FileSavePickerUI クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
アプリがファイル保存ピッカー コントラクトを使用して保存場所を提供するときに、ファイル ピッカーと対話するために使用されます。
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 オブジェクトが 含まれます。 さらに、 OnFileSavePickerActivated
は App.xaml.cs ファイル内にあり、 Activate
メソッドは ファイル ピッカー サンプルの FileSavePickerPage.xaml.cs ファイルにあります。
注釈
アプリがファイル保存ピッカー コントラクトに参加している場合は、FileSavePicker アクティブ化イベントを処理するときに fileSavePickerUI プロパティを使用してこのオブジェクトにアクセスできます。
FileSavePickerActivatedEventArgs.FileSavePickerUI プロパティを使用して、fileSavePickerUI オブジェクトを取得します。
ユーザーがアプリを保存場所として使用するときの優れたエクスペリエンスを作成する方法については、「ピッカーを使用して ファイルとフォルダーを開く」を参照してください。
プロパティ
AllowedFileTypes |
保存場所を提供するアプリに保存できるファイルの種類 (拡張子) の一覧を取得します。 |
FileName |
ファイルの種類の拡張子を含め、保存するファイルの完全なファイル名を取得します。 ファイル名と拡張子は、ユーザーによって指定されます。 |
SettingsIdentifier |
ファイル ピッカーの現在のコンテキストの識別子を取得します。 |
Title |
ファイル ピッカー UI に表示するタイトルを取得または設定します。これは、ファイル ピッカーがユーザーに表示する場所を識別します。 |
メソッド
TrySetFileName(String) |
ファイル ピッカー UI でファイル名と拡張子の設定を試みます。 |
イベント
FileNameChanged |
ユーザーがファイル名テキスト ボックスのファイル名を変更するか、ファイルの種類のドロップダウン メニューで拡張子を変更したときに発生します。 |
TargetFileRequested |
ユーザーがファイル ピッカーに保存するファイルをコミットすると発生します。 |