Method Show

Source/Engine/UI/GUI/Tooltip.cs:61–125

Shows tooltip over given control. The parent control to attach to it. Popup menu origin location in parent control coordinates. Tooltip target area of interest.

(Control target, Float2 location, Rectangle targetArea)

        /// <param name="location">Popup menu origin location in parent control coordinates.</param>
        /// <param name="targetArea">Tooltip target area of interest.</param>
        public void Show(Control target, Float2 location, Rectangle targetArea)
        {
            if (target == null)
                throw new ArgumentNullException();

            // Ensure to be closed
            Hide();

            // Block showing tooltips when application is not focused
            if (!Platform.HasFocus)
                return;

            // Unlock and perform controls update
            UnlockChildrenRecursive();
            PerformLayout();

            var parentWin = target.Root;
            if (parentWin == null)
                return;

            // Showing a popup window might bring up the parent window on top
            if (!parentWin.IsFocused)
                return;

            // Calculate popup direction and initial location
            var dpiScale = target.RootWindow.DpiScale;
            var dpiSize = Size * dpiScale;
            var locationWS = target.PointToWindow(location);
            var locationSS = parentWin.PointToScreen(locationWS);
            var mousePos = Input.MouseScreenPosition;
            _showTarget = target;
            //WrapPosition(ref locationSS);
            WrapPosition(ref mousePos, 10);
            locationSS = mousePos + TooltipOffset;

            // Create window
            var desc = CreateWindowSettings.Default;
            desc.StartPosition = WindowStartPosition.Manual;
            desc.Position = locationSS;
            desc.Size = dpiSize;
            desc.Fullscreen = false;
            desc.HasBorder = false;
            desc.SupportsTransparency = false;
            desc.ShowInTaskbar = false;
            desc.ActivateWhenFirstShown = false;
            desc.AllowInput = false;
            desc.AllowMinimize = false;
            desc.AllowMaximize = false;
            desc.AllowDragAndDrop = false;
            desc.IsTopmost = true;
            desc.Type = WindowType.Tooltip;
            desc.Title = "Tooltip";
            desc.HasSizingFrame = false;
            desc.ShowAfterFirstPaint = true;
            desc.Parent = parentWin.RootWindow.Window;
            _window = Platform.CreateWindow(ref desc);
            if (_window == null)
                throw new InvalidOperationException("Failed to create tooltip window.");