Control.IsFocusEngagementEnabled 屬性

定義

命名空間:

Windows.UI.Xaml.Controls

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

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"/>

屬性值

Boolean

bool

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

Windows 需求

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

備註

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

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

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

版本相容性

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

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

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