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/上一頁按鈕來解除控制項的距離並離開控制項。 您可以呼叫 RemoveFocusEngagement 以程式設計方式解除控制項。

如需詳細資訊，請參閱設計 Xbox 和電視文章的焦點參與一節。

版本相容性

RemoveFocusEngagement 方法在 Windows 10 1607 版之前無法使用。 如果您的 App 在 Microsoft Visual Studio 中的「最低平臺版本」設定小於此頁面稍後的 [需求] 區塊中顯示的「引進版本」，您必須設計並測試您的應用程式以考慮此設定。 如需詳細資訊，請參閱 版本調適型程式碼。

若要避免在舊版Windows 10上執行應用程式時發生例外狀況，請勿在沒有先執行執行時間檢查的情況下呼叫此方法。 此範例示範如何使用 ApiInformation 類別來檢查此方法是否存在，再使用它。

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