Control.RemoveFocusEngagement メソッド

定義

名前空間:

Windows.UI.Xaml.Controls

フォーカスエンゲージメントを持つコントロールのコントロール境界からフォーカスを解放します (ゲーム パッド/リモート操作の場合)。

public:
 virtual void RemoveFocusEngagement() = RemoveFocusEngagement;

void RemoveFocusEngagement();

public void RemoveFocusEngagement();

function removeFocusEngagement()

Public Sub RemoveFocusEngagement ()

Windows の要件

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

注釈

フォーカス エンゲージメントを使用すると、ゲーム パッドやリモート コントロールを使用してアプリを操作しやすくなります。 フォーカスエンゲージメントを設定しても、キーボードやその他の入力デバイスには影響しません。

IsFocusEngagementEnabled プロパティが true に設定されている場合、コントロールはフォーカスエンゲージメントを必要とするとマークされます。 この場合、コントロールを "獲得" して操作するには、ユーザーが A/[選択] ボタンをクリックする必要があります。 完了したら、B/Back ボタンを押してコントロールを外し、そこから移動できます。 RemoveFocusEngagement を呼び出して、プログラムによってコントロールを解除できます。

詳細については、Xbox とテレビの設計に関する記事の「フォーカス エンゲージメント」セクションを参照してください。

バージョンの互換性

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

以前のバージョンのWindows 10でアプリを実行するときに例外を回避するには、最初にランタイム チェックを実行せずにこのメソッドを呼び出さないでください。 この例では、ApiInformation クラスを使用して、使用する前にこのメソッドの存在をチェックする方法を示します。

if (ApiInformation.IsMethodPresent("Windows.UI.Xaml.Controls.Control", "RemoveFocusEngagement"))
{
    control1.RemoveFocusEngagement();
}