using System;
using System.Collections.Generic;
using Microsoft.Xna.Framework;
using MLEM.Input;
using MLEM.Ui.Style;
#if FNA
using MLEM.Extensions;
#endif
namespace MLEM.Ui.Elements {
///
/// A tooltip element for use inside of a .
/// A tooltip is a with a custom cursor that always follows the position of the mouse.
/// Tooltips can easily be configured to be hooked onto an element, causing them to appear when it is moused, and disappear when it is not moused anymore.
///
public class Tooltip : Panel {
///
/// A list of objects that this tooltip automatically manages.
/// A paragraph that is contained in this list will automatically have the and applied.
/// To add a paragraph to both this list and to , use .
///
public readonly List Paragraphs = new List();
///
/// The offset that this tooltip's top left corner should have from the mouse position
///
public StyleProp MouseOffset;
///
/// The offset that this tooltip's top center coordinate should have from the bottom center of the element snapped to when is true.
///
public StyleProp AutoNavOffset;
///
/// The amount of time that the mouse has to be over an element before it appears
///
public StyleProp Delay;
///
/// The that this tooltip's should have
///
public StyleProp ParagraphTextColor {
get => this.paragraphTextColor;
set {
this.paragraphTextColor = value;
this.UpdateParagraphsStyles();
}
}
///
/// The that this tooltip's should have
///
public StyleProp ParagraphTextScale {
get => this.paragraphTextScale;
set {
this.paragraphTextScale = value;
this.UpdateParagraphsStyles();
}
}
///
/// The width that this tooltip's should have
///
public StyleProp ParagraphWidth {
get => this.paragraphWidth;
set {
this.paragraphWidth = value;
this.UpdateParagraphsStyles();
}
}
///
/// The paragraph of text that this tooltip displays
///
[Obsolete("Use Paragraphs instead, which allows for multiple paragraphs to be managed by one tooltip")]
public Paragraph Paragraph;
///
/// Determines whether this tooltip should display when is true, which is when the UI is being controlled using a keyboard or gamepad.
/// If this tooltip is displayed in auto-nav mode, it will display below the selected element with the applied.
///
public bool DisplayInAutoNavMode;
///
/// The position that this tooltip should be following (or snapped to) instead of the .
/// If this value is unset, will be used as the snap position.
/// Note that is still applied with this value set.
///
public virtual Vector2? SnapPosition { get; set; }
///
public override bool IsHidden => this.autoHidden || base.IsHidden;
private TimeSpan delayCountdown;
private bool autoHidden;
private Element snapElement;
private StyleProp paragraphWidth;
private StyleProp paragraphTextScale;
private StyleProp paragraphTextColor;
///
/// Creates a new tooltip with the given settings
///
/// The text to display on the tooltip
/// The element that should automatically cause the tooltip to appear and disappear when hovered and not hovered, respectively
public Tooltip(string text = null, Element elementToHover = null) :
base(Anchor.TopLeft, Vector2.One, Vector2.Zero) {
if (text != null) {
#pragma warning disable CS0618
this.Paragraph = this.AddParagraph(text);
#pragma warning restore CS0618
}
this.Init(elementToHover);
}
///
/// Creates a new tooltip with the given settings
///
/// The text to display on the tooltip
/// The element that should automatically cause the tooltip to appear and disappear when hovered and not hovered, respectively
public Tooltip(Paragraph.TextCallback textCallback, Element elementToHover = null) :
base(Anchor.TopLeft, Vector2.One, Vector2.Zero) {
#pragma warning disable CS0618
this.Paragraph = this.AddParagraph(textCallback);
#pragma warning restore CS0618
this.Init(elementToHover);
}
///
public override void Update(GameTime time) {
base.Update(time);
this.SnapPositionToMouse();
if (this.delayCountdown > TimeSpan.Zero) {
this.delayCountdown -= time.ElapsedGameTime;
if (this.delayCountdown <= TimeSpan.Zero) {
this.IsHidden = false;
this.UpdateAutoHidden();
this.SnapPositionToMouse();
}
} else {
this.UpdateAutoHidden();
}
}
///
public override void ForceUpdateArea() {
if (this.Parent != null)
throw new NotSupportedException($"A tooltip shouldn't be the child of another element ({this.Parent})");
base.ForceUpdateArea();
this.SnapPositionToMouse();
}
///
protected override void InitStyle(UiStyle style) {
base.InitStyle(style);
this.Texture = this.Texture.OrStyle(style.TooltipBackground);
this.MouseOffset = this.MouseOffset.OrStyle(style.TooltipOffset);
this.AutoNavOffset = this.AutoNavOffset.OrStyle(style.TooltipAutoNavOffset);
this.Delay = this.Delay.OrStyle(style.TooltipDelay);
this.ParagraphTextColor = this.ParagraphTextColor.OrStyle(style.TooltipTextColor);
this.ParagraphTextScale = this.ParagraphTextScale.OrStyle(style.TextScale);
this.ParagraphWidth = this.ParagraphWidth.OrStyle(style.TooltipTextWidth);
this.ChildPadding = this.ChildPadding.OrStyle(style.TooltipChildPadding);
this.UpdateParagraphsStyles();
}
///
/// Adds the given paragraph to this tooltip's managed list, as well as to its children using .
/// A paragraph that is contained in the list will automatically have the and applied.
///
/// The paragraph to add
/// The added paragraph, for chaining
/// The index to add the child at, or -1 to add it to the end of the list
public Paragraph AddParagraph(Paragraph paragraph, int index = -1) {
this.Paragraphs.Add(paragraph);
this.AddChild(paragraph, index);
this.UpdateParagraphStyle(paragraph);
return paragraph;
}
///
/// Adds a new paragraph with the given text callback to this tooltip's managed list, as well as to its children using .
/// A paragraph that is contained in the list will automatically have the and applied.
///
/// The text that the paragraph should display
/// The created paragraph, for chaining
/// The index to add the child at, or -1 to add it to the end of the list
public Paragraph AddParagraph(Paragraph.TextCallback text, int index = -1) {
return this.AddParagraph(new Paragraph(Anchor.AutoLeft, 0, text), index);
}
///
/// Adds a new paragraph with the given text to this tooltip's managed list, as well as to its children using .
/// A paragraph that is contained in the list will automatically have the and applied.
///
/// The text that the paragraph should display
/// The created paragraph, for chaining
/// The index to add the child at, or -1 to add it to the end of the list
public Paragraph AddParagraph(string text, int index = -1) {
return this.AddParagraph(p => text, index);
}
///
/// Causes this tooltip's position to be snapped to the mouse position, or the if is true, or the if set.
///
public void SnapPositionToMouse() {
Vector2 snapPosition;
if (this.snapElement != null) {
// center our snap position below the snap element
snapPosition = new Vector2(this.snapElement.DisplayArea.Center.X, this.snapElement.DisplayArea.Bottom) + this.AutoNavOffset;
snapPosition.X -= this.DisplayArea.Width / 2F;
} else {
snapPosition = (this.SnapPosition ?? this.Input.ViewportMousePosition.ToVector2()) + this.MouseOffset.Value;
}
var viewport = this.System.Viewport;
var offset = snapPosition / this.Scale;
if (offset.X < viewport.X)
offset.X = viewport.X;
if (offset.Y < viewport.Y)
offset.Y = viewport.Y;
if (offset.X * this.Scale + this.Area.Width >= viewport.Right)
offset.X = (viewport.Right - this.Area.Width) / this.Scale;
if (offset.Y * this.Scale + this.Area.Height >= viewport.Bottom)
offset.Y = (viewport.Bottom - this.Area.Height) / this.Scale;
this.PositionOffset = offset;
}
///
/// Adds this tooltip to the given and either displays it directly or starts the timer.
///
/// The system to add this tooltip to
/// The name that this tooltip should use
/// Whether this tooltip was successfully added, which is not the case if it is already being displayed currently.
public bool Display(UiSystem system, string name) {
if (system.Add(name, this) == null)
return false;
if (this.Delay <= TimeSpan.Zero) {
this.IsHidden = false;
this.SnapPositionToMouse();
} else {
this.IsHidden = true;
this.delayCountdown = this.Delay;
}
this.autoHidden = false;
return true;
}
///
/// Removes this tooltip from its and resets the timer, if there is one.
///
public void Remove() {
this.delayCountdown = TimeSpan.Zero;
if (this.System != null)
this.System.Remove(this.Root.Name);
}
///
/// Adds this tooltip instance to the given , making it display when it is moused over
///
/// The element that should automatically cause the tooltip to appear and disappear when hovered and not hovered, respectively
public void AddToElement(Element elementToHover) {
elementToHover.OnMouseEnter += e => this.Display(e.System, $"{e.GetType().Name}Tooltip");
elementToHover.OnMouseExit += e => this.Remove();
elementToHover.OnSelected += e => {
if (this.DisplayInAutoNavMode && e.Controls.IsAutoNavMode) {
this.snapElement = e;
this.Display(e.System, $"{e.GetType().Name}Tooltip");
}
};
elementToHover.OnDeselected += e => {
if (this.DisplayInAutoNavMode) {
this.Remove();
this.snapElement = null;
}
};
}
private void Init(Element elementToHover) {
this.SetWidthBasedOnChildren = true;
this.SetHeightBasedOnChildren = true;
this.CanBeMoused = false;
if (elementToHover != null)
this.AddToElement(elementToHover);
}
private void UpdateAutoHidden() {
var shouldBeHidden = true;
foreach (var child in this.Children) {
if (!child.IsHidden) {
shouldBeHidden = false;
break;
}
}
if (this.autoHidden != shouldBeHidden) {
this.autoHidden = shouldBeHidden;
this.SetAreaDirty();
}
}
private void UpdateParagraphsStyles() {
foreach (var paragraph in this.Paragraphs)
this.UpdateParagraphStyle(paragraph);
#pragma warning disable CS0618
// still set style here in case someone changed the paragraph field manually
if (this.Paragraph != null)
this.UpdateParagraphStyle(this.Paragraph);
#pragma warning restore CS0618
}
private void UpdateParagraphStyle(Paragraph paragraph) {
paragraph.TextColor = paragraph.TextColor.OrStyle(this.ParagraphTextColor, 1);
paragraph.TextScale = paragraph.TextScale.OrStyle(this.ParagraphTextScale, 1);
paragraph.Size = new Vector2(this.ParagraphWidth, 0);
paragraph.AutoAdjustWidth = true;
}
}
}