get_mbutton_sub_pixT_get_mbutton_sub_pixGetMbuttonSubPixGetMbuttonSubPixget_mbutton_sub_pix (Operator)
Name
get_mbutton_sub_pixT_get_mbutton_sub_pixGetMbuttonSubPixGetMbuttonSubPixget_mbutton_sub_pix — Abfragen der subpixelgenauen Mausposition bei Tastendruck.
Signatur
def get_mbutton_sub_pix(window_handle: HHandle) -> Tuple[float, float, int]
Beschreibung
get_mbutton_sub_pixget_mbutton_sub_pixGetMbuttonSubPixGetMbuttonSubPixGetMbuttonSubPixget_mbutton_sub_pix 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 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 nur pixelgenaue Bildkoordinaten benötigt werden, kann der Operator
get_mbuttonget_mbuttonGetMbuttonGetMbuttonGetMbuttonget_mbutton verwendet werden.
Achtung
get_mbutton_sub_pixget_mbutton_sub_pixGetMbuttonSubPixGetMbuttonSubPixGetMbuttonSubPixget_mbutton_sub_pix kommt erst zurück, wenn mit der Maus in das
Fenster geklickt wird.
Ausführungsinformationen
- Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
- Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
- Wird ohne Parallelisierung verarbeitet.
Parameter
WindowHandleWindowHandleWindowHandleWindowHandlewindowHandlewindow_handle (input_control) window → HWindow, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Fenster-Handle.
RowRowRowRowrowrow (output_control) point.y → HTuplefloatHTupleHtuple (real) (double) (double) (double)
Zeilenkoordinate des Mauscursors im Bildkoordinatensystem.
ColumnColumnColumnColumncolumncolumn (output_control) point.x → HTuplefloatHTupleHtuple (real) (double) (double) (double)
Spaltenkoordinate des Mauscursors im Bildkoordinatensystem.
ButtonButtonButtonButtonbuttonbutton (output_control) integer → HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Betätigte Taste(n).
Ergebnis
get_mbutton_sub_pixget_mbutton_sub_pixGetMbuttonSubPixGetMbuttonSubPixGetMbuttonSubPixget_mbutton_sub_pix liefert den Wert TRUE.
Vorgänger
open_windowopen_windowOpenWindowOpenWindowOpenWindowopen_window
Alternativen
get_mbuttonget_mbuttonGetMbuttonGetMbuttonGetMbuttonget_mbutton,
get_mpositionget_mpositionGetMpositionGetMpositionGetMpositionget_mposition,
get_mposition_sub_pixget_mposition_sub_pixGetMpositionSubPixGetMpositionSubPixGetMpositionSubPixget_mposition_sub_pix
Siehe auch
open_windowopen_windowOpenWindowOpenWindowOpenWindowopen_window
Modul
Foundation