Control.IsFocusEngaged 屬性

定義

命名空間:

Windows.UI.Xaml.Controls

取得或設定值，這個值表示焦點是否限制在遊戲台/遠端互動 (的控制界限內) 。

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

bool IsFocusEngaged();

void IsFocusEngaged(bool value);

public bool IsFocusEngaged { get; set; }

var boolean = control.isFocusEngaged;
control.isFocusEngaged = boolean;

Public Property IsFocusEngaged As Boolean

<control IsFocusEngaged="bool"/>

屬性值

Boolean

bool

如果焦點在控制界限內受到限制，則為true;否則為false。

Windows 需求

裝置系列	Windows 10 Anniversary Edition (已於 10.0.14393.0 引進)
API contract	Windows.Foundation.UniversalApiContract (已於 v3.0 引進)

備註

IsFocusEngagementEnabled 必須是 true ，而且控制項必須有焦點，才能將 IsFocusEngaged 屬性設定為 true。 否則，會發生執行時間例外狀況。

焦點參與可讓您更輕鬆地使用遊戲台或遙控器來與應用程式互動。 設定焦點參與不會影響鍵盤或其他輸入裝置。

當 IsFocusEngagementEnabled 屬性設定為 true時，它會將控制項標示為需要焦點參與。 這表示，使用者必須按下 \[A/選取\] 按鈕來「佔住」控制項並與它互動。 完成時，他們可以按 B/上一頁按鈕來解除控制項並離開控制項。

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

版本相容性

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

若要避免在舊版Windows 10上執行您的應用程式時發生例外狀況，請勿在 XAML 中設定此屬性，或在不執行執行時間檢查的情況下使用它。 此範例示範如何使用 ApiInformation 類別來檢查此屬性是否存在，再加以設定。

if (ApiInformation.IsPropertyPresent("Windows.UI.Xaml.Controls.Control", "IsFocusEngaged"))
{
    slider1.IsFocusEngaged = true;
}