get_mbuttonget_mbuttonGetMbuttonget_mbuttonGetMbuttonGetMbutton (Operator)

Name

get_mbuttonget_mbuttonGetMbuttonget_mbuttonGetMbuttonGetMbutton — Abfragen der Mausposition bei Tastendruck.

Signatur

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

Beschreibung

get_mbuttonget_mbuttonGetMbuttonget_mbuttonGetMbuttonGetMbutton 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 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_partSetPartset_partSetPartSetPart).

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

Achtung

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

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

WindowHandleWindowHandleWindowHandleWindowHandleWindowHandlewindowHandle (input_control) window → (integer)

Fenster-Handle.

RowRowRowRowRowrow (output_control) point.y → (integer)

Zeilenindex der Mausposition innerhalb der Fensters.

ColumnColumnColumnColumnColumncolumn (output_control) point.x → (integer)

Spaltenindex der Mausposition innerhalb der Fensters.

ButtonButtonButtonButtonButtonbutton (output_control) integer → (integer)

Betätigte Taste(n).

Ergebnis

get_mbuttonget_mbuttonGetMbuttonget_mbuttonGetMbuttonGetMbutton liefert den Wert 2 (H_MSG_TRUE).

Vorgänger

open_windowopen_windowOpenWindowopen_windowOpenWindowOpenWindow

Alternativen

get_mpositionget_mpositionGetMpositionget_mpositionGetMpositionGetMposition, get_mbutton_sub_pixget_mbutton_sub_pixGetMbuttonSubPixget_mbutton_sub_pixGetMbuttonSubPixGetMbuttonSubPix, get_mposition_sub_pixget_mposition_sub_pixGetMpositionSubPixget_mposition_sub_pixGetMpositionSubPixGetMpositionSubPix

Siehe auch

open_windowopen_windowOpenWindowopen_windowOpenWindowOpenWindow

Modul

Foundation