#include <kencodingfiledialog.h>

Inheritance diagram for KEncodingFileDialog:

Classes
class	Result

Public Member Functions
	KEncodingFileDialog (const QString &startDir=QString(), const QString &encoding=QString(), const QString &filter=QString(), const QString &caption=QString(), KFileDialog::OperationMode type=KFileDialog::Opening, QWidget *parent=0)

	~KEncodingFileDialog ()

QString	selectedEncoding () const

Public Member Functions inherited from KFileDialog
	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

Static Public Member Functions
static Result	getOpenFileNameAndEncoding (const QString &encoding=QString(), const QString &startDir=QString(), const QString &filter=QString(), QWidget *parent=0, const QString &caption=QString())

static Result	getOpenFileNamesAndEncoding (const QString &encoding=QString(), const QString &startDir=QString(), const QString &filter=QString(), QWidget *parent=0, const QString &caption=QString())

static Result	getOpenUrlAndEncoding (const QString &encoding=QString(), const QString &startDir=QString(), const QString &filter=QString(), QWidget *parent=0, const QString &caption=QString())

static Result	getOpenUrlsAndEncoding (const QString &encoding=QString(), const QString &startDir=QString(), const QString &filter=QString(), QWidget *parent=0, const QString &caption=QString())

static Result	getSaveFileNameAndEncoding (const QString &encoding=QString(), const QString &startDir=QString(), const QString &filter=QString(), QWidget *parent=0, const QString &caption=QString())

static Result	getSaveUrlAndEncoding (const QString &encoding=QString(), const QString &startDir=QString(), const QString &filter=QString(), QWidget *parent=0, const QString &caption=QString())

Static Public Member Functions inherited from KFileDialog
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)

Additional Inherited Members
Public Types inherited from KFileDialog
enum	OperationMode { Other = 0, Opening, Saving }

enum	Option { ConfirmOverwrite = 0x01, ShowInlinePreview = 0x02 }

Public Slots inherited from KFileDialog
int	exec ()

Signals inherited from KFileDialog
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 ()

Protected Slots inherited from KFileDialog
virtual void	accept ()

virtual void	slotCancel ()

virtual void	slotOk ()

Protected Member Functions inherited from KFileDialog
virtual void	hideEvent (QHideEvent *event)

virtual void	keyPressEvent (QKeyEvent *e)

Detailed Description

Provides a user (and developer) friendly way to select files with support for choosing encoding.

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.

Definition at line 39 of file kencodingfiledialog.h.

Constructor & Destructor Documentation

KEncodingFileDialog::KEncodingFileDialog	(	const QString &	startDir = `QString()`,
		const QString &	encoding = `QString()`,
		const QString &	filter = `QString()`,
		const QString &	caption = `QString()`,
		KFileDialog::OperationMode	type = `KFileDialog::Opening`,
		QWidget *	parent = `0`
	)

Constructs a file dialog for text files with encoding selection possibility.

Parameters

startDir	This can either be The URL of the directory to start in. QString() to start in the current working directory, or the last directory where a file has been selected. ':<keyword>' to start in the directory last used by a filedialog in the same application that specified the same keyword. '::<keyword>' to start in the directory last used by a filedialog in any application that specified the same keyword.
encoding	The encoding shown in the encoding combo. If it's QString(), the global default encoding will be shown.
filter	A shell glob or a mime-type-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.
caption	The caption of the dialog
type	This can either be Opening (open dialog, the default setting) Saving
parent	The parent widget of this dialog

Definition at line 39 of file kencodingfiledialog.cpp.

KEncodingFileDialog::~KEncodingFileDialog ( )

Destructs the file dialog.

Definition at line 85 of file kencodingfiledialog.cpp.

Member Function Documentation

KEncodingFileDialog::Result KEncodingFileDialog::getOpenFileNameAndEncoding	(	const QString &	encoding = `QString()`,
		const QString &	startDir = `QString()`,
		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 additionally a chosen encoding value is returned.

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

Parameters

encoding	The encoding shown in the encoding combo.
startDir	This can either be The URL of the directory to start in. QString() to start in the current working directory, or the last directory where a file has been selected. ':<keyword>' to start in the directory last used by a filedialog in the same application that specified the same keyword. '::<keyword>' to start in the directory last used by a filedialog in any application that specified the same keyword.
filter	A shell glob or a mime-type-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.
parent	The widget the dialog will be centered on initially.
caption	The name of the dialog widget.

Definition at line 100 of file kencodingfiledialog.cpp.

KEncodingFileDialog::Result KEncodingFileDialog::getOpenFileNamesAndEncoding	(	const QString &	encoding = `QString()`,
		const QString &	startDir = `QString()`,
		const QString &	filter = `QString()`,
		QWidget *	parent = `0`,
		const QString &	caption = `QString()`
	)

static

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

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

Parameters

encoding	The encoding shown in the encoding combo.
startDir	This can either be The URL of the directory to start in. QString() to start in the current working directory, or the last directory where a file has been selected. ':<keyword>' to start in the directory last used by a filedialog in the same application that specified the same keyword. '::<keyword>' to start in the directory last used by a filedialog in any application that specified the same keyword.
filter	A shell glob or a mime-type-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.
parent	The widget the dialog will be centered on initially.
caption	The name of the dialog widget.

Definition at line 118 of file kencodingfiledialog.cpp.

KEncodingFileDialog::Result KEncodingFileDialog::getOpenUrlAndEncoding	(	const QString &	encoding = `QString()`,
		const QString &	startDir = `QString()`,
		const QString &	filter = `QString()`,
		QWidget *	parent = `0`,
		const QString &	caption = `QString()`
	)

static

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

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

Parameters

encoding	The encoding shown in the encoding combo.
startDir	This can either be The URL of the directory to start in. QString() to start in the current working directory, or the last directory where a file has been selected. ':<keyword>' to start in the directory last used by a filedialog in the same application that specified the same keyword. '::<keyword>' to start in the directory last used by a filedialog in any application that specified the same keyword.
filter	A shell glob or a mime-type-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.
parent	The widget the dialog will be centered on initially.
caption	The name of the dialog widget.

Definition at line 135 of file kencodingfiledialog.cpp.

KEncodingFileDialog::Result KEncodingFileDialog::getOpenUrlsAndEncoding	(	const QString &	encoding = `QString()`,
		const QString &	startDir = `QString()`,
		const QString &	filter = `QString()`,
		QWidget *	parent = `0`,
		const QString &	caption = `QString()`
	)

static

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

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

Parameters

encoding	The encoding shown in the encoding combo.
startDir	This can either be The URL of the directory to start in. QString() to start in the current working directory, or the last directory where a file has been selected. ':<keyword>' to start in the directory last used by a filedialog in the same application that specified the same keyword. '::<keyword>' to start in the directory last used by a filedialog in any application that specified the same keyword.
filter	A shell glob or a mime-type-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.
parent	The widget the dialog will be centered on initially.
caption	The name of the dialog widget.

Definition at line 151 of file kencodingfiledialog.cpp.

KEncodingFileDialog::Result KEncodingFileDialog::getSaveFileNameAndEncoding	(	const QString &	encoding = `QString()`,
		const QString &	startDir = `QString()`,
		const QString &	filter = `QString()`,
		QWidget *	parent = `0`,
		const QString &	caption = `QString()`
	)

static

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

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

Parameters

encoding	The encoding shown in the encoding combo.
startDir	This can either be The URL of the directory to start in. a relative path or a filename determining the directory to start in and the file to be selected. QString() to start in the current working directory, or the last directory where a file has been selected. ':<keyword>' to start in the directory last used by a filedialog in the same application that specified the same keyword. '::<keyword>' to start in the directory last used by a filedialog in any application that specified the same keyword.
filter	A shell glob or a mime-type-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.
parent	The widget the dialog will be centered on initially.
caption	The name of the dialog widget.

Definition at line 170 of file kencodingfiledialog.cpp.

KEncodingFileDialog::Result KEncodingFileDialog::getSaveUrlAndEncoding	(	const QString &	encoding = `QString()`,
		const QString &	startDir = `QString()`,
		const QString &	filter = `QString()`,
		QWidget *	parent = `0`,
		const QString &	caption = `QString()`
	)

static

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

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

Parameters

encoding	The encoding shown in the encoding combo.
startDir	This can either be The URL of the directory to start in. a relative path or a filename determining the directory to start in and the file to be selected. QString() to start in the current working directory, or the last directory where a file has been selected. ':<keyword>' to start in the directory last used by a filedialog in the same application that specified the same keyword. '::<keyword>' to start in the directory last used by a filedialog in any application that specified the same keyword.
filter	A shell glob or a mime-type-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.
parent	The widget the dialog will be centered on initially.
caption	The name of the dialog widget.

Definition at line 193 of file kencodingfiledialog.cpp.

QString KEncodingFileDialog::selectedEncoding ( ) const

Returns: The selected encoding if the constructor with the encoding parameter was used, otherwise QString().

Definition at line 91 of file kencodingfiledialog.cpp.

The documentation for this class was generated from the following files:

KIO

Classes

Public Member Functions

Static Public Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

KIO

kdelibs API Reference

Search