AcDbEntity::getStretchPoints

C++

ACDBCORE2D_PORT ADESK_SEALED_VIRTUAL Acad::ErrorStatus getStretchPoints(
    AcGePoint3dArray& stretchPoints
) const;

Description

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 getGripPoints() method).

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

Stretch points are used by the stretch command within AutoCAD. Any stretch points that are within the crossing selection window during the stretch command, will be moved by whatever amount the user decides to "stretch" the selected entities. Any stretch points not in the crossing selection window will be left alone. This combination of some stretch points moving while others do not is what "stretches" the entity. If all stretch points are in the crossing window, then the entity is moved instead of stretched.

The stretchPoints array is passed to all entities involved in the stretch operation, so the array may already contain stretch 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 stretch points, return Acad::eOk. If anything other than Acad::eOk is returned, then this entity's stretch points will be ignored by the stretch operation.

Calls the AcDbEntity::getGripPoints() method. So, unless the entity needs to have stretch points that are different from the grip points, there is no need to override this method.

Parameters

Links

AcDbEntity