Clase wxDirPickerCtrl
Este control permite al usuario seleccionar un directorio.
Jerarquía:
La implementación genérica es un botón que abre un wxDirDialog cuando se hace clic en él. La implementación nativa puede diferir, pero suele ser un widget (pequeño) que da acceso al cuadro de diálogo de selección de directorios. Sólo está disponible si wxUSE_DIRPICKERCTRL está establecido en 1 (el valor predeterminado).
Estilos
Esta clase admite los siguientes estilos:
- wxDIRP_DEFAULT_STYLE
- El estilo predeterminado: incluye wxDIRP_DIR_MUST_EXIST y, sólo en wxMSW, wxDIRP_USE_TEXTCTRL.
- wxDIRP_USE_TEXTCTRL
- Crea un control de texto a la izquierda del botón selector que está completamente gestionado por wxDirPickerCtrl y que el usuario puede utilizar para especificar una ruta (ver SetPath). El control de texto se sincroniza automáticamente con el valor del botón. Utilizar las funciones definidas en wxPickerBase para modificar el control de texto.
- wxDIRP_DIR_MUST_EXIST
- Crea un selector que permite seleccionar sólo directorios existentes en el cuadro de diálogo emergente wxDirDialog. Hay que tener en cuenta que, al igual que con wxFLP_FILE_MUST_EXIST, sigue siendo posible introducir un directorio inexistente incluso cuando se especifica este archivo si también se utiliza el estilo wxDIRP_USE_TEXTCTRL. Hay que tener en cuenta también que si no se utiliza wxDIRP_USE_TEXTCTRL, la implementación nativa de wxGTK siempre utiliza este estilo, ya que no admite la selección de directorios inexistentes.
- wxDIRP_CHANGE_DIR
- Cambia el directorio de trabajo actual cada vez que el usuario cambia la selección del directorio.
- wxDIRP_SMALL
- Utiliza una versión más pequeña del control con un pequeño botón "..." en lugar del botón normal "Examinar". Esta bandera es nueva desde wxWidgets 2.9.3.
Eventos emitidos por esta clase
Las siguientes macros de controlador de eventos redirigen los eventos a los controladores de funciones miembro "func" con prototipos como:
void handlerFuncName(wxFileDirPickerEvent& event)
Macros de eventos para eventos emitidos por esta clase:
- EVT_DIRPICKER_CHANGED(id, func)
- El usuario ha cambiado el directorio seleccionado en el control utilizando el botón o el control de texto (ver wxDIRP_USE_TEXTCTRL; Hay que tener en cuenta que, en este caso, el evento sólo se activa si la entrada del usuario es válida, por ejemplo, una ruta de directorio existente).
Funciones miembro
wxDirPickerCtrl()
wxDirPickerCtrl::wxDirPickerCtrl()
Constructor por defecto.
wxDirPickerCtrl()
wxDirPickerCtrl::wxDirPickerCtrl( wxWindow * parent, wxWindowID id, const wxString & path = wxEmptyString, const wxString & message = wxDirSelectorPromptStr, const wxPoint & pos = wxDefaultPosition, const wxSize & size = wxDefaultSize, long style = wxDIRP_DEFAULT_STYLE, const wxValidator & validator = wxDefaultValidator, const wxString & name = wxDirPickerCtrlNameStr )
Inicializa el objeto y llama a Create() con todos los parámetros.
Create()
bool wxDirPickerCtrl::Create( wxWindow * parent, wxWindowID id, const wxString & path = wxEmptyString, const wxString & message = wxDirSelectorPromptStr, const wxPoint & pos = wxDefaultPosition, const wxSize & size = wxDefaultSize, long style = wxDIRP_DEFAULT_STYLE, const wxValidator & validator = wxDefaultValidator, const wxString & name = wxDirPickerCtrlNameStr )
Crea los widgets con los parámetros dados.
Parámetros
- parent
- Ventana principal, no debe ser nula.
- id
- El identificador del control.
- path
- El directorio inicial que se muestra en el control. Debe ser una ruta válida a un directorio o una cadena vacía.
- message
- El mensaje que se muestra al usuario en el wxDirDialog mostrado por el control.
- pos
- Posición inicial.
- size
- Tamaño inicial.
- style
- El estilo de la ventana, consultar los indicadores wxDIRP_*.
- validator
- Validador que se puede utilizar para comprobaciones de datos adicionales.
- name
- Nombre del control.
Devuelve
true si el control se ha creado correctamente o false si la creación ha fallado.
GetDirName()
wxFileName wxDirPickerCtrl::GetDirName() const
Devuelve la ruta absoluta del directorio seleccionado actualmente como un objeto wxFileName.
Esta función es equivalente a GetPath().
GetPath()
wxString wxDirPickerCtrl::GetPath() const
Devuelve la ruta absoluta del directorio seleccionado actualmente.
SetDirName()
void wxDirPickerCtrl::SetDirName(const wxFileName & dirname)
Igual que SetPath(), pero esta función toma un objeto wxFileName.
SetInitialDirectory()
void wxDirPickerCtrl::SetInitialDirectory(const wxString & dir)
Establece el directorio que se mostrará al comenzar a buscar directorios.
Esta función es especialmente útil para los controles de selección de directorios que inicialmente no tienen ninguna selección, ya que permite configurar el directorio que se mostrará si el usuario comienza a buscar directorios; de lo contrario, se utilizará el directorio seleccionado inicialmente, que suele ser el comportamiento deseado, por lo que el directorio especificado por esta función se ignorará en este caso.
SetPath()
void wxDirPickerCtrl::SetPath(const wxString & dirname)
Establece la ruta absoluta del directorio seleccionado actualmente.
Si el control utiliza wxDIRP_DIR_MUST_EXIST y no utiliza el estilo wxDIRP_USE_TEXTCTRL, el nombre del directorio debe ser el nombre de un directorio existente y, si no es así, la implementación nativa de wxGTK simplemente lo ignorará.
Métodos y datos heredados
Esta clase hereda los métodos y datos miembro públicos y protegidos de wxObject, wxEvtHandler, wxWindow, wxControl y wxPickerBase.