FileOpenPickerUI Klasse

Referenz

Definition

Namespace:: Windows.Storage.Pickers.Provider

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bearbeiten

Wird für die Interaktion mit der Dateiauswahl verwendet, wenn Ihre App Dateien mit dem Vertrag "Dateiauswahl öffnen" bereitstellt.

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

Vererbung: Object Platform::Object IInspectable FileOpenPickerUI

Attribute: ContractVersionAttribute

Windows-Anforderungen

Gerätefamilie	Windows 10 (eingeführt in 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Beispiele

Das Beispiel des Dateiauswahlanbieters veranschaulicht, wie auf ein aktiviertes FileOpenPicker-Ereignis 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();
}

Enthält für C# args ein FileOpenPickerActivatedEventArgs-Objekt . Darüber hinaus befindet sich der OnFileOpenPickerActivated in der Datei App.xaml.cs und die Activate -Methode in der Datei FileOpenPickerPage.xaml.cs des Dateiauswahlanbieterbeispiels.

Hinweise

Wenn Ihre App am Vertrag "Dateiöffnenauswahl" teilnimmt, können Sie dieses Objekt mithilfe einer FileOpenPickerUI-Eigenschaft abrufen, während Sie ein aktiviertes FileOpenPicker-Ereignis behandeln.

Verwenden Sie die Windows.ApplicationModel.Activation.FileOpenPickerActivatedEventArgs.FileOpenPickerUI-Eigenschaft , um auf eine FileOpenPickerUI zuzugreifen.

Erfahren Sie mehr über das Erstellen einer guten Benutzeroberfläche für Benutzer, wenn sie über die Dateiauswahl auf Ihre Dateien zugreifen, indem Sie die UX-Richtlinien zum Bereitstellen von Dateien in Öffnen von Dateien und Ordnern mit einer Auswahl lesen.

Eigenschaften

AllowedFileTypes	Ruft eine Liste der Dateitypen (Erweiterungen) ab, die der Benutzer auswählen kann.
SelectionMode	Ruft einen Enumerationswert ab, der angibt, ob die Dateiauswahl derzeit die Auswahl auf einzelne Dateien beschränkt oder ob mehrere Dateien ausgewählt werden können.
SettingsIdentifier	Ruft einen Bezeichner für den aktuellen Kontext der Dateiauswahl ab.
Title	Ruft einen Titel ab, der auf der Dateiauswahl-Benutzeroberfläche angezeigt werden soll, der den Speicherort identifiziert, den die Dateiauswahl dem Benutzer anzeigt, oder legt diesen fest.

Methoden

AddFile(String, IStorageFile)	Fügt die angegebene Datei der Liste der Dateien hinzu, die der Benutzer ausgewählt hat.
CanAddFile(IStorageFile)	Gibt an, ob die angegebene Datei der Liste der vom Benutzer ausgewählten Dateien hinzugefügt werden kann.
ContainsFile(String)	Bestimmt, ob sich die angegebene Datei in der Liste der dateien befindet, die der Benutzer ausgewählt hat.
RemoveFile(String)	Entfernt die angegebene Datei aus der Liste der dateien, die der Benutzer ausgewählt hat.

Ereignisse

Closing	Wird ausgelöst, wenn der Benutzer die Dateiauswahl schließt.
FileRemoved	Hinweis Das FileRemoved-Ereignis ist veraltet und sollte nicht verwendet werden. Wird ausgelöst, wenn der Benutzer eine Datei aus der Liste der Dateien entfernt, die der Benutzer ausgewählt hat, wenn diese Datei von der App hinzugefügt wurde, die Dateien bereitstellt.

Gilt für:

Freigeben über