RadialController.ScreenContactStarted Event

Definition

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:

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
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) 

Event Type

TypedEventHandler<RadialController,RadialControllerScreenContactStartedEventArgs>

Applies to

See also