Compartir a través de


FileActivatedEventArgs Clase

Definición

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 : IApplicationViewActivatedEventArgs, IFileActivatedEventArgsWithCallerPackageFamilyName, IFileActivatedEventArgsWithNeighboringFiles, IViewSwitcherProvider
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 : 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 : 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 IApplicationViewActivatedEventArgs, IFileActivatedEventArgsWithCallerPackageFamilyName, IFileActivatedEventArgsWithNeighboringFiles, IViewSwitcherProvider
Public NotInheritable Class FileActivatedEventArgs
Implements IActivatedEventArgsWithUser, IApplicationViewActivatedEventArgs, IFileActivatedEventArgsWithCallerPackageFamilyName, IFileActivatedEventArgsWithNeighboringFiles, IViewSwitcherProvider
Herencia
Object Platform::Object IInspectable FileActivatedEventArgs
Atributos
Implementaciones

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.

Se aplica a

Consulte también