<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="en_US" xml:lang="en_US">
<head>
<title>kio/kfile: KEncodingFileDialog Class Reference (kio/kfile)</title>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta http-equiv="Content-Style-Type" content="text/css" />
<meta http-equiv="pics-label" content='(pics-1.1 "http://www.icra.org/ratingsv02.html" comment "ICRAonline DE v2.0" l gen true for "http://www.kde.org" r (nz 1 vz 1 lz 1 oz 1 cb 1) "http://www.rsac.org/ratingsv01.html" l gen true for "http://www.kde.org" r (n 0 s 0 v 0 l 0))' />
<meta name="trademark" content="KDE e.V." />
<meta name="description" content="K Desktop Environment Homepage, KDE.org" />
<meta name="MSSmartTagsPreventParsing" content="true" />
<meta name="robots" content="all" />
<link rel="shortcut icon" href="../../../favicon.ico" />
<link rel="stylesheet" media="screen" type="text/css" title="APIDOX" href="doxygen.css" />
</head>
<body>
<div id="nav_header_top" align="right">
<a href="#content" class="doNotDisplay" accesskey="2">Skip to main content ::</a>
<a href="../../.."><img id="nav_header_logo" alt="Home" align="left" src="../../../kde_gear_64.png" border="0" /></a>
<span class="doNotDisplay">::</span>
<div id="nav_header_title" align="left">KDE API Reference</div>
</div>
<div id="nav_header_bottom" align="right">
<span class="doNotDisplay">:: <a href="#navigation" accesskey="5">Skip to Link Menu</a><br/></span>
<div id="nav_header_bottom_right" style="text-align: left;">
/ <a href="../../..">API Reference</a>
/ <a href="../../html/index.html">kio</a> / <a href=".">kfile</a>
</div>
</div>
<table id="main" border="0" cellpadding="0" cellspacing="0" width="100%">
<tr>
<td valign="top" class="menuheader" height="0"></td>
<td id="contentcolumn" valign="top" rowspan="2" >
<div id="content" style="padding-top: 0px;"><div style="width:100%; margin: 0px; padding: 0px;">
<a name="content"></a>
<!-- Generated by Doxygen 1.7.4 -->
</div>
<div class="header">
<div class="summary">
<a href="#pub-methods">Public Member Functions</a> |
<a href="#pub-static-methods">Static Public Member Functions</a> |
<a href="#pro-methods">Protected Member Functions</a> </div>
<div class="headertitle">
<div class="title">KEncodingFileDialog Class Reference</div> </div>
</div>
<div class="contents">
<!-- doxytag: class="KEncodingFileDialog" --><!-- doxytag: inherits="KFileDialog" -->
<p>Provides a user (and developer) friendly way to select files with support for choosing encoding.
<a href="classKEncodingFileDialog.html#details">More...</a></p>
<p><code>#include <<a class="el" href="kencodingfiledialog_8h_source.html">kencodingfiledialog.h</a>></code></p>
<div class="dynheader">
Inheritance diagram for KEncodingFileDialog:</div>
<div class="dyncontent">
<div class="center">
<img src="classKEncodingFileDialog.png" usemap="#KEncodingFileDialog_map" alt=""/>
<map id="KEncodingFileDialog_map" name="KEncodingFileDialog_map">
<area href="classKFileDialog.html" title="Provides a user (and developer) friendly way to select files and directories." alt="KFileDialog" shape="rect" coords="0,0,130,24"/>
</map>
</div></div>
<p><a href="classKEncodingFileDialog-members.html">List of all members.</a></p>
<table class="memberdecls">
<tr><td colspan="2"><h2><a name="pub-methods"></a>
Public Member Functions</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classKEncodingFileDialog.html#a900be5870e0397d774ef401d80f98cf0">KEncodingFileDialog</a> (const <a class="elRef" href="qstring.html">QString</a> &startDir=QString::null, const <a class="elRef" href="qstring.html">QString</a> &encoding=QString::null, const <a class="elRef" href="qstring.html">QString</a> &filter=QString::null, const <a class="elRef" href="qstring.html">QString</a> &caption=QString::null, <a class="el" href="classKFileDialog.html#a92793cc7dbd998ec502567ab056b7098">KFileDialog::OperationMode</a> type=KFileDialog::Opening, <a class="elRef" href="qwidget.html">QWidget</a> *parent=0, const char *name="", bool modal=true)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classKEncodingFileDialog.html#ac0ce4b66621e67cfc57d57b25ada84b7">~KEncodingFileDialog</a> ()</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="qstring.html">QString</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classKEncodingFileDialog.html#a60c67aeb47e96abf9ba71a00f624fed0">selectedEncoding</a> () const </td></tr>
<tr><td colspan="2"><h2><a name="pub-static-methods"></a>
Static Public Member Functions</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static Result </td><td class="memItemRight" valign="bottom"><a class="el" href="classKEncodingFileDialog.html#a37991cdbacec90445da37fdcc6ee7f9d">getOpenFileNameAndEncoding</a> (const <a class="elRef" href="qstring.html">QString</a> &encoding=QString::null, const <a class="elRef" href="qstring.html">QString</a> &startDir=QString::null, const <a class="elRef" href="qstring.html">QString</a> &filter=QString::null, <a class="elRef" href="qwidget.html">QWidget</a> *parent=0, const <a class="elRef" href="qstring.html">QString</a> &caption=QString::null)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static Result </td><td class="memItemRight" valign="bottom"><a class="el" href="classKEncodingFileDialog.html#ab74a92967e98fe6442713b8141ffb623">getOpenFileNamesAndEncoding</a> (const <a class="elRef" href="qstring.html">QString</a> &encoding=QString::null, const <a class="elRef" href="qstring.html">QString</a> &startDir=QString::null, const <a class="elRef" href="qstring.html">QString</a> &filter=QString::null, <a class="elRef" href="qwidget.html">QWidget</a> *parent=0, const <a class="elRef" href="qstring.html">QString</a> &caption=QString::null)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static Result </td><td class="memItemRight" valign="bottom"><a class="el" href="classKEncodingFileDialog.html#a2822ad4a7ab8f344f858b783545cc98b">getOpenURLAndEncoding</a> (const <a class="elRef" href="qstring.html">QString</a> &encoding=QString::null, const <a class="elRef" href="qstring.html">QString</a> &startDir=QString::null, const <a class="elRef" href="qstring.html">QString</a> &filter=QString::null, <a class="elRef" href="qwidget.html">QWidget</a> *parent=0, const <a class="elRef" href="qstring.html">QString</a> &caption=QString::null)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static Result </td><td class="memItemRight" valign="bottom"><a class="el" href="classKEncodingFileDialog.html#a12efc5295f6a15a44799c718fd6fbbc5">getOpenURLsAndEncoding</a> (const <a class="elRef" href="qstring.html">QString</a> &encoding=QString::null, const <a class="elRef" href="qstring.html">QString</a> &startDir=QString::null, const <a class="elRef" href="qstring.html">QString</a> &filter=QString::null, <a class="elRef" href="qwidget.html">QWidget</a> *parent=0, const <a class="elRef" href="qstring.html">QString</a> &caption=QString::null)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static Result </td><td class="memItemRight" valign="bottom"><a class="el" href="classKEncodingFileDialog.html#a77b5f2361a6ef898c9ef5952cdb875b4">getSaveFileNameAndEncoding</a> (const <a class="elRef" href="qstring.html">QString</a> &encoding=QString::null, const <a class="elRef" href="qstring.html">QString</a> &startDir=QString::null, const <a class="elRef" href="qstring.html">QString</a> &filter=QString::null, <a class="elRef" href="qwidget.html">QWidget</a> *parent=0, const <a class="elRef" href="qstring.html">QString</a> &caption=QString::null)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static Result </td><td class="memItemRight" valign="bottom"><a class="el" href="classKEncodingFileDialog.html#ada6813fffc296a7c2bbbd9b1d4bbf8ad">getSaveURLAndEncoding</a> (const <a class="elRef" href="qstring.html">QString</a> &encoding=QString::null, const <a class="elRef" href="qstring.html">QString</a> &startDir=QString::null, const <a class="elRef" href="qstring.html">QString</a> &filter=QString::null, <a class="elRef" href="qwidget.html">QWidget</a> *parent=0, const <a class="elRef" href="qstring.html">QString</a> &caption=QString::null)</td></tr>
<tr><td colspan="2"><h2><a name="pro-methods"></a>
Protected Member Functions</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a017f92a4b625428ca7b9c53a1bf2365a"></a><!-- doxytag: member="KEncodingFileDialog::virtual_hook" ref="a017f92a4b625428ca7b9c53a1bf2365a" args="(int id, void *data)" -->
virtual void </td><td class="memItemRight" valign="bottom"><b>virtual_hook</b> (int id, void *data)</td></tr>
</table>
<hr/><a name="details" id="details"></a><h2>Detailed Description</h2>
<div class="textblock"><p>Provides a user (and developer) friendly way to select files with support for choosing encoding. </p>
<p>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. </p>
<p>Definition at line <a class="el" href="kencodingfiledialog_8h_source.html#l00039">39</a> of file <a class="el" href="kencodingfiledialog_8h_source.html">kencodingfiledialog.h</a>.</p>
</div><hr/><h2>Constructor & Destructor Documentation</h2>
<a class="anchor" id="a900be5870e0397d774ef401d80f98cf0"></a><!-- doxytag: member="KEncodingFileDialog::KEncodingFileDialog" ref="a900be5870e0397d774ef401d80f98cf0" args="(const QString &startDir=QString::null, const QString &encoding=QString::null, const QString &filter=QString::null, const QString &caption=QString::null, KFileDialog::OperationMode type=KFileDialog::Opening, QWidget *parent=0, const char *name="", bool modal=true)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">KEncodingFileDialog::KEncodingFileDialog </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>startDir</em> = <code>QString::null</code>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>encoding</em> = <code>QString::null</code>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>filter</em> = <code>QString::null</code>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>caption</em> = <code>QString::null</code>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="classKFileDialog.html#a92793cc7dbd998ec502567ab056b7098">KFileDialog::OperationMode</a> </td>
<td class="paramname"><em>type</em> = <code>KFileDialog::Opening</code>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="elRef" href="qwidget.html">QWidget</a> * </td>
<td class="paramname"><em>parent</em> = <code>0</code>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>name</em> = <code>""</code>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">bool </td>
<td class="paramname"><em>modal</em> = <code>true</code> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Constructs a file dialog for text files with encoding selection possibility. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">startDir</td><td>This can either be <ul>
<li>The URL of the directory to start in. </li>
<li>QString::null to start in the current working directory, or the last directory where a file has been selected. </li>
<li>':<keyword>' to start in the directory last used by a filedialog in the same application that specified the same keyword. </li>
<li>'::<keyword>' to start in the directory last used by a filedialog in any application that specified the same keyword.</li>
</ul>
</td></tr>
<tr><td class="paramname">encoding</td><td>The encoding shown in the encoding combo. If it's QString::null, the global default encoding will be shown.</td></tr>
<tr><td class="paramname">filter</td><td>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 <a class="el" href="classKFileDialog.html#a715e45099822135eeab4fd3ba828bc4a" title="Sets the filter to be used to filter.">setFilter()</a> for details on how to do this...</td></tr>
<tr><td class="paramname">caption</td><td>The caption of the dialog</td></tr>
<tr><td class="paramname">type</td><td>This can either be <ul>
<li>Opening (open dialog, the default setting) </li>
<li>Saving </li>
</ul>
</td></tr>
<tr><td class="paramname">parent</td><td>The parent widget of this dialog </td></tr>
<tr><td class="paramname">name</td><td>The name of this object </td></tr>
<tr><td class="paramname">modal</td><td>Whether to create a modal dialog or not</td></tr>
</table>
</dd>
</dl>
<dl class="since"><dt><b>Since:</b></dt><dd>3.2 </dd></dl>
<p>Definition at line <a class="el" href="kencodingfiledialog_8cpp_source.html#l00039">39</a> of file <a class="el" href="kencodingfiledialog_8cpp_source.html">kencodingfiledialog.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="ac0ce4b66621e67cfc57d57b25ada84b7"></a><!-- doxytag: member="KEncodingFileDialog::~KEncodingFileDialog" ref="ac0ce4b66621e67cfc57d57b25ada84b7" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">KEncodingFileDialog::~KEncodingFileDialog </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Destructs the file dialog. </p>
<p>Definition at line <a class="el" href="kencodingfiledialog_8cpp_source.html#l00081">81</a> of file <a class="el" href="kencodingfiledialog_8cpp_source.html">kencodingfiledialog.cpp</a>.</p>
</div>
</div>
<hr/><h2>Member Function Documentation</h2>
<a class="anchor" id="a37991cdbacec90445da37fdcc6ee7f9d"></a><!-- doxytag: member="KEncodingFileDialog::getOpenFileNameAndEncoding" ref="a37991cdbacec90445da37fdcc6ee7f9d" args="(const QString &encoding=QString::null, const QString &startDir=QString::null, const QString &filter=QString::null, QWidget *parent=0, const QString &caption=QString::null)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">KEncodingFileDialog::Result KEncodingFileDialog::getOpenFileNameAndEncoding </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>encoding</em> = <code>QString::null</code>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>startDir</em> = <code>QString::null</code>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>filter</em> = <code>QString::null</code>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="elRef" href="qwidget.html">QWidget</a> * </td>
<td class="paramname"><em>parent</em> = <code>0</code>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>caption</em> = <code>QString::null</code> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>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. </p>
<p>Note that with this method the user must select an existing filename.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">startDir</td><td>This can either be <ul>
<li>The URL of the directory to start in. </li>
<li>QString::null to start in the current working directory, or the last directory where a file has been selected. </li>
<li>':<keyword>' to start in the directory last used by a filedialog in the same application that specified the same keyword. </li>
<li>'::<keyword>' to start in the directory last used by a filedialog in any application that specified the same keyword. </li>
</ul>
</td></tr>
<tr><td class="paramname">encoding</td><td>The encoding shown in the encoding combo. </td></tr>
<tr><td class="paramname">filter</td><td>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 <a class="el" href="classKFileDialog.html#a715e45099822135eeab4fd3ba828bc4a" title="Sets the filter to be used to filter.">setFilter()</a> for details on how to do this... </td></tr>
<tr><td class="paramname">parent</td><td>The widget the dialog will be centered on initially. </td></tr>
<tr><td class="paramname">caption</td><td>The name of the dialog widget. </td></tr>
</table>
</dd>
</dl>
<p>Definition at line <a class="el" href="kencodingfiledialog_8cpp_source.html#l00096">96</a> of file <a class="el" href="kencodingfiledialog_8cpp_source.html">kencodingfiledialog.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="ab74a92967e98fe6442713b8141ffb623"></a><!-- doxytag: member="KEncodingFileDialog::getOpenFileNamesAndEncoding" ref="ab74a92967e98fe6442713b8141ffb623" args="(const QString &encoding=QString::null, const QString &startDir=QString::null, const QString &filter=QString::null, QWidget *parent=0, const QString &caption=QString::null)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">KEncodingFileDialog::Result KEncodingFileDialog::getOpenFileNamesAndEncoding </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>encoding</em> = <code>QString::null</code>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>startDir</em> = <code>QString::null</code>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>filter</em> = <code>QString::null</code>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="elRef" href="qwidget.html">QWidget</a> * </td>
<td class="paramname"><em>parent</em> = <code>0</code>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>caption</em> = <code>QString::null</code> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Creates a modal file dialog and returns the selected encoding and the selected filenames or an empty list if none was chosen. </p>
<p>Note that with this method the user must select an existing filename.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">startDir</td><td>This can either be <ul>
<li>The URL of the directory to start in. </li>
<li>QString::null to start in the current working directory, or the last directory where a file has been selected. </li>
<li>':<keyword>' to start in the directory last used by a filedialog in the same application that specified the same keyword. </li>
<li>'::<keyword>' to start in the directory last used by a filedialog in any application that specified the same keyword. </li>
</ul>
</td></tr>
<tr><td class="paramname">encoding</td><td>The encoding shown in the encoding combo. </td></tr>
<tr><td class="paramname">filter</td><td>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 <a class="el" href="classKFileDialog.html#a715e45099822135eeab4fd3ba828bc4a" title="Sets the filter to be used to filter.">setFilter()</a> for details on how to do this. </td></tr>
<tr><td class="paramname">parent</td><td>The widget the dialog will be centered on initially. </td></tr>
<tr><td class="paramname">caption</td><td>The name of the dialog widget. </td></tr>
</table>
</dd>
</dl>
<p>Definition at line <a class="el" href="kencodingfiledialog_8cpp_source.html#l00114">114</a> of file <a class="el" href="kencodingfiledialog_8cpp_source.html">kencodingfiledialog.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="a2822ad4a7ab8f344f858b783545cc98b"></a><!-- doxytag: member="KEncodingFileDialog::getOpenURLAndEncoding" ref="a2822ad4a7ab8f344f858b783545cc98b" args="(const QString &encoding=QString::null, const QString &startDir=QString::null, const QString &filter=QString::null, QWidget *parent=0, const QString &caption=QString::null)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">KEncodingFileDialog::Result KEncodingFileDialog::getOpenURLAndEncoding </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>encoding</em> = <code>QString::null</code>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>startDir</em> = <code>QString::null</code>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>filter</em> = <code>QString::null</code>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="elRef" href="qwidget.html">QWidget</a> * </td>
<td class="paramname"><em>parent</em> = <code>0</code>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>caption</em> = <code>QString::null</code> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Creates a modal file dialog and returns the selected encoding and URL or an empty string if none was chosen. </p>
<p>Note that with this method the user must select an existing URL.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">startDir</td><td>This can either be <ul>
<li>The URL of the directory to start in. </li>
<li>QString::null to start in the current working directory, or the last directory where a file has been selected. </li>
<li>':<keyword>' to start in the directory last used by a filedialog in the same application that specified the same keyword. </li>
<li>'::<keyword>' to start in the directory last used by a filedialog in any application that specified the same keyword. </li>
</ul>
</td></tr>
<tr><td class="paramname">encoding</td><td>The encoding shown in the encoding combo. </td></tr>
<tr><td class="paramname">filter</td><td>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 <a class="el" href="classKFileDialog.html#a715e45099822135eeab4fd3ba828bc4a" title="Sets the filter to be used to filter.">setFilter()</a> for details on how to do this... </td></tr>
<tr><td class="paramname">parent</td><td>The widget the dialog will be centered on initially. </td></tr>
<tr><td class="paramname">caption</td><td>The name of the dialog widget. </td></tr>
</table>
</dd>
</dl>
<p>Definition at line <a class="el" href="kencodingfiledialog_8cpp_source.html#l00132">132</a> of file <a class="el" href="kencodingfiledialog_8cpp_source.html">kencodingfiledialog.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="a12efc5295f6a15a44799c718fd6fbbc5"></a><!-- doxytag: member="KEncodingFileDialog::getOpenURLsAndEncoding" ref="a12efc5295f6a15a44799c718fd6fbbc5" args="(const QString &encoding=QString::null, const QString &startDir=QString::null, const QString &filter=QString::null, QWidget *parent=0, const QString &caption=QString::null)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">KEncodingFileDialog::Result KEncodingFileDialog::getOpenURLsAndEncoding </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>encoding</em> = <code>QString::null</code>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>startDir</em> = <code>QString::null</code>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>filter</em> = <code>QString::null</code>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="elRef" href="qwidget.html">QWidget</a> * </td>
<td class="paramname"><em>parent</em> = <code>0</code>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>caption</em> = <code>QString::null</code> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Creates a modal file dialog and returns the selected encoding URLs or an empty list if none was chosen. </p>
<p>Note that with this method the user must select an existing filename.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">startDir</td><td>This can either be <ul>
<li>The URL of the directory to start in. </li>
<li>QString::null to start in the current working directory, or the last directory where a file has been selected. </li>
<li>':<keyword>' to start in the directory last used by a filedialog in the same application that specified the same keyword. </li>
<li>'::<keyword>' to start in the directory last used by a filedialog in any application that specified the same keyword. </li>
</ul>
</td></tr>
<tr><td class="paramname">encoding</td><td>The encoding shown in the encoding combo. </td></tr>
<tr><td class="paramname">filter</td><td>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 <a class="el" href="classKFileDialog.html#a715e45099822135eeab4fd3ba828bc4a" title="Sets the filter to be used to filter.">setFilter()</a> for details on how to do this... </td></tr>
<tr><td class="paramname">parent</td><td>The widget the dialog will be centered on initially. </td></tr>
<tr><td class="paramname">caption</td><td>The name of the dialog widget. </td></tr>
</table>
</dd>
</dl>
<p>Definition at line <a class="el" href="kencodingfiledialog_8cpp_source.html#l00148">148</a> of file <a class="el" href="kencodingfiledialog_8cpp_source.html">kencodingfiledialog.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="a77b5f2361a6ef898c9ef5952cdb875b4"></a><!-- doxytag: member="KEncodingFileDialog::getSaveFileNameAndEncoding" ref="a77b5f2361a6ef898c9ef5952cdb875b4" args="(const QString &encoding=QString::null, const QString &startDir=QString::null, const QString &filter=QString::null, QWidget *parent=0, const QString &caption=QString::null)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">KEncodingFileDialog::Result KEncodingFileDialog::getSaveFileNameAndEncoding </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>encoding</em> = <code>QString::null</code>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>startDir</em> = <code>QString::null</code>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>filter</em> = <code>QString::null</code>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="elRef" href="qwidget.html">QWidget</a> * </td>
<td class="paramname"><em>parent</em> = <code>0</code>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>caption</em> = <code>QString::null</code> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Creates a modal file dialog and returns the selected encoding and filename or an empty string if none was chosen. </p>
<p>Note that with this method the user need not select an existing filename.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">startDir</td><td>This can either be <ul>
<li>The URL of the directory to start in. </li>
<li>a relative path or a filename determining the directory to start in and the file to be selected. </li>
<li>QString::null to start in the current working directory, or the last directory where a file has been selected. </li>
<li>':<keyword>' to start in the directory last used by a filedialog in the same application that specified the same keyword. </li>
<li>'::<keyword>' to start in the directory last used by a filedialog in any application that specified the same keyword. </li>
</ul>
</td></tr>
<tr><td class="paramname">encoding</td><td>The encoding shown in the encoding combo. </td></tr>
<tr><td class="paramname">filter</td><td>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 <a class="el" href="classKFileDialog.html#a715e45099822135eeab4fd3ba828bc4a" title="Sets the filter to be used to filter.">setFilter()</a> for details on how to do this... </td></tr>
<tr><td class="paramname">parent</td><td>The widget the dialog will be centered on initially. </td></tr>
<tr><td class="paramname">caption</td><td>The name of the dialog widget. </td></tr>
</table>
</dd>
</dl>
<p>Definition at line <a class="el" href="kencodingfiledialog_8cpp_source.html#l00167">167</a> of file <a class="el" href="kencodingfiledialog_8cpp_source.html">kencodingfiledialog.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="ada6813fffc296a7c2bbbd9b1d4bbf8ad"></a><!-- doxytag: member="KEncodingFileDialog::getSaveURLAndEncoding" ref="ada6813fffc296a7c2bbbd9b1d4bbf8ad" args="(const QString &encoding=QString::null, const QString &startDir=QString::null, const QString &filter=QString::null, QWidget *parent=0, const QString &caption=QString::null)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">KEncodingFileDialog::Result KEncodingFileDialog::getSaveURLAndEncoding </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>encoding</em> = <code>QString::null</code>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>startDir</em> = <code>QString::null</code>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>filter</em> = <code>QString::null</code>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="elRef" href="qwidget.html">QWidget</a> * </td>
<td class="paramname"><em>parent</em> = <code>0</code>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>caption</em> = <code>QString::null</code> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Creates a modal file dialog and returns the selected encoding and filename or an empty string if none was chosen. </p>
<p>Note that with this method the user need not select an existing filename.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">startDir</td><td>This can either be <ul>
<li>The URL of the directory to start in. </li>
<li>a relative path or a filename determining the directory to start in and the file to be selected. </li>
<li>QString::null to start in the current working directory, or the last directory where a file has been selected. </li>
<li>':<keyword>' to start in the directory last used by a filedialog in the same application that specified the same keyword. </li>
<li>'::<keyword>' to start in the directory last used by a filedialog in any application that specified the same keyword. </li>
</ul>
</td></tr>
<tr><td class="paramname">encoding</td><td>The encoding shown in the encoding combo. </td></tr>
<tr><td class="paramname">filter</td><td>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 <a class="el" href="classKFileDialog.html#a715e45099822135eeab4fd3ba828bc4a" title="Sets the filter to be used to filter.">setFilter()</a> for details on how to do this... </td></tr>
<tr><td class="paramname">parent</td><td>The widget the dialog will be centered on initially. </td></tr>
<tr><td class="paramname">caption</td><td>The name of the dialog widget. </td></tr>
</table>
</dd>
</dl>
<p>Definition at line <a class="el" href="kencodingfiledialog_8cpp_source.html#l00192">192</a> of file <a class="el" href="kencodingfiledialog_8cpp_source.html">kencodingfiledialog.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="a60c67aeb47e96abf9ba71a00f624fed0"></a><!-- doxytag: member="KEncodingFileDialog::selectedEncoding" ref="a60c67aeb47e96abf9ba71a00f624fed0" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="qstring.html">QString</a> KEncodingFileDialog::selectedEncoding </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<dl class="return"><dt><b>Returns:</b></dt><dd>The selected encoding if the constructor with the encoding parameter was used, otherwise QString::null. </dd></dl>
<p>Definition at line <a class="el" href="kencodingfiledialog_8cpp_source.html#l00087">87</a> of file <a class="el" href="kencodingfiledialog_8cpp_source.html">kencodingfiledialog.cpp</a>.</p>
</div>
</div>
<hr/>The documentation for this class was generated from the following files:<ul>
<li><a class="el" href="kencodingfiledialog_8h_source.html">kencodingfiledialog.h</a></li>
<li><a class="el" href="kencodingfiledialog_8cpp_source.html">kencodingfiledialog.cpp</a></li>
</ul>
</div>
</div></div>
</td>
</tr>
<tr>
<td valign="top" id="leftmenu" width="25%">
<a name="navigation"></a>
<div class="menu_box"><h2>kio/kfile</h2>
<div class="nav_list">
<ul><li><a href="index.html">Main Page</a></li><li><a href="hierarchy.html">Class Hierarchy</a></li><li><a href="classes.html">Alphabetical List</a></li><li><a href="annotated.html">Class List</a></li><li><a href="files.html">File List</a></li><li><a href="functions.html">Class Members</a></li><li><a href="pages.html">Related Pages</a></li></ul>
<!--
<h2>Class Picker</h2>
<div style="text-align: center;">
<form name="guideform">
<select name="guidelinks" style="width:100%;" onChange="window.location=document.guideform.guidelinks.options[document.guideform.guidelinks.selectedIndex].value">
<option value="annotated.html">-- Choose --</option>
<option value="classKApplicationPropsPlugin.html">kapplicationpropsplugin</option>, <option value="classKBindingPropsPlugin.html">kbindingpropsplugin</option>, <option value="classKCombiView.html">kcombiview</option>, <option value="classKDesktopPropsPlugin.html">kdesktoppropsplugin</option>, <option value="classKDevicePropsPlugin.html">kdevicepropsplugin</option>, <option value="classKDirOperator.html">kdiroperator</option>, <option value="classKDirSelectDialog.html">kdirselectdialog</option>, <option value="classKDirSize.html">kdirsize</option>, <option value="classKDiskFreeSp.html">kdiskfreesp</option>, <option value="classKEncodingFileDialog.html">kencodingfiledialog</option>, <option value="classKExecPropsPlugin.html">kexecpropsplugin</option>, <option value="classKFile.html">kfile</option>, <option value="classKFileDetailView.html">kfiledetailview</option>, <option value="classKFileDialog.html">kfiledialog</option>, <option value="classKFileIconView.html">kfileiconview</option>, <option value="classKFileIconViewItem.html">kfileiconviewitem</option>, <option value="classKFileListViewItem.html">kfilelistviewitem</option>, <option value="classKFileMetaInfoWidget.html">kfilemetainfowidget</option>, <option value="classKFileMetaPropsPlugin.html">kfilemetapropsplugin</option>, <option value="classKFileOpenWithHandler.html">kfileopenwithhandler</option>, <option value="classKFilePermissionsPropsPlugin.html">kfilepermissionspropsplugin</option>, <option value="classKFilePreview.html">kfilepreview</option>, <option value="classKFilePropsPlugin.html">kfilepropsplugin</option>, <option value="classKFileSharePropsPlugin.html">kfilesharepropsplugin</option>, <option value="classKFileTreeBranch.html">kfiletreebranch</option>, <option value="classKFileTreeView.html">kfiletreeview</option>, <option value="classKFileTreeViewItem.html">kfiletreeviewitem</option>, <option value="classKFileView.html">kfileview</option>, <option value="classKFileViewSignaler.html">kfileviewsignaler</option>, <option value="classKIconButton.html">kiconbutton</option>, <option value="classKIconCanvas.html">kiconcanvas</option>, <option value="classKIconDialog.html">kicondialog</option>, <option value="classKImageFilePreview.html">kimagefilepreview</option>, <option value="classKNotifyDialog.html">knotifydialog</option>, <option value="classKOpenWithDlg.html">kopenwithdlg</option>, <option value="classKPreviewPropsPlugin.html">kpreviewpropsplugin</option>, <option value="classKPreviewWidgetBase.html">kpreviewwidgetbase</option>, <option value="classKPropertiesDialog.html">kpropertiesdialog</option>, <option value="classKPropsDlgPlugin.html">kpropsdlgplugin</option>, <option value="classKRecentDirs.html">krecentdirs</option>, <option value="classKRecentDocument.html">krecentdocument</option>, <option value="classKURLBar.html">kurlbar</option>, <option value="classKURLBarItem.html">kurlbaritem</option>, <option value="classKURLBarItemDialog.html">kurlbaritemdialog</option>, <option value="classKURLBarListBox.html">kurlbarlistbox</option>, <option value="classKURLComboBox.html">kurlcombobox</option>, <option value="classKURLComboRequester.html">kurlcomborequester</option>, <option value="classKURLPropsPlugin.html">kurlpropsplugin</option>, <option value="classKURLRequester.html">kurlrequester</option>, <option value="classKURLRequesterDlg.html">kurlrequesterdlg</option>,
</select>
</form>
</div>
-->
</div></div>
<div class="menu_box"><h2>API Dox</h2>
<div class="nav_list">
<ul>
<li><a href="../../../arts/html/index.html">arts</a></li><li><a href="../../../dcop/html/index.html">dcop</a></li><li><a href="../../../dnssd/html/index.html">dnssd</a></li><li><a href="../../../interfaces/html/index.html">interfaces</a></li><li> <a href="../../../interfaces/kimproxy/interface/html/index.html">interface</a></li><li> <a href="../../../interfaces/kimproxy/library/html/index.html">library</a></li><li> <a href="../../../interfaces/kspeech/html/index.html">kspeech</a></li><li> <a href="../../../interfaces/ktexteditor/html/index.html">ktexteditor</a></li><li><a href="../../../kabc/html/index.html">kabc</a></li><li><a href="../../../kate/html/index.html">kate</a></li><li><a href="../../../kcmshell/html/index.html">kcmshell</a></li><li><a href="../../../kdecore/html/index.html">kdecore</a></li><li><a href="../../../kded/html/index.html">kded</a></li><li><a href="../../../kdefx/html/index.html">kdefx</a></li><li><a href="../../../kdeprint/html/index.html">kdeprint</a></li><li><a href="../../../kdesu/html/index.html">kdesu</a></li><li><a href="../../../kdeui/html/index.html">kdeui</a></li><li><a href="../../../kdoctools/html/index.html">kdoctools</a></li><li><a href="../../../khtml/html/index.html">khtml</a></li><li><a href="../../../kimgio/html/index.html">kimgio</a></li><li><a href="../../../kinit/html/index.html">kinit</a></li><li><a href="../../../kio/html/index.html">kio</a></li><li> <a href="../../../kio/bookmarks/html/index.html">bookmarks</a></li><li> <a href="../../../kio/httpfilter/html/index.html">httpfilter</a></li><li> <a href="../../../kio/kfile/html/index.html">kfile</a></li><li> <a href="../../../kio/kio/html/index.html">kio</a></li><li> <a href="../../../kio/kioexec/html/index.html">kioexec</a></li><li> <a href="../../../kio/kpasswdserver/html/index.html">kpasswdserver</a></li><li> <a href="../../../kio/kssl/html/index.html">kssl</a></li><li><a href="../../../kioslave/html/index.html">kioslave</a></li><li> <a href="../../../kioslave/http/html/index.html">http</a></li><li><a href="../../../kjs/html/index.html">kjs</a></li><li><a href="../../../kmdi/html/index.html">kmdi</a></li><li> <a href="../../../kmdi/kmdi/html/index.html">kmdi</a></li><li><a href="../../../knewstuff/html/index.html">knewstuff</a></li><li><a href="../../../kparts/html/index.html">kparts</a></li><li><a href="../../../kresources/html/index.html">kresources</a></li><li><a href="../../../kspell2/html/index.html">kspell2</a></li><li><a href="../../../kunittest/html/index.html">kunittest</a></li><li><a href="../../../kutils/html/index.html">kutils</a></li><li><a href="../../../kwallet/html/index.html">kwallet</a></li><li><a href="../../../libkmid/html/index.html">libkmid</a></li><li><a href="../../../libkscreensaver/html/index.html">libkscreensaver</a></li>
</ul></div></div>
</td>
</tr>
</table>
<span class="doNotDisplay">
<a href="http://www.kde.org/" accesskey="8">KDE Home</a> |
<a href="http://accessibility.kde.org/" accesskey="9">KDE Accessibility Home</a> |
<a href="http://www.kde.org/media/accesskeys.php" accesskey="0">Description of Access Keys</a>
</span>
<div style="height: 8px"></div>
<div id="footer">
<div id="footer_left">
Maintained by <a href="mailto:groot@kde.org">Adriaan de Groot</a>
and
<a href="mailto:winter@kde.org">Allen Winter</a>.
<br/>
KDE and K Desktop Environment are trademarks of <a href="http://www.kde.org/areas/kde-ev/" title="Homepage of the KDE non-profit Organization">KDE e.V.</a> |
<a href="http://www.kde.org/contact/impressum.php">Legal</a>
</div>
<div id="footer_right"><img src="/media/images/footer_right.png" style="margin: 0px" alt="" /></div>
</div>
<!--
WARNING: DO NOT SEND MAIL TO THE FOLLOWING EMAIL ADDRESS! YOU WILL
BE BLOCKED INSTANTLY AND PERMANENTLY!
<a href="mailto:aaaatrap-425acc3b5374943f@kde.org">Block me</a>
WARNING END
-->
</body>
</html>
