messagebox — n_pbt_messagebox #

← Komponentenreferenz · Inhalt des Handbuchs

Modales Dialogfeld im Design der Anwendung, mit synchronem Rückgabewert: der direkte Ersatz für das MessageBox() von PowerBuilder, mit Rich-Text, frei wählbaren Schaltflächen, Symbolen und Kontrollkästchen.

▶ Live ansehen — Demoanwendung, Kachel Message box: die Vorschau, der zugehörige Code und diese Seite, nebeneinander.

Auf einen Blick #

Anders als die visuellen Komponenten wird dieses Objekt nicht in ein Fenster eingefügt: Sie erzeugen, konfigurieren, zeigen und zerstören es.

n_pbt_messagebox lnv_mb

lnv_mb = create n_pbt_messagebox
// ... Konfiguration ...
destroy lnv_mb

Schnellstart #

n_pbt_messagebox lnv_mb

lnv_mb = create n_pbt_messagebox

lnv_mb.is_title   = "Löschen"
lnv_mb.is_icon    = lnv_mb.ICON_WARNING
lnv_mb.is_message = "[b]12 Ordner[/b] endgültig löschen ?[br][br]Diese Aktion kann nicht rückgängig gemacht werden."

lnv_mb.of_add_button(/*text*/ "Löschen", /*standard*/ true,  /*abbrechen*/ false)   // -> 1
lnv_mb.of_add_button(/*text*/ "Abbrechen",   /*standard*/ false, /*abbrechen*/ true)    // -> 2

if lnv_mb.of_show(/*hwnd*/ Handle(this)) = 1 then
    of_supprimer()
end if

destroy lnv_mb

of_show wartet auf die Antwort des Benutzers: Die nächste Zeile wird erst nach dem Klick ausgeführt, genau wie bei MessageBox().

Eigenschaften #

Vor of_show zu setzen.

Konstanten #

Methoden #

Die Beschriftung einer Schaltfläche akzeptiert die Rich-Text-Auszeichnung und das Mnemonik-Zeichen & ("&Speichern" unterstreicht das S und aktiviert die Schaltfläche mit Alt+S); && zeigt ein wörtliches Und-Zeichen an.

Die Tastatur #

Beim Öffnen zeigt keine Schaltfläche einen Fokusrahmen: Das ist beabsichtigt und entspricht dem Verhalten moderner Windows-Dialoge. Der Rahmen erscheint erst nach dem ersten Druck auf Tab, also sobald der Benutzer ausdrücklich zur Tastatur wechselt. Eingabetaste und Esc sind von der ersten Sekunde an aktiv, auch ohne sichtbaren Fokus.

Beispiele #

Geschlossene Frage mit Standardschaltfläche #

n_pbt_messagebox lnv_mb
long ll_reponse

lnv_mb = create n_pbt_messagebox

lnv_mb.is_title   = "Änderungen speichern"
lnv_mb.is_icon    = lnv_mb.ICON_QUESTION
lnv_mb.is_message = "Der Ordner wurde geändert. Möchten Sie vor dem Schließen speichern ?"

lnv_mb.of_add_button(/*text*/ "&Speichern",     /*standard*/ true,  /*abbrechen*/ false)  // 1
lnv_mb.of_add_button(/*text*/ "&Nicht speichern", /*standard*/ false, /*abbrechen*/ false) // 2
lnv_mb.of_add_button(/*text*/ "Abbrechen",          /*standard*/ false, /*abbrechen*/ true)   // 3

ll_reponse = lnv_mb.of_show(/*hwnd*/ Handle(this))
destroy lnv_mb

choose case ll_reponse
    case 1 ; of_enregistrer() ; Close(parent)
    case 2 ; Close(parent)
    case else ; // 3 oder 0 : nicht schliessen
end choose

Formatierte Meldung und Symbol #

lnv_mb.is_title   = "Import abgeschlossen"
lnv_mb.is_icon    = lnv_mb.ICON_SUCCESS
lnv_mb.is_message = "[b]1 240 Zeilen[/b] übernommen.[br][br]" &
                  + "[accent]18 Duplikate[/accent] wurden übersprungen."

lnv_mb.of_add_button(/*text*/ "OK", /*standard*/ true, /*abbrechen*/ false)
lnv_mb.of_show(/*hwnd*/ Handle(this))

Kontrollkästchen „nicht mehr nachfragen" #

n_pbt_messagebox lnv_mb

lnv_mb = create n_pbt_messagebox

lnv_mb.is_title    = "Löschen"
lnv_mb.is_icon     = lnv_mb.ICON_WARNING
lnv_mb.is_message  = "Die ausgewählten Zeilen löschen ? Diese Aktion kann nicht rückgängig gemacht werden."
lnv_mb.is_checkbox = "Nicht mehr nachfragen"
lnv_mb.ib_checked  = false

lnv_mb.of_add_button(/*text*/ "Löschen", /*standard*/ true,  /*abbrechen*/ false)
lnv_mb.of_add_button(/*text*/ "Abbrechen",   /*standard*/ false, /*abbrechen*/ true)

if lnv_mb.of_show(/*hwnd*/ Handle(this)) = 1 then
    of_supprimer()
    // Die Wahl des Benutzers merken
    ib_confirmer_suppression = not lnv_mb.of_checked()
end if

destroy lnv_mb

Schaltfläche mit Countdown #

lnv_mb.is_title   = "Neustart"
lnv_mb.is_icon    = lnv_mb.ICON_INFORMATION
lnv_mb.is_message = "Die Anwendung wird neu gestartet, um das Update anzuwenden."

// "Weiter" bleibt 3 Sekunden lang grau (ein Zaehler wird angezeigt)
lnv_mb.of_add_button_timed(/*text*/ "Weiter", /*standard*/ true, /*abbrechen*/ false, &
                           /*aktiv_sekunden*/ 3, /*klick_sekunden*/ 0)

// "Spaeter" klickt sich nach 10 Sekunden von selbst
lnv_mb.of_add_button_timed(/*text*/ "Später", /*standard*/ false, /*abbrechen*/ true, &
                           /*aktiv_sekunden*/ 0, /*klick_sekunden*/ 10)

lnv_mb.of_show(/*hwnd*/ Handle(this))

Lange Meldung: die Größe begrenzen #

// Ein umfangreicher Text : das Dialogfeld ist gedeckelt und der Text scrollt
lnv_mb.is_title      = "Versionshinweise"
lnv_mb.is_message    = ls_notes
lnv_mb.il_max_width  = 480
lnv_mb.il_max_height = 320

lnv_mb.of_add_button(/*text*/ "Schließen", /*standard*/ true, /*abbrechen*/ true)
lnv_mb.of_show(/*hwnd*/ Handle(this))

Eine Instanz wiederverwenden #

// Eine Fensterinstanz, mehrere Dialoge : of_reset zwischen jedem Aufruf
inv_mb.of_reset()      // loescht die Eigenschaften UND die vorherigen Schaltflaechen

inv_mb.is_title   = "Zweiter Dialog"
inv_mb.is_message = "Jedes of_reset beginnt wieder mit einem leeren Dialogfeld."
inv_mb.of_add_button(/*text*/ "OK", /*standard*/ true, /*abbrechen*/ false)
inv_mb.of_show(/*hwnd*/ Handle(this))

Best Practices #

• Rufen Sie immer of_reset() auf, bevor Sie eine wiederverwendete Instanz neu konfigurieren: Andernfalls werden die Schaltflächen des vorherigen Dialogs zu den neuen hinzugefügt.
• Kennzeichnen Sie grundsätzlich eine Standard-Schaltfläche und eine Abbrechen-Schaltfläche: Wer die Tastatur benutzt, erwartet Eingabetaste und Esc.
• Prüfen Sie den Rückgabewert 0: Er bedeutet, dass das Dialogfeld ohne Auswahl geschlossen wurde (Kreuz oder Esc). Behandeln Sie ihn wie ein Abbrechen.
• Übergeben Sie Handle(this) (oder Handle(parent)) als aufrufendes Fenster: Das Dialogfeld zentriert sich darauf und die Modalität bezieht sich auf das richtige Fenster.
• Reservieren Sie Rot und ICON_ERROR für echte Fehler; eine gewöhnliche Bestätigung verdient ICON_QUESTION.
• Für eine Information, die keinerlei Antwort erfordert, ziehen Sie eine nicht blockierende Benachrichtigung vor: siehe toaster.

← Komponentenreferenz · Inhalt des Handbuchs