Anlagensteuerelement in Power Apps

Ein Steuerelement, mit dem Benutzer Dateien auf ihr Gerät herunterladen und Dateien aus einer Liste hochladen und löschen können, die mit Microsoft Lists oder einer Microsoft Dataverse-Tabelle erstellt wurde.

Description

Mithilfe eines Anlagensteuerelements können Sie Dateien aus einer Liste oder einer Dataverse-Tabelle öffnen, hinzufügen und löschen.

Einschränkungen

Das Anlagensteuerelement hat die folgenden Einschränkungen:

1. Das Anlagensteuerelement unterstützt nur Listen und Dataverse-Tabellen als Datenquellen. Es werden keine Ausdrücke unterstützt, die diese Datenquellen in Tabellen transformieren, z. B. mit der ForAll-Funktion .

2. Die Funktion zum Hochladen und Löschen funktioniert nur innerhalb eines Formulars. Das Anlagensteuerelement wird im Bearbeitungsmodus und nicht innerhalb eines Formulars deaktiviert. Um Dateizusätze und Löschungen zu speichern, muss der App-Benutzer das Formular speichern. Aufgrund dieser Einschränkung ist das Anlagensteuerelement nicht über die Registerkarte "Einfügen " verfügbar, wird aber im Formular angezeigt, wenn das Anlagenformularfeld in einem SharePoint- oder Dataverse-Formular aktiviert ist.

3. Mit dem Steuerelement "Anlagen" in einem Webbrowser können Sie mehrere Dateien auswählen und die Drag- und Drop-Funktionalität verwenden. Wenn Sie jedoch das Anlagensteuerelement auf Power Apps Mobile verwenden, können Sie dateien nur einzeln hinzufügen.

4. Möglicherweise können Sie dateien, die in OneDrive oder einem anderen Cloudspeicher gespeichert sind, nicht anfügen. Versuchen Sie, diese Dateien auf das Gerät herunterzuladen, bevor Sie sie mithilfe der Dateiauswahl des Geräts anfügen.

5. Die mobile Power Apps-App unterstützt das Aufnehmen von Videos nicht direkt über die Kamera oder das Auswählen von Videos aus der Fotobibliothek bei Verwendung des Anlagensteuerelements . Um ein Video hinzuzufügen, müssen Benutzer die Option "Durchsuchen" verwenden.

   • Unter Android: Die Option "Durchsuchen " zeigt alle Dateitypen an, einschließlich Videos, sodass Sie Ihre Videodateien auswählen und anfügen können.
   • Unter iOS: Die Option "Durchsuchen " zeigt nur Dateien an, die in der Datei-App gespeichert sind. Wenn Ihr Video noch nicht dort gespeichert ist, müssen Sie es in die Datei-App verschieben, bevor Sie es anfügen.

   Wenn ein Video nicht als Option zum Anfügen angezeigt wird, speichern Sie das Video zuerst in der Datei-App Ihres Geräts, und versuchen Sie es dann erneut.

6. Das Hochladen und Anzeigen von Anlagen wird nicht unterstützt, wenn Canvas-Apps in Microsoft Teams auf mobilen Android- oder iOS-Geräten ausgeführt werden.

Schlüsseleigenschaften

Elemente – Die Spalte "Anlage " der Liste oder der Dataverse-Tabelle. Sammlungen und Tabellen werden nicht unterstützt.

MaxAttachments – Die maximale Anzahl von Dateien, die das Steuerelement akzeptiert.

MaxAttachmentSize – Die maximal zulässige Dateigröße in MB für jede neue Anlage. 1 MB sind hier 1.000.000 Bytes (10⁶ B) oder 1.000 KB.

OnAddFile – Aktionen, die ausgeführt werden sollen, wenn der Benutzer eine neue Dateianlage hinzufügt.

OnRemoveFile – Aktionen, die ausgeführt werden, wenn der Benutzer eine vorhandene Anlage löscht.

OnUndoRemoveFile – Aktionen, die ausgeführt werden sollen, wenn der Benutzer eine gelöschte Anlage wiederhergestellt.

Zusätzliche Eigenschaften

AccessibleLabel – Bezeichnung für Bildschirmsprachausgaben. Sollte den Zweck der Anlagen beschreiben.

AddAttachmentText – Der Beschriftungstext für den Link, der zum Hinzufügen einer neuen Anlage verwendet wird.

BorderColor – Die Farbe des Rahmens eines Steuerelements.

BorderStyle – Gibt an, ob der Rahmen eines Steuerelements einfarbig, gestrichelt, gepunktet oder None ist.

BorderThickness – Die Stärke des Rahmens eines Steuerelements.

Farbe – Die Farbe des Texts eines Steuerelements.

DisabledBorderColor – Die Farbe des Rahmens eines Steuerelements, wenn die DisplayMode-Eigenschaft des Steuerelements auf "Disabled" festgelegt ist.

DisabledColor – Die Farbe von Text in einem Steuerelement, wenn die DisplayMode-Eigenschaft auf "Disabled" festgelegt ist.

DisabledFill – Die Hintergrundfarbe eines Steuerelements, wenn die DisplayMode-Eigenschaft auf "Disabled" festgelegt ist.

DisplayMode – Ob das Steuerelement das Hinzufügen und Löschen von Dateien (Bearbeiten) zulässt, zeigt nur Daten (Ansicht) an oder ist deaktiviert (deaktiviert).

[DropTargetBackgroundColor] – Die Farbe des Zielhintergrunds des Steuerelements.

[DropTargetBorderColor] – Die Farbe des Zielrahmens des Steuerelements.

[DropTargetBorderStyle] – Gibt an, ob der Zielrahmen des Steuerelements einfarbig, gestrichelt, gepunktet oder None ist.

[DropTargetBorderThickness] – Die Stärke des Zielrahmens des Steuerelements.

[DropTargetTextColor] – Die Farbe des Zieltexts des Steuerelements.

Füllung – Die Hintergrundfarbe eines Steuerelements.

FocusedBorderColor – Die Farbe des Rahmens eines Steuerelements, wenn das Steuerelement fokussiert ist.

FocusedBorderThickness – Die Stärke des Rahmens eines Steuerelements, wenn das Steuerelement fokussiert ist.

Höhe – Der Abstand zwischen den oberen und unteren Rändern eines Steuerelements.

Schriftart – Der Name der Schriftartenfamilie, in der Text angezeigt wird.

FontWeight – Die Stärke des Texts in einem Steuerelement: Fett, Semibold, Normal oder Heller.

HoverBorderColor – Die Farbe des Rahmens eines Steuerelements, wenn der Benutzer den Mauszeiger auf diesem Steuerelement hält.

HoverColor – Die Farbe des Texts in einem Steuerelement, wenn der Benutzer den Mauszeiger darauf hält.

HoverFill – Die Hintergrundfarbe eines Steuerelements, wenn der Benutzer den Mauszeiger darauf hält.

Kursiv – Gibt an, ob der Text in einem Steuerelement kursiv ist.

MaxAttachmentsText – Der Text, der den Link "Datei anfügen" ersetzt, wenn das Steuerelement die maximale Anzahl zulässiger Dateien enthält.

NoAttachmentsText – Dem Benutzer angezeigter Informationstext, wenn keine Dateien angefügt sind.

Abstand – Der Abstand zwischen dem Text auf einer Import- oder Exportschaltfläche und den Rändern dieser Schaltfläche.

PressedBorderColor – Die Farbe des Rahmens eines Steuerelements, wenn der Benutzer dieses Steuerelement auswählt.

PressedColor – Die Textfarbe in einem Steuerelement, wenn der Benutzer dieses Steuerelement auswählt.

PressedFill – Die Hintergrundfarbe eines Steuerelements, wenn der Benutzer dieses Steuerelement auswählt.

Zurücksetzen – Setzt alle Änderungen am Anlagensteuerelement zurück und kehrt zum zuvor gespeicherten Zustand zurück.

Size – Der Schriftgrad des Texts, der in einem Steuerelement angezeigt wird.

Durchgestrichen – Gibt an, ob eine Zeile durch den Text angezeigt wird, der in einem Steuerelement angezeigt wird.

TabIndex – Tastaturnavigationsreihenfolge im Verhältnis zu anderen Steuerelementen.

QuickInfo – Erläuternder Text, der angezeigt wird, wenn der Benutzer auf ein Steuerelement zeigt.

Unterstrichen – Gibt an, ob unter dem Text, der in einem Steuerelement angezeigt wird, eine Zeile angezeigt wird.

Sichtbar – Ob ein Steuerelement sichtbar oder ausgeblendet ist.

Width – Der Abstand zwischen den linken und rechten Rändern eines Steuerelements.

X – Der Abstand zwischen dem linken Rand eines Steuerelements und dem linken Rand des übergeordneten Containers (oder bildschirms, wenn kein übergeordneter Container).

Y – Der Abstand zwischen dem oberen Rand eines Steuerelements und dem oberen Rand des übergeordneten Containers (oder Bildschirm, wenn kein übergeordneter Container).

Example

1. Fügen Sie Ihrer App ein Formular hinzu, und legen Sie eine Liste als Datenquelle fest.

2. Wählen Sie das Anzeigeformular-Steuerelement in der Strukturansicht auf der linken Seite aus. Sie können stattdessen auch das Bearbeitungsformular verwenden.

3. Wählen Sie auf der Registerkarte "Eigenschaften" im Optionsbereich auf der rechten Seite die Option "Datenquelle " aus, und wählen Sie dann die Liste aus, mit der Sie eine Verbindung hergestellt haben.

4. Wählen Sie "Felder bearbeiten " im Abschnitt "Felder" und dann "Feld hinzufügen" aus.

5. Wählen Sie das Feld "Anlagen" und dann "Hinzufügen" aus.

   Das feld "Anlagen", das der Liste zugeordnet ist, wird im Formular angezeigt.

Erfahren Sie, wie Sie ein Steuerelement hinzufügen und konfigurieren.

Richtlinien für Eingabehilfen

Farbkontrast

Stellen Sie sicher, dass ein ausreichender Farbkontrast zwischen:

• ItemColor und ItemFill
• ItemHoverColor und ItemHoverFill
• ItemPressedColor und ItemPressedFill
• AddedItemColor und AddedItemFill
• RemovedItemColor und RemovedItemFill
• ItemErrorColor und ItemErrorFill
• AddAttachmentColor und Fill
• MaxAttachmentsColor und Fill
• NoAttachmentsColor und Fill

Diese Anforderung ist zusätzlich zu den Standardfarbkontrastanforderungen erforderlich.

Unterstützung für Sprachausgabe

Fügen Sie die folgenden Eigenschaften ein:

• AccessibleLabel
• AddAttachmentsText
• MaxAttachmentsText
• NoAttachmentsText

Tastaturunterstützung

• Verwenden Sie TabIndex mit einem Wert von null oder höher, damit Tastaturbenutzer zu ihr navigieren können.
• Fokusindikatoren müssen deutlich sichtbar sein. Verwenden Sie FocusedBorderColor und FocusedBorderThickness , um diese Klarheit zu erzielen.