UI.LastElementSourceFocused

static BtnState LastElementSourceFocused(InteractorSource source)

Tells if an interactor from the given source was involved in the focus state of the most recently called UI element using an id. Focus occurs when the interactor is in or near an element, in such a way that indicates the user may be about to interact with it. Sources can be combined as a bit-flag to ask about several at once.


InteractorSource source	The source, or combination of sources, to check.
RETURNS: BtnState	A BtnState that indicates the source was “just focused” this frame, is currently “focused”, or if it “just became unfocused” this frame.

Examples

Checking UI element status

It can sometimes be nice to know how the user is interacting with a particular UI element! The UI.LastElementX functions can be used to query a bit of this information, but only for the most recent UI element that uses an id!

A window containing the status of a UI element

So in this example, we’re querying the information for the “Slider” UI element. Note that UI.Text does NOT use an id, which is why this works.

UI.WindowBegin("Last Element API", ref windowPose);

UI.HSlider("Slider", ref sliderVal, 0, 1, 0.1f, 0, UIConfirm.Pinch);
UI.Text("Element Info:", Align.TopCenter);
if (UI.LastElementSourceActive (InteractorSource.HandLeft  | InteractorSource.ControllerLeft ).IsActive()) UI.Label("Left Active");
if (UI.LastElementSourceActive (InteractorSource.HandRight | InteractorSource.ControllerRight).IsActive()) UI.Label("Right Active");
if (UI.LastElementSourceFocused(InteractorSource.HandLeft  | InteractorSource.ControllerLeft ).IsActive()) UI.Label("Left Focused");
if (UI.LastElementSourceFocused(InteractorSource.HandRight | InteractorSource.ControllerRight).IsActive()) UI.Label("Right Focused");
if (UI.LastElementFocused.IsActive()) UI.Label("Focused");
if (UI.LastElementActive .IsActive()) UI.Label("Active");

UI.WindowEnd();

Found an issue with these docs, or have some additional questions? Create an Issue on Github!