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.
Calls the Entity.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.
Public Function GetStretchPoints( stretchPoints As Point3dCollection ) As void
public void GetStretchPoints( Point3dCollection stretchPoints );
Parameters |
Description |
Point3dCollection stretchPoints |
Input pre-existing array to append the stretch points to; output with the entity's stretch points appended |
Comments? |