InvisibleApp.DefaultTextUnits Property (Visio)

Determines the default unit of measure for quantities that represent text metrics. Read/write.

Syntax

expression. DefaultTextUnits

expression A variable that represents an InvisibleApp object.

Return value

Variant

Remarks

The DefaultTextUnits property corresponds to the value shown in the Text box under Display on the Advanced tab of the Visio Options dialog box (click the File tab, and then click Options).

The return value contains one of the values of VisUnitCodes , which are declared in the Microsoft Visio type library.

You can specify the value of DefaultTextUnits as an integer (a member of VisUnitCodes) or a string value such as "pt". If the string is invalid or the unit code is inappropriate (non-textual), an error is generated.

For a complete list of valid unit strings along with corresponding Automation constants (integer values), see About Units of Measure.

Cell formulas that contain a specific unit of measure are displayed in those units regardless of the default text units setting. Many cell formulas, however, use implicit unit syntax and are displayed in default units.

A program can create a cell whose formula is displayed in default units by setting the cell's Formula property to a string in implicit unit syntax. For example, the formula "=8[pt,T]" is displayed as "8 pt" if the DefaultTextUnits property is visPoints and "0.6272" if the DefaultTextUnits property is visCiceros .

Alternatively, a program can use the following statement to set the cell's result to default text units:

vsoCell.Result(visTextUnits) = 12

In this case, the text is 12 points if the DefaultTextUnits property is visPoints and 12 ciceros if the DefaultTextUnits property is visCiceros .

For details about implicit units of measure, see About Units of Measure.