FolderPicker Classe

  • Riferimento

Definizione

Spazio dei nomi:
Windows.Storage.Pickers
Modifica

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.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class FolderPicker final
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class FolderPicker final
/// [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.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public sealed class FolderPicker
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class FolderPicker
[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.

Si applica a

Vedi anche