Share

AcDbEntity::getGripPoints

C++

ACDBCORE2D_PORT ADESK_SEALED_VIRTUAL Acad::ErrorStatus getGripPoints(
    AcGePoint3dArray& gripPoints, 
    AcDbIntArray & osnapModes, 
    AcDbIntArray & geomIds
) const;

Description

Function usage

This function supports "old style" grips, in applications that existed before the enhancement of grip functionality by the addition of the AcDbGripData class.

This function is not intended to be called by ObjectARX applications. However, it is possible to do so (for example, as a pass-through from the getStretchPoints() method).

Function implementation in derived classes

This function should append to the gripPoints array any points that are to treated as grip points for the entity.

The gripPoints array is passed to all entities involved in the grip operation, so the array may already contain grip points for other entities. Therefore, it is very important to append the new points rather than assigning them to any existing elements in the array.

When finished appending all desired grip points, return Acad::eOk. If anything other than Acad::eOk is returned, then grips are not activated for this entity.

The osnapModes and geomIds arguments are not currently used.

Default implementation

Immediately returns Adesk::eNotImplemented.

Parameters

Parameters Description
gripPoints Input pre-existing array to append the grip points to; output with the entity's grip points appended
osnapModes not currently in use
geomIds not currently in use

Links

AcDbEntity

Was this information helpful?