FileOpenPickerUI Classe

Riferimento

Definizione

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

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

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

Condividi tramite