Share

AcDbEntity::pushHighlight Method

C++

Acad::ErrorStatus pushHighlight(
    const AcDbFullSubentPath& subId, 
    AcGiHighlightStyle highlightStyle
);

Description

The later pushed highlight effect will override the former push highlight effect. Different sub-entities can be highlighted with different styles at the same time.

If we first push to a sub-entity highlight style1, then push to an entity highlight style2, then the whole entity will display highlight style2. After the highlight is popped from the entity, the sub-entity will continue to be displayed with highlight style1.

If highlight style1 is first pushed to the entity, then highlight style2 is pushed to the sub-entity, then the whole entity will not be highlighted, and only the sub-entity display will be highlighted with highlight style2. After a popHighlight is performed on the sub-entity, the whole entity display will be highlighted with highlight style1.

Parameters

Parameters Description
subId Input AcDbFullSubentPath that identifies the subentity to highlight
highlightStyle Input AcGiHighlightStyle for this subid

Returns

Returns Acad::eOk if successful.

Links

AcDbEntity

See Also

popHighlight

Was this information helpful?