QFileDialog Class

メンバ関数のドキュメント

QFileDialog::QFileDialog(QWidget *parent, Qt::WindowFlags flags)

指定されたparent とウィジェットflags を使用して、ファイルダイアログを作成します。

[explicit] QFileDialog::QFileDialog(QWidget *parent = nullptr, const QString &caption = QString(), const QString &directory = QString(), const QString &filter = QString())

指定されたparent およびcaption を用いてファイルダイアログを作成し、最初に指定されたdirectory の内容を表示します。ディレクトリの内容は、filter で指定されたセミコロン区切りのフィルタリストを用いてフィルタリングされた上で、ダイアログに表示されます。

[virtual noexcept] QFileDialog::~QFileDialog()

ファイル選択ダイアログを閉じます。

[override virtual protected] void QFileDialog::accept()

QDialog::accept() を再実装します。

[override virtual protected] void QFileDialog::changeEvent(QEvent *e)

QWidget::changeEvent(QEvent *event) を再実装します。

[signal] void QFileDialog::currentChanged(const QString &path)

ローカル操作において現在のファイルが変更された場合、このシグナルが、path パラメータとして新しいファイル名とともに発行されます。

filesSelected()も参照してください 。

[signal] void QFileDialog::currentUrlChanged(const QUrl &url)

現在のファイルが変更されると、このシグナルが、新しいファイルのURLをurl パラメータとして指定して発信されます。

urlsSelected()も参照してください 。

QDir QFileDialog::directory() const

ダイアログに現在表示されているディレクトリを返します。

setDirectory()も参照してください 。

[signal] void QFileDialog::directoryEntered(const QString &directory)

この信号は、ユーザーがdirectory を入力した際に、ローカル操作として発信されます。

QUrl QFileDialog::directoryUrl() const

ダイアログに現在表示されているディレクトリのURLを返します。

setDirectoryUrl()も参照してください 。

[signal] void QFileDialog::directoryUrlEntered(const QUrl &directory)

このシグナルは、ユーザーがdirectory に入力したときに発せられます。

[override virtual protected] void QFileDialog::done(int result)

QDialog::done(int r) を再実装します。

[signal] void QFileDialog::fileSelected(const QString &file)

ローカル操作の選択内容が変更され、ダイアログが確定されると、このシグナルが、（空の場合もある）選択されたfile とともに発信されます。

currentChanged() およびQDialog::Acceptedも参照してください 。

[signal] void QFileDialog::filesSelected(const QStringList &selected)

ローカル操作の選択内容が変更され、ダイアログが確定されると、このシグナルが、selected ファイルのリスト（空の場合もある）とともに発信されます。

currentChanged() およびQDialog::Acceptedも参照してください 。

QDir::Filters QFileDialog::filter() const

ファイルの表示時に使用されるフィルタを返します。

setFilter()も参照してください 。

[signal] void QFileDialog::filterSelected(const QString &filter)

このシグナルは、ユーザーがfilter を選択したときに発せられます。

[static] QString QFileDialog::getExistingDirectory(QWidget *parent = nullptr, const QString &caption = QString(), const QString &dir = QString(), QFileDialog::Options options = ShowDirsOnly)

これは、ユーザーが選択した既存のディレクトリを返す、便利な静的関数です。

QString dir = QFileDialog::getExistingDirectory(this, tr("Open Directory"),
                                                "/home",
                                                QFileDialog::ShowDirsOnly
                                                | QFileDialog::DontResolveSymlinks);

この関数は、指定されたparent ウィジェットを使用してモーダルなファイルダイアログを作成します。parent がnullptr でない場合、ダイアログは親ウィジェットの中央に配置されて表示されます。

ダイアログの作業ディレクトリは `dir` に設定され、キャプションは `caption` に設定されます。これらはいずれも空の文字列に設定可能であり、その場合はそれぞれ現在のディレクトリとデフォルトのキャプションが使用されます。

options 引数には、ダイアログの実行方法に関するさまざまなオプションが格納されます。渡すことができるフラグの詳細については、QFileDialog::Option 列挙型を参照してください。ネイティブのファイルダイアログを確実に表示するには、ShowDirsOnly を設定する必要があります。

Windows および macOS では、この静的関数は `QFileDialog` ではなく、ネイティブのファイルダイアログを使用します。ただし、Windows のネイティブファイルダイアログは、ディレクトリ選択画面でのファイル表示をサポートしていません。QFileDialog を使用してファイルを表示するには、`DontUseNativeDialog ` オプションを指定するか、グローバルな `AA_DontUseNativeDialogs ` アプリケーション属性を設定する必要があります。

なお、macOSのネイティブファイルダイアログにはタイトルバーが表示されません。

Unix/X11 では、ファイルダイアログの通常の動作として、シンボリックリンクが解決され、その先へ移動します。たとえば、/usr/tmp が/var/tmp へのシンボリックリンクである場合、/usr/tmp と入力すると、ファイルダイアログは/var/tmp に切り替わります。options にDontResolveSymlinks が含まれている場合、ファイルダイアログはシンボリックリンクを通常のディレクトリとして扱います。

Windows では、ダイアログは QTimer を一切ディスパッチしないブロッキングなモーダルイベントループを実行し、parent がnullptr でない場合、ダイアログを親ウィンドウのタイトルバーのすぐ下に配置します。

getOpenFileName()、getOpenFileNames()、およびgetSaveFileName()も参照してください 。

[static] QUrl QFileDialog::getExistingDirectoryUrl(QWidget *parent = nullptr, const QString &caption = QString(), const QUrl &dir = QUrl(), QFileDialog::Options options = ShowDirsOnly, const QStringList &supportedSchemes = QStringList())

これは、ユーザーが選択した既存のディレクトリを返す便利な静的関数です。ユーザーが「キャンセル」を押した場合、空のURLを返します。

この関数の使い方は、QFileDialog::getExistingDirectory()と同様です。特に、parent 、caption 、dir 、options は、まったく同じように使用されます。

QFileDialog::getExistingDirectory() との主な違いは、ユーザーがリモートディレクトリを選択できる機能がある点にあります。そのため、dir の戻り値の型はQUrl となります。

supportedSchemes 引数を使用すると、ユーザーが選択できるURLの種類を制限できます。これは、アプリケーションがファイルコンテンツの取得にサポートするプロトコルを宣言するための手段です。 空のリストは、制限が適用されないことを意味します（デフォルト）。ローカルファイル（「file」スキーマ）への対応は暗黙的に行われ、常に有効です。制限に含める必要はありません。

可能な場合、この静的関数は `QFileDialog` ではなく、ネイティブなファイルダイアログを使用します。リモートファイルの選択をサポートしていないプラットフォームでは、Qt ではローカルファイルのみを選択できるようにします。

getExistingDirectory()、getOpenFileUrl()、getOpenFileUrls()、およびgetSaveFileUrl()も参照してください 。

[static] void QFileDialog::getOpenFileContent(const QString &nameFilter, const std::function<void (const QString &, const QByteArray &)> &fileOpenCompleted, QWidget *parent = nullptr)

これは、ユーザーが選択したファイルの内容を返す便利な静的関数です。

Webサンドボックスによってファイルアクセスが制限されている場合、Qt for WebAssembly上でローカルファイルにアクセスするためにこの関数を使用してください。この実装により、ブラウザ上でネイティブなファイルダイアログが表示され、ユーザーはnameFilter パラメータに基づいてファイルを選択できます。

parent は、Qt for WebAssembly では無視されます。他のプラットフォームでは、parent を指定して、ポップアップを別のウィジェットの子にするようにしてください。プラットフォームがネイティブなファイルダイアログをサポートしていない場合、この関数はQFileDialog にフォールバックします。

この関数は非同期であり、即座に返ります。ファイルが選択され、その内容がメモリに読み込まれた時点で、fileOpenCompleted コールバックが呼び出されます。

auto fileContentReady = [](const QString &fileName, const QByteArray &fileContent) {
    if (fileName.isEmpty()) {
        // No file was selected
    } else {
        // Use fileName and fileContent
    }
};
QFileDialog::getOpenFileContent("Images (*.png *.xpm *.jpg)",  fileContentReady);

[static] QString QFileDialog::getOpenFileName(QWidget *parent = nullptr, const QString &caption = QString(), const QString &dir = QString(), const QString &filter = QString(), QString *selectedFilter = nullptr, QFileDialog::Options options = Options())

これは、ユーザーが選択した既存のファイルを返す、便利な静的関数です。ユーザーが「キャンセル」を押した場合は、空文字列を返します。

QString fileName = QFileDialog::getOpenFileName(this, tr("Open File"),
                                                "/home",
                                                tr("Images (*.png *.xpm *.jpg)"));

この関数は、指定されたparent ウィジェットを使用してモーダルなファイルダイアログを作成します。parent がnullptr でない場合、ダイアログは親ウィジェットの中心に表示されます。

ファイルダイアログの作業ディレクトリは、dir に設定されます。dir にファイル名が含まれている場合、そのファイルが選択されます。指定されたfilter に一致するファイルのみが表示されます。選択されたフィルタは、selectedFilter に設定されます。パラメータdir 、selectedFilter 、およびfilter は、空の文字列でも構いません。複数のフィルタを指定する場合は、「;;」で区切ります。例：

"Images (*.png *.xpm *.jpg);;Text files (*.txt);;XML files (*.xml)"

options 引数には、ダイアログの実行方法に関するさまざまなオプションが格納されます。渡すことができるフラグの詳細については、QFileDialog::Option 列挙型を参照してください。

ダイアログのキャプションは `caption` に設定されます。`caption ` が指定されていない場合は、デフォルトのキャプションが使用されます。

Windows および macOS では、この静的関数は `QFileDialog` ではなく、ネイティブのファイルダイアログを使用します。macOS のネイティブファイルダイアログにはタイトルバーが表示されない点に注意してください。

Windows では、このダイアログは QTimer を一切ディスパッチしないブロッキングなモーダルイベントループを実行し、parent がnullptr でない場合、ダイアログは親ウィンドウのタイトルバーのすぐ下に配置されます。

Unix/X11 では、ファイルダイアログの通常の動作として、シンボリックリンクを解決して追跡します。たとえば、/usr/tmp が/var/tmp へのシンボリックリンクである場合、/usr/tmp を入力すると、ファイルダイアログは/var/tmp に切り替わります。options にDontResolveSymlinks が含まれている場合、ファイルダイアログはシンボリックリンクを通常のディレクトリとして扱います。

getOpenFileNames()、getSaveFileName()、およびgetExistingDirectory()も参照してください 。

[static] QStringList QFileDialog::getOpenFileNames(QWidget *parent = nullptr, const QString &caption = QString(), const QString &dir = QString(), const QString &filter = QString(), QString *selectedFilter = nullptr, QFileDialog::Options options = Options())

これは、ユーザーが選択した1つ以上の既存のファイルを返す、便利な静的関数です。

QStringList files = QFileDialog::getOpenFileNames(
                        this,
                        "Select one or more files to open",
                        "/home",
                        "Images (*.png *.xpm *.jpg)");

この関数は、指定されたparent ウィジェットを使用してモーダルなファイルダイアログを作成します。parent がnullptr でない場合、ダイアログは親ウィジェットの中央に配置されて表示されます。

ファイルダイアログの作業ディレクトリは `dir` に設定されます。dir にファイル名が含まれている場合、そのファイルが選択されます。フィルターは `filter ` に設定されるため、フィルターに一致するファイルのみが表示されます。選択されたフィルターは `selectedFilter` に設定されます。パラメータ `dir`、`selectedFilter `、および `filter ` は空の文字列でも構いません。複数のフィルターが必要な場合は、`;;` で区切ってください。例：

"Images (*.png *.xpm *.jpg);;Text files (*.txt);;XML files (*.xml)"

ダイアログのキャプションは `caption` に設定されます。caption が指定されていない場合は、デフォルトのキャプションが使用されます。

Windows および macOS では、この静的関数はQFileDialog ではなく、ネイティブのファイルダイアログを使用します。macOS のネイティブファイルダイアログにはタイトルバーが表示されない点に注意してください。

Windowsでは、このダイアログはQTimerを一切ディスパッチしないブロッキングなモーダルイベントループを実行し、parent がnullptr でない場合、ダイアログを親ウィンドウのタイトルバーのすぐ下に配置します。

Unix/X11 では、ファイルダイアログの通常の動作として、シンボリックリンクを解決して追跡します。たとえば、/usr/tmp が/var/tmp へのシンボリックリンクである場合、/usr/tmp と入力すると、ファイルダイアログは/var/tmp に切り替わります。options 引数には、ダイアログの実行方法に関するさまざまなオプションが指定されます。渡すことができるフラグの詳細については、QFileDialog::Option 列挙型を参照してください。

getOpenFileName()、getSaveFileName()、およびgetExistingDirectory()も参照してください 。

[static] QUrl QFileDialog::getOpenFileUrl(QWidget *parent = nullptr, const QString &caption = QString(), const QUrl &dir = QUrl(), const QString &filter = QString(), QString *selectedFilter = nullptr, QFileDialog::Options options = Options(), const QStringList &supportedSchemes = QStringList())

これは、ユーザーが選択した既存のファイルを返す、便利な静的関数です。ユーザーが「キャンセル」を押した場合は、空のURLを返します。

この関数の使い方は、QFileDialog::getOpenFileName()と似ています。特に、parent 、caption 、dir 、filter 、selectedFilter 、options は、まったく同じ方法で使用されます。

QFileDialog::getOpenFileName() との主な違いは、ユーザーがリモートファイルを選択できる機能がある点にあります。そのため、dir の戻り値の型はQUrl となります。

supportedSchemes 引数を使用すると、ユーザーが選択できるURLの種類を制限できます。これは、アプリケーションがファイルコンテンツの取得にサポートするプロトコルを宣言するための手段です。 空のリストは、制限が適用されないことを意味します（デフォルト）。ローカルファイル（「file」スキーマ）への対応は暗黙的にサポートされており、常に有効です。制限に含める必要はありません。

可能な場合、この静的関数は `QFileDialog` ではなく、ネイティブのファイルダイアログを使用します。リモートファイルの選択をサポートしていないプラットフォームでは、Qt はローカルファイルのみの選択を許可します。

getOpenFileName()、getOpenFileUrls()、getSaveFileUrl()、およびgetExistingDirectoryUrl()も参照してください 。

[static] QList<QUrl> QFileDialog::getOpenFileUrls(QWidget *parent = nullptr, const QString &caption = QString(), const QUrl &dir = QUrl(), const QString &filter = QString(), QString *selectedFilter = nullptr, QFileDialog::Options options = Options(), const QStringList &supportedSchemes = QStringList())

これは、ユーザーが選択した1つ以上の既存のファイルを返す、便利な静的関数です。ユーザーが「キャンセル」を押した場合、空のリストを返します。

この関数の使い方は、QFileDialog::getOpenFileNames()と似ています。特に、parent 、caption 、dir 、filter 、selectedFilter 、options は、まったく同じように使用されます。

QFileDialog::getOpenFileNames() との主な違いは、ユーザーがリモートファイルを選択できる機能がある点にあります。そのため、dir の戻り値の型と型は、それぞれQList<QUrl> およびQUrl となります。

supportedSchemes 引数を使用すると、ユーザーが選択できるURLの種類を制限できます。これは、アプリケーションがファイルコンテンツの取得にサポートするプロトコルを宣言するための手段です。 空のリストは、制限が適用されないことを意味します（デフォルト）。ローカルファイル（「file」スキーム）への対応は暗黙的にサポートされており、常に有効です。制限に含める必要はありません。

可能な場合、この静的関数は `QFileDialog` ではなく、ネイティブのファイルダイアログを使用します。リモートファイルの選択をサポートしていないプラットフォームでは、Qt はローカルファイルのみの選択を許可します。

getOpenFileNames()、getOpenFileUrl()、getSaveFileUrl()、およびgetExistingDirectoryUrl()も参照してください 。

[static] QString QFileDialog::getSaveFileName(QWidget *parent = nullptr, const QString &caption = QString(), const QString &dir = QString(), const QString &filter = QString(), QString *selectedFilter = nullptr, QFileDialog::Options options = Options())

これは、ユーザーが選択したファイル名を返す便利な静的関数です。ファイルは存在していなくても構いません。

指定されたparent ウィジェットを使用して、モーダル形式のファイルダイアログを作成します。parent がnullptr でない場合、ダイアログは親ウィジェットの中央に配置されて表示されます。

QString fileName = QFileDialog::getSaveFileName(this, tr("Save File"),
                                                "/home/jana/untitled.png",
                                                tr("Images (*.png *.xpm *.jpg)"));

ファイルダイアログの作業ディレクトリは、dir に設定されます。dir にファイル名が含まれている場合、そのファイルが選択されます。filter に一致するファイルのみが表示されます。選択されたフィルタは、selectedFilter に設定されます。パラメータdir 、selectedFilter 、およびfilter は空の文字列でも構いません。複数のフィルタは「;;」で区切られます。例えば：

"Images (*.png *.xpm *.jpg);;Text files (*.txt);;XML files (*.xml)"

options 引数には、ダイアログの実行方法に関するさまざまなオプションが含まれています。渡すことができるフラグの詳細については、QFileDialog::Option 列挙型を参照してください。

selectedFilter を適切な値に設定することで、デフォルトのフィルタを選択できます。

ダイアログのキャプションは `caption` に設定されます。`caption ` が指定されていない場合は、デフォルトのキャプションが使用されます。

Windows および macOS では、この静的関数はQFileDialog ではなく、ネイティブのファイルダイアログを使用します。

Windows では、ダイアログは QTimer を一切ディスパッチしないブロッキングなモーダルイベントループを実行し、parent がnullptr でない場合は、ダイアログを親ウィンドウのタイトルバーのすぐ下に配置します。macOS では、ネイティブのファイルダイアログが使用されるため、filter 引数は無視されます。

Unix/X11では、ファイルダイアログの通常の動作として、シンボリックリンクを解決して追跡します。例えば、/usr/tmp が/var/tmp へのシンボリックリンクである場合、/usr/tmp を入力すると、ファイルダイアログは/var/tmp に切り替わります。options にDontResolveSymlinks が含まれている場合、ファイルダイアログはシンボリックリンクを通常のディレクトリとして扱います。

getOpenFileName()、getOpenFileNames()、およびgetExistingDirectory()も参照してください 。

[static] QUrl QFileDialog::getSaveFileUrl(QWidget *parent = nullptr, const QString &caption = QString(), const QUrl &dir = QUrl(), const QString &filter = QString(), QString *selectedFilter = nullptr, QFileDialog::Options options = Options(), const QStringList &supportedSchemes = QStringList())

これは、ユーザーが選択したファイルを返す便利な静的関数です。ファイルは存在していなくてもかまいません。ユーザーが「キャンセル」を押した場合、空のURLを返します。

この関数の使い方は、QFileDialog::getSaveFileName()と同様です。特に、parent 、caption 、dir 、filter 、selectedFilter 、options は、まったく同じように使用されます。

QFileDialog::getSaveFileName() との主な違いは、ユーザーがリモートファイルを選択できる機能がある点にあります。そのため、dir の戻り値の型はQUrl となります。

supportedSchemes 引数を使用すると、ユーザーが選択できるURLの種類を制限できます。これは、アプリケーションがファイルの内容を保存するためにサポートするプロトコルを宣言する方法です。 空のリストは、制限が適用されないことを意味します（デフォルト）。ローカルファイル（「file」スキーマ）への対応は暗黙的にサポートされており、常に有効です。制限に含める必要はありません。

可能な場合、この静的関数は `QFileDialog` ではなく、ネイティブのファイルダイアログを使用します。リモートファイルの選択をサポートしていないプラットフォームでは、Qt はローカルファイルのみの選択を許可します。

getSaveFileName()、getOpenFileUrl()、getOpenFileUrls()、およびgetExistingDirectoryUrl()も参照してください 。

QStringList QFileDialog::history() const

filedialog の閲覧履歴をパスのリストとして返します。

setHistory()も参照してください 。

QAbstractFileIconProvider *QFileDialog::iconProvider() const

filedialog で使用されているアイコンプロバイダを返します。

setIconProvider()も参照してください 。

QAbstractItemDelegate *QFileDialog::itemDelegate() const

filedialog内のビューで項目をレンダリングするために使用される項目デリゲートを返します。

setItemDelegate()も参照してください 。

QString QFileDialog::labelText(QFileDialog::DialogLabel label) const

指定されたlabel でファイルダイアログに表示されるテキストを返します。

setLabelText()も参照してください 。

QStringList QFileDialog::mimeTypeFilters() const

このファイルダイアログで有効になっているMIMEタイプフィルターを返します。

setMimeTypeFilters()も参照してください 。

QStringList QFileDialog::nameFilters() const

このファイルダイアログで有効になっているファイルタイプのフィルタを返します。

setNameFilters()も参照してください 。

void QFileDialog::open(QObject *receiver, const char *member)

この関数はダイアログを表示し、receiver およびmember で指定されたスロットを、選択状態の変化を通知するシグナルに接続します。fileMode がExistingFiles の場合、これはfilesSelected()シグナルとなり、それ以外の場合はfileSelected()シグナルとなります。

ダイアログが閉じられると、このシグナルはスロットから切断されます。

QAbstractProxyModel *QFileDialog::proxyModel() const

ファイルダイアログで使用されるプロキシモデルを返します。デフォルトでは、プロキシは設定されていません。

setProxyModel()も参照してください 。

bool QFileDialog::restoreState(const QByteArray &state)

ダイアログのレイアウト、履歴、および現在のディレクトリを、指定されたstate の状態に復元します。

通常、これは `QSettings ` と組み合わせて使用され、過去のセッションのサイズを復元します。

エラーが発生した場合は、false を返します。

[static] void QFileDialog::saveFileContent(const QByteArray &fileContent, const QString &fileNameHint, QWidget *parent = nullptr)

これは、ユーザーが指定したファイル名と保存先を使用して、fileContent をファイルに保存するための便利な静的関数です。fileNameHint を指定することで、ユーザーにファイル名を提案することができます。

Webサンドボックスによってファイルアクセスが制限されている場合、Qt for WebAssembly上でコンテンツをローカルファイルに保存するには、この関数を使用してください。この関数を実装することで、ブラウザにネイティブなファイルダイアログを表示できるようになり、ユーザーはfileNameHint 引数に基づいて出力ファイルを指定できます。

parent Qt for WebAssembly では無視されます。他のプラットフォームでは、parent を渡すことで、ポップアップを別のウィジェットの子として表示できます。プラットフォームがネイティブなファイルダイアログをサポートしていない場合、この関数はQFileDialog にフォールバックします。

この関数は非同期であり、即座に返ります。

QByteArray imageData; // obtained from e.g. QImage::save()
QFileDialog::saveFileContent(imageData, "myimage.png");

QByteArray QFileDialog::saveState() const

ダイアログのレイアウト、履歴、および現在のディレクトリの状態を保存します。

通常、これはQSettings と組み合わせて使用され、次回のセッションのためにサイズを記憶するために用いられます。データの一部としてバージョン番号が保存されます。

void QFileDialog::selectFile(const QString &filename)

ファイルダイアログで、指定されたfilename を選択します。

selectedFiles()も参照してください 。

void QFileDialog::selectMimeTypeFilter(const QString &filter)

現在のMIMEタイプをfilter に設定します。

void QFileDialog::selectNameFilter(const QString &filter)

現在のファイルタイプをfilter に設定します。filter には、セミコロンまたはスペースで区切ることで、複数のフィルターを渡すことができます。

setNameFilter()、setNameFilters()、およびselectedNameFilter()も参照してください 。

void QFileDialog::selectUrl(const QUrl &url)

ファイルダイアログで、指定されたurl を選択します。

selectedUrls()も参照してください 。

QStringList QFileDialog::selectedFiles() const

ダイアログで選択されたファイルの絶対パスを含む文字列のリストを返します。ファイルが選択されていない場合、またはモードが `ExistingFiles ` または `ExistingFile` でない場合、`selectedFiles()` にはビューポート内の現在のパスが含まれます。

selectedNameFilter() およびselectFile()も参照してください 。

QString QFileDialog::selectedMimeTypeFilter() const

ファイルダイアログでユーザーが選択したファイルのMIMEタイプを返します。

QString QFileDialog::selectedNameFilter() const

ファイルダイアログでユーザーが選択したフィルターを返します。

selectedFiles()も参照してください 。

QList<QUrl> QFileDialog::selectedUrls() const

ダイアログで選択されたファイルを含む URL のリストを返します。ファイルが選択されていない場合、またはモードが `ExistingFiles ` または `ExistingFile` でない場合、`selectedUrls()` にはビューポート内の現在のパスが含まれます。

selectedNameFilter() およびselectUrl()も参照してください 。

void QFileDialog::setDirectory(const QString &directory)

ファイルダイアログの現在の「directory 」を設定します。

directory()も参照してください 。

void QFileDialog::setDirectory(const QDir &directory)

void QFileDialog::setDirectoryUrl(const QUrl &directory)

ファイルダイアログの現在のdirectory のURLを設定します。

directoryUrl() およびQUuidも参照してください 。

void QFileDialog::setFilter(QDir::Filters filters)

モデルが使用するフィルタを「filters 」に設定します。このフィルタは、表示すべきファイルの種類を指定するために使用されます。

filter()も参照してください 。

void QFileDialog::setHistory(const QStringList &paths)

filedialogの閲覧履歴に、指定されたpaths を含めるように設定します。

history()も参照してください 。

void QFileDialog::setIconProvider(QAbstractFileIconProvider *provider)

filedialog で使用されるアイコンプロバイダを、指定されたprovider に設定します。

iconProvider()も参照してください 。

void QFileDialog::setItemDelegate(QAbstractItemDelegate *delegate)

ファイルダイアログ内のビューでアイテムをレンダリングするために使用されるアイテムデリゲートを、指定されたdelegate に設定します。

既存のデリゲートはすべて削除されますが、破棄されることはありません。QFileDialog はdelegate の所有権を取得しません。

なお、使用されるモデルは `QFileSystemModel` です。これにはカスタムアイテムデータロールがあり、これは `Roles ` 列挙型で定義されています。カスタムアイコンのみが必要な場合は、`QFileIconProvider ` を使用できます。

itemDelegate()、setIconProvider()、およびQFileSystemModelも参照してください 。

void QFileDialog::setLabelText(QFileDialog::DialogLabel label, const QString &text)

指定されたlabel で、ファイルダイアログに表示されるtext を設定します。

labelText()も参照してください 。

void QFileDialog::setMimeTypeFilters(const QStringList &filters)

MIMEタイプのリストから、ファイルダイアログで使用されるfilters を設定します。

setNameFilters() の便宜的なメソッドです。QMimeType を使用して、各 MIME タイプで定義されたグロブパターンと説明から名前フィルターを作成します。

「すべてのファイル (*)」フィルタには、すべてのファイルのベース MIME タイプである application/octet-stream を使用してください。

setMimeTypeFilters を呼び出すと、以前に設定された名前フィルターはすべて上書きされ、nameFilters() の戻り値が変更されます。

QStringList mimeTypeFilters({"image/jpeg", // will show "JPEG image (*.jpeg *.jpg *.jpe)
                             "image/png",  // will show "PNG image (*.png)"
                             "application/octet-stream" // will show "All files (*)"
                            });

QFileDialog dialog(this);
dialog.setMimeTypeFilters(mimeTypeFilters);
dialog.exec();

mimeTypeFilters()も参照してください 。

void QFileDialog::setNameFilter(const QString &filter)

ファイルダイアログで使用されるフィルタを、指定されたfilter に設定します。

filter に、スペースで区切られた 1 つ以上のファイル名ワイルドカードパターンを含む括弧のペアが含まれている場合、フィルターとして使用されるのは括弧内のテキストのみとなります。つまり、以下の呼び出しはすべて同等です:

dialog.setNameFilter("All C++ files (*.cpp *.cc *.C *.cxx *.c++)");
dialog.setNameFilter("*.cpp *.cc *.C *.cxx *.c++");

setMimeTypeFilters() およびsetNameFilters()も参照してください 。

void QFileDialog::setNameFilters(const QStringList &filters)

ファイルダイアログで使用されるfilters を設定します。

なお、フィルター「*.*」は移植性がありません。これは、ファイル拡張子がファイルの種類を決定するという従来の前提が、すべてのオペレーティングシステムで一貫しているわけではないためです。ファイル名にドットが含まれていないファイル（例：Makefile ）が存在する可能性があります。 ネイティブの Windows ファイルダイアログでは、*.*はそのようなファイルに一致しますが、他の種類のファイルダイアログでは一致しない場合があります。したがって、任意のファイルを選択したい場合は、*を使用することをお勧めします。

const QStringList filters({"Image files (*.png *.xpm *.jpg)",
                           "Text files (*.txt)",
                           "Any files (*)"
                          });
QFileDialog dialog(this);
dialog.setNameFilters(filters);
dialog.exec();

setMimeTypeFilters() には、各ファイルタイプに対して考えられるすべての名前フィルターを提供できるという利点があります。たとえば、JPEG 画像には 3 種類の拡張子があります。アプリケーションがそのようなファイルを開くことができる場合、フィルターとしてimage/jpeg という MIME タイプを選択すれば、それらすべてを開くことができます。

nameFilters()も参照してください 。

void QFileDialog::setOption(QFileDialog::Option option, bool on = true)

on がtrueの場合、指定されたoption を有効に設定します。そうでない場合は、指定されたoption をクリアします。

オプション（特にDontUseNativeDialog オプション）は、ダイアログのプロパティを変更したり、ダイアログを表示したりする前に設定しておく必要があります。

ダイアログが表示されている間にオプションを設定しても、その設定がダイアログに即座に反映されるとは限りません（オプションやプラットフォームによって異なります）。

他のプロパティを変更した後にオプションを設定すると、これらの値が反映されない場合があります。

options およびtestOption()も参照してください 。

void QFileDialog::setProxyModel(QAbstractProxyModel *proxyModel)

ビューのモデルを、指定されたproxyModel に設定します。これは、基となるモデルを変更したい場合（たとえば、列の追加、データのフィルタリング、ドライブの追加など）に便利です。

既存のプロキシモデルは削除されますが、ファイル自体は削除されません。ファイルダイアログがproxyModel の所有権を取得します。

proxyModel()も参照してください 。

void QFileDialog::setSidebarUrls(const QList<QUrl> &urls)

サイドバーに表示される「urls 」を設定します。

例：

QList<QUrl> urls;
urls << QUrl::fromLocalFile("/Users/foo/Code/qt5")
     << QUrl::fromLocalFile(QStandardPaths::standardLocations(QStandardPaths::MusicLocation).first());

QFileDialog dialog;
dialog.setSidebarUrls(urls);
dialog.setFileMode(QFileDialog::AnyFile);
if (dialog.exec()) {
    // ...
}

その場合、ファイルダイアログは次のようになります：

「sidebarUrls()」も参照してください 。

[override virtual] void QFileDialog::setVisible(bool visible)

QDialog::setVisible （bool visible）を再実装します。

QList<QUrl> QFileDialog::sidebarUrls() const

現在サイドバーに表示されているURLのリストを返します

setSidebarUrls()も参照してください 。

bool QFileDialog::testOption(QFileDialog::Option option) const

指定されたoption が有効な場合はtrue を返し、そうでない場合はfalseを返します。

options およびsetOption()も参照してください 。

[signal] void QFileDialog::urlSelected(const QUrl &url)

選択内容が変更され、ダイアログが確定されると、このシグナルが、（空の場合もある）選択されたurl とともに発信されます。

currentUrlChanged() およびQDialog::Acceptedも参照してください 。

[signal] void QFileDialog::urlsSelected(const QList<QUrl> &urls)

選択内容が変更され、ダイアログが確定されると、このシグナルが、選択されたurls のリスト（空の場合もある）とともに発信されます。

currentUrlChanged() およびQDialog::Acceptedも参照してください 。