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.
`GetClassDefaultAttributes`
`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.

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

Returns

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

static GetClassDefaultAttributes(variant=WINDOW_VARIANT_NORMAL)¶

Parameters: variant (WindowVariant) –
Return type: wx.VisualAttributes

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.

If path includes the directory part, it must exist, otherwise False is returned and nothing else is done.

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