FileDialog QML Type
파일 대화상자입니다. 자세히...
Import Statement: | import QtQuick.Dialogs |
Since: | Qt 6.2 |
Inherits: |
속성
- acceptLabel : string
- currentFolder : url
- defaultSuffix : string
- fileMode : enumeration
- nameFilters : list<string>
- options : flags
- rejectLabel : string
- selectedFile : url
- selectedFiles : list<url>
- selectedNameFilter
- selectedNameFilter.extensions : list<string>
- selectedNameFilter.globs : list<string>
- selectedNameFilter.index : int
- selectedNameFilter.name : string
상세 설명
FileDialog 유형은 파일 대화 상자를 위한 QML API를 제공합니다.
파일 대화 상자를 표시하려면 FileDialog의 인스턴스를 만들고 원하는 속성을 설정한 다음 open()를 호출합니다. currentFolder 속성은 대화 상자가 열리는 폴더를 결정하는 데 사용할 수 있습니다. selectedFile 및 selectedFiles 속성은 대화 상자가 열릴 때 선택되는 파일을 결정하는 데 사용할 수 있으며, 사용자가 대화 상자에서 파일을 선택할 때와 대화 상자가 수락될 때에도 업데이트됩니다.
import QtCore import QtQuick import QtQuick.Controls import QtQuick.Dialogs ApplicationWindow { width: 640 height: 480 visible: true header: ToolBar { Button { text: qsTr("Choose Image...") onClicked: fileDialog.open() } } Image { id: image anchors.fill: parent fillMode: Image.PreserveAspectFit } FileDialog { id: fileDialog currentFolder: StandardPaths.standardLocations(StandardPaths.PicturesLocation)[0] onAccepted: image.source = selectedFile } }
사용 가능성
기본 플랫폼 파일 대화 상자는 현재 다음 플랫폼에서 사용할 수 있습니다:
- Android
- iOS
- Linux(GTK+ 플랫폼 테마로 실행하는 경우)
- macOS
- Windows
Qt Quick Dialogs 는 기본 구현이 없는 플랫폼의 경우 Qt Quick 구현을 폴백으로 사용합니다.
FolderDialog 및 StandardPaths 을참조하세요 .
속성 문서
acceptLabel : string |
이 속성은 대화 상자를 수락하는 버튼에 표시되는 레이블 텍스트를 보유합니다.
빈 문자열로 설정하면 기본 플랫폼의 기본 레이블이 사용됩니다. 기본 레이블은 일반적으로 대화 상자가 사용되는 fileMode 에 따라 Open 또는 Save 입니다.
기본값은 빈 문자열입니다.
rejectLabel 를참조하세요 .
currentFolder : url |
이 속성은 파일이 선택된 폴더를 보유합니다. 대화 상자가 열릴 때 표시되는 초기 디렉터리를 제어하도록 설정할 수 있습니다.
폴더를 선택하려면 FolderDialog 을 대신 사용합니다.
defaultSuffix : string |
이 속성에는 접미사가 지정되지 않은 선택된 파일에 추가되는 접미사가 저장됩니다. 접미사는 일반적으로 파일 유형을 나타내는 데 사용됩니다(예: "txt"는 텍스트 파일을 나타냄).
첫 번째 문자가 점('.')이면 제거됩니다.
fileMode : enumeration |
이 속성은 대화 상자의 모드를 유지합니다.
사용 가능한 값은 다음과 같습니다:
Constant | 설명 |
---|---|
FileDialog.OpenFile | 이 대화 상자는 기존 파일을 선택하는 데 사용됩니다(기본값). |
FileDialog.OpenFiles | 이 대화 상자는 여러 개의 기존 파일을 선택하는 데 사용됩니다. |
FileDialog.SaveFile | 이 대화 상자는 파일을 선택하는 데 사용됩니다. 파일이 존재하지 않아도 됩니다. |
이 속성에는 선택할 수 있는 파일 유형을 제한하는 필터가 있습니다.
FileDialog { nameFilters: ["Text files (*.txt)", "HTML files (*.html *.htm)"] }
플랫폼마다 선택할 수 있는 파일을 다른 방식으로 제한할 수 있습니다. 예를 들어 macOS에서는 필터와 일치하지 않는 파일 항목이 비활성화되는 반면, Windows에서는 해당 파일이 숨겨집니다.
참고: *.*는 파일 확장자가 파일 유형을 결정한다는 과거의 가정이 모든 운영 체제에서 일관되지 않기 때문에 이식 가능한 필터가 아닙니다. 이름에 점이 없는 파일(예: Makefile
)도 있을 수 있습니다. 기본 Windows 파일 대화 상자에서는 *.*가 이러한 파일과 일치하지만 다른 유형의 파일 대화 상자에서는 일치하지 않을 수 있습니다. 따라서 파일을 선택하려면 *를 사용하는 것이 좋습니다.
selectedNameFilter 를참조하세요 .
options : flags |
이 속성에는 대화 상자의 모양과 느낌에 영향을 주는 다양한 옵션이 있습니다.
기본적으로 모든 옵션은 비활성화되어 있습니다.
대화 상자를 표시하기 전에 옵션을 설정해야 합니다. 대화 상자가 표시된 상태에서 옵션을 설정해도 옵션 및 플랫폼에 따라 대화 상자에 즉각적인 영향을 미치지는 않습니다.
사용 가능한 옵션
상수 | 설명 |
---|---|
FileDialog.DontResolveSymlinks | 파일 대화 상자에서 심볼릭 링크를 확인하지 않습니다. 기본적으로 심볼릭 링크가 확인됩니다. |
FileDialog.DontConfirmOverwrite | 기존 파일이 선택된 경우 확인을 요청하지 않습니다. 기본적으로 확인을 요청합니다. |
FileDialog.ReadOnly | 대화 상자에서 디렉터리 생성을 허용하지 않음을 나타냅니다. |
FileDialog.HideNameFilterDetails | 파일 이름 필터 세부 정보를 숨길지 여부를 나타냅니다. |
FileDialog.DontUseNativeDialog | 대화 상자가 기본이 아닌 빠른 구현을 사용하도록 강제합니다. |
rejectLabel : string |
이 속성은 대화 상자를 거부하는 버튼에 표시되는 레이블 텍스트를 보유합니다.
빈 문자열로 설정하면 기본 플랫폼의 기본 레이블이 사용됩니다. 기본 레이블은 일반적으로 Cancel 입니다.
기본값은 빈 문자열입니다.
acceptLabel 를참조하세요 .
selectedFile : url |
이 속성은 대화 상자에서 마지막으로 선택한 파일을 보유합니다.
대화 상자가 열릴 때 선택된 파일을 제어하도록 설정할 수 있습니다.
선택한 파일이 여러 개 있는 경우 이 속성은 첫 번째 파일을 참조합니다.
이 속성의 값은 사용자가 대화 상자에서 파일을 선택할 때마다 그리고 대화 상자가 수락될 때마다 업데이트됩니다. accepted () 신호를 처리하여 최종 선택 항목을 가져옵니다.
selectedFiles, accepted() 및 currentFolder 를참조하세요 .
이 속성은 대화 상자에서 마지막으로 선택된 파일을 보유합니다.
이 속성의 값은 사용자가 대화 상자에서 파일을 선택할 때마다 그리고 대화 상자가 수락될 때마다 업데이트됩니다. accepted () 신호를 처리하여 최종 선택 항목을 가져옵니다.
accepted() 및 currentFolder 을참조하세요 .
이 속성은 현재 선택된 이름 필터를 유지합니다.
이름 | 설명 |
---|---|
index: int | 이 속성은 어떤 name filter 이 선택되는지 결정합니다. 지정된 필터는 대화 상자가 열릴 때 선택됩니다. 사용자가 다른 필터를 선택하면 값이 업데이트됩니다. |
[읽기 전용] 이름: 문자열 | 이 속성은 선택한 필터의 이름을 보유합니다. 아래 예에서 첫 번째 필터의 이름은 "Text files" 이고 두 번째 필터의 이름은 "HTML files" 입니다. |
[읽기 전용] 확장명: 목록<스트링> | 이 속성은 선택한 필터의 확장명 목록을 보유합니다. 아래 예에서 첫 번째 필터의 확장자 목록은 ["txt"] 이고 두 번째 필터는 ["html", "htm"] 입니다. |
[읽기 전용] globs: list<string> | 이 속성은 선택한 필터의 글로브 목록을 보유합니다. 아래 예에서 첫 번째 필터의 글로브 목록은 ["*.txt"] 이고 두 번째 필터의 글로브 목록은 ["*.html", "*.htm"] 입니다.이 속성은 예를 들어 FolderListModel 의 nameFilters 속성과 함께 사용하면 유용합니다. |
FileDialog { id: fileDialog selectedNameFilter.index: 1 nameFilters: ["Text files (*.txt)", "HTML files (*.html *.htm)"] } MyDocument { id: document fileType: fileDialog.selectedNameFilter.extensions[0] }
nameFilters도 참조하세요 .
© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.