ObjectARX学习笔记2-acdb类杂记.docx

/zhanglibo0626/archive/2010/06/05/1752169.htmlacdb类杂记从今天起我陆续贴给大家：AcApLayoutManager 类处理和访问AcDbLayout对象的应用程序特定程序的接口类。这个类也控制着与GUI属性相关的Layout(布局)。继承自AcDbLayoutManager包含文件acaplmgr.h参见AcDbLayout, AcDbLayoutManager成员AcApLayoutManager Application Methods （应用程序方法）AcApLayoutManager::CreateViewports函数virtual Adesk::BooleancreateViewports() = 0;当在图纸空间布局里能默认建立一个视口时，这个函数返回kTrue，否则返回kFalse。AcApLayoutManager::findActiveTab函数virtual const char *findActiveTab() = 0;这个函数返回一个指向当前选定布局标签的名称的指针常量，这个名称就是当前AcDbLayout对象的名称。AcApLayoutManager::getClipBoundaryElaboration函数virtual Acad::ErrorStatusgetClipBoundaryElaboration(AcDbObjectId clipId,AcGePoint2dArray * clipBoundary) = 0;clipId传递非矩形裁剪实体视口的AcDbObjectIdclipBoundary返回指向裁剪实体视口的AcGePoint2dArray边界点的指针这个函数取得一个非矩形裁剪实体视口的AcDbObjectId并在一个AcGePoint2dArray对象数组中返回屏幕上的边界点。边界点在图纸空 间图形坐标中。如果在显示列表中找到一个边界且成功返回，则返回值为eOK，调用者必须在使用后删除已返回的clipBoundary。如果找不到实体的 边界，则返回错误状态。如果应用程序打开的要求有边界的AcDbViewport，则clipId参数将传递给视口的 AcDbViewport::nonRectClipEntityId()方法，这个方法将返回视口裁剪实体的AcDbObjectId。AcApLayoutManager::getNextNewLayoutName函数virtual char *getNextNewLayoutName(AcDbDatabase* useDb = NULL) = 0;useDb输入指向AcDbDatabase的指针，可选的；默认使用当前数据库这个函数扫描名称与Layout#类型相匹配的已有的布局（包含已删除的布局），其中“#”是一个从1开始的数。这个函数从“Layout1”开始，试图找出未在这个格式中使用的布局类型，并返回该布局类型。AcApLayoutManager::pageSetup函数virtual intpageSetup(AcDbObjectId layoutBTRId = AcDbObjectId::kNull,void* pParent = NULL,Adesk::Boolean isPageSetupDlg = TRUE) = 0;layoutBTRId输入AcDbLayout块表记录用于初始化对话框的AcDbObjectId，可选的；默认值AcDbObjectId::kNull表示使用活动的AcDbLayout对象。pParent输入指向父窗口调用对话框的指针，可选的；默认值NULL表示使用AutoCAD的主窗口。isPageSetupDlg输入布尔值，在页面设置和绘图对话框之间进行切换。在默认情况下，这个函数使用当前的AcDbLayout对象加载“页面设置”对话框。另外可选的，这个函数使用一个不同的AcDbLayout对象、一个指向父窗口的指针以及表示是否使用共享的绘图对话框代替“页面设置”对话框的布尔值作为参数进行初始化。如果“页面设置”对话框被取消，则这个函数返回0；如果“页面设置”对话框成功，则这个函数返回1；在任何错误的情况下，返回-1。AcApLayoutManager::pointInViewports函数virtual Acad::ErrorStatuspointInViewports(const AcGePoint3d pickPt,AcDbObjectIdArray viewports) = 0;pickPt传递在世界坐标系下图纸空间的选择点。viewports返回指向要返回的AcDbViewport实体的Ids 的AcDbObjectIdArray的指针。这个函数传递在