C++
Acad::ErrorStatus setPlotStyleName( const AcDbObjectId& newId );
Description
This function sets the entity to reference the AcDbPlaceHolder that has the object ID newId. The AcDbPlaceHolder object must be owned by the plot style name dictionary. The plot style name dictionary's key for the AcDbPlaceHolder object is the plot style name string.
If the function is successful, then Acad::eOk is returned.
If the AcDbLayerTableRecord object on which this function is called is database resident and the database is in plot style legacy mode (in other words, AcDbDatabase::plotStyleMode() returns true), then this function will fail and will return Acad::ePlotStyleInColorDependentMode.
If the object with object ID newId is not an AcDbPlaceHolder object, then Acad::eWrongObjectType is returned.
An attempt is made to open (for read) the object identified by newId in order to determine if it is indeed an AcDbPlaceHolder object. If the open attempt fails, then the error status returned by the failed open attempt will be returned by this function (see acdbOpenObject() for possible return values).
Parameters
| Parameters | Description |
|---|---|
| newId | Input object ID of the AcDbPlaceHolder object to be referenced by the entity |