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

[DinahK-2SO]

This pull request updates the Storage.Pickers API specifications 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:

• Feature Request: Add a Title property to Storage.Pickers #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:

• File/Folder pickers: Missing SettingsIdentifier property #5847
• Proposal: Add SettingsIdentifier to Microsoft.Windows.Storage.Pickers microsoft-ui-xaml#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:

• FileSavePicker: Cannot set default extension when defining FileTypeChoices #5975

Changes in FileSavePicker

• Adds a new properties for FileSavePicker: ShowOverwritePrompt:
  ShowOverwritePrompt default to true and control whether the picker warns about overwriting when user picked an existing file via FileSavePicker.

• Changing the default behavior - when the user picked a not-existing file via FileSavePicker, the picker will NOT create an empty file there - allowing developer to decide when to make this file.

Related:

• FileSavePicker auto creates empty file after clicking OK button #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:

• FolderPicker: Missing PickMultipleFoldersAsync method #5848

[ghost1372]

@DinahK-2SO
here is other related issues which can be closed:
#5847
#5827

[kmahone]

🕐

[DinahK-2SO]

hey Friend @copilot , would you take a look at the latest iteration?

[Copilot]

@DinahK-2SO I've opened a new pull request, #6139, to work on those changes. Once the pull request is ready, I'll request review from you.