FileSavePickerUI クラス

リファレンス

定義

名前空間:: Windows.Storage.Pickers.Provider

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 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

継承: Object Platform::Object IInspectable FileSavePickerUI

属性: ContractVersionAttribute

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	ユーザーがファイルピッカーに保存するファイルをコミットすると発生します。

適用対象

次の方法で共有