FolderPicker Classe

Definizione

Spazio dei nomi:

Windows.Storage.Pickers

Rappresenta un elemento dell'interfaccia utente che consente all'utente di scegliere le cartelle.

In un'app desktop, prima di usare un'istanza di questa classe in modo da visualizzare l'interfaccia utente, dovrai associare l'oggetto all'handle della finestra del proprietario. Per altre info ed esempi di codice, vedi Visualizzare gli oggetti dell'interfaccia utente WinRT che dipendono da CoreWindow.

public ref class FolderPicker sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class FolderPicker final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class FolderPicker

function FolderPicker()

Public NotInheritable Class FolderPicker

Ereditarietà

Object Platform::Object IInspectable FolderPicker

Attributi

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisiti Windows

Famiglia di dispositivi	Windows 10 (è stato introdotto in 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)

Commenti

Per iniziare ad accedere a file e cartelle con una selezione, vedere Aprire file e cartelle con una selezione.

Cronologia delle versioni

Versione di Windows	Versione dell'SDK	Valore aggiunto
1903	18362	CreateForUser
1903	18362	Utente

Costruttori

FolderPicker()

Crea una nuova istanza di folderPicker. In un'app desktop, prima di usare un'istanza di questa classe in modo da visualizzare l'interfaccia utente, dovrai associare l'oggetto all'handle della finestra del proprietario. Per altre info ed esempi di codice, vedi Visualizzare gli oggetti dell'interfaccia utente WinRT che dipendono da CoreWindow.

Proprietà

CommitButtonText	Ottiene o imposta il testo dell'etichetta del pulsante di commit della selezione cartella.
ContinuationData	Ottiene un set di valori da popolare dall'app prima di un'operazione PickFolderAndContinue che disattiva l'app per fornire il contesto quando l'app viene attivata. (Windows Phone 8.x app)
FileTypeFilter	Ottiene la raccolta di tipi di file visualizzati dalla selezione cartelle.
SettingsIdentifier	Ottiene o imposta l'identificatore delle impostazioni associato all'istanza FolderPicker corrente.
SuggestedStartLocation	Ottiene o imposta il percorso iniziale in cui la selezione cartella cerca le cartelle da presentare all'utente.
User	Ottiene informazioni sull'utente per cui è stato creato FolderPicker . Usare questa proprietà per le applicazioni multiutente.
ViewMode	Ottiene o imposta la modalità di visualizzazione utilizzata dalla selezione cartelle per visualizzare gli elementi.

Metodi

CreateForUser(User)	Crea un oggetto FolderPicker con ambito nella directory personale dell'utente specificato. Usare questo metodo per le applicazioni multiutente.
PickFolderAndContinue()	Obsoleto a partire da Windows 10. Usare invece PickSingleFolderAsync. Mostra la selezione file in modo che l'utente possa selezionare una cartella, disattivare e riattivarla al termine dell'operazione. (Windows Phone 8.x app)
PickSingleFolderAsync()	Mostra l'oggetto folderPicker in modo che l'utente possa selezionare una cartella. (app UWP) Nota È necessario specificare FileTypeFilter prima di chiamare questo metodo oppure verrà generata un'eccezione. Per elencare tutte le cartelle, usare "*" come filtro.

Vedi anche

• Esempio di utilità di selezione file
• Visualizzare oggetti dell'interfaccia utente WinRT che dipendono da CoreWindow