qfiledialog.html

QT参考文档

<h3 class=fn>void <a name="setIconProvider"></a>QFileDialog::setIconProvider ( <a href="qfileiconprovider.html">QFileIconProvider</a>&nbsp;*&nbsp;provider )<tt> [静态]</tt>
</h3>
设置文件对话框使用的<a href="qfileiconprovider.html">QFileIconProvider</a>为<em>provider</em>。
<p> 默认没有QFileIconProvider并且QFileDialog只为每一个目录绘制一个文件夹图标，而对文件则没有图标。
<p> <p>也可以参考<a href="qfileiconprovider.html">QFileIconProvider</a>和<a href="#iconProvider">iconProvider</a>()。
<p>实例：<a href="showimg-example.html#x1301">showimg/main.cpp</a>。

<h3 class=fn>void <a name="setInfoPreview"></a>QFileDialog::setInfoPreview ( <a href="qwidget.html">QWidget</a>&nbsp;*&nbsp;w, <a href="qfilepreview.html">QFilePreview</a>&nbsp;*&nbsp;preview )
</h3>
设置被用于作为文件对话框显示文件信息的窗口部件为<em>w</em>并且使用<a href="qfilepreview.html">QFilePreview</a> <em>preview</em>来预览信息。
<p> 通常你需要创建一个继承<a href="qwidget.html">QWidget</a>和QFilePreview的预览窗口部件，所以你需要传递同一个窗口部件两次。
<p> <pre>
    class Preview : public <a href="qlabel.html">QLabel</a>, public QFilePreview
    {
    public:
        Preview( <a href="qwidget.html">QWidget</a> *parent=0 ) : <a href="qlabel.html">QLabel</a>( parent ) {}

        void previewUrl( const <a href="qurl.html">QUrl</a> &amp;u )
        {
            <a href="qstring.html">QString</a> path = u.<a href="qurl.html#path">path</a>();
            <a href="qpixmap.html">QPixmap</a> pix( path );
            if ( pix.<a href="qpixmap.html#isNull">isNull</a>() )
                setText( "This is not a pixmap" );
            else
                setText( "This is a pixmap" );
        }
    };

  //...

  int main( int argc, char** argv )
  {
    Preview* p = new Preview;

    QFileDialog* fd = new QFileDialog( this );
    fd-&gt;<a href="#setInfoPreviewEnabled">setInfoPreviewEnabled</a>( TRUE );
    fd-&gt;<a href="#setInfoPreview">setInfoPreview</a>( p, p );
    fd-&gt;<a href="#setPreviewMode">setPreviewMode</a>( QFileDialog::<a href="#PreviewMode-enum">Info</a> );
    fd-&gt;<a href="qdialog.html#show">show</a>();
  }

  </pre>
 
<p> <p>也可以参考<a href="#setContentsPreview">setContentsPreview</a>()、<a href="#infoPreview-prop">infoPreview</a>和<a href="#previewMode-prop">previewMode</a>。

<h3 class=fn>void <a name="setInfoPreviewEnabled"></a>QFileDialog::setInfoPreviewEnabled ( bool )
</h3>
<p>设置文件对话框是否提供当前选择文件的信息预览。详细情况请参考<a href="qfiledialog.html#infoPreview-prop">“infoPreview”</a>属性。

<h3 class=fn>void <a name="setMode"></a>QFileDialog::setMode ( <a href="qfiledialog.html#Mode-enum">Mode</a> )
</h3>
<p>设置文件对话框的模式。详细情况请参考<a href="qfiledialog.html#mode-prop">“mode”</a>属性。

<h3 class=fn>void <a name="setPreviewMode"></a>QFileDialog::setPreviewMode ( <a href="qfiledialog.html#PreviewMode-enum">PreviewMode</a>&nbsp;m )
</h3>
<p>设置文件对话框的预览模式为<em>m</em>。详细情况请参考<a href="qfiledialog.html#previewMode-prop">“previewMode”</a>属性。

<h3 class=fn>void <a name="setSelectedFilter"></a>QFileDialog::setSelectedFilter ( const&nbsp;<a href="qstring.html">QString</a>&nbsp;&amp;&nbsp;mask )<tt> [虚]</tt>
</h3>
设置文件对话框中当前选择的过滤器为文本<em>mask</em>中包含的第一个。

<h3 class=fn>void <a name="setSelectedFilter-2"></a>QFileDialog::setSelectedFilter ( int&nbsp;n )<tt> [虚]</tt>
</h3> 
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。
<p> 设置文件对话框中当前选择的过滤器为过滤器列表中的第<em>n</em>个过滤器。
<p> <p>也可以参考<a href="#filterSelected">filterSelected</a>()、<a href="#selectedFilter-prop">selectedFilter</a>、<a href="#selectedFiles-prop">selectedFiles</a>和<a href="#selectedFile-prop">selectedFile</a>。

<h3 class=fn>void <a name="setSelection"></a>QFileDialog::setSelection ( const&nbsp;<a href="qstring.html">QString</a>&nbsp;&amp;&nbsp;filename )
</h3>
设置默认选择为<em>filename</em>。如果<em>filename</em>为绝对的，<a href="#setDir">setDir</a>()也会被调用来设置文件对话框的工作目录为<em>filename</em>中的目录。
<p>实例：<a href="qdir-example.html#x1814">qdir/qdir.cpp</a>。

<h3 class=fn>void <a name="setShowHiddenFiles"></a>QFileDialog::setShowHiddenFiles ( bool&nbsp;s )
</h3>
<p>设置文件对话框中隐藏文件是否被显示为<em>s</em>。详细情况请参考<a href="qfiledialog.html#showHiddenFiles-prop">“showHiddenFiles”</a>属性。

<h3 class=fn>void <a name="setUrl"></a>QFileDialog::setUrl ( const&nbsp;<a href="qurloperator.html">QUrlOperator</a>&nbsp;&amp;&nbsp;url )<tt> [槽]</tt>
</h3>
设置文件对话框的工作目录为<em>url</em>指定的目录。
<p> <p>也可以参考<a href="#url">url</a>()。

<h3 class=fn>void <a name="setViewMode"></a>QFileDialog::setViewMode ( <a href="qfiledialog.html#ViewMode-enum">ViewMode</a>&nbsp;m )
</h3>
<p>设置文件对话框的视图模式为<em>m</em>。详细情况请参考<a href="qfiledialog.html#viewMode-prop">“viewMode”</a>属性。

<h3 class=fn>bool <a name="showHiddenFiles"></a>QFileDialog::showHiddenFiles () const
</h3>
<p>如果文件对话框中隐藏文件被显示，返回真，否则返回假。详细情况请参考<a href="qfiledialog.html#showHiddenFiles-prop">“showHiddenFiles”</a>属性。

<h3 class=fn><a href="qurl.html">QUrl</a> <a name="url"></a>QFileDialog::url () const
</h3>
返回文件对话框中当前工作目录的URL。
<p> <p>也可以参考<a href="#setUrl">setUrl</a>()。
<p>实例：<a href="qdialog.html#x2099">network/networkprotocol/view.cpp</a>。

<h3 class=fn><a href="qfiledialog.html#ViewMode-enum">ViewMode</a> <a name="viewMode"></a>QFileDialog::viewMode () const
</h3>
<p>返回文件对话框的视图模式。详细情况请参考<a href="qfiledialog.html#viewMode-prop">“viewMode”</a>属性。

<hr><h2>属性文档</h2>
<h3 class=fn>bool <a name="contentsPreview-prop"></a>contentsPreview</h3>
<p>这个属性保存的是文件对话框是否提供当前选择文件的内容预览。
<p>默认为假。
<p> <p>也可以参考<a href="#setContentsPreview">setContentsPreview</a>()和<a href="#infoPreview-prop">infoPreview</a>。
<p>通过<a href="#setContentsPreviewEnabled">setContentsPreviewEnabled</a>()设置属性值并且通过<a href="#isContentsPreviewEnabled">isContentsPreviewEnabled</a>()来获得属性值。

<h3 class=fn><a href="qstring.html">QString</a> <a name="dirPath-prop"></a>dirPath</h3>
<p>这个属性保存的是文件对话框的工作目录。
<p>通过<a href="#dirPath">dirPath</a>()来获得属性值。
<p><p>也可以参考<a href="#dir">dir</a>()和<a href="#setDir">setDir</a>()。

<h3 class=fn>bool <a name="infoPreview-prop"></a>infoPreview</h3>
<p>这个属性保存的是文件对话框是否提供当前选择文件的信息预览。
<p>默认为假。
<p>通过<a href="#setInfoPreviewEnabled">setInfoPreviewEnabled</a>()设置属性值并且通过<a href="#isInfoPreviewEnabled">isInfoPreviewEnabled</a>()来获得属性值。

<h3 class=fn><a href="qfiledialog.html#Mode-enum">Mode</a> <a name="mode-prop"></a>mode</h3>
<p>这个属性保存的是文件对话框的模式。
<p>默认模式为<a href="#Mode-enum">ExistingFile</a>。
<p>通过<a href="#setMode">setMode</a>()设置属性值并且通过<a href="#mode">mode</a>()来获得属性值。

<h3 class=fn><a href="qfiledialog.html#PreviewMode-enum">PreviewMode</a> <a name="previewMode-prop"></a>previewMode</h3>
<p>这个属性保存的是文件的对话框的预览模式。
<p>如果你设置这个模式为<em>NoPreview</em>之外的模式，你必须使用<a href="#setInfoPreview">setInfoPreview</a>()或者<a href="#setContentsPreview">setContentsPreview</a>()来设置这个对话框的预览窗口部件为你的预览窗口部件并且使用<a href="#setInfoPreviewEnabled">setInfoPreviewEnabled</a>()或<a href="#setContentsPreviewEnabled">setContentsPreviewEnabled</a>()来让预览窗口部件生效。
<p> <p>也可以参考<a href="#infoPreview-prop">infoPreview</a>、<a href="#contentsPreview-prop">contentsPreview</a>和<a href="#viewMode-prop">viewMode</a>。
<p>通过<a href="#setPreviewMode">setPreviewMode</a>()设置属性值并且通过<a href="#previewMode">previewMode</a>()来获得属性值。

<h3 class=fn><a href="qstring.html">QString</a> <a name="selectedFile-prop"></a>selectedFile</h3>
<p>这个属性保存的是选择的文件的名称。
<p>如果文件被选择，则selectedFile包含文件的名称和它的绝对路径，否则selectedFile为空。
<p> <p>也可以参考<a href="qstring.html#isEmpty">QString::isEmpty</a>()、<a href="#selectedFiles-prop">selectedFiles</a>和<a href="#selectedFilter-prop">selectedFilter</a>。
<p>通过<a href="#selectedFile">selectedFile</a>()来获得属性值。

<h3 class=fn><a href="qstringlist.html">QStringList</a> <a name="selectedFiles-prop"></a>selectedFiles</h3>
<p>这个属性保存的是选择的文件的列表。
<p>如果有一个或多个文件被选择，selectedFiles包含这些文件的名称和它们的绝对路径。如果没有文件被选择或者模式不是ExistingFiles，selectedFiles是一个空列表。
<p> 如果模式为<a href="#Mode-enum">ExistingFile</a>、<a href="#Mode-enum">Directory</a>或<a href="#Mode-enum">DirectoryOnly</a>，使用<a href="#selectedFile">selectedFile</a>()更方便。
<p> 注意，如果你想遍历这个列表，你应该遍历它的复制，例如：
<pre>
    <a href="qstringlist.html">QStringList</a> list = myFileDialog.selectedFiles();
    QStringList::Iterator it = list.<a href="qvaluelist.html#begin">begin</a>();
    while( it != list.<a href="qvaluelist.html#end">end</a>() ) {
        myProcessing( *it );
        ++it;
    }
    </pre>
 
<p> <p>也可以参考<a href="#selectedFile-prop">selectedFile</a>、<a href="#selectedFilter-prop">selectedFilter</a>和<a href="qvaluelist.html#empty">QValueList::empty</a>()。
<p>通过<a href="#selectedFiles">selectedFiles</a>()来获得属性值。

<h3 class=fn><a href="qstring.html">QString</a> <a name="selectedFilter-prop"></a>selectedFilter</h3>
<p>这个属性保存的是文件对话框中用户选择文件的过滤器。
<p>通过<a href="#selectedFilter">selectedFilter</a>()来获得属性值。
<p><p>也可以参考<a href="#filterSelected">filterSelected</a>()、<a href="#selectedFiles-prop">selectedFiles</a>和<a href="#selectedFile-prop">selectedFile</a>。

<h3 class=fn>bool <a name="showHiddenFiles-prop"></a>showHiddenFiles</h3>
<p>这个属性保存的是文件对话框中隐藏文件是否显示。
<p>默认是假，也就是不显示隐藏文件。
<p>通过<a href="#setShowHiddenFiles">setShowHiddenFiles</a>()设置属性值并且通过<a href="#showHiddenFiles">showHiddenFiles</a>()来获得属性值。

<h3 class=fn><a href="qfiledialog.html#ViewMode-enum">ViewMode</a> <a name="viewMode-prop"></a>viewMode</h3>
<p>这个属性保存的是文件对话框的视图模式。
<p>如果你设置视图模式为<em>Detail</em>（默认），那么你将看到文件的详细情况，除了文件名之外，还有文件的大小和这个文件最近一次被修改的日期。
<p> 如果你设置视图模式为<em>List</em>，那么你将只会看到文件和文件夹的列表。
<p> 请参考<a href="#ViewMode-enum">QFileDialog::ViewMode</a>。
<p>通过<a href="#setViewMode">setViewMode</a>()设置属性值并且通过<a href="#viewMode">viewMode</a>()来获得属性值。

<!-- eof -->
<hr><p>
这个文件是<a href="index.html">Qt工具包</a>一部分。
版权所有 &copy; 1995-2002
<a href="http://www.trolltech.com/">Trolltech</a>。保留所有权利。
<p><address><hr><div align=center>
<table width=100% cellspacing=0 border=0><tr>
<td>Copyright &copy; 2002 
<a href="http://www.trolltech.com">Trolltech</a>
<td><a href="http://www.trolltech.com/trademarks.html">Trademarks</a>
<td><a href="zh_CN.html">译者:Cavendish</a>
<td align=right><div align=right>Qt 3.0.5版</div>
</table></div></address></body>
</html>