Freigeben über


FileOpenPickerActivatedEventArgs Klasse

Definition

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 : 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
Vererbung
Object Platform::Object IInspectable FileOpenPickerActivatedEventArgs
Attribute
Implementiert

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.

Gilt für:

Weitere Informationen