diff options
Diffstat (limited to 'kio/kfile/kfiledialog.h')
| -rw-r--r-- | kio/kfile/kfiledialog.h | 989 |
1 files changed, 0 insertions, 989 deletions
diff --git a/kio/kfile/kfiledialog.h b/kio/kfile/kfiledialog.h deleted file mode 100644 index 2f986d351..000000000 --- a/kio/kfile/kfiledialog.h +++ /dev/null @@ -1,989 +0,0 @@ -// -*- c++ -*- -/* This file is part of the KDE libraries - Copyright (C) 1997, 1998 Richard Moore <rich@kde.org> - 1998 Stephan Kulow <coolo@kde.org> - 1998 Daniel Grana <grana@ie.iwi.unibe.ch> - 2000,2001 Carsten Pfeiffer <pfeiffer@kde.org> - 2001 Frerich Raabe <raabe@kde.org> - - This library is free software; you can redistribute it and/or - modify it under the terms of the GNU Library General Public - License as published by the Free Software Foundation; either - version 2 of the License, or (at your option) any later version. - - This library is distributed in the hope that it will be useful, - but WITHOUT ANY WARRANTY; without even the implied warranty of - MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU - Library General Public License for more details. - - You should have received a copy of the GNU Library General Public License - along with this library; see the file COPYING.LIB. If not, write to - the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, - Boston, MA 02110-1301, USA. -*/ - -#ifndef __KFILEDIALOG_H__ -#define __KFILEDIALOG_H__ - -#include <tqstring.h> - -#include <kdialogbase.h> -#include <kfile.h> -#include <kurl.h> -#include <kmimetype.h> -#include <kio/jobclasses.h> - -class TQCheckBox; -class TQHBoxLayout; -class TQGridLayout; -class TQLabel; -class TQPopupMenu; -class TQVBoxLayout; - -class KActionCollection; -class KDirOperator; -class KURLBar; -class KURLComboBox; -class KFileFilterCombo; -class KFileView; -class KFileItem; -class KPushButton; -class KToolBar; -class KPreviewWidgetBase; - -struct KFileDialogPrivate; - -/** - * Provides a user (and developer) friendly way to - * select files and directories. - * - * The widget can be used as a drop in replacement for the - * TQFileDialog 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 customise it - * by subclassing. It uses geometry management to ensure that subclasses - * can easily add children that will be incorporated into the layout. - * - * \image html kfiledialog.png "KDE File Dialog" - * - * @short A file selection dialog. - * - * @author Richard J. Moore <rich@kde.org>, Carsten Pfeiffer <pfeiffer@kde.org> - */ -class TDEIO_EXPORT KFileDialog : public KDialogBase -{ - Q_OBJECT - -public: - - /** - * Defines some default behavior of the filedialog. - * E.g. in mode @p Opening and @p Saving, the selected files/urls will - * be added to the "recent documents" list. The Saving mode also implies - * setKeepLocation() being set. - * - * @p Other means that no default actions are performed. - * - * @see setOperationMode - * @see operationMode - */ - enum OperationMode { Other = 0, Opening, Saving }; - - /** - * Constructs a file dialog. - * - * @param startDir This can either be - * @li The URL of the directory to start in. - * @li TQString::null to start in the current working - * directory, or the last directory where a file has been - * selected. - * @li ':<keyword>' to start in the directory last used - * by a filedialog in the same application that specified - * the same keyword. - * @li '::<keyword>' to start in the directory last used - * by a filedialog in any application that specified the - * same keyword. - * - * @param filter A shell glob or a mime-type-filter that specifies - * which files to display. - * @param parent The parent widget of this dialog - * @param name The name of this object - * @param modal Whether to create a modal dialog or not - * See setFilter() for details on how to use this argument. - * - */ - KFileDialog(const TQString& startDir, const TQString& filter, - TQWidget *parent, const char *name, - bool modal); - - /** - * Constructs a file dialog. - * - * The parameters here are identical to the first constructor except - * for the addition of a TQWidget parameter. - * - * Historical note: The original version of KFileDialog did not have this extra - * parameter. It was added later, and, in order to maintain binary compatibility, - * it was placed in a new constructor instead of added to the original one. - * - * @param startDir This can either be - * @li The URL of the directory to start in. - * @li TQString::null to start in the current working - * directory, or the last directory where a file has been - * selected. - * @li ':<keyword>' to start in the directory last used - * by a filedialog in the same application that specified - * the same keyword. - * @li '::<keyword>' to start in the directory last used - * by a filedialog in any application that specified the - * same keyword. - * - * @param filter A shell glob or a mime-type-filter that specifies - * which files to display. - * See setFilter() for details on how to use this argument. - * - * @param widget A 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. - * @param parent The parent widget of this dialog - * @param name The name of this object - * @param modal Whether to create a modal dialog or not - * @since 3.1 - */ - KFileDialog(const TQString& startDir, const TQString& filter, - TQWidget *parent, const char *name, - bool modal, TQWidget* widget); - - - /** - * Destructs the file dialog. - */ - ~KFileDialog(); - - /** - * @returns The selected fully qualified filename. - */ - KURL selectedURL() const; - - /** - * @returns The list of selected URLs. - */ - KURL::List selectedURLs() const; - - /** - * @returns the currently shown directory. - */ - KURL baseURL() const; - - /** - * Returns the full path of the selected file in the local filesystem. - * (Local files only) - */ - TQString selectedFile() const; - - /** - * Returns a list of all selected local files. - */ - TQStringList selectedFiles() const; - - /** - * Sets the directory to view. - * - * @param url URL to show. - * @param clearforward Indicates whether the forward queue - * should be cleared. - */ - void setURL(const KURL &url, bool clearforward = true); - - /** - * Sets the file name to preselect to @p name - * - * This takes absolute URLs and relative file names. - */ - void setSelection(const TQString& name); - - /** - * Sets the operational mode of the filedialog to @p Saving, @p Opening - * or @p 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 @p Saving, together with a default filter set via - * setMimeFilter() will make the filter combobox read-only. - * - * The default mode is @p Opening. - * - * Call this method right after instantiating KFileDialog. - * - * @see operationMode - * @see KFileDialog::OperationMode - */ - void setOperationMode( KFileDialog::OperationMode ); - - /** - * @returns the current operation mode, Opening, Saving or Other. Default - * is Other. - * - * @see operationMode - * @see KFileDialog::OperationMode - */ - OperationMode operationMode() const; - - /** - * 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. - */ - void setKeepLocation( bool keep ); - - /** - * @returns whether the contents of the location edit are kept when - * changing directories. - */ - bool keepsLocation() const; - - /** - * Sets the filter to be used to @p filter. - * - * You can set more - * filters for the user to select separated by '\n'. Every - * filter entry is defined through namefilter|text to diplay. - * If no | is found in the expression, just the namefilter is - * shown. Examples: - * - * \code - * 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"); - * \endcode - * - * 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. - * - * 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): - * - * \code - * kfile->setFilter( "image/png text/html text/plain" ); - * kfile->setFilter( "*.cue|CUE\\/BIN Files (*.cue)" ); - * \endcode - * - * @see filterChanged - * @see setMimeFilter - */ - void setFilter(const TQString& filter); - - /** - * Returns the current filter as entered by the user or one of the - * predefined set via setFilter(). - * - * @see setFilter() - * @see filterChanged() - */ - TQString currentFilter() const; - - /** - * Sets the filter up to specify the output type. - * - * @param label the label to use instead of "Filter:" - * @param types a list of mimetypes that can be used as output format - * @param defaultType the default mimetype to use as output format. - * - * Do not use in conjunction with setFilter() - * @deprecated - */ - void setFilterMimeType(const TQString &label, const KMimeType::List &types, const KMimeType::Ptr &defaultType) KDE_DEPRECATED; - - /** - * Returns the mimetype for the desired output format. - * - * This is only valid if setFilterMimeType() has been called - * previously. - * - * @see setFilterMimeType() - */ - KMimeType::Ptr currentFilterMimeType(); - - /** - * Sets the filter up to specify the output type. - * - * @param types a list of mimetypes that can be used as output format - * @param defaultType the default mimetype to use as output format, if any. - * If @p defaultType is set, it will be set as the current item. - * Otherwise, a first item showing all the mimetypes will be created. - * Typically, @p defaultType should be empty for loading and set for saving. - * - * Do not use in conjunction with setFilter() - */ - void setMimeFilter( const TQStringList& types, - const TQString& defaultType = TQString::null ); - - /** - * The mimetype for the desired output format. - * - * This is only valid if setMimeFilter() has been called - * previously. - * - * @see setMimeFilter() - */ - TQString currentMimeFilter() const; - - /** - * Clears any mime- or namefilter. Does not reload the directory. - */ - void clearFilter(); - - /** - * @deprecated - * Add a preview widget and enter the preview mode. - * - * In this mode - * the dialog is split and the right part contains your widget. - * This widget has to inherit TQWidget and it has to implement - * a slot showPreview(const KURL &); which is called - * every time the file changes. You may want to look at - * koffice/lib/kofficecore/koFilterManager.cc for some hints :) - * - * Ownership is transferred to KFileDialog. You need to create the - * preview-widget with "new", i.e. on the heap. - */ - void setPreviewWidget(const TQWidget *w) KDE_DEPRECATED; - - /** - * 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. - * - * @param w The widget to be used for the preview. - */ - void setPreviewWidget(const KPreviewWidgetBase *w); - - /** - * 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. - * - * @param startDir This can either be - * @li The URL of the directory to start in. - * @li TQString::null to start in the current working - * directory, or the last directory where a file has been - * selected. - * @li ':<keyword>' to start in the directory last used - * by a filedialog in the same application that specified - * the same keyword. - * @li '::<keyword>' to start in the directory last used - * by a filedialog in any application that specified the - * same keyword. - * @param filter This is a space separated list of shell globs. - * You can set the text to be displayed for the glob, and - * provide multiple globs. See setFilter() for details on - * how to do this... - * @param parent The widget the dialog will be centered on initially. - * @param caption The name of the dialog widget. - */ - static TQString getOpenFileName(const TQString& startDir= TQString::null, - const TQString& filter= TQString::null, - TQWidget *parent= 0, - const TQString& caption = TQString::null); - - - /** - * Use this version only if you have no TQWidget 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. - * - * @since 3.4 - */ - static TQString getOpenFileNameWId(const TQString& startDir, - const TQString& filter, - WId parent_id, const TQString& caption); - - /** - * 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. - * - * @param startDir This can either be - * @li The URL of the directory to start in. - * @li TQString::null to start in the current working - * directory, or the last directory where a file has been - * selected. - * @li ':<keyword>' to start in the directory last used - * by a filedialog in the same application that specified - * the same keyword. - * @li '::<keyword>' to start in the directory last used - * by a filedialog in any application that specified the - * same keyword. - * @param filter This is a space separated list of shell globs. - * You can set the text to be displayed for the glob, and - * provide multiple globs. See setFilter() for details on - * how to do this... - * @param parent The widget the dialog will be centered on initially. - * @param caption The name of the dialog widget. - */ - static TQStringList getOpenFileNames(const TQString& startDir= TQString::null, - const TQString& filter= TQString::null, - TQWidget *parent = 0, - const TQString& caption= TQString::null); - - - - /** - * 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. - * - * @param startDir This can either be - * @li The URL of the directory to start in. - * @li TQString::null to start in the current working - * directory, or the last directory where a file has been - * selected. - * @li ':<keyword>' to start in the directory last used - * by a filedialog in the same application that specified - * the same keyword. - * @li '::<keyword>' to start in the directory last used - * by a filedialog in any application that specified the - * same keyword. - * @param filter This is a space separated list of shell globs. - * You can set the text to be displayed for the glob, and - * provide multiple globs. See setFilter() for details on - * how to do this... - * @param parent The widget the dialog will be centered on initially. - * @param caption The name of the dialog widget. - */ - static KURL getOpenURL(const TQString& startDir = TQString::null, - const TQString& filter= TQString::null, - TQWidget *parent= 0, - const TQString& caption = TQString::null); - - - - /** - * 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. - * - * @param startDir This can either be - * @li The URL of the directory to start in. - * @li TQString::null to start in the current working - * directory, or the last directory where a file has been - * selected. - * @li ':<keyword>' to start in the directory last used - * by a filedialog in the same application that specified - * the same keyword. - * @li '::<keyword>' to start in the directory last used - * by a filedialog in any application that specified the - * same keyword. - * @param filter This is a space separated list of shell globs. - * You can set the text to be displayed for the glob, and - * provide multiple globs. See setFilter() for details on - * how to do this... - * @param parent The widget the dialog will be centered on initially. - * @param caption The name of the dialog widget. - */ - static KURL::List getOpenURLs(const TQString& startDir= TQString::null, - const TQString& filter= TQString::null, - TQWidget *parent = 0, - const TQString& caption= TQString::null); - - - - /** - * 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. - * - * @param startDir This can either be - * @li The URL of the directory to start in. - * @li a relative path or a filename determining the - * directory to start in and the file to be selected. - * @li TQString::null to start in the current working - * directory, or the last directory where a file has been - * selected. - * @li ':<keyword>' to start in the directory last used - * by a filedialog in the same application that specified - * the same keyword. - * @li '::<keyword>' to start in the directory last used - * by a filedialog in any application that specified the - * same keyword. - * @param filter This is a space separated list of shell globs. - * You can set the text to be displayed for the glob, and - * provide multiple globs. See setFilter() for details on - * how to do this... - * @param parent The widget the dialog will be centered on initially. - * @param caption The name of the dialog widget. - */ - static TQString getSaveFileName(const TQString& startDir= TQString::null, - const TQString& filter= TQString::null, - TQWidget *parent= 0, - const TQString& caption = TQString::null); - - - /** - * This function accepts the window id of the parent window, instead - * of TQWidget*. It should be used only when necessary. - * @since 3.4 - */ - static TQString getSaveFileNameWId(const TQString& dir, const TQString& filter, - WId parent_id, - const TQString& caption); - - /** - * 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. - * - * @param startDir This can either be - * @li The URL of the directory to start in. - * @li a relative path or a filename determining the - * directory to start in and the file to be selected. - * @li TQString::null to start in the current working - * directory, or the last directory where a file has been - * selected. - * @li ':<keyword>' to start in the directory last used - * by a filedialog in the same application that specified - * the same keyword. - * @li '::<keyword>' to start in the directory last used - * by a filedialog in any application that specified the - * same keyword. - * @param filter This is a space separated list of shell globs. - * You can set the text to be displayed for the glob, and - * provide multiple globs. See setFilter() for details on - * how to do this... - * @param parent The widget the dialog will be centered on initially. - * @param caption The name of the dialog widget. - */ - static KURL getSaveURL(const TQString& startDir= TQString::null, - const TQString& filter= TQString::null, - TQWidget *parent= 0, - const TQString& caption = TQString::null); - - - /** - * Creates a modal file dialog and returns the selected - * directory or an empty string if none was chosen. - * - * @param startDir This can either be - * @li The URL of the directory to start in. - * @li TQString::null to start in the current working - * directory, or the last directory where a file has been - * selected. - * @li ':<keyword>' to start in the directory last used - * by a filedialog in the same application that specified - * the same keyword. - * @li '::<keyword>' to start in the directory last used - * by a filedialog in any application that specified the - * same keyword. - * @param parent The widget the dialog will be centered on initially. - * @param caption The name of the dialog widget. - */ - static TQString getExistingDirectory(const TQString & startDir = TQString::null, - TQWidget * parent = 0, - const TQString& caption= TQString::null); - - /** - * Creates a modal file dialog and returns the selected - * directory or an empty string if none was chosen. - * - * Contrary to getExistingDirectory(), this method allows the - * selection of a remote directory. - * - * @param startDir This can either be - * @li The URL of the directory to start in. - * @li TQString::null to start in the current working - * directory, or the last directory where a file has been - * selected. - * @li ':<keyword>' to start in the directory last used - * by a filedialog in the same application that specified - * the same keyword. - * @li '::<keyword>' to start in the directory last used - * by a filedialog in any application that specified the - * same keyword. - * @param parent The widget the dialog will be centered on initially. - * @param caption The name of the dialog widget. - * @since 3.1 - */ - static KURL getExistingURL(const TQString & startDir = TQString::null, - TQWidget * parent = 0, - const TQString& caption= TQString::null); - /** - * Creates a modal file dialog with an image previewer and returns the - * selected url or an empty string if none was chosen. - * - * @param startDir This can either be - * @li The URL of the directory to start in. - * @li TQString::null to start in the current working - * directory, or the last directory where a file has been - * selected. - * @li ':<keyword>' to start in the directory last used - * by a filedialog in the same application that specified - * the same keyword. - * @li '::<keyword>' to start in the directory last used - * by a filedialog in any application that specified the - * same keyword. - * @param parent The widget the dialog will be centered on initially. - * @param caption The name of the dialog widget. - */ - static KURL getImageOpenURL( const TQString& startDir = TQString::null, - TQWidget *parent = 0, - const TQString& caption = TQString::null ); - virtual void show(); - - /** - * Convenient overload of the other setMode(unsigned int) method. - */ - void setMode( KFile::Mode m ); - - /** - * Sets the mode of the dialog. - * - * The mode is defined as (in kfile.h): - * \code - * enum Mode { - * File = 1, - * Directory = 2, - * Files = 4, - * ExistingOnly = 8, - * LocalOnly = 16 - * }; - * \endcode - * You can OR the values, e.g. - * \code - * KFile::Mode mode = static_cast<KFile::Mode>( KFile::Files | - * KFile::ExistingOnly | - * KFile::LocalOnly ); - * setMode( mode ); - * \endcode - */ - void setMode( unsigned int m ); - - /** - * Returns the mode of the filedialog. - * @see setMode() - */ - KFile::Mode mode() const; - - /** - * 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. - */ - void setLocationLabel(const TQString& text); - - /** - * Returns a pointer to the toolbar. - * - * You can use this to insert custom - * items into it, e.g.: - * \code - * yourAction = new KAction( i18n("Your Action"), 0, - * this, TQT_SLOT( yourSlot() ), - * this, "action name" ); - * yourAction->plug( kfileDialog->toolBar() ); - * \endcode - */ - KToolBar *toolBar() const { return toolbar; } - - /** - * @returns a pointer to the OK-Button in the filedialog. You may use it - * e.g. to set a custom text to it. - */ - KPushButton *okButton() const; - - /** - * @returns a pointer to the Cancel-Button in the filedialog. You may use - * it e.g. to set a custom text to it. - */ - KPushButton *cancelButton() const; - - /** - * @returns the KURLBar object used as the "speed bar". You can add custom - * entries to it like that: - * \code - * KURLBar *urlBar = fileDialog->speedBar(); - * if ( urlBar ) - * urlBar->insertDynamicItem( someURL, i18n("The URL's description") ); - * \endcode - * - * Note that this method may return a null-pointer if the user configured - * to not use the speed-bar. - * @see KURLBar - * @see KURLBar::insertDynamicItem - * @since 3.2 - */ - KURLBar *speedBar(); - - /** - * @returns a pointer to the action collection, holding all the used - * KActions. - */ - KActionCollection *actionCollection() const; - - /** - * @returns the index of the path combobox so when inserting widgets into - * the dialog (e.g. subclasses) they can do so without hardcoding in an index - */ - int pathComboIndex(); - - /** - * This method implements the logic to determine the user's default directory - * to be listed. E.g. the documents direcory, home directory or a recently - * used directory. - * @param startDir A url/directory, to be used. May use the ':' and '::' syntax - * as documented in the KFileDialog() constructor. - * @param recentDirClass If the ':' or '::' syntax is used, recentDirClass - * will contain the string to be used later for KRecentDir::dir() - * @return The URL that should be listed by default (e.g. by KFileDialog or - * KDirSelectDialog). - * @since 3.1 - */ - static KURL getStartURL( const TQString& startDir, TQString& recentDirClass ); - - /** - * @internal - * Used by KDirSelectDialog to share the dialog's start directory. - */ - static void setStartDir( const KURL& directory ); - -signals: - /** - * 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 KDialogBase - * and call selectedFile(), selectedFiles(), - * selectedURL() or selectedURLs(). - */ - void fileSelected(const TQString&); - - /** - * Emitted when the user highlights a file. - */ - void fileHighlighted(const TQString&); - - /** - * Emitted when the user hilights one or more files in multiselection mode. - * - * Note: fileHighlighted() or fileSelected() are @em not - * emitted in multiselection mode. You may use selectedItems() to - * ask for the current highlighted items. - * @see fileSelected - */ - void selectionChanged(); - - /** - * Emitted when the filter changed, i.e. the user entered an own filter - * or chose one of the predefined set via setFilter(). - * - * @param filter contains the new filter (only the extension part, - * not the explanation), i.e. "*.cpp" or "*.cpp *.cc". - * - * @see setFilter() - * @see currentFilter() - */ - void filterChanged( const TQString& filter ); - -protected: - KToolBar *toolbar; - - static KURL *lastDirectory; - - KURLComboBox *locationEdit; - - KFileFilterCombo *filterWidget; - - /** - * Reimplemented to animate the cancel button. - */ - virtual void keyPressEvent( TQKeyEvent *e ); - - /** - * Perform basic initialization tasks. Called by constructors. - * @since 3.1 - */ - void init(const TQString& startDir, const TQString& filter, TQWidget* widget); - - /** - * rebuild geometry management. - * - */ - virtual void initGUI(); - - /** - * called when an item is highlighted/selected in multiselection mode. - * handles setting the locationEdit. - */ - void multiSelectionChanged(); - - /** - * Reads configuration and applies it (size, recent directories, ...) - */ - virtual void readConfig( TDEConfig *, const TQString& group = TQString::null ); - - /** - * Saves the current configuration - */ - virtual void writeConfig( TDEConfig *, const TQString& group = TQString::null ); - - /** - * Reads the recent used files and inserts them into the location combobox - */ - virtual void readRecentFiles( TDEConfig * ); - - /** - * Saves the entries from the location combobox. - */ - virtual void saveRecentFiles( TDEConfig * ); - - /** - * Parses the string "line" for files. If line doesn't contain any ", the - * whole line will be interpreted as one file. If the number of " is odd, - * an empty list will be returned. Otherwise, all items enclosed in " " - * will be returned as correct urls. - */ - KURL::List tokenize(const TQString& line) const; - - /** - * Returns the absolute version of the URL specified in locationEdit. - * @since 3.2 - */ - KURL getCompleteURL(const TQString&); - - /** - * Returns the filename extension associated with the currentFilter(). - * TQString::null is returned if an extension is not available or if - * operationMode() != Saving. - * @since 3.2 - */ - TQString currentFilterExtension(); - - /** - * Updates the currentFilterExtension and the availability of the - * Automatically Select Extension Checkbox (visible if operationMode() - * == Saving and enabled if an extension _will_ be associated with the - * currentFilter(), _after_ this call). You should call this after - * filterWidget->setCurrentItem(). - * @since 3.2 - */ - void updateAutoSelectExtension(); - - -protected slots: - void urlEntered( const KURL& ); - void enterURL( const KURL& url ); - void enterURL( const TQString& url ); - void locationActivated( const TQString& url ); - - /** - * @deprecated, - */ - // ### remove in KDE4 - void toolbarCallback(int); - /** - * @deprecated - */ - // ### remove in KDE4 - void pathComboChanged( const TQString& ); - /** - * @deprecated - */ - // ### remove in KDE4 - void dirCompletion( const TQString& ); - - void slotFilterChanged(); - void fileHighlighted(const KFileItem *i); - void fileSelected(const KFileItem *i); - void slotStatResult(TDEIO::Job* job); - void slotLoadingFinished(); - - void fileCompletion( const TQString& ); - /** - * @since 3.1 - */ - void toggleSpeedbar( bool ); - - /** - * @since 3.4 - */ - void toggleBookmarks(bool show); - - /** - * @deprecated - */ - virtual void updateStatusLine(int dirs, int files); - - virtual void slotOk(); - virtual void accept(); - virtual void slotCancel(); - - void slotAutoSelectExtClicked(); - void addToRecentDocuments(); - void initSpeedbar(); - -private slots: - void slotLocationChanged( const TQString& text ); - -private: - KFileDialog(const KFileDialog&); - KFileDialog operator=(const KFileDialog&); - - void setLocationText( const TQString& text ); - void updateLocationWhatsThis(); - - void appendExtension(KURL &url); - void updateLocationEditExtension(const TQString &); - void updateFilter(); - - static void initStatic(); - - void setNonExtSelection(); - -protected: - KDirOperator *ops; - bool autoDirectoryFollowing; - - KURL::List& parseSelectedURLs() const; - -protected: - virtual void virtual_hook( int id, void* data ); -private: - KFileDialogPrivate *d; -}; - -#endif |