get_mpositionget_mpositionGetMpositionget_mpositionGetMpositionGetMposition (Operator)

Name

get_mpositionget_mpositionGetMpositionget_mpositionGetMpositionGetMposition — Abfragen der Mausposition.

Signatur

Beschreibung

get_mpositionget_mpositionGetMpositionget_mpositionGetMpositionGetMposition 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 ButtonButtonButtonButtonButtonbutton zurückgegeben. Die folgenden Werte sind den einzelnen Tasten zugeordnet:

0:

Keine Taste,

1:

Linke Taste,

2:

Mittlere Taste,

4:

Rechte Taste,

8:

Shift Taste,

16:

Strg Taste,

32:

Alt Taste.

Die Summe der Werte aller gedrückten Tasten wird in ButtonButtonButtonButtonButtonbutton zurückgegeben.

Im Falle eines Grafikfensters berücksichtigen die Koordinaten RowRowRowRowRowrow und ColumnColumnColumnColumnColumncolumn den aktuellen Bildausschnitt (siehe set_partset_partSetPartset_partSetPartSetPart).

Falls subpixelgenaue Bildkoordinaten benötigt werden, kann der Operator get_mposition_sub_pixget_mposition_sub_pixGetMpositionSubPixget_mposition_sub_pixGetMpositionSubPixGetMpositionSubPix verwendet werden.

Achtung

get_mpositionget_mpositionGetMpositionget_mpositionGetMpositionGetMposition scheitert (FAIL), falls sich die Maus nicht innerhalb des Fensters befindet. In diesem Fall werden in den drei Parametern keine Werte übergeben.

Parallelisierung

• Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
• Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
• Wird ohne Parallelisierung verarbeitet.

Parameter

Ergebnis

get_mpositionget_mpositionGetMpositionget_mpositionGetMpositionGetMposition liefert den Wert 2 (H_MSG_TRUE). Befindet sich der Cursor außerhalb des Fensters, wird 5 (H_MSG_FAIL) ausgegeben.

Vorgänger

open_windowopen_windowOpenWindowopen_windowOpenWindowOpenWindow

Alternativen

get_mbuttonget_mbuttonGetMbuttonget_mbuttonGetMbuttonGetMbutton, get_mposition_sub_pixget_mposition_sub_pixGetMpositionSubPixget_mposition_sub_pixGetMpositionSubPixGetMpositionSubPix, get_mbutton_sub_pixget_mbutton_sub_pixGetMbuttonSubPixget_mbutton_sub_pixGetMbuttonSubPixGetMbuttonSubPix

Siehe auch

open_windowopen_windowOpenWindowopen_windowOpenWindowOpenWindow

Modul

Foundation