GAMBAS BOOK 3.19.5

The DirChooser control (gb.form) allows the user to select a directory. There is an additional option to also display the contents of a selected directory.

The control can be created:

Dim hDirChooser As DirChooser

hDirChooser = New DirChooser ( Parent As Container )  As "EventName"

Internally, the DirView and FileView controls (optional) are used.

The DirChooser class has these selected properties:

Table 6.9.3.1.1 : Properties of the DirChooser class.

Notes:

• You get project-wide access to the selected directory via the value of the property DirChooser.SelectedPath, which you also store in a (public) variable sDirPath, for example.
• It makes sense when selecting a directory if you recognise the content of the selected directory. For example, first set the ShowFile properties in the source code and then also set ShowHidden, ShowPreview or ShowDetailed to True.
• Alternatively, you can also set the property DirChooser.ShowSplitter to True. Even then, you have the option of specifying additional display options via the context menu.
• Note that you can define bookmarks for the runtime of the programme in the context menu if you have set the property DirChooser.ShowBookmark to True.
• For a detailed description of the use of bookmarks, see the chapter describing the FileChooser control.

The DirChooser class has only one relevant method, Reload( ). It reloads the contents of the view - as if you had clicked on the “Refresh” button in the context menu.

6.9.3.3 Events

The DirChooser class has these selected events, among others:

Table 6.9.3.3.1 : Selected events of the DirChooser class.

Notes:

You can create new directories via the context menu or trigger the creation via the following source code:

Public Sub btnCreateNewFolder_Click()
  DirChooser1.DirView.NewFolder()
End

You change the name of an existing directory via the context menu or via the following source code, which triggers the change:

Public Sub btnRenameFolder_Click()
  DirChooser1.DirView.Rename()
End

The following notes on the layout of the programme window and the basic configuration of the DirChoosers control have proven to be useful for practical use:

Public Sub Form_Open()
 
  FMain.Resizable = True
  FMain.Utility = True ' Minimum window size as defined in the IDE
 
  DirChooser1.Root = User.Home ' Default-Folder
  DirChooser1.ShowSplitter = True
  DirChooser1.ShowBookmark = True
  ...
 
End

Figure 6.9.3.3.1: DirChooser with basic configuration

If you switch on the splitter, you will also see the contents of the selected directory in the internal FileView. In addition, the ToolBar fills with more buttons and controls like a slider to change the display size of the preview images.

Figure 6.9.3.3.2: DirChooser with extended configuration

You can also use the available context menu of the internal FileView to make further settings or actions. A nested context menu supports you in working with the DirChooser control:

Figure 6.9.3.3: Context menu