1.31.4 Send methods

connect_gesture ->connect: from=graphical, to=graphical, link=link, from_handle=[name], to_handle=[name]

This method is called from connect_gesture->terminate. It's responsibility is to create the actual connection object. The default implementation is to invoke graphical->connect with the corresponding arguments. This method may be redefined.

connect_gesture ->drag: event

Updates the connect_gesture<-end of the connect_gesture<-line. Next searches for graphicals on connect_gesture<-device that overlap with the pointer and have suitable handles. When found, invokes connect_gesture->indicate to provide visual feedback to the user on the matching handles.

connect_gesture ->indicate: at=graphical, near=event, handle_kind=name, indicators=chain, variable={to_handle,from_handle}

If there are any possible handle objects within 10 pixels of the pointer, indicate the closest using connect_gesture->indicate_handle.and fill the given variable (connect_gesture<-to_handle or connect_gesture<-from_handle) with the name of the closest handle.

Else if there are any pointer handle objects anywhere on the graphical under the pointer, indicate them. Fill the given variable with @default.

connect_gesture ->indicate_handle: at=graphical, handle=name, indicators=chain

Indicate the position of the named handle using a free indicator bitmap from the given list of indicators. Whether or not an indicators is free is determined by the graphical<-name of the indicator: unused or used. Used by connect_gesture->indicate.

connect_gesture ->initialise: button=[button_name], modifier=[modifier], link=[link]

Create a connect_gesture object from the button it should operate on, possible modifier keys and the link object to use for the connection. This link object is used to determine the valid handle objects for the connection object to be created as well as the attributes of the connect_gesture<-line used for feedback.

connect_gesture ->initiate: event

Set's up the connect gesture. This consist of the following steps:

1. Prepare the connect_gesture<-line using: a) line->copy using the line of the connect_gesture<-link. b) graphical->texture c)‘line connect_gesture->points with the connect_gesture<-x and connect_gesture<-y of the event
2. Display the line on connect_gesture<-device
3. connect_gesture->indicate the handle objects on the receiving graphicals. @see connect_gesture-from_handle

connect_gesture ->terminate: event

Invokes connect_gesture->drag. Next removes the connect_gesture<-line and the indicator bitmaps from the connect_gesture<-device and finally invokes connect_gesture->connect using the following arguments:

constant<-receiver	The from graphical
connect_gesture<-to	The to graphical
connect_gesture<-link	The connect_gesture<-link
connect_gesture<-from_handle	Handle name at the from side
connect_gesture<-to_handle	Handle name at the to side

connect_gesture ->verify: event

Fails if either the receiving graphical object has no‘graphical connect_gesture<-device’or connect_gesture<-link equals @nil.

Otherwise assigns connect_gesture<-device to the graphical<-device and succeed.

See also

connect_gesture-link