Clase wxGenericDirCtrl
Este control se puede utilizar para colocar un listado de directorios (con archivos opcionales) en una ventana arbitraria.
Jerarquía:
El control contiene una ventana wxTreeCtrl que representa la jerarquía de directorios y, opcionalmente, una ventana wxChoice que contiene una lista de filtros.
Estilos
Esta clase admite los siguientes estilos:
- wxDIRCTRL_DIR_ONLY
- Sólo muestra directorios, no archivos.
- wxDIRCTRL_3D_INTERNAL
- Utiliza bordes 3D para los controles internos. Este es el valor predeterminado.
- wxDIRCTRL_SELECT_FIRST
- Al establecer la ruta predeterminada, selecciona el primer archivo del directorio.
- wxDIRCTRL_SHOW_FILTERS
- Muestra la lista desplegable de filtros.
- wxDIRCTRL_EDIT_LABELS
- Permite editar las etiquetas de carpetas y archivos.
- wxDIRCTRL_MULTIPLE
- Permite seleccionar varios archivos y carpetas.
Eventos emitidos por esta clase
Macros de eventos para eventos emitidos por esta clase:
- EVT_DIRCTRL_SELECTIONCHANGED(id, func)
- El directorio seleccionado ha cambiado. Procesa un evento de tipo wxEVT_DIRCTRL_SELECTIONCHANGED. Hay que tener en cuenta que este evento se genera incluso para los cambios realizados por el propio programa y no sólo para los realizados por el usuario. Disponible desde wxWidgets 2.9.5.
- EVT_DIRCTRL_FILEACTIVATED(id, func)
- El usuario ha activado un archivo haciendo doble clic o pulsando Intro. Disponible desde wxWidgets 2.9.5.
Funciones miembro
wxGenericDirCtrl()
wxGenericDirCtrl::wxGenericDirCtrl()
Constructor por defecto.
wxGenericDirCtrl()
wxGenericDirCtrl::wxGenericDirCtrl( wxWindow * parent, wxWindowID id = wxID_ANY, const wxString & dir = wxDirDialogDefaultFolderStr, const wxPoint & pos = wxDefaultPosition, const wxSize & size = wxDefaultSize, long style = wxDIRCTRL_DEFAULT_STYLE, const wxString & filter = wxEmptyString, int defaultFilter = 0, const wxString & name = wxTreeCtrlNameStr )
Constructor principal.
Parámetros
- parent
- Ventana principal.
- id
- Identificador de la ventana.
- dir
- Carpeta inicial.
- pos
- Posición.
- size
- Tamaño.
- style
- Estilo de la ventana.
- filter
- Cadena de filtro, con la misma sintaxis que la de wxFileDialog. Puede estar vacía si no se utilizan filtros. Ejemplo: "Todos los archivos (*.*)|*.*|Archivos JPEG (*.jpg)|*.jpg".
- defaultFilter
- Configuración del filtro predeterminado con índice cero.
- name
- Nombre de la ventana.
~wxGenericDirCtrl()
virtual wxGenericDirCtrl::~wxGenericDirCtrl()
Destructor.
CollapsePath()
virtual bool wxGenericDirCtrl::CollapsePath(const wxString & path)
Colapsa la ruta dada.
CollapseTree()
virtual void wxGenericDirCtrl::CollapseTree()
Colapsa el árbol completo.
Create()
bool wxGenericDirCtrl::Create( wxWindow * parent, wxWindowID id = wxID_ANY, const wxString & dir = wxDirDialogDefaultFolderStr, const wxPoint & pos = wxDefaultPosition, const wxSize & size = wxDefaultSize, long style = wxDIRCTRL_DEFAULT_STYLE, const wxString & filter = wxEmptyString, int defaultFilter = 0, const wxString & name = wxTreeCtrlNameStr )
Función para construcción en dos pasos.
ExpandPath()
virtual bool wxGenericDirCtrl::ExpandPath(const wxString & path)
Intenta expandir tanto como sea posible la ruta dada, de modo que el nombre del archivo o directorio sea visible en el control de árbol.
GetDefaultPath()
virtual wxString wxGenericDirCtrl::GetDefaultPath() const
Obtiene la ruta predeterminada.
GetFilePath()
virtual wxString wxGenericDirCtrl::GetFilePath() const
Obtiene sólo la ruta del nombre de archivo seleccionado (de lo contrario, una cadena vacía).
Esta función no cuenta un directorio como una selección.
GetFilePaths()
virtual void wxGenericDirCtrl::GetFilePaths(wxArrayString & paths) const
Rellena las rutas del array con las rutas de archivo seleccionadas actualmente.
Esta función no cuenta un directorio como una selección.
GetFilter()
virtual wxString wxGenericDirCtrl::GetFilter() const
Devuelve la cadena de filtro.
GetFilterIndex()
virtual int wxGenericDirCtrl::GetFilterIndex() const
Devuelve el índice del filtro actual (basado en cero).
GetFilterListCtrl()
virtual wxDirFilterListCtrl* wxGenericDirCtrl::GetFilterListCtrl() const
Devuelve un puntero al control de la lista de filtros (si existe).
GetPath()
virtual wxString wxGenericDirCtrl::GetPath() const
Obtiene el directorio o nombre de archivo seleccionado actualmente.
GetPath()
wxString wxGenericDirCtrl::GetPath(wxTreeItemId itemId) const
Obtiene la ruta correspondiente al elemento del control de árbol dado.
GetPaths()
virtual void wxGenericDirCtrl::GetPaths(wxArrayString & paths) const
Rellena las rutas de la matriz con los directorios y nombres de archivo seleccionados.
GetRootId()
virtual wxTreeItemId wxGenericDirCtrl::GetRootId()
Devuelve el identificador raíz del control de árbol.
GetTreeCtrl()
virtual wxTreeCtrl* wxGenericDirCtrl::GetTreeCtrl() const
Devuelve un puntero al control de árbol.
Init()
virtual void wxGenericDirCtrl::Init()
Inicializa variables.
ReCreateTree()
virtual void wxGenericDirCtrl::ReCreateTree()
Contrae y expande el árbol, recreándolo así desde cero.
Se puede utilizar para actualizar el contenido del directorio mostrado.
SelectPath()
virtual void wxGenericDirCtrl::SelectPath( const wxString & path, bool select = true )
Selecciona el elemento dado.
SelectPaths()
virtual void wxGenericDirCtrl::SelectPaths(const wxArrayString & paths)
Selecciona sólo las rutas especificadas, borrando cualquier selección anterior.
Sólo es compatible cuando se establece wxDIRCTRL_MULTIPLE.
SetDefaultPath()
virtual void wxGenericDirCtrl::SetDefaultPath(const wxString & path)
Establece la ruta predeterminada.
SetFilter()
virtual void wxGenericDirCtrl::SetFilter(const wxString & filter)
Establece la cadena de filtro.
SetFilterIndex()
virtual void wxGenericDirCtrl::SetFilterIndex(int n)
Establece el índice del filtro actual (basado en cero).
SetPath()
virtual void wxGenericDirCtrl::SetPath(const wxString & path)
Establece la ruta actual.
ShowHidden()
virtual void wxGenericDirCtrl::ShowHidden(bool show)
Parámetros
- mostrar
- Si es verdadero, el control mostrará las carpetas y archivos ocultos. Si es falso, no se mostrarán.
UnselectAll()
virtual void wxGenericDirCtrl::UnselectAll()
Elimina la selección de todos los elementos seleccionados actualmente.
Métodos y datos heredados
Esta clase hereda los métodos y datos miembro públicos y protegidos de wxObject, wxEvtHandler, wxWIndow y wxControl.