Clase wxPropertySheetDialog
Esta clase representa un cuadro de diálogo de hoja de propiedades: un cuadro de diálogo con pestañas para mostrar la configuración.
Jerarquía:
Está optimizada para mostrar pestañas planas en dispositivos PocketPC y se puede personalizar para utilizar diferentes controladores en lugar del estilo de cuaderno predeterminado.
Por ejemplo:
bool MyPropertySheetDialog::Create(...)
{
if (!wxPropertySheetDialog::Create(...))
return false;
CreateButtons(wxOK|wxCANCEL|wxHELP);
// Añadir página
wxPanel* panel = new wxPanel(GetBookCtrl(), ...);
GetBookCtrl()->AddPage(panel, "General");
LayoutDialog();
return true;
}
Si es necesario, sobrescribir CreateBookCtrl() y AddBookCtrl() para crear y añadir un tipo diferente de control de libro. A continuación, se deberá utilizar una construcción en dos pasos para el cuadro de diálogo o cambiar el estilo del control de libro llamando a SetSheetStyle() antes de llamar a Create().
El ejemplo Dialogs muestra el uso de esta clase con controladores de cuadernos y libros de herramientas (para cuadros de diálogo de configuración de estilo Windows y Mac).
Para hacer que las páginas del cuadro de diálogo se desplacen cuando la pantalla sea demasiado pequeña para mostrar todo el cuadro de diálogo, se puede activar la adaptación del diseño de forma global con wxDialog::EnableLayoutAdaptation() o por cuadro de diálogo con wxDialog::SetLayoutAdaptationMode().
Para obtener más información sobre la adaptación del diseño, consultar Cuadros de diálogo con desplazamiento automático.
Funciones miembro
wxPropertySheetDialog()
wxPropertySheetDialog::wxPropertySheetDialog()
Constructor predeterminado.
Llamar a Create si utiliza este tipo de constructor.
wxPropertySheetDialog()
wxPropertySheetDialog::wxPropertySheetDialog( wxWindow * parent, wxWindowID id, const wxString & title, const wxPoint & pos = wxDefaultPosition, const wxSize & size = wxDefaultSize, long style = wxDEFAULT_DIALOG_STYLE, const wxString & name = wxDialogNameStr )
Constructor.
AddBookCtrl()
virtual void wxPropertySheetDialog::AddBookCtrl(wxSizer * sizer)
Sobrescribir esta opción si se desea añadir el control del libro de una forma diferente a la estándar (por ejemplo, utilizando un espaciado diferente).
Create()
bool wxPropertySheetDialog::Create( wxWindow * parent, wxWindowID id, const wxString & title, const wxPoint & pos = wxDefaultPosition, const wxSize & size = wxDefaultSize, long style = wxDEFAULT_DIALOG_STYLE, const wxString & name = wxDialogNameStr )
Llámarla desde la propia función Create, antes de añadir botones y páginas.
CreateBookCtrl()
virtual wxBookCtrlBase* wxPropertySheetDialog::CreateBookCtrl()
Sobrescribir si se desea crear un tipo diferente de control de libro; de forma predeterminada, el valor pasado a SetSheetStyle() se utiliza para determinar el control.
El comportamiento predeterminado es crear un cuaderno, excepto en teléfonos inteligentes, donde se utiliza un libro de opciones.
CreateButtons()
virtual void wxPropertySheetDialog::CreateButtons(int flags = wxOK|wxCANCEL)
Llamela para crear los botones del cuadro de diálogo.
Esto llama a wxDialog::CreateButtonSizer(), y los indicadores son los mismos.
Nota: En PocketPC, no se crean botones.
GetBookCtrl()
wxBookCtrlBase* wxPropertySheetDialog::GetBookCtrl() const
Devuelve el control del libro que contendrá tus páginas de configuración.
GetContentWindow()
virtual wxWindow* wxPropertySheetDialog::GetContentWindow() const
Sobrescribair para devolver una ventana que contenga el contenido principal del cuadro de diálogo.
Esto resulta especialmente útil cuando el cuadro de diálogo implementa páginas, como wxPropertySheetDialog, y permite que el código de adaptación del diseño sepa que sólo las páginas deben poder desplazarse.
Reimplementado desde wxDialog.
GetInnerSizer()
wxSizer* wxPropertySheetDialog::GetInnerSizer() const
Devuelve el controlador interno que contiene el control del libro y el controlador del botón.
GetSheetInnerBorder()
int wxPropertySheetDialog::GetSheetInnerBorder() const
Devuelve sólo el borde alrededor del control del libro.
GetSheetOuterBorder()
int wxPropertySheetDialog::GetSheetOuterBorder() const
Devuelve el borde que rodea todo el cuadro de diálogo.
GetSheetStyle()
long wxPropertySheetDialog::GetSheetStyle() const
Devuelve el estilo de la hoja.
Consultar SetSheetStyle() para conocer los valores permitidos.
LayoutDialog()
virtual void wxPropertySheetDialog::LayoutDialog(int centreFlags = wxBOTH)
Llamarla para diseñar el cuadro de diálogo.
Nota: En PocketPC, esto no hace nada, ya que el cuadro de diálogo se mostrará a pantalla completa y el diseño se realizará cuando el cuadro de diálogo reciba un evento de tamaño.
SetBookCtr()
void wxPropertySheetDialog::SetBookCtr(wxBookCtrlBase * bookCtrl)
Establece el control del libro utilizado para el cuadro de diálogo.
Normalmente no será necesario utilizarlo.
SetInnerSizer()
void wxPropertySheetDialog::SetInnerSizer(wxSizer * sizer)
Establece el tamaño interior que contiene el control del libro y el tamaño del botón.
SetSheetInnerBorder()
void wxPropertySheetDialog::SetSheetInnerBorder(int border)
Establece el borde sólo alrededor del control del libro.
SetSheetOuterBorder()
void wxPropertySheetDialog::SetSheetOuterBorder(int border)
Establece el borde alrededor de todo el cuadro de diálogo.
SetSheetStyle()
void wxPropertySheetDialog::SetSheetStyle(long style)
Se puede personalizar el aspecto del cuadro de diálogo configurando el estilo de la hoja.
Esta es una lista de valores de wxPropertySheetDialogFlags.
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.