Clase wxDialog

Constructor por defecto.

Constructor.

Parámetros

parent

Puede ser NULL, un marco u otro cuadro de diálogo.

id

Un identificador para el cuadro de diálogo. Un valor de -1 se toma por defecto.

title

El título del diálogo.

pos

La posición del diálogo. El valor wxDefaultPosition indica una posición por defecto, elegida por el sistema de ventanas o por wxWidgets, dependiendo de la plataforma.

size

El tamaño del diálogo. El valor wxDefaultSize indica el tamaño por defecto, elegido por el sistema de ventanas o por wxWidgets, dependiendo de la plataforma.

style

El estilo de la ventana.

name

Se utiliza para asociar un nombre a la ventana, permitiendo al usuario de la aplicación establecer valores de recursos Motif para cuadros de diálogo individuales.

Ver también

Creater().

Destructor.

Borra cualquier ventana hija antes de borrar la ventana física.

Añade un identificador que se considerará botón principal para la zona no desplazable de un cuadro de diálogo.

Devuelve true si este diálogo puede y debe realizar la adaptación del diseño utilizando DoLayoutAdaptation(), normalmente si el diálogo es demasiado grande para caber en la pantalla.

Centra el cuadro de diálogo en la pantalla.

Parámetros

direction

Puede ser wxHORIZONTAL, wxVERTICAL o wxBOTH.

Se utiliza para la construcción de cuadros de diálogo en dos pasos.

Ver wxDialog.

Crea un sizer con botones estándar.

flags es una lista de bits de los siguientes flags: wxOK, wxCANCEL, wxYES, wxNO, wxAPPLY, wxCLOSE, wxHELP, wxNO_DEFAULT.

El tamaño de los botones se adapta a la plataforma.

Esta función utiliza CreateStdDialogButtonSizer() internamente para la mayoría de las plataformas pero no crea el sizer en absoluto para las plataformas con botones hardware (como los smartphones) para las que configura los botones hardware apropiadamente y devuelve NULL, así que no se debe olvidar comprobar que el valor de retorno es válido antes de utilizarlo.

Crea un sizer con botones estándar mediante CreateButtonSizer() separados del resto del contenido del diálogo por una wxStaticLine horizontal.

Nota: Al igual que CreateButtonSizer(), esta función puede devolver NULL si no se han creado botones.

Se trata de una combinación de CreateButtonSizer() y CreateSeparatedSizer().

Devuelve el sizer que contiene el dado con un wxStaticLine de separación si es necesario.

Esta función es útil para crear el sizer que contiene contenidos tipo pie de página en cuadros de diálogo. Añadirá una línea estática de separación sólo si se ajusta a la convención de la plataforma actual (actualmente no se añade en Mac donde se desaconseja el uso de líneas estáticas para agrupar y se añade en otro lugar).

Parámetros

sizer

El sizer a envolver, debe ser no NULL.

Valor de retorno

El sizer que envuelve al de entrada o posiblemente el propio sizer de entrada si no es necesario envolverlo.

Crea un wxStdDialogButtonSizercon botones estándar.

flags es una lista de bits de los siguientes flags: wxOK, wxCANCEL, wxYES, wxNO, wxAPPLY, wxCLOSE, wxHELP, wxNO_DEFAULT.

El tamaño de los botones se adapta a la plataforma.

Divide el texto en nuevas líneas y coloca las líneas en objetos wxStaticText con la anchura máxima especificada en un wxBoxSizer vertical.

Si widthMax tiene su valor por defecto de -1, solo se tienen en cuenta los caracteres explícitos de nueva línea en el mensaje. De lo contrario, las líneas se rompen después de una nueva línea o se envuelven, en el límite de la palabra, si su anchura fuera mayor que la anchura máxima especificada.

Parámetros

mensaje

El texto que se va a mostrar.

widthMax

Especifica la anchura máxima del texto (este argumento está disponible desde la versión 3.1.1, las versiones anteriores siempre se comportaban como si se especificara la anchura máxima de -1).

Ver también

wxStaticText::Wrap(int width).

Realiza la adaptación del diseño, normalmente si el diálogo es demasiado grande para caber en la pantalla.

Finaliza un diálogo modal, pasando un valor a devolver desde la invocación ShowModal().

Parámetros

retCode

El valor que debe devolver ShowModal.

Ver también

ShowModal(), GetReturnCode(), SetReturnCode()

Obtiene el identificador del botón que funciona como botón OK estándar en este diálogo.

Ver también

SetAffirmativeId().

Sobreescrir este método para devolver una ventana que contenga el contenido principal del diálogo.

Esto es particularmente útil cuando el diálogo implementa páginas, como wxPropertySheetDialog, y permite que el código de adaptación del diseño sepa que solo las páginas necesitan ser desplazables.

Reimplementado en wxPropertySheetDialog.

Obtiene el identificador del botón al que se asignan las pulsaciones del botón ESC.

Ver también

SetEscapeId().

Devuelve true si el diálogo ha sido adaptado, normalmente haciéndolo desplazable para trabajar con una pantalla pequeña.

Obtiene un valor que representa la agresividad de la búsqueda de botones y selectores en la parte no desplazable de un diálogo adaptado.

Cero desactiva la adaptación, y 3 permite la búsqueda de botones estándar en cualquier parte del diálogo.

Obtiene el modo de adaptación, anulando la bandera de adaptación global.

Devuelve una matriz de identificadores que se considerarán los botones principales de la zona no desplazable de un cuadro de diálogo.

Obtiene el código de retorno de esta ventana.

Observaciones

Un código de retorno está normalmente asociado a un diálogo modal, donde ShowModal() devuelve un código a la aplicación.

Ver también

SetReturnCode(), ShowModal(), EndModal().

En PocketPC, se proporciona automáticamente un cuadro de diálogo con una barra de herramientas vacía.

Esta función permite acceder a la barra de herramientas y añadirle herramientas. Actualmente no es posible eliminar herramientas ni añadir controles arbitrarios.

Esta función no está disponible en ninguna otra plataforma.

Disponibilidad: solo disponible para la versión wxMSW.

Iconiza o restaura el diálogo.

Sólo para Windows.

Parámetros

iconize

Si es true, iconiza el cuadro de diálogo; si es false, lo muestra y lo restaura.

Observaciones

Hay que tener en cuenta que en Windows, la iconización no tiene ningún efecto, ya que los cuadros de diálogo no se pueden iconizar. Sin embargo, las aplicaciones pueden necesitar restaurar explícitamente los cuadros de diálogo en Motif que tienen marcos iconizables por el usuario, y en Windows llamar a Iconize(false) traerá la ventana al frente, al igual que Show(true).

Reimplementado de wxTopLevelWindow.

Devuelve true si el cuadro de diálogo está iconizado.

Solo para Windows.

Observaciones

Siempre devuelve false bajo Windows ya que los cuadros de diálogo no pueden ser iconizados.

Reimplementado de wxTopLevelWindow.

Devuelve true si id está en el array de identificadores a considerar como botones principales para el área no desplazable de un diálogo.

Disponibilidad: sólo disponible para la versión wxMSW.

Devuelve true si el cuadro de diálogo es modal, false en caso contrario.

Establece el identificador que se utilizará como botón Aceptar.

Cuando se pulsa el botón con este identificador, el diálogo llama a wxWindow::Validate() y a wxWindow::TransferDataFromWindow() y, si ambos devuelven verdadero, cierra el diálogo con el código de retorno del identificador afirmativo.

Además, cuando el usuario pulsa un botón hardware OK en los dispositivos que disponen de uno o el botón especial OK en la barra de título de PocketPC, se genera un evento con este id.

Por defecto, el id afirmativo es wxID_OK.

Ver también

GetAffirmativeId(), SetEscapeId().

Establece el identificador del botón que debería funcionar como el botón "Cancelar" estándar en este diálogo.

Cuando se pulsa el botón con este identificador, se cierra el diálogo. Además, cuando el usuario pulsa la tecla ESC en el diálogo o cierra el diálogo utilizando el botón cerrar en la barra de título, esto se asigna al clic del botón con el id especificado.

Por defecto, el id de escape es el valor especial wxID_ANY lo que significa que se utiliza el botón wxID_CANCEL si está presente en el diálogo y en caso contrario se utiliza el botón con GetAffirmativeId(). Otro valor especial para id es wxID_NONE que significa que las pulsaciones ESC deben ser ignoradas. Si se da cualquier otro valor, se interpreta como el id del botón al que asignar la tecla de escape.

Nota: Este método debe utilizarse para diálogos modales personalizados implementados en el propio wxWidgets, los diálogos nativos como wxMessageDialog o wxFileDialog, manejan las pulsaciones ESC de su propia manera que no puede ser personalizada.

Establece el icono de este diálogo.

Parámetros

icon

El icono que se asociará a este diálogo.

Establece los iconos de este diálogo.

Parámetros

icons

Los iconos a asociar con este diálogo.

Marca el diálogo como adaptado, normalmente haciéndolo desplazable para trabajar con una pantalla pequeña.

Establece la agresividad de la búsqueda de botones y medidores en la parte no desplazable de un diálogo adaptado al diseño.

Cero desactiva la adaptación, y 3 permite la búsqueda de botones estándar en cualquier parte del diálogo.

Establece el modo de adaptación, anulando la bandera de adaptación global.

Establece el código de retorno para esta ventana.

Un código de retorno se asocia normalmente con un diálogo modal, donde ShowModal() devuelve un código a la aplicación. La función EndModal() llama a SetReturnCode().

Parámetros

retCode

El código de retorno entero, normalmente un identificador de control.

Ver también

GetReturnCode(), ShowModal(), EndModal().

Oculta o muestra el diálogo.

La forma preferida de cerrar un diálogo modal es utilizar EndModal().

Parámetros

show

Si es true, el cuadro de diálogo se muestra y se trae al frente, de lo contrario el cuadro se oculta. Si es false y el diálogo es modal, el control se devuelve al programa que lo llama.

Reimplementado de wxWindow.

Muestra un diálogo modal de aplicación.

El flujo del programa no vuelve hasta que el diálogo ha sido cerrado con EndModal().

Obsérvese que es posible llamar a ShowModal() para un diálogo que ha sido mostrado previamente con Show(), esto permite hacer modal un diálogo no modal existente. Sin embargo ShowModal() no puede ser llamada dos veces sin que intervenga EndModal().

Hay que tener en cuenta que esta función crea un bucle de eventos temporal que tiene prioridad sobre el bucle de eventos principal de la aplicación (véase wxEventLoopBase) y que se destruye cuando se cierra el diálogo. Esto también resulta en una llamada a wxApp::ProcessPendingEvents().

Valor de retorno

El valor establecido con SetReturnCode().

Ver también

ShowWindowModal(), ShowWindowModalThenDo(), EndModal(), GetReturnCode(), SetReturnCode().

Reimplementado en wxTextEntryDialog, wxclass/wxMessageDialog, wxFontDialog, wxFileDialog, wxDirDialog, wxColourDialog, wxSingleChoiceDialog y wxMultiChoiceDialog.

Muestra un diálogo modal solo a la ventana de nivel superior padre.

A diferencia de ShowModal(), los diálogos mostrados con esta función solo impiden al usuario interactuar con su marco padre pero no con el resto de la aplicación. Tampoco bloquean la ejecución del programa, sino que vuelven inmediatamente, como Show(), y generan un evento wxEVT_WINDOW_MODAL_DIALOG_CLOSED (wxWindowModalDialogEvent) más tarde, cuando se cierra el diálogo.

Actualmente esta función sólo está completamente implementada en las versiones de wxOSX, en el resto de plataformas se comporta como ShowModal() (pero también envía el evento mencionado).

Ver también

wxWindowModalDialogEvent, ShowWindowModalThenDo().

Muestra un diálogo modal solo a la ventana de nivel superior padre y llama a un functor después de que se cierre el diálogo.

Igual que la otra sobrecarga ShowWindowModal(), pero llama al functor pasado como argumento al finalizar, en lugar de generar el evento wxEVT_WINDOW_MODAL_DIALOG_CLOSED.

Esta forma es particularmente útil en combinación con las lambdas de C++11, cuando permite escribir ventana-modal de forma muy similar a como se utiliza ShowModal() (con la notable excepción de no poder crear el diálogo en la pila):

wxWindowPtr<wxDialog> dlg(new wxMessageDialog(this, "¡Hola!"));
 
dlg->ShowWindowModalThenDo([this,dlg](int retcode){
    if ( retcode == wxID_OK )
        DoSomething();
    // dlg se destruye implícitamente aquí, porque el puntero fue
    // capturado explícitamente por la lambda
});

Parámetros

onEndModal

Objeto función a llamar cuando se cierra el diálogo. El functor es llamado con un único argumento entero, el código de retorno del diálogo.

Nota: La instancia del diálogo no debe ser destruida hasta que se llame a onEndModal. La mejor forma de asegurarse de ello es utilizar wxWindowPtr para mantener un puntero e incluirlo en la captura de la lambda, por valor (¡no por referencia!), como se muestra en el ejemplo anterior.

Función estática que habilita o deshabilita la adaptación del diseño para todos los diálogos.

Función estática que obtiene el objeto adaptador de diseño actual.

Una función estática que devuelve true si la adaptación del diseño está habilitada para todos los diálogos.

Una función estática para establecer el objeto adaptador de diseño actual, devolviendo el adaptador antiguo.

Si llama a esta función, debe eliminar el objeto adaptador antiguo.