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 * 이벤트).

[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 파일 대화 상자는 디렉토리 선택기에 파일을 표시하는 기능을 지원하지 않습니다. DontUseNativeDialog 옵션을 전달하거나 글로벌 \l{Qt::}{AA_DontUseNativeDialogs} 애플리케이션 속성을 설정하여 QFileDialog 을 사용하여 파일을 표시해야 합니다.

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 유형을 제한할 수 있습니다. 이는 애플리케이션이 파일 콘텐츠를 가져오기 위해 지원하는 프로토콜을 선언하는 방법입니다. 빈 목록은 제한이 적용되지 않음을 의미합니다(기본값). 로컬 파일('파일' 체계)에 대한 지원은 암시적이며 항상 활성화되어 있으므로 제한에 포함할 필요가 없습니다.

가능하면 이 정적 함수는 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)

이 함수는 사용자가 선택한 파일의 내용을 반환하는 편리한 정적 함수입니다.

웹 샌드박스가 파일 액세스를 제한하는 경우 이 함수를 사용하여 웹 어셈블리용 Qt에서 로컬 파일에 액세스할 수 있습니다. 이 함수를 구현하면 사용자가 nameFilter 매개 변수를 기반으로 파일을 선택하는 브라우저에 네이티브 파일 대화 상자를 표시할 수 있습니다.

parent 는 웹 어셈블리용 Qt에서는 무시됩니다. 다른 플랫폼에서는 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())

이 함수는 사용자가 선택한 기존 파일을 반환하는 편리한 정적 함수입니다. 사용자가 취소를 누르면 null 문자열을 반환합니다.

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())

이 함수는 사용자가 선택한 하나 이상의 기존 파일을 반환하는 편리한 정적 함수입니다.

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에서 이 대화 상자는 Q타이머를 디스패치하지 않는 차단 모달 이벤트 루프를 돌리며, 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 유형을 제한할 수 있습니다. 이는 애플리케이션이 파일 콘텐츠를 가져오기 위해 지원할 프로토콜을 선언하는 방법입니다. 빈 목록은 제한이 적용되지 않음을 의미합니다(기본값). 로컬 파일('파일' 체계)에 대한 지원은 암시적이며 항상 활성화되어 있으므로 제한에 포함할 필요가 없습니다.

가능하면 이 정적 함수는 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())

이 함수는 사용자가 선택한 하나 이상의 기존 파일을 반환하는 편리한 정적 함수입니다. 사용자가 취소를 누르면 빈 목록을 반환합니다.

이 함수는 QFileDialog::getOpenFileNames()와 유사하게 사용됩니다. 특히 parent, caption, dir, filter, selectedFilter 및 options 는 정확히 같은 방식으로 사용됩니다.

QFileDialog::getOpenFileNames()와의 주요 차이점은 사용자에게 원격 파일을 선택할 수 있는 기능이 제공된다는 점입니다. 그렇기 때문에 반환 유형과 dir 의 유형은 각각 QList<QUrl> 및 QUrl 입니다.

supportedSchemes 인수를 사용하면 사용자가 선택할 수 있는 URL 유형을 제한할 수 있습니다. 이는 애플리케이션이 파일 콘텐츠를 가져오기 위해 지원하는 프로토콜을 선언하는 방법입니다. 빈 목록은 제한이 적용되지 않음을 의미합니다(기본값). 로컬 파일('파일' 체계)에 대한 지원은 암시적이며 항상 활성화되어 있으므로 제한에 포함할 필요가 없습니다.

가능하면 이 정적 함수는 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에서는 필터 인수가 무시됩니다.

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 유형을 제한할 수 있습니다. 이는 애플리케이션이 파일 콘텐츠를 저장하기 위해 지원하는 프로토콜을 선언하는 방법입니다. 빈 목록은 제한이 적용되지 않음을 의미합니다(기본값). 로컬 파일('파일' 체계)에 대한 지원은 암시적이며 항상 활성화되어 있으므로 제한에 포함할 필요가 없습니다.

가능하면 이 정적 함수는 QFileDialog 이 아닌 네이티브 파일 대화 상자를 사용합니다. 원격 파일 선택을 지원하지 않는 플랫폼에서 Qt는 로컬 파일만 선택할 수 있습니다.

getSaveFileName(), getOpenFileUrl(), getOpenFileUrls() 및 getExistingDirectoryUrl()도 참조하십시오 .

QStringList QFileDialog::history() const

파일 로그의 검색 기록을 경로 목록으로 반환합니다.

setHistory()도 참조하세요 .

QAbstractFileIconProvider *QFileDialog::iconProvider() const

파일 로그에서 사용하는 아이콘 공급자를 반환합니다.

setIconProvider()도 참조하세요 .

QAbstractItemDelegate *QFileDialog::itemDelegate() const

파일 로그에서 뷰의 항목을 렌더링하는 데 사용되는 항목 델리게이트를 반환합니다.

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 을 제공하여 사용자에게 파일 이름을 제안할 수 있습니다.

웹 샌드박스가 파일 액세스를 제한하는 경우 이 함수를 사용하여 Qt for WebAssembly의 로컬 파일에 콘텐츠를 저장할 수 있습니다. 이 함수를 구현하면 사용자가 fileNameHint 인수를 기반으로 출력 파일을 지정하는 네이티브 파일 대화 상자를 브라우저에 표시할 수 있습니다.

parent 는 웹 어셈블리용 Qt에서는 무시됩니다. 다른 플랫폼에서는 parent 을 전달하여 팝업을 다른 위젯의 자식으로 만듭니다. 플랫폼이 네이티브 파일 대화 상자를 지원하지 않는 경우, 함수는 QFileDialog 로 돌아갑니다.

이 함수는 비동기식이며 즉시 반환됩니다.

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

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

사용자가 파일 대화 상자에서 선택한 파일의 모형을 반환합니다.

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)

지정된 paths 을 포함하도록 파일 로그의 검색 기록을 설정합니다.

history()도 참조하세요 .

void QFileDialog::setIconProvider(QAbstractFileIconProvider *provider)

파일 로그에서 사용하는 아이콘 공급자를 지정된 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)

파일 로그에 표시된 text 을 지정된 label 으로 설정합니다.

labelText()도 참조하세요 .

void QFileDialog::setMimeTypeFilters(const QStringList &filters)

파일 대화 상자에서 사용되는 filters 을 MIME 유형 목록에서 설정합니다.

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 에 공백으로 구분된 하나 이상의 파일명-와일드카드 패턴이 포함된 괄호 쌍이 포함되어 있으면 괄호 안에 포함된 텍스트만 필터로 사용됩니다. 즉, 이러한 호출은 모두 동일합니다:

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 이미지에는 세 가지 확장자가 있는데, 애플리케이션에서 이러한 파일을 열 수 있는 경우 image/jpeg mime 유형을 필터로 선택하면 모든 확장자를 열 수 있습니다.

nameFilters()도 참조하세요 .

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

on 이 참이면 지정된 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 표시).

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도 참조하세요 .