FileOpenPickerUI Klasse

  • Referenz

Definition

Namespace:
Windows.Storage.Pickers.Provider
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:

Weitere Informationen