AcDbEntity::moveGripPointsAt

C++

ACDBCORE2D_PORT ADESK_SEALED_VIRTUAL Acad::ErrorStatus moveGripPointsAt(
    const AcDbVoidPtrArray& gripAppData, 
    const AcGeVector3d& offset, 
    const int bitflags
);

Description

Function usage

This function is intended to be called by the host application to move the grip points during a grip edit of the entity. However, it is also possible for ObjectARX applications to call it.

Prior to calling this function, an ObjectARX application must call

virtual Acad::ErrorStatus   getGripPoints(AcDbGripDataArray& grips,
const double curViewUnitSize, const AcGeVector3d curViewDir,
const int bitflags) const;

to obtain the grip points and their application data pointers.

A host application calls this function only if the previous call to AcDbEntity::getGripPoints returned Acad:eOK.

On success this function returns Acad::eOK.

It is recommended that the grip application data maintain pointers to the AcDbDimData objects associated with this grip.

Function implementation in derived classes

The application must override this function and update the entity being grip edited. The application also must update the dynamic dimensions associated with this grip to conform to the geometry change of the entity being grip edited.

This function modifies the entity such that the grip points identified by the gripAppData array are translated to the direction and magnitude specified by the offset vector. How this affects the rest of the entity is dependent on the entity, but any other effects must also be taken care of by this function since this function is expected to perform all entity modifications that result from the grip edit.

If this function is implemented in a derived class,

virtual Acad::ErrorStatus   getGripPoints(AcDbGripDataArray& grips,
const double curViewUnitSize, const AcGeVector3d curViewDir,
const int bitflags) const;

must also be implemented.

On success, this function should return Acad::eOk. Return values for error conditions are up to the implementer.

Function usage

The default implementation does nothing and immediately returns Acad::eNotImplemented.

Parameters

Links

AcDbEntity