HALCON Website / HALCON Operator-Referenz / Graphik / Maus
KlassenKlassen | | Operatoren

get_mpositionget_mpositionGetMpositionGetMposition (Operator)

Name

get_mpositionget_mpositionGetMpositionGetMposition — Abfragen der Mausposition.

Signatur

get_mposition( : : WindowHandle : Row, Column, Button)

Herror get_mposition(const Hlong WindowHandle, Hlong* Row, Hlong* Column, Hlong* Button)

Herror T_get_mposition(const Htuple WindowHandle, Htuple* Row, Htuple* Column, Htuple* Button)

void GetMposition(const HTuple& WindowHandle, HTuple* Row, HTuple* Column, HTuple* Button)

void HWindow::GetMposition(Hlong* Row, Hlong* Column, Hlong* Button) const

static void HOperatorSet.GetMposition(HTuple windowHandle, out HTuple row, out HTuple column, out HTuple button)

void HWindow.GetMposition(out int row, out int column, out int button)

Beschreibung

get_mpositionget_mpositionGetMpositionGetMpositionGetMposition 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 ButtonButtonButtonButtonbutton 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 ButtonButtonButtonButtonbutton zurückgegeben.

Im Falle eines Grafikfensters berücksichtigen die Koordinaten RowRowRowRowrow und ColumnColumnColumnColumncolumn den aktuellen Bildausschnitt (siehe set_partset_partSetPartSetPartSetPart).

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

Achtung

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

Ausführungsinformationen

Parameter

WindowHandleWindowHandleWindowHandleWindowHandlewindowHandle (input_control)  window → HWindow, HTupleHTupleHtuple (integer) (IntPtr) (Hlong) (Hlong)

Fenster-Handle.

RowRowRowRowrow (output_control)  point.y → HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Zeilenindex der Mausposition innerhalb der Fensters.

ColumnColumnColumnColumncolumn (output_control)  point.x → HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Spaltenindex der Mausposition innerhalb der Fensters.

ButtonButtonButtonButtonbutton (output_control)  integer → HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Betätigte Taste(n) oder 0.

Ergebnis

get_mpositionget_mpositionGetMpositionGetMpositionGetMposition 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_windowOpenWindowOpenWindowOpenWindow

Alternativen

get_mbuttonget_mbuttonGetMbuttonGetMbuttonGetMbutton, get_mposition_sub_pixget_mposition_sub_pixGetMpositionSubPixGetMpositionSubPixGetMpositionSubPix, get_mbutton_sub_pixget_mbutton_sub_pixGetMbuttonSubPixGetMbuttonSubPixGetMbuttonSubPix

Siehe auch

open_windowopen_windowOpenWindowOpenWindowOpenWindow

Modul

Foundation

KlassenKlassen | | Operatoren
HALCON Operator-Referenz 17.12 Copyright © 1996-2017 MVTec Software GmbH