FileOpenPickerActivatedEventArgs Classe

Definizione

Spazio dei nomi:

Windows.ApplicationModel.Activation

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 : IActivatedEventArgsWithUser, 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 : IActivatedEventArgsWithUser, IFileOpenPickerActivatedEventArgs, IFileOpenPickerActivatedEventArgs2

Public NotInheritable Class FileOpenPickerActivatedEventArgs
Implements IActivatedEventArgsWithUser, IFileOpenPickerActivatedEventArgs, IFileOpenPickerActivatedEventArgs2

Ereditarietà

Object Platform::Object IInspectable FileOpenPickerActivatedEventArgs

Attributi

ContractVersionAttribute MarshalingBehaviorAttribute

Implementazioni

IActivatedEventArgs IFileOpenPickerActivatedEventArgs IFileOpenPickerActivatedEventArgs2 IActivatedEventArgsWithUser

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.

Vedi anche

• OnFileOpenPickerActivated(FileOpenPickerActivatedEventArgs)
• Application
• FileOpenPicker
• Windows.Storage.Pickers.Provider
• Activated
• Activated
• Guida introduttiva: Fornire servizi file tramite
• Esempio di contratti di selezione file