次の方法で共有

FileOpenPickerUI クラス

  • リファレンス

定義

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

アプリでファイルを開くピッカー コントラクトを使用してファイルを提供する場合に、ファイル ピッカーを操作するために使用されます。

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
継承
Object Platform::Object IInspectable FileOpenPickerUI
属性
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 で導入)

例

ファイル ピッカー プロバイダーのサンプルでは、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();
}

C# の場合、 args には FileOpenPickerActivatedEventArgs オブジェクトが 含まれます。 さらに、 OnFileOpenPickerActivated は App.xaml.cs ファイル内にあり、 Activate メソッドは ファイル ピッカー プロバイダー サンプルの FileOpenPickerPage.xaml.cs ファイルにあります。

注釈

アプリが File Open Picker コントラクトに参加している場合は、FileOpenPicker のアクティブ化されたイベントを処理するときに、 FileOpenPickerUI プロパティを使用してこのオブジェクトを取得できます。

FileOpenPickerUI にアクセスするには、Windows.ApplicationModel.Activation.FileOpenPickerActivatedEventArgs.FileOpenPickerUI プロパティを使用します。

ユーザーがファイル ピッカーを使用してファイルにアクセスするときの優れたエクスペリエンスを作成する方法については、「ピッカーを使用してファイル とフォルダーを開く」でファイルを提供するための UX ガイドラインを参照してください。

プロパティ

AllowedFileTypes

ユーザーが選択できるファイルの種類 (拡張子) の一覧を取得します。
SelectionMode

ファイル ピッカーが現在選択を 1 つのファイルに制限しているか、複数のファイルを選択できるかを示す列挙値を取得します。
SettingsIdentifier

ファイル ピッカーの現在のコンテキストの識別子を取得します。
Title

ファイル ピッカー UI に表示するタイトルを取得または設定します。これは、ファイル ピッカーがユーザーに表示する場所を識別します。

メソッド

AddFile(String, IStorageFile)

指定したファイルを、ユーザーが選択したファイルの一覧に追加します。
CanAddFile(IStorageFile)

指定したファイルを、ユーザーが選択したファイルの一覧に追加できるかどうかを示します。
ContainsFile(String)

指定したファイルが、ユーザーが選択したファイルの一覧に含まれているかどうかを判断します。
RemoveFile(String)

ユーザーが選択したファイルの一覧から指定したファイルを削除します。

イベント

Closing

ユーザーがファイル ピッカーを閉じると発生します。
FileRemoved

Note

FileRemoved イベントは非推奨であり、使用しないでください。

ユーザーがファイルを提供しているアプリによってファイルが追加された場合に、ユーザーが選択したファイルの一覧からファイルを削除すると発生します。

適用対象

こちらもご覧ください