---
description: >-
  A feature that configures the tool-tip text and its appearance to provide
  users with additional context or guidance when interacting with the button.
---

# Tool-tip Settings

## Overview

The Tooltip Settings feature allows developers to customize the text and visual appearance of the tooltip that appears when the user hovers over the SiticoneTileButton. It provides control over the tooltip’s content, font, background and text colors, and timing properties such as initial delay, auto pop delay, and reshow delay. This feature enhances usability by offering helpful hints or descriptions about the button's function.

***

#### Feature Properties Table

| Property Name       | Type   | Default Value                           | Description                                                                       |
| ------------------- | ------ | --------------------------------------- | --------------------------------------------------------------------------------- |
| TooltipText         | string | string.Empty                            | The text displayed in the tooltip when the user hovers over the button.           |
| TooltipFont         | Font   | new Font("Segoe UI", 9f)                | The font used for displaying the tooltip text.                                    |
| TooltipBackColor    | Color  | Color.Black                             | The background color of the tooltip popup.                                        |
| TooltipForeColor    | Color  | Color.White                             | The text color used in the tooltip.                                               |
| TooltipInitialDelay | int    | (Inherited from \_tooltip.InitialDelay) | The delay (in milliseconds) before the tooltip appears on hover.                  |
| TooltipAutoPopDelay | int    | (Inherited from \_tooltip.AutoPopDelay) | The duration (in milliseconds) that the tooltip remains visible once displayed.   |
| TooltipReshowDelay  | int    | (Inherited from \_tooltip.ReshowDelay)  | The delay (in milliseconds) before the tooltip is shown again after being hidden. |
| TooltipAlwaysShow   | bool   | (Based on \_tooltip.Active)             | Determines whether the tooltip should always be shown on hover.                   |

***

#### Key Points

| Aspect                  | Details                                                                                                    |
| ----------------------- | ---------------------------------------------------------------------------------------------------------- |
| Contextual Guidance     | Tooltip text provides additional information about the button’s function, improving usability.             |
| Customizable Appearance | Developers can tailor the font, background, and text colors to match the application’s design.             |
| Timing Control          | Adjustable delays ensure that the tooltip behaves responsively and predictably, enhancing user experience. |

***

#### Best Practices

| Practice                                              | Explanation                                                                                                                               |
| ----------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| Keep tooltip text concise                             | Use brief, clear descriptions to help users understand the button's functionality without overwhelming them.                              |
| Match tooltip appearance to UI design                 | Customize the TooltipFont, TooltipBackColor, and TooltipForeColor so that tooltips blend well with your overall application theme.        |
| Adjust delays to balance responsiveness and usability | Set TooltipInitialDelay, TooltipAutoPopDelay, and TooltipReshowDelay based on typical user interaction speeds to avoid tooltip annoyance. |
| Test tooltips on multiple devices and screen sizes    | Ensure the tooltip remains legible and positioned correctly across various display resolutions.                                           |

***

#### Common Pitfalls

| Pitfall                                      | Recommendation                                                                                      |
| -------------------------------------------- | --------------------------------------------------------------------------------------------------- |
| Overly verbose tooltip text                  | Keep the tooltip text short to avoid clutter and distraction.                                       |
| Inconsistent styling with the rest of the UI | Standardize tooltip styling across the application for a cohesive look.                             |
| Improper delay settings causing frustration  | Test and fine-tune the delay properties to prevent tooltips from appearing too quickly or too late. |
| Neglecting accessibility requirements        | Ensure tooltip text contrasts sufficiently with the background and is legible for all users.        |

***

#### Usage Scenarios

| Scenario            | Description                                                                                                                          |
| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| Form Input Guidance | Provide tooltips on buttons that perform form submissions, reset actions, or data processing to inform users of the next steps.      |
| Navigation Aids     | Enhance navigational buttons by adding tooltips that explain their destination or function.                                          |
| Feature Explanation | Use tooltips on complex or multi-functional buttons to provide brief descriptions of their purpose, thereby reducing user confusion. |

***

#### Code Examples

**Example 1: Basic Tooltip Integration**

This example demonstrates how to integrate the SiticoneTileButton with default tooltip settings. The tooltip text appears when the user hovers over the button.

```csharp
using System;
using System.Drawing;
using System.Windows.Forms;
using SiticoneNetFrameworkUI;

namespace TooltipSettingsDemo
{
    public class MainForm : Form
    {
        public MainForm()
        {
            // Initialize the SiticoneTileButton with tooltip text
            var tooltipButton = new SiticoneTileButton
            {
                Text = "Submit",
                Size = new Size(220, 150),
                Location = new Point(50, 50),
                
                // Tooltip settings
                TooltipText = "Click here to submit your data",
                
                // Basic color settings for the button
                BaseColor = Color.FromArgb(50, 150, 215),
                HoverColor = Color.FromArgb(70, 170, 235)
            };

            // Optionally adjust tooltip appearance via properties
            tooltipButton.TooltipFont = new Font("Segoe UI", 9f);
            tooltipButton.TooltipBackColor = Color.Black;
            tooltipButton.TooltipForeColor = Color.White;
            tooltipButton.TooltipInitialDelay = 500;
            tooltipButton.TooltipAutoPopDelay = 5000;
            tooltipButton.TooltipReshowDelay = 100;

            Controls.Add(tooltipButton);
        }

        [STAThread]
        static void Main()
        {
            Application.EnableVisualStyles();
            Application.Run(new MainForm());
        }
    }
}
```

**Example 2: Customized Tooltip Appearance**

This example shows how to customize tooltip settings to better fit a dark-themed application.

```csharp
using System;
using System.Drawing;
using System.Windows.Forms;
using SiticoneNetFrameworkUI;

namespace CustomizedTooltipSettingsDemo
{
    public class MainForm : Form
    {
        public MainForm()
        {
            // Initialize the SiticoneTileButton with customized tooltip settings
            var customTooltipButton = new SiticoneTileButton
            {
                Text = "Settings",
                Size = new Size(220, 150),
                Location = new Point(30, 30),
                
                // Tooltip settings for a dark theme
                TooltipText = "Adjust your preferences",
                TooltipFont = new Font("Arial", 10f),
                TooltipBackColor = Color.DarkGray,
                TooltipForeColor = Color.LightYellow,
                TooltipInitialDelay = 300,
                TooltipAutoPopDelay = 4000,
                TooltipReshowDelay = 150,
                
                // Button color settings
                BaseColor = Color.FromArgb(30, 30, 30),
                HoverColor = Color.FromArgb(50, 50, 50)
            };

            Controls.Add(customTooltipButton);
        }

        [STAThread]
        static void Main()
        {
            Application.EnableVisualStyles();
            Application.Run(new MainForm());
        }
    }
}
```

***

#### Review

| Aspect                 | Review Comments                                                                                                                                  |
| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| Clarity of Information | The tooltip settings provide concise, contextual help that enhances user interaction without overwhelming the interface.                         |
| Customizability        | Developers can easily adjust the appearance and timing of tooltips to match the application’s design and user needs.                             |
| Ease of Integration    | With simple property assignments, integrating tooltip settings is straightforward, making it accessible for both novice and advanced developers. |

***

#### Summary

The Tooltip Settings feature of the SiticoneTileButton control enables developers to offer contextual assistance through customizable tooltips. By adjusting properties such as TooltipText, TooltipFont, TooltipBackColor, TooltipForeColor, and the various delay settings, you can create informative, aesthetically pleasing tooltips that enhance the overall user experience. This feature is particularly useful for guiding users through complex interfaces and ensuring that essential information is always within reach.

***

#### Additional Resources

| Resource Category            | Description                                                                                                 |
| ---------------------------- | ----------------------------------------------------------------------------------------------------------- |
| Integration Tips             | Use the provided code examples as a starting point for adding and customizing tooltips in your application. |
| Accessibility Considerations | Ensure that tooltip text is legible and that color contrasts meet accessibility standards.                  |
| UI Consistency               | Standardize tooltip settings across your application to maintain a uniform user experience.                 |

***

By following these guidelines and examples, developers can seamlessly integrate and customize the Tooltip Settings feature of the SiticoneTileButton control, thereby enhancing the usability and accessibility of their .NET WinForms applications.







