Condividi tramite

FileOpenPickerUI Classe

  • Riferimento

Definizione

Spazio dei nomi:
Windows.Storage.Pickers.Provider
Modifica

Usato per interagire con la selezione file se l'app fornisce file con il contratto Selezione file aperto.

public ref class FileOpenPickerUI sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class FileOpenPickerUI final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public sealed class FileOpenPickerUI
Public NotInheritable Class FileOpenPickerUI
Ereditarietà
Object Platform::Object IInspectable FileOpenPickerUI
Attributi
ContractVersionAttribute

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)

Esempio

L'esempio di provider di selezione file illustra come rispondere a un evento attivato FileOpenPicker.

// File open picker activated event handler
protected override void OnFileOpenPickerActivated(FileOpenPickerActivatedEventArgs args)
{
    var FileOpenPickerPage = new SDKTemplate.FileOpenPickerPage();
    FileOpenPickerPage.Activate(args);
}

// Overloaded method to respond to fileOpenPicker events
public void Activate(FileOpenPickerActivatedEventArgs args)
{
    // Perform tasks to prepare your app to display its file picker page

    // Get file picker UI
    fileOpenPickerUI = args.FileOpenPickerUI;

    Window.Current.Content = this;
    this.OnNavigatedTo(null);
    Window.Current.Activate();
}

Per C#, args contiene un oggetto FileOpenPickerActivatedEventArgs . Inoltre, OnFileOpenPickerActivated è nel file App.xaml.cs e il Activate metodo si trova nel file FileOpenPickerPage.xaml.cs dell'esempio del provider di selezione file.

Commenti

Se l'app partecipa al contratto Selezione apri file, puoi recuperare questo oggetto usando una proprietà FileOpenPickerUI mentre gestisci un evento attivato da FileOpenPicker .

Utilizzare la proprietà Windows.ApplicationModel.Activation.FileOpenPickerActivatedEventArgs.FileOpenPickerUI per accedere a un Oggetto FileOpenPickerUI.

Informazioni sulla creazione di un'esperienza ottimale per gli utenti quando accedono ai file tramite la selezione file leggendo le linee guida per l'esperienza utente per fornire file in Apri file e cartelle con una selezione.

Proprietà

AllowedFileTypes

Ottiene un elenco di tipi di file (estensioni) che l'utente può scegliere.
SelectionMode

Ottiene un valore di enumerazione che indica se la selezione file limita attualmente la selezione a singoli file o se è possibile selezionare più file.
SettingsIdentifier

Ottiene un identificatore per il contesto corrente della selezione file.
Title

Ottiene o imposta un titolo da visualizzare nell'interfaccia utente di selezione file che identifica il percorso visualizzato dalla selezione file all'utente.

Metodi

AddFile(String, IStorageFile)

Aggiunge il file specificato all'elenco di file scelti dall'utente.
CanAddFile(IStorageFile)

Indica se il file specificato può essere aggiunto all'elenco dei file scelti dall'utente.
ContainsFile(String)

Determina se il file specificato è incluso nell'elenco di file scelti dall'utente.
RemoveFile(String)

Rimuove il file specificato dall'elenco dei file scelti dall'utente.

Eventi

Closing

Viene generato quando l'utente chiude la selezione file.
FileRemoved

Nota

L'evento FileRemoved è deprecato e non deve essere utilizzato.

Viene generato quando l'utente rimuove un file dall'elenco di file scelto dall'utente se il file è stato aggiunto dall'app che fornisce file.

Si applica a

Vedi anche