Control.IsFocusEngagementEnabled プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
コントロール境界内でフォーカスを制限できるかどうかを示す値を取得または設定します (ゲーム パッド/リモート操作の場合)。
public:
property bool IsFocusEngagementEnabled { bool get(); void set(bool value); };
bool IsFocusEngagementEnabled();
void IsFocusEngagementEnabled(bool value);
public bool IsFocusEngagementEnabled { get; set; }
var boolean = control.isFocusEngagementEnabled;
control.isFocusEngagementEnabled = boolean;
Public Property IsFocusEngagementEnabled As Boolean
<control IsFocusEngagementEnabled="bool"/>
プロパティ値
bool
コントロール の境界内でフォーカスを制限できる場合は true。それ以外の場合は false。
Windows の要件
デバイス ファミリ |
Windows 10 Anniversary Edition (10.0.14393.0 で導入)
|
API contract |
Windows.Foundation.UniversalApiContract (v3.0 で導入)
|
注釈
フォーカス エンゲージメントを使用すると、ゲーム パッドやリモート コントロールを使用してアプリを操作しやすくなります。 フォーカスエンゲージメントを設定しても、キーボードやその他の入力デバイスには影響しません。
IsFocusEngagementEnabled プロパティが true に設定されている場合、コントロールはフォーカスエンゲージメントを必要とするとマークされます。 この場合、コントロールを "獲得" して操作するには、ユーザーが A/[選択] ボタンをクリックする必要があります。 完了したら、B/Back ボタンを押してコントロールを外し、そこから移動できます。
このプロパティの詳細については、Xbox とテレビの設計に関する記事の「フォーカスエンゲージメント」セクションを参照してください。
バージョンの互換性
IsFocusEngagementEnabled プロパティは、バージョン 1607 より前Windows 10使用できません。 Microsoft Visual Studio のアプリの "最小プラットフォーム バージョン" 設定が、このページの後半の 「要件」 ブロックに示されている "導入されたバージョン" より小さい場合は、これを考慮してアプリを設計してテストする必要があります。 詳細については、「 バージョン アダプティブ コード」を参照してください。
アプリを以前のバージョンのWindows 10で実行するときに例外を回避するには、XAML でこのプロパティを設定したり、ランタイム チェックを実行せずに使用したりしないでください。 この例では、ApiInformation クラスを使用して、設定する前にこのプロパティの存在をチェックする方法を示します。
if (ApiInformation.IsPropertyPresent("Windows.UI.Xaml.Controls.Control", "IsFocusEngagementEnabled"))
{
slider1.IsFocusEngagementEnabled = true;
}