Vcl.Controls.THintInfo

• Übergeordnet: Vcl.Controls
• Felder

Delphi

  THintInfo = record
    HintControl: TControl;
    HintWindowClass: THintWindowClass;
    HintPos: TPoint;
    HintMaxWidth: Integer;
    HintColor: TColor;
    CursorRect: TRect;
    CursorPos: TPoint;
    ReshowTimeout: Integer;
    HideTimeout: Integer;
    HintStr: string;
    HintData: TCustomData;
  end;

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;
    void *HintData;
};

Eigenschaften

Typ	Sichtbarkeit	Quelle	Unit	Übergeordnet
record struct	public	Vcl.Controls.pas Vcl.Controls.hpp	Vcl.Controls	Vcl.Controls

Beschreibung

Mit THintInfo wird das Erscheinungsbild und die Funktionsweise des Hinweisfensters definiert.

Mit dem Typ THintInfo wird das Erscheinungsbild und die Funktionsweise des Hinweisfensters in einer Ereignisbehandlungsroutine OnShowHint vom Typ TShowHintEvent definiert.

In der folgenden Tabelle ist die Bedeutung der Felder von Vcl.Controls.THintInfo beschrieben:

Feld	Bedeutung
HintControl	Der Name des Steuerelements, für das eine Hinweisverarbeitung erfolgen soll.
HintWindowClass	Die Klasse des Hinweisfenster-Steuerelements. Die Standardvorgabe ist THintWindow. Sie können aber jede von THintWindow abgeleitete Klasse angeben. Verwenden Sie dieses Feld, wenn Sie THintWindow durch ein benutzerdefiniertes Hinweisfenster ersetzen möchten.
HintPos	Die Standardposition in Bildschirmkoordinaten der linken oberen Ecke des Hinweisfensters. Durch Änderung dieses Wertes können Sie das Fenster an einer anderen Position anzeigen.
HintMaxWidth	Die maximale Breite des Hinweisfensters vor dem Textumbruch. Standardmäßig entspricht der Wert der Breite des Bildschirms (der Eigenschaft Width der globalen Variable Screen).
HintColor	Die Hintergrundfarbe des Hinweisfensters.
CursorRect	Das Rechteck, in dem sich der Mauszeiger befinden muss, damit das Hinweisfenster angezeigt wird. Der Standardwert für CursorRect entspricht dem Client-Rechteck des Steuerelements. Ändern Sie diesen Wert, um ein Steuerelement in mehrere Hinweisbereiche zu unterteilen. Wenn der Benutzer den Mauszeiger außerhalb des Hinweisbereichs positioniert, wird das Hinweisfenster ausgeblendet.
CursorPos	Die Position des Mauszeigers innerhalb des Steuerelements.
ReshowTimeout	Zeitspanne, die das Hinweissystem warten soll, ehe der Hinweisstatus erneut abgefragt wird. Standardmäßig enthält dieses Feld den Wert Null. Damit wird festgelegt, dass der Hinweisstatus nicht abgefragt wird. Wenn Sie diesem Feld einen Wert zuweisen (nicht Null), verhält sich das Hinweisfenster nach Ablauf der angegebenen Millisekunden so, als ob der Mauszeiger aus dem Hinweisfenster heraus und wieder hinein bewegt wurde. Damit kann die Hinweisprozedur unterbrochen oder der Hinweis periodisch aktualisiert werden.
HideTimeout	Die Anzahl der Millisekunden, die der Hinweis angezeigt werden soll. Standardmäßig wird der Wert der Eigenschaft HintHidePause der Variable Application verwendet.
HintStr	Der String, der im Hinweisfenster angezeigt werden soll. Damit kann der Inhalt eines Hinweises vor dem Anzeigen durch die Ereignisbehandlungsroutine OnHint geändert werden. Standardmäßig enthält HintStr den von der Funktion GetShortHint zurückgegebenen Wert, nachdem dieser der Wert der Eigenschaft Hint der Variable Application übergeben wurde.
HintData	Zusätzliche Daten, die an das Hinweisfenster-Steuerelement übergeben werden sollen. Verwenden Sie dieses Feld zusammen mit HintWindowClass.

Siehe auch

• THintWindow
• OnShowHint

Codebeispiele

• OnShowHint (Delphi)
• OnShowHint (C++)