ComponentOne Menus and Toolbars for WinForms
C1.Win.C1SuperTooltip.4.8 Assembly / C1.Win.C1SuperTooltip Namespace / C1SuperTooltip Class
Members

In This Topic
    C1SuperTooltip Class
    In This Topic
    C1SuperTooltip control allows to show tooltips with different visual options and rich html content.
    Object Model
    C1SuperTooltip Class
    Syntax
    'Declaration
     
    Public Class C1SuperTooltip 
       Inherits C1.Win.C1SuperTooltip.C1SuperTooltipBase
    public class C1SuperTooltip : C1.Win.C1SuperTooltip.C1SuperTooltipBase 
    Remarks

    The C1SuperTooltip component is virtually identical to the System.Windows.Forms.ToolTip component, with one significant difference: C1SuperTooltip displays HTML text instead of plain text. This way, your tooltips can have multiple fonts, colors, tables, lists, and images. See the SetToolTip(Control,String) method for details and examples.

    You can associate HTML tooltips with any System.Windows.Forms.Control or System.Windows.Forms.ToolStripItem on the form.

    C1SuperTooltip does not use IE to render the HTML content. Instead, it has its own light-weight HTML parser and renderer. This means the output you get will not be always be 100% compatible with IE (or FireFox), but in most cases it should be close. C1SuperTooltip supports cascading style sheets, tables, and most other HTML features. For more details, see the SetToolTip(Control,String) method.

    The C1SuperTooltip component allows you to provide help to users when they place the mouse cursor over a control. The C1SuperTooltip component is typically used to alert users to the intended use of a control. For example, you could specify tooltip text for a TextBox control that accepts a name, specifying the format of the name to typed into the control. In addition to providing help, you can also use the C1SuperTooltip component to provide run time status information. For example, you could use the C1SuperTooltip component to display connection speed and line quality data when the user moves the mouse cursor over a PictureBox control that displays Internet connection status.

    The C1SuperTooltip component provides properties that enable you to modify how long and how quickly a tooltip window is displayed. The C1.Win.C1SuperTooltip.C1SuperTooltipBase.AutoPopDelay property determines how long a tooltip window is displayed; the C1.Win.C1SuperTooltip.C1SuperTooltipBase.InitialDelay and C1.Win.C1SuperTooltip.C1SuperTooltipBase.ReshowDelay properties determine the delay before a tooltip window is displayed. To set all of these properties to a consistent pattern, you can use the C1.Win.C1SuperTooltip.C1SuperTooltipBase.AutomaticDelay property. This value is then used to calculate and set the values of the other delay properties. To enable a control's tooltip text to be displayed regardless of whether the Form or container the control is contained within is enabled, you can use the ShowAlways property. If you want to disable all tooltip text from being displayed in your application, you can use the C1.Win.C1SuperTooltip.C1SuperTooltipBase.Active property.

    The C1SuperTooltip component can be used in any container. To specify a specific container to use the C1SuperTooltip component within, use the C1SuperTooltip constructor. In order for tooltip text to be displayed when the user moves the mouse cursor over a control, the tooltip text to be displayed must be associated with the control within an instance of the C1SuperTooltip component. To associate tooltip text with a control, use the SetToolTip(Control,String) method. The SetToolTip method can be called more than once for the same control to change the text that is associated with the control. If you want to get the text that is associated with a control, use the GetToolTip method. To remove all tooltip text associations with an instance of the C1SuperTooltip component, use the C1.Win.C1SuperTooltip.C1SuperTooltipBase.RemoveAll method.

    Inheritance Hierarchy

    System.Object
       System.MarshalByRefObject
          System.ComponentModel.Component
             C1.Win.C1SuperTooltip.C1SuperTooltipBase
                C1.Win.C1SuperTooltip.C1SuperTooltip

    scrap%

    Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

    See Also

    Reference

    C1SuperTooltip Members
    C1.Win.C1SuperTooltip Namespace