Compartilhar via


FileOpenPickerUI Classe

Definição

Usado para interagir com o seletor de arquivos se o aplicativo fornecer arquivos com o contrato do Seletor de Arquivos Abertos.

public ref class FileOpenPickerUI sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class FileOpenPickerUI final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public sealed class FileOpenPickerUI
Public NotInheritable Class FileOpenPickerUI
Herança
Object Platform::Object IInspectable FileOpenPickerUI
Atributos

Requisitos do Windows

Família de dispositivos
Windows 10 (introduzida na 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract
Windows.Foundation.UniversalApiContract (introduzida na v1.0)

Exemplos

O exemplo de provedor de seletor de arquivos demonstra como responder a um evento ativado 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 contém um objeto FileOpenPickerActivatedEventArgs . Além disso, o OnFileOpenPickerActivated está no arquivo App.xaml.cs e o Activate método está no arquivo FileOpenPickerPage.xaml.cs do exemplo do provedor do seletor de arquivos.

Comentários

Se o aplicativo participar do contrato do Seletor de Arquivo Aberto, você poderá recuperar esse objeto usando uma propriedade FileOpenPickerUI enquanto manipula um evento ativado FileOpenPicker .

Use a propriedade Windows.ApplicationModel.Activation.FileOpenPickerActivatedEventArgs.FileOpenPickerUI para acessar um FileOpenPickerUI.

Saiba mais sobre como criar uma boa experiência para os usuários quando eles acessam seus arquivos por meio do seletor de arquivos lendo as diretrizes de experiência do usuário para fornecer arquivos em Abrir arquivos e pastas com um seletor.

Propriedades

AllowedFileTypes

Obtém uma lista de tipos de arquivo (extensões) que o usuário pode escolher.

SelectionMode

Obtém um valor de enumeração que indica se o seletor de arquivos atualmente limita a seleção a arquivos únicos ou se vários arquivos podem ser selecionados.

SettingsIdentifier

Obtém um identificador para o contexto atual do seletor de arquivos.

Title

Obtém ou define um título a ser exibido na interface do usuário do seletor de arquivos que identifica o local que o seletor de arquivos está exibindo para o usuário.

Métodos

AddFile(String, IStorageFile)

Adiciona o arquivo especificado à lista de arquivos escolhidos pelo usuário.

CanAddFile(IStorageFile)

Indica se o arquivo especificado pode ser adicionado à lista de arquivos escolhidos pelo usuário.

ContainsFile(String)

Determina se o arquivo especificado está na lista de arquivos escolhidos pelo usuário.

RemoveFile(String)

Remove o arquivo especificado da lista de arquivos escolhidos pelo usuário.

Eventos

Closing

Dispara quando o usuário fecha o seletor de arquivos.

FileRemoved

Observação

O evento FileRemoved foi preterido e não deve ser usado.

Aciona quando o usuário remove um arquivo da lista de arquivos que o usuário escolheu se esse arquivo foi adicionado pelo aplicativo que está fornecendo arquivos.

Aplica-se a

Confira também