Control.FocusDisengaged 事件

定義

命名空間:

Windows.UI.Xaml.Controls

當焦點從遊戲台/遠端互動 () 的控制項界限釋放時發生。

// Register
event_token FocusDisengaged(TypedEventHandler<Control, FocusDisengagedEventArgs const&> const& handler) const;

// Revoke with event_token
void FocusDisengaged(event_token const* cookie) const;

// Revoke with event_revoker
Control::FocusDisengaged_revoker FocusDisengaged(auto_revoke_t, TypedEventHandler<Control, FocusDisengagedEventArgs const&> const& handler) const;

public event TypedEventHandler<Control,FocusDisengagedEventArgs> FocusDisengaged;

function onFocusDisengaged(eventArgs) { /* Your code */ }
control.addEventListener("focusdisengaged", onFocusDisengaged);
control.removeEventListener("focusdisengaged", onFocusDisengaged);
- or -
control.onfocusdisengaged = onFocusDisengaged;

Public Custom Event FocusDisengaged As TypedEventHandler(Of Control, FocusDisengagedEventArgs) 

<control FocusDisengaged="eventhandler"/>

事件類型

TypedEventHandler<Control,FocusDisengagedEventArgs>

Windows 需求

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

備註

如需事件資料，請參閱 FocusDisengagedEventArgs。

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

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

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

版本相容性

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

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

<Slider x:Name="slider1" Loaded="Slider_Loaded"/>

private void Slider_Loaded(object sender, RoutedEventArgs e)
{
    if (ApiInformation.IsEventPresent("Windows.UI.Xaml.Controls.Control", "FocusDisengaged"))
    {
        slider1.FocusDisengaged += Slider1_FocusDisengaged;
    }
}