FileOpenPickerUI Clase

Definición

Espacio de nombres:

Windows.Storage.Pickers.Provider

Se usa para interactuar con el selector de archivos si la aplicación proporciona archivos con el contrato del selector de archivos abierto.

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

Herencia

Object Platform::Object IInspectable FileOpenPickerUI

Atributos

ContractVersionAttribute

Requisitos de Windows

Familia de dispositivos	Windows 10 (se introdujo en la versión 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)

Ejemplos

En el ejemplo del proveedor del selector de archivos se muestra cómo responder a un evento activado FileOpenPicker .

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

Para C#, args contiene un objeto FileOpenPickerActivatedEventArgs . Además, OnFileOpenPickerActivated está en el archivo App.xaml.cs y el Activate método se encuentra en el archivo FileOpenPickerPage.xaml.cs del ejemplo del proveedor del selector de archivos.

Comentarios

Si la aplicación participa en el contrato de selector abierto de archivos, puedes recuperar este objeto mediante una propiedad FileOpenPickerUI mientras controlas un evento activado FileOpenPicker .

Utilice la propiedad Windows.ApplicationModel.Activation.FileOpenPickerActivatedEventArgs.FileOpenPickerUI para tener acceso a fileOpenPickerUI.

Obtenga información sobre cómo crear una buena experiencia para los usuarios cuando acceden a los archivos a través del selector de archivos leyendo las directrices de experiencia del usuario para proporcionar archivos en Abrir archivos y carpetas con un selector.

Propiedades

AllowedFileTypes	Obtiene una lista de tipos de archivo (extensiones) que el usuario puede elegir.
SelectionMode	Obtiene un valor de enumeración que indica si el selector de archivos limita actualmente la selección a archivos únicos o si se pueden seleccionar varios archivos.
SettingsIdentifier	Obtiene un identificador para el contexto actual del selector de archivos.
Title	Obtiene o establece un título que se va a mostrar en la interfaz de usuario del selector de archivos que identifica la ubicación en la que se muestra el selector de archivos al usuario.

Métodos

AddFile(String, IStorageFile)	Agrega el archivo especificado a la lista de archivos que ha elegido el usuario.
CanAddFile(IStorageFile)	Indica si el archivo especificado se puede agregar a la lista de archivos que ha elegido el usuario.
ContainsFile(String)	Determina si el archivo especificado está en la lista de archivos que ha elegido el usuario.
RemoveFile(String)	Quita el archivo especificado de la lista de archivos que ha elegido el usuario.

Eventos

Closing	Se activa cuando el usuario cierra el selector de archivos.
FileRemoved	Nota El evento FileRemoved está en desuso y no debe usarse. Se activa cuando el usuario quita un archivo de la lista de archivos que el usuario ha elegido si la aplicación que proporciona archivos ha agregado ese archivo.

Consulte también

• ActivationKind
• WebUIFileOpenPickerActivatedEventArgs
• FileOpenPickerActivatedEventArgs
• Abrir archivos y carpetas con un selector
• Ejemplo del proveedor del selector de archivos