send_mouse_up_eventsend_mouse_up_eventSendMouseUpEventsend_mouse_up_eventSendMouseUpEventSendMouseUpEvent (Operator)

Name

send_mouse_up_eventsend_mouse_up_eventSendMouseUpEventsend_mouse_up_eventSendMouseUpEventSendMouseUpEvent — Send an event to a buffer window signaling a mouse up event.

Signature

Description

send_mouse_up_eventsend_mouse_up_eventSendMouseUpEventsend_mouse_up_eventSendMouseUpEventSendMouseUpEvent sends an event at the position (RowRowRowRowRowrow, ColumnColumnColumnColumnColumncolumn) to the buffer window WindowHandleWindowHandleWindowHandleWindowHandleWindowHandlewindowHandle, signaling that the mouse button encoded by ButtonButtonButtonButtonButtonbutton has been released. Please refer to get_mbuttonget_mbuttonGetMbuttonget_mbuttonGetMbuttonGetMbutton to see how to encode ButtonButtonButtonButtonButtonbutton.

The purpose of this operator is to release manipulated drawing objects in a buffer window. For example, a drawing object that has been moved by a (sequence of) send_mouse_down_eventsend_mouse_down_eventSendMouseDownEventsend_mouse_down_eventSendMouseDownEventSendMouseDownEvent will be released. To simplify the interaction with the drawing object, the coordinates RowRowRowRowRowrow and ColumnColumnColumnColumnColumncolumn are given in the image coordinate system. To convert window coordinates into image coordinates, the operator convert_coordinates_window_to_imageconvert_coordinates_window_to_imageConvertCoordinatesWindowToImageconvert_coordinates_window_to_imageConvertCoordinatesWindowToImageConvertCoordinatesWindowToImage can be used.

If the event could be processed, send_mouse_up_eventsend_mouse_up_eventSendMouseUpEventsend_mouse_up_eventSendMouseUpEventSendMouseUpEvent returns 'true'"true""true""true""true""true" in ProcessedProcessedProcessedProcessedProcessedprocessed. If no action for the event could be determined (e.g., because there is no drawing object below the mouse position), 'false'"false""false""false""false""false" is returned in ProcessedProcessedProcessedProcessedProcessedprocessed. In this case the caller may determine an action for the event.

The operators send_mouse_down_eventsend_mouse_down_eventSendMouseDownEventsend_mouse_down_eventSendMouseDownEventSendMouseDownEvent, send_mouse_up_eventsend_mouse_up_eventSendMouseUpEventsend_mouse_up_eventSendMouseUpEventSendMouseUpEvent, send_mouse_drag_eventsend_mouse_drag_eventSendMouseDragEventsend_mouse_drag_eventSendMouseDragEventSendMouseDragEvent and send_mouse_double_click_eventsend_mouse_double_click_eventSendMouseDoubleClickEventsend_mouse_double_click_eventSendMouseDoubleClickEventSendMouseDoubleClickEvent are the only means to manipulate drawing objects in buffer windows.

Attention

send_mouse_up_eventsend_mouse_up_eventSendMouseUpEventsend_mouse_up_eventSendMouseUpEventSendMouseUpEvent depends on the library libcanvas, which might not be available on embedded systems.

Parallelization

• Multithreading type: reentrant (runs in parallel with non-exclusive operators).
• Multithreading scope: global (may be called from any thread).
• Processed without parallelization.

Parameters

Result

send_mouse_up_eventsend_mouse_up_eventSendMouseUpEventsend_mouse_up_eventSendMouseUpEventSendMouseUpEvent returns the value 2 (H_MSG_TRUE) if the window handle WindowHandleWindowHandleWindowHandleWindowHandleWindowHandlewindowHandle corresponds to a window of valid type, and the event is properly encoded. Otherwise, an exception is raised.

Possible Predecessors

open_windowopen_windowOpenWindowopen_windowOpenWindowOpenWindow

See also

send_mouse_down_eventsend_mouse_down_eventSendMouseDownEventsend_mouse_down_eventSendMouseDownEventSendMouseDownEvent, send_mouse_double_click_eventsend_mouse_double_click_eventSendMouseDoubleClickEventsend_mouse_double_click_eventSendMouseDoubleClickEventSendMouseDoubleClickEvent, open_windowopen_windowOpenWindowopen_windowOpenWindowOpenWindow

Module

Foundation