Official API Review for new functionalities of Storage.Pickers: SettingsIdentifier; FileTypeIndex; Title; PickMultipleFoldersAsync; ShowOverwritePrompt; CreateNewFileIfNotExists #6051
+179
−2
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
…ickMultipleFoldersAsync
DinahK-2SO
added
the
area-File access
DinahK-2SO
force-pushed
the
user/DinahK-2SO/spec_settingsidentifier_filetypefilterindex_title
branch
from
e8f4450 to
7af6a89
Compare
Contributor
|
@DinahK-2SO |
DinahK-2SO
changed the title
d2phap
reviewed
Dec 6, 2025
| catagorized filter types. When both `FileTypeChoices` and `FileTypeFilter` are provided, | ||
| `FileTypeChoices` is used and `FileTypeFilter` is ignored. | ||
|
|
||
| 1. Adding `FileTypeIndex` for `FileOpenPicker` and `FileSavePicker`. This allows setting the default selected file type filter index. Note this index is 1-based. When it is 0 (the default value), the selected filter might be override by the API's default behavior. |
There was a problem hiding this comment.
It would be friendlier to developer to use 0-based index (-1 for default behavior), it will save lots of time where they assume the "index" was always 0-based.
Are there any issues with the 0-based index?
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
This pull request updates the Storage.Pickers API specifications and documentation to add new customization and usability features to the
FileOpenPicker,FileSavePicker, andFolderPickerclasses. 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.Adding properties:
Title
Titleproperties toFileOpenPicker,FileSavePicker, andFolderPicker, enabling custom dialog titles and persistent picker state across sessions. ([1], [2], [3], [4], [5], [6])Related:
SettingsIdentifier
SettingsIdentifierproperties toFileOpenPicker,FileSavePicker, andFolderPicker, enabling custom dialog titles and persistent picker state across sessions. ([1], [2], [3], [4], [5], [6])Related:
FileTypeIndex
FileTypeIndexproperty toFileOpenPickerandFileSavePicker, 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.ShowOverwritePrompt & FileSavePicker.CreateNewFileIfNotExists
FileSavePicker:ShowOverwritePromptandCreateNewFileIfNotExists.ShowOverwritePromptdefault totrueand control whether the picker warns about overwriting when user picked an existing file via FileSavePicker.CreateNewFileIfNotExistsdefault totrueand control whether to auto-create an empty file when the picked file doesn't exists.Related:
Adding method:
FolderPicker.PickMultipleFoldersAsync
PickMultipleFoldersAsyncmethod toFolderPicker, 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: