• Skip to content
  • Skip to link menu
KDE API Reference
  • KDE API Reference
  • kdelibs API Reference
  • KDE Home
  • Contact Us
 

KIO

Public Types | Public Slots | Signals | Public Member Functions | Static Public Member Functions | Protected Slots | Protected Member Functions | List of all members
KFileDialog Class Reference

#include <kfiledialog.h>

Inheritance diagram for KFileDialog:
Inheritance graph
[legend]

Public Types

enum  OperationMode { Other = 0, Opening, Saving }
 
enum  Option { ConfirmOverwrite = 0x01, ShowInlinePreview = 0x02 }
 

Public Slots

int exec ()
 

Signals

void fileHighlighted (const KUrl &)
 
QT_MOC_COMPAT void fileHighlighted (const QString &)
 
void fileSelected (const KUrl &)
 
QT_MOC_COMPAT void fileSelected (const QString &)
 
void filterChanged (const QString &filter)
 
void selectionChanged ()
 

Public Member Functions

 KFileDialog (const KUrl &startDir, const QString &filter, QWidget *parent, QWidget *widget=0)
 
 ~KFileDialog ()
 
KActionCollection * actionCollection () const
 
KUrl baseUrl () const
 
KPushButton * cancelButton () const
 
void clearFilter ()
 
QString currentFilter () const
 
KMimeType::Ptr currentFilterMimeType ()
 
QString currentMimeFilter () const
 
KAbstractFileWidget * fileWidget ()
 
KFileFilterCombo * filterWidget () const
 
bool keepsLocation () const
 
KUrlComboBox * locationEdit () const
 
KFile::Modes mode () const
 
KPushButton * okButton () const
 
OperationMode operationMode () const
 
QString selectedFile () const
 
QStringList selectedFiles () const
 
KUrl selectedUrl () const
 
KUrl::List selectedUrls () const
 
void setConfirmOverwrite (bool enable)
 
void setFilter (const QString &filter)
 
void setInlinePreviewShown (bool show)
 
void setKeepLocation (bool keep)
 
void setLocationLabel (const QString &text)
 
void setMimeFilter (const QStringList &types, const QString &defaultType=QString())
 
void setMode (KFile::Modes m)
 
void setOperationMode (KFileDialog::OperationMode)
 
void setPreviewWidget (KPreviewWidgetBase *w)
 
void setSelection (const QString &name)
 
void setUrl (const KUrl &url, bool clearforward=true)
 
virtual QSize sizeHint () const
 
KToolBar * toolBar () const
 
- Public Member Functions inherited from QDialog
 QDialog (QWidget *parent, QFlags< Qt::WindowType > f)
 
 QDialog (QWidget *parent, const char *name, bool modal, QFlags< Qt::WindowType > f)
 
 ~QDialog ()
 
virtual void accept ()
 
void accepted ()
 
virtual void done (int r)
 
int exec ()
 
QWidget * extension () const
 
void finished (int result)
 
bool isSizeGripEnabled () const
 
virtual QSize minimumSizeHint () const
 
void open ()
 
Qt::Orientation orientation () const
 
virtual void reject ()
 
void rejected ()
 
int result () const
 
void setExtension (QWidget *extension)
 
void setModal (bool modal)
 
void setOrientation (Qt::Orientation orientation)
 
void setResult (int i)
 
void setSizeGripEnabled (bool)
 
virtual void setVisible (bool visible)
 
void showExtension (bool showIt)
 
- Public Member Functions inherited from QWidget
 QWidget (QWidget *parent, QFlags< Qt::WindowType > f)
 
 QWidget (QWidget *parent, const char *name, QFlags< Qt::WindowType > f)
 
 ~QWidget ()
 
bool acceptDrops () const
 
QString accessibleDescription () const
 
QString accessibleName () const
 
QList< QAction * > actions () const
 
void activateWindow ()
 
void addAction (QAction *action)
 
void addActions (QList< QAction * > actions)
 
void adjustSize ()
 
bool autoFillBackground () const
 
Qt::BackgroundMode backgroundMode () const
 
QPoint backgroundOffset () const
 
BackgroundOrigin backgroundOrigin () const
 
QPalette::ColorRole backgroundRole () const
 
QSize baseSize () const
 
QString caption () const
 
QWidget * childAt (int x, int y, bool includeThis) const
 
QWidget * childAt (const QPoint &p, bool includeThis) const
 
QWidget * childAt (int x, int y) const
 
QWidget * childAt (const QPoint &p) const
 
QRect childrenRect () const
 
QRegion childrenRegion () const
 
void clearFocus ()
 
void clearMask ()
 
bool close (bool alsoDelete)
 
bool close ()
 
QColorGroup colorGroup () const
 
void constPolish () const
 
QMargins contentsMargins () const
 
QRect contentsRect () const
 
Qt::ContextMenuPolicy contextMenuPolicy () const
 
QCursor cursor () const
 
void customContextMenuRequested (const QPoint &pos)
 
void drawText (const QPoint &p, const QString &s)
 
void drawText (int x, int y, const QString &s)
 
WId effectiveWinId () const
 
void ensurePolished () const
 
void erase ()
 
void erase (const QRect &rect)
 
void erase (const QRegion &rgn)
 
void erase (int x, int y, int w, int h)
 
Qt::FocusPolicy focusPolicy () const
 
QWidget * focusProxy () const
 
QWidget * focusWidget () const
 
const QFont & font () const
 
QFontInfo fontInfo () const
 
QFontMetrics fontMetrics () const
 
QPalette::ColorRole foregroundRole () const
 
QRect frameGeometry () const
 
QSize frameSize () const
 
const QRect & geometry () const
 
void getContentsMargins (int *left, int *top, int *right, int *bottom) const
 
virtual HDC getDC () const
 
void grabGesture (Qt::GestureType gesture, QFlags< Qt::GestureFlag > flags)
 
void grabKeyboard ()
 
void grabMouse ()
 
void grabMouse (const QCursor &cursor)
 
int grabShortcut (const QKeySequence &key, Qt::ShortcutContext context)
 
QGraphicsEffect * graphicsEffect () const
 
QGraphicsProxyWidget * graphicsProxyWidget () const
 
bool hasEditFocus () const
 
bool hasFocus () const
 
bool hasMouse () const
 
bool hasMouseTracking () const
 
int height () const
 
virtual int heightForWidth (int w) const
 
void hide ()
 
const QPixmap * icon () const
 
void iconify ()
 
QString iconText () const
 
QInputContext * inputContext ()
 
Qt::InputMethodHints inputMethodHints () const
 
virtual QVariant inputMethodQuery (Qt::InputMethodQuery query) const
 
void insertAction (QAction *before, QAction *action)
 
void insertActions (QAction *before, QList< QAction * > actions)
 
bool isActiveWindow () const
 
bool isAncestorOf (const QWidget *child) const
 
bool isDesktop () const
 
bool isDialog () const
 
bool isEnabled () const
 
bool isEnabledTo (QWidget *ancestor) const
 
bool isEnabledToTLW () const
 
bool isFullScreen () const
 
bool isHidden () const
 
bool isInputMethodEnabled () const
 
bool isMaximized () const
 
bool isMinimized () const
 
bool isModal () const
 
bool isPopup () const
 
bool isShown () const
 
bool isTopLevel () const
 
bool isUpdatesEnabled () const
 
bool isVisible () const
 
bool isVisibleTo (QWidget *ancestor) const
 
bool isVisibleToTLW () const
 
bool isWindow () const
 
bool isWindowModified () const
 
QLayout * layout () const
 
Qt::LayoutDirection layoutDirection () const
 
QLocale locale () const
 
void lower ()
 
Qt::HANDLE macCGHandle () const
 
Qt::HANDLE macQDHandle () const
 
QPoint mapFrom (QWidget *parent, const QPoint &pos) const
 
QPoint mapFromGlobal (const QPoint &pos) const
 
QPoint mapFromParent (const QPoint &pos) const
 
QPoint mapTo (QWidget *parent, const QPoint &pos) const
 
QPoint mapToGlobal (const QPoint &pos) const
 
QPoint mapToParent (const QPoint &pos) const
 
QRegion mask () const
 
int maximumHeight () const
 
QSize maximumSize () const
 
int maximumWidth () const
 
int minimumHeight () const
 
QSize minimumSize () const
 
int minimumWidth () const
 
void move (int x, int y)
 
void move (const QPoint &)
 
QWidget * nativeParentWidget () const
 
QWidget * nextInFocusChain () const
 
QRect normalGeometry () const
 
void overrideWindowFlags (QFlags< Qt::WindowType > flags)
 
bool ownCursor () const
 
bool ownFont () const
 
bool ownPalette () const
 
virtual QPaintEngine * paintEngine () const
 
const QPalette & palette () const
 
QWidget * parentWidget (bool sameWindow) const
 
QWidget * parentWidget () const
 
QPlatformWindow * platformWindow () const
 
QPlatformWindowFormat platformWindowFormat () const
 
void polish ()
 
QPoint pos () const
 
QWidget * previousInFocusChain () const
 
void raise ()
 
void recreate (QWidget *parent, QFlags< Qt::WindowType > f, const QPoint &p, bool showIt)
 
QRect rect () const
 
virtual void releaseDC (HDC hdc) const
 
void releaseKeyboard ()
 
void releaseMouse ()
 
void releaseShortcut (int id)
 
void removeAction (QAction *action)
 
void render (QPaintDevice *target, const QPoint &targetOffset, const QRegion &sourceRegion, QFlags< QWidget::RenderFlag > renderFlags)
 
void render (QPainter *painter, const QPoint &targetOffset, const QRegion &sourceRegion, QFlags< QWidget::RenderFlag > renderFlags)
 
void repaint (int x, int y, int w, int h, bool b)
 
void repaint (const QRegion &rgn, bool b)
 
void repaint ()
 
void repaint (int x, int y, int w, int h)
 
void repaint (const QRegion &rgn)
 
void repaint (bool b)
 
void repaint (const QRect &rect)
 
void repaint (const QRect &r, bool b)
 
void reparent (QWidget *parent, QFlags< Qt::WindowType > f, const QPoint &p, bool showIt)
 
void reparent (QWidget *parent, const QPoint &p, bool showIt)
 
void resize (int w, int h)
 
void resize (const QSize &)
 
bool restoreGeometry (const QByteArray &geometry)
 
QByteArray saveGeometry () const
 
void scroll (int dx, int dy)
 
void scroll (int dx, int dy, const QRect &r)
 
void setAcceptDrops (bool on)
 
void setAccessibleDescription (const QString &description)
 
void setAccessibleName (const QString &name)
 
void setActiveWindow ()
 
void setAttribute (Qt::WidgetAttribute attribute, bool on)
 
void setAutoFillBackground (bool enabled)
 
void setBackgroundColor (const QColor &color)
 
void setBackgroundMode (Qt::BackgroundMode widgetBackground, Qt::BackgroundMode paletteBackground)
 
void setBackgroundOrigin (BackgroundOrigin background)
 
void setBackgroundPixmap (const QPixmap &pixmap)
 
void setBackgroundRole (QPalette::ColorRole role)
 
void setBaseSize (const QSize &)
 
void setBaseSize (int basew, int baseh)
 
void setCaption (const QString &c)
 
void setContentsMargins (int left, int top, int right, int bottom)
 
void setContentsMargins (const QMargins &margins)
 
void setContextMenuPolicy (Qt::ContextMenuPolicy policy)
 
void setCursor (const QCursor &)
 
void setDisabled (bool disable)
 
void setEditFocus (bool enable)
 
void setEnabled (bool)
 
void setEraseColor (const QColor &color)
 
void setErasePixmap (const QPixmap &pixmap)
 
void setFixedHeight (int h)
 
void setFixedSize (const QSize &s)
 
void setFixedSize (int w, int h)
 
void setFixedWidth (int w)
 
void setFocus (Qt::FocusReason reason)
 
void setFocus ()
 
void setFocusPolicy (Qt::FocusPolicy policy)
 
void setFocusProxy (QWidget *w)
 
void setFont (const QFont &)
 
void setFont (const QFont &f, bool b)
 
void setForegroundRole (QPalette::ColorRole role)
 
void setGeometry (int x, int y, int w, int h)
 
void setGeometry (const QRect &)
 
void setGraphicsEffect (QGraphicsEffect *effect)
 
void setHidden (bool hidden)
 
void setIcon (const QPixmap &i)
 
void setIconText (const QString &it)
 
void setInputContext (QInputContext *context)
 
void setInputMethodEnabled (bool enabled)
 
void setInputMethodHints (QFlags< Qt::InputMethodHint > hints)
 
void setKeyCompression (bool b)
 
void setLayout (QLayout *layout)
 
void setLayoutDirection (Qt::LayoutDirection direction)
 
void setLocale (const QLocale &locale)
 
void setMask (const QBitmap &bitmap)
 
void setMask (const QRegion &region)
 
void setMaximumHeight (int maxh)
 
void setMaximumSize (const QSize &)
 
void setMaximumSize (int maxw, int maxh)
 
void setMaximumWidth (int maxw)
 
void setMinimumHeight (int minh)
 
void setMinimumSize (int minw, int minh)
 
void setMinimumSize (const QSize &)
 
void setMinimumWidth (int minw)
 
void setMouseTracking (bool enable)
 
void setPalette (const QPalette &)
 
void setPalette (const QPalette &p, bool b)
 
void setPaletteBackgroundColor (const QColor &color)
 
void setPaletteBackgroundPixmap (const QPixmap &pixmap)
 
void setPaletteForegroundColor (const QColor &color)
 
void setParent (QWidget *parent)
 
void setParent (QWidget *parent, QFlags< Qt::WindowType > f)
 
void setPlatformWindow (QPlatformWindow *window)
 
void setPlatformWindowFormat (const QPlatformWindowFormat &format)
 
void setShortcutAutoRepeat (int id, bool enable)
 
void setShortcutEnabled (int id, bool enable)
 
void setShown (bool shown)
 
void setSizeIncrement (const QSize &)
 
void setSizeIncrement (int w, int h)
 
void setSizePolicy (QSizePolicy::Policy hor, QSizePolicy::Policy ver, bool hfw)
 
void setSizePolicy (QSizePolicy::Policy horizontal, QSizePolicy::Policy vertical)
 
void setSizePolicy (QSizePolicy)
 
void setStatusTip (const QString &)
 
void setStyle (QStyle *style)
 
QStyle * setStyle (const QString &style)
 
void setStyleSheet (const QString &styleSheet)
 
void setToolTip (const QString &)
 
void setUpdatesEnabled (bool enable)
 
void setupUi (QWidget *widget)
 
void setWhatsThis (const QString &)
 
void setWindowFilePath (const QString &filePath)
 
void setWindowFlags (QFlags< Qt::WindowType > type)
 
void setWindowIcon (const QIcon &icon)
 
void setWindowIconText (const QString &)
 
void setWindowModality (Qt::WindowModality windowModality)
 
void setWindowModified (bool)
 
void setWindowOpacity (qreal level)
 
void setWindowRole (const QString &role)
 
void setWindowState (QFlags< Qt::WindowState > windowState)
 
void setWindowSurface (QWindowSurface *surface)
 
void setWindowTitle (const QString &)
 
void show ()
 
void showFullScreen ()
 
void showMaximized ()
 
void showMinimized ()
 
void showNormal ()
 
QSize size () const
 
QSize sizeIncrement () const
 
QSizePolicy sizePolicy () const
 
void stackUnder (QWidget *w)
 
QString statusTip () const
 
QStyle * style () const
 
QString styleSheet () const
 
bool testAttribute (Qt::WidgetAttribute attribute) const
 
QString toolTip () const
 
QWidget * topLevelWidget () const
 
bool underMouse () const
 
void ungrabGesture (Qt::GestureType gesture)
 
void unsetCursor ()
 
void unsetFont ()
 
void unsetLayoutDirection ()
 
void unsetLocale ()
 
void unsetPalette ()
 
void update (const QRect &rect)
 
void update (const QRegion &rgn)
 
void update (int x, int y, int w, int h)
 
void update ()
 
void updateGeometry ()
 
bool updatesEnabled () const
 
QRect visibleRect () const
 
QRegion visibleRegion () const
 
QString whatsThis () const
 
int width () const
 
QWidget * window () const
 
QString windowFilePath () const
 
Qt::WindowFlags windowFlags () const
 
QIcon windowIcon () const
 
QString windowIconText () const
 
Qt::WindowModality windowModality () const
 
qreal windowOpacity () const
 
QString windowRole () const
 
Qt::WindowStates windowState () const
 
QWindowSurface * windowSurface () const
 
QString windowTitle () const
 
Qt::WindowType windowType () const
 
WId winId () const
 
int x () const
 
const QX11Info & x11Info () const
 
Qt::HANDLE x11PictureHandle () const
 
int y () const
 
- Public Member Functions inherited from QObject
 QObject (QObject *parent)
 
 QObject (QObject *parent, const char *name)
 
virtual  ~QObject ()
 
bool blockSignals (bool block)
 
QObject * child (const char *objName, const char *inheritsClass, bool recursiveSearch) const
 
const QObjectList & children () const
 
const char * className () const
 
bool connect (const QObject *sender, const char *signal, const char *method, Qt::ConnectionType type) const
 
void deleteLater ()
 
void destroyed (QObject *obj)
 
bool disconnect (const QObject *receiver, const char *method)
 
bool disconnect (const char *signal, const QObject *receiver, const char *method)
 
void dumpObjectInfo ()
 
void dumpObjectTree ()
 
QList< QByteArray > dynamicPropertyNames () const
 
T findChild (const QString &name) const
 
QList< T > findChildren (const QRegExp &regExp) const
 
QList< T > findChildren (const QString &name) const
 
bool inherits (const char *className) const
 
void insertChild (QObject *object)
 
void installEventFilter (QObject *filterObj)
 
bool isA (const char *className) const
 
bool isWidgetType () const
 
void killTimer (int id)
 
virtual const QMetaObject * metaObject () const
 
void moveToThread (QThread *targetThread)
 
const char * name () const
 
const char * name (const char *defaultName) const
 
QString objectName () const
 
QObject * parent () const
 
QVariant property (const char *name) const
 
void removeChild (QObject *object)
 
void removeEventFilter (QObject *obj)
 
void setName (const char *name)
 
void setObjectName (const QString &name)
 
void setParent (QObject *parent)
 
bool setProperty (const char *name, const QVariant &value)
 
bool signalsBlocked () const
 
int startTimer (int interval)
 
QThread * thread () const
 
- Public Member Functions inherited from QPaintDevice
virtual  ~QPaintDevice ()
 
int colorCount () const
 
int depth () const
 
int height () const
 
int heightMM () const
 
int logicalDpiX () const
 
int logicalDpiY () const
 
int numColors () const
 
virtual QPaintEngine * paintEngine () const =0
 
bool paintingActive () const
 
int physicalDpiX () const
 
int physicalDpiY () const
 
int width () const
 
int widthMM () const
 
int x11Cells () const
 
Qt::HANDLE x11Colormap () const
 
bool x11DefaultColormap () const
 
bool x11DefaultVisual () const
 
int x11Depth () const
 
Display * x11Display () const
 
int x11Screen () const
 
void * x11Visual () const
 

Static Public Member Functions

static QString getExistingDirectory (const KUrl &startDir=KUrl(), QWidget *parent=0, const QString &caption=QString())
 
static KUrl getExistingDirectoryUrl (const KUrl &startDir=KUrl(), QWidget *parent=0, const QString &caption=QString())
 
static KUrl getImageOpenUrl (const KUrl &startDir=KUrl(), QWidget *parent=0, const QString &caption=QString())
 
static QString getOpenFileName (const KUrl &startDir=KUrl(), const QString &filter=QString(), QWidget *parent=0, const QString &caption=QString())
 
static QStringList getOpenFileNames (const KUrl &startDir=KUrl(), const QString &filter=QString(), QWidget *parent=0, const QString &caption=QString())
 
static QString getOpenFileNameWId (const KUrl &startDir, const QString &filter, WId parent_id, const QString &caption)
 
static KUrl getOpenUrl (const KUrl &startDir=KUrl(), const QString &filter=QString(), QWidget *parent=0, const QString &caption=QString())
 
static KUrl::List getOpenUrls (const KUrl &startDir=KUrl(), const QString &filter=QString(), QWidget *parent=0, const QString &caption=QString())
 
static QString getSaveFileName (const KUrl &startDir=KUrl(), const QString &filter=QString(), QWidget *parent=0, const QString &caption=QString())
 
static QString getSaveFileName (const KUrl &startDir, const QString &filter, QWidget *parent, const QString &caption, Options options)
 
static QString getSaveFileNameWId (const KUrl &startDir, const QString &filter, WId parent_id, const QString &caption)
 
static QString getSaveFileNameWId (const KUrl &startDir, const QString &filter, WId parent_id, const QString &caption, Options options)
 
static KUrl getSaveUrl (const KUrl &startDir=KUrl(), const QString &filter=QString(), QWidget *parent=0, const QString &caption=QString())
 
static KUrl getSaveUrl (const KUrl &startDir, const QString &filter, QWidget *parent, const QString &caption, Options options)
 
static KUrl getStartUrl (const KUrl &startDir, QString &recentDirClass)
 
static void setStartDir (const KUrl &directory)
 
- Static Public Member Functions inherited from QWidget
QWidget * find (WId id)
 
QWidget * keyboardGrabber ()
 
QWidget * mouseGrabber ()
 
void setTabOrder (QWidget *first, QWidget *second)
 
QWidgetMapper * wmapper ()
 
- Static Public Member Functions inherited from QObject
bool connect (const QObject *sender, const char *signal, const QObject *receiver, const char *method, Qt::ConnectionType type)
 
bool connect (const QObject *sender, const QMetaMethod &signal, const QObject *receiver, const QMetaMethod &method, Qt::ConnectionType type)
 
bool disconnect (const QObject *sender, const char *signal, const QObject *receiver, const char *method)
 
bool disconnect (const QObject *sender, const QMetaMethod &signal, const QObject *receiver, const QMetaMethod &method)
 
QString tr (const char *sourceText, const char *disambiguation, int n)
 
QString trUtf8 (const char *sourceText, const char *disambiguation, int n)
 
- Static Public Member Functions inherited from QPaintDevice
int x11AppCells (int screen)
 
Qt::HANDLE x11AppColormap (int screen)
 
bool x11AppDefaultColormap (int screen)
 
bool x11AppDefaultVisual (int screen)
 
int x11AppDepth (int screen)
 
Display * x11AppDisplay ()
 
int x11AppDpiX (int screen)
 
int x11AppDpiY (int screen)
 
Qt::HANDLE x11AppRootWindow (int screen)
 
int x11AppScreen ()
 
void * x11AppVisual (int screen)
 
void x11SetAppDpiX (int dpi, int screen)
 
void x11SetAppDpiY (int dpi, int screen)
 

Protected Slots

virtual void accept ()
 
virtual void slotCancel ()
 
virtual void slotOk ()
 

Protected Member Functions

virtual void hideEvent (QHideEvent *event)
 
virtual void keyPressEvent (QKeyEvent *e)
 
- Protected Member Functions inherited from QDialog
virtual void closeEvent (QCloseEvent *e)
 
virtual void contextMenuEvent (QContextMenuEvent *e)
 
virtual bool event (QEvent *e)
 
virtual bool eventFilter (QObject *o, QEvent *e)
 
virtual void resizeEvent (QResizeEvent *)
 
virtual void showEvent (QShowEvent *event)
 
- Protected Member Functions inherited from QWidget
virtual void actionEvent (QActionEvent *event)
 
virtual void changeEvent (QEvent *event)
 
void create (WId window, bool initializeWindow, bool destroyOldWindow)
 
void destroy (bool destroyWindow, bool destroySubWindows)
 
virtual void dragEnterEvent (QDragEnterEvent *event)
 
virtual void dragLeaveEvent (QDragLeaveEvent *event)
 
virtual void dragMoveEvent (QDragMoveEvent *event)
 
virtual void dropEvent (QDropEvent *event)
 
virtual void enterEvent (QEvent *event)
 
virtual void focusInEvent (QFocusEvent *event)
 
bool focusNextChild ()
 
virtual bool focusNextPrevChild (bool next)
 
virtual void focusOutEvent (QFocusEvent *event)
 
bool focusPreviousChild ()
 
virtual void inputMethodEvent (QInputMethodEvent *event)
 
virtual void keyReleaseEvent (QKeyEvent *event)
 
virtual void languageChange ()
 
virtual void leaveEvent (QEvent *event)
 
virtual bool macEvent (EventHandlerCallRef caller, EventRef event)
 
virtual int metric (PaintDeviceMetric m) const
 
virtual void mouseDoubleClickEvent (QMouseEvent *event)
 
virtual void mouseMoveEvent (QMouseEvent *event)
 
virtual void mousePressEvent (QMouseEvent *event)
 
virtual void mouseReleaseEvent (QMouseEvent *event)
 
virtual void moveEvent (QMoveEvent *event)
 
virtual void paintEvent (QPaintEvent *event)
 
virtual bool qwsEvent (QWSEvent *event)
 
void resetInputContext ()
 
virtual void tabletEvent (QTabletEvent *event)
 
void updateMicroFocus ()
 
virtual void wheelEvent (QWheelEvent *event)
 
virtual bool winEvent (MSG *message, long *result)
 
virtual bool x11Event (XEvent *event)
 
- Protected Member Functions inherited from QObject
bool checkConnectArgs (const char *signal, const QObject *object, const char *method)
 
virtual void childEvent (QChildEvent *event)
 
virtual void connectNotify (const char *signal)
 
virtual void customEvent (QEvent *event)
 
virtual void disconnectNotify (const char *signal)
 
int receivers (const char *signal) const
 
QObject * sender () const
 
int senderSignalIndex () const
 
virtual void timerEvent (QTimerEvent *event)
 
- Protected Member Functions inherited from QPaintDevice
 QPaintDevice ()
 

Additional Inherited Members

- Public Attributes inherited from QWidget
typedef RenderFlags
 
- Static Protected Member Functions inherited from QObject
QByteArray normalizeSignalSlot (const char *signalSlot)
 
- Properties inherited from QDialog
 modal
 
 sizeGripEnabled
 
- Properties inherited from QWidget
 acceptDrops
 
 accessibleDescription
 
 accessibleName
 
 autoFillBackground
 
 baseSize
 
 childrenRect
 
 childrenRegion
 
 contextMenuPolicy
 
 cursor
 
 enabled
 
 focus
 
 focusPolicy
 
 font
 
 frameGeometry
 
 frameSize
 
 fullScreen
 
 geometry
 
 height
 
 inputMethodHints
 
 isActiveWindow
 
 layoutDirection
 
 locale
 
 maximized
 
 maximumHeight
 
 maximumSize
 
 maximumWidth
 
 minimized
 
 minimumHeight
 
 minimumSize
 
 minimumSizeHint
 
 minimumWidth
 
 modal
 
 mouseTracking
 
 normalGeometry
 
 palette
 
 pos
 
 rect
 
 size
 
 sizeHint
 
 sizeIncrement
 
 sizePolicy
 
 statusTip
 
 styleSheet
 
 toolTip
 
 updatesEnabled
 
 visible
 
 whatsThis
 
 width
 
 windowFilePath
 
 windowFlags
 
 windowIcon
 
 windowIconText
 
 windowModality
 
 windowModified
 
 windowOpacity
 
 windowTitle
 
 x
 
 y
 
- Properties inherited from QObject
 objectName
 

Detailed Description

Provides a user (and developer) friendly way to select files and directories.

The widget can be used as a drop in replacement for the QFileDialog widget, but has greater functionality and a nicer GUI.

You will usually want to use one of the static methods getOpenFileName(), getSaveFileName(), getOpenUrl() or for multiple files getOpenFileNames() or getOpenUrls().

The dialog has been designed to allow applications to customize it by subclassing. It uses geometry management to ensure that subclasses can easily add children that will be incorporated into the layout.

kfiledialog.png
KDE File Dialog

A file selection dialog.

Author
Richard J. Moore rich@.nosp@m.kde..nosp@m.org, Carsten Pfeiffer pfeif.nosp@m.fer@.nosp@m.kde.o.nosp@m.rg

Definition at line 68 of file kfiledialog.h.

Member Enumeration Documentation

enum KFileDialog::OperationMode

Defines some default behavior of the filedialog.

E.g. in mode Opening and Saving, the selected files/urls will be added to the "recent documents" list. The Saving mode also implies setKeepLocation() being set.

Other means that no default actions are performed.

See also
setOperationMode
operationMode
Enumerator
Other 
Opening 
Saving 

Definition at line 85 of file kfiledialog.h.

enum KFileDialog::Option

Defines the options to use when calling getSave* functions.

Since
4.4
Enumerator
ConfirmOverwrite 

Confirm whether to overwrite file to save.

ShowInlinePreview 

Always show an inline preview.

Definition at line 91 of file kfiledialog.h.

Constructor & Destructor Documentation

KFileDialog::KFileDialog ( const KUrl &  startDir,
const QString &  filter,
QWidget *  parent,
QWidget *  widget = 0 
)

Constructs a file dialog.

Parameters
startDirSpecifies the starting directory and/or initially selected file name, or a last used directory and optional file name using the kfiledialog:/// syntax. Refer to the KFileWidget documentation for more information on this parameter.
filterA shell glob or a mimetype filter that specifies which files to display. For better consistency across applications, it is recommended to use a mimetype filter. See setFilter() and setMimeFilter() for details on how to use this argument.
parentThe parent widget of this dialog
widgetA widget, or a widget of widgets, for displaying custom data in the dialog. This can be used, for example, to display a check box with the caption "Open as read-only". When creating this widget, you don't need to specify a parent, since the widget's parent will be set automatically by KFileDialog.
See also
KFileWidget::KFileWidget()

Definition at line 253 of file kfiledialog.cpp.

KFileDialog::~KFileDialog ( )

Destructs the file dialog.

Definition at line 320 of file kfiledialog.cpp.

Member Function Documentation

void KFileDialog::accept ( )
protectedvirtualslot

Definition at line 424 of file kfiledialog.cpp.

KActionCollection * KFileDialog::actionCollection ( ) const
Returns
a pointer to the action collection, holding all the used KActions.

Definition at line 882 of file kfiledialog.cpp.

KUrl KFileDialog::baseUrl ( ) const
Returns
the currently shown directory.

Definition at line 694 of file kfiledialog.cpp.

KPushButton * KFileDialog::cancelButton ( ) const
Returns
a pointer to the Cancel-Button in the filedialog. You may use it e.g. to set a custom text to it.

Definition at line 867 of file kfiledialog.cpp.

void KFileDialog::clearFilter ( )

Clears any mime- or namefilter.

Does not reload the directory.

Definition at line 363 of file kfiledialog.cpp.

QString KFileDialog::currentFilter ( ) const

Returns the current filter as entered by the user or one of the predefined set via setFilter().

See also
setFilter()
filterChanged()

Definition at line 341 of file kfiledialog.cpp.

KMimeType::Ptr KFileDialog::currentFilterMimeType ( )

Returns the mimetype for the desired output format.

This is only valid if setMimeFilter() has been called previously.

See also
setFilterMimeType()

Definition at line 384 of file kfiledialog.cpp.

QString KFileDialog::currentMimeFilter ( ) const

The mimetype for the desired output format.

This is only valid if setMimeFilter() has been called previously.

See also
setMimeFilter()

Definition at line 372 of file kfiledialog.cpp.

int KFileDialog::exec ( )
slot

Definition at line 965 of file kfiledialog.cpp.

void KFileDialog::fileHighlighted ( const KUrl &  )
signal

Emitted when the user highlights a file.

Since
4.4
QT_MOC_COMPAT void KFileDialog::fileHighlighted ( const QString &  )
signal
Deprecated:
, connect to fileSelected(const KUrl&) instead
void KFileDialog::fileSelected ( const KUrl &  )
signal

Emitted when the user selects a file.

It is only emitted in single- selection mode. The best way to get notified about selected file(s) is to connect to the okClicked() signal inherited from KDialog and call selectedFile(), selectedFiles(), selectedUrl() or selectedUrls().

Since
4.4
QT_MOC_COMPAT void KFileDialog::fileSelected ( const QString &  )
signal
Deprecated:
, connect to fileSelected(const KUrl&) instead
KAbstractFileWidget * KFileDialog::fileWidget ( )

Returns the KFileWidget that implements most of this file dialog.

If you link to libkfile you can cast this to a KFileWidget*.

Definition at line 959 of file kfiledialog.cpp.

void KFileDialog::filterChanged ( const QString &  filter)
signal

Emitted when the filter changed, i.e.

the user entered an own filter or chose one of the predefined set via setFilter().

Parameters
filtercontains the new filter (only the extension part, not the explanation), i.e. "*.cpp" or "*.cpp *.cc".
See also
setFilter()
currentFilter()
KFileFilterCombo * KFileDialog::filterWidget ( ) const
Returns
the combobox that contains the filters You need to link to libkfile to use this widget.

Definition at line 877 of file kfiledialog.cpp.

QString KFileDialog::getExistingDirectory ( const KUrl &  startDir = KUrl(),
QWidget *  parent = 0,
const QString &  caption = QString() 
)
static

Creates a modal directory-selection dialog and returns the selected directory (local only) or an empty string if none was chosen.

Parameters
startDirStarting directory or kfiledialog:/// URL. Refer to the KFileWidget documentation for more information on this parameter.
parentThe widget the dialog will be centered on initially.
captionThe name of the dialog widget.
Returns
the path to an existing local directory.
See also
KFileWidget::KFileWidget()

Definition at line 630 of file kfiledialog.cpp.

KUrl KFileDialog::getExistingDirectoryUrl ( const KUrl &  startDir = KUrl(),
QWidget *  parent = 0,
const QString &  caption = QString() 
)
static

Creates a modal directory-selection dialog and returns the selected directory or an empty string if none was chosen.

This version supports remote urls.

Parameters
startDirStarting directory or kfiledialog:/// URL. Refer to the KFileWidget documentation for more information on this parameter.
parentThe widget the dialog will be centered on initially.
captionThe name of the dialog widget.
Returns
the url to an existing directory (local or remote).
See also
KFileWidget::KFileWidget()

Definition at line 617 of file kfiledialog.cpp.

KUrl KFileDialog::getImageOpenUrl ( const KUrl &  startDir = KUrl(),
QWidget *  parent = 0,
const QString &  caption = QString() 
)
static

Creates a modal file dialog with an image previewer and returns the selected url or an empty string if none was chosen.

Parameters
startDirStarting directory or kfiledialog:/// URL. Refer to the KFileWidget documentation for more information on this parameter.
parentThe widget the dialog will be centered on initially.
captionThe name of the dialog widget.
See also
KFileWidget::KFileWidget()

Definition at line 645 of file kfiledialog.cpp.

QString KFileDialog::getOpenFileName ( const KUrl &  startDir = KUrl(),
const QString &  filter = QString(),
QWidget *  parent = 0,
const QString &  caption = QString() 
)
static

Creates a modal file dialog and return the selected filename or an empty string if none was chosen.

Note that with this method the user must select an existing filename.

Parameters
startDirStarting directory or kfiledialog:/// URL. Refer to the KFileWidget documentation for more information on this parameter.
filterA shell glob or a mimetype filter that specifies which files to display. The preferred option is to set a list of mimetype names, see setMimeFilter() for details. Otherwise you can set the text to be displayed for the each glob, and provide multiple globs, see setFilter() for details.
parentThe widget the dialog will be centered on initially.
captionThe name of the dialog widget.
See also
KFileWidget::KFileWidget()

Definition at line 464 of file kfiledialog.cpp.

QStringList KFileDialog::getOpenFileNames ( const KUrl &  startDir = KUrl(),
const QString &  filter = QString(),
QWidget *  parent = 0,
const QString &  caption = QString() 
)
static

Creates a modal file dialog and returns the selected filenames or an empty list if none was chosen.

Note that with this method the user must select an existing filename.

Parameters
startDirStarting directory or kfiledialog:/// URL. Refer to the KFileWidget documentation for more information on this parameter.
filterA shell glob or a mimetype filter that specifies which files to display. The preferred option is to set a list of mimetype names, see setMimeFilter() for details. Otherwise you can set the text to be displayed for the each glob, and provide multiple globs, see setFilter() for details.
parentThe widget the dialog will be centered on initially.
captionThe name of the dialog widget.
See also
KFileWidget::KFileWidget()

Definition at line 518 of file kfiledialog.cpp.

QString KFileDialog::getOpenFileNameWId ( const KUrl &  startDir,
const QString &  filter,
WId  parent_id,
const QString &  caption 
)
static

Use this version only if you have no QWidget available as parent widget.

This can be the case if the parent widget is a widget in another process or if the parent widget is a non-Qt widget. For example, in a GTK program.

Definition at line 497 of file kfiledialog.cpp.

KUrl KFileDialog::getOpenUrl ( const KUrl &  startDir = KUrl(),
const QString &  filter = QString(),
QWidget *  parent = 0,
const QString &  caption = QString() 
)
static

Creates a modal file dialog and returns the selected URL or an empty string if none was chosen.

Note that with this method the user must select an existing URL.

Parameters
startDirStarting directory or kfiledialog:/// URL. Refer to the KFileWidget documentation for more information on this parameter.
filterA shell glob or a mimetype filter that specifies which files to display. The preferred option is to set a list of mimetype names, see setMimeFilter() for details. Otherwise you can set the text to be displayed for the each glob, and provide multiple globs, see setFilter() for details.
parentThe widget the dialog will be centered on initially.
captionThe name of the dialog widget.
See also
KFileWidget::KFileWidget()

Definition at line 552 of file kfiledialog.cpp.

KUrl::List KFileDialog::getOpenUrls ( const KUrl &  startDir = KUrl(),
const QString &  filter = QString(),
QWidget *  parent = 0,
const QString &  caption = QString() 
)
static

Creates a modal file dialog and returns the selected URLs or an empty list if none was chosen.

Note that with this method the user must select an existing filename.

Parameters
startDirStarting directory or kfiledialog:/// URL. Refer to the KFileWidget documentation for more information on this parameter.
filterA shell glob or a mimetype filter that specifies which files to display. The preferred option is to set a list of mimetype names, see setMimeFilter() for details. Otherwise you can set the text to be displayed for the each glob, and provide multiple globs, see setFilter() for details.
parentThe widget the dialog will be centered on initially.
captionThe name of the dialog widget.
See also
KFileWidget::KFileWidget()

Definition at line 578 of file kfiledialog.cpp.

QString KFileDialog::getSaveFileName ( const KUrl &  startDir = KUrl(),
const QString &  filter = QString(),
QWidget *  parent = 0,
const QString &  caption = QString() 
)
static

Creates a modal file dialog and returns the selected filename or an empty string if none was chosen.

Note that with this method the user need not select an existing filename.

Parameters
startDirStarting directory or kfiledialog:/// URL. Refer to the KFileWidget documentation for more information on this parameter.
filterA shell glob or a mimetype filter that specifies which files to display. The preferred option is to set a list of mimetype names, see setMimeFilter() for details. Otherwise you can set the text to be displayed for the each glob, and provide multiple globs, see setFilter() for details.
parentThe widget the dialog will be centered on initially.
captionThe name of the dialog widget.
See also
KFileWidget::KFileWidget()

Definition at line 701 of file kfiledialog.cpp.

QString KFileDialog::getSaveFileName ( const KUrl &  startDir,
const QString &  filter,
QWidget *  parent,
const QString &  caption,
Options  options 
)
static

Creates a modal file dialog and returns the selected filename or an empty string if none was chosen.

Note that with this method the user need not select an existing filename.

Parameters
startDirStarting directory or kfiledialog:/// URL. Refer to the KFileWidget documentation for more information on this parameter.
filterA shell glob or a mimetype filter that specifies which files to display. The preferred option is to set a list of mimetype names, see setMimeFilter() for details. Otherwise you can set the text to be displayed for the each glob, and provide multiple globs, see setFilter() for details.
parentThe widget the dialog will be centered on initially.
captionThe name of the dialog widget.
optionsDialog options.
See also
KFileWidget::KFileWidget()
Since
4.4

Definition at line 710 of file kfiledialog.cpp.

QString KFileDialog::getSaveFileNameWId ( const KUrl &  startDir,
const QString &  filter,
WId  parent_id,
const QString &  caption 
)
static

This function accepts the window id of the parent window, instead of QWidget*.

It should be used only when necessary.

Definition at line 768 of file kfiledialog.cpp.

QString KFileDialog::getSaveFileNameWId ( const KUrl &  startDir,
const QString &  filter,
WId  parent_id,
const QString &  caption,
Options  options 
)
static

This function accepts the window id of the parent window, instead of QWidget*.

It should be used only when necessary.

Since
4.4

Definition at line 777 of file kfiledialog.cpp.

KUrl KFileDialog::getSaveUrl ( const KUrl &  startDir = KUrl(),
const QString &  filter = QString(),
QWidget *  parent = 0,
const QString &  caption = QString() 
)
static

Creates a modal file dialog and returns the selected filename or an empty string if none was chosen.

Note that with this method the user need not select an existing filename.

Parameters
startDirStarting directory or kfiledialog:/// URL. Refer to the KFileWidget documentation for more information on this parameter.
filterA shell glob or a mimetype filter that specifies which files to display. The preferred option is to set a list of mimetype names, see setMimeFilter() for details. Otherwise you can set the text to be displayed for the each glob, and provide multiple globs, see setFilter() for details.
parentThe widget the dialog will be centered on initially.
captionThe name of the dialog widget.
See also
KFileWidget::KFileWidget()

Definition at line 805 of file kfiledialog.cpp.

KUrl KFileDialog::getSaveUrl ( const KUrl &  startDir,
const QString &  filter,
QWidget *  parent,
const QString &  caption,
Options  options 
)
static

Creates a modal file dialog and returns the selected filename or an empty string if none was chosen.

Note that with this method the user need not select an existing filename.

Parameters
startDirStarting directory or kfiledialog:/// URL. Refer to the KFileWidget documentation for more information on this parameter.
filterA shell glob or a mimetype filter that specifies which files to display. The preferred option is to set a list of mimetype names, see setMimeFilter() for details. Otherwise you can set the text to be displayed for the each glob, and provide multiple globs, see setFilter() for details.
parentThe widget the dialog will be centered on initially.
captionThe name of the dialog widget.
optionsDialog options.
See also
KFileWidget::KFileWidget()
Since
4.4

Definition at line 813 of file kfiledialog.cpp.

KUrl KFileDialog::getStartUrl ( const KUrl &  startDir,
QString &  recentDirClass 
)
static

This method implements the logic to determine the user's default directory to be listed.

E.g. the documents directory, home directory or a recently used directory.

Parameters
startDirStarting directory or kfiledialog:/// URL. Refer to the KFileWidget documentation for more information on this parameter.
recentDirClassIf the kfiledialog:/// syntax is used, this will return the string to be passed to KRecentDirs::dir() and KRecentDirs::add().
Returns
The URL that should be listed by default (e.g. by KFileDialog or KDirSelectDialog).
See also
KFileWidget::KFileWidget()
KFileWidget::getStartUrl( const KUrl& startDir, QString& recentDirClass );

Definition at line 941 of file kfiledialog.cpp.

void KFileDialog::hideEvent ( QHideEvent *  event)
protectedvirtual

Reimplemented for saving the dialog geometry.

Reimplemented from QWidget.

Definition at line 930 of file kfiledialog.cpp.

bool KFileDialog::keepsLocation ( ) const
Returns
whether the contents of the location edit are kept when changing directories.

Definition at line 894 of file kfiledialog.cpp.

void KFileDialog::keyPressEvent ( QKeyEvent *  e)
protectedvirtual

Reimplemented to animate the cancel button.

Reimplemented from QDialog.

Definition at line 916 of file kfiledialog.cpp.

KUrlComboBox * KFileDialog::locationEdit ( ) const
Returns
the combobox used to type the filename or full location of the file. You need to link to libkfile to use this widget.

Definition at line 872 of file kfiledialog.cpp.

KFile::Modes KFileDialog::mode ( ) const

Returns the mode of the filedialog.

See also
setMode()

Definition at line 855 of file kfiledialog.cpp.

KPushButton * KFileDialog::okButton ( ) const
Returns
a pointer to the OK-Button in the filedialog. You may use it e.g. to set a custom text to it.

Definition at line 862 of file kfiledialog.cpp.

KFileDialog::OperationMode KFileDialog::operationMode ( ) const
Returns
the current operation mode, Opening, Saving or Other. Default is Other.
See also
operationMode
KFileDialog::OperationMode

Definition at line 909 of file kfiledialog.cpp.

QString KFileDialog::selectedFile ( ) const

Returns the full path of the selected file in the local filesystem.

(Local files only)

Definition at line 680 of file kfiledialog.cpp.

QStringList KFileDialog::selectedFiles ( ) const

Returns a list of all selected local files.

Definition at line 687 of file kfiledialog.cpp.

KUrl KFileDialog::selectedUrl ( ) const
Returns
The selected fully qualified filename.

Definition at line 666 of file kfiledialog.cpp.

KUrl::List KFileDialog::selectedUrls ( ) const
Returns
The list of selected URLs.

Definition at line 673 of file kfiledialog.cpp.

void KFileDialog::selectionChanged ( )
signal

Emitted when the user hilights one or more files in multiselection mode.

Note: fileHighlighted() or fileSelected() are not emitted in multiselection mode. You may use selectedItems() to ask for the current highlighted items.

See also
fileSelected
void KFileDialog::setConfirmOverwrite ( bool  enable)

Sets whether the dialog should ask before accepting the selected file when KFileDialog::OperationMode is set to Saving.

In this case a KMessageBox appears for confirmation.

Parameters
enableSet this to true to enable checking.
Since
4.2

Definition at line 610 of file kfiledialog.cpp.

void KFileDialog::setFilter ( const QString &  filter)

Sets the filter to be used to filter.

The filter can be either set as a space-separated list of mimetypes, which is recommended, or as a list of shell globs separated by '\n'.

If the filter contains an unescaped '/', a mimetype filter is assumed. If you would like a '/' visible in your filter it can be escaped with a '\'. You can specify multiple mimetypes like this (separated with space):

kfile->setFilter( "image/png text/html text/plain" );

When showing the filter to the user, the mimetypes will be automatically translated into their description like `PNG image'. Multiple mimetypes will be automatically summarized to a filter item `All supported files'. To add a filter item for all files matching '*', add all/allfiles as mimetype.

If the filter contains no unescaped '/', it is assumed that the filter contains conventional shell globs. Several filter items to select from can be separated by '\n'. Every filter entry is defined through namefilter|text to display. If no '|' is found in the expression, just the namefilter is shown. Examples:

kfile->setFilter("*.cpp|C++ Source Files\n*.h|Header files");
kfile->setFilter("*.cpp");
kfile->setFilter("*.cpp|Sources (*.cpp)");
kfile->setFilter("*.cpp|" + i18n("Sources (*.cpp)"));
kfile->setFilter("*.cpp *.cc *.C|C++ Source Files\n*.h *.H|Header files");

Note: The text to display is not parsed in any way. So, if you want to show the suffix to select by a specific filter, you must repeat it.

For better consistency across applications, it is recommended to use a mimetype filter.

See also
filterChanged
setMimeFilter

Definition at line 332 of file kfiledialog.cpp.

void KFileDialog::setInlinePreviewShown ( bool  show)

Forces the inline previews to be shown or hidden, depending on show.

Parameters
showWhether to show inline previews or not.
Since
4.2

Definition at line 396 of file kfiledialog.cpp.

void KFileDialog::setKeepLocation ( bool  keep)

Sets whether the filename/url should be kept when changing directories.

This is for example useful when having a predefined filename where the full path for that file is searched.

This is implicitly set when operationMode() is KFileDialog::Saving

getSaveFileName() and getSaveUrl() set this to true by default, so that you can type in the filename and change the directory without having to type the name again.

Definition at line 887 of file kfiledialog.cpp.

void KFileDialog::setLocationLabel ( const QString &  text)

Sets the text to be displayed in front of the selection.

The default is "Location". Most useful if you want to make clear what the location is used for.

Definition at line 325 of file kfiledialog.cpp.

void KFileDialog::setMimeFilter ( const QStringList &  types,
const QString &  defaultType = QString() 
)

Sets the filter up to specify the output type.

Parameters
typesa list of mimetypes that can be used as output format
defaultTypethe default mimetype to use as output format, if any. If defaultType is set, it will be set as the current item. Otherwise, a first item showing all the mimetypes will be created. Typically, defaultType should be empty for loading and set for saving.

Do not use in conjunction with setFilter()

Definition at line 348 of file kfiledialog.cpp.

void KFileDialog::setMode ( KFile::Modes  m)

Sets the mode of the dialog.

The mode is defined as (in kfile.h):

enum Mode {
File = 1,
Directory = 2,
Files = 4,
ExistingOnly = 8,
LocalOnly = 16
};

You can OR the values, e.g.

KFile::Modes mode = KFile::Files |
KFile::ExistingOnly |
KFile::LocalOnly );
setMode( mode );

Definition at line 847 of file kfiledialog.cpp.

void KFileDialog::setOperationMode ( KFileDialog::OperationMode  mode)

Sets the operational mode of the filedialog to Saving, Opening or Other.

This will set some flags that are specific to loading or saving files. E.g. setKeepLocation() makes mostly sense for a save-as dialog. So setOperationMode( KFileDialog::Saving ); sets setKeepLocation for example.

The mode Saving, together with a default filter set via setMimeFilter() will make the filter combobox read-only.

The default mode is Opening.

Call this method right after instantiating KFileDialog.

See also
operationMode
KFileDialog::OperationMode

Definition at line 901 of file kfiledialog.cpp.

void KFileDialog::setPreviewWidget ( KPreviewWidgetBase *  w)

Adds a preview widget and enters the preview mode.

In this mode the dialog is split and the right part contains your preview widget.

Ownership is transferred to KFileDialog. You need to create the preview-widget with "new", i.e. on the heap.

Parameters
wThe widget to be used for the preview.

Definition at line 389 of file kfiledialog.cpp.

void KFileDialog::setSelection ( const QString &  name)

Sets the file name to preselect to name.

This takes absolute URLs and relative file names.

Definition at line 454 of file kfiledialog.cpp.

void KFileDialog::setStartDir ( const KUrl &  directory)
static

Used by KDirSelectDialog to share the dialog's start directory.

Definition at line 947 of file kfiledialog.cpp.

void KFileDialog::setUrl ( const KUrl &  url,
bool  clearforward = true 
)

Sets the directory to view.

Parameters
urlURL to show.
clearforwardIndicates whether the forward queue should be cleared.

Definition at line 444 of file kfiledialog.cpp.

QSize KFileDialog::sizeHint ( void  ) const
virtual
See also
QWidget::sizeHint()

Reimplemented from QDialog.

Definition at line 405 of file kfiledialog.cpp.

void KFileDialog::slotCancel ( )
protectedvirtualslot

Definition at line 436 of file kfiledialog.cpp.

void KFileDialog::slotOk ( )
protectedvirtualslot

Definition at line 416 of file kfiledialog.cpp.

KToolBar * KFileDialog::toolBar ( ) const

Returns a pointer to the toolbar.

You can use this to insert custom items into it, e.g.:

yourAction = new KAction( i18n("Your Action"), 0,
this, SLOT( yourSlot() ),
this, "action name" );
yourAction->plug( kfileDialog->toolBar() );

Definition at line 954 of file kfiledialog.cpp.


The documentation for this class was generated from the following files:
  • kfiledialog.h
  • kfiledialog.cpp
This file is part of the KDE documentation.
Documentation copyright © 1996-2020 The KDE developers.
Generated on Mon Jun 22 2020 13:24:54 by doxygen 1.8.7 written by Dimitri van Heesch, © 1997-2006

KDE's Doxygen guidelines are available online.

KIO

Skip menu "KIO"
  • Main Page
  • Namespace List
  • Namespace Members
  • Alphabetical List
  • Class List
  • Class Hierarchy
  • Class Members
  • File List
  • File Members
  • Related Pages

kdelibs API Reference

Skip menu "kdelibs API Reference"
  • DNSSD
  • Interfaces
  •   KHexEdit
  •   KMediaPlayer
  •   KSpeech
  •   KTextEditor
  • kconf_update
  • KDE3Support
  •   KUnitTest
  • KDECore
  • KDED
  • KDEsu
  • KDEUI
  • KDEWebKit
  • KDocTools
  • KFile
  • KHTML
  • KImgIO
  • KInit
  • kio
  • KIOSlave
  • KJS
  •   KJS-API
  •   WTF
  • kjsembed
  • KNewStuff
  • KParts
  • KPty
  • Kross
  • KUnitConversion
  • KUtils
  • Nepomuk
  • Plasma
  • Solid
  • Sonnet
  • ThreadWeaver

Search



Report problems with this website to our bug tracking system.
Contact the specific authors with questions and comments about the page contents.

KDE® and the K Desktop Environment® logo are registered trademarks of KDE e.V. | Legal