get_mposition_sub_pixT_get_mposition_sub_pixGetMpositionSubPixGetMpositionSubPix (Operator)

Name

get_mposition_sub_pixT_get_mposition_sub_pixGetMpositionSubPixGetMpositionSubPix — Abfragen der subpixelgenauen Mausposition.

Signatur

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

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

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

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

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

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

Beschreibung

get_mposition_sub_pixget_mposition_sub_pixGetMpositionSubPixGetMpositionSubPixGetMpositionSubPix liefert die subpixelgenauen Bildoordinaten 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 nur pixelgenaue Bildkoordinaten benötigt werden, kann der Operator get_mpositionget_mpositionGetMpositionGetMpositionGetMposition verwendet werden.

Achtung

get_mposition_sub_pixget_mposition_sub_pixGetMpositionSubPixGetMpositionSubPixGetMpositionSubPix 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 (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) oder 0.

Ergebnis

get_mposition_sub_pixget_mposition_sub_pixGetMpositionSubPixGetMpositionSubPixGetMpositionSubPix 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_mpositionget_mpositionGetMpositionGetMpositionGetMposition, get_mbutton_sub_pixget_mbutton_sub_pixGetMbuttonSubPixGetMbuttonSubPixGetMbuttonSubPix

Siehe auch

open_windowopen_windowOpenWindowOpenWindowOpenWindow

Modul

Foundation