WinForms › Tool Tip › BinaryPointTip

BinaryPointTip

class.NET 6 / 8 / 10.NET Framework 4.8Binarymission.WinForms.Controls.Popups

BinaryPointTip .NET is an extended ToolTip object, enabling you to display tooltips at any Point of your choice on the screen.
It also provides a wealth of impressive features, including the ever popular Windows XP styled "Balloon ToolTip" style, thereby making it easier for you to develop high quality and outstanding GUI applications.

public sealed class BinaryPointTip : Component

Inherits from / implements: Component

Remarks

In addition to the providing tooltips at a specified location (point) of your choice, BinaryPointTip object offers the following features as below :-

1. Balloon tooltips : The component supports a style property to display tooltips with the ever popular Windows XP style Balloon tooltip style.
2. Image Support : By setting a simple property, you can display an image along with the tooltip title text
3. Ability to fully support painting with custom colors and font : Using the component's simple properties, you can set the color and font of your choice for displaying the tooltip text, title, its forecolor, backcolor and border color.
4. DropShadow effects : The component can paint the tooltip with or without drop shadows. Using its simple properties, you can easily configure the DropShadows for the tooltip. Also, you can configure the tooltip's dropshadow offset, to give an extended floating effect for the tooltip.
5. ToolTip title : By setting a simple property, you can assign a title text to the tooltip, apart from the usual tooltip text
6. Multiple Tooltip styles : The component provides for two different styles of tooltip, viz., an extended version of the standard tooltip and an XP styled Balloon tooltip.
7. Automatic tooltip location management : The component automatically decides the best location for painting the ToolTip window, based on the screen co-ordinates of the underlying BinaryToolTip enabled controls on your Form.

Members at a glance

`BinaryPointTip`	Initializes a new instance of BinaryPointTip component.
`BinaryPointTip`	Initializes a new instance of BinaryPointTip component.
`AutomaticMultiLineSupport`	Gets or sets whether Multiline tooltip feature is automatically supported.
`BackColor`	Gets or sets the tooltip's background color.
`BalloonEdgeCurveFactor`	Gets or sets the Edge curve factor when the style is Balloon style!
`BorderColor`	Gets or sets the tooltip's borderColor color.
`CustomWidth`	Gets or sets the custom tooltip window width, based on which a multiline tooltip text will be displayed.
`Image`	Gets or sets the image to display as an icon.
`PointTipText`	Gets or sets the tooltip text to display.
`ShadowColor`	Gets or sets the colour the tip's drop shadow is drawn in.
`ShadowOffset`	Gets or sets the tooltip's dropshadow position.
`ShowDelay`	Gets or sets the time, in milliseconds, that the BinaryPointTip will be displayed.
`TextForeColor`	Gets or sets the tooltip's main text forecolor.
`TitleForeColor`	Gets or sets the tooltip's title foreColor.
`TitleWillBeBold`	Gets or sets whether the tooltip's title will be in bold font or not.
`TitleWillBeUnderlined`	Gets or sets whether the tooltip's title will be underlined or not.
`ToolTipHideDelay`	Gets or sets the delay, in milliseconds, before when the tooltip will appear while the mouse is stationary over the target control.
`ToolTipHoverDelay`	Gets or sets the delay, in milliseconds, before when the tooltip will appear while the mouse is stationary over the target control.
`ToolTipReshowDelay`	Gets or sets the time, in milliseconds, when to reshow the tooltip as the mouse moves to another target control.
`ToolTipTextFont`	Gets or sets the tooltip's main text's font.
`ToolTipTipStyle`	Associates a ToolTip display style with the specified control.
`Dispose`	Releases the resources held by this BinaryPointTip.
`Hide`	Hides the BinaryPointTip displayed with the ShowForEver method.
`Show`	Displays the BinaryPointTip in the specified Point in the screen.
`ShowForEver`	Shows the tooltip until you call `Hide` deterministically.

Constructors

BinaryPointTip

public BinaryPointTip()

Initializes a new instance of BinaryPointTip component.

BinaryPointTip

public BinaryPointTip(IContainer ic) : this()

Initializes a new instance of BinaryPointTip component.

Properties

AutomaticMultiLineSupport

public bool AutomaticMultiLineSupport

Gets or sets whether Multiline tooltip feature is automatically supported.

BinaryPointTip gives you the ability to automatically display a multiline tooltip, based on a custom width property, without you having to specifically insert NewLine characters.
Set this property to false if you do not want to enable this feature.
The default value is true.

BackColor

public Color BackColor

Gets or sets the tooltip's background color.

BinaryToolTip gives you the ability to define a background color, of your choice, to paint its window.
Set this property to modify the background color of the tooltip.

BalloonEdgeCurveFactor

public int BalloonEdgeCurveFactor

Gets or sets the Edge curve factor when the style is Balloon style!

Use this property to set the curve factor for drawing the edges of the tooltip window when the Tooltip is set to Balloon style.

BorderColor

public Color BorderColor

Gets or sets the tooltip's borderColor color.

BinaryToolTip gives you the ability to define a BorderColor color, of your choice, to paint its window borders.
Set this property to modify the borderColor color of the tooltip.

CustomWidth

public int CustomWidth

Gets or sets the custom tooltip window width, based on which a multiline tooltip text will be displayed.

BinaryPointTip gives you the ability to automatically display a multiline tooltip, based on a custom width property, without you having to specifically insert NewLine characters.
Set this property with a custom width (integer value) of your choice.
Once set with a value, the tooltip window will automatically display the tooltip text on multiple lines, based on the window width so set.
The default value is 100, in logical (96 DPI) units: the width is scaled to the display the tip is shown on.
Note: The minimum value this property can accept is 100 pixels.

Image

public Image Image

Gets or sets the image to display as an icon.

Set this property with an Image with a maximum of 16 x 16 pixels.
The transparent color will be taken from pixel 0,0 (top-left corner).

PointTipText

public string PointTipText

Gets or sets the tooltip text to display.

ShadowColor

public Color ShadowColor

Gets or sets the colour the tip's drop shadow is drawn in.

The shadow is drawn at a fraction of this colour's opacity and faded out at its edge, so a shadow in black darkens whatever is behind the tip on any theme. A light colour is only right over a darker background than itself.

ShadowOffset

public Point ShadowOffset

Gets or sets the tooltip's dropshadow position.

Use this property to set the distance that the tooltip's shadow will be offset from its main painting area. A larger offset gives the a higher floating appearance of the tooltip above the underlying control.

ShowDelay

public float ShowDelay

Gets or sets the time, in milliseconds, that the BinaryPointTip will be displayed.

TextForeColor

public Color TextForeColor

Gets or sets the tooltip's main text forecolor.

BinaryToolTip gives you the ability to define a forecolor color, of your choice, to paint the tooltip text .
Set this property to modify the tooltip text color of the tooltip.
Note: To change the ToolTip title text forecolor, set the TitleForeColor property.

TitleForeColor

public Color TitleForeColor

Gets or sets the tooltip's title foreColor.

BinaryToolTip gives you the ability to define a forecolor color, of your choice, to paint the title text .
Set this property to modify the title text color of the tooltip.
Note: To change the ToolTip text forecolor (not its title), set the TextForeColor property.

TitleWillBeBold

public bool TitleWillBeBold

Gets or sets whether the tooltip's title will be in bold font or not.

BinaryToolTip gives you the ability to set whether the tooltip's title will be in bold font or not.
Set this property to false, to set the tooltip title text to be displayed in Normal font.
By default, the title text will be in bold font, and hence this property is set to true.

TitleWillBeUnderlined

public bool TitleWillBeUnderlined

Gets or sets whether the tooltip's title will be underlined or not.

BinaryToolTip gives you the ability to set whether the tooltip's title will be underlined or not.
Set this property to true, to underline the tooltip title text.
By default, the title text will not be underlined, and hence this property is set to false.

ToolTipHideDelay

public int ToolTipHideDelay

Gets or sets the delay, in milliseconds, before when the tooltip will appear while the mouse is stationary over the target control.

ToolTipHoverDelay

public int ToolTipHoverDelay

Gets or sets the delay, in milliseconds, before when the tooltip will appear while the mouse is stationary over the target control.

ToolTipReshowDelay

public int ToolTipReshowDelay

Gets or sets the time, in milliseconds, when to reshow the tooltip as the mouse moves to another target control.

ToolTipTextFont

public Font ToolTipTextFont

Gets or sets the tooltip's main text's font.

BinaryToolTip gives you the ability to set a Font of your choice, for the tooltip's main text.
Set this property with a valid Font value of your choice.

ToolTipTipStyle

public BinaryToolTipStyle ToolTipTipStyle

Associates a ToolTip display style with the specified control.

BinaryToolTip provides the ability to display tooltips in two different style, viz.,

1. Standard : The standard style denotes the style of painting the Tooltip with a standard rectangular area.
2. Balloon : The balloon style denotes the style of painting the Tooltip with a balloon shaped area, just like the popular Windows XP style ballon styled tooltips.
By default, the style is set to BinaryToolTip's Standard style.
Refer to BinaryToolTipStyle for details on the tooltip styles.

Methods

Dispose

protected override void Dispose(bool disposing)

Releases the resources held by this BinaryPointTip.

disposing: true when called from Dispose; false when called from the finalizer.

Hide

public void Hide()

Hides the BinaryPointTip displayed with the ShowForEver method.

Show

public void Show(string title, string tiptext, Point pnt, float Delay, Image img, BinaryToolTipStyle style)

Displays the BinaryPointTip in the specified Point in the screen.

title: The Tooltip title to display.
tiptext: The Tooltip text to display.
pnt: The point (in screen coordinates) at which to display the Tooltip
Delay: The time (in milliseconds) to display the ToolTip
img: The image to use as an icon (Ensure to set an Image with a maximum of 16 x 16 pixels). This is Optional, so it can be null.
style: The ToolTip style to use - whether Extended standard style or Balloon type.

ShowForEver

public void ShowForEver(string title, string tiptext,Point pnt, Image img, BinaryToolTipStyle theTipStyle)

Shows the tooltip until you call Hide deterministically.

title
tiptext
pnt
img
theTipStyle