FileOpenPickerActivatedEventArgs Classe

Definição

Namespace:

Windows.ApplicationModel.Activation

Fornece informações sobre um evento ativado que é acionado quando o usuário tenta escolher arquivos ou pastas fornecidos pelo aplicativo.

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

Herança

Object Platform::Object IInspectable FileOpenPickerActivatedEventArgs

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute

Implementações

IActivatedEventArgs IFileOpenPickerActivatedEventArgs IFileOpenPickerActivatedEventArgs2 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 exemplo de contratos do seletor de arquivos demonstra como responder a um ponto de ativação 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 uma substituição OnFileOpenPickerActivated faz referência a um objeto FileOpenPickerActivatedEventArgs. A substituição OnFileOpenPickerActivated está no arquivo App.xaml.cs e o Activate método está no arquivo FileOpenPickerPage.xaml.cs do exemplo de contratos do seletor de arquivos.

Comentários

Saiba como fornecer arquivos para o usuário escolher em seu aplicativo no Início Rápido: Fornecendo serviços de arquivo por meio de e na referência de namespace Windows.Storage.Pickers.Provider .

Um objeto FileOpenPickerActivatedEventArgs é passado para o manipulador de eventos ativado do aplicativo quando o usuário deseja escolher arquivos ou pastas fornecidos pelo aplicativo. Esse tipo de ativação é indicado pelo valor ActivationKind.FileOpenPicker retornado pela propriedade Kind .

Os aplicativos escritos em JavaScript devem escutar e manipular eventos Windows.UI.WebUI.webUIApplication.activated .

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 OnFileOpenPickerActivated , 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.

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.
FileOpenPickerUI	Obtém a interface do usuário da caixa de correio do seletor de arquivos exibido quando o usuário deseja escolher arquivos ou pastas fornecidos pelo aplicativo.
Kind	Obtém o tipo de ativação.
PreviousExecutionState	Obtém o estado de execução do aplicativo antes de ser ativado.
SplashScreen	Obtém um objeto SplashScreen 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.

Confira também

• OnFileOpenPickerActivated(FileOpenPickerActivatedEventArgs)
• Application
• FileOpenPicker
• Windows.Storage.Pickers.Provider
• Activated
• Activated
• Início Rápido: Fornecendo serviços de arquivo por meio de
• Exemplo de contratos de seletor de arquivos