Vcl.Controls.TMouse.CursorPos

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

property CursorPos: TPoint read GetCursorPos write SetCursorPos;

C++

__property System::Types::TPoint CursorPos = {read=GetCursorPos, write=SetCursorPos};

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
property public
Vcl.Controls.pas
Vcl.Controls.hpp
Vcl.Controls TMouse

Beschreibung

Gibt die Position des Mauszeigers an.

Mit CursorPos können Sie die aktuelle Position des Mauszeigers in globalen Koordinaten ermitteln. Anhand dieser Position können Sie UI-Elemente in Bezug zur Maus positionieren. Auf dem Wert von CursorPos basieren beispielsweise die Positionen von Popup-Menüs oder die Anzeige von Phantomrahmen während Drag&Dock-Operationen.

TMouseCursorPos kann eine Exception auslösen. Der API-Aufruf zum Abrufen der Eigenschaft ist in Win32Check gekapselt, was die Exception EOSException auslöst, wenn die Funktion fehlschlägt. Der API-Aufruf sieht folgendermaßen aus:

function TMouse.GetCursorPos: TPoint; begin Win32Check(Windows.GetCursorPos(Result)); end;

Codebeispiele