Question

实体简介

实体是具有图形表示 的数据库对象，实体的例子有直线、圆、圆弧、文本、曲线和椭圆等。

实体组成了控件图形，用户在控件中的操作都是对实体进行的，可见实体具有非常重要的地位。在控件中绝大部分实体都是从McDbEntity 中派生出来的，而McDbEntity是从McDbObject 中派生出来的。

实体的共同属性

所有实体都有一些共同的属性，这些属性可以通过相同的成员函数来获得或修改，当然，这些属性也可以被用户命令修改。实体的共同属性如下：

颜色

线型

线型比例

可见性

层

线宽

当用户添加一个实体到块表记录中时，控件会自动将用户没有指定的实体属性设为缺省值。

颜色

实体的颜色可以通过0~256的数字值来指定和读取，也可以通过McCmColor 类的实例来指定和读取，McCmColor类可以用来扩展颜色模型。McCmColor类可以用来表示真彩色中的任何一种色彩。

颜色值1~7代表的标准颜色如下：

颜色值	1	2	3	4	5	6	7
颜色	红	黄	绿	青	蓝	紫红	白或黑

颜色值7对应的颜色与控件背景颜色有关。如果背景是黑，则7对应的颜色是白，反之则对应的颜色是黑。

还有一些颜色值代表了一些特殊的含义：

0：指定实体的颜色为BYBLOCK 。即实体继承当前块表记录中块参照的颜色值，如果实体直接处于模型空间或图纸空间块表记录中，则实体的颜色就是黑或白。

256：指定实体的颜色为BYLAYER 。实体使用其所在层的颜色。

257：实体无颜色 。这种情况仅在实体刚刚实例化，在被赋予0~256之间颜色值或被添加到数据库并使用数据库的当前颜色值之前才会出现。

可以使用下面的函数来设置或查询实体的颜色：

通过索引设置颜色：

Mcad::ErrorStatus McDbEntity::setColorIndex(Mdesk::Uint16 color);

通过索引读取颜色：

Mdesk::Uint16 McDbEntity::colorIndex() const;

通过McCmColor类设置颜色：

Mcad::ErrorStatus McDbEntity::setColor(const McCmColor& color, Mdesk::BooleandoSubents = true);

通过McCmColor类读取颜色：

McCmColor McDbEntity::color() const;

线型

当一个实体被创建时，它的线型被设置为NULL 。当实体被添加到数据库后，如果没有这个实体指定的线型，则该实体的线型将被设置成数据库的当前线型值。这个缺省的线型值存放在CELTYPE系统变量中。线型可以通过名称字符串或在实体所在数据库的McDbLineTypeTableRecord 的对象ID来指定。

可以使用下面的函数用实体名或对象ID来指定实体的线型：

使用函数用实体名来指定实体的线型：

Mcad::ErrorStatus McDbEntity::setLinetype(const char* newVal);

使用对象ID来指定实体的线型：

Mcad::ErrorStatus McDbEntity::setLinetype(McDbObjectId newVal);

下面的函数返回实体的线型名：

LPCTSTR  McDbEntity::linetype() const;

下面的函数返回线型符号表记录的对象ID：

McDbObjectId McDbEntity::linetypeId() const;

线型比例

当一个实体被创建时，它的线型比例被设置成一个无效值。当对象被添加到数据库中后，如果没有为这个实体指定线型比例，则该实体的线型比例将被设置成数据库的当前线型比例值。这个缺省的线型比例值存放在CELTSCALE 系统变量中。

可以使用下面的函数来设置或查询一个实体的线型比例值：

可以使用下面的函数来设置一个实体的线型比例值：

Mcad::ErrorStatus McDbEntity::setLinetypeScale(double newVal);

可以使用下面的函数来查询一个实体的线型比例值：

Double McDbEntity::linetypeScale() const;

当实体被重新生成后，它的有效线型比例是实体自身线型比例和全局数据库线型比例的乘积。对于非图纸空间的实体，它的线型比例可按如下方法计算：

effltscale = ent->linetypeScale() * ent->database()->ltscale();

可见性

如果指定一个实体不可见，则不管数据库中其他设置如何，该实体都将不可见。其他因素也可能导致实体不可见，例如：如果实体所在层被关闭或冻结，则该实体不可见。实体可见或不可见可以用一个变量 McDb::Visibility 来表示，它的值可以是kInvisible 或 kVisible 。

可以用下面的函数来设置或查询一个实体的可见性：

可以用下面的函数来设置一个实体的可见性：

Mcad::ErrorStatus McDbEntity::setVisibility(McDb::Visibility newVal);

可以用下面的函数来查询一个实体的可见性：

McDb::Visibility McDbEntity::visibility() const;

层

所有实体都在某一个层上。在数据库中，最少包含一个层（初始情况下是0层）。和线型一样，用户可以为一个实体指定所在的层。如果用户不为实体指定层，则系统将会把这个实体添加到缺省层上。

每一个层有自己相关的属性，这此属性包括冻结/解冻、打开/关闭、锁定/解锁、颜色、线型和视口。当一个实体的颜色或线型是BYLAYER时，实体上的相关属性将会使用层的属性。

可以使用下面的函数来设置或查询一个实体所在的层：

可以使用下面的函数来设置一个实体所在的层：

Mcad::ErrorStatus McDbEntity::setLayer(const char* newVal);

可以使用下面的函数来查询一个实体所在的层：

Mcad::ErrorStatus McDbEntity::setLayer(McDbObjectId newVal);

下面的函数返回当前实体所在层的名称：

LPCTSTR McDbEntity::layer() const;

下面的函数返回实体所在层的对象ID：

McDbObjectId McDbEntity::layerId() const;