다음을 통해 공유


FileSavePicker.FileTypeChoices 속성

정의

사용자가 파일에 할당하도록 선택할 수 있는 유효한 파일 형식의 컬렉션을 가져옵니다.

public:
 property IMap<Platform::String ^, IVector<Platform::String ^> ^> ^ FileTypeChoices { IMap<Platform::String ^, IVector<Platform::String ^> ^> ^ get(); };
IMap<winrt::hstring, IVector<winrt::hstring> const&> FileTypeChoices();
public IDictionary<string,IList<string>> FileTypeChoices { get; }
var iMap = fileSavePicker.fileTypeChoices;
Public ReadOnly Property FileTypeChoices As IDictionary(Of String, IList(Of String))

속성 값

IMap<String,IVector<String>>

IDictionary<String,IList<String>>

IMap<Platform::String,IVector<Platform::String>>

IMap<winrt::hstring,IVector<winrt::hstring>>

사용자가 파일을 저장하는 데 사용할 수 있는 유효한 파일 형식(확장명) 컬렉션을 포함하는 FilePickerFileTypesOrderedMap 개체입니다. 이 컬렉션의 각 요소는 표시 이름을 해당 파일 이름 확장명 컬렉션에 매핑합니다. 키는 단일 문자열이고 값은 하나 이상의 확장 선택을 나타내는 문자열의 목록/벡터입니다.

예제

파일 선택기 샘플에서는 표시 이름을 사용하여 파일 형식 선택 항목을 추가하는 방법을 보여 줍니다.

FileSavePicker savePicker = new FileSavePicker();
savePicker.SuggestedStartLocation = PickerLocationId.DocumentsLibrary;
// Dropdown of file types the user can save the file as
savePicker.FileTypeChoices.Add("Plain Text", new List<string>() { ".txt" });
// Default file name if the user does not type one in or select a file to replace
savePicker.SuggestedFileName = "New Document";
auto plainTextExtensions{ winrt::single_threaded_vector<winrt::hstring>() };
plainTextExtensions.Append(L".txt");

savePicker.FileTypeChoices().Insert(L"Plain Text", plainTextExtensions);
savePicker.SuggestedFileName(L"New Document");

FileSavePicker에 여러 FileTypeChoices를 추가하는 경우 추가된 첫 번째 파일 형식은 기본 파일 형식입니다. 이 기본값은 사용자가 파일 선택기를 열 때 선택됩니다. 사용자가 파일 선택기에서 파일 형식을 변경하지 않는 경우 기본 파일 형식이 사용됩니다. 이 예제에서는 선택한 라디오 단추에 따라 FileTypeChoices 항목이 추가됩니다.

if (radioButtonRichText.IsChecked)
{
    savePicker.FileTypeChoices.Add("Rich text", new List<string>() { ".rtf" });
    savePicker.FileTypeChoices.Add("Word document", new List<string>() { ".docx" });
    savePicker.FileTypeChoices.Add("Plain text", new List<string>() { ".txt" });
}
else if (radioButtonWordDoc.IsChecked)
{
    savePicker.FileTypeChoices.Add("Word document", new List<string>() { ".docx" });
    savePicker.FileTypeChoices.Add("Plain text", new List<string>() { ".txt" });
    savePicker.FileTypeChoices.Add("Rich text", new List<string>() { ".rtf" });
}
else // default to plain text file type
{
    savePicker.FileTypeChoices.Add("Plain text", new List<string>() { ".txt" });
    savePicker.FileTypeChoices.Add("Rich text", new List<string>() { ".rtf" });
    savePicker.FileTypeChoices.Add("Word document", new List<string>() { ".docx" });
}

설명

일부 앱은 클라우드 스토리지 공급자와 같이 파일 형식을 처리하기 위해 이해할 필요가 없습니다. 따라서 파일 와일드카드 문자 "*"를 사용하면 FileOpenPicker.FileTypeFilter 컬렉션이 지원됩니다. 그러나 파일을 작성하려면 해당 형식에 대한 지식이 필요합니다. 따라서 FileSavePicker.FileTypeChoices에 대해 와일드카드가 지원되지 않습니다.

파일 형식의 분류로서 하나의 표시 이름에는 이를 지원하는 여러 파일 형식이 있을 수 있습니다. 예를 들어 "HTML 페이지"의 표시 이름은 ".htm" 또는 ".html" 확장으로 저장할 수 있습니다. 따라서 FilePickerFileTypesOrderedMap 의 각 항목 값은 벡터에 확장을 배치하는 순서대로 UI에 표시되는 문자열의 순서가 지정된 목록(벡터)입니다.

적용 대상

추가 정보