FileChooser (gb.form)

This control allows the user to select a file, or a list of files in the same directory.

This class inherits UserControl in gb.qt4.

This class is creatable.

Properties

AutoExt	Return or set if the extension of the file is automatically set from the current filter.
Bookmarks	Sets or returns the list of user-defined bookmarks.
Border	Return or set if the FileChooser has a border.
Dir	Returns or sets the current directory.
DirView	Return the DirView control internally used by the FileChooser.
Extension	Return the internal container that can be used for inserting extensions inside the FileChooser control.
FileView	Return the FileView control internally used by the FileChooser.
Filter	Returns or sets the filters used by the control for only displaying specific file types.
FilterIndex	Returns or sets the index of the filter that is used by FileChooser control.
Icon	Returns or sets the icon used for displaying a file or a directory.
Margin	Return or set if there is a margin around the file TextBox and the filter ComboBox.
Multi	Returns or sets if the user can select only one or many files.
Picture	Returns or sets the picture displayed by the FileChooser directory view.
ReadOnly	Returns or sets if the FileChooser is read-only.
Root	Returns or sets the root directory.
SelectedPath	Returns the current selected file.
SelectedPaths	Returns the list of all selected files, if the Multi property is `TRUE`.
Settings	Returns or sets a string that represents the control current state.
ShowBookmark	Returns or sets if the bookmark panel is visible or not.
ShowButton	Return or set if the standard dialog buttons ('OK' and 'Cancel') are visible or not.
ShowDetailed	Returns or sets if the files are displayed with a detailed view or with icons.
ShowDirectory	Returns if the directories are displayed in the file view.
ShowFile	Return or set if the file TextBox is visible or not.
ShowHidden	Returns or sets if the hidden files or directories are shown or hidden.
ShowPreview	Return or set if the image thumbnails are displayed or not
ShowToolbar	Return or set if the toolbar is visible.
UncompressFilter	Return or set a list of file filters that identify files that can be uncompressed in response of the Uncompress event.
Value	If the Multi property is `FALSE`, then this property is a synonymous of the SelectedPath property.
View	Return or set the view mode of the internal file view.

Inherited properties

Action	Returns or sets the action string associated with the control.
Background	Returns or sets the background color used by the control.
Children	Returns a collection of each control included in the container.
ClientH	A synonymous for the ClientHeight property.
ClientHeight	Returns the height of the area containing the controls.
ClientW	A synonymous for the ClientWidth property.
ClientWidth	Returns the width of the area containing the controls.
ClientX	Returns the position of the left border of the area containing the controls.
ClientY	Returns the position of the top border of the area containing the controls.
Cursor	Use this property for assigning a custom cursor to a control.
Design	Indicates that the control is in design mode.
Direction	Since 3.17 Return or set the control text direction.
Drop	Returns or sets if a control accepts drops.
Enabled	Indicates that the control is enabled.
Expand	Returns or sets if a control will expand if included in a container that arranges its contents.
Font	Returns or sets the font used to draw text in the control.
Foreground	Returns or sets the foreground color used by the control.
H	A synonymous for the Height property.
Handle	Returns the internal X11 window handle of the control.
HasFocus	Returns whether the control has the focus.
Height	Returns or sets the height of the control.
Hovered	Returns whether the mouse cursor is inside the control.
Id	A synonymous for the Handle property.
Ignore	Returns or sets if a control must be ignored when its parent arranges its children.
Left	Returns or sets the position of the left border of the control relative to its parent.
Mouse	Returns or sets the appearence of the cursor when it points inside the control.
Name	Returns or sets the name of the control.
Next	Returns the next control having the same parent.
NoAnimation	Since 3.20 Return or set if the possible animations of a control are disabled.
NoTabFocus	Return or set if a control cannot be focused with the TAB key.
Parent	Returns the control container.
PopupMenu	Return or set the name of the menu that will be popped-up when the user presses the right mouse button or the keyboard `MENU` key.
Previous	Returns the previous control having the same parent.
Proxy	Return or set the "proxy" of a control.
ProxyFor	Return which control that control is a proxy for.
RightToLeft	Return if the control is right to left oriented.
ScreenX	Returns the position of the left border of the control in screen coordinates.
ScreenY	Returns the position of the top border of the control in screen coordinates.
Tag	Returns or sets the control tag.
Tooltip	Returns or sets the tooltip shown when the mouse stays on the control for a short time.
Top	Returns or sets the position of the top border of the control relative to its parent.
TopLevel	Since 3.21 Return the top-level window this control belongs to.
Tracking	Returns or sets if the control will receive MouseMove events.
Visible	Indicates if the control is visible or not.
W	A synonymous for the Width property.
Width	Returns or sets the width of the control.
Window	Returns the window that contains the control.
X	Returns or sets the position of the left border of the control relative to its parent.
Y	Returns or sets the position of the top border of the control relative to its parent.

Methods

Reload	Reload the view contents as if you have clicked on the refresh button.
SetFocus	Gives the focus to the control.

Inherited methods

Delete	Destroys the control.
Drag	Starts a drag & drop process.
FindChild	Since 3.4 Finds the first child control pointed by the X and Y coordinates.
Grab	Grab the keyboard and the mouse so that all keyboard and mouse events are received by the control.
Hide	Hides the control.
Lower	Sends the control to the background of its parent.
Move	Moves and/or resizes the control.
MoveScaled	Moves and/or resizes the control.
Raise	Sends the control to the foreground of its parent.
Refresh	Trigger a redraw of the control.
Reparent	Changes the container of a control.
Resize	Resizes the control.
ResizeScaled	Resizes the control.
Show	Shows the control.

Events

Activate	This event is raised when the user double-clicks on a file, or clicks on the 'OK' button.
Cancel	Raised when the user clicks on the 'Cancel' button.
Change	This event is raised when the selected file changes.
Icon	This event is raised when the control needs to get the icon associated with a specific file or directory.
Uncompress	Raise when a specific compressed file must be uncompressed.

Inherited events

Arrange	This event is raised when a container has just finished arranging its contents.
BeforeArrange	This event is raised just before a container arranges its contents.
DblClick	Raised when the user quickly clicks twice on the control.
Drag	This event is raised when the mouse enters the control during a drag & drop process.
DragLeave	This event is raised when the mouse leaves the control during a drag & drop operation.
DragMove	This event is raised while the mouse moves inside the control during a drag & drop process.
Drop	This event is raised when a drag is dropped in the control.
Enter	Raised when the mouse enters the control.
GotFocus	Raised when the control has got the focus.
KeyPress	Raised when a key is pressed while the control has the focus.
KeyRelease	Raised when a key is released while the control has the focus.
Leave	Raised when the mouse leaves the control.
LostFocus	Raised when the control has lost the focus.
Menu	Raised when the user clicks on the control with the right mouse button, or if it hits the `MENU` key.
MouseDown	Raised when a mouse button is pressed while the cursor is inside the control.
MouseDrag	This event is raised when a drag operation should be started.
MouseMove	Raised when the mouse moves inside the control while a mouse button is pressed.
MouseUp	Raised when a mouse button is depressed while the cursor is inside the control.
MouseWheel	This event is raised when the user moves or presses the mouse wheel while the mouse is inside the control.
NewChild	This event is raised when a new child Control has just been inserted into the container.