FileOpenPickerActivatedEventArgs Klasse

Definition

Namespace:

Windows.ApplicationModel.Activation

Stellt Informationen zu einem aktivierten Ereignis bereit, das ausgelöst wird, wenn der Benutzer versucht, Von der App bereitgestellte Dateien oder Ordner zu wählen.

Javascript Dieser Typ wird als WebUIFileOpenPickerActivatedEventArgs angezeigt.

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

Vererbung

Object Platform::Object IInspectable FileOpenPickerActivatedEventArgs

Attribute

ContractVersionAttribute MarshalingBehaviorAttribute

Implementiert

IActivatedEventArgs IFileOpenPickerActivatedEventArgs IFileOpenPickerActivatedEventArgs2 IActivatedEventArgsWithUser

Windows-Anforderungen

Gerätefamilie	Windows 10 (eingeführt in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Beispiele

Im Beispiel für Verträge für die Dateiauswahl wird veranschaulicht, wie auf einen FileOpenPicker-Aktivierungspunkt reagiert wird.

// 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();
}

Für C# args verweist die Überschreibung für OnFileOpenPickerActivated auf ein FileOpenPickerActivatedEventArgs-Objekt. Die OnFileOpenPickerActivated-Überschreibung befindet sich in der Datei App.xaml.cs, und die Activate Methode befindet sich in der Datei FileOpenPickerPage.xaml.cs des Beispiels für Verträge der Dateiauswahl.

Hinweise

In schnellstart: Bereitstellen von Dateidiensten über und in der Windows.Storage.Pickers.Provider-Namespacereferenz erfahren Sie, wie Sie Dateien bereitstellen, die der Benutzer aus Ihrer App auswählen kann.

Ein FileOpenPickerActivatedEventArgs-Objekt wird an den aktivierten Ereignishandler der App übergeben, wenn der Benutzer Dateien oder Ordner auswählen möchte, die von der App bereitgestellt werden. Dieser Aktivierungstyp wird durch den ActivationKind.FileOpenPicker-Wert angegeben, der von der Kind-Eigenschaft zurückgegeben wird.

In JavaScript geschriebene Apps müssen Windows.UI.WebUI.webUIApplication.activated-Ereignisse überwachen und behandeln.

Die UWP-App mit C++, C# oder Visual Basic implementiert in der Regel Aktivierungspunkte, indem Methoden des Application-Objekts überschrieben werden. Die CodeBehind-Dateien der Standardvorlage app.xaml enthalten immer eine Überschreibung für OnLaunched. Das Definieren von Überschreibungen für andere Aktivierungspunkte wie OnFileOpenPickerActivated liegt jedoch bei Ihrem App-Code.

Alle Anwendungsüberschreibungen , die an einem Aktivierungsszenario beteiligt sind, sollten Window.Activate in ihren Implementierungen aufrufen.

Versionsverlauf

Windows-Version	SDK-Version	Wertschöpfung
1607	14393	User

Eigenschaften

CallerPackageFamilyName	Der Paketfamilienname der App, die Ihre App gestartet hat.
FileOpenPickerUI	Ruft die Benutzeroberfläche des Briefkastens der Dateiauswahl ab, die angezeigt wird, wenn der Benutzer Dateien oder Ordner auswählen möchte, die von der App bereitgestellt werden.
Kind	Ruft den Aktivierungstyp ab.
PreviousExecutionState	Ruft den Ausführungsstatus der App ab, bevor sie aktiviert wurde.
SplashScreen	Ruft ein SplashScreen-Objekt ab, das Informationen zum Übergang vom Begrüßungsbildschirm zur aktivierten App bereitstellt.
User	Ruft den Benutzer ab, für den die App aktiviert wurde.

Weitere Informationen

• OnFileOpenPickerActivated(FileOpenPickerActivatedEventArgs)
• Application
• FileOpenPicker
• Windows.Storage.Pickers.Provider
• Activated
• Activated
• Schnellstart: Bereitstellen von Dateidiensten über
• Beispiel für Verträge für die Dateiauswahl