using System; using Microsoft.Xna.Framework; using MLEM.Ui.Style; 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 { /// /// The offset that this tooltip's top left corner should have from the mouse position /// public StyleProp MouseOffset; /// /// The amount of time that the mouse has to be over an element before it appears /// public StyleProp Delay; /// /// The paragraph of text that this tooltip displays /// public Paragraph Paragraph; private TimeSpan delayCountdown; private bool autoHidden; /// /// 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) this.Paragraph = this.AddChild(new Paragraph(Anchor.TopLeft, 0, text)); 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) { this.Paragraph = this.AddChild(new Paragraph(Anchor.TopLeft, 0, textCallback)); 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(); } } 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.Delay = this.Delay.OrStyle(style.TooltipDelay); this.ChildPadding = this.ChildPadding.OrStyle(style.TooltipChildPadding); if (this.Paragraph != null) { this.Paragraph.TextColor = this.Paragraph.TextColor.OrStyle(style.TooltipTextColor, 1); this.Paragraph.Size = new Vector2(style.TooltipTextWidth, 0); } } /// /// Causes this tooltip's position to be snapped to the mouse position. /// public void SnapPositionToMouse() { var viewport = this.System.Viewport; var offset = (this.Input.MousePosition.ToVector2() + this.MouseOffset.Value) / 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 public void Display(UiSystem system, string name) { system.Add(name, this); if (this.Delay <= TimeSpan.Zero) { this.IsHidden = false; this.SnapPositionToMouse(); } else { this.IsHidden = true; this.delayCountdown = this.Delay; } this.autoHidden = false; } /// /// 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 += element => this.Display(element.System, element.GetType().Name + "Tooltip"); elementToHover.OnMouseExit += element => this.Remove(); } private void Init(Element elementToHover) { if (this.Paragraph != null) this.Paragraph.AutoAdjustWidth = true; 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) { // only auto-hide if IsHidden wasn't changed manually if (this.IsHidden == this.autoHidden) this.IsHidden = shouldBeHidden; this.autoHidden = shouldBeHidden; } } } }