This wraps the ObjectARX AcDbEntity::pushHighlight() method. 

The later pushed highlight effect will override the former push highlight effect. We could highlight different sub-entity with different style at the same time. 

If we first push sub-entity with highlight style1, then push entity with highlight style2, then the whole entity will display highlight style2. After pop the entity highlight, the former sub-entity will continue display with highlight style1. 

If we first push entity with highlight style1, then push sub-entity with highlight style2, then the whole entity will not be highlight, and only display highlight of sub-entity with highlight style2. After pop the highlight of former sub-entity, the whole entity will display with highlight style1.

Public Function PushHighlight(
    subId As FullSubentityPath, 
    highlightStyle As HighlightStyle
) As void

public void PushHighlight(
    FullSubentityPath subId, 
    HighlightStyle highlightStyle
);

popHighlight