RadialController.ScreenContactStarted Ereignis
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Tritt auf, wenn ein anfänglicher Kontakt zwischen einem Radgerät und der Digitizeroberfläche erkannt wird und ein benutzerdefiniertes RadialController-Tool aktiv ist.
Ihre App empfängt dieses Ereignis nicht in folgenden Fällen:
- Das RadialController-Menü ist aktiv.
- Ein integriertes Tool ist aktiv
Tipp
Zusätzlich zum standardmäßigen Drücken und Halten des Menüs kann das Surface Dial auch direkt auf dem Bildschirm des Surface Studio platziert werden. Dadurch wird ein spezielles Onscreen-Menü aktiviert.
Durch die Erkennung der Kontaktposition und der Grenzen des Surface Dial kann das System die Okklusion durch das Gerät verarbeiten und eine größere Version des Menüs anzeigen, das um die Außenseite des Dial umschließt. Auch die App kann diese Informationen nutzen, um die Benutzeroberfläche an das Vorhandensein des Geräts und dessen beabsichtigte Nutzung anzupassen, z. B. daran, wie der Benutzer seine Hand und seinen Arm platziert.
// 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)