FileOpenPickerActivatedEventArgs Clase

Definición

Espacio de nombres:

Windows.ApplicationModel.Activation

Proporciona información sobre un evento activado que se desencadena cuando el usuario intenta seleccionar archivos o carpetas proporcionados por la aplicación.

Javascript Este tipo aparece como WebUIFileOpenPickerActivatedEventArgs.

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 : 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 : IActivatedEventArgsWithUser, IFileOpenPickerActivatedEventArgs, IFileOpenPickerActivatedEventArgs2

Public NotInheritable Class FileOpenPickerActivatedEventArgs
Implements IActivatedEventArgsWithUser, IFileOpenPickerActivatedEventArgs, IFileOpenPickerActivatedEventArgs2

Herencia

Object Platform::Object IInspectable FileOpenPickerActivatedEventArgs

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute

Implementaciones

IActivatedEventArgs IFileOpenPickerActivatedEventArgs IFileOpenPickerActivatedEventArgs2 IActivatedEventArgsWithUser

Requisitos de Windows

Familia de dispositivos	Windows 10 (se introdujo en la versión 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)

Ejemplos

El ejemplo de contratos del selector de archivos muestra cómo responder a un punto de activación 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 para un onFileOpenPickerActivated invalidación hace referencia a un objeto FileOpenPickerActivatedEventArgs. La invalidación OnFileOpenPickerActivated se encuentra en el archivo App.xaml.cs y el Activate método se encuentra en el archivo FileOpenPickerPage.xaml.cs del ejemplo de contratos del selector de archivos.

Comentarios

Obtenga información sobre cómo proporcionar archivos para que el usuario elija de la aplicación en Inicio rápido: Proporcionar servicios de archivos a través de y en la referencia del espacio de nombres Windows.Storage.Pickers.Provider .

Un objeto FileOpenPickerActivatedEventArgs se pasa al controlador de eventos activado de la aplicación cuando el usuario quiere seleccionar archivos o carpetas proporcionados por la aplicación. Este tipo de activación se indica mediante el valor ActivationKind.FileOpenPicker devuelto por la propiedad Kind .

Las aplicaciones escritas en JavaScript deben escuchar y controlar los eventos Windows.UI.WebUI.webUIApplication.activated .

La aplicación para UWP que usa C++, C# o Visual Basic suele implementar puntos de activación reemplazando métodos del objeto Application . Los archivos de código subyacente de la plantilla predeterminada app.xaml siempre incluyen una invalidación para OnLaunched, pero la definición de invalidaciones para otros puntos de activación, como OnFileOpenPickerActivated , depende del código de la aplicación.

Todas las invalidaciones de aplicación implicadas en un escenario de activación deben llamar a Window.Activate en sus implementaciones.

Historial de versiones

Versión de Windows	Versión del SDK	Valor agregado
1607	14393	Usuario

Propiedades

CallerPackageFamilyName	El nombre de familia del paquete de la aplicación que inició la aplicación.
FileOpenPickerUI	Obtiene la interfaz de usuario del cuadro de letras del selector de archivos que se muestra cuando el usuario quiere seleccionar archivos o carpetas proporcionados por la aplicación.
Kind	Obtiene el tipo de activación.
PreviousExecutionState	Obtiene el estado de ejecución de la aplicación antes de activarla.
SplashScreen	Obtiene un objeto SplashScreen que proporciona información sobre la transición de la pantalla de presentación a la aplicación activada.
User	Obtiene el usuario para el que se activó la aplicación.

Consulte también

• OnFileOpenPickerActivated(FileOpenPickerActivatedEventArgs)
• Application
• FileOpenPicker
• Windows.Storage.Pickers.Provider
• Activated
• Activated
• Inicio rápido: Proporcionar servicios de archivos a través de
• Ejemplo de contratos de selector de archivos