7.4 文字注释

BIMBase API的文字包括单行文字和多行文字两种，可根据需要应用于不同的场景。

7.3.1 单行文字

使用类BPTextEntity可创建单行文字，常用接口见下表。

示例代码7-6展示了单行文字的创建，首先创建一个单行文字对象，通过接口设置文字内容、字体、字高等属性，然后将文字保存到指定model上。

BIMBase::Core::IBPProjectManagerP  pProjectManager = BPApplication::getInstance().getProjectManager();
if (pProjectManager == nullptr)
    return;
BPProjectP pProject = pProjectManager->getMainProject();
if (pProject == nullptr)
    return;
BPModelBaseP pModel = pProjectManager->getActiveModel();
if (pModel == nullptr)
    return;
BPTextStyle::constructDefaultTextStyle();
BPTextEntityPtr text = BPTextEntity::create();
if (text.isNull())
    return;
text->setContent(_T("测试文字Ex"));
text->setWidthFactor(1);
text->setStyle(L"微软雅黑");
text->setPos(GePoint3d::create(0, 0, 0));
text->setHeight(3000);
text->setStyle(L"sans-serif");
text->setUseFixedHeight(false);
text->addToProject(*pProject, pModel->getModelId());

单行文字范例效果如图所示：

图7-5 单行文字范例范例效果图

7.3.2 多行文字

使用类BPMTextEntity可创建多行文字或段落，多行文字较单行文字复杂，其关联类包括多行文字属性（MTextRunPropertiesAppender）， 多行文字段落属性（MTextParagraphPropertiesAppender），多行文字内容（MTextTextLineAppender）等，主要接口见下表。

多行文字的创建步骤较多，需要设置段落属性，文字属性；附加文字内容、换行符、分段符等，可参考示例代码7-7进行创建。

BIMBase::Core::IBPProjectManagerP pProjectManager = BIMBase::Core::BPApplication::getInstance().getProjectManager();
if (pProjectManager == nullptr)
    return;
BPProjectP pProject = pProjectManager->getMainProject();
if (pProject == nullptr)
    return;
BPModelBaseP pModel = pProjectManager->getActiveModel();
if (pModel == nullptr)
    return;
//创建多行文字
BPMTextEntityPtr ptrMtext = new BPMTextEntity();;
BPFont font1 = BIMBase::Core::BPFontUtil::getDefaultTrueTypeFont();
//多行文字之间的段落设置
MTextParagraphPropertiesAppenderPtr appender = new MTextParagraphPropertiesAppender;
appender->isFullJustified = false;
appender->mtext_FirstLineIndent = 0;
appender->mtext_HangingIndent = 0;
appender->lineSpacingValue = 400;
ptrMtext->appendTextPart(appender);
//多行文字属性设置
MTextRunPropertiesAppenderPtr runAppender = new MTextRunPropertiesAppender;
runAppender->isItalic = false;
runAppender->isOverlined = false;
runAppender->font = font1;
runAppender->overrideFontSize = true;
runAppender->fontSize = GePoint2d::create(400, 600);
ptrMtext->appendTextPart(runAppender);
//多行文字内容设置
MTextTextLineAppenderPtr textAppender1 = new MTextTextLineAppender;
textAppender1->mtextLine = _T("测试多行文字行1");
ptrMtext->appendTextPart(textAppender1);

MTextLineBreakAppenderPtr ptrLineBreak = new MTextLineBreakAppender();
ptrMtext->appendTextPart(ptrLineBreak);

MTextTextLineAppenderPtr textAppender2 = new MTextTextLineAppender;
textAppender2->mtextLine = _T("测试多行文字行2");
ptrMtext->appendTextPart(textAppender2);
ptrMtext->addToProject(*pProject, pModel->getModelId());