Share

AcDbLayerTableRecord::setIsHidden

C++

Acad::ErrorStatus setIsHidden(
    bool on
);

Description

Allows the layer to be hidden from the user interface of the host application (provided that the host application honors this flag). AutoCAD, for instance, does not show layers that are hidden.

Hidden layers operate as follows:

  • A hidden layer cannot be seen anywhere in the AutoCAD user interface where layers can be chosen or inspected.
  • An entity that is already on a hidden layer cannot be assigned a new layer and entities that are on normal layers cannot be assigned to a hidden layer via the UI.
  • A hidden layer cannot be made current.
  • Hidden layers show up as regular layers when saved to pre-AutoCAD 2007 formats. Hidden layers do not round-trip. This is to prevent users of older versions of AutoCAD from putting data on layers that may become hidden in later versions.
  • Hidden layer names are not mangled during xref attach. They behave similarly to layer 0.

Returns all the return values of the getName() function. It also returns eInvalidInput if an attempt is made to hide layer 0, the defpoints layer, or an xref-dependent layer.

Parameters

Parameters Description
value Input Boolean indicating whether to hide the layer

Links

AcDbLayerTableRecord

Was this information helpful?