Zum Hauptinhalt springen

Dialog-Builder

Was ist der Dialog-Builder?​

Der Dialog-Builder ist eine nützliche Funktion, die es Ihnen ermöglicht, interaktive Dialoge innerhalb Ihres Makros zu erstellen. Diese Dialoge werden normalerweise verwendet, um Eingaben von Benutzern einzuholen, bevor das Makro mit der Hauptausführung beginnt. Betrachten Sie es als eine Möglichkeit, das Verhalten Ihres Makros basierend auf der Benutzerwahl anzupassen.

Beispielsweise könnten Sie einen Dialog erstellen, der fragt: „Welche Option möchten Sie ausführen?“ Wenn der Benutzer Option 5 auswählt, führt das Makro anschließend eine bestimmte Reihe von Aktionen aus, die mit dieser Auswahl verbunden sind.

Dialog-Komponenten​

Dialoge werden aus verschiedenen UI-Komponenten zusammengesetzt. Jeder Dialog kann die folgenden Elemente enthalten:

  1. CheckBox: Für Ja/Nein- oder Wahr/Falsch-Auswahlen
  2. EditText: Für freie Texteingabe
  3. RadioGroup: Ein Container für mehrere RadioButtons
  4. Column: Ein vertikaler Layout-Container
  5. Row: Ein horizontaler Layout-Container
  6. RadioButton: Für Einzelwahl-Auswahlen innerhalb einer RadioGroup
  7. TextView: Zur Anzeige von Textinformationen

Standardwerte​

Dialog-Eingabekomponenten können jetzt Anfangswerte festlegen, bevor der Dialog angezeigt wird:

  • EditText(id, hint, defaultValue) legt den Starttext fest
  • CheckBox(id, text, defaultChecked) legt den Start-Ankreuzzustand fest
  • RadioGroup(id, defaultButtonId) wählt standardmäßig einen RadioButton aus

Wenn ein Standardwert angegeben wird, wird dieser beim Öffnen des Dialogs zuerst verwendet.

Ihren Dialog aufbauen​

Sie können diese Komponenten kombinieren, um einen benutzerdefinierten Dialog zu erstellen, der den Anforderungen Ihres Makros entspricht. Unter diesen Komponenten gibt es drei Eingabetypen, aus denen Sie Werte abrufen können:

  • CheckBox
  • EditText
  • RadioGroup

Um auf die Werte dieser Eingabekomponenten zuzugreifen, können Sie die Funktion Dialog:getValueById() in Ihrer Makro-Logik verwenden. Durch Angabe der eindeutigen ID der Komponente können Sie die Eingabe des Benutzers abrufen und verwenden, um die Aktionen Ihres Makros zu steuern.

Hinweis: Jede Komponente in Ihrem Dialog muss eine eindeutige ID haben. Dadurch wird sichergestellt, dass das Makro Werte aus der speziellen Komponente, die Sie ansprechen, korrekt identifizieren und abrufen kann. Doppelte IDs können zu Verwirrung und Fehlern bei der Ausführung Ihres Makros führen.

Letztes Update am