Official API Review for new functionalities of Storage.Pickers: SettingsIdentifier; FileTypeIndex; Title; PickMultipleFoldersAsync; ShowOverwritePrompt; CreateNewFileIfNotExists

[DinahK-2SO]

This pull request updates the Storage.Pickers API specifications and documentation to add new customization and usability features to the FileOpenPicker, FileSavePicker, and FolderPicker classes. The changes introduce properties for dialog title and persistent settings, allow specifying the default file type filter, and add support for picking multiple folders. These enhancements are reflected in both the API definitions and usage examples.

Adds properties:

Title

• Adds Title properties to FileOpenPicker, FileSavePicker, and FolderPicker, enabling custom dialog titles and persistent picker state across sessions. ([1], [2], [3], [4], [5], [6])

Related:

• #5879

SettingsIdentifier

• Adds SettingsIdentifier properties to FileOpenPicker, FileSavePicker, and FolderPicker, enabling custom dialog titles and persistent picker state across sessions. ([1], [2], [3], [4], [5], [6])

Related:

• #5847
• https://github.com/microsoft/microsoft-ui-xaml/issues/10904

FileTypeIndex

• Adds FileTypeIndex property to FileOpenPicker and FileSavePicker, allowing developers to set the default selected file type filter by index (1-based). This is documented and shown in usage examples. ([1], [2], [3], [4], [5], [6], [7], [8])

Related:

• #5975

FileSavePicker.ShowOverwritePrompt & FileSavePicker.CreateNewFileIfNotExists

• Adds 2 new properties for FileSavePicker: ShowOverwritePrompt and CreateNewFileIfNotExists.
  • ShowOverwritePrompt default to true and control whether the picker warns about overwriting when user picked an existing file via FileSavePicker.
  • CreateNewFileIfNotExists default to true and control whether to auto-create an empty file when the picked file doesn't exists.

Related:

• #5976

Adds method:

FolderPicker.PickMultipleFoldersAsync

• Adds PickMultipleFoldersAsync method to FolderPicker, enabling selection of multiple folders in a single operation. API definitions, documentation, and code samples have been updated to reflect this feature. ([1], [2], [3]`)

Related:

• #5848

[ghost1372]

@DinahK-2SO here is other related issues which can be closed: https://github.com/microsoft/WindowsAppSDK/issues/5847 https://github.com/microsoft/WindowsAppSDK/issues/5827