FileOpenPickerUI Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
- 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. |