ドキュメントにテキスト要素を作成するには、OdBmTextNoteクラスオブジェクトを作成し、それをデータベースに追加します。
テキストノートは、通常の要素インターフェースを使用してデータベースに作成および登録されます。テキスト固有のデータを定義するだけで済みます。これらは、テキスト要素を定義する主なプロパティです。
- テキストが追加されるビュー
- テキスト
- 位置
- 方向
- 幅
このデータは、以下のインターフェースで設定できます。
- setOwnerDBViewId(OdBmObjectId) — インターフェースはElementから継承され、テキスト要素が作成されるビューを定義します。要素をデータベースに追加した後、ビューIDを変更してはなりません。
- setRawText(OdString&) — 生のテキスト文字列からテキストを設定します。
- setRtfText(OdAnsiString&) — RTFテキスト文字列からテキストを設定します。
- setOrigin(OdGePoint3d) — テキストの原点を設定します。テキストの配置原点に応じて、テキストの左/中央/右の上/中央/下の点になります。たとえば、左水平配置と上垂直配置の場合、原点は左上の点です。
- setVertAlign(OdBm::VerticalAlignment::Enum) — 垂直方向の配置を設定します。
- setHorzAlign(OdBm::HorizontalAlignment::Enum) — 水平方向の配置を設定します。
- setDirection(OdGeVector3d) — テキストの水平方向を設定します。テキストの垂直方向は、ビューの方向を法線として使用し、水平方向の設定に基づいて自動的に計算されます。
- setWidth(double) — テキストの幅を設定します。この幅が1行のテキストの幅よりも小さい場合、テキストは折り返されます。
- setKeepReadable(bool) — 読み取り可能モードを維持するように設定します。オンの場合、テキストは常に左から右へ（またはY軸に平行な場合は下から上へ）描画されます。このフラグがオンになっているテキストが右から左、または上から下へ向かう方向を持っている場合、レンダリング時にテキストは180度回転されます。
- setType(OdBmObjectId) — テキスト注釈タイプIDを設定します。IDパラメーターはOdBmTextNoteAttributesオブジェクトを指している必要があります。そうでない場合、メソッドはeInvalidInputエラーを返します。
- setLeaderLeftAttachment(OdBm::LeaderAttachment::Enum) — 左の引出線アタッチメント位置を設定します。
- setLeaderRightAttachment(OdBm::LeaderAttachment::Enum) — 右の引出線アタッチメント位置を設定します。
既定値
テキスト以外のすべてのプロパティはオプションです。テキスト要素をデータベースに追加する前にそれらを設定しない場合、既定値が入力されます。
- ビューIDはアクティブなビューのIDに設定されます。
- 原点は(0, 0, 0)に設定されます。
- テキストの配置は左/上に設定されます。
- 方向はビューの右方向に設定されます。
- 幅は折り返しなしのテキストの幅に設定されます。
- 左の引出線アタッチメントは上線に設定されます。
- 右の引出線アタッチメントは下線に設定されます。
例
OdBmTextNotePtr pTextNote3 = OdBmTextNote::createObject();
zpTextNote3->setOrigin(OdGePoint3d::kOrigin);
pTextNote3->setVertAlign(OdBm::VerticalAlignment::Middle);
pTextNote3->setHorzAlign(OdBm::HorizontalAlignment::Center);
pTextNote3->setDirection(OdGeVector3d::kXAxis);
pTextNote3->setRawText(L"Text line 1\nLine2");
pTextNote3->setKeepReadable(true);
pDb->addElement(pTextNote3);
