CFx SDK Documentation  2022 SP0
Public Types | Public Member Functions | Static Public Member Functions | List of all members
OdDbMText Class Reference

#include <DbMText.h>

Inheritance diagram for OdDbMText:
OdDbEntity OdDbObject OdGiDrawable OdRxObject

Public Types

enum  AttachmentPoint {
  kTopLeft = 1 , kTopCenter = 2 , kTopRight = 3 , kMiddleLeft = 4 ,
  kMiddleCenter = 5 , kMiddleRight = 6 , kBottomLeft = 7 , kBottomCenter = 8 ,
  kBottomRight = 9 , kBaseLeft = 10 , kBaseCenter = 11 , kBaseRight = 12 ,
  kBaseAlign = 13 , kBottomAlign = 14 , kMiddleAlign = 15 , kTopAlign = 16 ,
  kBaseFit = 17 , kBottomFit = 18 , kMiddleFit = 19 , kTopFit = 20 ,
  kBaseMid = 21 , kBottomMid = 22 , kMiddleMid = 23 , kTopMid = 24
}
 
enum  FlowDirection {
  kLtoR = 1 , kRtoL = 2 , kTtoB = 3 , kBtoT = 4 ,
  kByStyle = 5
}
 
enum  ColumnType { kNoColumns , kStaticColumns , kDynamicColumns }
 
- Public Types inherited from OdDbEntity
enum  VisualStyleType { kFullVisualStyle , kFaceVisualStyle , kEdgeVisualStyle }
 
- Public Types inherited from OdGiDrawable
enum  SetAttributesFlags {
  kDrawableNone = 0 , kDrawableIsAnEntity = 1 , kDrawableUsesNesting = 2 , kDrawableIsCompoundObject = 4 ,
  kDrawableViewIndependentViewportDraw = 8 , kDrawableIsInvisible = 16 , kDrawableHasAttributes = 32 , kDrawableRegenTypeDependantGeometry = 64 ,
  kDrawableIsDimension = (kDrawableIsAnEntity + kDrawableIsCompoundObject + 128) , kDrawableRegenDraw = 256 , kDrawableStandardDisplaySingleLOD = 512 , kDrawableShadedDisplaySingleLOD = 1024 ,
  kDrawableViewDependentViewportDraw = 2048 , kDrawableBlockDependentViewportDraw = 4096 , kDrawableIsExternalReference = 8192 , kDrawableNotPlottable = 16384 ,
  kLastFlag = kDrawableNotPlottable
}
 
enum  DrawableType {
  kGeometry = 0 , kDistantLight = 1 , kPointLight = 2 , kSpotLight = 3 ,
  kAmbientLight , kSolidBackground , kGradientBackground , kImageBackground ,
  kGroundPlaneBackground , kViewport , kWebLight , kSkyBackground ,
  kImageBasedLightingBackground
}
 

Public Member Functions

 ODDB_DECLARE_MEMBERS (OdDbMText)
 
 OdDbMText ()
 
OdGePoint3d location () const
 
void setLocation (const OdGePoint3d &location)
 
OdGeVector3d normal () const
 
void setNormal (const OdGeVector3d &normal)
 
OdGeVector3d direction () const
 
void setDirection (const OdGeVector3d &direction)
 
double rotation () const
 
void setRotation (double rotation)
 
double width () const
 
void setWidth (double width)
 
OdDbObjectId textStyle () const
 
void setTextStyle (OdDbObjectId textStyleId)
 
double textHeight () const
 
void setTextHeight (double height)
 
AttachmentPoint attachment () const
 
void setAttachment (AttachmentPoint type)
 
FlowDirection flowDirection () const
 
void setFlowDirection (FlowDirection flowDirection)
 
OdString contents () const
 
int setContents (const OdString &text)
 
int setContentsRTF (const OdString &text)
 
double actualWidth () const
 
void setLineSpacingStyle (OdDb::LineSpacingStyle lineSpacingStyle)
 
OdDb::LineSpacingStyle lineSpacingStyle () const
 
void setLineSpacingFactor (double lineSpacingFactor)
 
double lineSpacingFactor () const
 
OdDb::TextHorzMode horizontalMode () const
 
void setHorizontalMode (OdDb::TextHorzMode horizontalMode)
 
OdDb::TextVertMode verticalMode () const
 
void setVerticalMode (OdDb::TextVertMode verticalMode)
 
OdGeMatrix3d getEcs () const
 
virtual OdResult dwgInFields (OdDbDwgFiler *pFiler)
 
virtual void dwgOutFields (OdDbDwgFiler *pFiler) const
 
virtual OdResult dxfInFields (OdDbDxfFiler *pFiler)
 
virtual void dxfOutFields (OdDbDxfFiler *pFiler) const
 
bool subWorldDraw (OdGiWorldDraw *pWd) const
 
void subViewportDraw (OdGiViewportDraw *pVd) const
 
virtual OdResult subTransformBy (const OdGeMatrix3d &xfm)
 
virtual OdResult subExplode (OdRxObjectPtrArray &entitySet) const
 
virtual OdResult explodeGeometry (OdRxObjectPtrArray &entitySet) const
 
OdResult subGetClassID (void *pClsid) const
 
void subClose ()
 
void explodeFragments (OdDbMTextEnum fragmentFn, void *params, OdGiWorldDraw *ctxt=0) const
 
double actualHeight (OdGiWorldDraw *ctxt=0) const
 
void getActualBoundingPoints (OdGePoint3dArray &boundingPoints, double dGapX=0., double dGapY=0.) const
 
void getBoundingPoints (OdGePoint3dArray &boundingPoints) const
 
OdResult setAttachmentMovingLocation (AttachmentPoint attachment)
 
virtual OdResult subGetGeomExtents (OdGeExtents3d &extents) const
 
bool backgroundFillOn () const
 
void setBackgroundFill (bool bEnable)
 
OdCmColor getBackgroundFillColor () const
 
void setBackgroundFillColor (const OdCmColor &color)
 
double getBackgroundScaleFactor () const
 
void setBackgroundScaleFactor (const double scaleFactor)
 
OdCmTransparency getBackgroundTransparency () const
 
void setBackgroundTransparency (const OdCmTransparency &transparency)
 
bool useBackgroundColorOn () const
 
void setUseBackgroundColor (bool enable)
 
void getParagraphsIndent (OdDbMTextIndents &indents) const
 
OdDbObjectId setField (const OdString &fieldName, OdDbField *pField)
 
OdResult removeField (OdDbObjectId fieldId)
 
OdDbObjectId removeField (const OdString &fieldName)
 
void convertFieldToText ()
 
void subSetDatabaseDefaults (OdDbDatabase *pDb, bool doSubents)
 
void setDynamicColumns (double width, double gutter, bool bAutoHeigh)
 
void setStaticColumns (double width, double gutter, OdInt16 count)
 
ColumnType getColumnType () const
 
void setColumnType (ColumnType colType)
 
bool getColumnAutoHeight () const
 
void setColumnAutoHeight (bool bAutoHeigh)
 
OdInt32 getColumnCount () const
 
void setColumnCount (OdInt32 numCol)
 
double getColumnWidth () const
 
void setColumnWidth (double colWidth)
 
double getColumnGutterWidth () const
 
void setColumnGutterWidth (double colGutter)
 
bool getColumnFlowReversed () const
 
void setColumnFlowReversed (bool bFlowRev)
 
double getColumnHeight (OdInt16 col) const
 
void setColumnHeight (OdInt16 col, double colHeight)
 
double height () const
 
void setHeight (double value)
 
virtual OdResult getPlane (OdGePlane &plane, OdDb::Planarity &planarity) const
 
virtual OdResult subGetTransformedCopy (const OdGeMatrix3d &mat, OdDbEntityPtr &pCopy) const
 
double ascent () const
 
double descent () const
 
void setShowBorders (bool bEnable)
 
bool showBorders ()
 
OdString text ()
 
- Public Member Functions inherited from OdDbEntity
 ODDB_DECLARE_MEMBERS (OdDbEntity)
 
 OdDbEntity ()
 
OdDbObjectId blockId () const
 
OdCmColor color () const
 
virtual OdResult setColor (const OdCmColor &color, bool doSubents=true)
 
OdUInt16 colorIndex () const
 
virtual OdCmEntityColor entityColor () const
 
virtual OdResult setColorIndex (OdUInt16 colorIndex, bool doSubents=true)
 
OdDbObjectId colorId () const
 
virtual OdResult setColorId (OdDbObjectId colorId, bool doSubents=true)
 
OdCmTransparency transparency () const
 
virtual OdResult setTransparency (const OdCmTransparency &transparency, bool doSubents=true)
 
OdString plotStyleName () const
 
OdDb::PlotStyleNameType getPlotStyleNameId (OdDbObjectId &plotStyleNameId) const
 
virtual OdResult setPlotStyleName (const OdString &plotStyleName, bool doSubents=true)
 
virtual OdResult setPlotStyleName (OdDb::PlotStyleNameType plotStyleNameType, OdDbObjectId plotStyleNameId=OdDbObjectId::kNull, bool doSubents=true)
 
OdString layer () const
 
OdDbObjectId layerId () const
 
virtual OdResult setLayer (const OdString &layerName, bool doSubents=true, bool allowHiddenLayer=false)
 
virtual OdResult setLayer (OdDbObjectId layerId, bool doSubents=true, bool allowHiddenLayer=false)
 
OdString linetype () const
 
OdDbObjectId linetypeId () const
 
virtual OdResult setLinetype (const OdString &linetypeName, bool doSubents=true)
 
virtual OdResult setLinetype (OdDbObjectId linetypeID, bool doSubents=true)
 
OdString material () const
 
OdDbObjectId materialId () const
 
virtual OdResult setMaterial (const OdString &materialName, bool doSubents=true)
 
virtual OdResult setMaterial (OdDbObjectId materialID, bool doSubents=true)
 
OdDbObjectId visualStyleId (VisualStyleType vstype=kFullVisualStyle) const
 
virtual OdResult setVisualStyle (OdDbObjectId visualStyleId, VisualStyleType vstype=kFullVisualStyle, bool doSubents=true)
 
virtual const OdGiMappermaterialMapper () const
 
virtual void setMaterialMapper (const OdGiMapper *mapper, bool doSubents=true)
 
double linetypeScale () const
 
virtual OdResult setLinetypeScale (double linetypeScale, bool doSubents=true)
 
OdDb::Visibility visibility () const
 
ODRX_SEALED_VIRTUAL OdResult setVisibility (OdDb::Visibility visibility, bool doSubents=true) ODRX_SEALED
 
OdDb::Visibility tempVisibility () const
 
void setTempVisibility (OdDb::Visibility visibility)
 
OdDb::LineWeight lineWeight () const
 
virtual OdResult setLineWeight (OdDb::LineWeight lineWeight, bool doSubents=true)
 
virtual bool castShadows () const
 
virtual void setCastShadows (bool castShadows)
 
virtual bool receiveShadows () const
 
virtual void setReceiveShadows (bool receiveShadows)
 
virtual OdDb::CollisionType collisionType () const
 
void setPropertiesFrom (const OdDbEntity *pSource, bool doSubents=true)
 
virtual bool isPlanar () const
 
void subHandOverTo (OdDbObject *pNewObject)
 
ODRX_SEALED_VIRTUAL OdResult transformBy (const OdGeMatrix3d &xfm) ODRX_SEALED
 
ODRX_SEALED_VIRTUAL OdResult getTransformedCopy (const OdGeMatrix3d &xfm, OdDbEntityPtr &pCopy) const ODRX_SEALED
 
ODRX_SEALED_VIRTUAL OdResult explode (OdRxObjectPtrArray &entitySet) const ODRX_SEALED
 
virtual OdResult explodeToBlock (OdDbBlockTableRecord *pBlockRecord, OdDbObjectIdArray *ids=0)
 
virtual OdResult explodeGeometryToBlock (OdDbBlockTableRecord *pBlockRecord, OdDbObjectIdArray *ids=0)
 
void setDatabaseDefaults (OdDbDatabase *pDb=0, bool doSubents=false)
 
virtual void applyPartialUndo (OdDbDwgFiler *pUndoFiler, OdRxClass *pClassObj)
 
void appendToOwner (OdDbIdPair &idPair, OdDbObject *pOwnerObject, OdDbIdMapping &ownerIdMap)
 
virtual OdResult dxfIn (OdDbDxfFiler *pFiler)
 
virtual void dxfOut (OdDbDxfFiler *pFiler) const
 
virtual OdResult dxfInFields_R12 (OdDbDxfFiler *pFiler)
 
virtual void dxfOutFields_R12 (OdDbDxfFiler *pFiler) const
 
virtual OdGiDrawabledrawable ()
 
virtual OdUInt32 subSetAttributes (OdGiDrawableTraits *pTraits) const
 
virtual void subList () const
 
void subSwapIdWith (const OdDbObjectId &otherId, bool swapXdata=false, bool swapExtDict=false)
 
virtual OdResult subErase (bool erasing) ODRX_OVERRIDE
 
void recordGraphicsModified (bool graphicsModified=true)
 
virtual void copyFrom (const OdRxObject *pSource)
 
ODRX_SEALED_VIRTUAL void list () const ODRX_SEALED
 
virtual OdResult getGeomExtents (OdGeExtents3d &extents) const ODRX_SEALED
 
ODRX_SEALED_VIRTUAL void highlight (bool bDoIt=true, const OdDbFullSubentPath *pSubId=0, bool highlightAll=false) const ODRX_SEALED
 
ODRX_SEALED_VIRTUAL OdResult getOsnapPoints (OdDb::OsnapMode osnapMode, OdGsMarker gsSelectionMark, const OdGePoint3d &pickPoint, const OdGePoint3d &lastPoint, const OdGeMatrix3d &xWorldToEye, OdGePoint3dArray &snapPoints) const ODRX_SEALED
 
ODRX_SEALED_VIRTUAL OdResult getOsnapPoints (OdDb::OsnapMode osnapMode, OdGsMarker gsSelectionMark, const OdGePoint3d &pickPoint, const OdGePoint3d &lastPoint, const OdGeMatrix3d &xWorldToEye, OdGePoint3dArray &snapPoints, const OdGeMatrix3d &insertionMat) const ODRX_SEALED
 
ODRX_SEALED_VIRTUAL bool isContentSnappable () const ODRX_SEALED
 
ODRX_SEALED_VIRTUAL OdResult getGripPoints (OdGePoint3dArray &gripPoints) const ODRX_SEALED
 
ODRX_SEALED_VIRTUAL OdResult moveGripPointsAt (const OdIntArray &indices, const OdGeVector3d &offset) ODRX_SEALED
 
ODRX_SEALED_VIRTUAL OdResult getGripPoints (OdDbGripDataPtrArray &grips, const double curViewUnitSize, const int gripSize, const OdGeVector3d &curViewDir, const int bitFlags) const ODRX_SEALED
 
ODRX_SEALED_VIRTUAL OdResult moveGripPointsAt (const OdDbVoidPtrArray &grips, const OdGeVector3d &offset, int bitFlags) ODRX_SEALED
 
ODRX_SEALED_VIRTUAL OdResult getStretchPoints (OdGePoint3dArray &stretchPoints) const ODRX_SEALED
 
ODRX_SEALED_VIRTUAL OdResult moveStretchPointsAt (const OdIntArray &indices, const OdGeVector3d &offset) ODRX_SEALED
 
virtual void dragStatus (const OdDb::DragStat status)
 
ODRX_SEALED_VIRTUAL void gripStatus (const OdDb::GripStat status) ODRX_SEALED
 
ODRX_SEALED_VIRTUAL bool cloneMeForDragging () ODRX_SEALED
 
ODRX_SEALED_VIRTUAL bool hideMeForDragging () const ODRX_SEALED
 
virtual void saveAs (OdGiWorldDraw *pWd, OdDb::DwgVersion ver) const
 
ODRX_SEALED_VIRTUAL OdResult getCompoundObjectTransform (OdGeMatrix3d &xM) const ODRX_SEALED
 
ODRX_SEALED_VIRTUAL OdResult intersectWith (const OdDbEntity *pEnt, OdDb::Intersect intType, OdGePoint3dArray &points, OdGsMarker thisGsMarker=0, OdGsMarker otherGsMarker=0) const ODRX_SEALED
 
ODRX_SEALED_VIRTUAL OdResult intersectWith (const OdDbEntity *pEnt, OdDb::Intersect intType, const OdGePlane &projPlane, OdGePoint3dArray &points, OdGsMarker thisGsMarker=0, OdGsMarker otherGsMarker=0) const ODRX_SEALED
 
OdResult boundingBoxIntersectWith (const OdDbEntity *pEnt, OdDb::Intersect intType, OdGePoint3dArray &points, OdGsMarker thisGsMarker, OdGsMarker otherGsMarker) const
 
OdResult boundingBoxIntersectWith (const OdDbEntity *pEnt, OdDb::Intersect intType, const OdGePlane &projPlane, OdGePoint3dArray &points, OdGsMarker thisGsMarker, OdGsMarker otherGsMarker) const
 
ODRX_SEALED_VIRTUAL OdResult getSubentPathsAtGsMarker (OdDb::SubentType type, OdGsMarker gsMark, const OdGePoint3d &pickPoint, const OdGeMatrix3d &xfm, OdDbFullSubentPathArray &subentPaths, const OdDbObjectIdArray *pEntAndInsertStack=0) const ODRX_SEALED
 
ODRX_SEALED_VIRTUAL OdResult getGsMarkersAtSubentPath (const OdDbFullSubentPath &subPath, OdGsMarkerArray &gsMarkers) const ODRX_SEALED
 
ODRX_SEALED_VIRTUAL OdResult getGripPointsAtSubentPath (const OdDbFullSubentPath &path, OdDbGripDataPtrArray &grips, const double curViewUnitSize, const int gripSize, const OdGeVector3d &curViewDir, const OdUInt32 bitflags) const ODRX_SEALED
 
ODRX_SEALED_VIRTUAL OdResult moveGripPointsAtSubentPaths (const OdDbFullSubentPathArray &paths, const OdDbVoidPtrArray &gripAppData, const OdGeVector3d &offset, const OdUInt32 bitflags) ODRX_SEALED
 
ODRX_SEALED_VIRTUAL OdResult deleteSubentPaths (const OdDbFullSubentPathArray &paths) ODRX_SEALED
 
ODRX_SEALED_VIRTUAL OdResult addSubentPaths (const OdDbFullSubentPathArray &paths) ODRX_SEALED
 
ODRX_SEALED_VIRTUAL OdDbEntityPtr subentPtr (const OdDbFullSubentPath &path) const ODRX_SEALED
 
ODRX_SEALED_VIRTUAL OdResult transformSubentPathsBy (const OdDbFullSubentPathArray &paths, const OdGeMatrix3d &xform) ODRX_SEALED
 
ODRX_SEALED_VIRTUAL OdResult getSubentClassId (const OdDbFullSubentPath &path, void *clsId) ODRX_SEALED
 
ODRX_SEALED_VIRTUAL OdResult getSubentPathGeomExtents (const OdDbFullSubentPath &path, OdGeExtents3d &extents) ODRX_SEALED
 
ODRX_SEALED_VIRTUAL void subentGripStatus (OdDb::GripStat status, const OdDbFullSubentPath &subentity) ODRX_SEALED
 
- Public Member Functions inherited from OdDbObject
 ODDB_DECLARE_MEMBERS (OdDbObject)
 
 ~OdDbObject ()
 
void addRef ()
 
void release ()
 
long numRefs () const
 
OdDbObjectId objectId () const
 
OdDbHandle getDbHandle () const
 
OdDbHandle handle () const
 
OdDbObjectId ownerId () const
 
virtual void setOwnerId (OdDbObjectId ownerId)
 
OdDbDatabasedatabase () const
 
void createExtensionDictionary ()
 
OdDbObjectId extensionDictionary () const
 
bool releaseExtensionDictionary ()
 
OdDbXrecordPtr createXrecord (const OdString &xrecordName, OdDb::DuplicateRecordCloning style=OdDb::kDrcIgnore)
 
void upgradeOpen ()
 
void downgradeOpen ()
 
void cancel ()
 
virtual OdResult subOpen (OdDb::OpenMode mode)
 
OdResult erase (bool eraseIt=true)
 
void handOverTo (OdDbObject *pNewObject, bool keepXData=true, bool keepExtDict=true)
 
void swapIdWith (OdDbObjectId otherId, bool swapXdata=false, bool swapExtDict=false)
 
virtual void audit (OdDbAuditInfo *pAuditInfo)
 
void dwgIn (OdDbDwgFiler *pFiler)
 
void dwgOut (OdDbDwgFiler *pFiler) const
 
virtual OdDb::DuplicateRecordCloning mergeStyle () const
 
virtual OdResBufPtr xData (const OdString &regappName=OdString::kEmpty) const
 
virtual void setXData (const OdResBuf *pRb)
 
bool isEraseStatusToggled () const
 
bool isErased () const
 
bool isReadEnabled () const
 
bool isWriteEnabled () const
 
bool isNotifyEnabled () const
 
bool isModified () const
 
bool isModifiedXData () const
 
bool isModifiedGraphics () const
 
bool isNewObject () const
 
bool isNotifying () const
 
bool isUndoing () const
 
bool isReallyClosing () const
 
bool isDBRO () const
 
void assertReadEnabled () const
 
void assertWriteEnabled (bool autoUndo=true, bool recordModified=true)
 
void assertNotifyEnabled () const
 
void disableUndoRecording (bool disable)
 
bool isUndoRecordingDisabled () const
 
OdDbDwgFilerundoFiler ()
 
void addReactor (OdDbObjectReactor *pReactor) const
 
void removeReactor (OdDbObjectReactor *pReactor) const
 
virtual void addPersistentReactor (const OdDbObjectId &objId)
 
virtual void removePersistentReactor (const OdDbObjectId &objId)
 
bool hasPersistentReactor (const OdDbObjectId &objId) const
 
OdDbObjectIdArray getPersistentReactors () const
 
OdDbObjectReactorArray getTransientReactors () const
 
virtual void recvPropagateModify (const OdDbObject *pSubObj)
 
virtual void xmitPropagateModify () const
 
ODRX_SEALED_VIRTUAL OdDbObjectPtr deepClone (OdDbIdMapping &ownerIdMap, OdDbObject *pOwner, bool bPrimary=true) const ODRX_SEALED
 
ODRX_SEALED_VIRTUAL OdDbObjectPtr wblockClone (OdDbIdMapping &ownerIdMap, OdDbObject *pOwner, bool bPrimary=true) const ODRX_SEALED
 
void setOdDbObjectIdsInFlux ()
 
bool isOdDbObjectIdsInFlux () const
 
virtual void copied (const OdDbObject *pObject, const OdDbObject *pNewObject)
 
virtual void erased (const OdDbObject *pObject, bool erasing=true)
 
virtual void goodbye (const OdDbObject *pObject)
 
virtual void openedForModify (const OdDbObject *pObject)
 
virtual void modified (const OdDbObject *pObject)
 
virtual void subObjModified (const OdDbObject *pObject, const OdDbObject *pSubObj)
 
virtual void modifyUndone (const OdDbObject *pObject)
 
virtual void modifiedXData (const OdDbObject *pObject)
 
virtual void unappended (const OdDbObject *pObject)
 
virtual void reappended (const OdDbObject *pObject)
 
bool isAProxy () const
 
virtual void objectClosed (const OdDbObjectId &objectId)
 
virtual void modifiedGraphics (const OdDbObject *pObject)
 
bool hasSaveVersionOverride () const
 
void setHasSaveVersionOverride (bool hasSaveVersionOverride)
 
virtual OdDb::DwgVersion getObjectSaveVersion (const OdDbFiler *pFiler, OdDb::MaintReleaseVer *pMaintVer=0) const
 
virtual OdDbObjectPtr decomposeForSave (OdDb::DwgVersion ver, OdDbObjectId &replaceId, bool &exchangeXData)
 
virtual OdDbObjectPtr decomposeForSave (OdDb::SaveType format, OdDb::DwgVersion ver, OdDbObjectId &replaceId, bool &exchangeXData)
 
void convertForSave (OdDb::DwgVersion ver)
 
virtual void composeForLoad (OdDb::SaveType format, OdDb::DwgVersion version, OdDbAuditInfo *pAuditInfo)
 
virtual bool isPersistent () const
 
virtual OdDbStub * id () const
 
ODRX_SEALED_VIRTUAL OdResult getClassID (void *pClsid) const ODRX_SEALED
 
void setGsNode (OdGsCache *pNode)
 
OdGsCachegsNode () const
 
void xDataTransformBy (const OdGeMatrix3d &xfm)
 
bool hasFields () const
 
OdDbObjectId getField (const OdString &fieldName) const
 
OdDbObjectPtr getField (const OdString &fieldName, OdDb::OpenMode mode) const
 
OdDbObjectId getFieldDictionary () const
 
OdDbObjectPtr getFieldDictionary (OdDb::OpenMode mode) const
 
virtual OdRxClasssaveAsClass (OdRxClass *pClass) const
 
- Public Member Functions inherited from OdGiDrawable
 ODRX_DECLARE_MEMBERS (OdGiDrawable)
 
virtual DrawableType drawableType () const
 
ODRX_SEALED_VIRTUAL OdUInt32 setAttributes (OdGiDrawableTraits *pTraits) const ODRX_SEALED
 
ODRX_SEALED_VIRTUAL bool worldDraw (OdGiWorldDraw *pWd) const ODRX_SEALED
 
ODRX_SEALED_VIRTUAL void viewportDraw (OdGiViewportDraw *pVd) const ODRX_SEALED
 
ODRX_SEALED_VIRTUAL OdUInt32 viewportDrawLogicalFlags (OdGiViewportDraw *pVd) const ODRX_SEALED
 
ODRX_SEALED_VIRTUAL OdUInt32 regenSupportFlags () const ODRX_SEALED
 
- Public Member Functions inherited from OdRxObject
 ODRX_HEAP_OPERATORS ()
 
 OdRxObject ()
 
virtual ~OdRxObject ()
 
virtual OdRxObjectqueryX (const OdRxClass *pClass) const
 
virtual OdRxObjectx (const OdRxClass *pClass) const
 
virtual OdRxClassisA () const
 
bool isKindOf (const OdRxClass *pClass) const
 
virtual OdRxObjectPtr clone () const
 
virtual OdRx::Ordering comparedTo (const OdRxObject *pOther) const
 
virtual bool isEqualTo (const OdRxObject *pOther) const
 

Static Public Member Functions

static const OdString nonBreakSpace ()
 
static const OdString overlineOn ()
 
static const OdString overlineOff ()
 
static const OdString underlineOn ()
 
static const OdString underlineOff ()
 
static const OdString colorChange ()
 
static const OdString fontChange ()
 
static const OdString heightChange ()
 
static const OdString widthChange ()
 
static const OdString obliqueChange ()
 
static const OdString trackChange ()
 
static const OdString lineBreak ()
 
static const OdString paragraphBreak ()
 
static const OdString stackStart ()
 
static const OdString alignChange ()
 
static const OdString blockBegin ()
 
static const OdString blockEnd ()
 
static const OdString strikethroughOn ()
 
static const OdString strikethroughOff ()
 
- Static Public Member Functions inherited from OdRxObject
static OdRxObjectPtr cast (const OdRxObject *pointer)
 
static OdRxClassdesc ()
 

Additional Inherited Members

- Protected Member Functions inherited from OdDbEntity
virtual OdDbObjectPtr subWblockClone (OdDbIdMapping &ownerIdMap, OdDbObject *, bool bPrimary) const ODRX_OVERRIDE
 
virtual OdDbObjectPtr subDeepClone (OdDbIdMapping &ownerIdMap, OdDbObject *, bool bPrimary) const ODRX_OVERRIDE
 
virtual OdResult subGetCompoundObjectTransform (OdGeMatrix3d &xM) const
 
virtual bool subCloneMeForDragging ()
 
virtual bool subHideMeForDragging () const
 
virtual void subGripStatus (const OdDb::GripStat status)
 
virtual OdResult subGetOsnapPoints (OdDb::OsnapMode osnapMode, OdGsMarker gsSelectionMark, const OdGePoint3d &pickPoint, const OdGePoint3d &lastPoint, const OdGeMatrix3d &xWorldToEye, OdGePoint3dArray &snapPoints) const
 
virtual OdResult subGetOsnapPoints (OdDb::OsnapMode osnapMode, OdGsMarker gsSelectionMark, const OdGePoint3d &pickPoint, const OdGePoint3d &lastPoint, const OdGeMatrix3d &xWorldToEye, OdGePoint3dArray &snapPoints, const OdGeMatrix3d &insertionMat) const
 
virtual bool subIsContentSnappable () const
 
virtual OdResult subGetGripPoints (OdGePoint3dArray &gripPoints) const
 
virtual OdResult subMoveGripPointsAt (const OdIntArray &indices, const OdGeVector3d &offset)
 
virtual OdResult subGetGripPoints (OdDbGripDataPtrArray &grips, const double curViewUnitSize, const int gripSize, const OdGeVector3d &curViewDir, const int bitFlags) const
 
virtual OdResult subMoveGripPointsAt (const OdDbVoidPtrArray &grips, const OdGeVector3d &offset, int bitFlags)
 
virtual OdResult subGetStretchPoints (OdGePoint3dArray &stretchPoints) const
 
virtual OdResult subMoveStretchPointsAt (const OdIntArray &indices, const OdGeVector3d &offset)
 
virtual OdResult subIntersectWith (const OdDbEntity *pEnt, OdDb::Intersect intType, OdGePoint3dArray &points, OdGsMarker thisGsMarker=0, OdGsMarker otherGsMarker=0) const
 
virtual OdResult subIntersectWith (const OdDbEntity *pEnt, OdDb::Intersect intType, const OdGePlane &projPlane, OdGePoint3dArray &points, OdGsMarker thisGsMarker=0, OdGsMarker otherGsMarker=0) const
 
virtual void subHighlight (bool bDoIt=true, const OdDbFullSubentPath *pSubId=0, bool highlightAll=false) const
 
virtual OdDb::Visibility subVisibility () const
 
virtual OdResult subSetVisibility (OdDb::Visibility visibility, bool doSubents=true)
 
virtual OdResult subDeleteSubentPaths (const OdDbFullSubentPathArray &paths)
 
virtual OdResult subAddSubentPaths (const OdDbFullSubentPathArray &paths)
 
virtual OdResult subMoveGripPointsAtSubentPaths (const OdDbFullSubentPathArray &paths, const OdDbVoidPtrArray &gripAppData, const OdGeVector3d &offset, const OdUInt32 bitflags)
 
virtual OdResult subGetGripPointsAtSubentPath (const OdDbFullSubentPath &path, OdDbGripDataPtrArray &grips, const double curViewUnitSize, const int gripSize, const OdGeVector3d &curViewDir, const OdUInt32 bitflags) const
 
virtual OdResult subGetSubentPathsAtGsMarker (OdDb::SubentType type, OdGsMarker gsMark, const OdGePoint3d &pickPoint, const OdGeMatrix3d &xfm, OdDbFullSubentPathArray &subentPaths, const OdDbObjectIdArray *pEntAndInsertStack=0) const
 
virtual OdResult subGetGsMarkersAtSubentPath (const OdDbFullSubentPath &subPath, OdGsMarkerArray &gsMarkers) const
 
virtual OdDbEntityPtr subSubentPtr (const OdDbFullSubentPath &path) const
 
virtual OdResult subTransformSubentPathsBy (const OdDbFullSubentPathArray &paths, const OdGeMatrix3d &xform)
 
virtual OdResult subGetSubentClassId (const OdDbFullSubentPath &path, void *clsId) const
 
virtual OdResult subGetSubentPathGeomExtents (const OdDbFullSubentPath &path, OdGeExtents3d &extents) const
 
virtual void subSubentGripStatus (OdDb::GripStat status, const OdDbFullSubentPath &subentity)
 
- Protected Member Functions inherited from OdDbObject
 OdDbObject ()
 
- Protected Member Functions inherited from OdGiDrawable
 OdGiDrawable ()
 
virtual OdUInt32 subViewportDrawLogicalFlags (OdGiViewportDraw *vd) const
 
virtual OdUInt32 subRegenSupportFlags () const
 
- Protected Attributes inherited from OdDbObject
OdDbObjectImplm_pImpl
 

Detailed Description

<group OdDb_Classes>

This class represents paragraph (multi-line) text (MText) entities in an OdDbDatabase instance.

Corresponding C++ library: TD_Db

See also
<link db_text_multi.html, Working with Multi-Line Text>

OdDbText, OdDbMline classes

Definition at line 136 of file DbMText.h.

Member Enumeration Documentation

◆ AttachmentPoint

Enumerator
kTopLeft 
kTopCenter 
kTopRight 
kMiddleLeft 
kMiddleCenter 
kMiddleRight 
kBottomLeft 
kBottomCenter 
kBottomRight 
kBaseLeft 
kBaseCenter 
kBaseRight 
kBaseAlign 
kBottomAlign 
kMiddleAlign 
kTopAlign 
kBaseFit 
kBottomFit 
kMiddleFit 
kTopFit 
kBaseMid 
kBottomMid 
kMiddleMid 
kTopMid 

Definition at line 246 of file DbMText.h.

◆ ColumnType

Enumerator
kNoColumns 
kStaticColumns 
kDynamicColumns 

Definition at line 931 of file DbMText.h.

◆ FlowDirection

Enumerator
kLtoR 
kRtoL 
kTtoB 
kBtoT 
kByStyle 

Definition at line 331 of file DbMText.h.

Constructor & Destructor Documentation

◆ OdDbMText()

OdDbMText::OdDbMText ( )

Member Function Documentation

◆ actualHeight()

double OdDbMText::actualHeight ( OdGiWorldDraw ctxt = 0) const

Returns the actual height of this MText entity (depends on contents).

Parameters
ctxt[in] Drawing context.
Remarks
If ctxt is null, the current OdGiWorldDraw object will be used.

◆ actualWidth()

double OdDbMText::actualWidth ( ) const

Returns the width of the bounding box of this MText entity.

Remarks
This value will probably be different than that returned by OdDbMText::width().

◆ alignChange()

static const OdString OdDbMText::alignChange ( )
static

Returns the alignment change string "\A".

Remarks
May be used in place of "\A" to make code more understandable.

◆ ascent()

double OdDbMText::ascent ( ) const

Returns the ascent of this MText entity.

◆ attachment()

AttachmentPoint OdDbMText::attachment ( ) const

Returns the type of the attachment point of this MText entity (DXF 71).

Remarks
attachment() returns one of the following:

Value kTopLeft 1 kTopCenter 2 kTopRight 3 kMiddleLeft 4 kMiddleCenter 5 kMiddleRight 6 kBottomLeft 7 kBottomCenter 8 kBottomRight 9

◆ backgroundFillOn()

bool OdDbMText::backgroundFillOn ( ) const

Returns true if and only if background fill is on of this MText entity (DXF 90, bit 0x01).

◆ blockBegin()

static const OdString OdDbMText::blockBegin ( )
static

Returns the begin block string "{".

Remarks
May be used in place of "{" to make code more understandable.

◆ blockEnd()

static const OdString OdDbMText::blockEnd ( )
static

Returns the end block string "}".

Remarks
May be used in place of "}" to make code more understandable.

◆ colorChange()

static const OdString OdDbMText::colorChange ( )
static

Returns the color change string "\C".

Remarks
May be used in place of "\C" to make code more understandable.

◆ contents()

OdString OdDbMText::contents ( ) const

Returns a copy of the character content of this MText entity (DXF 1 & 3).

◆ convertFieldToText()

void OdDbMText::convertFieldToText ( )

Converts the fields in this MText entity to text, and removes the fields.

Returns
Returns eOk if successful, or an appropriate error code if not.
Remarks
The fields are not evaluated before conversion.

◆ descent()

double OdDbMText::descent ( ) const

Returns the descent of this MText entity.

◆ direction()

OdGeVector3d OdDbMText::direction ( ) const

Returns the WCS X-axis direction vector of this MText entity (DXF 11).

◆ dwgInFields()

virtual OdResult OdDbMText::dwgInFields ( OdDbDwgFiler pFiler)
virtual

Reads the .dwg file data of this object.

Parameters
pFiler[in] Filer object from which data are read.
Returns
Returns the filer status.

This function is called by dwgIn() to allow the object to read its data.

When overriding this function:

1) Call assertWriteEnabled(). 2) Call the parent class's dwgInFields(pFiler). 3) If it returns eOK, continue; otherwise return whatever the parent's dwgInFields(pFiler) returned. 4) Call the OdDbDwgFiler(pFiler) methods to read each of the object's data items in the order they were written. 5) Return pFiler->filerStatus().

Reimplemented from OdDbEntity.

◆ dwgOutFields()

virtual void OdDbMText::dwgOutFields ( OdDbDwgFiler pFiler) const
virtual

Writes the .dwg file data of this object.

Parameters
pFiler[in] Pointer to the filer to which data are written.
Remarks

This function is called by dwgIn() to allow the object to write its data.

When overriding this function:

1) Call assertReadEnabled(). 2) Call the parent class's dwgOutFields(pFiler). 3) Call the OdDbDwgFiler(pFiler) methods to write each of the object's data items in the order they were written.

Reimplemented from OdDbEntity.

◆ dxfInFields()

virtual OdResult OdDbMText::dxfInFields ( OdDbDxfFiler pFiler)
virtual

Reads the DXF data of this object.

Parameters
pFiler[in] Pointer to the filer from which data are read.
Returns
Returns the filer status.

This function is called by dxfIn() to allow the object to read its data.

When overriding this function:

1) Call assertWriteEnabled(). 2) Call the parent class's dwgInFields(pFiler). 3) If it returns eOK, continue; otherwise return whatever the parent's dxfInFields(pFiler) returned. 4) Call the OdDbDxfFiler(pFiler) methods to read each of the object's data items in the order they were written. 5) Return pFiler->filerStatus().

Reimplemented from OdDbEntity.

◆ dxfOutFields()

virtual void OdDbMText::dxfOutFields ( OdDbDxfFiler pFiler) const
virtual

Writes the DXF data of this object.

Parameters
pFiler[in] Pointer to the filer to which data are to be written.
Remarks

This function is called by dxfOut() to allow the object to write its data.

When overriding this function:

1) Call assertReadEnabled(). 2) Call the parent class's dxfOutFields(pFiler). 4) Use pFiler to call the OdDbDxfFiler methods to write each of the object's data items in the order they were written.

Reimplemented from OdDbEntity.

◆ explodeFragments()

void OdDbMText::explodeFragments ( OdDbMTextEnum  fragmentFn,
void params,
OdGiWorldDraw ctxt = 0 
) const

Explodes this MText entity into a sequence of simple text fragments, passing each fragment to the specified function

Parameters
fragmentFn[in] Function pointer to the fragment elaboration callback function.
params[in] Void pointer to the fragmentFn callback function's second argument.
ctxt[in] Drawing context.
Remarks
The prototype of the fragment elaboration is as follows:
    int (*OdDbMtextEnum)(OdDbMTextFragment *fragment, void *param)
If ctxt is null, the current OdGiWorldDraw object will be used.

The elaboration function should return 1 to continue, or 0 to terminate the explosion.

Each new line in this MText entity, and each change of text attributes, will start a new fragment.

◆ explodeGeometry()

virtual OdResult OdDbMText::explodeGeometry ( OdRxObjectPtrArray entitySet) const
virtual

Explodes this entity into a set of simpler entities.

Parameters
entitySet[in/out] Receives an array of pointers to the new entities.
Remarks
The newly created entities will be not database resident. Entities resulting from the explosion are appended to the specified array. The default implementation of this function calls subWorldDraw() and makes entities from geometry generated by subWorldDraw(). This function can be overridden in custom classes.
Returns
Returns eOk if successful, or an appropriate error code if not.

Reimplemented from OdDbEntity.

◆ flowDirection()

FlowDirection OdDbMText::flowDirection ( ) const

Returns the flow direction of this MText entity (DXF 72).

Remarks
flowDirection() returns one of the following:

Value kLtoR 1 kRtoL 2 kTtoB 3 kBtoT 4 kByStyle 5

◆ fontChange()

static const OdString OdDbMText::fontChange ( )
static

Returns the font change string "\F".

Remarks
May be used in place of "\F" to make code more understandable.

◆ getActualBoundingPoints()

void OdDbMText::getActualBoundingPoints ( OdGePoint3dArray boundingPoints,
double  dGapX = 0.,
double  dGapY = 0. 
) const

Returns the WCS actual bounding points of this MText entity.

Parameters
boundingPoints[out] Receives the bounding points.
dGapX[in] specifies gap aroung actual text in X direction.
dGapY[in] specifies gap aroung actual text in Y direction.
Remarks
The points are returned as follows:

Corner boundingPoints[0] Top left boundingPoints[1] Top right boundingPoints[2] Bottom left boundingPoints[3] Bottom right

◆ getBackgroundFillColor()

OdCmColor OdDbMText::getBackgroundFillColor ( ) const

Returns the background fill color of this MText entity (DXF 63 and optionally 421 & 431).

◆ getBackgroundScaleFactor()

double OdDbMText::getBackgroundScaleFactor ( ) const

Returns the background scale factor of this MText entity (DXF 45).

Remarks
The filled background area is extended by (ScaleFactor - 1) * TextHeight in all directions.

◆ getBackgroundTransparency()

OdCmTransparency OdDbMText::getBackgroundTransparency ( ) const

Returns the background transparency of this MText entity (DXF 441).

◆ getBoundingPoints()

void OdDbMText::getBoundingPoints ( OdGePoint3dArray boundingPoints) const

Returns the WCS bounding points of this MText entity box.

Parameters
boundingPoints[out] Receives the bounding points.
Remarks
The points are returned as follows:

Corner boundingPoints[0] Top left boundingPoints[1] Top right boundingPoints[2] Bottom left boundingPoints[3] Bottom right

◆ getColumnAutoHeight()

bool OdDbMText::getColumnAutoHeight ( ) const

Returns the column auto height status of this MText entity.

◆ getColumnCount()

OdInt32 OdDbMText::getColumnCount ( ) const

Returns the column count of this MText entity.

◆ getColumnFlowReversed()

bool OdDbMText::getColumnFlowReversed ( ) const

Returns the column flow reverse status of this MText entity.

◆ getColumnGutterWidth()

double OdDbMText::getColumnGutterWidth ( ) const

Returns the column gutter of this MText entity.

◆ getColumnHeight()

double OdDbMText::getColumnHeight ( OdInt16  col) const

Returns the column height of this MText entity.

Parameters
col[in] Column number.

◆ getColumnType()

ColumnType OdDbMText::getColumnType ( ) const

Returns the column type of this MText entity.

Remarks
The type is returned as follows:

Value kNoColumns 1 kStaticColumns 2 kDynamicColumns 3

◆ getColumnWidth()

double OdDbMText::getColumnWidth ( ) const

Returns the column width of this MText entity.

◆ getEcs()

OdGeMatrix3d OdDbMText::getEcs ( ) const
virtual

Returns the entity coordinate system matrix.

Reimplemented from OdDbEntity.

◆ getParagraphsIndent()

void OdDbMText::getParagraphsIndent ( OdDbMTextIndents indents) const

Returns the paragraph indentation and tab data of this MText entity.

Parameters
indents[out] Receives the indentation and tab data.

◆ getPlane()

virtual OdResult OdDbMText::getPlane ( OdGePlane plane,
OdDb::Planarity planarity 
) const
virtual

Returns the plane that contains this entity.

Parameters
plane[out] Receives the plane that contains this entity.
planarity[out] Receives the planarity of this entity.
Returns
Returns eOk if successful, or an appropriate error code if not.

planarity and plane return values as follows::

Value Description plane kNonPlanar 0 Non-planar Not set kPlanar 1 Planar Entity plane kLinear 2 Linear Arrbitrary plane containing this entity

Reimplemented from OdDbEntity.

◆ height()

double OdDbMText::height ( ) const

Returns the height of the box of this MText entity.

◆ heightChange()

static const OdString OdDbMText::heightChange ( )
static

Returns the height change string "\H".

Remarks
May be used in place of "\H" to make code more understandable.

◆ horizontalMode()

OdDb::TextHorzMode OdDbMText::horizontalMode ( ) const

Returns the horizontal mode of this MText entity (used for DXF 71).

Remarks
horizontalMode returns one of the following:

Value OdDb::kTextLeft 0 OdDb::kTextCenter 1 OdDb::kTextRight 2 OdDb::kTextAlign 3 OdDb::kTextMid 4 OdDb::kTextFit 5

◆ lineBreak()

static const OdString OdDbMText::lineBreak ( )
static

Returns the line break string "\p".

Remarks
May be used in place of "\p" to make code more understandable.

◆ lineSpacingFactor()

double OdDbMText::lineSpacingFactor ( ) const

Returns the linespacing factor of this MText entity (DXF 44).

◆ lineSpacingStyle()

OdDb::LineSpacingStyle OdDbMText::lineSpacingStyle ( ) const

Returns the linespacing style of this MText entity (DXF 73).

◆ location()

OdGePoint3d OdDbMText::location ( ) const

Returns the insertion point of this MText entity (WCS equivalent of DXF 10).

◆ nonBreakSpace()

static const OdString OdDbMText::nonBreakSpace ( )
static

Returns the non-break space string "\~".

Remarks
May be used in place of "\~" to make code more understandable.

◆ normal()

OdGeVector3d OdDbMText::normal ( ) const

Returns the WCS normal to the plane of this entity (DXF 210).

◆ obliqueChange()

static const OdString OdDbMText::obliqueChange ( )
static

Returns the oblique angle change string "\Q".

Remarks
May be used in place of "\Q" to make code more understandable.

◆ ODDB_DECLARE_MEMBERS()

OdDbMText::ODDB_DECLARE_MEMBERS ( OdDbMText  )

◆ overlineOff()

static const OdString OdDbMText::overlineOff ( )
static

Returns the overline off string "\o".

Remarks
May be used in place of "\o" to make code more understandable.

◆ overlineOn()

static const OdString OdDbMText::overlineOn ( )
static

Returns the overline on string "\O".

Remarks
May be used in place of "\O" to make code more understandable.

◆ paragraphBreak()

static const OdString OdDbMText::paragraphBreak ( )
static

Returns the paragraph break string "\P".

Remarks
May be used in place of "\P" to make code more understandable.

◆ removeField() [1/2]

OdDbObjectId OdDbMText::removeField ( const OdString fieldName)
virtual

Removes the specified field from the field dictionary of this object.

Parameters
fieldName[in] Name (key) for the entry.
Remarks
Returns the Object ID of the removed field if successful, or a null Object ID if not.

Reimplemented from OdDbObject.

◆ removeField() [2/2]

OdResult OdDbMText::removeField ( OdDbObjectId  fieldId)
virtual

Removes the specified field from the field dictionary of this object.

Parameters
fieldId[in] Object ID for the field.
Remarks
Returns eOk if successful, or an appropriate error code if not.

Reimplemented from OdDbObject.

◆ rotation()

double OdDbMText::rotation ( ) const

Returns the rotation angle of this MText entity in radians (DXF 50).

◆ setAttachment()

void OdDbMText::setAttachment ( AttachmentPoint  type)

Sets the type of the attachment point of this MText entity (DXF 71).

Parameters
type[in] Type of the attachment point.
Remarks
attachment must be one of the following:

Value kTopLeft 1 kTopCenter 2 kTopRight 3 kMiddleLeft 4 kMiddleCenter 5 kMiddleRight 6 kBottomLeft 7 kBottomCenter 8 kBottomRight 9

Remarks
setAttachment() keeps the location of this MText entity constant while changing the attachment type, thereby changing the extents of (moving) this MText entity.

setAttachmentMovingLocation() moves the location of the MText entity while changing the attachment type, thereby maintaining the extents (not moving) this MText entity.

Throws: Method generates the eInvalidInput exception when the text attachment number is out of the range 1 to 9.

See also
OdDbMText::setAttachmentMovingLocation() method

◆ setAttachmentMovingLocation()

OdResult OdDbMText::setAttachmentMovingLocation ( AttachmentPoint  attachment)

Sets the type of the attachment point of this MText entity (DXF 71).

Parameters
attachment[in] Type of the attachment point.
Remarks
attachment must be one of the following:

Value kTopLeft 1 kTopCenter 2 kTopRight 3 kMiddleLeft 4 kMiddleCenter 5 kMiddleRight 6 kBottomLeft 7 kBottomCenter 8 kBottomRight 9

Remarks
setAttachment() keeps the location of this MText entity constant while changing the attachment type, thereby changing the extents of (moving) this MText entity.

setAttachmentMovingLocation() adjusts the location of the MText entity while changing the attachment type, so as to maintain the extents (not move) this MText entity.

See also
OdDbMText::setAttachment() method

◆ setBackgroundFill()

void OdDbMText::setBackgroundFill ( bool  bEnable)

Controls the background fill of this MText entity (DXF 90, bit 0x01).

Parameters
bEnable[in] True to enable background fill, false to disable.

◆ setBackgroundFillColor()

void OdDbMText::setBackgroundFillColor ( const OdCmColor color)

Sets the background fill color of this MText entity (DXF 63 and optionally 421 & 431).

Parameters
color[in] New color value.

◆ setBackgroundScaleFactor()

void OdDbMText::setBackgroundScaleFactor ( const double  scaleFactor)

Sets the background scale factor of this MText entity (DXF 45).

Parameters
scaleFactor[in] Background scale factor. [1..5]
Remarks
The filled background area is extended by (ScaleFactor - 1) * TextHeight in all directions.

Throws: Method generates the eInvalidInput exception when the scale factor is out of the range 1.0 to 5.0.

◆ setBackgroundTransparency()

void OdDbMText::setBackgroundTransparency ( const OdCmTransparency transparency)

Sets the background transparency of this MText entity (DXF 441).

Parameters
transparency[in] New transparency value.

◆ setColumnAutoHeight()

void OdDbMText::setColumnAutoHeight ( bool  bAutoHeigh)

Switches the column auto height status of this MText entity.

Parameters
bAutoHeigh[in] New column auto height status.

Throws: Method generates the eNotApplicable exception when the column type is not set to kDynamicColumns.

◆ setColumnCount()

void OdDbMText::setColumnCount ( OdInt32  numCol)

Sets the column count of this MText entity.

Parameters
numCol[in] Number of columns.

Throws: Method generates the eInvalidInput exception when the column count is out of the range 1 to 100.

◆ setColumnFlowReversed()

void OdDbMText::setColumnFlowReversed ( bool  bFlowRev)

Switches the column flow reverse status of this MText entity.

Parameters
bFlowRev[in] New status.

◆ setColumnGutterWidth()

void OdDbMText::setColumnGutterWidth ( double  colGutter)

Sets the column gutter of this MText entity.

Parameters
colGutter[in] Gutter of columns.

Throws: Method generates the eInvalidInput exception when the column gutter is a negative value.

◆ setColumnHeight()

void OdDbMText::setColumnHeight ( OdInt16  col,
double  colHeight 
)

Sets the column height of this MText entity.

Parameters
col[in] Column number.
colHeight[in] Height of the specified column.

Throws: Method generates the eInvalidInput exception when the column height is a non-positive double value.

◆ setColumnType()

void OdDbMText::setColumnType ( ColumnType  colType)

Sets the column type of this MText entity.

Parameters
colType[in] Column type.

Value kNoColumns 1 kStaticColumns 2 kDynamicColumns 3

◆ setColumnWidth()

void OdDbMText::setColumnWidth ( double  colWidth)

Sets the column width of this MText entity.

Parameters
colWidth[in] Width of columns.

Throws: Method generates the eInvalidInput exception when the column width is a non-positive double value.

◆ setContents()

int OdDbMText::setContents ( const OdString text)

Sets the character content of this MText entity (DXF 1 & 3).

Parameters
text[in] New character content.

◆ setContentsRTF()

int OdDbMText::setContentsRTF ( const OdString text)

Sets the character content of this MText entity (DXF 1 & 3) from the RTF-encoded text string.

Parameters
text[in] New character content.

◆ setDirection()

void OdDbMText::setDirection ( const OdGeVector3d direction)

Sets the WCS X-axis direction vector of this MText entity (DXF 11).

Parameters
direction[in] Direction vector.
Remarks
Direction and rotation are equivalent, and only one need be set when creating (or modifying) an MText entity.

◆ setDynamicColumns()

void OdDbMText::setDynamicColumns ( double  width,
double  gutter,
bool  bAutoHeigh 
)

◆ setField()

OdDbObjectId OdDbMText::setField ( const OdString fieldName,
OdDbField pField 
)
virtual

Adds the specified field to the field dictionary of this object.

Parameters
fieldName[in] Name (key) for the new entry.
pField[in] Pointer to the field object.
Returns
Returns the Object ID of the new entry.

Reimplemented from OdDbObject.

◆ setFlowDirection()

void OdDbMText::setFlowDirection ( FlowDirection  flowDirection)

Sets the flow direction of this MText entity (DXF 72).

Parameters
flowDirection[in] New flow direction enumerator.
Remarks
flowDirection() returns one of the following:

Value kLtoR 1 kRtoL 2 kTtoB 3 kBtoT 4 kByStyle 5

Throws: Method generates the eInvalidInput exception when the flow direction is out of the range 1 to 5.

◆ setHeight()

void OdDbMText::setHeight ( double  value)

Sets the height of the box of this MText entity.

Parameters
value[in] New height value.

◆ setHorizontalMode()

void OdDbMText::setHorizontalMode ( OdDb::TextHorzMode  horizontalMode)

Sets the horizontal mode of this MText entity (used for DXF 71).

Parameters
horizontalMode[in] Horizontal mode.
Remarks
horizontalMode must be one of the following:

Value OdDb::kTextLeft 0 OdDb::kTextCenter 1 OdDb::kTextRight 2 OdDb::kTextAlign 3 OdDb::kTextMid 4 OdDb::kTextFit 5

Throws: Method generates the eNotApplicable exception when the horizontal mode is out of the range 0 to 5.

◆ setLineSpacingFactor()

void OdDbMText::setLineSpacingFactor ( double  lineSpacingFactor)

Sets the linespacing factor of this MText entity (DXF 44).

Parameters
lineSpacingFactor[in] Linespacing Factor.

Throws: Method generates the eInvalidInput exception when the line spacing factor is out of the range 0.25 to 4.00.

◆ setLineSpacingStyle()

void OdDbMText::setLineSpacingStyle ( OdDb::LineSpacingStyle  lineSpacingStyle)

Sets the linespacing style of this MText entity (DXF 73).

Parameters
lineSpacingStyle[in] Linespacing style.

Value kAtLeast 1 kExactly 2

Throws: Method generates the eInvalidInput exception when the linespacing style is not 1 or 2.

◆ setLocation()

void OdDbMText::setLocation ( const OdGePoint3d location)

Sets the insertion point of this MText entity (WCS equivalent of DXF 10).

Parameters
location[in] Insertion point.

◆ setNormal()

void OdDbMText::setNormal ( const OdGeVector3d normal)

Sets the WCS normal to the plane of this entity (DXF 210).

Parameters
normal[in] Normal.

◆ setRotation()

void OdDbMText::setRotation ( double  rotation)

Sets the rotation angle of this MText entity in radians (DXF 50).

Parameters
rotation[in] Rotation angle in radians.

◆ setShowBorders()

void OdDbMText::setShowBorders ( bool  bEnable)

Sets the flag controlling mtext border's visibility.

Parameters
bEnable[in] - True means borders will be visible and false means borders will be invisible.

◆ setStaticColumns()

void OdDbMText::setStaticColumns ( double  width,
double  gutter,
OdInt16  count 
)

◆ setTextHeight()

void OdDbMText::setTextHeight ( double  height)

Sets the text height of this MText entity (DXF 40).

Parameters
height[in] New text height value.

Throws: Method generates the eInvalidInput exception when the text height is less than or equal to zero.

◆ setTextStyle()

void OdDbMText::setTextStyle ( OdDbObjectId  textStyleId)

Sets the Object ID of the text style of this MText entity (DXF 7).

Parameters
textStyleId[in] Text style Object ID.

◆ setUseBackgroundColor()

void OdDbMText::setUseBackgroundColor ( bool  enable)

Controls the use of the screen background color as the background color of this MText entity (DXF 90, bit 0x02).

Parameters
enable[in] True to use the screen background color, false to use the setBackgroundFillColor() method.

◆ setVerticalMode()

void OdDbMText::setVerticalMode ( OdDb::TextVertMode  verticalMode)

Sets the vertical mode of this MText entity (used for DXF 71).

Parameters
verticalMode[in] Vertical mode.
Remarks
verticalMode must be one of the following:

Value OdDb::kTextBottom 1 OdDb::kTextVertMid 2 OdDb::kTextTop 3

Throws: Method generates the eNotApplicable exception when the vertical mode is out of the range 1 to 3.

◆ setWidth()

void OdDbMText::setWidth ( double  width)

Sets the word-wrap width of this MText entity (DXF 41).

Parameters
width[in] Word-wrap width
Remarks
Words exceeding this value will extend beyond the Specified width.

◆ showBorders()

bool OdDbMText::showBorders ( )

Gets the flag controlling mtext border's visibility.

◆ stackStart()

static const OdString OdDbMText::stackStart ( )
static

Returns the stacked text start string "\S".

Remarks
May be used in place of "\S" to make code more understandable.

◆ strikethroughOff()

static const OdString OdDbMText::strikethroughOff ( )
static

Returns the strike through off string "\k".

Remarks
May be used in place of "\k" to make code more understandable.

◆ strikethroughOn()

static const OdString OdDbMText::strikethroughOn ( )
static

Returns the strike through on string "\K".

Remarks
May be used in place of "\K" to make code more understandable.

◆ subClose()

void OdDbMText::subClose ( )
virtual

Called as the first operation as this object is being closed, for database -resident objects only.

Remarks
This function is notified just before the current open operation is to be closed, giving this function the ability to perform necessary operatons.

When overriding this function:

1) If the OdDbObject's state is incorrect, throw exception.

2) Call parent class's subClose().

3) If other actions are required before close, do them.

The default implementation of this function does nothing. This function can be overridden in custom classes.

Reimplemented from OdDbObject.

◆ subExplode()

virtual OdResult OdDbMText::subExplode ( OdRxObjectPtrArray entitySet) const
virtual

Reimplemented from OdDbEntity.

◆ subGetClassID()

OdResult OdDbMText::subGetClassID ( void pClsid) const
virtual

Reimplemented from OdDbEntity.

◆ subGetGeomExtents()

virtual OdResult OdDbMText::subGetGeomExtents ( OdGeExtents3d extents) const
virtual

Reimplemented from OdDbEntity.

◆ subGetTransformedCopy()

virtual OdResult OdDbMText::subGetTransformedCopy ( const OdGeMatrix3d mat,
OdDbEntityPtr pCopy 
) const
virtual

Reimplemented from OdDbEntity.

◆ subSetDatabaseDefaults()

void OdDbMText::subSetDatabaseDefaults ( OdDbDatabase pDb,
bool  doSubents 
)
virtual

This function is an override for OdDbEntity::subSetDatabaseDefaults() to set the dimension style of this entity to the current style for the specified database.

Reimplemented from OdDbEntity.

◆ subTransformBy()

virtual OdResult OdDbMText::subTransformBy ( const OdGeMatrix3d xfm)
virtual

Reimplemented from OdDbEntity.

◆ subViewportDraw()

void OdDbMText::subViewportDraw ( OdGiViewportDraw pVd) const
virtual

Reimplemented from OdDbEntity.

◆ subWorldDraw()

bool OdDbMText::subWorldDraw ( OdGiWorldDraw pWd) const
virtual

Reimplemented from OdDbEntity.

◆ text()

OdString OdDbMText::text ( )

Gets contents without formate codes.

◆ textHeight()

double OdDbMText::textHeight ( ) const

Returns the text height of this MText entity (DXF 40).

◆ textStyle()

OdDbObjectId OdDbMText::textStyle ( ) const

Returns the Object ID of the text style of this MText entity (DXF 7).

◆ trackChange()

static const OdString OdDbMText::trackChange ( )
static

Returns the track change string "\T".

Remarks
May be used in place of "\T" to make code more understandable.

◆ underlineOff()

static const OdString OdDbMText::underlineOff ( )
static

Returns the underline off string "\l".

Remarks
May be used in place of "\l" to make code more understandable.

◆ underlineOn()

static const OdString OdDbMText::underlineOn ( )
static

Returns the underline on string "\L".

Remarks
May be used in place of "\L" to make code more understandable.

◆ useBackgroundColorOn()

bool OdDbMText::useBackgroundColorOn ( ) const

Returns true if and only if the screen background color is used as the/ background color/ of this MText entity (DXF 90, bit 0x02).

◆ verticalMode()

OdDb::TextVertMode OdDbMText::verticalMode ( ) const

Returns the vertical mode of this MText entity (used for DXF 71).

Remarks
verticalMode() returns one of the following:

Value OdDb::kTextBase 0 OdDb::kkTextBottom 1 OdDb::kkTextVertMid 2 OdDb::kkTextTop 3

◆ width()

double OdDbMText::width ( ) const

Returns the word-wrap width of this MText entity (DXF 41).

Remarks
Words exceeding this value will extend beyond this width.

◆ widthChange()

static const OdString OdDbMText::widthChange ( )
static

Returns the width change string "\W".

Remarks
May be used in place of "\W" to make code more understandable.

The documentation for this class was generated from the following file: