PCE version 4C man_modulenamespaceid_tablemodified current_idOIxNclass/connectionN referenceC hash_tablerefersizeOIxaI sN C.connectionCman_class_card identifiermodule last_modifiednamesummary descriptionsee_alsoinherituser_interfacebugsOIxN C.connectionRICdateOIx,}E›N connectionnCstringOIx Class connection is a subclass of class line. A connection is a line that connects two graphical objects and is automatically updated if either of them changes. A connection is the instantiation of a link. The link object describes the generic properties of the line: what the line looks like and handle objects it can connect too. A connection may be created between any two graphical object displayed on the same window object. The connected graphicals may be arbitrary deeply nested on device objects. The connection itself is displayed in the deepest nested device that displays both connected graphicals. See also class link, class handle, `graphical ->connect', `graphical <-connected' and class connect_gesture. The drawing program PceDraw exploits connections.CchainsizeOIxI eN,$class/graphical$M.graphical.G.common_deviceeN $topics$138eN&$class/graphical$M.graphical.S.connecteN%$class/graphical$M.graphical.S.handleeN($class/connect_gesture$C.connect_gestureeN$class/line$C.lineeN$class/constraint$C.constrainteN $examples$10eN$class/link$C.linkeN$class/handle$C.handleXnnnsNV.connection.toCman_variable_card identifiermodule last_modifiednamesummary descriptionsee_alsoinheritdefaultsOIxNV.connection.toRIOIx,KûNtonnnOI xIENV.connection.fromXnsNV.connection.to_handleOI xNV.connection.to_handleRIOI x,KûmN to_handlennnOI xIENV.connection.from_handleXnsNM.connection.S.computeCman_method_card identifiermodule last_modifiednamesummary descriptionsee_alsoinherit diagnosticsdefaultsbugsOI xNM.connection.S.computeRIOIx,Ký¢NcomputenOIxPerforms the following operations: * if -for either graphical-, <-is_displayed yields @off, undisplay the connection. * Recompute <-from_handle and <-to_handle if these are not fixed * Recompute the positions of these handles and update the line using ->points if necessary.nnnnnsNM.connection.S.pointsOIxNM.connection.S.pointsRIOIx,KøŽNpointsnOIx Define the start and end-point of the connection. This method is called from ->compute. ->points is the only method to change a connection as all other methods are discarded by a redefined ->geometry method. ->points may be used to manage a label for the connection.nnnnnsNV.connection.from_handleOIxNV.connection.from_handleRIOIx,Kû¶N from_handlenOIx¸Name of the handle used at the indicated end. Depending on <-fixed_from/fixed_to, this handle is or is not updated if either of the connected graphicals is moved or changed otherwise.nnnsNV.connection.fixed_fromOIxNV.connection.fixed_fromRIOIx,}E›N fixed_fromnOIx9The slots <-fixed_from and <-fixed_to are used internally to represent that the handles the connection is related to (<-from_handle and <-to_handle) should not be reconsidered if the connection is updated. These values are normally @off and set to @on by ->initialise if the corresponding handle is specified.nnnsNV.connection.fromOIxNV.connection.fromRIOIx,KûRNfromnOIx‘Related graphical and the indicated end of the connection. See also `graphical <-connections', `graphical <-connected', `connection <-opposite'.nnnsNM.connection.G.oppositeOIxNM.connection.G.oppositeRIOIx,KüNoppositenOIxcIf the argument graphical is either <-from or <-to, return the other end. Fail silently otherwise.nnnnnsNM.connection.S.geometryOIxNM.connection.S.geometryRIOI x,KüNgeometrynOI!xlNo-op. The coordinates of a connection are determined by the graphical objects related. See also ->points.nnnnnsNV.connection.fixed_toOI"xNV.connection.fixed_toRIOI#x,KøÆNfixed_tonnnOI$xIENV.connection.fixed_fromXnsN%M.connection.S.update_link_attributesOI%xN%M.connection.S.update_link_attributesRIOI&x,Kþ"Nupdate_link_attributesnOI'xMRe-read <-arrows, <-texture and <-pen from the <-link and update accordingly.nnnnnsNM.connection.S.initialiseOI(xNM.connection.S.initialiseRIOI)x.¨14N initialisenOI*xDCreate a connection object (automatically updating line) between the two graphicals. The first becomes `connection <-from'; the second `connection <-to'. `Link' is a link object describing the handles and characteristics of the line (<-pen, <-arrows, ...). The two name arguments define the name of the handle to connect to at the <-from resp. <-to side. When omitted and there are multiple matching handles PCE will connect to the `best-looking' one. Always succeeds, also if the line cannot (yet) been created because there is no common device to display the graphical on.OI+xIEN&$class/graphical$M.graphical.S.connectXnnnnXuCnumber O I,xx