RadialController.ScreenContactStarted 事件
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
在轮设备和数字化器表面之间检测到初始接触并且自定义 RadialController 工具处于活动状态时发生。
应用在以下情况下不会收到此事件:
- RadialController 菜单处于活动状态
- 内置工具处于活动状态
提示
除了默认的长按菜单体验外,Surface Dial 还可以直接放置在Surface Studio屏幕上。 这会启用一个特殊的“屏幕”菜单。
通过检测 Surface Dial 的接触位置和边界,系统可以处理设备的遮挡,并显示环绕拨号外部的更大版本的菜单。 应用还可以使用这一相同信息针对设备的存在及其预期用途(例如用户的手和臂的放置)排布 UI。
// Register
event_token ScreenContactStarted(TypedEventHandler<RadialController, RadialControllerScreenContactStartedEventArgs const&> const& handler) const;
// Revoke with event_token
void ScreenContactStarted(event_token const* cookie) const;
// Revoke with event_revoker
RadialController::ScreenContactStarted_revoker ScreenContactStarted(auto_revoke_t, TypedEventHandler<RadialController, RadialControllerScreenContactStartedEventArgs const&> const& handler) const;
public event TypedEventHandler<RadialController,RadialControllerScreenContactStartedEventArgs> ScreenContactStarted;
function onScreenContactStarted(eventArgs) { /* Your code */ }
radialController.addEventListener("screencontactstarted", onScreenContactStarted);
radialController.removeEventListener("screencontactstarted", onScreenContactStarted);
- or -
radialController.onscreencontactstarted = onScreenContactStarted;
Public Custom Event ScreenContactStarted As TypedEventHandler(Of RadialController, RadialControllerScreenContactStartedEventArgs)