messagebox — n_pbt_messagebox #

← Referencia de componentes · Índice de la guía

Cuadro de diálogo modal con tema, de resultado síncrono: el sustituto directo del MessageBox() de PowerBuilder, con texto enriquecido, botones libres, iconos y casilla de verificación.

▶ Verlo en vivo — Aplicación de demostración, mosaico Message box: la vista previa, el código que lo genera y esta página, uno al lado del otro.

De un vistazo #

A diferencia de los componentes visuales, este objeto no se inserta en una ventana: se crea, configura, muestra y destruye.

n_pbt_messagebox lnv_mb

lnv_mb = create n_pbt_messagebox
// ... configuracion ...
destroy lnv_mb

Inicio rápido #

n_pbt_messagebox lnv_mb

lnv_mb = create n_pbt_messagebox

lnv_mb.is_title   = "Eliminación"
lnv_mb.is_icon    = lnv_mb.ICON_WARNING
lnv_mb.is_message = "¿Eliminar definitivamente [b]12 carpetas[/b]?[br][br]Esta acción es irreversible."

lnv_mb.of_add_button(/*texto*/ "Eliminar", /*predeterminado*/ true,  /*cancelacion*/ false)   // -> 1
lnv_mb.of_add_button(/*texto*/ "Cancelar",   /*predeterminado*/ false, /*cancelacion*/ true)    // -> 2

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

destroy lnv_mb

of_show espera la respuesta del usuario: la línea siguiente no se ejecuta hasta después del clic, exactamente igual que con MessageBox().

Propiedades #

Deben establecerse antes de of_show.

Constantes #

Métodos #

La etiqueta de un botón acepta el texto enriquecido con etiquetas y el mnemotécnico & ("&Guardar" subraya la G y lo activa con Alt+G); && muestra un ampersand literal.

El teclado #

Al abrirse, ningún botón tiene contorno de foco: es intencionado, y es el comportamiento de los cuadros de diálogo modernos de Windows. El borde solo aparece tras una primera pulsación de Tab, es decir, cuando el usuario pasa explícitamente al teclado. Intro y Esc permanecen activos desde el primer segundo, incluso sin foco visible.

Ejemplos #

Pregunta cerrada con botón predeterminado #

n_pbt_messagebox lnv_mb
long ll_reponse

lnv_mb = create n_pbt_messagebox

lnv_mb.is_title   = "Guardar los cambios"
lnv_mb.is_icon    = lnv_mb.ICON_QUESTION
lnv_mb.is_message = "La carpeta se ha modificado. ¿Desea guardar antes de cerrar?"

lnv_mb.of_add_button(/*texto*/ "&Guardar",     /*predeterminado*/ true,  /*cancelacion*/ false)  // 1
lnv_mb.of_add_button(/*texto*/ "&No guardar", /*predeterminado*/ false, /*cancelacion*/ false) // 2
lnv_mb.of_add_button(/*texto*/ "Cancelar",          /*predeterminado*/ false, /*cancelacion*/ 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 : no se cierra
end choose

Mensaje enriquecido e icono #

lnv_mb.is_title   = "Importación finalizada"
lnv_mb.is_icon    = lnv_mb.ICON_SUCCESS
lnv_mb.is_message = "[b]1 240 líneas[/b] integradas.[br][br]" &
                  + "[accent]18 duplicados[/accent] se han ignorado."

lnv_mb.of_add_button(/*texto*/ "Aceptar", /*predeterminado*/ true, /*cancelacion*/ false)
lnv_mb.of_show(/*hwnd*/ Handle(this))

Casilla «no volver a preguntar» #

n_pbt_messagebox lnv_mb

lnv_mb = create n_pbt_messagebox

lnv_mb.is_title    = "Eliminación"
lnv_mb.is_icon     = lnv_mb.ICON_WARNING
lnv_mb.is_message  = "¿Eliminar las líneas seleccionadas? Esta acción es irreversible."
lnv_mb.is_checkbox = "No volver a preguntar"
lnv_mb.ib_checked  = false

lnv_mb.of_add_button(/*texto*/ "Eliminar", /*predeterminado*/ true,  /*cancelacion*/ false)
lnv_mb.of_add_button(/*texto*/ "Cancelar",   /*predeterminado*/ false, /*cancelacion*/ true)

if lnv_mb.of_show(/*hwnd*/ Handle(this)) = 1 then
    of_supprimer()
    // Memorizar la eleccion del usuario
    ib_confirmer_suppression = not lnv_mb.of_checked()
end if

destroy lnv_mb

Botón con cuenta atrás #

lnv_mb.is_title   = "Reinicio"
lnv_mb.is_icon    = lnv_mb.ICON_INFORMATION
lnv_mb.is_message = "La aplicación se va a reiniciar para aplicar la actualización."

// "Continuar" permanece atenuado 3 segundos (se muestra un contador)
lnv_mb.of_add_button_timed(/*texto*/ "Continuar", /*predeterminado*/ true, /*cancelacion*/ false, &
                           /*segundos_activo*/ 3, /*segundos_clic*/ 0)

// "Mas tarde" se pulsa solo al cabo de 10 segundos
lnv_mb.of_add_button_timed(/*texto*/ "Más tarde", /*predeterminado*/ false, /*cancelacion*/ true, &
                           /*segundos_activo*/ 0, /*segundos_clic*/ 10)

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

Mensaje largo: limitar el tamaño #

// Un texto voluminoso : el cuadro esta limitado y el cuerpo se desplaza
lnv_mb.is_title      = "Notas de la versión"
lnv_mb.is_message    = ls_notes
lnv_mb.il_max_width  = 480
lnv_mb.il_max_height = 320

lnv_mb.of_add_button(/*texto*/ "Cerrar", /*predeterminado*/ true, /*cancelacion*/ true)
lnv_mb.of_show(/*hwnd*/ Handle(this))

Reutilizar una instancia #

// Una instancia de ventana, varios dialogos : of_reset entre cada llamada
inv_mb.of_reset()      // borra las propiedades Y los botones anteriores

inv_mb.is_title   = "Segundo diálogo"
inv_mb.is_message = "Cada of_reset vuelve a empezar con un cuadro en blanco."
inv_mb.of_add_button(/*texto*/ "Aceptar", /*predeterminado*/ true, /*cancelacion*/ false)
inv_mb.of_show(/*hwnd*/ Handle(this))

Buenas prácticas #

• Llame siempre a of_reset() antes de reconfigurar una instancia reutilizada: sin ello, los botones del diálogo anterior se suman a los nuevos.
• Marque sistemáticamente un botón predeterminado y un botón de cancelación: quien usa el teclado espera Intro y Esc.
• Compruebe el valor de retorno 0: significa que el cuadro se ha cerrado sin elección (cruz o Esc). Trátelo como una cancelación.
• Pase Handle(this) (o Handle(parent)) como ventana llamante: el cuadro se centra sobre ella y la modalidad afecta a la ventana correcta.
• Reserve el rojo e ICON_ERROR para los errores reales; una confirmación corriente merece ICON_QUESTION.
• Para una información que no requiere ninguna respuesta, prefiera una notificación no bloqueante: véase toaster.

← Referencia de componentes · Índice de la guía