QtGui.QFileDialog Class Reference

The QFileDialog class provides a dialog that allow users to select files or directories. More...

Inheritance diagram for QtGui.QFileDialog:

Collaboration diagram for QtGui.QFileDialog:

Public Types
enum	AcceptMode { AcceptOpen = 0, AcceptSave = 1 }
enum	DialogLabel {   Accept = 3, FileName = 1, FileType = 2, LookIn = 0,   Reject = 4 }
enum	FileMode {   AnyFile = 0, Directory = 2, DirectoryOnly = 4, ExistingFile = 1,   ExistingFiles = 3 }
	More...
enum	Option {   DontConfirmOverwrite = 4, DontResolveSymlinks = 2, DontUseNativeDialog = 16, DontUseSheet = 8,   HideNameFilterDetails = 64, ReadOnly = 32, ShowDirsOnly = 1 }
enum	ViewMode { Detail = 0, List = 1 }
	More...
Public Types inherited from QtGui.QDialog
enum	DialogCode { Accepted = 1, Rejected = 0 }
	More...
Public Types inherited from QtGui.QWidget
enum	RenderFlag { DrawChildren = 2, DrawWindowBackground = 1, IgnoreMask = 4 }
	More...

Public Member Functions
	QFileDialog (QWidget parent, Qt.WindowType f)
	QFileDialog (QWidget parent=null, string caption="", string directory="", string filter="")
override void	CreateProxy ()
override void	Accept ()
override void	Done (int result)
new string	LabelText (QFileDialog.DialogLabel label)
new void	Open ()
new void	Open (QObject receiver, string member)
new QFileDialog.Option	options ()
new bool	RestoreState (QByteArray state)
new QByteArray	SaveState ()
new void	SelectFile (string filename)
new void	SelectFilter (string filter)
new void	SelectNameFilter (string filter)
new System.Collections.Generic.List < string >	SelectedFiles ()
new string	SelectedFilter ()
new string	SelectedNameFilter ()
new void	SetDirectory (string directory)
new void	SetFilter (string filter)
new void	SetLabelText (QFileDialog.DialogLabel label, string text)
new void	SetNameFilter (string filter)
new void	SetNameFilterDetailsVisible (bool enabled)
new void	SetOption (QFileDialog.Option option, bool on=true)
new void	SetOptions (QFileDialog.Option options)
override void	SetVisible (bool visible)
new bool	TestOption (QFileDialog.Option option)
new void	Dispose ()
Public Member Functions inherited from QtGui.QDialog
	QDialog (QWidget parent=null, Qt.WindowType f=0)
override bool	EventFilter (QObject arg1, QEvent arg2)
new int	Exec ()
override QSize	MinimumSizeHint ()
new void	Open ()
virtual void	Reject ()
new void	ShowExtension (bool arg1)
override QSize	SizeHint ()
new void	Dispose ()
Public Member Functions inherited from QtGui.QWidget
	QWidget (QWidget parent=null, Qt.WindowType f=0)
override void	CreateProxy ()
new System.Collections.Generic.List < QAction >	Actions ()
new void	ActivateWindow ()
new void	AddAction (QAction action)
new void	AddActions (System.Collections.Generic.List< QAction > actions)
new void	AdjustSize ()
new QWidget	ChildAt (QPoint p)
new QWidget	ChildAt (int x, int y)
new void	ClearFocus ()
new void	ClearMask ()
new bool	Close ()
new QRect	ContentsRect ()
new void	CreateWinId ()
virtual int	DevType ()
new NativeULong	EffectiveWinId ()
new void	EnsurePolished ()
override bool	OnEvent (QEvent arg1)
new QWidget	FocusWidget ()
new QFont	font ()
new QFontInfo	FontInfo ()
new QFontMetrics	FontMetrics ()
new QRect	geometry ()
new void	GetContentsMargins (ref int left, ref int top, ref int right, ref int bottom)
virtual System.IntPtr	GetDC ()
new void	GrabGesture (Qt.GestureType type, Qt.GestureFlag flags=0)
new void	GrabKeyboard ()
new void	GrabMouse ()
new void	GrabMouse (QCursor arg1)
new int	GrabShortcut (QKeySequence key, Qt.ShortcutContext context=Qt.ShortcutContext.WindowShortcut)
new QGraphicsProxyWidget	GraphicsProxyWidget ()
virtual int	HeightForWidth (int arg1)
new void	Hide ()
new Qt.InputMethodHint	inputMethodHints ()
virtual object	InputMethodQuery (Qt.InputMethodQuery arg1)
new void	InsertAction (QAction before, QAction action)
new void	InsertActions (QAction before, System.Collections.Generic.List< QAction > actions)
new NativeULong	InternalWinId ()
new bool	IsAncestorOf (QWidget child)
new bool	IsEnabledTo (QWidget arg1)
new bool	IsEnabledToTLW ()
new bool	IsHidden ()
new bool	IsLeftToRight ()
new bool	IsRightToLeft ()
new bool	IsTopLevel ()
new bool	IsVisibleTo (QWidget arg1)
new bool	IsWindow ()
new void	Lower ()
new QPoint	MapFrom (QWidget arg1, QPoint arg2)
new QPoint	MapFromGlobal (QPoint arg1)
new QPoint	MapFromParent (QPoint arg1)
new QPoint	MapTo (QWidget arg1, QPoint arg2)
new QPoint	MapToGlobal (QPoint arg1)
new QPoint	MapToParent (QPoint arg1)
new void	Move (int x, int y)
new QWidget	NativeParentWidget ()
new QWidget	NextInFocusChain ()
new void	OverrideWindowFlags (Qt.WindowType type)
new void	OverrideWindowState (Qt.WindowState state)
virtual QPaintEngine	PaintEngine ()
new QPalette	palette ()
new QWidget	ParentWidget ()
new QWidget	PreviousInFocusChain ()
new void	Raise ()
virtual void	ReleaseDC (System.IntPtr arg1)
new void	ReleaseKeyboard ()
new void	ReleaseMouse ()
new void	ReleaseShortcut (int id)
new void	RemoveAction (QAction action)
new void	Render (IQPaintDevice target)
new void	Render (QPainter painter)
new void	Render (IQPaintDevice target, QPoint targetOffset)
new void	Render (QPainter painter, QPoint targetOffset)
new void	Render (IQPaintDevice target, QPoint targetOffset, QRegion sourceRegion, QWidget.RenderFlag renderFlags=QWidget.RenderFlag.DrawWindowBackground|QWidget.RenderFlag.DrawChildren)
new void	Render (QPainter painter, QPoint targetOffset, QRegion sourceRegion, QWidget.RenderFlag renderFlags=QWidget.RenderFlag.DrawWindowBackground|QWidget.RenderFlag.DrawChildren)
new void	Repaint ()
new void	Repaint (QRect arg1)
new void	Repaint (QRegion arg1)
new void	Repaint (int x, int y, int w, int h)
new void	Resize (int w, int h)
new bool	RestoreGeometry (QByteArray geometry)
new QByteArray	SaveGeometry ()
new void	Scroll (int dx, int dy)
new void	Scroll (int dx, int dy, QRect arg3)
new void	SetAttribute (Qt.WidgetAttribute arg1, bool on=true)
new void	SetBaseSize (int basew, int baseh)
new void	SetContentsMargins (int left, int top, int right, int bottom)
new void	SetDisabled (bool arg1)
new void	SetFixedHeight (int h)
new void	SetFixedSize (QSize arg1)
new void	SetFixedSize (int w, int h)
new void	SetFixedWidth (int w)
new void	SetFocus ()
new void	SetFocus (Qt.FocusReason reason)
new void	SetGeometry (int x, int y, int w, int h)
new void	SetHidden (bool hidden)
new void	SetInputMethodHints (Qt.InputMethodHint hints)
new void	SetMask (QBitmap arg1)
new void	SetMaximumSize (int maxw, int maxh)
new void	SetMinimumSize (int minw, int minh)
new void	SetParent (QWidget parent)
new void	SetParent (QWidget parent, Qt.WindowType f)
new void	SetShortcutAutoRepeat (int id, bool enable=true)
new void	SetShortcutEnabled (int id, bool enable=true)
new void	SetShown (bool shown)
new void	SetSizeIncrement (int w, int h)
new void	SetSizePolicy (QSizePolicy.Policy horizontal, QSizePolicy.Policy vertical)
new void	Show ()
new void	ShowFullScreen ()
new void	ShowMaximized ()
new void	ShowMinimized ()
new void	ShowNormal ()
new void	StackUnder (QWidget arg1)
new bool	TestAttribute (Qt.WidgetAttribute arg1)
new QWidget	TopLevelWidget ()
new bool	UnderMouse ()
new void	UngrabGesture (Qt.GestureType type)
new void	UnsetCursor ()
new void	UnsetLayoutDirection ()
new void	UnsetLocale ()
new void	Update ()
new void	Update (QRect arg1)
new void	Update (QRegion arg1)
new void	Update (int x, int y, int w, int h)
new void	UpdateGeometry ()
new QRegion	VisibleRegion ()
new NativeULong	WinId ()
new QWidget	Window ()
new Qt.WindowType	WindowType ()
new void	Dispose ()
new int	ColorCount ()
new int	Depth ()
new int	HeightMM ()
new int	LogicalDpiX ()
new int	LogicalDpiY ()
new int	NumColors ()
new bool	PaintingActive ()
new int	PhysicalDpiX ()
new int	PhysicalDpiY ()
new int	WidthMM ()
Public Member Functions inherited from QtCore.QObject
	QObject (QObject parent=null)
new bool	BlockSignals (bool b)
new System.Collections.Generic.List < QObject >	Children ()
new bool	Connect (QObject sender, string signal, string member, Qt.ConnectionType type=Qt.ConnectionType.AutoConnection)
new void	DeleteLater ()
new bool	Disconnect (QObject receiver, string member=null)
new bool	Disconnect (string signal=null, QObject receiver=null, string member=null)
new void	DumpObjectInfo ()
new void	DumpObjectTree ()
new System.Collections.Generic.List < QByteArray >	DynamicPropertyNames ()
new bool	Inherits (string classname)
new void	InstallEventFilter (QObject arg1)
new bool	IsWidgetType ()
new void	KillTimer (int id)
new object	Property (string name)
new void	RemoveEventFilter (QObject arg1)
new bool	SetProperty (string name, object value)
new void	SetUserData (uint id, QObjectUserData data)
new bool	SignalsBlocked ()
new int	StartTimer (int interval)
new QObjectUserData	UserData (uint id)
new void	Dispose ()
Public Member Functions inherited from QtCore.Qt
delegate QTextStream	FuncQTextStreamQTextStream (QTextStream qTextStream)
delegate string	FuncStringQByteArray (QByteArray qByteArray)
delegate QByteArray	FuncQByteArrayString (string @string)
delegate void	ActionQtMsgTypeString (QtMsgType qtMsgType, string @string)
delegate QObject	FuncQObject ()
Public Member Functions inherited from QtGui.IQPaintDevice
new int	ColorCount ()
new int	Depth ()
int	DevType ()
System.IntPtr	GetDC ()
new int	Height ()
new int	HeightMM ()
new int	LogicalDpiX ()
new int	LogicalDpiY ()
new int	NumColors ()
QPaintEngine	PaintEngine ()
new bool	PaintingActive ()
new int	PhysicalDpiX ()
new int	PhysicalDpiY ()
void	ReleaseDC (System.IntPtr hdc)
new int	Width ()
new int	WidthMM ()

Static Public Member Functions
static string	GetExistingDirectory (QWidget parent=null, string caption="", string dir="", QFileDialog.Option options=QFileDialog.Option.ShowDirsOnly)
static string	GetOpenFileName (QWidget parent=null, string caption="", string dir="", string filter="", System.Text.StringBuilder selectedFilter=null, QFileDialog.Option options=0)
static System.Collections.Generic.List < string >	GetOpenFileNames (QWidget parent=null, string caption="", string dir="", string filter="", System.Text.StringBuilder selectedFilter=null, QFileDialog.Option options=0)
static string	GetSaveFileName (QWidget parent=null, string caption="", string dir="", string filter="", System.Text.StringBuilder selectedFilter=null, QFileDialog.Option options=0)
static string	Tr (string s, string c=null)
static string	Tr (string s, string c, int n)
static string	TrUtf8 (string s, string c=null)
static string	TrUtf8 (string s, string c, int n)
Static Public Member Functions inherited from QtGui.QDialog
static string	Tr (string s, string c=null)
static string	Tr (string s, string c, int n)
static string	TrUtf8 (string s, string c=null)
static string	TrUtf8 (string s, string c, int n)
Static Public Member Functions inherited from QtGui.QWidget
static QWidget	Find (NativeULong arg1)
static QWidget	KeyboardGrabber ()
static QWidget	MouseGrabber ()
static void	SetTabOrder (QWidget arg1, QWidget arg2)
static string	Tr (string s, string c=null)
static string	Tr (string s, string c, int n)
static string	TrUtf8 (string s, string c=null)
static string	TrUtf8 (string s, string c, int n)
Static Public Member Functions inherited from QtCore.QObject
static bool	Connect (QObject sender, QMetaMethod signal, QObject receiver, QMetaMethod method, Qt.ConnectionType type=Qt.ConnectionType.AutoConnection)
static bool	Connect (QObject sender, string signal, QObject receiver, string member, Qt.ConnectionType arg5=Qt.ConnectionType.AutoConnection)
static bool	Disconnect (QObject sender, QMetaMethod signal, QObject receiver, QMetaMethod member)
static bool	Disconnect (QObject sender, string signal, QObject receiver, string member)
static uint	RegisterUserData ()
static string	Tr (string s, string c=null)
static string	Tr (string s, string c, int n)
static string	TrUtf8 (string s, string c=null)
static string	TrUtf8 (string s, string c, int n)
Static Public Member Functions inherited from QtCore.Qt
static QDataStream	Write (QDataStream s, object p)
static QDataStream	Write (QDataStream arg1, QSizeF arg2)
static QTextStream	Write (QTextStream s, Qt.FuncQTextStreamQTextStream f)
static QDataStream	Write (QDataStream arg1, QPoint arg2)
static QDataStream	Write (QDataStream arg1, QLineF arg2)
static QDataStream	Write (QDataStream arg1, QPointF arg2)
static QDataStream	Write (QDataStream arg1, QChar arg2)
static QDataStream	Write (QDataStream arg1, QByteArray arg2)
static QDataStream	Write (QDataStream arg1, QEasingCurve arg2)
static QDataStream	Write (QDataStream arg1, QRectF arg2)
static QDataStream	Write (QDataStream arg1, QDateTime arg2)
static QDataStream	Write (QDataStream arg1, QUrl arg2)
static QDataStream	Write (QDataStream arg1, QTime arg2)
static QDataStream	Write (QDataStream arg1, QLocale arg2)
static QDataStream	Write (QDataStream arg1, QBitArray arg2)
static QDataStream	Write (QDataStream arg1, QUuid arg2)
static QDataStream	Write (QDataStream arg1, QLine arg2)
static QDataStream	Write (QDataStream arg1, QDate arg2)
static QDataStream	Write (QDataStream @out, QRegExp regExp)
static QDataStream	Write (QDataStream arg1, QRect arg2)
static QDataStream	Write (QDataStream arg1, QSize arg2)
static QDataStream	Write (QDataStream s, QVariant.Type p)
static QDataStream	Write (QDataStream arg1, string arg2)
static QDataStream	Write (QDataStream @out, System.Collections.Generic.List< string > list)
static QDataStream	Read (QDataStream arg1, QChar arg2)
static QDataStream	Read (QDataStream arg1, QLocale arg2)
static QDataStream	Read (QDataStream arg1, QRect arg2)
static QDataStream	Read (QDataStream arg1, QEasingCurve arg2)
static QDataStream	Read (QDataStream arg1, QDate arg2)
static QDataStream	Read (QDataStream arg1, QUrl arg2)
static QDataStream	Read (QDataStream arg1, QUuid arg2)
static QTextStream	Read (QTextStream s, Qt.FuncQTextStreamQTextStream f)
static QDataStream	Read (QDataStream arg1, QLineF arg2)
static QDataStream	Read (QDataStream arg1, QRectF arg2)
static QDataStream	Read (QDataStream arg1, QPointF arg2)
static QDataStream	Read (QDataStream arg1, QLine arg2)
static QDataStream	Read (QDataStream arg1, QBitArray arg2)
static QDataStream	Read (QDataStream arg1, QSize arg2)
static QDataStream	Read (QDataStream arg1, QDateTime arg2)
static QDataStream	Read (QDataStream arg1, QTime arg2)
static QDataStream	Read (QDataStream arg1, QPoint arg2)
static QDataStream	Read (QDataStream @in, QRegExp regExp)
static QDataStream	Read (QDataStream s, object p)
static QDataStream	Read (QDataStream arg1, QByteArray arg2)
static QDataStream	Read (QDataStream arg1, QSizeF arg2)
static QDataStream	Read (QDataStream arg1, string arg2)
static QDataStream	Read (QDataStream s, QVariant.Type p)
static QDataStream	Read (QDataStream @in, System.Collections.Generic.List< string > list)
static double	qAcos (double v)
static void	qAddPostRoutine (System.Action arg1)
static string	qAppName ()
static double	qAsin (double v)
static double	qAtan (double v)
static double	qAtan2 (double x, double y)
static void	qBadAlloc ()
static int	qCeil (double v)
static ushort	qChecksum (string s, uint len)
static QByteArray	qCompress (QByteArray data)
static QByteArray	qCompress (QByteArray data, int compressionLevel=-1)
static QByteArray	qCompress (Pointer< byte > data, int nbytes)
static QByteArray	qCompress (Pointer< byte > data, int nbytes, int compressionLevel=-1)
static double	qCos (double v)
static double	qExp (double v)
static double	qFabs (double v)
static double	qFastCos (double x)
static double	qFastSin (double x)
static string	qFlagLocation (string method)
static int	qFloor (double v)
static bool	qFuzzyCompare (double p1, double p2)
static bool	qFuzzyCompare (float p1, float p2)
static bool	qFuzzyIsNull (double d)
static bool	qFuzzyIsNull (float f)
static uint	qHash (QBitArray key)
static uint	qHash (QChar key)
static uint	qHash (QStringRef key)
static uint	qHash (QUrl url)
static uint	qHash (QPersistentModelIndex index)
static uint	qHash (QByteArray key)
static uint	qHash (QModelIndex index)
static uint	qHash (uint key)
static uint	qHash (sbyte key)
static uint	qHash (byte key)
static uint	qHash (short key)
static uint	qHash (NativeLong key)
static uint	qHash (ushort key)
static uint	qHash (long key)
static uint	qHash (ulong key)
static uint	qHash (int key)
static uint	qHash (string key)
static uint	qHash (NativeULong key)
static double	qInf ()
static Qt.ActionQtMsgTypeString	qInstallMsgHandler (Qt.ActionQtMsgTypeString arg1)
static int	qIntCast (float f)
static int	qIntCast (double f)
static bool	qIsFinite (double d)
static bool	qIsFinite (float f)
static bool	qIsInf (float f)
static bool	qIsInf (double d)
static bool	qIsNaN (float f)
static bool	qIsNaN (double d)
static bool	qIsNull (float f)
static bool	qIsNull (double d)
static double	qLn (double v)
static double	qPow (double x, double y)
static double	qQNaN ()
static void	qRegisterStaticPluginInstanceFunction (Qt.FuncQObject function)
static void	qRemovePostRoutine (System.Action arg1)
static int	qRound (double d)
static long	qRound64 (double d)
static double	qSNaN ()
static bool	qSharedBuild ()
static double	qSin (double v)
static double	qSqrt (double v)
static bool	qStringComparisonHelper (QStringRef s1, string s2)
static double	qTan (double v)
static QByteArray	qUncompress (QByteArray data)
static QByteArray	qUncompress (Pointer< byte > data, int nbytes)
static string	qVersion ()
static void	Qbswap_helper (Pointer< byte > src, Pointer< byte > dest, int size)
static QByteArray	Qgetenv (string varName)
static bool	Qputenv (string varName, QByteArray value)
static int	Qrand ()
static void	Qsrand (uint seed)
static int	Qstrcmp (QByteArray str1, QByteArray str2)
static int	Qstrcmp (QByteArray str1, string str2)
static int	Qstrcmp (string str1, QByteArray str2)
static int	Qstrcmp (string str1, string str2)
static Pointer< sbyte >	Qstrcpy (Pointer< sbyte > dst, string src)
static Pointer< sbyte >	Qstrdup (string arg1)
static int	Qstricmp (string arg1, string arg2)
static uint	Qstrlen (string str)
static int	Qstrncmp (string str1, string str2, uint len)
static Pointer< sbyte >	Qstrncpy (Pointer< sbyte > dst, string src, uint len)
static int	Qstrnicmp (string arg1, string arg2, uint len)
static uint	Qstrnlen (string str, uint maxlen)
static string	QtTrId (string id, int n=-1)

Protected Member Functions
	QFileDialog (System.Type dummy)
override void	OnChangeEvent (QEvent e)
new void	OnCurrentChanged (string path)
new void	OnDirectoryEntered (string directory)
new void	OnFileSelected (string file)
new void	OnFilesSelected (System.Collections.Generic.List< string > files)
new void	OnFilterSelected (string filter)
Protected Member Functions inherited from QtGui.QDialog
	QDialog (System.Type dummy)
new void	OnAccepted ()
new void	AdjustPosition (QWidget arg1)
override void	OnCloseEvent (QCloseEvent arg1)
override void	OnContextMenuEvent (QContextMenuEvent arg1)
new void	OnFinished (int result)
override void	OnKeyPressEvent (QKeyEvent arg1)
new void	OnRejected ()
override void	OnResizeEvent (QResizeEvent arg1)
override void	OnShowEvent (QShowEvent arg1)
Protected Member Functions inherited from QtGui.QWidget
	QWidget (System.Type dummy)
virtual void	OnActionEvent (QActionEvent arg1)
new void	Create ()
new void	Create (NativeULong arg1, bool initializeWindow=true, bool destroyOldWindow=true)
new void	OnCustomContextMenuRequested (QPoint pos)
new void	Destroy (bool destroyWindow=true, bool destroySubWindows=true)
virtual void	OnDragEnterEvent (QDragEnterEvent arg1)
virtual void	OnDragLeaveEvent (QDragLeaveEvent arg1)
virtual void	OnDragMoveEvent (QDragMoveEvent arg1)
virtual void	OnDropEvent (QDropEvent arg1)
virtual void	EnabledChange (bool arg1)
virtual void	OnEnterEvent (QEvent arg1)
virtual void	OnFocusInEvent (QFocusEvent arg1)
new bool	FocusNextChild ()
virtual bool	FocusNextPrevChild (bool next)
virtual void	OnFocusOutEvent (QFocusEvent arg1)
new bool	FocusPreviousChild ()
virtual void	FontChange (QFont arg1)
virtual void	OnHideEvent (QHideEvent arg1)
virtual void	OnInputMethodEvent (QInputMethodEvent arg1)
virtual void	OnKeyReleaseEvent (QKeyEvent arg1)
virtual void	LanguageChange ()
virtual void	OnLeaveEvent (QEvent arg1)
virtual int	Metric (QPaintDevice.PaintDeviceMetric arg1)
virtual void	OnMouseDoubleClickEvent (QMouseEvent arg1)
virtual void	OnMouseMoveEvent (QMouseEvent arg1)
virtual void	OnMousePressEvent (QMouseEvent arg1)
virtual void	OnMouseReleaseEvent (QMouseEvent arg1)
virtual void	OnMoveEvent (QMoveEvent arg1)
virtual void	OnPaintEvent (QPaintEvent arg1)
virtual void	PaletteChange (QPalette arg1)
new void	ResetInputContext ()
virtual void	StyleChange (QStyle arg1)
virtual void	OnTabletEvent (QTabletEvent arg1)
new void	UpdateMicroFocus ()
virtual void	OnWheelEvent (QWheelEvent arg1)
virtual void	WindowActivationChange (bool arg1)
Protected Member Functions inherited from QtCore.QObject
	QObject (System.Type dummy)
virtual void	OnChildEvent (QChildEvent arg1)
virtual void	ConnectNotify (string signal)
virtual void	OnCustomEvent (QEvent arg1)
new void	OnDestroyed (QObject arg1=null)
virtual void	DisconnectNotify (string signal)
new int	Receivers (string signal)
new QObject	Sender ()
new int	SenderSignalIndex ()
virtual void	OnTimerEvent (QTimerEvent arg1)

Properties
Slot< System.String >	FileSelected
Slot < System.Collections.Generic.List < string > >	FilesSelected
Slot< System.String >	CurrentChanged
Slot< System.String >	DirectoryEntered
Slot< System.String >	FilterSelected
new QDir	Directory [get, set]
new QDir.Filter	Filter [get, set]
new System.Collections.Generic.List < string >	Filters [get, set]
new System.Collections.Generic.List < string >	History [get, set]
new QFileIconProvider	IconProvider [get, set]
new QAbstractItemDelegate	ItemDelegate [get, set]
new System.Collections.Generic.List < string >	NameFilters [get, set]
new QAbstractProxyModel	ProxyModel [get, set]
new System.Collections.Generic.List < QUrl >	SidebarUrls [get, set]
new ViewMode	viewMode [get, set]
new FileMode	fileMode [get, set]
new AcceptMode	acceptMode [get, set]
new bool	ReadOnly [get, set]
new bool	ResolveSymlinks [get, set]
new bool	ConfirmOverwrite [get, set]
new string	DefaultSuffix [get, set]
new bool	NameFilterDetailsVisible [get, set]
new Option	Options [get, set]
static new QMetaObject	StaticMetaObject [get]
new IQFileDialogSignals	Emit [get]
Properties inherited from QtGui.QDialog
Slot< System.Int32 >	Finished
Slot	Accepted
Slot	Rejected
new QWidget	Extension [get, set]
new Qt.Orientation	Orientation [get, set]
new int	Result [get, set]
new bool	SizeGripEnabled [get, set]
static new QMetaObject	StaticMetaObject [get]
new IQDialogSignals	Emit [get]
Properties inherited from QtGui.QWidget
virtual EventHandler < QEventArgs< QActionEvent > >	ActionEvent
virtual EventHandler < QEventArgs< QEvent > >	ChangeEvent
virtual EventHandler < QEventArgs< QCloseEvent > >	CloseEvent
virtual EventHandler < QEventArgs < QContextMenuEvent > >	ContextMenuEvent
virtual EventHandler < QEventArgs< QDragEnterEvent > >	DragEnterEvent
virtual EventHandler < QEventArgs< QDragLeaveEvent > >	DragLeaveEvent
virtual EventHandler < QEventArgs< QDragMoveEvent > >	DragMoveEvent
virtual EventHandler < QEventArgs< QDropEvent > >	DropEvent
virtual EventHandler < QEventArgs< QEvent > >	EnterEvent
virtual EventHandler < QEventArgs< QFocusEvent > >	FocusInEvent
virtual EventHandler < QEventArgs< QFocusEvent > >	FocusOutEvent
virtual EventHandler < QEventArgs< QHideEvent > >	HideEvent
virtual EventHandler < QEventArgs < QInputMethodEvent > >	InputMethodEvent
virtual EventHandler < QEventArgs< QKeyEvent > >	KeyPressEvent
virtual EventHandler < QEventArgs< QKeyEvent > >	KeyReleaseEvent
virtual EventHandler < QEventArgs< QEvent > >	LeaveEvent
virtual EventHandler < QEventArgs< QMouseEvent > >	MouseDoubleClickEvent
virtual EventHandler < QEventArgs< QMouseEvent > >	MouseMoveEvent
virtual EventHandler < QEventArgs< QMouseEvent > >	MousePressEvent
virtual EventHandler < QEventArgs< QMouseEvent > >	MouseReleaseEvent
virtual EventHandler < QEventArgs< QMoveEvent > >	MoveEvent
virtual EventHandler < QEventArgs< QPaintEvent > >	PaintEvent
virtual EventHandler < QEventArgs< QResizeEvent > >	ResizeEvent
virtual EventHandler < QEventArgs< QShowEvent > >	ShowEvent
virtual EventHandler < QEventArgs< QTabletEvent > >	TabletEvent
virtual EventHandler < QEventArgs< QWheelEvent > >	WheelEvent
Slot< QPoint >	CustomContextMenuRequested
new QPalette.ColorRole	BackgroundRole [get, set]
new QMargins	ContentsMargins [get, set]
new QWidget	FocusProxy [get, set]
new QPalette.ColorRole	ForegroundRole [get, set]
new QGraphicsEffect	GraphicsEffect [get, set]
new QInputContext	InputContext [get, set]
new QLayout	Layout [get, set]
new QRegion	Mask [get, set]
new QStyle	Style [get, set]
new Qt.WindowType	WindowFlags [get, set]
new string	WindowRole [get, set]
new Qt.WindowState	WindowState [get, set]
new bool	Modal [get]
new Qt.WindowModality	WindowModality [get, set]
new bool	Enabled [get, set]
new QRect	Geometry [get, set]
new QRect	FrameGeometry [get]
new QRect	NormalGeometry [get]
new int	X [get]
new int	Y [get]
new QPoint	Pos [get, set]
new QSize	FrameSize [get]
new QSize	Size [get, set]
new int	Width [get]
new int	Height [get]
new QRect	Rect [get]
new QRect	ChildrenRect [get]
new QRegion	ChildrenRegion [get]
new QSizePolicy	SizePolicy [get, set]
new QSize	MinimumSize [get, set]
new QSize	MaximumSize [get, set]
new int	MinimumWidth [get, set]
new int	MinimumHeight [get, set]
new int	MaximumWidth [get, set]
new int	MaximumHeight [get, set]
new QSize	SizeIncrement [get, set]
new QSize	BaseSize [get, set]
new QPalette	Palette [get, set]
new QFont	Font [get, set]
new QCursor	Cursor [get, set]
new bool	MouseTracking [get, set]
new bool	IsActiveWindow [get]
new Qt.FocusPolicy	FocusPolicy [get, set]
new bool	Focus [get]
new Qt.ContextMenuPolicy	ContextMenuPolicy [get, set]
new bool	UpdatesEnabled [get, set]
new bool	Visible [get, set]
new bool	Minimized [get]
new bool	Maximized [get]
new bool	FullScreen [get]
new bool	AcceptDrops [get, set]
new string	WindowTitle [get, set]
new QIcon	WindowIcon [get, set]
new string	WindowIconText [get, set]
new double	WindowOpacity [get, set]
new bool	WindowModified [get, set]
new string	ToolTip [get, set]
new string	StatusTip [get, set]
new string	WhatsThis [get, set]
new string	AccessibleName [get, set]
new string	AccessibleDescription [get, set]
new Qt.LayoutDirection	LayoutDirection [get, set]
new bool	AutoFillBackground [get, set]
new string	StyleSheet [get, set]
new QLocale	Locale [get, set]
new string	WindowFilePath [get, set]
new Qt.InputMethodHint	InputMethodHints [get, set]
static new QMetaObject	StaticMetaObject [get]
new ushort	Painters [get, set]
new IQWidgetSignals	Emit [get]
Properties inherited from QtCore.QObject
virtual EventHandler < QEventArgs< QChildEvent > >	ChildEvent
virtual EventHandler < QEventArgs< QEvent > >	CustomEvent
virtual EventHandler < QEventArgs< QEvent > >	Event
virtual EventHandler < QEventArgs< QTimerEvent > >	TimerEvent
Slot< QObject >	DestroyedQObject
Slot	Destroyed
new QObject	Parent [get, set]
virtual System.IntPtr	SmokeObject [get, set]
new string	ObjectName [get, set]
static new QMetaObject	StaticMetaObject [get]
static new QMetaObject	StaticQtMetaObject [get]
new IQObjectSignals	Emit [get]

Additional Inherited Members
Protected Attributes inherited from QtCore.QObject
object	Q_EMIT = null
SmokeInvocation	interceptor
readonly List< QEventHandler >	eventFilters = new List<QEventHandler>()

Detailed Description

The QFileDialog class provides a dialog that allow users to select files or directories.

The QFileDialog class enables a user to traverse the file system in order to select one or many files or a directory.

The easiest way to create a QFileDialog is to use the static functions. On Windows, Mac OS X, KDE and GNOME, these static functions will call the native file dialog when possible.

fileName = QFileDialog::getOpenFileName(this,

tr("Open Image"), "/home/jana", tr("Image Files (*.png *.jpg *.bmp)"));

In the above example, a modal QFileDialog is created using a static function. The dialog initially displays the contents of the "/home/jana" directory, and displays files matching the patterns given in the string "Image Files (*.png *.jpg *.bmp)". The parent of the file dialog is set to this, and the window title is set to "Open Image".

If you want to use multiple filters, separate each one with two semicolons. For example:

"Images (*.png *.xpm *.jpg);;Text files (*.txt);;XML files (*.xml)"

You can create your own QFileDialog without using the static functions. By calling setFileMode(), you can specify what the user must select in the dialog:

QFileDialog dialog(this);

dialog.setFileMode(QFileDialog::AnyFile);

In the above example, the mode of the file dialog is set to AnyFile, meaning that the user can select any file, or even specify a file that doesn't exist. This mode is useful for creating a "Save As" file dialog. Use ExistingFile if the user must select an existing file, or Directory if only a directory may be selected. See the QFileDialog::FileMode enum for the complete list of modes.

The fileMode property contains the mode of operation for the dialog; this indicates what types of objects the user is expected to select. Use setNameFilter() to set the dialog's file filter. For example:

dialog.setNameFilter(tr("Images (*.png *.xpm *.jpg)"));

In the above example, the filter is set to "Images (*.png *.xpm *.jpg)", this means that only files with the extension png, xpm, or jpg will be shown in the QFileDialog. You can apply several filters by using setNameFilters(). Use selectNameFilter() to select one of the filters you've given as the file dialog's default filter.

The file dialog has two view modes: List and Detail. List presents the contents of the current directory as a list of file and directory names. Detail also displays a list of file and directory names, but provides additional information alongside each name, such as the file size and modification date. Set the mode with setViewMode():

dialog.setViewMode(QFileDialog::Detail);

The last important function you will need to use when creating your own file dialog is selectedFiles().

QStringList fileNames;

if (dialog.exec())

fileNames = dialog.selectedFiles();

In the above example, a modal file dialog is created and shown. If the user clicked OK, the file they selected is put in fileName.

The dialog's working directory can be set with setDirectory(). Each file in the current directory can be selected using the selectFile() function.

The Standard Dialogs example shows how to use QFileDialog as well as other built-in Qt dialogs.

See also QDir, QFileInfo, QFile, QPrintDialog, QColorDialog, QFontDialog, Standard Dialogs Example, and Application Example.

Member Enumeration Documentation

enum QtGui.QFileDialog.AcceptMode

Enumerator:

AcceptOpen
AcceptSave

enum QtGui.QFileDialog.DialogLabel

Enumerator:

Accept
FileName
FileType
LookIn
Reject

enum QtGui.QFileDialog.FileMode

This enum is used to indicate what the user may select in the file dialog; i.e. what the dialog will return if the user clicks OK.

This value is obsolete since Qt 4.5:

See also setFileMode().

Enumerator:

AnyFile	The name of a file, whether it exists or not.
Directory	The name of a directory. Both files and directories are displayed.
DirectoryOnly	Use Directory and setOption(ShowDirsOnly, true) instead.
ExistingFile	The name of a single existing file.
ExistingFiles	The names of zero or more existing files.

enum QtGui.QFileDialog.Option

Enumerator:

DontConfirmOverwrite	Don't ask for confirmation if an existing file is selected. By default confirmation is requested.
DontResolveSymlinks	Don't resolve symlinks in the file dialog. By default symlinks are resolved.
DontUseNativeDialog	Don't use the native file dialog. By default, the native file dialog is used unless you use a subclass of QFileDialog that contains the Q_OBJECT macro.
DontUseSheet	In previous versions of Qt, the static functions would create a sheet by default if the static function was given a parent. This is no longer supported and does nothing in Qt 4.5, The static functions will always be an application modal dialog. If you want to use sheets, use QFileDialog::open() instead.
HideNameFilterDetails	Indicates if the file name filter details are hidden or not.
ReadOnly	Indicates that the model is readonly.
ShowDirsOnly	Only show directories in the file dialog. By default both files and directories are shown. (Valid only in the Directory file mode.)

enum QtGui.QFileDialog.ViewMode

This enum describes the view mode of the file dialog; i.e. what information about each file will be displayed.

See also setViewMode().

Enumerator:

Detail	Displays an icon, a name, and details for each item in the directory.
List	Displays only an icon and a name for each item in the directory.

Constructor & Destructor Documentation

QtGui.QFileDialog.QFileDialog ( System.Type  dummy )

protected

QtGui.QFileDialog.QFileDialog	(	QWidget	parent,
		Qt.WindowType	f
	)

Constructs a file dialog with the given parent and widget flags.

QtGui.QFileDialog.QFileDialog	(	QWidget	parent = null,
		string	caption = "",
		string	directory = "",
		string	filter = ""
	)

Constructs a file dialog with the given parent and widget flags.

Member Function Documentation

override void QtGui.QFileDialog.Accept ( )

virtual

Reimplemented from QDialog::accept().

Reimplemented from QtGui.QDialog.

override void QtGui.QFileDialog.CreateProxy ( )

virtual

Reimplemented from QtGui.QDialog.

new void QtGui.QFileDialog.Dispose

(

)

override void QtGui.QFileDialog.Done ( int  result )

virtual

Reimplemented from QDialog::done().

Reimplemented from QtGui.QDialog.

static string QtGui.QFileDialog.GetExistingDirectory ( QWidget  parent = null, string  caption = "", string  dir = "", QFileDialog.Option  options = QFileDialog.Option.ShowDirsOnly  )

static

This is a convenience static function that will return an existing directory selected by the user.

QString dir = QFileDialog::getExistingDirectory(this, tr("Open Directory"),

"/home",

QFileDialog::ShowDirsOnly

| QFileDialog::DontResolveSymlinks);

This function creates a modal file dialog with the given parent widget. If parent is not 0, the dialog will be shown centered over the parent widget.

The dialog's working directory is set to dir, and the caption is set to caption. Either of these may be an empty string in which case the current directory and a default caption will be used respectively.

The options argument holds various options about how to run the dialog, see the QFileDialog::Option enum for more information on the flags you can pass. To ensure a native file dialog, ShowDirsOnly must be set.

On Windows, Mac OS X and Symbian^3, this static function will use the native file dialog and not a QFileDialog. On Windows CE, if the device has no native file dialog, a QFileDialog will be used.

On Unix/X11, the normal behavior of the file dialog is to resolve and follow symlinks. For example, if /usr/tmp is a symlink to /var/tmp, the file dialog will change to /var/tmp after entering /usr/tmp. If options includes DontResolveSymlinks, the file dialog will treat symlinks as regular directories.

On Windows the dialog will spin a blocking modal event loop that will not dispatch any QTimers, and if parent is not 0 then it will position the dialog just below the parent's title bar.

On Symbian^3 the options parameter is only used to define if the native file dialog is used.

Warning: Do not delete parent during the execution of the dialog. If you want to do this, you should create the dialog yourself using one of the QFileDialog constructors.

See also getOpenFileName(), getOpenFileNames(), and getSaveFileName().

static string QtGui.QFileDialog.GetOpenFileName ( QWidget  parent = null, string  caption = "", string  dir = "", string  filter = "", System.Text.StringBuilder  selectedFilter = null, QFileDialog.Option  options = 0  )

static

This is a convenience static function that returns an existing file selected by the user. If the user presses Cancel, it returns a null string.

QString fileName = QFileDialog::getOpenFileName(this, tr("Open File"),

"/home",

tr("Images (*.png *.xpm *.jpg)"));

The function creates a modal file dialog with the given parent widget. If parent is not 0, the dialog will be shown centered over the parent widget.

The file dialog's working directory will be set to dir. If dir includes a file name, the file will be selected. Only files that match the given filter are shown. The filter selected is set to selectedFilter. The parameters dir, selectedFilter, and filter may be empty strings. If you want multiple filters, separate them with ';;', for example:

"Images (*.png *.xpm *.jpg);;Text files (*.txt);;XML files (*.xml)"

The options argument holds various options about how to run the dialog, see the QFileDialog::Option enum for more information on the flags you can pass.

The dialog's caption is set to caption. If caption is not specified then a default caption will be used.

On Windows, Mac OS X and Symbian^3, this static function will use the native file dialog and not a QFileDialog.

On Windows the dialog will spin a blocking modal event loop that will not dispatch any QTimers, and if parent is not 0 then it will position the dialog just below the parent's title bar.

On Unix/X11, the normal behavior of the file dialog is to resolve and follow symlinks. For example, if /usr/tmp is a symlink to /var/tmp, the file dialog will change to /var/tmp after entering /usr/tmp. If options includes DontResolveSymlinks, the file dialog will treat symlinks as regular directories.

On Symbian^3 the parameter selectedFilter has no meaning and the options parameter is only used to define if the native file dialog is used.

Warning: Do not delete parent during the execution of the dialog. If you want to do this, you should create the dialog yourself using one of the QFileDialog constructors.

See also getOpenFileNames(), getSaveFileName(), and getExistingDirectory().

static System.Collections.Generic.List<string> QtGui.QFileDialog.GetOpenFileNames ( QWidget  parent = null, string  caption = "", string  dir = "", string  filter = "", System.Text.StringBuilder  selectedFilter = null, QFileDialog.Option  options = 0  )

static

This is a convenience static function that will return one or more existing files selected by the user.

QStringList files = QFileDialog::getOpenFileNames(

this,

"Select one or more files to open",

"/home",

"Images (*.png *.xpm *.jpg)");

This function creates a modal file dialog with the given parent widget. If parent is not 0, the dialog will be shown centered over the parent widget.

The file dialog's working directory will be set to dir. If dir includes a file name, the file will be selected. The filter is set to filter so that only those files which match the filter are shown. The filter selected is set to selectedFilter. The parameters dir, selectedFilter and filter may be empty strings. If you need multiple filters, separate them with ';;', for instance:

"Images (*.png *.xpm *.jpg);;Text files (*.txt);;XML files (*.xml)"

The dialog's caption is set to caption. If caption is not specified then a default caption will be used.

On Windows, Mac OS X and Symbian^3, this static function will use the native file dialog and not a QFileDialog.

On Windows the dialog will spin a blocking modal event loop that will not dispatch any QTimers, and if parent is not 0 then it will position the dialog just below the parent's title bar.

On Unix/X11, the normal behavior of the file dialog is to resolve and follow symlinks. For example, if /usr/tmp is a symlink to /var/tmp, the file dialog will change to /var/tmp after entering /usr/tmp. The options argument holds various options about how to run the dialog, see the QFileDialog::Option enum for more information on the flags you can pass.

Note: If you want to iterate over the list of files, you should iterate over a copy. For example:

QStringList list = files;

QStringList::Iterator it = list.begin();

while(it != list.end()) {

myProcessing(*it);

++it;

}

On Symbian^3 the parameter selectedFilter has no meaning and the options parameter is only used to define if the native file dialog is used. On Symbian^3, this function can only return a single filename.

Warning: Do not delete parent during the execution of the dialog. If you want to do this, you should create the dialog yourself using one of the QFileDialog constructors.

See also getOpenFileName(), getSaveFileName(), and getExistingDirectory().

static string QtGui.QFileDialog.GetSaveFileName ( QWidget  parent = null, string  caption = "", string  dir = "", string  filter = "", System.Text.StringBuilder  selectedFilter = null, QFileDialog.Option  options = 0  )

static

This is a convenience static function that will return a file name selected by the user. The file does not have to exist.

It creates a modal file dialog with the given parent widget. If parent is not 0, the dialog will be shown centered over the parent widget.

QString fileName = QFileDialog::getSaveFileName(this, tr("Save File"),

"/home/jana/untitled.png",

tr("Images (*.png *.xpm *.jpg)"));

The file dialog's working directory will be set to dir. If dir includes a file name, the file will be selected. Only files that match the filter are shown. The filter selected is set to selectedFilter. The parameters dir, selectedFilter, and filter may be empty strings. Multiple filters are separated with ';;'. For instance:

"Images (*.png *.xpm *.jpg);;Text files (*.txt);;XML files (*.xml)"

The options argument holds various options about how to run the dialog, see the QFileDialog::Option enum for more information on the flags you can pass.

The default filter can be chosen by setting selectedFilter to the desired value.

The dialog's caption is set to caption. If caption is not specified, a default caption will be used.

On Windows, Mac OS X and Symbian^3, this static function will use the native file dialog and not a QFileDialog.

On Windows the dialog will spin a blocking modal event loop that will not dispatch any QTimers, and if parent is not 0 then it will position the dialog just below the parent's title bar. On Mac OS X, with its native file dialog, the filter argument is ignored.

On Unix/X11, the normal behavior of the file dialog is to resolve and follow symlinks. For example, if /usr/tmp is a symlink to /var/tmp, the file dialog will change to /var/tmp after entering /usr/tmp. If options includes DontResolveSymlinks the file dialog will treat symlinks as regular directories.

On Symbian^3 the parameters filter and selectedFilter have no meaning. The options parameter is only used to define if the native file dialog is used.

Warning: Do not delete parent during the execution of the dialog. If you want to do this, you should create the dialog yourself using one of the QFileDialog constructors.

See also getOpenFileName(), getOpenFileNames(), and getExistingDirectory().

new string QtGui.QFileDialog.LabelText

(

QFileDialog.DialogLabel

label

)

Returns the text shown in the filedialog in the specified label.

See also setLabelText().

override void QtGui.QFileDialog.OnChangeEvent ( QEvent  e )

protectedvirtual

Reimplemented from QWidget::changeEvent().

Reimplemented from QtGui.QWidget.

new void QtGui.QFileDialog.OnCurrentChanged ( string  path )

protected

When the current file changes, this signal is emitted with the new file name as the path parameter.

See also filesSelected().

new void QtGui.QFileDialog.OnDirectoryEntered ( string  directory )

protected

This signal is emitted when the user enters a directory.

This function was introduced in Qt 4.3.

new void QtGui.QFileDialog.OnFileSelected ( string  file )

protected

When the selection changes and the dialog is accepted, this signal is emitted with the (possibly empty) selected file.

See also currentChanged() and QDialog::Accepted.

new void QtGui.QFileDialog.OnFilesSelected ( System.Collections.Generic.List< string >  files )

protected

When the selection changes and the dialog is accepted, this signal is emitted with the (possibly empty) list of selected files.

See also currentChanged() and QDialog::Accepted.

new void QtGui.QFileDialog.OnFilterSelected ( string  filter )

protected

This signal is emitted when the user selects a filter.

This function was introduced in Qt 4.3.

new void QtGui.QFileDialog.Open

(

)

This is an overloaded function.

This function connects one of its signals to the slot specified by receiver and member. The specific signal depends is filesSelected() if fileMode is ExistingFiles and fileSelected() if fileMode is anything else.

The signal will be disconnected from the slot when the dialog is closed.

This function was introduced in Qt 4.5.

new void QtGui.QFileDialog.Open	(	QObject	receiver,
		string	member
	)

This is an overloaded function.

This function connects one of its signals to the slot specified by receiver and member. The specific signal depends is filesSelected() if fileMode is ExistingFiles and fileSelected() if fileMode is anything else.

The signal will be disconnected from the slot when the dialog is closed.

This function was introduced in Qt 4.5.

new QFileDialog.Option QtGui.QFileDialog.options

(

)

new bool QtGui.QFileDialog.RestoreState

(

QByteArray

state

)

Restores the dialogs's layout, history and current directory to the state specified.

Typically this is used in conjunction with QSettings to restore the size from a past session.

Returns false if there are errors

This function was introduced in Qt 4.3.

new QByteArray QtGui.QFileDialog.SaveState

(

)

Saves the state of the dialog's layout, history and current directory.

Typically this is used in conjunction with QSettings to remember the size for a future session. A version number is stored as part of the data.

This function was introduced in Qt 4.3.

new System.Collections.Generic.List<string> QtGui.QFileDialog.SelectedFiles

(

)

Returns a list of strings containing the absolute paths of the selected files in the dialog. If no files are selected, or the mode is not ExistingFiles or ExistingFile, selectedFiles() contains the current path in the viewport.

See also selectedNameFilter() and selectFile().

new string QtGui.QFileDialog.SelectedFilter

(

)

new string QtGui.QFileDialog.SelectedNameFilter

(

)

Returns the filter that the user selected in the file dialog.

This function was introduced in Qt 4.4.

See also selectedFiles().

new void QtGui.QFileDialog.SelectFile

(

string

filename

)

Selects the given filename in the file dialog.

See also selectedFiles().

new void QtGui.QFileDialog.SelectFilter

(

string

filter

)

new void QtGui.QFileDialog.SelectNameFilter

(

string

filter

)

Sets the current file type filter. Multiple filters can be passed in filter by separating them with semicolons or spaces.

This function was introduced in Qt 4.4.

See also setNameFilter(), setNameFilters(), and selectedNameFilter().

new void QtGui.QFileDialog.SetDirectory

(

string

directory

)

Sets the file dialog's current directory.

See also directory().

new void QtGui.QFileDialog.SetFilter

(

string

filter

)

Sets the filter used by the model to filters. The filter is used to specify the kind of files that should be shown.

This function was introduced in Qt 4.4.

See also filter().

new void QtGui.QFileDialog.SetLabelText	(	QFileDialog.DialogLabel	label,
		string	text
	)

Sets the text shown in the filedialog in the specified label.

See also labelText().

new void QtGui.QFileDialog.SetNameFilter

(

string

filter

)

Sets the filter used in the file dialog to the given filter.

If filter contains a pair of parentheses containing one or more of anything*something, separated by spaces, then only the text contained in the parentheses is used as the filter. This means that these calls are all equivalent:

dialog.setNameFilter("All C++ files (*.cpp *.cc *.C *.cxx *.c++)");

dialog.setNameFilter("*.cpp *.cc *.C *.cxx *.c++");

This function was introduced in Qt 4.4.

See also setNameFilters().

new void QtGui.QFileDialog.SetNameFilterDetailsVisible

(

bool

enabled

)

new void QtGui.QFileDialog.SetOption	(	QFileDialog.Option	option,
		bool	on = true
	)

Sets the given option to be enabled if on is true; otherwise, clears the given option.

This function was introduced in Qt 4.5.

See also options and testOption().

new void QtGui.QFileDialog.SetOptions

(

QFileDialog.Option

options

)

override void QtGui.QFileDialog.SetVisible ( bool  visible )

virtual

Reimplemented from QWidget::setVisible().

Reimplemented from QtGui.QDialog.

new bool QtGui.QFileDialog.TestOption

(

QFileDialog.Option

option

)

Returns true if the given option is enabled; otherwise, returns false.

This function was introduced in Qt 4.5.

See also options and setOption().

static string QtGui.QFileDialog.Tr ( string  s, string  c = null  )

static

static string QtGui.QFileDialog.Tr ( string  s, string  c, int  n  )

static

static string QtGui.QFileDialog.TrUtf8 ( string  s, string  c = null  )

static

static string QtGui.QFileDialog.TrUtf8 ( string  s, string  c, int  n  )

static

Property Documentation

new AcceptMode QtGui.QFileDialog.acceptMode

getset

This property holds the accept mode of the dialog.

The action mode defines whether the dialog is for opening or saving files.

By default, this property is set to AcceptOpen.

new bool QtGui.QFileDialog.ConfirmOverwrite

getset

This property holds whether the filedialog should ask before accepting a selected file, when the accept mode is AcceptSave.

Use setOption(DontConfirmOverwrite, !enabled) or !testOption(DontConfirmOverwrite) instead.

Slot<System.String> QtGui.QFileDialog.CurrentChanged

addremove

When the current file changes, this signal is emitted with the new file name as the path parameter.

See also filesSelected().

new string QtGui.QFileDialog.DefaultSuffix

getset

This property holds suffix added to the filename if no other suffix was specified.

This property specifies a string that will be added to the filename if it has no suffix already. The suffix is typically used to indicate the file type (e.g. "txt" indicates a text file).

new QDir QtGui.QFileDialog.Directory

getset

Returns the directory currently being displayed in the dialog.

This is an overloaded function.

Slot<System.String> QtGui.QFileDialog.DirectoryEntered

addremove

This signal is emitted when the user enters a directory.

This function was introduced in Qt 4.3.

new IQFileDialogSignals QtGui.QFileDialog.Emit

getprotected

new FileMode QtGui.QFileDialog.fileMode

getset

This property holds the file mode of the dialog.

The file mode defines the number and type of items that the user is expected to select in the dialog.

By default, this property is set to AnyFile.

This function will set the labels for the FileName and Accept DialogLabels. It is possible to set custom text after the call to setFileMode().

Slot<System.String> QtGui.QFileDialog.FileSelected

addremove

When the selection changes and the dialog is accepted, this signal is emitted with the (possibly empty) selected file.

See also currentChanged() and QDialog::Accepted.

Slot<System.Collections.Generic.List<string> > QtGui.QFileDialog.FilesSelected

addremove

When the selection changes and the dialog is accepted, this signal is emitted with the (possibly empty) list of selected files.

See also currentChanged() and QDialog::Accepted.

new QDir.Filter QtGui.QFileDialog.Filter

getset

Returns the filter that is used when displaying files.

This function was introduced in Qt 4.4.

Sets the filter used by the model to filters. The filter is used to specify the kind of files that should be shown.

This function was introduced in Qt 4.4.

new System.Collections.Generic.List<string> QtGui.QFileDialog.Filters

getset

Slot<System.String> QtGui.QFileDialog.FilterSelected

addremove

This signal is emitted when the user selects a filter.

This function was introduced in Qt 4.3.

new System.Collections.Generic.List<string> QtGui.QFileDialog.History

getset

Returns the browsing history of the filedialog as a list of paths.

Sets the browsing history of the filedialog to contain the given paths.

new QFileIconProvider QtGui.QFileDialog.IconProvider

getset

Returns the icon provider used by the filedialog.

Sets the icon provider used by the filedialog to the specified provider.

new QAbstractItemDelegate QtGui.QFileDialog.ItemDelegate

getset

Returns the item delegate used to render the items in the views in the filedialog.

Sets the item delegate used to render items in the views in the file dialog to the given delegate.

Warning: You should not share the same instance of a delegate between views. Doing so can cause incorrect or unintuitive editing behavior since each view connected to a given delegate may receive the closeEditor() signal, and attempt to access, modify or close an editor that has already been closed.

Note that the model used is QFileSystemModel. It has custom item data roles, which is described by the Roles enum. You can use a QFileIconProvider if you only want custom icons.

new bool QtGui.QFileDialog.NameFilterDetailsVisible

getset

This property holds this property holds whether the filter details is shown or not.

When this property is true (the default), the filter details are shown in the combo box. When the property is set to false, these are hidden.

Use setOption(HideNameFilterDetails, !enabled) or !testOption(HideNameFilterDetails).

This property was introduced in Qt 4.4.

new System.Collections.Generic.List<string> QtGui.QFileDialog.NameFilters

getset

Returns the file type filters that are in operation on this file dialog.

This function was introduced in Qt 4.4.

Sets the filters used in the file dialog.

QStringList filters;

filters << "Image files (*.png *.xpm *.jpg)"

<< "Text files (*.txt)"

<< "Any files (*)";

QFileDialog dialog(this);

dialog.setNameFilters(filters);

dialog.exec();

This function was introduced in Qt 4.4.

new Option QtGui.QFileDialog.Options

getset

This property holds the various options that affect the look and feel of the dialog.

By default, all options are disabled.

Options should be set before showing the dialog. Setting them while the dialog is visible is not guaranteed to have an immediate effect on the dialog (depending on the option and on the platform).

This property was introduced in Qt 4.5.

new QAbstractProxyModel QtGui.QFileDialog.ProxyModel

getset

Returns the proxy model used by the file dialog. By default no proxy is set.

Sets the model for the views to the given proxyModel. This is useful if you want to modify the underlying model; for example, to add columns, filter data or add drives.

Any existing proxy model will be removed, but not deleted. The file dialog will take ownership of the proxyModel.

This function was introduced in Qt 4.3.

new bool QtGui.QFileDialog.ReadOnly

getset

This property holds whether the filedialog is read-only.

If this property is set to false, the file dialog will allow renaming, and deleting of files and directories and creating directories.

Use setOption(ReadOnly, enabled) or testOption(ReadOnly) instead.

new bool QtGui.QFileDialog.ResolveSymlinks

getset

This property holds whether the filedialog should resolve shortcuts.

If this property is set to true, the file dialog will resolve shortcuts or symbolic links.

Use setOption(DontResolveSymlinks, !enabled) or !testOption(DontResolveSymlinks).

new System.Collections.Generic.List<QUrl> QtGui.QFileDialog.SidebarUrls

getset

Returns a list of urls that are currently in the sidebar

This function was introduced in Qt 4.3.

Sets the urls that are located in the sidebar.

For instance:

QList<QUrl> urls;

urls << QUrl::fromLocalFile("/home/gvatteka/dev/qt-45")

<< QUrl::fromLocalFile(QDesktopServices::storageLocation(QDesktopServices::MusicLocation));

QFileDialog dialog;

dialog.setSidebarUrls(urls);

dialog.setFileMode(QFileDialog::AnyFile);

if(dialog.exec()) {

// ...

}

The file dialog will then look like this:

This function was introduced in Qt 4.3.

new QMetaObject QtGui.QFileDialog.StaticMetaObject

staticget

new ViewMode QtGui.QFileDialog.viewMode

getset

This property holds the way files and directories are displayed in the dialog.

By default, the Detail mode is used to display information about files and directories.