DwellHandler Class

Reference

Definition

Namespace:: Microsoft.MixedReality.Toolkit.Dwell

Assembly:: Microsoft.MixedReality.Toolkit.SDK.dll

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.

Use this component to add a Dwell modality (https://docs.microsoft.com/windows/mixed-reality/gaze-and-dwell) to the UI target.

public ref class DwellHandler : UnityEngine::MonoBehaviour, Microsoft::MixedReality::Toolkit::Input::IMixedRealityFocusChangedHandler, UnityEngine::EventSystems::IEventSystemHandler

[UnityEngine.AddComponentMenu("Scripts/MRTK/SDK/DwellHandler")]
public class DwellHandler : UnityEngine.MonoBehaviour, Microsoft.MixedReality.Toolkit.Input.IMixedRealityFocusChangedHandler, UnityEngine.EventSystems.IEventSystemHandler

[<UnityEngine.AddComponentMenu("Scripts/MRTK/SDK/DwellHandler")>]
type DwellHandler = class
    inherit MonoBehaviour
    interface IMixedRealityFocusChangedHandler
    interface IEventSystemHandler

Public Class DwellHandler
Inherits MonoBehaviour
Implements IEventSystemHandler, IMixedRealityFocusChangedHandler

Inheritance: UnityEngine.MonoBehaviour
DwellHandler

Attributes: UnityEngine.AddComponentMenuAttribute

Implements: IMixedRealityFocusChangedHandler UnityEngine.EventSystems.IEventSystemHandler

Constructors

DwellHandler()

Fields

dwellProfile

Properties

CurrentDwellState	Captures the dwell status
DwellCanceled	The event to trigger when losing focus while being in the dwell started state
DwellCompleted	The event to trigger when being focused longer than the TimeToCompleteDwell after the DwellStartDelay
DwellIntended	The event to trigger when being focused longer than the DwellIntentDelay
DwellProfile	The profile to use with this handler
DwellProgress	Property exposing the computation for what percentage of dwell has progressed, ranging from 0 to 1.
DwellStarted	The event to trigger when being focused longer than the DwellStartDelay after the DwellIntentDelay
FillTimer	Abstracted value for the how long the dwelled object still needs to be focused to complete the dwell action Value ranges from 0 to "TimeToCompleteDwell" setting in the dwellprofile. This picks up the same unit as TimeToCompleteDwell
HasFocus	Exposes whether the target has focus from the pointer type defined in dwell profile settings

Methods

CancelDwell()	Method that can be invoked if external factors (e.g. alternate input modality preemptively invoked the target) force the dwell action to prematurely end
GetCurrentDwellProgress()	Get the current progess of dwell. Return value ranges from 0 to 1.
OnBeforeFocusChange(FocusEventData)	Focus event that is raised before the focus is actually changed.
OnFocusChanged(FocusEventData)	Focus event that is raised when the focused object is changed.
UpdateFillTimer()	Default FillTimer computation based on profile settings

Applies to