TextEntity
Inheritance Hierarchy
System.Object
Rhino.Runtime.CommonObject
Rhino.Geometry.GeometryBase
Rhino.Geometry.AnnotationBase
Rhino.Geometry.TextEntity
Namespace: Rhino.Geometry
Assembly: RhinoCommon (in RhinoCommon.dll)
Syntax
[SerializableAttribute]public class TextEntity : AnnotationBaseThe TextEntity type exposes the following members.
Constructors
Name
Description
Public Method
Code Example
TextEntity.
Initializes a new instance of the TextEntity class.
Protected Method
TextEntity(SerializationInfo, StreamingContext)
Protected constructor used in serialization
Properties
Name
Description
Public Property
AlternateDimensionLengthDisplay
Alternate length display units and format
(Inherited from AnnotationBase.)
Public Property
AnnotationType
Type of annotation
(Inherited from AnnotationBase.)
Public Property
DecimalSeparator
Set or get the decimal separator c
(Inherited from AnnotationBase.)
Public Property
DimensionLengthDisplay
Length display units and format
(Inherited from AnnotationBase.)
Public Property
DimensionScale
Gets or sets the dimension scale
(Inherited from AnnotationBase.)
Public Property
DimensionStyle
If there are no overrides then the parent style is returned otherwise the dimension style saved with the annotation is returned.
(Inherited from AnnotationBase.)
Public Property
DimensionStyleId
Id of this annotation’s parent dimstyle If this annotation has overrides to dimstyle properties, those overrides will be represented in the DimensionStyle returned by DimensionStyle(ParentStyle)
(Inherited from AnnotationBase.)
Public Property
Disposed
Indicates if this object has been disposed or the document it originally belonged to has been disposed.
(Inherited from CommonObject.)
Public Property
DrawForward
Gets or sets whether the text is oriented towards the reader when viewed from behind
(Inherited from AnnotationBase.)
Public Property
DrawTextFrame
Obsolete.
Gets or sets whether to draw a frame around a text mask
(Inherited from AnnotationBase.)
Public Property
FirstCharFont
Returns the font used by the first run of text in an annotation
(Inherited from AnnotationBase.)
Public Property
Font
The base Font for the text of the annotation. The text string is rich text and therefore a different font that the base font can be associated with sub strings of the text
(Inherited from AnnotationBase.)
Public Property
FormatWidth
Text format width (Wrapping rectangle)
(Inherited from AnnotationBase.)
Public Property
HasBrepForm
Returns true if the Brep.TryConvertBrep function will be successful for this object
(Inherited from GeometryBase.)
Public Property
HasPropertyOverrides
(Inherited from AnnotationBase.)
Public Property
HasUserData
Gets true if this class has any custom information attached to it through UserData.
(Inherited from CommonObject.)
Public Property
IsDeformable
true if object can be accurately modified with “squishy” transformations like projections, shears, and non-uniform scaling.
(Inherited from GeometryBase.)
Public Property
IsDocumentControlled
If true this object may not be modified. Any properties or functions that attempt to modify this object when it is set to “IsReadOnly” will throw a NotSupportedException.
(Inherited from GeometryBase.)
Public Property
IsValid
Tests an object to see if it is valid.
(Inherited from CommonObject.)
Public Property
Code Example
Justification
Gets or sets the justification of text in relation to its base point.
Public Property
MaskColor
Color to use for drawing a text mask when it is enabled. If the mask is enabled and MaskColor is System.Drawing.Color.Transparent, then the viewport’s color will be used for the MaskColor
(Inherited from AnnotationBase.)
Public Property
MaskColorSource
Gets or sets whether the mask background color is from the background or from a color
(Inherited from AnnotationBase.)
Public Property
MaskEnabled
Determines whether or not to draw a Text Mask
(Inherited from AnnotationBase.)
Public Property
MaskFrame
Gets or sets whether to draw a frame around a text mask
(Inherited from AnnotationBase.)
Public Property
MaskOffset
Offset for the border around text of the rectangle used to draw the mask. This value multiplied by TextHeight is the offset on each side of the tight rectangle around the text characters to the mask rectangle. The default value is 0.1.
(Inherited from AnnotationBase.)
Public Property
MaskUsesViewportColor
If true, the viewport’s color is used for the mask color. If false, the color defined by MaskColor is used
(Inherited from AnnotationBase.)
Public Property
ObjectType
Useful for switch statements that need to differentiate between basic object types like points, curves, surfaces, and so on.
(Inherited from GeometryBase.)
Public Property
ParentDimensionStyle
The parent dimension style associated with this annotation
(Inherited from AnnotationBase.)
Public Property
PlainText
Text stripped of RTF formatting information
(Inherited from AnnotationBase.)
Public Property
PlainTextWithFields
Text stripped of RTF formatting information and with field expressions intact
(Inherited from AnnotationBase.)
Public Property
Plane
Plane that this annotation lies on
(Inherited from AnnotationBase.)
Public Property
RichText
Text including additional RTF formatting information
(Inherited from AnnotationBase.)
Public Property
Text
Obsolete.
Text including additional RTF formatting information
(Inherited from AnnotationBase.)
Public Property
TextFormula
Obsolete.
See RichText
(Inherited from AnnotationBase.)
Public Property
TextHasRtfFormatting
(Inherited from AnnotationBase.)
Public Property
TextHeight
AnnotationBase.TextHeight Gets the parent dimstyle for the annotation and gets or sets the text height in the dimstyle
(Inherited from AnnotationBase.)
Public Property
TextHorizontalAlignment
Public Property
TextIsWrapped
Is text wrapping on
(Inherited from AnnotationBase.)
Public Property
TextModelWidth
Width of text in the model
(Inherited from AnnotationBase.)
Public Property
TextOrientation
Public Property
TextRotationDegrees
Rotation of text in degrees
(Inherited from AnnotationBase.)
Public Property
TextRotationRadians
Rotation of text in radians
(Inherited from AnnotationBase.)
Public Property
TextVerticalAlignment
Public Property
UserData
List of custom information that is attached to this class.
(Inherited from CommonObject.)
Public Property
UserDictionary
Dictionary of custom information attached to this class. The dictionary is actually user data provided as an easy to use shareable set of information.
(Inherited from CommonObject.)
Public Property
UserStringCount
Gets the amount of user strings.
(Inherited from GeometryBase.)
Methods
Name
Description
Public Method
ClearPropertyOverrides
Clears all overridden properties for this annotation
(Inherited from AnnotationBase.)
Public Method
ComponentIndex
If this piece of geometry is a component in something larger, like a BrepEdge in a Brep, then this function returns the component index.
(Inherited from GeometryBase.)
Protected Method
ConstructConstObject
Assigns a parent object and a sub-object index to this.
(Inherited from CommonObject.)
Public Method
Static Member
Create
Create Text geometry or null if input is invalid
Public Method
CreateCurves
Returns the outline curves.
Public Method
CreateCurvesGrouped
Creates planar curve from text outline curves. Curves are grouped such that each element in the list being returned represents a single character.
Public Method
CreateExtrusions
Creates extrusions from the outline curves with specified height.
Public Method
CreateExtrusionsGrouped
Creates 3d Breps from text outline curves. Breps are grouped such that each element in the list being returned represents a single character.
Public Method
CreatePolySurfaces
Creates breps from the outline curves with specified height.
Public Method
CreatePolysurfacesGrouped
Creates 3d Breps from text outline curves. Breps are grouped such that each element in the list being returned represents a single character.
Public Method
CreateSurfaces
Creates planar breps from the outline curves.
Public Method
CreateSurfacesGrouped
Creates planar Breps from text outline curves. Breps are grouped such that each element in the list being returned represents a single character.
Public Method
Static Member
CreateWithRichText
Create RichText geometry or null if input is invalid
Public Method
DataCRC
Returns a CRC calculated from the information that defines the object. This CRC can be used as a quick way to see if two objects are not identical.
(Inherited from GeometryBase.)
Public Method
DeleteAllUserStrings
(Inherited from GeometryBase.)
Public Method
DeleteUserString
(Inherited from GeometryBase.)
Public Method
Dispose.
Actively reclaims unmanaged resources that this instance uses.
(Inherited from CommonObject.)
Protected Method
Dispose(Boolean)
Overridden in order to destroy local display cache information
(Inherited from GeometryBase.)
Public Method
Duplicate
Constructs a deep (full) copy of this object.
(Inherited from GeometryBase.)
Public Method
DuplicateShallow
Constructs a light copy of this object. By “light”, it is meant that the same underlying data is used until something is done to attempt to change it. For example, you could have a shallow copy of a very heavy mesh object and the same underlying data will be used when doing things like inspecting the number of faces on the mesh. If you modify the location of one of the mesh vertices, the shallow copy will create a full duplicate of the underlying mesh data and the shallow copy will become a deep copy.
(Inherited from GeometryBase.)
Public Method
EnsurePrivateCopy
If you want to keep a copy of this class around by holding onto it in a variable after a command completes, call EnsurePrivateCopy to make sure that this class is not tied to the document. You can call this function as many times as you want.
(Inherited from CommonObject.)
Public Method
Equals
Determines whether the specified object is equal to the current object.
(Inherited from Object.)
Public Method
Explode
Explodes this text entity into an array of curves.
Protected Method
Finalize
Passively reclaims unmanaged resources when the class user did not explicitly call Dispose().
(Inherited from CommonObject.)
Public Method
Code Example
GetBoundingBox(Boolean)
Bounding box solver. Gets the world axis aligned bounding box for the geometry.
(Inherited from GeometryBase.)
Public Method
Code Example
GetBoundingBox(Plane)
Aligned Bounding box solver. Gets the plane aligned bounding box.
(Inherited from GeometryBase.)
Public Method
GetBoundingBox(Transform)
Aligned bounding box solver. Gets the world axis aligned bounding box for the transformed geometry.
(Inherited from AnnotationBase.)
Public Method
GetBoundingBox(Plane, Box.)
Aligned Bounding box solver. Gets the plane aligned bounding box.
(Inherited from GeometryBase.)
Public Method
GetDimensionStyle
Return the proper dimension style from which to get properties for this annotation object If this object has style overrides, those will be included in the returned dimension style and the style will be updated to include the current state of the parent style for non-overridden fields
(Inherited from AnnotationBase.)
Public Method
GetHashCode
Serves as the default hash function.
(Inherited from Object.)
Public Method
GetObjectData
Populates a System.Runtime.Serialization.SerializationInfo with the data needed to serialize the target object.
(Inherited from CommonObject.)
Public Method
GetPlainTextWithRunMap
Return plain text string for this annotation with field expressions unevaluated.
(Inherited from AnnotationBase.)
Public Method
GetTextTransform
Get the transform for this text object’s text geometry
Public Method
GetType
Gets the Type of the current instance.
(Inherited from Object.)
Public Method
GetUserString
Gets user string from this geometry.
(Inherited from GeometryBase.)
Public Method
GetUserStrings
Gets a copy of all (user key string, user value string) pairs attached to this geometry.
(Inherited from GeometryBase.)
Public Method
IsAllBold
Returns true if all of the text in the annotation is Bold, otherwise returns false
(Inherited from AnnotationBase.)
Public Method
IsAllItalic
Returns true if all of the text in the annotation is Italic, otherwise returns false
(Inherited from AnnotationBase.)
Public Method
IsAllUnderlined
Returns true if all of the text in the annotation is Underlined, otherwise returns false
(Inherited from AnnotationBase.)
Public Method
IsPropertyOverridden
Returns true if a property is overridden
(Inherited from AnnotationBase.)
Public Method
IsValidWithLog
Determines if an object is valid. Also provides a report on errors if this object happens not to be valid.
(Inherited from CommonObject.)
Public Method
MakeDeformable
If possible, converts the object into a form that can be accurately modified with “squishy” transformations like projections, shears, an non-uniform scaling.
(Inherited from GeometryBase.)
Protected Method
MemberwiseClone
Creates a shallow copy of the current Object.
(Inherited from Object.)
Public Method
MemoryEstimate
Computes an estimate of the number of bytes that this object is using in memory.
(Inherited from GeometryBase.)
Protected Method
NonConstOperation
Destroy cache handle
(Inherited from GeometryBase.)
Protected Method
OnSwitchToNonConst
Is called when a non-constant operation occurs.
(Inherited from GeometryBase.)
Public Method
Rotate
Rotates the object about the specified axis. A positive rotation angle results in a counter-clockwise rotation about the axis (right hand rule).
(Inherited from GeometryBase.)
Public Method
RunReplace
Replace text within a formatted string
(Inherited from AnnotationBase.)
Public Method
Scale
Scales the object by the specified factor. The scale is centered at the origin.
(Inherited from GeometryBase.)
Public Method
SetBold
(Inherited from AnnotationBase.)
Public Method
SetFacename
(Inherited from AnnotationBase.)
Public Method
SetItalic
(Inherited from AnnotationBase.)
Public Method
SetOverrideDimStyle
Set a style including overrides for this annotation object. The DimensionStyle OverrideStyle must have the override fields marked as overridden and must have it’s Id set to nil. Use DimensinoStyle.SetFieldOverride(Field field) and related functions to manage override settings. To override a field, the field value must be set and the field must be marked as an override. The DimensionStyle passed in here must not be in the dimstyle table
(Inherited from AnnotationBase.)
Public Method
SetRichText
(Inherited from AnnotationBase.)
Public Method
SetUnderline
(Inherited from AnnotationBase.)
Public Method
SetUserString
Attach a user string (key,value combination) to this geometry.
(Inherited from GeometryBase.)
Public Method
ToJSON
Create a JSON string representation of this object
(Inherited from CommonObject.)
Public Method
ToString
Returns a string that represents the current object.
(Inherited from Object.)
Public Method
Transform(Transform)
Transforms the geometry. If the input Transform has a SimilarityType of OrientationReversing, you may want to consider flipping the transformed geometry after calling this function when it makes sense. For example, you may want to call Flip() on a Brep after transforming it.
(Inherited from GeometryBase.)
Public Method
Transform(Transform, DimensionStyle)
Transform the object by a 4x4 transform matrix and change text height override to accommodate scaling in the transform if necessary
Public Method
Translate(Vector3d)
Translates the object along the specified vector.
(Inherited from GeometryBase.)
Public Method
Translate(Double, Double, Double)
Translates the object along the specified vector.
(Inherited from GeometryBase.)
Public Method
WrapText
Wrap text
(Inherited from AnnotationBase.)