Teilen über

„Bild hinzufügen“-Steuerelement in Canvas Apps

  • Artikel

Nimmt ein Foto auf oder lädt Bilder vom lokalen Gerät.

Beschreibung

Mit diesem Steuerelement können die Benutzer Fotos aufnehmen oder Bilddateien von ihrem Gerät laden und die Datenquelle mit diesem Inhalt aktualisieren. Auf einem mobilen Gerät wird für den Benutzer das Auswahldialogfeld des Geräts angezeigt, in dem zwischen dem Aufnehmen eines Fotos und dem Auswählen eines bereits verfügbaren Fotos gewählt werden kann.

Bei dem Steuerelement handelt es sich um ein gruppiertes Steuerelement mit zwei Steuerelementen: ein Bild und eine „Bild hinzufügen“-Schaltfläche. Das Bild-Steuerelement zeigt das hochgeladene Bild bzw. (wenn kein Bild hochgeladen wurde) einen Platzhalter an. Die „Bild hinzufügen“-Schaltfläche fordert Sie auf, ein Bild hochzuladen.

Weitere Informationen zu den Bild-Eigenschaften erhalten Sie in der Referenz zu dem Steuerelement Bild.

Einschränkungen

Für das Bild-Steuerelement gelten folgende Einschränkungen:

  • Bei Verwendung des Steuerelements Bild hinzufügen unter iOS enthalten Bilder, die mithilfe der Kamera oder dem Katalog importiert wurde, keine Metadaten wie Ausrichtung, Standortinformationen oder Kameraeinstellungen.

„Bild hinzufügen“-Schaltflächeneigenschaften

AccessibleLabel - Bezeichnung für Sprachausgaben. Sollte beschreiben, warum ein Bild hochgeladen werden soll.

Align – Die Position von Text in Relation zur horizontalen Mitte des Steuerelements.

BorderColor - Die Farbe des Rahmens eines Steuerelements.

BorderStyle - Legt fest, ob der Rahmen eines Steuerelements Durgehend, Gestrichelt, Gepunktet oder Keine ist.

BorderThickness - Die Linienstärke des Rahmens eines Steuerelements.

ChangePictureText – Text, der angezeigt wird, wenn ein Bild hochgeladen wurde.

Color – Die Farbe des Texts in einem Steuerelement.

DisabledBorderColor: Die Farbe des Steuerelementrahmens, wenn die DisplayMode-Eigenschaft des Steuerelements auf Deaktiviert festgelegt ist.

DisabledColor: Die Farbe des Texts in einem Steuerelement, wenn seine DisplayMode-Eigenschaft auf Deaktiviert festgelegt ist.

DisabledFill: Die Hintergrundfarbe eines Steuerelements, wenn dessen DisplayMode-Eigenschaft auf Deaktiviert festgelegt ist.

DisplayMode - Legt fest, ob das Steuerelement Benutzereingaben zulässt (Bearbeiten), ob nur Daten angezeigt werden (Anzeigen) oder ob das Steuerelement deaktiviert ist (Deaktiviert).

Error – Falls beim Hochladen eines Bilds ein Problem auftritt, enthält diese Eigenschaft eine entsprechende Fehlerzeichenfolge.

Fill - Die Hintergrundfarbe eines Steuerelements.

FocusedBorderColor - Die Rahmenfarbe eines Steuerelements, wenn das Steuerelement der Fokus ist.

FocusedBorderThickness - Die Rahmendicke eines Steuerelements, wenn das Steuerelement der Fokus ist.

Font – Der Name der Schriftfamilie des angezeigten Texts.

FontWeight – Die Schriftbreite des Texts in einem Steuerelement: Fett, Halbfett. Normal oder Jeller.

Height - Die Entfernung zwischen dem oberen und unteren Rand eines Steuerelements.

HoverBorderColor – Die Rahmenfarbe eines Steuerelements, wenn der Benutzer den Mauszeiger über das Steuerelement hält.

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

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

Italic – Legt fest, ob der Text in einem Steuerelement kursiv formatiert ist.

Media – Ein Bezeichner für den Clip, der von einem Audio- oder Video-Steuerelement wiedergegeben wird.

OnChange  – Auszuführende Aktionen, wenn der Benutzer den Wert eines Steuerelements ändert (z. B. per Schieberegler).

OnSelect – Auszuführende Aktionen, wenn der Benutzer auf ein Steuerelement tippt oder klickt.

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

PressedBorderColor – Die Rahmenfarbe eines Steuerelements, wenn der Benutzer auf das Steuerelement tippt oder klickt.

PressedColor – Die Farbe des Texts in einem Steuerelement, wenn der Benutzer auf das Steuerelement tippt oder klickt.

PressedFill – Die Hintergrundfarbe eines Steuerelements, wenn der Benutzer auf das Steuerelement tippt oder klickt.

Reset – Gibt an, ob ein Steuerelement auf seinen Standardwert zurückgesetzt wird.

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

Strikethrough – Legt fest, ob der in einem Steuerelement angezeigte Text durchgestrichen ist.

TabIndex: Navigationsreihenfolge der Tastatur in Bezug auf andere Steuerelemente.

Text – Text, der angezeigt wird, wenn kein Bild hochgeladen wurde.

Tooltip - Erklärender Text, der angezeigt wird, wenn der Benutzer auf ein Steuerelement zeigt.

Underline – Legt fest, ob der in einem Steuerelement angezeigte Text unterstrichen ist.

UseMobileCamera – Gibt an, ob eine mobile Kamera direkt verwendet werden soll, sofern verfügbar. Für Android-Geräte erfordert diese Eigenschaft, dass die experimentelle Einstellung Verbesserte Medienaufnahme eingeschaltet ist.

VerticalAlign – Die Position des Texts in einem Steuerelement in Relation zur vertikalen Mitte des Steuerelements.

Visible - Gibt an, ob ein Steuerelement angezeigt wird oder ausgeblendet ist.

Width - Der Abstand zwischen dem linken und rechten Rand eines Steuerelements.

X – Der Abstand zwischen dem linken Rand eines Steuerelements und dem linken Rand des übergeordneten Containers (vom Bildschirm, wenn kein übergeordneter Container vorhanden ist).

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

Patch( DataSource, BaseRecord, ChangeRecord )

Beispiele

  1. Fügen Sie ein Bild hinzufügen-Steuerelement hinzu, und klicken Sie dann dreimal darauf.

    Möchten Sie wissen, wie Sie ein Steuerelement hinzufügen, benennen und konfigurieren?

  2. Klicken oder tippen Sie im Dialogfeld Öffnen auf eine Bilddatei, und klicken oder tippen Sie dann auf Öffnen.

  3. Fügen Sie ein Schaltfläche-Steuerelement hinzu, verschieben Sie es unter das Steuerelement Bild hinzufügen, und legen Sie die OnSelect-Eigenschaft für das Schaltfläche-Steuerelement auf die folgende Formel fest:
    Collect(MyPix, AddMediaButton1.Media)

    Benötigen Sie weitere Informationen zur Funktion Collect oder anderen Funktionen?

  4. Fügen Sie ein Steuerelement Vertical gallery hinzu und legen Sie die Items Eigenschaft auf MyPix fest.

  5. Wählen Sie das Bild Steuerelement im Katalog und legen Sie die Image-Eigenschaft auf ThisItem.Value fest.

  6. Drücken Sie F5, und klicken oder tippen Sie auf das Schaltfläche-Steuerelement.

    Das Bild aus dem Steuerelement Bild hinzufügen wird im Steuerelement Vertikaler Katalog angezeigt. Wenn das Bild nicht das gleiche Seitenverhältnis wie das Bild-Steuerelement im Vertical gallery-Steuerelement aufweist, legen Sie die ImagePosition-Eigenschaft des Bild-Steuerelements auf Einpassen fest.

  7. Klicken oder tippen Sie auf das Bild hinzufügen-Steuerelement, auf eine andere Bilddatei, auf Öffnen und dann auf das hinzugefügte Schaltfläche-Steuerelement.

    Das zweite Bild wird im Bilderkatalog-Steuerelement angezeigt.

  8. (optional) Wiederholen Sie den vorherigen Schritt beliebig oft, und kehren Sie dann zurück zum Standardarbeitsbereich, indem Sie ESC drücken.

Verwenden Sie die SaveData-Funktion, um die Bilder lokal zu speichern, oder die Patch-Funktion, um eine Datenquelle zu aktualisieren.

Richtlinien für Barrierefreiheit

Es gelten für die Schaltfläche und das Bild dieselben Richtlinien. Ziehen Sie außerdem Folgendes in Betracht:

Farbkontrast

  • Der Farbkontrast zwischen dem Text und dem Hintergrund der „Bild hinzufügen“-Schaltfläche muss angemessen sein. Da die Farben des hochgeladenen Bilds unterschiedlich sein können, sollte die Fill auf der „Bild hinzufügen“-Schaltfläche undurchsichtig sein, damit der Kontrast immer gleich hoch ist.

Screenreadersupport

  • Die „Bild hinzufügen“-Schaltfläche muss die Eigenschaften Text und ChangePictureText aufweisen, über die der Benutzer aufgefordert wird, ein Bild hinzuzufügen oder zu ändern.

Tastaturunterstützung

  • Für die „Bild hinzufügen“-Schaltfläche muss TabIndex gleich Null oder größer sein, damit Tastaturbenutzer dorthin navigieren können.
  • „Bild hinzufügen“-Schaltfläche muss für Fokusindikatoren deutlich sichtbar sein. FocusedBorderColor und FocusedBorderThickness können Ihnen dabei helfen.

Hinweis

Können Sie uns Ihre Präferenzen für die Dokumentationssprache mitteilen? Nehmen Sie an einer kurzen Umfrage teil. (Beachten Sie, dass diese Umfrage auf Englisch ist.)

Die Umfrage dauert etwa sieben Minuten. Es werden keine personenbezogenen Daten erhoben. (Datenschutzbestimmungen).