FileActivatedEventArgs Classe

Definição

Fornece dados quando um aplicativo é ativado porque é o aplicativo associado a um arquivo.

Javascript Esse 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
Herança
Object Platform::Object IInspectable FileActivatedEventArgs
Atributos
Implementações

Requisitos do Windows

Família de dispositivos
Windows 10 (introduzida na 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduzida na v1.0)

Exemplos

O manipulador de eventos OnFileActivated no objeto Application recebe todos os eventos de ativação de arquivo.

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
}

Comentários

Esse objeto é acessado quando você implementa um manipulador de eventos para responder a eventos ativados quando ActivationKind é Arquivo.

O aplicativo UWP usando C++, C#ou Visual Basic normalmente implementa pontos de ativação substituindo métodos do objeto Application . Os arquivos code-behind do modelo padrão app.xaml sempre incluem uma substituição para OnLaunched, mas definir substituições para outros pontos de ativação, como OnFileActivated , depende do código do aplicativo.

Todas as substituições de aplicativo envolvidas em um cenário de ativação devem chamar Window.Activate em suas implementações.

Observe que quando seu aplicativo é ativado para o contrato de arquivo, você deve acessar os dados usando os objetos StorageFile passados para seu aplicativo por meio da propriedade Files . Você não deve tentar acessar o caminho do arquivo, pois seu aplicativo pode não ter permissão para o local do arquivo.

Histórico de versão

Versão do Windows Versão do SDK Valor adicionado
1607 14393 Usuário

Propriedades

CallerPackageFamilyName

O nome da família de pacotes do aplicativo que iniciou seu aplicativo.

CurrentlyShownApplicationViewId

Obtém o identificador para a exibição de aplicativo mostrada no momento.

Files

Obtém os arquivos para os quais o aplicativo foi ativado.

Kind

Obtém o tipo de ativação.

NeighboringFilesQuery

Obtém os arquivos vizinhos dos arquivos para os quais o aplicativo foi ativado.

PreviousExecutionState

Obtém o estado de execução do aplicativo antes de ser ativado.

SplashScreen

Obtém o objeto de tela inicial que fornece informações sobre a transição da tela inicial para o aplicativo ativado.

User

Obtém o usuário para o qual o aplicativo foi ativado.

Verb

Obtém a ação associada ao arquivo ativado.

ViewSwitcher

Fornece o objeto que permite definir a exibição para o aplicativo.

Aplica-se a

Confira também