Compartilhar via


FileOpenPickerActivatedEventArgs Classe

Definição

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 : IFileOpenPickerActivatedEventArgs, IFileOpenPickerActivatedEventArgs2
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 : 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 : 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 IFileOpenPickerActivatedEventArgs, IFileOpenPickerActivatedEventArgs2
Public NotInheritable Class FileOpenPickerActivatedEventArgs
Implements IActivatedEventArgsWithUser, IFileOpenPickerActivatedEventArgs, IFileOpenPickerActivatedEventArgs2
Herança
Object Platform::Object IInspectable FileOpenPickerActivatedEventArgs
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 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.

Aplica-se a

Confira também