RadialController.ScreenContactEnded 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 a wheel device that is in contact with the digitizer surface is removed (or is no longer detected), 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.
This event occurs after ScreenContactStarted.
// Register
event_token ScreenContactEnded(TypedEventHandler<RadialController, IInspectable const&> const& handler) const;
// Revoke with event_token
void ScreenContactEnded(event_token const* cookie) const;
// Revoke with event_revoker
RadialController::ScreenContactEnded_revoker ScreenContactEnded(auto_revoke_t, TypedEventHandler<RadialController, IInspectable const&> const& handler) const;
public event TypedEventHandler<RadialController,object> ScreenContactEnded;
function onScreenContactEnded(eventArgs) { /* Your code */ }
radialController.addEventListener("screencontactended", onScreenContactEnded);
radialController.removeEventListener("screencontactended", onScreenContactEnded);
- or -
radialController.onscreencontactended = onScreenContactEnded;
Public Custom Event ScreenContactEnded As TypedEventHandler(Of RadialController, Object)
Event Type
TypedEventHandler<RadialController,IInspectable>