send_mouse_down_eventT_send_mouse_down_eventSendMouseDownEventSendMouseDownEventsend_mouse_down_event (Operator)
Name
send_mouse_down_eventT_send_mouse_down_eventSendMouseDownEventSendMouseDownEventsend_mouse_down_event — Senden eines Events, welches das Drücken eines Mausbuttons signalisiert an
einem Pufferfenster.
Signatur
void SendMouseDownEvent(const HTuple& WindowHandle, const HTuple& Row, const HTuple& Column, const HTuple& Button, HTuple* Processed)
HString HWindow::SendMouseDownEvent(const HTuple& Row, const HTuple& Column, Hlong Button) const
HString HWindow::SendMouseDownEvent(Hlong Row, Hlong Column, Hlong Button) const
static HString HDrawingObject::SendMouseDownEvent(const HWindow& WindowHandle, const HTuple& Row, const HTuple& Column, Hlong Button)
static HString HDrawingObject::SendMouseDownEvent(const HWindow& WindowHandle, Hlong Row, Hlong Column, Hlong Button)
static void HOperatorSet.SendMouseDownEvent(HTuple windowHandle, HTuple row, HTuple column, HTuple button, out HTuple processed)
string HWindow.SendMouseDownEvent(HTuple row, HTuple column, int button)
string HWindow.SendMouseDownEvent(int row, int column, int button)
static string HDrawingObject.SendMouseDownEvent(HWindow windowHandle, HTuple row, HTuple column, int button)
static string HDrawingObject.SendMouseDownEvent(HWindow windowHandle, int row, int column, int button)
Beschreibung
send_mouse_down_eventsend_mouse_down_eventSendMouseDownEventSendMouseDownEventsend_mouse_down_event sendet dem Pufferfenster WindowHandleWindowHandleWindowHandlewindowHandlewindow_handle
ein Event, das signalisiert, dass der durch ButtonButtonButtonbuttonbutton kodiert
Mausbutton an der Position (RowRowRowrowrow, ColumnColumnColumncolumncolumn) gedrückt wurde.
In der Dokumentation von get_mbuttonget_mbuttonGetMbuttonGetMbuttonget_mbutton wird beschrieben wie
ButtonButtonButtonbuttonbutton kodiert werden muss.
Mit diesem Operator können Zeichenobjekte manipuliert werden. Zeigen
die Koordinaten RowRowRowrowrow und ColumnColumnColumncolumncolumn auf ein Zeichenobjekt, so
wird das Zeichenobjekt aktiviert und kann durch senden weiterer
Events mit send_mouse_down_eventsend_mouse_down_eventSendMouseDownEventSendMouseDownEventsend_mouse_down_event bewegt oder verändert werden. Um
die Interaktion mit Zeichenobjekten zu vereinfachen, sind die
Koordinaten RowRowRowrowrow und ColumnColumnColumncolumncolumn im
Bildkoordinatensystem gegeben. Um Fenster- in Bildkoordinaten
umzuwandeln kann der Operator
convert_coordinates_window_to_imageconvert_coordinates_window_to_imageConvertCoordinatesWindowToImageConvertCoordinatesWindowToImageconvert_coordinates_window_to_image verwendet werden.
Sofern das Event verarbeitet werden konnte, gibt send_mouse_down_eventsend_mouse_down_eventSendMouseDownEventSendMouseDownEventsend_mouse_down_event
'true'"true""true""true""true" in ProcessedProcessedProcessedprocessedprocessed zurück. Falls keine Aktion aus dem
Event abgeleitet werden konnte (weil sich zum Beispiel kein Zeichenobjekt
an der Mausposition befindet), wird 'false'"false""false""false""false" zurückgegeben. In diesem
Fall kann der Aufrufer das Event behandeln.
Die Operatoren send_mouse_down_eventsend_mouse_down_eventSendMouseDownEventSendMouseDownEventsend_mouse_down_event, send_mouse_up_eventsend_mouse_up_eventSendMouseUpEventSendMouseUpEventsend_mouse_up_event,
send_mouse_drag_eventsend_mouse_drag_eventSendMouseDragEventSendMouseDragEventsend_mouse_drag_event und send_mouse_double_click_eventsend_mouse_double_click_eventSendMouseDoubleClickEventSendMouseDoubleClickEventsend_mouse_double_click_event sind
die einzige Möglichkeit Zeichenobjekte in Pufferfenstern zu manipulieren.
Achtung
send_mouse_down_eventsend_mouse_down_eventSendMouseDownEventSendMouseDownEventsend_mouse_down_event benötigt die Bibliothek libcanvas, die auf
Embedded-Systemen möglicherweise nicht verfügbar ist.
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
WindowHandleWindowHandleWindowHandlewindowHandlewindow_handle (input_control) window → HWindow, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Fenster-Handle des Pufferfensters.
RowRowRowrowrow (input_control) point.y → HTupleUnion[float, int]HTupleHtuple (integer / real) (int / long / double) (Hlong / double) (Hlong / double)
Zeilenkoordinate des Mauscursors im Bildkoordinatensystem.
ColumnColumnColumncolumncolumn (input_control) point.x → HTupleUnion[float, int]HTupleHtuple (integer / real) (int / long / double) (Hlong / double) (Hlong / double)
Spaltenkoordinate des Mauscursors im Bildkoordinatensystem.
ButtonButtonButtonbuttonbutton (input_control) integer → HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Gedrückte Mausbuttons.
ProcessedProcessedProcessedprocessedprocessed (output_control) string → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
'true', wenn das Event verarbeitet werden konnte.
Ergebnis
send_mouse_down_eventsend_mouse_down_eventSendMouseDownEventSendMouseDownEventsend_mouse_down_event liefert den Wert 2 (
H_MSG_TRUE)
, falls WindowHandleWindowHandleWindowHandlewindowHandlewindow_handle
ein Pufferfenster ist. Ansonsten wird eine Fehlerbehandlung
durchgeführt.
Vorgänger
open_windowopen_windowOpenWindowOpenWindowopen_window
Siehe auch
send_mouse_up_eventsend_mouse_up_eventSendMouseUpEventSendMouseUpEventsend_mouse_up_event,
send_mouse_double_click_eventsend_mouse_double_click_eventSendMouseDoubleClickEventSendMouseDoubleClickEventsend_mouse_double_click_event,
open_windowopen_windowOpenWindowOpenWindowopen_window
Modul
Foundation