Beiträge in diesem Abschnitt

Weitere anzeigen

SetProcessMessage - Nachricht im Prozessdialog anzeigen

Albert Labermair
  • Aktualisiert
Folgen

Beschreibung

Die Funktion SetProcessMessage wird verwendet, um eine Nachricht im Prozessdialog anzuzeigen. Dies ist besonders nützlich, um Benutzer während der Ausführung von Prozessen über den Fortschritt oder Status zu informieren. Zusätzlich kann ein Icon hinzugefügt oder geändert werden, um die visuelle Darstellung der Nachricht zu verbessern.

Wichtig: SetProcessMessage kann nur innerhalb der Process()-Funktion verwendet werden. Diese Funktion muss in einem Button (createButton) definiert sein, da sie sonst nicht funktioniert.

Syntax

SetProcessMessage(message, icon [, duration])

Argumente

Argument Beschreibung
message Der Text der Nachricht, der im Prozessdialog angezeigt wird.
icon Das Symbol, das neben der Nachricht angezeigt wird. Unterstützt sind Icons aus der Font Awesome Icon Library.
duration (optional) Die Dauer, für die die Nachricht angezeigt wird, in Sekunden. Wenn keine Dauer angegeben wird, bleibt die Nachricht dauerhaft sichtbar, bis der Prozess abgeschlossen ist.

 

Rückgabetypen

Die Funktion gibt keine Werte zurück. Sie dient ausschließlich dazu, eine visuelle Nachricht anzuzeigen.

Beispiele

Beschreibung Formel
Anzeige einer Nachricht während eines Prozesses 
createButton(
  1,
  "Prozess starten",
  "Startet den Prozess und zeigt eine Nachricht an",
  "Process(
    SetProcessMessage('Der Prozess wird ausgeführt...', 'chart-pie-simple-circle-dollar')
  )",
  "",
  "",
  "",
  "Der Prozess wurde gestartet.",
  "",
  "cogs"
)
Nachricht mit angepasster Dauer 
createButton(
  1,
  "Verarbeitung starten",
  "Zeigt eine Nachricht für 5 Sekunden an",
  "Process(
    SetProcessMessage('Die Daten werden verarbeitet...', 'spinner', 5)
  )",
  "",
  "",
  "",
  "Die Verarbeitung wurde gestartet.",
  "",
  "hourglass-start"
)
Statusnachricht bei Abschluss eines Prozesses 
createButton(
  1,
  "Prozess abschließen",
  "Zeigt eine Abschlussnachricht an",
  "Process(
    SetProcessMessage('Der Prozess wurde erfolgreich abgeschlossen.', 'check-circle')
  )",
  "",
  "",
  "",
  "Prozess erfolgreich abgeschlossen.",
  "",
  "check-circle"
)

 

Icons ändern

Um das Icon zu ändern, ersetzen Sie den zweiten Parameter durch den Namen eines unterstützten Icons. Eine vollständige Liste der verfügbaren Icons finden Sie in der Font Awesome Icon Library.

  • Beispiel für ein erfolgreiches Symbol: check-circle
  • Beispiel für ein Ladesymbol: spinner
  • Beispiel für ein Warnsymbol: exclamation-triangle

Hinweise

  • Die Funktion SetProcessMessage muss in einem interaktiven Button und innerhalb der Process()-Funktion verwendet werden.
  • Die Nachricht kann dazu verwendet werden, Benutzer über den Fortschritt eines Prozesses oder einen Fehlerstatus zu informieren.
  • Wählen Sie Icons aus, die den Status oder die Aktion gut visuell unterstützen, um die Benutzererfahrung zu verbessern.
  • Achten Sie darauf, dass der Nachrichtentext klar und verständlich formuliert ist.

Verwandte Beiträge

Kommentare

0 Kommentare

Bitte melden Sie sich an, um einen Kommentar zu hinterlassen.