get_mbuttonT_get_mbuttonGetMbuttonGetMbuttonget_mbutton (Operator)

Name

get_mbuttonT_get_mbuttonGetMbuttonGetMbuttonget_mbutton — Abfragen der Mausposition bei Tastendruck.

Signatur

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

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

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

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

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

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

def get_mbutton(window_handle: HHandle) -> Tuple[int, int, int]

Beschreibung

get_mbuttonget_mbuttonGetMbuttonGetMbuttonGetMbuttonget_mbutton liefert die pixelgenauen 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, addiert zum Wert der gedrückten Maustaste, wird in ButtonButtonButtonButtonbuttonbutton 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 RowRowRowRowrowrow und ColumnColumnColumnColumncolumncolumn den aktuellen Bildausschnitt (siehe set_partset_partSetPartSetPartSetPartset_part).

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

Achtung

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

Ausführungsinformationen

Parameter

WindowHandleWindowHandleWindowHandleWindowHandlewindowHandlewindow_handle (input_control)  window HWindow, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Fenster-Handle.

RowRowRowRowrowrow (output_control)  point.y HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Zeilenkoordinate des Mauscursors im Bildkoordinatensystem.

ColumnColumnColumnColumncolumncolumn (output_control)  point.x HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Spaltenkoordinate des Mauscursors im Bildkoordinatensystem.

ButtonButtonButtonButtonbuttonbutton (output_control)  integer HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Betätigte Taste(n).

Ergebnis

get_mbuttonget_mbuttonGetMbuttonGetMbuttonGetMbuttonget_mbutton liefert den Wert 2 (H_MSG_TRUE).

Vorgänger

open_windowopen_windowOpenWindowOpenWindowOpenWindowopen_window

Alternativen

get_mpositionget_mpositionGetMpositionGetMpositionGetMpositionget_mposition, get_mbutton_sub_pixget_mbutton_sub_pixGetMbuttonSubPixGetMbuttonSubPixGetMbuttonSubPixget_mbutton_sub_pix, get_mposition_sub_pixget_mposition_sub_pixGetMpositionSubPixGetMpositionSubPixGetMpositionSubPixget_mposition_sub_pix

Siehe auch

open_windowopen_windowOpenWindowOpenWindowOpenWindowopen_window

Modul

Foundation