messagebox — n_pbt_messagebox #

← Riferimento dei componenti · Sommario della guida

Finestra di dialogo modale a tema, con esito sincrono: il sostituto diretto del MessageBox() di PowerBuilder, con testo formattato, pulsanti liberi, icone e casella di controllo.

▶ Vederlo dal vivo — Applicazione dimostrativa, riquadro Message box: l'anteprima, il codice che lo produce e questa pagina, affiancati.

In breve #

A differenza dei componenti visuali, questo oggetto non si inserisce in una finestra: lo si crea, configura, mostra, distrugge.

n_pbt_messagebox lnv_mb

lnv_mb = create n_pbt_messagebox
// ... configurazione ...
destroy lnv_mb

Avvio rapido #

n_pbt_messagebox lnv_mb

lnv_mb = create n_pbt_messagebox

lnv_mb.is_title   = "Eliminazione"
lnv_mb.is_icon    = lnv_mb.ICON_WARNING
lnv_mb.is_message = "Eliminare definitivamente [b]12 cartelle[/b] ?[br][br]Questa azione è irreversibile."

lnv_mb.of_add_button(/*testo*/ "Elimina", /*predefinito*/ true,  /*annullamento*/ false)   // -> 1
lnv_mb.of_add_button(/*testo*/ "Annulla",   /*predefinito*/ false, /*annullamento*/ true)    // -> 2

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

destroy lnv_mb

of_show attende la risposta dell'utente: la riga successiva viene eseguita solo dopo il clic, esattamente come con MessageBox().

Proprietà #

Da impostare prima di of_show.

Costanti #

Metodi #

L'etichetta di un pulsante accetta il testo formattato con tag e il mnemonico & ("&Salva" sottolinea la S e la attiva con Alt+S); && mostra una e commerciale letterale.

La tastiera #

All'apertura nessun pulsante ha un contorno di focus: è voluto, ed è il comportamento delle finestre di dialogo Windows moderne. Il bordo appare solo dopo una prima pressione di Tab, cioè quando l'utente passa esplicitamente alla tastiera. Invio ed Esc restano attivi fin dal primo secondo, anche senza focus visibile.

Esempi #

Domanda chiusa con pulsante predefinito #

n_pbt_messagebox lnv_mb
long ll_reponse

lnv_mb = create n_pbt_messagebox

lnv_mb.is_title   = "Salvare le modifiche"
lnv_mb.is_icon    = lnv_mb.ICON_QUESTION
lnv_mb.is_message = "La cartella è stata modificata. Vuole salvare prima di chiudere ?"

lnv_mb.of_add_button(/*testo*/ "&Salva",     /*predefinito*/ true,  /*annullamento*/ false)  // 1
lnv_mb.of_add_button(/*testo*/ "&Non salvare", /*predefinito*/ false, /*annullamento*/ false) // 2
lnv_mb.of_add_button(/*testo*/ "Annulla",          /*predefinito*/ false, /*annullamento*/ 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 o 0 : non si chiude
end choose

Messaggio formattato e icona #

lnv_mb.is_title   = "Importazione completata"
lnv_mb.is_icon    = lnv_mb.ICON_SUCCESS
lnv_mb.is_message = "[b]1 240 righe[/b] integrate.[br][br]" &
                  + "[accent]18 duplicati[/accent] sono stati ignorati."

lnv_mb.of_add_button(/*testo*/ "OK", /*predefinito*/ true, /*annullamento*/ false)
lnv_mb.of_show(/*hwnd*/ Handle(this))

Casella «non chiedermelo più» #

n_pbt_messagebox lnv_mb

lnv_mb = create n_pbt_messagebox

lnv_mb.is_title    = "Eliminazione"
lnv_mb.is_icon     = lnv_mb.ICON_WARNING
lnv_mb.is_message  = "Eliminare le righe selezionate ? Questa azione è irreversibile."
lnv_mb.is_checkbox = "Non chiedermelo più"
lnv_mb.ib_checked  = false

lnv_mb.of_add_button(/*testo*/ "Elimina", /*predefinito*/ true,  /*annullamento*/ false)
lnv_mb.of_add_button(/*testo*/ "Annulla",   /*predefinito*/ false, /*annullamento*/ true)

if lnv_mb.of_show(/*hwnd*/ Handle(this)) = 1 then
    of_supprimer()
    // Memorizzare la scelta dell'utente
    ib_confirmer_suppression = not lnv_mb.of_checked()
end if

destroy lnv_mb

Pulsante con conto alla rovescia #

lnv_mb.is_title   = "Riavvio"
lnv_mb.is_icon    = lnv_mb.ICON_INFORMATION
lnv_mb.is_message = "L'applicazione verrà riavviata per applicare l'aggiornamento."

// "Continua" resta disattivato 3 secondi (viene mostrato un contatore)
lnv_mb.of_add_button_timed(/*testo*/ "Continua", /*predefinito*/ true, /*annullamento*/ false, &
                           /*secondi_attivo*/ 3, /*secondi_clic*/ 0)

// "Piu tardi" si clicca da solo dopo 10 secondi
lnv_mb.of_add_button_timed(/*testo*/ "Più tardi", /*predefinito*/ false, /*annullamento*/ true, &
                           /*secondi_attivo*/ 0, /*secondi_clic*/ 10)

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

Messaggio lungo: limitare le dimensioni #

// Un testo voluminoso : la finestra e limitata e il corpo scorre
lnv_mb.is_title      = "Note di rilascio"
lnv_mb.is_message    = ls_notes
lnv_mb.il_max_width  = 480
lnv_mb.il_max_height = 320

lnv_mb.of_add_button(/*testo*/ "Chiudi", /*predefinito*/ true, /*annullamento*/ true)
lnv_mb.of_show(/*hwnd*/ Handle(this))

Riutilizzare un'istanza #

// Un'istanza di finestra, piu dialoghi : of_reset tra una chiamata e l'altra
inv_mb.of_reset()      // cancella le proprieta E i pulsanti precedenti

inv_mb.is_title   = "Secondo dialogo"
inv_mb.is_message = "Ogni of_reset riparte da una finestra vergine."
inv_mb.of_add_button(/*testo*/ "OK", /*predefinito*/ true, /*annullamento*/ false)
inv_mb.of_show(/*hwnd*/ Handle(this))

Buone pratiche #

• Chiami sempre of_reset() prima di riconfigurare un'istanza riutilizzata: senza di esso i pulsanti del dialogo precedente si aggiungono ai nuovi.
• Contrassegni sistematicamente un pulsante predefinito e un pulsante di annullamento: chi usa la tastiera si aspetta Invio ed Esc.
• Verifichi il valore restituito 0: significa che la finestra è stata chiusa senza scelta (croce o Esc). Lo tratti come un annullamento.
• Passi Handle(this) (o Handle(parent)) come finestra chiamante: la finestra si centra su di essa e la modalità riguarda la finestra giusta.
• Riservi il rosso e ICON_ERROR agli errori veri; una conferma banale merita ICON_QUESTION.
• Per un'informazione che non richiede alcuna risposta, preferisca una notifica non bloccante: vedere toaster.

← Riferimento dei componenti · Sommario della guida