Category Mechanism Design, Object ProKinDrag

Function ProKinDragPerformMove


Description
this function bring to drag this selected object. Displays a hook point around the point. Performs a drag according to the environment set in ProKinDragEnvironmentSet(). For dragging use constraints from current snapshot, if it set. After end of the movement the hook point is removed.
Synopsis
#include <ProKinDrag.h>
ProErrorProKinDragPerformMove(
const ProSelection dragpoint
/* (In)
A geometrical object (PRO_POINT, PRO_SURFACE_PNT, PRO_AXIS, PRO_EDGE, PRO_CURVE, PRO_DATUM_PLANE, PRO_SRF_PLANE_PNT, PRO_SURFACE for PRO_KIN_POINT_DRAG, or PRO_PART, PRO_MDO_BODY for all other drag types) to be dragged. Set the selected-point using ProSelectionPoint3dSet(), otherwise the hook point will be wrong and movement result will be wrong as well.
*/
const Pro2dPnt* screenx_y
/* (In)
ProArray array of Pro2dPnt X and Y screen coordinates we want our dragpoint to be moved to.
*/
)
Returns
PRO_TK_NO_ERRORThe function was successful.
PRO_TK_BAD_INPUTSDragpoint cannot be used for dragging. For example, it may belong to Ground or undefined body.
PRO_TK_NOT_VALIDConnect failed. The model is left unchanged.
PRO_TK_GENERAL_ERRORThe function ProKinDragStart has not been called before.

Manual References:

  1. Assembly: Kinematic Dragging and Creating Snapshots: Performing Kinematic Drag

Sample Code References:

  1. pt_examples ( TestDrag.c )