FileSavePickerUI Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Используется для взаимодействия с элементом выбора файлов, когда приложение предоставляет расположение для сохранения с помощью контракта средства выбора файлов.
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
- Наследование
- Атрибуты
Требования к Windows
Семейство устройств |
Windows 10 (появилось в 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
|
API contract |
Windows.Foundation.UniversalApiContract (появилось в v1.0)
|
Примеры
В примере средства выбора файлов показано, как реагировать на событие, активированное 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();
}
Для C# args
содержит объект FileSavePickerActivatedEventArgs . Кроме того, находится в файле App.xaml.cs, OnFileSavePickerActivated
а Activate
метод — в файле FileSavePickerPage.xaml.cs примера средства выбора файлов.
Комментарии
Если приложение участвует в контракте средства выбора для сохранения файлов, доступ к этому объекту можно получить с помощью свойства fileSavePickerUI при обработке события активации FileSavePicker .
Используйте свойство FileSavePickerActivatedEventArgs.FileSavePickerUI для получения объекта fileSavePickerUI.
Сведения о создании удобного интерфейса для пользователей при использовании приложения в качестве расположения для сохранения см. в статье Открытие файлов и папок с помощью средства выбора.
Свойства
AllowedFileTypes |
Возвращает список типов файлов (расширений), которые можно сохранить в приложении, которое предоставляет расположение для сохранения. |
FileName |
Возвращает полное имя файла для сохранения, включая расширение типа файла. Имя и расширение файла указываются пользователем. |
SettingsIdentifier |
Возвращает идентификатор для текущего контекста средства выбора файлов. |
Title |
Возвращает или задает заголовок, отображаемый в пользовательском интерфейсе средства выбора файлов, который определяет расположение, которое средство выбора файлов отображает пользователю. |
Методы
TrySetFileName(String) |
Пытается задать имя и расширение файла в пользовательском интерфейсе средства выбора файлов. |
События
FileNameChanged |
Возникает, когда пользователь изменяет имя файла в текстовом поле имя файла или изменяет расширение в раскрывающемся меню типа файла. |
TargetFileRequested |
Возникает, когда пользователь фиксирует файл для сохранения в средство выбора файлов. |