wx.FileCtrl¶

This control allows the user to select a file.

Two implementations of this class exist, one for Gtk and another generic one for all the other ports.

This class is only available if USE_FILECTRL is set to 1.

Window Styles¶

This class supports the following styles:

wx.FC_DEFAULT_STYLE: The default style: wx.FC_OPEN
wx.FC_OPEN: Creates an file control suitable for opening files. Cannot be combined with wx.FC_SAVE.
wx.FC_SAVE: Creates an file control suitable for saving files. Cannot be combined with wx.FC_OPEN.
wx.FC_MULTIPLE: For open control only, Allows selecting multiple files. Cannot be combined with wx.FC_SAVE
wx.FC_NOSHOWHIDDEN: Hides the “Show Hidden Files” checkbox (Generic only)

Events Emitted by this Class¶

Handlers bound for the following event types will receive a wx.FileCtrlEvent parameter.

EVT_FILECTRL_FILEACTIVATED: The user activated a file(by double-clicking or pressing Enter)
EVT_FILECTRL_SELECTIONCHANGED: The user changed the current selection(by selecting or deselecting a file)
EVT_FILECTRL_FOLDERCHANGED: The current folder of the file control has been changed
EVT_FILECTRL_FILTERCHANGED: The current file filter of the file control has been changed.

New in version 2.9.1..

Implementations:GTK port; a generic implementation is used elsewhere.

Class Hierarchy¶

Inheritance diagram for class FileCtrl:

Control Appearance¶

wxMSW

wxMAC

wxGTK

Methods Summary¶

`__init__`
`Create`	Create function for two-step construction.
`GetDirectory`	Returns the current directory of the file control (i.e. the directory shown by it).
`GetFilename`	Returns the currently selected filename.
`GetFilenames`	Returns a list of filenames selected in the control. This function
`GetFilterIndex`	Returns the zero-based index of the currently selected filter.
`GetPath`	Returns the full path (directory and filename) of the currently selected file.
`GetPaths`	Returns a list of the full paths (directory and filename) of the files
`GetWildcard`	Returns the current wildcard.
`SetDirectory`	Sets(changes) the current directory displayed in the control.
`SetFilename`	Selects a certain file.
`SetFilterIndex`	Sets the current filter index, starting from zero.
`SetPath`	Changes to a certain directory and selects a certain file.
`SetWildcard`	Sets the wildcard, which can contain multiple file types, for example: “`BMP` files (.bmp)\|.bmp\|GIF files (.gif)\|.gif”.
`ShowHidden`	Sets whether hidden files and folders are shown or not.

Properties Summary¶

`Directory`	See `GetDirectory` and `SetDirectory`
`Filename`	See `GetFilename` and `SetFilename`
`Filenames`	See `GetFilenames`
`FilterIndex`	See `GetFilterIndex` and `SetFilterIndex`
`Path`	See `GetPath` and `SetPath`
`Paths`	See `GetPaths`
`Wildcard`	See `GetWildcard` and `SetWildcard`

Class API¶

class wx.FileCtrl(Control)¶

Possible constructors:

FileCtrl()

FileCtrl(parent, id=ID_ANY, defaultDirectory="",
         defaultFilename="", wildCard=FileSelectorDefaultWildcardStr,
         style=FC_DEFAULT_STYLE, pos=DefaultPosition, size=DefaultSize,
         name=FileCtrlNameStr)

This control allows the user to select a file.

Methods¶

__init__(self, *args, **kw)¶

Overloaded Implementations:

__init__ (self)

__init__ (self, parent, id=ID_ANY, defaultDirectory=””, defaultFilename=””, wildCard=FileSelectorDefaultWildcardStr, style=FC_DEFAULT_STYLE, pos=DefaultPosition, size=DefaultSize, name=FileCtrlNameStr)

Constructs the window.

Parameters:

parent (wx.Window) – Parent window, must not be not None.
id (wx.WindowID) – The identifier for the control.
defaultDirectory (string) – The initial directory shown in the control. Must be a valid path to a directory or the empty string. In case it is the empty string, the current working directory is used.
defaultFilename (string) – The default filename, or the empty string.
wildCard (string) – A wildcard specifying which files can be selected, such as “x.x” or “BMP files (.bmp)|.bmp|GIF files (.gif)|.gif”.
style (long) – The window style, see FC_ flags.
pos (wx.Point) – Initial position.
size (wx.Size) – Initial size.
name (string) – Control name.

Returns:

True if the control was successfully created or False if creation failed.

Create(self, parent, id=ID_ANY, defaultDirectory="", defaultFilename="", wildCard=FileSelectorDefaultWildcardStr, style=FC_DEFAULT_STYLE, pos=DefaultPosition, size=DefaultSize, name=FileCtrlNameStr)¶

Create function for two-step construction.

See wx.FileCtrl for details.

Parameters:	parent (wx.Window) – id (wx.WindowID) – defaultDirectory (string) – defaultFilename (string) – wildCard (string) – style (long) – pos (wx.Point) – size (wx.Size) – name (string) –
Return type:	bool

GetDirectory(self)¶

Returns the current directory of the file control (i.e. the directory shown by it).

Return type:	`string`

GetFilename(self)¶

Returns the currently selected filename.

For the controls having the FC_MULTIPLE style, use GetFilenames instead.

Return type:	`string`

GetFilenames(self)¶

Returns a list of filenames selected in the control. This function should only be used with controls which have the wx.``wx.FC_MULTIPLE`` style, use GetFilename for the others.

Return type:	list of strings

GetFilterIndex(self)¶

Returns the zero-based index of the currently selected filter.

Return type:	int

GetPath(self)¶

Returns the full path (directory and filename) of the currently selected file.

For the controls having the FC_MULTIPLE style, use GetPaths instead.

Return type:	`string`

GetPaths(self)¶

Returns a list of the full paths (directory and filename) of the files chosen. This function should only be used with controlss which have the wx.``wx.FC_MULTIPLE`` style, use GetPath for the others.

Return type:	list of strings

GetWildcard(self)¶

Returns the current wildcard.

Return type:	`string`

SetDirectory(self, directory)¶

Sets(changes) the current directory displayed in the control.

Parameters:	directory (string) –
Return type:	bool
Returns:	Returns `True` on success, `False` otherwise.

SetFilename(self, filename)¶

Selects a certain file.

Parameters:	filename (string) –
Return type:	bool
Returns:	Returns `True` on success, `False` otherwise

SetFilterIndex(self, filterIndex)¶

Sets the current filter index, starting from zero.

Parameters:	filterIndex (int) –

SetPath(self, path)¶

Changes to a certain directory and selects a certain file.

In case the filename specified isn’t found/couldn’t be shown with currently selected filter, False is returned.

Parameters:	path (string) –
Return type:	bool
Returns:	Returns `True` on success, `False` otherwise

SetWildcard(self, wildCard)¶

Sets the wildcard, which can contain multiple file types, for example: “BMP files (.bmp)|.bmp|GIF files (.gif)|.gif”.

Parameters:	wildCard (string) –

ShowHidden(self, show)¶

Sets whether hidden files and folders are shown or not.

Parameters:	show (bool) –

Properties¶

Directory¶: See GetDirectory and SetDirectory

Filename¶: See GetFilename and SetFilename

Filenames¶: See GetFilenames

FilterIndex¶: See GetFilterIndex and SetFilterIndex

Path¶: See GetPath and SetPath

Paths¶: See GetPaths

Wildcard¶: See GetWildcard and SetWildcard

Navigation