Qtの基礎 - ダイアログ

提供：MochiuWiki - SUSE, Electronic Circuit, PCB
2021年1月27日 (水) 13:58時点におけるWiki (トーク | 投稿記録)による版
ナビゲーションに移動 検索に移動

概要



ダイアログの種類

下表に、Qtにおいて、標準で存在するダイアログの種類を示す。

用途 クラス名
ファイル・ディレクトリ選択 QFileDialog
色選択 QFontDialog
インプットボックス QInputDialog
プログレスバー QProgressDialog
印刷関連 QPrintDialog
メッセージボックス QMessageBox



ファイル・ディレクトリ選択ダイアログ

QFileDialogクラス

下表に、用途別にQFileDialogのメソッドを示す。

メソッド 用途 戻り値
getOpenFileName ローカルファイル選択(開く) QString
getOpenFileNames 複数ローカルファイル選択(開く) QStringList
getOpenFileUrl リモートファイル選択(開く) QUrl
getOpenFileUrls 複数リモートファイル選択(開く) QList<QUrl>
getSaveFileName ローカルファイル選択(保存) QString
getSaveFileUrl リモートファイル選択(保存) QUrl
getExistingDirectory ローカルフォルダ選択 QString
getExistingDirectoryUrl リモートフォルダ選択 QUrl


フィルタを指定すると、拡張子で絞ってファイルを表示することができる。

# 書式フォーマット
[書式];;見出し(拡張子1 拡張子2 ...) [;;見出し(拡張子1 ...)]

# 例
すべて(*.*);;音声(*.wav *.wma *.mp3);;動画(*.wmv *.avi)


下表に、QFileDialogクラスのオプションを示す。(enum QFileDialog::Option)

定義 値 説明
ShowDirsOnly 0x00000001 フォルダのみ表示する。
(FileModeがDirectoryの時に有効)
DontResolveSymlinks 0x00000002 シンボリックリンクを解釈しない。
(指定しない場合、解釈する)
DontConfirmOverwrite 0x00000004 既存ファイル選択時に確認画面を表示しない。
(指定しない場合、表示する)
DontUseNativeDialog 0x00000010 OS標準のダイアログを使用しない。
(指定しない場合、使用する)
ReadOnly 0x00000020 ReadOnlyを表示する。
HideNameFilterDetails 0x00000040 ファイル名フィルタの詳細が隠されているか示す。
DontUseCustomDirectoryIcons 0x00000080 ディレクトリのアイコンは常に標準のものを使用する。
ただし、カスタムアイコンを使用すると負荷が大きいため、
ディレクトリのアイコンは常に標準のものを使用した方がよい。


※注意
シンボリックリンク(ショートカット)を選択しても、ディレクトリ欄には表示されない。

また、DontResolveSymlinksを指定すると、シンボリックリンク(ショートカット)を選択した場合、エラーメッセージを出力する。
指定しない場合、シンボリックリンク(ショートカット)を解釈するため、リンク先のファイルまたはディレクトリを選択したことになる。

ファイル選択ダイアログ

ファイルを開く(getOpenFileNameメソッド)

ファイルとディレクトリの一覧を表示する。
getOpenFileNameメソッドは、ファイルを1つ選択できる。

# 書式フォーマット
[書式] 親, タイトル, パス, フィルター, 選択フィルタ, オプション


以下の例では、初期表示のパスを/home/<ユーザ名>、フィルタを2番目のフィルタ(*.txt)として表示する。
getOpenFileNameメソッドの戻り値には、選択したファイル名がフルパスで代入される。(キャンセルした場合、空文字が代入される)
変数SelFilterには、初期に選択するフィルターが入る。(キャンセルした場合、元のままになる)

 QString SelFilter = tr("テキスト(*.txt)");
 QString FileName = QFileDialog::getOpenFileName(this, tr("ファイルを開く"), "~/", tr("すべて(*.*);;テキスト(*.txt);;ソース(*.h *.cpp)"),
                                                 &SelFilter, QFileDialog::DontUseCustomDirectoryIcons);
 
 if(FileName.isEmpty())
 {  // キャンセル
    // キャンセル処理を記述
 }


また、引数を全て省略する場合、標準のダイアログが表示される。
標準のダイアログとは、タイトルは"開く"、初期表示のパスは"実行ファイルが存在するディレクトリ"となる。
また、フィルタ欄は表示されない。

 QString fileName = QFileDialog::getOpenFileName();


名前を付けて保存(getSaveFileNameメソッド)

getSaveFileNameメソッドを使用して、ファイルを1つ保存することができる。
既に同じ名前のファイルが存在する場合、上書きの確認メッセージが表示される。

[書式] getSaveFileName(親ウインドウのポインタ, ダイアログのタイトル, 初期表示のパス, フィルタ, 選択フィルタ, オプション)


パスに.(カレントディレクトリ)を指定する時、実行ファイルが存在するディレクトリを表示する。
getSaveFileNameメソッドの戻り値は、選択したファイル名のフルパスである。(キャンセルした場合、空文字となる)
選択フィルタ(下例では、変数SelFilter)には、選択したフィルタが代入される。(キャンセルした場合、元のままとなる)
選択フィルタ(下例では、変数SelFilter)を指定しない場合、フィルタの初期表示はフィルタの1つ目の要素(下例では、*.tif *.tiff)となる。

 QString SelFilter = "";
 QString FileName = QFileDialog::getSaveFileName(this, tr("名前を付けて保存"), ".", 
                                                 tr("TIFF image document(*.tif *.tiff);;Portable network graphic(*.png)"),
                                                 &SelFilter, QFileDialog::DontUseCustomDirectoryIcons);
 if(FileName.isEmpty())
 {  // キャンセル
    // キャンセル処理を記述
 }


getSaveFileNameメソッドの引数を全て省略する時、標準のダイアログが表示される。
この時、ダイログのタイトルは"名前を付けて保存"、初期表示のパスは"実行ファイルが存在するディレクトリ"となる。
また、フィルタ欄と既存ファイルの上書き確認メッセージは表示される。

 QString FileName = QFileDialog::getSaveFileName();


ディレクトリ選択ダイアログ(getExistingDirectoryメソッド)

getExistingDirectoryメソッドを使用して、ディレクトリの一覧を表示する。
ディレクトリを1つ選択することができる。

# 書式フォーマット
[書式] getExistingDirectory(親ウインドウのポインタ, ダイアログのタイトル, 初期表示のパス, オプション)


QFileDialog::Optionsにおいて、ShowDirsOnlyを指定することで、ディレクトリのみ表示することができる。
getExistingDirectoryメソッドの戻り値は、選択したディレクトリ名のフルパスである。(キャンセルした場合、空文字となる)
また、以下のメッセージに対応するため、オプションにHideNameFilterDetailsを指定する。 

selectNameFilter: Invalid parameter 'Directories' not found in 'All Files (*)'.



 QFileDialog::Options options = QFileDialog::ShowDirsOnly | QFileDialog::HideNameFilterDetails | QFileDialog::DontUseCustomDirectoryIcons;
 QString DirName = QFileDialog::getExistingDirectory(this, tr("ディレクトリの選択"), "~/", options);
 
 if(DirName.isEmpty())
 {  // キャンセル
    // キャンセル処理を記述
 }


また、オプションにDontUseNativeDialogを指定する時、下図に示すダイアログが表示される。


getExistingDirectoryメソッドの引数を全て省略する場合、標準のダイアログが表示される。
この時、タイトルは"フォルダーの選択"、初期表示のパスは"実行ファイルが存在するディレクトリ"となる。

 QString DirName = QFileDialog::getExistingDirectory();



モーダルダイアログ

 // mainwindow.cpp
 void MainWindow::OnBtnClicked()
 {
    ModalDialog ModalDlg;
    ModalDlg.setModal(true);
    ModalDlg.exec();
 }



モードレスダイアログ

 // mainwindow.h
 
 #ifndef MAINWINDOW_H
 #define MAINWINDOW_H
 
 #include <QMainWindow>
 #include "ModelessDialog.h"
 
 namespace Ui
 {
    class MainWindow;
 }
 
 class MainWindow : public QMainWindow
 {
    Q_OBJECT
 
 public:
    explicit MainWindow(QWidget *parent = 0);
    ~MainWindow();
 
 private slots:
    void on_pushButton_clicked();
 
 private:
    Ui::MainWindow *ui;
    std::unique_ptr<ModelessDialog> ModelessDlg;
 };
 
 #endif // MAINWINDOW_H



 // mainwindow.cpp
 
 void MainWindow::OnBtnClicked()
 {
    ModelessDlg = std::make_unique<ModelessDialog>(this);
    ModelessDlg->show();
 }



「https://mochiuwiki.one/index.php?title=Qtの基礎_-_ダイアログ&oldid=2836」から取得