API Documentation -> NtDisplayDef -> hotspotX

# NtDisplayDef.hotspotX Member

The 'hot spot' of a visual representation of a data object like an icon is normally its top left edge. This means, that the visual representation (e.g. the icons) are aligned with their top edge to a certain Y-Coordinate (typically 2 pixels from top of the row) and with their left edge to the time stamp of the data object. Changing hotspotY moves the hot spot downwards within the object, which results in shifting the object's representation (e.g. icon) upwards. For icons that look like a crossmark e.g. it might be reasonable to move the hot spot to the middle.
Please see the example figure below: Both images show the same data object. Its time stamp is exactly 12:00. On the left image the hot spot is the top left edge of the icon, which means that its top is 2 pixels below the row top and the left edge is located at the time stamp 12:00. On the right image hotspotX is set to 16 as the icon is 31 pixels wide. This moves the icon 16 pixels to the left so its center is located on the time stamp of 12:00 which is a far more intuitive representation. Further more the hotspotY has been set to -3 move the hotspot about 3 pixels upward within the icon (basically moving it above the icon) which results in the icon being displaces by 3 pixels downwards in order to centralize it better.

Type:

int

Remarks:

Values can be positive and negative.
Important: When you choose to display your data in the style of a curve with the displayMode 2 (crossmarked curves), then hotspotX and hotspotY should be the same (e.g. 5). Twice the value will then define the size of the cross mark as the hot spot should always be the center of the cross, of course. Please see the example below:

See also:

hotspotY

Top API Documentation -> NtDisplayDef -> hotspotX © 2016 Bassaly