Clase wxFileCtrl
Este control permite al usuario seleccionar un archivo.
Jerarquía:
Existen dos implementaciones de esta clase, una para Gtk y otra genérica para todos los demás entornos.
Esta clase sólo está disponible si wxUSE_FILECTRL está establecido en 1.
Estilos
Esta clase admite los siguientes estilos:
- wxFC_DEFAULT_STYLE
- El estilo predeterminado: wxFC_OPEN.
- wxFC_OPEN
- Crea un control de archivo adecuado para abrir archivos. No se puede combinar con wxFC_SAVE.
- wxFC_SAVE
- Crea un control de archivo adecuado para guardar archivos. No se puede combinar con wxFC_OPEN.
- wxFC_MULTIPLE
- Sólo para el control de apertura, permite seleccionar varios archivos. No se puede combinar con wxFC_SAVE
- wxFC_NOSHOWHIDDEN
- Oculta la casilla de verificación "Mostrar archivos ocultos" (sólo genérico)
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(wxFileCtrlEvent& event)
Macros de eventos para eventos emitidos por esta clase:
- EVT_FILECTRL_FILEACTIVATED(id, func)
- El usuario ha activado un archivo (haciendo doble clic o pulsando Intro).
- EVT_FILECTRL_SELECTIONCHANGED(id, func)
- El usuario ha cambiado la selección actual (seleccionando o deseleccionando un archivo).
- EVT_FILECTRL_FOLDERCHANGED(id, func)
- Se ha cambiado la carpeta actual del control de archivos.
- EVT_FILECTRL_FILTERCHANGED(id, func)
- Se ha cambiado el filtro de archivos actual del control de archivos.
Funciones miembro
wxFileCtr()
wxFileCtrl::wxFileCtr()
Constructor por defecto.
wxFileCtr()
wxFileCtrl::wxFileCtrl( wxWindow * parent, wxWindowID id, const wxString & defaultDirectory = wxEmptyString, const wxString & defaultFilename = wxEmptyString, const wxString & wildCard = wxFileSelectorDefaultWildcardStr, long style = wxFC_DEFAULT_STYLE, const wxPoint & pos = wxDefaultPosition, const wxSize & size = wxDefaultSize, const wxString & name = wxFileCtrlNameStr )
Construye la ventana.
Parámetros
- parent
- Ventana principal, no debe ser nula.
- id
- El identificador del control.
- defaultDirectory
- El directorio inicial que se muestra en el control. Debe ser una ruta válida a un directorio o una cadena vacía. En caso de que sea una cadena vacía, se utiliza el directorio de trabajo actual.
- defaultFilename
- El nombre de archivo predeterminado o una cadena vacía.
- wildCard
- Un comodín que especifica qué archivos se pueden seleccionar, como "*.*" o "Archivos BMP (*.bmp)|*.bmp|Archivos GIF (*.gif)|*.gif".
- style
- El estilo de la ventana, consultar los indicadores wxFC_*.
- pos
- Posición inicial.
- size
- Tamaño inicial.
- name
- Nombre del control.
Create()
bool wxFileCtrl::Create( wxWindow * parent, wxWindowID id, const wxString & defaultDirectory = wxEmptyString, const wxString & defaultFilename = wxEmptyString, const wxString & wildCard = wxFileSelectorDefaultWildcardStr, long style = wxFC_DEFAULT_STYLE, const wxPoint & pos = wxDefaultPosition, const wxSize & size = wxDefaultSize, const wxString & name = wxFileCtrlNameStr )
Función para la construcción en dos pasos.
Consultar wxFileCtrl() para obtener más detalles.
Valor de retorno
true si el control se ha creado correctamente o false si la creación ha fallado.
GetDirectory()
virtual wxString wxFileCtrl::GetDirectory() const
Devuelve el directorio actual del control de archivos (es decir, el directorio que muestra).
GetFilename()
virtual wxString wxFileCtrl::GetFilename() const
Devuelve el nombre del archivo seleccionado actualmente.
Para los controles que tienen el estilo wxFC_MULTIPLE, utilizar GetFilenames() en su lugar.
GetFilenames()
virtual void wxFileCtrl::GetFilenames(wxArrayString & filenames) const
Rellena la matriz filenames con los nombres de archivo de los elementos seleccionados.
Esta función sólo debe utilizarse con los controles que tengan el estilo wxFC_MULTIPLE; para los demás, utilizar GetFilename().
Observaciones
filenames se vacía primero.
GetFilterIndex()
virtual int wxFileCtrl::GetFilterIndex() const
Devuelve el índice basado en cero del filtro seleccionado actualmente.
GetPath()
virtual wxString wxFileCtrl::GetPath() const
Devuelve la ruta completa (directorio y nombre de archivo) del archivo seleccionado actualmente.
Para los controles que tienen el estilo wxFC_MULTIPLE, utilizar GetPaths() en su lugar.
GetPaths()
virtual void wxFileCtrl::GetPaths(wxArrayString & paths) const
Rellena las rutas de la matriz con las rutas completas de los archivos seleccionados.
Esta función debe utilizarse con los controles que tienen el estilo wxFC_MULTIPLE; en caso contrario, utilizar GetPath().
Observaciones
paths se vacía primero.
GetWildcard()
virtual wxString wxFileCtrl::GetWildcard() const
Devuelve el comodín actual.
SetDirectory()
virtual bool wxFileCtrl::SetDirectory(const wxString & directory)
Establece (cambia) el directorio actual que se muestra en el control.
Valor de retorno
Devuelve true si se realiza correctamente, false en caso contrario.
SetFilename()
virtual bool wxFileCtrl::SetFilename(const wxString & filename)
Selecciona un archivo determinado.
Valor de retorno
Devuelve verdadero si se realiza correctamente, falso en caso contrario.
SetFilterIndex()
virtual void wxFileCtrl::SetFilterIndex(int filterIndex)
Establece el índice del filtro actual, comenzando desde cero.
SetPath()
virtual bool wxFileCtrl::SetPath(const wxString & path)
Cambia a un directorio determinado y selecciona un archivo determinado.
Si la ruta incluye la parte del directorio, este debe existir; de lo contrario, se devuelve false y no se realiza ninguna otra acción.
Valor de retorno
Devuelve true si se realiza correctamente, false en caso contrario.
SetWildcard()
virtual void wxFileCtrl::SetWildcard(const wxString & wildCard)
Establece el comodín, que puede contener varios tipos de archivos, por ejemplo: "Archivos BMP (*.bmp)|*.bmp|Archivos GIF (*.gif)|*.gif".
ShowHidden()
virtual void wxFileCtrl::ShowHidden(bool show)
Establece si se muestran o no los archivos y carpetas ocultos.
Métodos y datos heredados
Esta clase hereda los métodos y datos miembro públicos y protegidos de wxObject, wxEvtHandler, wxWindow y wxControl.