Freigeben über


Hinzufügen eines Bildsteuerelements in Canvas-Apps

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

Description

Mit diesem Steuerelement können Benutzer Fotos aufnehmen oder Bilddateien von ihrem Gerät hochladen und die Datenquelle mit diesem Inhalt aktualisieren. Auf einem mobilen Gerät wird dem Benutzer das Auswahldialogfeld des Geräts angezeigt, um zwischen dem Aufnehmen eines Fotos oder der Auswahl eines bereits verfügbaren Geräts auszuwählen.

Dieses Steuerelement ist ein gruppiertes Steuerelement, das zwei Steuerelemente enthält: ein Bild und eine Schaltfläche "Bild hinzufügen". Das Bildsteuerelement zeigt das hochgeladene Bild oder einen Platzhalter an, wenn kein Bild hochgeladen wurde. Mit der Schaltfläche "Bild hinzufügen" wird aufgefordert, ein Bild hochzuladen.

Weitere Informationen finden Sie in der Image-Steuerelementreferenz für Bildeigenschaften .

Einschränkungen

Das Bildsteuerelement hat die folgenden Einschränkungen:

  • Wenn Sie das Steuerelement "Bild hinzufügen" unter iOS verwenden, enthalten Bilder, die mithilfe der Kamera oder des Katalogs importiert werden, keine Metadaten wie Ausrichtung, Standortinformationen oder Kameraeinstellungen.

Hinzufügen von Bildschaltflächeneigenschaften

AccessibleLabel – Bezeichnung für Bildschirmsprachausgaben. Sollte den Zweck des Hinzufügens eines Bilds beschreiben.

Ausrichten – Die Position des Texts im Verhältnis zur horizontalen Mitte des Steuerelements.

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.

ChangePictureText – Text, der auf der Schaltfläche angezeigt wird, wenn ein Bild hochgeladen wurde.

Farbe – Die Farbe des Texts in einem Steuerelement.

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 Benutzereingaben (Bearbeiten) zulässt, zeigt nur Daten (Ansicht) an oder ist deaktiviert (deaktiviert).

Fehler : Wenn beim Hochladen eines Bilds ein Problem auftritt, enthält diese Eigenschaft eine entsprechende Fehlerzeichenfolge.

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.

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

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

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

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.

Medien – Ein Bezeichner für den Clip, der von einem Audio- oder Videosteuerelement wiedergegeben wird.

OnChange – Aktionen, die ausgeführt werden sollen, wenn der Benutzer den Wert eines Steuerelements ändert (z. B. durch Anpassen eines Schiebereglers).

OnSelect – Aktionen, die ausgeführt werden sollen, wenn der Benutzer auf ein Steuerelement tippt oder klickt.

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 auf dieses Steuerelement tippt oder klickt.

PressedColor – Die Textfarbe in einem Steuerelement, wenn der Benutzer auf dieses Steuerelement tippt oder klickt.

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

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

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.

Text – Text, der auf der Schaltfläche angezeigt wird, wenn ein Bild nicht hochgeladen wurde.

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.

UseMobileCamera – Ob eine mobile Kamera direkt verwendet werden soll, wenn verfügbar. Durch Festlegen dieser Einstellung auf TRUE werden Benutzer gezwungen, mithilfe der Kamera ein Bild aufzunehmen und das Hochladen vorhandener Bilder aus der Gerätegalerie zu deaktivieren.

VerticalAlign – Die Position von Text in einem Steuerelement im Verhältnis zur vertikalen Mitte dieses Steuerelements.

Sichtbar – Ob ein Steuerelement angezeigt 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 (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 )

Examples

  1. Fügen Sie ein Bildsteuerelement hinzufügen hinzu, und klicken Sie dann dreifach darauf.

    Wissen Sie nicht, wie Sie ein Steuerelement hinzufügen, benennen und konfigurieren können?

  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ächen-Steuerelement hinzu, verschieben Sie es unter das Steuerelement " Bild hinzufügen ", und legen Sie die OnSelect-Eigenschaft für das Schaltflächensteuerelement auf diese Formel fest:
    Collect(MyPix, AddMediaButton1.Media)

    Möchten Sie mehr über die Funktion "Sammeln" oder andere Funktionen erfahren?

  4. Fügen Sie ein Steuerelement für den vertikalen Katalog hinzu, und legen Sie dessen Items-Eigenschaft auf "MyPix" fest.

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

  6. Drücken Sie F5, und klicken oder tippen Sie dann auf das Schaltflächensteuerelement .

    Das Bild aus dem Steuerelement " Bild hinzufügen " wird im Steuerelement "Vertikaler Katalog " angezeigt. Wenn Ihr Bild nicht das gleiche Seitenverhältnis wie das Bildsteuerelement im Steuerelement "Vertikaler Katalog " aufweist, legen Sie die ImagePosition-Eigenschaft des Bildsteuerelements auf "Anpassen" fest.

  7. Klicken oder tippen Sie auf das Steuerelement "Bild hinzufügen ", klicken oder tippen Sie auf eine andere Bilddatei, klicken oder tippen Sie auf "Öffnen", und klicken oder tippen Sie dann auf das Schaltflächensteuerelement , das Sie hinzugefügt haben.

    Das zweite Bild wird im Bildkatalog-Steuerelement angezeigt.

  8. (optional) Wiederholen Sie den vorherigen Schritt ein oder mehrere Male, und kehren Sie dann zum Standardarbeitsbereich zurück, indem Sie ESC drücken.

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

Richtlinien für Eingabehilfen

Es gelten die gleichen Richtlinien für Schaltflächen und Bilder . Beachten Sie außerdem Folgendes:

Farbkontrast

  • Schaltfläche "Bild hinzufügen" muss einen angemessenen Kontrast zwischen Text und Hintergrund aufweisen. Da das hochgeladene Bild möglicherweise unterschiedliche Farben aufweist, verwenden Sie eine undurchsichtige Füllung auf der Schaltfläche "Bild hinzufügen" , um einen konsistenten Kontrast sicherzustellen.

Unterstützung für Sprachausgabe

  • Schaltfläche "Bild hinzufügen" muss "Text " und "ChangePictureText " enthalten, der den Benutzer auffordert, ein Bild hinzuzufügen oder zu ändern.

Tastaturunterstützung

  • Schaltfläche "Bild hinzufügen" muss tabIndex null oder größer haben, damit Tastaturbenutzer zu ihr navigieren können.
  • Schaltfläche "Bild hinzufügen" muss deutlich sichtbare Fokusanzeigen aufweisen. Verwenden Sie "FocusedBorderColor " und " FocusedBorderThickness ", um dies zu erreichen.