FileListBox - Propiedades, métodos y eventos
El control FileListBox permite ver en un listado los archivos de un path determinado.
Propiedad Path
La propiedad por defecto del control es la propiedad Path.
Por ejemplo para cargar en el control todos los ficheros de la unidad c:windows al pulsar un botón:
Colocar un botón en el formulario y un control FileListBox. Pegar el siguiente código
- Option Explicit
-
-
-
- Private Sub Command1_Click()
- File1.Path = "c:windows"
- End Sub
-
- Private Sub Form_Load()
- Command1.Caption = "Listar c:windows"
- End Sub
Importante : El FileListBox no contiene una opción para incluir los archivos de los subdirectorios, solo visualizará los ficheros de la carpeta actual.
La propiedad path es la propiedad por defecto del control FileListBox, por lo tanto no es necesario escribirla explícitamente, por lo cual esto también es válido :
- Option Explicit
-
- Private Sub Command1_Click()
- File1 = "c:windows"
- End Sub
Nota. Los controles DirListBox y DriveListBox también tienen sus propiedades por defecto. Para el control Dir es la propiedad Path y para el Drive es la propiedad Drive, y por lo tanto cuando no escribamos ninguna propiedad, es decir solo se escriba el nombre del control y se le asigne el valor, se asumirá como Default ( la propiedad por defecto )
Propiedad Pattern - Para Filtrar Archivos
Por defecto el control FileListbox visualiza todos los archivos del directorio indicado. Para listar archivos en forma filtrada, por ejemplo solo los Txt, solo archivos bmp, o un conjunto de extensiones : Solo Exe, dll y Bat por mencionar algunos tipos de ficheros, se utiliza la propiedad Pattern. A esta propiedad le debemos indicar la extensión o las extensiones a filtrar:
Por ejemplo para filtrar una sola extensión. En este caso se visualizarán solo archivos TXT
Colocar un control FileListBox llamado File1 y un control DirListBox llamado Dir1. Cuando selecciones una ruta en el Dir1, solo se listarán en el FileList los archivos que posean la extensión .txt
- Option Explicit
-
-
- Private Sub Dir1_Change()
- File1.Path = Dir1.Path
- End Sub
-
- Private Sub Form_Load()
-
- File1.Pattern = "*.txt"
- End Sub
Para filtrar varios archivos es de la misma forma que en el caso anterior, pero se debe establecer en la propiedad Pattern, separando las extensiones con un punto y coma ";".
Por ejemplo esto filtra y visualiza solo los archivos , Jpg, Bmp y Gif
File1,Pattern = "*.JPG;*.bMP;*.Gif"
En el ejemplo anterior se estableció la propiedad Pattern en tiempo de ejecución. Para establecerla en tiempo de diseño, se realiza desde la ventana de propiedades de Visual basic.
Propiedad FileName
Esta propiedad es muy importante y lo que hace es devolvernos el nombre del archivo seleccionado. Ojo, no la ruta entera (la propiedad path) , si no solo el nombre del archivo (el que se visualiza en el control).
El siguiente ejemplo, muestra un mensaje con el nombre del archivo seleccionado cuando hacemos Click en un archivo de la lista
- Option Explicit
-
-
- Private Sub File1_Click()
- MsgBox File1.FileName, vbInformation, "Nombre del archivo"
- End Sub
Pero como obtener la ruta completa ?
Es muy simple , debemos unir la propiedad Path , mas la propiedad FileName
Colocar un botón y un FileListBox. Pegar el siguiente fragmento de código en el formulario
- Option Explicit
-
-
- Private Sub Command1_Click()
-
- Dim sPath As String
-
-
- sPath = File1.Path & "" & File1.FileName
-
-
- MsgBox sPath, vbInformation, "Nombre del archivo"
-
- End Sub
-
- Private Sub Form_Load()
- Command1.Caption = "Mostrar"
- End Sub
Propiedad ListCount y objeto List
Si necesitamos recorrer todos los ficheros de la lista, es igual que el ejemplo que se describió para el control Drive, es decir utilizando las propiedades ListCount y el objeto List.
Un ejemplo que no tiene ningún sentido práctico, pero que sirve para ver el funcionamiento de estas dos propiedades, consiste en recorrer todos los ficheros en un bucle For Next, y agregarlos a un control ListBox.
Colocar un botón llamado Command1, un ListBox llamado List1 y un FileListBox llamado File1 en el formulario principal del programa. Luego pegar el siguiente código
- Option Explicit
-
-
-
-
- Private Sub Command1_Click()
-
-
- List1.Clear
-
-
- Dim i As Integer
-
- For i = 0 To File1.ListCount - 1
- List1.AddItem File1.List(i)
- Next
-
- End Sub
-
- Private Sub Form_Load()
- Command1.Caption = "Pasar archivos al ListBox"
- End Sub
System, Hidden, Normal, Archive - Propiedades
Estas propiedades permiten indicarle al control, si debe mostrar o no, archivos de acuerdo a sus atributos. Son cuatro propiedades
- System : Determina si un control FileListBox muestra archivos con el atributo Sistema
- Hidden : Determina si un control FileListBox muestra archivos con el atributo Oculto.
- Archive : Determina si un control FileListBox muestra los archivos con el atributo Modificado
- ReadOnly : Devuelve o establece un valor que determina si se muestran o no en la lista de archivos los archivos con el atributo Sólo lectura.
Eventos
Además de los eventos principales, como es el DobleClick, GotFocus, LostFocus y otros eventos comunes que poseen la gran mayoría de controles de vb, el FileListBox posee dos eventos exclusivos, ellos son :
- PathChange : Ocurre al cambiar la ruta de acceso estableciendo en el código las propiedades FileName o Path.
- PatternChange : Ocurre al cambiar el patrón de lista de archivos, como *.*, mediante FileName o Pattern en el código
Estos eventos le sirven al programador , en algunos casos que necesite saber cuando cambia alguna de las propiedades, y poder realizar alguna acción.
Ejemplo . Colocar dos botones y un File1
- Option Explicit
-
-
- Private Sub Command1_Click()
-
- File1.Path = "c:"
- End Sub
-
- Private Sub Command2_Click()
-
- File1.Pattern = "*.jpg"
- End Sub
-
- Private Sub File1_PathChange()
- MsgBox "Se ejecutó el evento PathChange", vbInformation
- End Sub
-
- Private Sub File1_PatternChange()
- MsgBox "Se ejecutó el evento PatternChange", vbInformation
- End Sub
-
- Private Sub Form_Load()
- Command1.Caption = "Cambiar Path"
- Command2.Caption = "Cambiar Pattern"
- End Sub
Ejemplo utilizando los 3 controles vistos para navegar por las unidades y directorios del sistema y visualizar archivos bmp en un control image
Colocar un control File1, un Dir1 y un Drive1 y un control Image como está en la imagen:
Lo que hace el ejemplo es cada vez que seleccionemos una unidad diferente en el control Drive se actualiza y muestra los directorios de la misma. A su vez al cambiar de directorio en el Dir1 se actualiza el control File1 mostrando los archivos de dicha carperta, pero solo los bmp, utilizando el filtrado con la propiedad Pattern. Luego, Al seleccionar un archivo bmp en el FileListBox, se cargará la imagen en el control Image utilizando el método LoadPicture
Pegar el código del ejemplo en un formulario:
- Option Explicit
-
-
- Private Sub Dir1_Change()
-
-
- File1.Path = Dir1.Path
- End Sub
- Private Sub Drive1_Change()
- On Error GoTo error_handler
-
-
-
- Dir1.Path = Drive1.Drive
-
-
-
- Exit Sub
- error_handler:
- MsgBox Err.Description, vbCritical
-
- End Sub
-
- Private Sub File1_Click()
- On Error GoTo error_handler
-
-
-
- Me.Caption = "Archivo Actual: " & File1.FileName
- Image1.Picture = LoadPicture(File1.Path & "" & File1.FileName)
-
-
- Exit Sub
- error_handler:
- MsgBox Err.Description, vbCritical
- End Sub
-
- Private Sub Form_Load()
-
- File1.Pattern = "*.bmp"
-
- Image1.Stretch = True
- End Sub