Dialog Kontrolle (experimentell)

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

Ein Steuerelement zum Gruppieren von Inhalten.

Wichtig

• Dies ist eine Funktion, die in Prüfung ist.
• Die experimentellen Funktionen sind nicht für die Produktion vorgesehen und weisen möglicherweise eine eingeschränkte Funktionalität auf. Diese Funktionen stehen vor der offiziellen Veröffentlichung zur Verfügung, damit Kunden frühzeitig Zugriff erhalten und Feedback geben können.

Beschreibung des Dataflows

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-Benutzeroberfläche-Dialogfeld-Steuerelements nach. Siehe Dokumentation für bewährte Methoden.

Sehen Sie sich die Komponente im Creator Kit GitHub-Repository an.

Eigenschaften

Schlüsseleigenschaften

Eigenschaften	Beschreibung des Dataflows
Buttons	Ein DataSet, das die Schaltflächen definiert (siehe Eigenschaften unten)
Title	Text, der im Titelbereich angezeigt wird
OverlayColor	Im Überlagerungsbereich angezeigte Farbe
DialogWidth	Die Breite des Dialogs (nicht zu verwechseln mit der Steuerelementbreite, die der App-Breite entsprechen sollte)
DialogHeight	Die Höhe des Dialogfelds (nicht zu verwechseln mit der Steuerelementhöhe, die der App-Höhe entsprechen sollte).
SubTitle	Text, der unter dem Titel angezeigt wird

Buttons Eigenschaften

Eigenschaften	Beschreibung des Dataflows
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 des Dataflows
Theme	Design-Objekt Siehe Designs für eine Konfigurationsanleitung.

Anleitungen für die Formatierung finden Sie im Abschnitt zum Formatieren des Bereichsinhalts von Bereich.

Ereigniseigenschaften

Eigenschaften	Beschreibung des Dataflows
OnCloseSelect	Aktionsausdruck, der ausgeführt wird, wenn die „Schließen“-Schaltfläche ausgewählt wird.
OnButtonSelect	Aktionsausdruck, der ausgeführt wird, wenn eine der Aktionsschaltflächen ausgewählt wird.

Behavior

Dialogfeldsichtbarkeit konfigurieren

Machen Sie das Dialog-Steuerelement selbst sichtbar (oder die Oberfläche, in der es sich befindet), wenn eine Variable vom Typ „boolesch (wahr/falsch)“ auf „wahr“ geändert wird, und weisen Sie diese Variable der Sichtbarkeitseigenschaft des Dialogfelds zu. Sobald der Dialogfeld angezeigt wird, können Sie ihn ausblenden, indem Sie die Variable in der „Zurücksetzen“-Eigenschaft aktualisieren, die ausgelöst wird, wenn das „Schließen“-Symbol ausgewählt wird.

Nachfolgend sehen Sie die Power Fx-Formel zum Öffnen des Dialogs 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 den Dialog in der OnCloseSelect-Eigenschaft des Dialogs 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.