FileOpenPickerUI クラス

リファレンス

定義

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

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

編集

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

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 イベントは非推奨であり、使用しないでください。ユーザーがファイルを提供しているアプリによってファイルが追加された場合に、ユーザーが選択したファイルの一覧からファイルを削除すると発生します。

適用対象

次の方法で共有