Character Object

Text in ConceptDraw shapes can consist of blocks (blocks of characters, sequence of characters) with uniform formatting attributes: font, font size, color, style, etc. The Character object provides access to various properties of such a text block.

Properties

Color Read-only. The color of the characters.
Count Read-only. The number of characters in this character block.
Font The font of character block.
Hyperlink The ID of the hyperlink associated with this character block.
Language Text encoding.
Pos Position relative to text baseline (subscript, superscript).
Size Font size.
Spacing Spacing between characters.
Style The font style (bold, italic, underline, etc).

Remarks

Character blocks are stored in the ConceptDraw shape and describe the way the shape's text is displayed. The Shape object contains a number of methods for working with the character block collection. Each character block describes the number of characters, defined by Count. The properties defined by the character block are applied to the text of the shape according to the order of blocks in the character block collection.

An instance of the Character object can be retrieved by using the same properties and methods:
Document object: DefCharacter property.
Shape object: Character method.
Style object: Character property.

To create a new character block in a shape with with the specified parameters, you can use the following methods of the Shape object: SetCharColor method, SetCharFont method, SetCharHyperlink method, SetCharLanguage method, SetCharPos method, SetCharSize method, SetCharSpacing method.

 

See Also

Color object, Document object, Paragraph object, Shape object, Style object