get_mbutton_sub_pixT_get_mbutton_sub_pixGetMbuttonSubPixGetMbuttonSubPix (Operator)

Name

get_mbutton_sub_pixT_get_mbutton_sub_pixGetMbuttonSubPixGetMbuttonSubPix — Abfragen der subpixelgenauen Mausposition bei Tastendruck.

Signatur

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

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

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

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

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

void HWindow.GetMbuttonSubPix(out double row, out double column, out int button)

Beschreibung

get_mbutton_sub_pixget_mbutton_sub_pixGetMbuttonSubPixGetMbuttonSubPixGetMbuttonSubPix liefert die subpixelgenauen Bildkoordinaten der Maus im Ausgabefenster und die dabei betätigten Tasten. Zusätzlich wird der Zustand der Tasten Shift, Strg und Alt zurückgegeben. Die folgenden Werte sind den einzelnen Tasten zugeordnet:

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.

Es wird so lange gewartet, bis eine der Tasten in dem angegebenen HALCON-Fenster gedrückt wird. Im Falle eines Grafikfensters berücksichtigen die Koordinaten RowRowRowRowrow und ColumnColumnColumnColumncolumn den aktuellen Bildausschnitt (siehe set_partset_partSetPartSetPartSetPart).

Falls nur pixelgenaue Bildkoordinaten benötigt werden, kann der Operator get_mbuttonget_mbuttonGetMbuttonGetMbuttonGetMbutton verwendet werden.

Achtung

get_mbutton_sub_pixget_mbutton_sub_pixGetMbuttonSubPixGetMbuttonSubPixGetMbuttonSubPix kommt erst zurück, wenn mit der Maus in das Fenster geklickt wird.

Ausführungsinformationen

Parameter

WindowHandleWindowHandleWindowHandleWindowHandlewindowHandle (input_control)  window HWindow, HTupleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Fenster-Handle.

RowRowRowRowrow (output_control)  point.y HTupleHTupleHtuple (real) (double) (double) (double)

Zeilenkoordinate des Mauscursors im Bildkoordinatensystem.

ColumnColumnColumnColumncolumn (output_control)  point.x HTupleHTupleHtuple (real) (double) (double) (double)

Spaltenkoordinate des Mauscursors im Bildkoordinatensystem.

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

Betätigte Taste(n).

Ergebnis

get_mbutton_sub_pixget_mbutton_sub_pixGetMbuttonSubPixGetMbuttonSubPixGetMbuttonSubPix liefert den Wert 2 (H_MSG_TRUE).

Vorgänger

open_windowopen_windowOpenWindowOpenWindowOpenWindow

Alternativen

get_mbuttonget_mbuttonGetMbuttonGetMbuttonGetMbutton, get_mpositionget_mpositionGetMpositionGetMpositionGetMposition, get_mposition_sub_pixget_mposition_sub_pixGetMpositionSubPixGetMpositionSubPixGetMpositionSubPix

Siehe auch

open_windowopen_windowOpenWindowOpenWindowOpenWindow

Modul

Foundation