Vcl.Controls.THintInfo

From RAD Studio API Documentation
Jump to: navigation, search

Delphi

THintInfo = record

C++

struct DECLSPEC_DRECORD THintInfo
{
public:
    TControl* HintControl;
    THintWindowClass HintWindowClass;
    System::Types::TPoint HintPos;
    int HintMaxWidth;
    System::Uitypes::TColor HintColor;
    System::Types::TRect CursorRect;
    System::Types::TPoint CursorPos;
    int ReshowTimeout;
    int HideTimeout;
    System::UnicodeString HintStr;
    TCustomData HintData;
};

Properties

Type Visibility Source Unit Parent
record
struct
public
Vcl.Controls.pas
Vcl.Controls.hpp
Vcl.Controls Vcl.Controls

Description

THintInfo is used to define the appearance and behavior of the Help window.

The THintInfo type is used to define the appearance and behavior of the Help window in a TShowHintEvent type OnShowHint event handler.

The following table describes the meaning of the fields of Vcl.Controls.THintInfo:


Field Meaning

HintControl

The name of the control for which hint processing is occurring.

HintWindowClass

The class of the hint-window control. The default is THintWindow, but you can specify any class derived from THintWindow. Use this field if you want to substitute a custom hint window for THintWindow.

HintPos

The default position in screen coordinates of the top-left corner of the hint window. Change where the window appears by changing this value.

HintMaxWidth

The maximum width of the hint window before word wrapping begins. By default, the value is the width of the screen (the Width property of the global Screen variable).

HintColor

The background color of the Hint window.

CursorRect

The rectangle the user's mouse pointer must be in for the hint window to appear. The default value for CursorRect is the client rectangle of the control. Change this value so that a single control can be divided into several hint regions. When the user moves the mouse pointer outside the rectangle, the hint window disappears.

CursorPos

The location of the mouse pointer within the control.

ReshowTimeout

How long the hint system should wait before asking about the hint status again. By default, this field is zero, indicating that the hint status will not change. Setting it to a non-zero value will cause the hint to act, after the requested milliseconds have elapsed, as if the user moved the mouse outside the hint rectangle and back in. This can be used to either put off hint processing for a period of time, or to allow the hint to be updated periodically.

HideTimeout

The number of milliseconds to show the hint. By default, it is set to the value of the Application variable's HintHidePause property.

HintStr

The string to be displayed in the hint window. This allows an OnHint event handler to modify the contents of a hint before it is displayed. By default, it contains the value returned by the GetShortHint function when passed the value of the Application variable's Hint property.

HintData

Additional data to be passed to the hint-window control. Use this field in conjunction with HintWindowClass.


See Also

Code Examples