User Tools

Site Tools


6.9.4 FileView

The FileView (gb.form) control displays files in a selected directory.

A FileView control can be created:

Dim hFileView As FileView

hFileView = New FileView ( Parent As Container ) As "EventName" Properties

The FileView class has these properties:

PropertyData typeDescription
BackgroundIntegerReturns the background colour or sets this colour.
BorderBooleanIndicates whether a border is set (default) or removes an existing border with the value 'False'.
CountIntegerReturns the number of files in the current directory (FileView.Dir) of the FileView. An inserted filter changes this number.
CurrentStringReturns the name of the selected file or selects the specified file in the current directory.
DirStringReturns the current directory in the FileView or sets the current directory of the FileView.
FilterString[ ]Returns the filters used by the control in a string array or sets them to show only certain file types. Each filter is a file pattern with wildcards. File names are matched with the LIKE command.
ForegroundIntegerReturns or sets the colour of the filenames.
IconPictureReturns or sets the icon for displaying a file or directory. Use this property to respond to the icon event.
IconSizeIntegerReturns or sets the icon size used by the view. The default value is 32.
ModeIntegerReturns or sets the FileView selection mode. The value of this property can be one of the constants (Multiple, None or Single) of the class Select (gb.qt4).
Selection String[ ]Returns the list of selected files in a string array if the property FileView.Mode is set to Select.Multiple.
Settings Variant[ ]Returns or assigns the configuration of the FileView. The configuration is stored in a Variant array in an unspecified format. Note: Since the Settings property serves as an interface to the gb.settings component, which allows graphical controls to serialise and re-read their own state, you should refrain from using this property.
ShowDetailedBooleanIndicates whether the files in the FileView are displayed with a detailed view or only with icons and the file names or sets the display of the detailed view.
ShowDirectoryBooleanIndicates whether the control also shows directories or not or sets the display of the directories.
ShowHiddenBooleanIndicates whether the control also shows hidden files or not or sets the display of hidden files.
ShowPreviewBooleanIndicates whether or not the control shows thumbnails for image files or sets the display of thumbnails of image files.

Table : Properties of the FileView class.


  • Access to the file name for a selected file - mode Single - in the project is obtained if you store the value of the property FileView.Current for example in a (public) variable sFileName = FileView.Current. You can access the files selected in FileView.Multiple = True mode, for example, if you save the list of selected file names, stored in the FileView.Selection property, in a (public) variable of the type string array such as aFileNames = FileView.Selection.
  • This is an example of a file filter: FileView1.Filter = [“*.txt”, “*.png”, “*.pd*”, “*.jp*”, “*.xml”] .
  • The filter should be followed in the source code by the instruction Wait, so that the file count is updated immediately.

Figure Selected file in a FileView

Figure List of selected files in a FileView Methods

The FileView class has these selected methods:

Reload( )Updates the contents of the FileView by re-reading the current directory.
Rename( )Starts renaming the currently selected file.
SelectAll( )Selects all entries in the FileView.
UnselectAll( )Resets all selected entries in the FileView.

Table : Selected methods of the FileView class Events

The FileView class has the following events, among others:

Activate( )This event is triggered when a user double-clicks on a file.
Click( )This event is triggered when a user clicks on a file. The event also triggers the select event first!
Icon( Path As String )This event is triggered when the control needs to get the icon for a specific file or directory. Path is the image path.
Menu( )This event is triggered when the user invokes a pop-up menu.
Select( )This event is triggered when a user only selects a file (MouseLeft_Down).

Table : Events of the FileView class Project

The source code for the project implements the above notes:

' Gambas class file
Public sFileName As String
Public aFileNames As String[]
Public Sub Form_Open()
  FMain.Resizable = False
  DirBox1.Value = "/home/hans/BildTon" ' (Start-)Folder
  FileView1.Dir = DirBox1.Value
  FileView1.IconSize = 32 ' Default-Value = 32
  FileView1.ShowPreview = True
  FileView1.ShowHidden = True
  FileView1.Background = &HC3DDFF
  FileView1.Foreground = Color.DarkGreen
  FileView1.Mode = Select.Single
  FileView1.Filter = ["*.txt", "*.png", "*.pd*", "*.jp*", "*.xml"]
  btnShowFileListContent.Enabled = False
Public Sub FileView1_Click()
  Dim sFileDir, sFilePath As String
  sFileName = FileView1.Current
  sFileDir = FileView1.Dir
  sFilePath = sFileDir &/ sFileName
  lblFileName.Text = Subst("&1 &2 &3", ("Filename"), ":", sFileName)
Public Sub FileView1_Select()
  If FileView1.Current Then
     Print Subst("&1 '&2' &3", ("The file"), FileView1.Current, ("has been selected."))
Public Sub DirBox1_Click()
  FileView1.Dir = DirBox1.Value
Public Sub btnSetMultiple_Click()
  If FileView1.Mode = Select.Single Then ' The default-value is "Single"
     FileView1.Mode = Select.Multiple
     btnSetMultiple.Caption = "Set file selection to single"
     btnShowFileListContent.Enabled = True
     FileView1.Mode = Select.Single
     btnSetMultiple.Caption = "Set file selection to multiple"
     btnShowFileListContent.Enabled = False
Public Sub btnShowFileListContent_Click()
  Dim sFile, sContent As String
  If FileView1.Mode = Select.Multiple Then
     If FileView1.Selection.Count > 0 Then
        lblFileName.Text = ""
        aFileNames = FileView1.Selection
        For Each sFile In aFileNames
          sContent &= sFile & gb.Lf
        Message.Info("Selected files:<hr>" & sContent)
        FileView1.Mode = Select.Single
        btnSetMultiple.Caption = "Set file selection to multiple"
        btnShowFileListContent.Enabled = False




The website uses a temporary session cookie. This technically necessary cookie is deleted when the browser is closed. You can find information on cookies in our privacy policy.
k6/k6.9/k6.9.4/start.txt · Last modified: 16.01.2022 (external edit)

Page Tools