FileSavePickerUI 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 quando seu aplicativo fornece um local de salvamento com o contrato do Seletor de Salvamento de Arquivos.
public ref class FileSavePickerUI sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class FileSavePickerUI final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public sealed class FileSavePickerUI
Public NotInheritable Class FileSavePickerUI
- 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 seletor de arquivos demonstra como responder a um evento ativado FileSavePicker .
// fileSavePicker activated event handler
protected override void OnFileSavePickerActivated(FileSavePickerActivatedEventArgs args)
{
var FileSavePickerPage = new SDKTemplate.FileSavePickerPage();
FileSavePickerPage.Activate(args);
}
// Overloaded method to respond to fileSavePicker events
internal void Activate(FileSavePickerActivatedEventArgs args)
{
// Perform tasks to prepare your app to display its file picker page
// Get file picker UI
fileSavePickerUI = args.FileSavePickerUI;
Window.Current.Content = this;
this.OnNavigatedTo(null);
Window.Current.Activate();
}
Para C#, args
contém um objeto FileSavePickerActivatedEventArgs . Além disso, o OnFileSavePickerActivated
está no arquivo App.xaml.cs e o Activate
método está no arquivo FileSavePickerPage.xaml.cs do exemplo do seletor de arquivos.
Comentários
Se seu aplicativo participar do contrato do Seletor de Salvamento de Arquivos, você poderá acessar esse objeto usando uma propriedade fileSavePickerUI enquanto manipula um evento ativado FileSavePicker .
Use a propriedade FileSavePickerActivatedEventArgs.FileSavePickerUI para recuperar um objeto fileSavePickerUI.
Para saber mais sobre como criar uma boa experiência para os usuários quando eles usam seu aplicativo como um local de salvamento, consulte Abrir arquivos e pastas com um seletor.
Propriedades
AllowedFileTypes |
Obtém uma lista de tipos de arquivo (extensões) que podem ser salvos no aplicativo que está fornecendo o local de salvamento. |
FileName |
Obtém o nome completo do arquivo a ser salvo, incluindo a extensão de tipo de arquivo. O nome do arquivo e a extensão são especificados pelo usuário. |
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
TrySetFileName(String) |
Tenta definir o nome do arquivo e a extensão na interface do usuário do seletor de arquivos. |
Eventos
FileNameChanged |
Acionado quando o usuário altera o nome do arquivo na caixa de texto nome de arquivo ou altera a extensão no menu suspenso tipo de arquivo. |
TargetFileRequested |
Aciona quando o usuário confirma um arquivo a ser salvo no seletor de arquivos. |