Characters.CharProps property (Visio)
Sets a character property of a Characters object to a new value. Write-only.
Syntax
expression.CharProps (CellIndex)
expression An expression that returns a Characters object.
Parameters
| Name | Required/Optional | Data type | Description |
|---|---|---|---|
| CellIndex | Required | Integer | The index of the cell in the Character section to set. See Remarks for possible values. |
Return value
Integer
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 ShapeSheet 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 CellIndex argument correspond to cells in the Character section of the ShapeSheet window, and the values of the CharProps property correspond to the values that can be entered in those cells.
Constants for CellIndex and for the CharProps property value are declared in the Visio type library in VisCellIndices.
| ** CellIndex** | ** Value** | ** intExpression** | ** Value** |
|---|---|---|---|
| visCharacterFont | 0 | An integer that represents an index into the Fonts collection installed on a system. Zero (0) 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 that represents point size. | N/A |
| visCharacterColorTrans | 17 | An integer from 0 to 100 that corresponds to the degree of transparency of the text color, as a percentage. | N/A |
| visCharacterDblUnderline | 8 | Boolean | N/A |
| visCharacterFontScale | 5 | An integer from 0 to 655 that represents the width of the text font, as a percentage, relative to the default (100%). | N/A |
| visCharacterLangID | 57 | A Long that represents the language the text is in. The language ID (LANGID) for a character is a 16-bit value defined by Windows, consisting of a primary language ID and a secondary language ID. To determine the value for particular languages, see the Platform SDK documentation on MSDN. | N/A |
| visCharacterLetterspace | 16 | An integer that represents additional space between adjacent letters, in points. | N/A |
| visCharacterOverline | 9 | Boolean | N/A |
| visCharacterStrikethru | 10 | Boolean | N/A |
If your Visual Studio solution includes the Microsoft.Office.Interop.Visio reference, this property maps to the following types:
- Microsoft.Office.Interop.Visio.IVCharacters.set_CharProps
Support and feedback
Have questions or feedback about Office VBA or this documentation? Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.