RadialController.ScreenContactStarted Event
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Occurs when initial contact is detected between a wheel device and the digitizer surface, and a custom RadialController tool is active.
Your app does not receive this event when:
- The RadialController menu is active
- A built-in tool is active
Tip
In addition to the default press and hold menu experience, the Surface Dial can also be placed directly on the screen of the Surface Studio. This enables a special "on-screen" menu.
By detecting both the contact location and bounds of the Surface Dial, the system can handle occlusion by the device and display a larger version of the menu that wraps around the outside of the Dial. This same info can also be used by your app to adapt the UI for both the presence of the device and its anticipated usage, such as the placement of the user's hand and arm.
// 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)