FileActivatedEventArgs Clase

Definición

Espacio de nombres:

Windows.ApplicationModel.Activation

Proporciona datos cuando se activa una aplicación porque es la aplicación asociada a un archivo.

Javascript Este tipo aparece como WebUIFileActivatedEventArgs.

public ref class FileActivatedEventArgs sealed : IActivatedEventArgsWithUser, IApplicationViewActivatedEventArgs, IFileActivatedEventArgsWithCallerPackageFamilyName, IFileActivatedEventArgsWithNeighboringFiles, IViewSwitcherProvider

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class FileActivatedEventArgs final : IActivatedEventArgsWithUser, IApplicationViewActivatedEventArgs, IFileActivatedEventArgsWithCallerPackageFamilyName, IFileActivatedEventArgsWithNeighboringFiles, IViewSwitcherProvider

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class FileActivatedEventArgs : IActivatedEventArgsWithUser, IApplicationViewActivatedEventArgs, IFileActivatedEventArgsWithCallerPackageFamilyName, IFileActivatedEventArgsWithNeighboringFiles, IViewSwitcherProvider

Public NotInheritable Class FileActivatedEventArgs
Implements IActivatedEventArgsWithUser, IApplicationViewActivatedEventArgs, IFileActivatedEventArgsWithCallerPackageFamilyName, IFileActivatedEventArgsWithNeighboringFiles, IViewSwitcherProvider

Herencia

Object Platform::Object IInspectable FileActivatedEventArgs

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute

Implementaciones

IActivatedEventArgs IApplicationViewActivatedEventArgs IFileActivatedEventArgs IFileActivatedEventArgsWithCallerPackageFamilyName IFileActivatedEventArgsWithNeighboringFiles IViewSwitcherProvider 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 controlador de eventos OnFileActivated del objeto Application recibe todos los eventos de activación de archivos.

protected override void OnFileActivated(FileActivatedEventArgs args)
{
       // TODO: Handle file activation

       // The number of files received is args.Files.Size
       // The first file is args.Files[0].Name
}

Private Sub OnFileActivated(ByVal args As Windows.ApplicationModel.Activation.FileActivatedEventArgs)
      ' TODO: Handle file activation

      ' The number of files received is args.Files.Size
      ' The first file is args.Files(0).Name
End Sub

void App::OnFileActivated(Windows::ApplicationModel::Activation::FileActivatedEventArgs const& /* args */)
{
    // TODO: Handle file activation.

    // The number of files received is args.Files().Size().
    // The first file is args.Files().GetAt(0).Name().
}

void App::OnFileActivated(Windows::ApplicationModel::Activation::FileActivatedEventArgs^ args)
{
       // TODO: Handle file activation

       // The number of files received is args->Files->Size
       // The first file is args->Files->GetAt(0)->Name
}

Comentarios

Se obtiene acceso a este objeto cuando se implementa un controlador de eventos para responder a eventos activados cuando ActivationKind es File.

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 definir invalidaciones para otros puntos de activación, como OnFileActivated , 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.

Ten en cuenta que cuando la aplicación se activa para el contrato de archivos, debes tener acceso a los datos mediante los objetos StorageFile pasados a la aplicación a través de la propiedad Files . No debes intentar acceder a la ruta de acceso del archivo, ya que es posible que la aplicación no tenga permiso para la ubicación del archivo.

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.
CurrentlyShownApplicationViewId	Obtiene el identificador de la vista de aplicación mostrada actualmente.
Files	Obtiene los archivos para los que se activó la aplicación.
Kind	Obtiene el tipo de activación.
NeighboringFilesQuery	Obtiene los archivos vecinos de los archivos para los que se activó la aplicación.
PreviousExecutionState	Obtiene el estado de ejecución de la aplicación antes de activarla.
SplashScreen	Obtiene el objeto de pantalla de presentación 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.
Verb	Obtiene la acción asociada al archivo activado.
ViewSwitcher	Proporciona el objeto que permite establecer la vista de la aplicación.

Consulte también

• Windows.Storage
• Activated
• OnFileActivated(FileActivatedEventArgs)
• Ejemplo de inicio por asociación
• Administrar la activación de archivos
• Directrices sobre tipos de archivo y URI
• Ejemplo de inicio de asociación (Windows 10)