Vcl.Controls.THintWindow.ActivateHint
Delphi
procedure ActivateHint(Rect: TRect; const AHint: string); virtual;
C++
virtual void __fastcall ActivateHint(const System::Types::TRect &Rect, const System::UnicodeString AHint);
Eigenschaften
Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
---|---|---|---|---|
procedure function |
public | Vcl.Controls.pas Vcl.Controls.hpp |
Vcl.Controls | THintWindow |
Beschreibung
Zeigt das Hinweisfenster an.
Rufen Sie die Methode ActivateHint auf, um das Hinweisfenster an den im Parameter Rect angegebenen Koordinaten anzuzeigen. Wenn der Parameter Rect Koordinaten enthält, die außerhalb des Bildschirms liegen, verschiebt ActivateHint das Hinweisfenster an eine Postion, die den angegebenen Koordinaten am nächsten kommt, aber noch eine vollständige Anzeige des Fensters zulässt. ActivateHint belegt vor der Anzeige des Fensters die Eigenschaft Caption mit dem Wert des Parameters AHint, um dem Benutzer den String in AHint anzuzeigen.
Das in einer Anwendung eingeblendete Hinweisfenster wird nach einer gewissen Zeit wieder deaktiviert. Die Anwendung blendet das Fenster auch dann aus, wenn sie eine Botschaft empfängt, die das Verbergen der Hinweismeldung fordert. Zum Verbergen eines Hinweisfensters, das automatisch von der Anwendung angezeigt wurde, steht die Methode HideHint des globalen Objekts Application zur Verfügung. Soll ein Fenster verborgen werden, das direkt durch einen Aufruf von ActivateHint geöffnet wurde, müssen Sie die Methode ReleaseHandle verwenden.