FolderBrowserDialog MultiSelect and SelectedPaths

[lonitra]

Help us make content visible

• FolderBrowserDialog multiselect
• FolderBrowserDialog selectedpaths

Describe the new article
Via dotnet/winforms#10357 WinForms has introduced new Multiselect and SelectedPaths property to FolderBrowserDialog which now allows users to select multiple folders if Multiselect = true and SelectedPaths willl pass back the list of folders the user has selected. (.NET 9 Preview 1)

The article should live under the properties section of https://learn.microsoft.com/en-us/dotnet/api/system.windows.forms.folderbrowserdialog?view=windowsdesktop-8.0. Ideally separate articles for Multiselect and SelectedPaths.

Both articles for Multiselect and SelectedPaths should cover what exactly these properties are, the property values and what they mean

Multiselect
Should have similar outline as https://learn.microsoft.com/en-us/dotnet/api/system.windows.forms.openfiledialog.multiselect?view=windowsdesktop-8.0:

Description

public bool Multiselect { get; set; }

true if dialog box allows multiple folders to be selected; otherwise, false. The default value is false.

Remarks
Use the SelectedPaths property to access full list of selected paths.

SelectedPaths
should have similar outline as https://learn.microsoft.com/en-us/dotnet/api/system.windows.forms.filedialog.filenames?view=windowsdesktop-8.0

Description

 public string[] SelectedPaths { get; }

Retrieves the paths of all selected folders in the dialog box.

Remarks
If no files are selected, this method returns an empty array.

[gewarren]

@adegeo Should this be transferred to the docs-desktop repo?

[adegeo]

Thanks @gewarren

[adegeo]

@lonitra Rereading through this, it sounds like these are actually updates to the API docs, not the conceptual, correct?

[lonitra]

@lonitra Rereading through this, it sounds like these are actually updates to the API docs, not the conceptual, correct?

Yes this would be updates to the API docs. Apologies I realized only today in a different thread that new APIs are automatically added and issues do not need to be opened for API doc updates.