Freigeben über

Dialog-Steuerelement (in der Prüfung)

[Dieser Artikel ist Teil der Dokumentation zur Vorschauversion und kann geändert werden.]

Ein Steuerelement zum Gruppieren von Inhalten.

Dialogfeld-Steuerelement.

Wichtig

  • Dies ist eine Funktion, die in Prüfung ist.
  • Previewfunktionen sind nicht für den Produktionseinsatz gedacht und können eine eingeschränkte Funktionalität aufweisen. Diese Funktionen stehen vor der offiziellen Veröffentlichung zur Verfügung, damit Kunden frühzeitig Zugriff erhalten und Feedback geben können.

Beschreibung

Ein Dialogfeld ist ein temporäres Popup-Fenster, das den Fokus von der Seite oder App nimmt und erfordert, dass man damit interagiert. Es wird hauptsächlich zum Bestätigen von Aktionen verwendet, z. B. zum Löschen einer Datei oder zum Auffordern einer Auswahl.

Diese Canvas-Komponente ahmt den Stil und das Verhalten des Fluent UI-Dialogfeld-Steuerelements nach. In der Dokumentation finden Sie bewährte Methoden.

Komponente im Creator Kit GitHub-Repository anzeigen

Eigenschaften

Schlüsseleigenschaften

Eigenschaften Beschreibung
Buttons Ein Dataset, das die Schaltflächen definiert (weitere Informationen zu Schaltflächeneigenschaften).
Title Text, der im Titelbereich angezeigt wird.
OverlayColor Im Überlagerungsbereich angezeigte Farbe.
DialogWidth Die Breite des Dialogfelds (nicht zu verwechseln mit der Steuerelementbreite, die die App-Breite umfassen soll).
DialogHeight Die Höhe des Dialogfelds (nicht zu verwechseln mit der Steuerelementhöhe, die der App-Höhe entsprechen sollte).
SubTitle Unter dem Titel angezeigter Text

Schaltflächeneigenschaften

Eigenschaften Beschreibung
Label Die Beschriftung auf der Schaltfläche.
ButtonType Enumeration, die das Design der Schaltfläche festlegt. Wählen Sie zwischen Standard und Primary. 
Table(
    {
        Label: "Cancel", 
        ButtonType:'Microsoft.CoreControls.Button.ButtonType'.Standard 
    },{
        Label: "Ok", 
        ButtonType:'Microsoft.CoreControls.Button.ButtonType'.Primary
    }
)

Stileigenschaften

Eigenschaften Beschreibung
Theme Design-Objekt Erfahren Sie mehr über Themen.

Erfahren Sie mehr über die Formatierung im Inhaltsabschnitt des Bereichs "Format" des Bereichs "Panel".

Ereigniseigenschaften

Eigenschaften Beschreibung
OnCloseSelect Aktionsausdruck, der ausgeführt wird, wenn die Schaltfläche "Schließen" ausgewählt ist.
OnButtonSelect Aktionsausdruck, der ausgeführt wird, wenn eine der Interaktiven Schaltflächen ausgewählt ist.

Verhalten

Dialogfeldsichtbarkeit konfigurieren

Machen Sie das Dialog Steuerelement selbst (oder die Oberfläche, in der es sich befindet) sichtbar, wenn sich eine boolesche Variable (true/false) in "true" ändert. Weisen Sie diese Variable der Sichtbarkeitseigenschaft des Dialogfelds zu. Um das Dialogfeld nach der Darstellung auszublenden, aktualisieren Sie die Variable für die Reset-Eigenschaft, die durch die Auswahl des Symbols 'Schließen' ausgelöst wird.

Nachfolgend sehen Sie die Power Fx-Formel zum Öffnen des Dialogfelds in einer Aktionsformel für eine andere Komponente irgendwo in der App (z. B. die OnSelect Eigenschaft einer Schaltfläche):

UpdateContext({ showHideDialog: true })

Nachfolgend sehen Sie die Power Fx-Formel, um das Dialogfeld in der OnCloseSelect-Eigenschaft des Dialogfelds zu schließen:

UpdateContext({ showHideDialog: false })

Weisen Sie die Variable der Visible-Eigenschaft des Dialogs zu:

showHideDialog

Schaltflächenaktionen konfigurieren

Stellen Sie in der OnButtonSelect-Eigenschaft des Dialogfelds Aktionen in einer If()- oder Switch()-Bedingung auf der Grundlage des Self.SelectedButton.Label-Textwerts bereit, um die Aktion festzulegen. Je nach Aktion kann es sinnvoll sein, das Dialogfeld auch nach Abschluss der Aktion zu schließen.

    If( Self.SelectedButton.Label = "Send", 
        Notify("Email Sent")
    );
    UpdateContext({ showHideDialog: false })

Einschränkungen

Diese Canvas-Komponente kann nur in Canvas-Apps und benutzerdefinierten Seiten verwendet werden.

  • Last updated on