ToolTipsFactory

Object Model - Additional Properties - Image

Gets or sets a reference to an Image-object to be displayed by the tooltip.

[Visual Basic]
Public Property Image As Image
[C#]
public Image Image {get; set;}

Property Value

Any bitmap image in a format supported by the .NET framework.

Overridable

Layout-file

Property of
AnimationTT ImageTT SingleLineTT MultiLineTT

Description

This property holds a reference to an Image-object (any kind of bitmap-image supported by the .NET-framework) to be displayed in an ImageToolTip as main tooltip-content.

The ImageToolTip-component exposes this property in its interface and it is fully accessible in the code-editor, but it is not shown in the property-grid of the component or the "Tooltip Layout-designer". Usually the content for a tooltip is not assigned directly to the corresponding content-property (Text, Image or AnimatedSymbol) of the component, because the tooltip-content should be provided by the individual controls of the form. This is done by means of the properties provided to the controls by the tooltip-components. Under normal circumstances it is not necessary nor useful to assign the Image-object (the content) directly to the  Image-property of the component, because it would anyway be overridden by the property provided to the controls. Thus, code like the following should be avoided unless you know exactly what and what for you are doing it:

'Create a new Image-object

Dim currentStatisticsChart As Image

currentStatisticsChart = RenderStatisticsChart()

 

'Assign the created image to the tooltip component

'this way, should be avoided....

Me.MyImageTT.Image = currentStatisticsChart 

Instead, the created statistics chart should be assigned as specific tooltip-content for a control with the following statement:

'This is the correct way to assign an image as

'tooltip content for a specific control...

Me.MyImageTT.GetImageToolTip(Panel1) _

.Image = currentStatisticsChart