FileOpenPickerUI Class

Reference

Definition

Namespace:: Windows.Storage.Pickers.Provider

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Edit

Used to interact with the file picker if your app provides files with the File Open Picker contract.

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

Inheritance: Object Platform::Object IInspectable FileOpenPickerUI

Attributes: ContractVersionAttribute

Windows requirements

Device family	Windows 10 (introduced in 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (introduced in v1.0)

Examples

The File picker provider sample demonstrates how to respond to a FileOpenPicker activated event.

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

For C#, args contains a FileOpenPickerActivatedEventArgs object. Additionally, the OnFileOpenPickerActivated is in the App.xaml.cs file and the Activate method is in the FileOpenPickerPage.xaml.cs file of the File picker provider sample.

Remarks

If your app participates in the File Open Picker contract, you can retrieve this object using a FileOpenPickerUI property while you handle a FileOpenPicker activated event.

Use the Windows.ApplicationModel.Activation.FileOpenPickerActivatedEventArgs.FileOpenPickerUI property to access a FileOpenPickerUI.

Learn about creating a good experience for users when they access your files through the file picker by reading the UX guidelines for providing files in Open files and folders with a picker.

Properties

AllowedFileTypes	Gets a list of file types (extensions) that the user can choose.
SelectionMode	Gets an enumeration value that indicates whether the file picker currently limits selection to single files, or if multiple files can be selected.
SettingsIdentifier	Gets an identifier for the current context of the file picker.
Title	Gets or sets a title to display in the file picker UI that identifies the location that the file picker is displaying to the user.

Methods

AddFile(String, IStorageFile)	Adds the specified file to the list of files that the user has chosen.
CanAddFile(IStorageFile)	Indicates whether the specified file can be added to the list of files the user has chosen.
ContainsFile(String)	Determines whether the specified file is in the list of files that the user has chosen.
RemoveFile(String)	Removes the specified file from the list of files the user has chosen.

Events

Closing	Fires when the user closes the file picker.
FileRemoved	Note The FileRemoved event is deprecated and should not be used. Fires when the user removes a file from the list of files that the user has chosen if that file was added by the app that is providing files.

Applies to