FileOpenPickerActivatedEventArgs Classe

Definizione

Fornisce informazioni su un evento attivato che viene generato quando l'utente tenta di selezionare file o cartelle forniti dall'app.

Javascript Questo tipo viene visualizzato come WebUIFileOpenPickerActivatedEventArgs.

public ref class FileOpenPickerActivatedEventArgs sealed : IFileOpenPickerActivatedEventArgs, IFileOpenPickerActivatedEventArgs2
public ref class FileOpenPickerActivatedEventArgs sealed : IActivatedEventArgsWithUser, IFileOpenPickerActivatedEventArgs, IFileOpenPickerActivatedEventArgs2
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class FileOpenPickerActivatedEventArgs final : IFileOpenPickerActivatedEventArgs, IFileOpenPickerActivatedEventArgs2
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class FileOpenPickerActivatedEventArgs final : IActivatedEventArgsWithUser, IFileOpenPickerActivatedEventArgs, IFileOpenPickerActivatedEventArgs2
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class FileOpenPickerActivatedEventArgs : IFileOpenPickerActivatedEventArgs, IFileOpenPickerActivatedEventArgs2
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class FileOpenPickerActivatedEventArgs : IActivatedEventArgsWithUser, IFileOpenPickerActivatedEventArgs, IFileOpenPickerActivatedEventArgs2
Public NotInheritable Class FileOpenPickerActivatedEventArgs
Implements IFileOpenPickerActivatedEventArgs, IFileOpenPickerActivatedEventArgs2
Public NotInheritable Class FileOpenPickerActivatedEventArgs
Implements IActivatedEventArgsWithUser, IFileOpenPickerActivatedEventArgs, IFileOpenPickerActivatedEventArgs2
Ereditarietà
Object Platform::Object IInspectable FileOpenPickerActivatedEventArgs
Attributi
Implementazioni

Requisiti Windows

Famiglia di dispositivi
Windows 10 (è stato introdotto in 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)

Esempio

L'esempio di contratti di selezione file illustra come rispondere a un punto di attivazione 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 per un oggetto OnFileOpenPickerActivatedActivated fa riferimento a un oggetto FileOpenPickerActivatedEventArgs. L'override OnFileOpenPickerActivated si trova nel file App.xaml.cs e il Activate metodo si trova nel file FileOpenPickerPage.xaml.cs dell'esempio di contratti di selezione file.

Commenti

Informazioni su come fornire file per l'utente da scegliere dall'app in Guida introduttiva: fornire servizi file tramite e nel riferimento allo spazio dei nomi Windows.Storage.Pickers.Provider .

Un oggetto FileOpenPickerActivatedEventArgs viene passato al gestore eventi attivato dell'app quando l'utente vuole selezionare file o cartelle forniti dall'app. Questo tipo di attivazione è indicato dal valore ActivationKind.FileOpenPicker restituito dalla proprietà Kind .

Le app scritte in JavaScript devono essere in ascolto e gestire eventi Windows.UI.WebUI.webUIApplication.activated .

L'app UWP usando C++, C#o Visual Basic implementa in genere i punti di attivazione eseguendo l'override dei metodi dell'oggetto Application . I file di code-behind del modello predefiniti includono sempre un override per OnLaunched, ma la definizione degli overridi per altri punti di attivazione, ad esempio OnFileOpenPickerActivated , è fino al codice dell'app.

Tutti gli overridi dell'applicazione coinvolti in uno scenario di attivazione devono chiamare Window.Activate nelle implementazioni.

Cronologia delle versioni

Versione di Windows Versione dell'SDK Valore aggiunto
1607 14393 Utente

Proprietà

CallerPackageFamilyName

Nome della famiglia di pacchetti dell'app che ha avviato l'app.

FileOpenPickerUI

Ottiene l'interfaccia utente della casella di posta elettronica del selettore file visualizzata quando l'utente vuole selezionare file o cartelle forniti dall'app.

Kind

Ottiene il tipo di attivazione.

PreviousExecutionState

Ottiene lo stato di esecuzione dell'app prima dell'attivazione.

SplashScreen

Ottiene un oggetto SplashScreen che fornisce informazioni sulla transizione dalla schermata iniziale all'app attivata.

User

Ottiene l'utente per cui è stata attivata l'app.

Si applica a

Vedi anche