FileActivatedEventArgs Classe

Definição

Namespace:

Windows.ApplicationModel.Activation

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

Javascript Esse 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

Herança

Object Platform::Object IInspectable FileActivatedEventArgs

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute

Implementações

IActivatedEventArgs IApplicationViewActivatedEventArgs IFileActivatedEventArgs IFileActivatedEventArgsWithCallerPackageFamilyName IFileActivatedEventArgsWithNeighboringFiles IViewSwitcherProvider IActivatedEventArgsWithUser

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.

Confira também

• Windows.Storage
• Activated
• OnFileActivated(FileActivatedEventArgs)
• Amostra de inicialização de associação
• Manipular a ativação do arquivo
• Diretrizes para tipos de arquivos e URIs
• Exemplo de inicialização de associação (Windows 10)