get_mposition — Abfragen der Mausposition.
get_mposition( : : WindowHandle : Row, Column, Button)
get_mposition liefert die pixelgenauen Bildkoordinaten der Maus im
Ausgabefenster und den Code für die betätigten Tasten.
Die Daten werden unabhängig vom Zustand der Tasten (betätigt oder
nicht betätigt) abgeliefert. Wurde mindestens eine Maustaste gedrückt,
wird auch der Zustand der Tasten Shift, Strg und Alt zurückgegeben.
Wurde keine Maustaste gedrückt, wird auf jeden Fall 0 in Button
zurückgegeben. Die folgenden Werte sind den einzelnen Tasten zugeordnet:
Keine Taste,
Linke Taste,
Mittlere Taste,
Rechte Taste,
Shift Taste,
Strg Taste,
Alt Taste.
Die Summe der Werte aller gedrückten Tasten wird in Button
zurückgegeben.
Im Falle eines Grafikfensters berücksichtigen die Koordinaten Row
und Column den aktuellen Bildausschnitt (siehe set_part).
Falls subpixelgenaue Bildkoordinaten benötigt werden, kann der Operator
get_mposition_sub_pix verwendet werden.
get_mposition scheitert (FAIL), falls sich die Maus
nicht innerhalb des Fensters befindet. In diesem Fall
werden in den drei Parametern keine Werte übergeben.
WindowHandle (input_control) window → (handle)
Fenster-Handle.
Row (output_control) point.y → (integer)
Zeilenkoordinate des Mauscursors im Bildkoordinatensystem.
Column (output_control) point.x → (integer)
Spaltenkoordinate des Mauscursors im Bildkoordinatensystem.
Button (output_control) integer → (integer)
Betätigte Taste(n) oder 0.
get_mposition liefert den Wert 2 (H_MSG_TRUE).
Befindet sich der Cursor außerhalb des
Fensters, wird 5 (H_MSG_FAIL) ausgegeben.
get_mbutton,
get_mposition_sub_pix,
get_mbutton_sub_pix
Foundation