QFileDialog概述

QFileDialog是Qt框架中提供的文件對話框類，用于讓用戶選擇文件或目錄。它提供了標準的文件選擇界面，支持文件打開、保存、多選等常見操作。

基本使用方式

QFileDialog提供了兩種使用方式：

1. 靜態方法：直接調用類方法快速創建標準對話框

2. 實例化對象：創建QFileDialog對象進行更靈活的定制

1. 靜態方法（推薦）

QFileDialog提供了幾個方便的靜態方法，可以快速創建標準文件對話框：

基本語法

// 打開單個文件
QString fileName = QFileDialog::getOpenFileName(parent,         // 父窗口caption,        // 對話框標題dir,            // 初始目錄filter          // 文件過濾器
);// 打開多個文件
QStringList fileNames = QFileDialog::getOpenFileNames(...);// 保存文件
QString saveName = QFileDialog::getSaveFileName(...);// 選擇目錄
QString dirName = QFileDialog::getExistingDirectory(...);

示例代碼

// 打開單個文本文件
QString fileName = QFileDialog::getOpenFileName(this, tr("打開文件"), "D:/QT/", tr("文本文件 (*.txt);;所有文件 (*)"));// 打開多個圖片文件
QStringList imageFiles = QFileDialog::getOpenFileNames(this,tr("選擇圖片"),"C:/Images",tr("圖片文件 (*.png *.jpg *.bmp);;所有文件 (*)"));// 保存文件
QString savePath = QFileDialog::getSaveFileName(this,tr("保存文檔"),"D:/Documents/untitled.txt",tr("文本文件 (*.txt);;Word文檔 (*.doc)"));// 選擇目錄
QString dirPath = QFileDialog::getExistingDirectory(this,tr("選擇項目目錄"),"D:/Projects");

2. 實例化對象方式

如果需要更復雜的定制，可以創建QFileDialog對象：

QFileDialog dialog(this);
dialog.setFileMode(QFileDialog::AnyFile);  // 設置文件模式
dialog.setNameFilter(tr("Images (*.png *.jpg)")); // 設置過濾器
dialog.setViewMode(QFileDialog::Detail);   // 設置視圖模式if (dialog.exec()) {QStringList files = dialog.selectedFiles();// 處理選擇的文件
}

• 關鍵方法：
  • setFileMode()：設置文件選擇模式（如?QFileDialog::ExistingFile、QFileDialog::ExistingFiles）。
  • setNameFilter()：設置文件過濾器。
  • exec()：顯示對話框并等待用戶操作。
  • selectedFiles()：獲取用戶選擇的文件列表。

核心功能詳解

1. 文件過濾器

文件過濾器用于限制顯示的文件類型，語法為：

"描述1 (*.ext1 *.ext2);;描述2 (*.ext3);;所有文件 (*)"

示例：

// 設置多種過濾器
QString filter = tr("文本文件 (*.txt);;""圖片文件 (*.png *.jpg *.bmp);;""所有文件 (*)");QString fileName = QFileDialog::getOpenFileName(this, tr("打開文件"), "", filter);

2. 文件模式

通過setFileMode()設置對話框模式：

3. 視圖模式

通過setViewMode()設置視圖顯示方式：

4. 其他常用設置

dialog.setAcceptMode(QFileDialog::AcceptSave); // 設置為保存模式
dialog.setDefaultSuffix("txt"); // 設置默認后綴
dialog.setDirectory("D:/Projects"); // 設置初始目錄
dialog.selectFile("default.txt"); // 設置默認選中的文件

注意事項

• 路徑分隔符：Qt使用'/'作為路徑分隔符，即使在Windows上也會自動轉換

• 編碼問題：對話框標題等文本建議使用tr()函數包裹以支持國際化

• 默認目錄：建議使用QStandardPaths獲取標準目錄，如：

QString docsPath = QStandardPaths::writableLocation(QStandardPaths::DocumentsLocation);

• 文件權限：選擇文件后應檢查讀寫權限

• 內存管理：靜態方法創建的對話框由Qt自動管理，無需手動釋放

QFileDialog提供了強大而靈活的文件選擇功能，通過合理使用可以大大簡化Qt應用程序中文件操作相關的UI實現。