CharProps property

Microsoft Visio Developer Reference

CharProps property

Sets a character property of a Characters object to a new value.

Version added

3.0

Syntax

`object.CharProps(intWhichProp) = intExpression`
object	Required. An expression that returns a Characters object.
intWhichProp	Required Integer. The property to set.
intExpression	Required Integer. The new value for the property.

Remarks

Depending on the extent of the text range and the format, setting the CharProps property may cause rows to be added or removed from a shape's Character section.

The CharProps property is a write-only property. To retrieve formatting properties of a Characters object, use the CharPropsRow property.

The values of the intWhichProp argument correspond to cells viewed in the Character section of the ShapeSheet window, and the values of intExpression correspond to the values that can be entered in those cells in the ShapeSheet window.

Constants for intWhichProp and intExpression are declared by the Visio type library.

*intWhichProp*	Value	*intExpression*	Value
visCharacterFont	0	An integer that represents an index into the fonts collection installed on a system. Zero represents the default font.	N/A
visCharacterColor	1	An integer from 0 to 23 that corresponds to a color in the current color palette.	N/A
visCharacterStyle	2	visBold visItalic visUnderLine visSmallCaps	&H1 &H2 &H4 &H8
visCharacterCase	3	visCaseNormal visCaseAllCaps visCaseInitialCaps	0 1 2
visCharacterPos	4	visPosNormal visPosSuper visPosSub	0 1 2
visCharacterSize	7	An integer representing point size.	N/A

previous page start next page