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)

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

웹 샌드박스가 파일 액세스를 제한하는 경우, 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())

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

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

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

이 함수는 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

필드 대화 상자의 뷰에 항목을 렌더링하는 데 사용되는 항목 델리게이트를 반환합니다.

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 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 유형에 정의된 글로브 패턴과 설명을 기반으로 이름 필터를 생성합니다.

"모든 파일 (*)" 필터에는 application/octet-stream을 사용하십시오. 이는 모든 파일의 기본 MIME 유형이기 때문입니다.

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 가 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도 참조하십시오 .