Skip to content

Clarify SettingsIdentifier documentation and Note 2 reference #6139

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
Copilot wants to merge 2 commits into
base: user/DinahK-2SO/spec_settingsidentifier_filetypefilterindex_title
Choose a base branch
from
+25 −19
Draft

Clarify SettingsIdentifier documentation and Note 2 reference #6139

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
3afa949
Initial plan
Copilot Jan 14, 2026
675d4e6
Address review feedback: Update SettingsIdentifier comments and Note …
Copilot Jan 14, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 8 additions & 6 deletions specs/Storage.Pickers/FileOpenPicker.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -72,9 +72,10 @@ var openPicker = new FileOpenPicker(this.AppWindow.Id)
// If not specified, the system uses a default title.
Title = "Open File",

// (Optional) allows customization of the settings name, to distinguish picker instances.
// Without the SettingsIdentifier specified, pickers in one app share the state together.
// Only specify this when a picker needs to track its own state (e.g. size, location, etc).
// (Optional) Allows customization of the settings name, to distinguish picker instances.
// Pickers in one app share state by default. Use this property only when you need
// multiple distinct picker states within the same app.
// See: https://learn.microsoft.com/en-us/uwp/api/windows.storage.pickers.fileopenpicker.settingsidentifier
SettingsIdentifier = "BookContents",

// (Optional) group file types into labeled choices
Expand Down Expand Up @@ -127,9 +128,10 @@ openPicker.CommitButtonText(L"Choose selected files");
// If not specified, the system uses a default title.
openPicker.Title(L"Open File");

// (Optional) allows customization of the settings name, to distinguish picker instances.
// Without the SettingsIdentifier specified, pickers in one app share the state together.
// Only specify this when a picker needs to track its own state (e.g. size, location, etc).
// (Optional) Allows customization of the settings name, to distinguish picker instances.
// Pickers in one app share state by default. Use this property only when you need
// multiple distinct picker states within the same app.
// See: https://learn.microsoft.com/en-us/uwp/api/windows.storage.pickers.fileopenpicker.settingsidentifier
openPicker.SettingsIdentifier(L"BookContents");

// (Optional) group file types into labeled choices
Expand Down
14 changes: 8 additions & 6 deletions specs/Storage.Pickers/FileSavePicker.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -74,9 +74,10 @@ var savePicker = new FileSavePicker(this.AppWindow.Id)
// If not specified, the system uses a default title.
Title = "Save File",

// (Optional) allows customization of the settings name, to distinguish picker instances.
// Without the SettingsIdentifier specified, pickers in one app share the state together.
// Only specify this when a picker needs to track its own state (e.g. size, location, etc).
// (Optional) Allows customization of the settings name, to distinguish picker instances.
// Pickers in one app share state by default. Use this property only when you need
// multiple distinct picker states within the same app.
// See: https://learn.microsoft.com/en-us/uwp/api/windows.storage.pickers.filesavepicker.settingsidentifier
SettingsIdentifier = "BookContents",

// (Optional) categorized extension types. If not specified, "All Files (*.*)" is allowed.
Expand Down Expand Up @@ -139,9 +140,10 @@ savePicker.CommitButtonText(L"Save Document");
// If not specified, the system uses a default title.
savePicker.Title(L"Save File");

// (Optional) allows customization of the settings name, to distinguish picker instances.
// Without the SettingsIdentifier specified, pickers in one app share the state together.
// Only specify this when a picker needs to track its own state (e.g. size, location, etc).
// (Optional) Allows customization of the settings name, to distinguish picker instances.
// Pickers in one app share state by default. Use this property only when you need
// multiple distinct picker states within the same app.
// See: https://learn.microsoft.com/en-us/uwp/api/windows.storage.pickers.filesavepicker.settingsidentifier
savePicker.SettingsIdentifier(L"BookContents");

// (Optional) categorized extension types. If not specified, "All Files (*.*)" is allowed.
Expand Down
14 changes: 8 additions & 6 deletions specs/Storage.Pickers/FolderPicker.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -73,9 +73,10 @@ var folderPicker = new FolderPicker(this.AppWindow.Id)
// If not specified, the system uses a default title.
Title = "Select Folder",

// (Optional) allows customization of the settings name, to distinguish picker instances.
// Without the SettingsIdentifier specified, pickers in one app share the state together.
// Only specify this when a picker needs to track its own state (e.g. size, location, etc).
// (Optional) Allows customization of the settings name, to distinguish picker instances.
// Pickers in one app share state by default. Use this property only when you need
// multiple distinct picker states within the same app.
// See: https://learn.microsoft.com/en-us/uwp/api/windows.storage.pickers.folderpicker.settingsidentifier
SettingsIdentifier = "BookContents",

// (Optional) specify the view mode of the picker dialog. If not specified, default to List.
Expand Down Expand Up @@ -116,9 +117,10 @@ folderPicker.CommitButtonText(L"Select Folder");
// If not specified, the system uses a default title.
folderPicker.Title(L"Select Folder");

// (Optional) allows customization of the settings name, to distinguish picker instances.
// Without the SettingsIdentifier specified, pickers in one app share the state together.
// Only specify this when a picker needs to track its own state (e.g. size, location, etc).
// (Optional) Allows customization of the settings name, to distinguish picker instances.
// Pickers in one app share state by default. Use this property only when you need
// multiple distinct picker states within the same app.
// See: https://learn.microsoft.com/en-us/uwp/api/windows.storage.pickers.folderpicker.settingsidentifier
folderPicker.SettingsIdentifier(L"BookContents");

// (Optional) specify the view mode of the picker dialog. If not specified, default to List.
Expand Down
2 changes: 1 addition & 1 deletion specs/Storage.Pickers/Microsoft.Windows.Storage.Pickers.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -63,7 +63,7 @@ setting the initial file type filter selected. Note this index is 0-based. When

1. Adding `SettingsIdentifier` for all 3 pickers. This allows the picker to hold its own state
(e.g. size, location, etc) across sessions. The `SettingsIdentifier` is scoped to the app.
(Read more in [Note 2](#note-2-the-use-case-and-implementation-of-settingsidentifier) below).
(See [Note 2](#note-2-the-use-case-and-implementation-of-settingsidentifier) for more details).

1. Adding `ShowOverwritePrompt` for `FileSavePicker`. This Boolean property defaults to `true` and
controls whether the picker warns about overwriting when the user picked an existing file via
Expand Down