Class TooltipManager

Namespace

MonkeyLoader.Resonite.UI.Tooltips

Assembly

MonkeyLoader.Resonite.Integration.dll

Handles resolving the labels as well as opening and closing the tooltips for FrooxEngine.IButtons.

public sealed class TooltipManager : ConfiguredResoniteCancelableEventHandlerMonkey<TooltipManager, TooltipConfig, ResolveTooltipLabelEvent>, IResoniteMonkey, ICancelableEventHandler<ResolveTooltipLabelEvent>, IPrioritizable, IConfiguredMonkey<TooltipConfig>, IConfiguredMonkey, IMonkey, IRun, IShutdown, IComparable<IMonkey>, INestedIdentifiable<Mod>, INestedIdentifiable, IIdentifiable, IAuthorable, ICancelableEventSource<ResolveTooltipLabelEvent>

Inheritance

object

MonkeyBase

MonkeyBase<TooltipManager>

Monkey<TooltipManager>

ResoniteMonkey<TooltipManager>

ResoniteCancelableEventHandlerMonkey<TooltipManager, ResolveTooltipLabelEvent>

ConfiguredResoniteCancelableEventHandlerMonkey<TooltipManager, TooltipConfig, ResolveTooltipLabelEvent>

TooltipManager

Implements

IResoniteMonkey

ICancelableEventHandler<ResolveTooltipLabelEvent>

IPrioritizable

IConfiguredMonkey<TooltipConfig>

IConfiguredMonkey

IMonkey

IRun

IShutdown

IComparable<IMonkey>

INestedIdentifiable<Mod>

INestedIdentifiable

IIdentifiable

IAuthorable

ICancelableEventSource<ResolveTooltipLabelEvent>

Inherited Members

ConfiguredResoniteCancelableEventHandlerMonkey<TooltipManager, TooltipConfig, ResolveTooltipLabelEvent>.ConfigSection

ResoniteCancelableEventHandlerMonkey<TooltipManager, ResolveTooltipLabelEvent>.Priority

ResoniteCancelableEventHandlerMonkey<TooltipManager, ResolveTooltipLabelEvent>.SkipCanceled

ResoniteMonkey<TooltipManager>.EngineInitFailed

ResoniteMonkey<TooltipManager>.EngineInitRan

ResoniteMonkey<TooltipManager>.EngineReadyFailed

ResoniteMonkey<TooltipManager>.EngineReadyRan

Monkey<TooltipManager>.Run()

MonkeyBase<TooltipManager>.Config

MonkeyBase<TooltipManager>.Enabled

MonkeyBase<TooltipManager>.Harmony

MonkeyBase<TooltipManager>.Instance

MonkeyBase<TooltipManager>.Logger

MonkeyBase<TooltipManager>.Mod

MonkeyBase.CompareTo(IMonkey)

MonkeyBase.HasAuthor(string)

MonkeyBase.Shutdown(bool)

MonkeyBase.ToString()

MonkeyBase.AssemblyName

MonkeyBase.Authors

MonkeyBase.CanBeDisabled

MonkeyBase.EnabledToggle

MonkeyBase.Failed

MonkeyBase.FeaturePatches

MonkeyBase.FullId

MonkeyBase.Id

MonkeyBase.Name

MonkeyBase.Ran

MonkeyBase.ShutdownFailed

MonkeyBase.ShutdownRan

MonkeyBase.Type

MonkeyBase.ShutdownDone

MonkeyBase.ShuttingDown

object.Equals(object)

object.Equals(object, object)

object.GetHashCode()

object.GetType()

object.ReferenceEquals(object, object)

Extension Methods

LocaleExtensions.GetLocaleKey(IIdentifiable, string)

LocaleExtensions.GetLocaleString(IIdentifiable, string, bool, Dictionary<string, object>?)

LocaleExtensions.GetLocaleString(IIdentifiable, string, string?, bool, Dictionary<string, object>?)

LocaleExtensions.GetLocaleString(IIdentifiable, string, string, object)

LocaleExtensions.GetLocaleString(IIdentifiable, string, string, string, object)

LocaleExtensions.GetLocaleString(IIdentifiable, string, string, params (string, object)[])

LocaleExtensions.GetLocaleString(IIdentifiable, string, params (string, object)[])

LocaleExtensions.GetMessageInCurrent(IIdentifiable, string)

LocaleExtensions.GetMessageInFallback(IIdentifiable, string)

LocaleExtensions.GetMessageInLocale(IIdentifiable, string, LocaleResource)

Properties

Priority

Gets the priority of this item. Use an agreed standard as a base.

public override int Priority { get; }

Property Value

int

An interger used to sort the prioritizable items.
Higher comes first with the default comparer.

SkipCanceled

Gets whether this handler should be skipped for events that have been canceled by a previous event handler.

public override bool SkipCanceled { get; }

Property Value

bool

Methods

CloseTooltip(IButton)

Closes the tooltip for the given button.

public static bool CloseTooltip(IButton button)

Parameters

button IButton

The button the tooltip is attached to.

Returns

bool

true if the tooltip was closed; false if there was no tooltip.

Handle(ResolveTooltipLabelEvent)

Handles the given event based on its data, if AppliesTo returned true.

protected override void Handle(ResolveTooltipLabelEvent eventData)

Parameters

eventData ResolveTooltipLabelEvent

An object containing all the relevant information for the applicable event.

HasLabelForButton(IButton)

Checks whether the given button has a registered label.

public static bool HasLabelForButton(IButton button)

Parameters

button IButton

The button to check for a registered label.

Returns

bool

true if the button has a registered label; otherwise, false.

HasTooltip(IButton)

Checks if there is a Tooltip associated with this FrooxEngine.IButton.

public static bool HasTooltip(IButton button)

Parameters

button IButton

The button the tooltip is attached to.

Returns

bool

true if a Tooltip for this FrooxEngine.IButton was found; otherwise, false.

MakeTooltip(IButton, Slot, in float3, in LocaleString)

Creates a tooltip according to the given parameters for the given button.
Any existing open tooltip will be closed.

public static Tooltip MakeTooltip(IButton button, Slot parent, in float3 startingPosition, in LocaleString label)

Parameters

button IButton

The button the tooltip is attached to.

parent Slot

The slot the tooltip will be parented to.

startingPosition float3

The position that the button starts at inside its parent slot.

label LocaleString

The label that should be shown on the tooltip.

Returns

Tooltip

The data for the newly created tooltip.

OnEngineReady()

Override this method to be called when the FrooxEngine.Engine is ready.
This is the primary method for patching used by Resonite Mods as basic facilities of the game are ready to use, while most other code hasn't been run yet.
Return true if patching was successful.

protected override bool OnEngineReady()

Returns

bool

Whether the patching was successful.

Remarks

Override OnLoaded() to patch before anything is initialized, but strongly consider also overriding this method if you do that.
Otherwise your patches will be applied twice, if you're using [HarmonyLib.HarmonyPatchCategory(nameof(MyPatcher))] attributes.

By default: Registers this Monkey as an event handler and applies the HarmonyLib.Harmony patches of the category with this patcher's type's name.
Easy to apply by using [HarmonyLib.HarmonyPatchCategory(nameof(MyPatcher))] attribute.

OnShutdown(bool)

Lets this monkey cleanup and shutdown.

protected override bool OnShutdown(bool applicationExiting)

Parameters

applicationExiting bool

Whether the shutdown was caused by the application exiting.

Returns

bool

true if it ran successfully; otherwise, false.

Remarks

By default: Unregisters this monkey as an event handler for ResolveTooltipLabelEvents and removes all HarmonyLib.Harmony patches done using this Monkey's Harmony instance, if not exiting, and returns true.

RegisterLabelForButton(IButton, in LocaleString)

Registers a label for the given undestroyed button, if it doesn't already have one.

public static bool RegisterLabelForButton(IButton button, in LocaleString label)

Parameters

button IButton

The undestroyed button to register a label for.

label LocaleString

The label to register for the button.

Returns

bool

true if the label was registered for the button; otherwise, false.

TryGetLabelForButton(IButton, out LocaleString?)

Tries to get the registered label for the given button.

public static bool TryGetLabelForButton(IButton button, out LocaleString? label)

Parameters

button IButton

The button to get the registered label for.

label LocaleString?

The registered label for the button if it has one; otherwise, null.

Returns

bool

true if the button has a registered label; otherwise, false.

TryGetTooltip(IButton, out Tooltip?)

Tries to get the Tooltip associated with this FrooxEngine.IButton.

public static bool TryGetTooltip(IButton button, out Tooltip? tooltip)

Parameters

button IButton

The button the tooltip is attached to.

tooltip Tooltip

The associated Tooltip if one is open; otherwise, null.

Returns

bool

true if a Tooltip for this FrooxEngine.IButton was found; otherwise, false.

TryOpenTooltip(IButton, ButtonEventData, Slot, in float3)

Tries to open a tooltip for the given button details.

public static bool TryOpenTooltip(IButton button, ButtonEventData buttonEventData, Slot tooltipParent, in float3 globalOffset = default)

Parameters

button IButton

The button the tooltip is attached to.

buttonEventData ButtonEventData

The button event triggering opening the tooltip.

tooltipParent Slot

The slot the tooltip will be parented to.

globalOffset float3

The offset of the top-mi

Returns

bool

true if a tooltip was already open or newly opened; otherwise, false.

Remarks

If the label for the tooltip fails to resolve or it's a locale key missing a message, no tooltip will be created.

TryOpenTooltip(IButton, ButtonEventData, Slot, out Tooltip?, in float3)

Tries to open a tooltip for the given button details, optionally returning the already open or newly created tooltip.

public static bool TryOpenTooltip(IButton button, ButtonEventData buttonEventData, Slot tooltipParent, out Tooltip? tooltip, in float3 globalOffset = default)

Parameters

button IButton

The button the tooltip is attached to.

buttonEventData ButtonEventData

The button event triggering opening the tooltip.

tooltipParent Slot

The slot the tooltip will be parented to.

tooltip Tooltip

The tooltip if one was already open or newly opened; otherwise, null.

globalOffset float3

The offset from the button hitpoint at which the tooltip should be opened in global space.

Returns

bool

true if a tooltip was already open or newly opened; otherwise, false.

Remarks

If the label for the tooltip fails to resolve or it's a locale key missing a message, no tooltip will be created.

TryResolveTooltipLabel(IButton, ButtonEventData, out LocaleString?)

Tries to resolve the tooltip label for the given button details.

public static bool TryResolveTooltipLabel(IButton button, ButtonEventData buttonEventData, out LocaleString? label)

Parameters

button IButton

The button the tooltip is attached to.

buttonEventData ButtonEventData

The button event triggering opening the tooltip.

label LocaleString?

The label if it was successfully resolved; otherwise, null.

Returns

bool

true if the label was successfully resolved; otherwise, false.

Remarks

If the label for the tooltip is locale key missing a message, it's treated as an unsuccessfully resolved.

UnregisterLabelForButton(IButton)

Removes the registered label for the given button.

public static bool UnregisterLabelForButton(IButton button)

Parameters

button IButton

The button to remove the registered label of.

Returns

bool

true if there was a label to remove; otherwise, false.