Control.RequiresPointer プロパティ

定義

UI 要素がマウス モードをサポートするかどうかを取得または設定します。これは、ゲーム パッドやリモート コントロールなどのポインター以外の入力デバイスとのポインター操作エクスペリエンスをエミュレートします。

public:
 property RequiresPointer RequiresPointer { RequiresPointer get(); void set(RequiresPointer value); };
RequiresPointer RequiresPointer();

void RequiresPointer(RequiresPointer value);
public RequiresPointer RequiresPointer { get; set; }
var requiresPointer = control.requiresPointer;
control.requiresPointer = requiresPointer;
Public Property RequiresPointer As RequiresPointer
<control RequiresPointer="requiresPointerMemberName"/>

プロパティ値

ポインター エミュレーション モード。 既定値は Never です

Windows の要件

デバイス ファミリ
Windows 10 Anniversary Edition (10.0.14393.0 で導入)
API contract
Windows.Foundation.UniversalApiContract (v3.0 で導入)

注釈

ポインター以外の入力デバイスの場合、キーボードの Tab キーと方向キー、リモートの方向パッド (D パッド)、ゲーム コントローラーの親指スティックなど、さまざまな方法でコントロール間でフォーカスが移動されます。 マップや描画サーフェスなどの一部のユーザー エクスペリエンスでは、XY フォーカス ナビゲーションを使用できないか、実用的ではありません。 RequiresPointer を使用すると、アプリは、ゲーム入力デバイスを使用して自由に移動できるカーソルを介して、ポインターに似た操作エクスペリエンスを提供できます。

RequiresPointer は Xbox デバイス ファミリでのみサポートされ、ゲーム パッドまたはリモート コントロールを使用する場合にのみサポートされます。 それ以外の場合、プロパティは無視されます。

RequiresPointerMode は、アプリケーション レベルでマウス モードを設定します。

詳細については、「Xbox とテレビのデザイン」の「マウス モード」セクションを参照してください。

バージョンの互換性

RequiresPointer プロパティは、バージョン 1607 Windows 10より前は使用できません。 Microsoft Visual Studio のアプリの "最小プラットフォーム バージョン" 設定が、このページの後半の 「要件」 ブロックに示されている "導入されたバージョン" より小さい場合は、これを考慮してアプリを設計してテストする必要があります。 詳細については、「 バージョン アダプティブ コード」を参照してください。

以前のバージョンのWindows 10でアプリを実行するときに例外を回避するには、XAML でこのプロパティを設定したり、ランタイム チェックを実行せずに使用したりしないでください。 この例では、ApiInformation クラスを使用して、このプロパティを設定する前に、このプロパティの存在をチェックする方法を示します。

if (ApiInformation.IsPropertyPresent("Windows.UI.Xaml.Controls.Control", "RequiresPointer"))
{
    mapControl1.RequiresPointer = RequiresPointer.WhenEngaged;
}

適用対象

こちらもご覧ください