Clase wxMessageDialog

Esta clase representa un diálogo que muestra un mensaje de una o varias líneas, con una selección de botones Aceptar, Sí, No y Cancelar.

Jerarquía:

Nota sobre los iconos: aunque este diálogo define una serie de estilos relacionados con los iconos, el icono real puede o no aparecer dependiendo de las convenciones de interfaz de usuario de la plataforma actual. Por ejemplo, el tema GTK por defecto no utiliza ningún icono en los diálogos de mensajes, mientras que macOS sí utiliza un icono, pero utiliza el icono de la aplicación para los diálogos informativos.

Estilos

Esta clase soporta los siguientes estilos:

wxOK

Pone un botón Ok en el cuadro de mensaje. Puede combinarse con wxCANCEL.

wxCANCEL

Pone un botón Cancelar en el cuadro de mensaje. Debe combinarse con wxOK o wxYES_NO.

wxYES_NO

Pone botones de Sí y No en el cuadro de mensaje. Se recomienda utilizar siempre wxCANCEL con este estilo ya que de lo contrario el cuadro de mensaje no tendrá botón de cierre bajo wxMSW y el usuario se verá obligado a responder.

wxHELP

Pone un botón de Ayuda en el cuadro de mensaje. Este botón puede tener una apariencia especial o estar especialmente posicionado si su etiqueta no se cambia de la que viene por defecto. Hay que tener en cuenta que el uso de este botón no está soportado cuando se muestra un cuadro de mensaje desde un hilo no principal en wxOSX/Cocoa. Disponible desde wxWidgets 2.9.3.

wxNO_DEFAULT

Hace que el botón "No" sea el predeterminado, sólo se puede utilizar con wxYES_NO.

wxCANCEL_DEFAULT

Hace que el botón "Cancelar" sea el predeterminado, sólo se puede utilizar con wxCANCEL. Este estilo no está soportado actualmente (e ignorado) en wxOSX.

wxYES_DEFAULT

Hace que el botón "Sí" sea el predeterminado, este es el comportamiento por defecto y esta bandera existe únicamente por simetría con wxNO_DEFAULT.

wxOK_DEFAULT

Hace que el botón "OK" sea el predeterminado, este es el comportamiento por defecto y esta bandera existe únicamente por simetría con wxCANCEL_DEFAULT.

wxICON_NONE

No muestra ningún icono en el diálogo si es posible (podría seguir mostrándose un icono si la plataforma actual obliga a su uso). Este estilo puede utilizarse para evitar que el diálogo utilice el icono por defecto basado en la presencia de wxYES_NO como se explica en la documentación de wxICON_QUESTION y wxICON_INFORMATION más adelante.

wxICON_ERROR

Muestra un icono de error en el diálogo.

wxICON_WARNING

Muestra un icono de advertencia en el diálogo. Este estilo se debe utilizar para advertencias informativas o, en combinación con wxYES_NO o wxCANCEL, para preguntas que tienen consecuencias potencialmente graves (el icono de precaución se utiliza en macOS en este caso).

wxICON_QUESTION

Muestra un símbolo de interrogación. Este icono se utiliza automáticamente con wxYES_NO, por lo que normalmente no es necesario especificarlo explícitamente. Este estilo no está soportado para diálogos de mensajes bajo wxMSW porque las directrices de Microsoft indican que no se debe utilizar ningún icono para confirmaciones rutinarias. Si se especifica, no se mostrará ningún icono.

wxICON_INFORMATION

Muestra un símbolo de información. Este icono se utiliza por defecto si no se indica wxYES_NO, por lo que no suele ser necesario especificarlo explícitamente.

wxICON_EXCLAMATION

Alias de wxICON_WARNING.

wxICON_HAND

Alias de wxICON_ERROR.

wxICON_AUTH_NEEDED

Muestra un símbolo de autenticación necesaria. Este estilo sólo está soportado para diálogos de mensajes bajo wxMSW. En otros casos se utilizará la lógica de selección de iconos por defecto. Hay que tener en cuenta que puede combinarse con otros estilos para proporcionar una alternativa. Por ejemplo, usando wxICON_AUTH_NEEDED | wxICON_QUESTION se mostrará un símbolo de escudo en Windows Vista o superior y un símbolo de pregunta en otras plataformas. Disponible desde wxWidgets 2.9.5.

wxSTAY_ON_TOP

Hace que el cuadro de mensaje permanezca encima de todas las demás ventanas y no sólo de su padre (actualmente implementado sólo en MSW y GTK).

wxCENTRE

Centra el cuadro de mensaje en su padre o en la pantalla si no se especifica el padre. Establecer este estilo en MSW no supone ninguna diferencia, ya que el cuadro de diálogo siempre se centra en la ventana padre.

Funciones miembro

wxMessageDialog()

GetCancelLabel()

GetCaption()

GetEffectiveIcon()

GetExtendedMessage()

GetHelpLabel()

GetMessage()

GetMessageDialogStyle()

GetNoLabel()

GetOKLabel()

GetYesLabel()

HasCustomLabels()

SetExtendedMessage()

SetHelpLabel()

SetMessage()

SetOKCancelLabels()

SetOKLabel()

SetYesNoCancelLabels()

SetYesNoLabels()

wxMessageDialog dlg(...);
dlg.SetYesNoLabels(wxID_SAVE, _("&Don't save"));

wxMessageDialog dlg(...);
if ( dlg.SetYesNoLabels(_("&Quit"), _("&Don't quit")) )
    dlg.SetMessage(_("What do you want to do?"));
else // buttons have standard "Yes"/"No" values, so rephrase the question
    dlg.SetMessage(_("Do you really want to quit?"));

ShowModal()

Métodos y datos heredados

Esta clase hereda los métodos y datos miembro públicos y protegidos de wxDialog, wxTopLevelWindow, wxNonOwnedWindow, wxWindow, wxEvtHandler y wxObject.