InvisibleApp.DefaultDurationUnits Property
| Visio Automation Reference |
Determines the default unit of measure for quantities that represent durations. Read/write.
Version Information
Version Added: Visio 2002
Syntax
expression.DefaultDurationUnits
expression A variable that represents an InvisibleApp object.
Return Value
Variant
Remarks
The DefaultDurationUnits property corresponds to the value shown in the Duration box on the Units tab of the Options dialog box (on the Tools menu, click Options).
The return value contains one of the values of VisUnitCodes, which are declared in the Microsoft Office Visio type library.
You can specify DefaultDurationUnits as an integer (a member of VisUnitCodes) or a string value such as "minutes". If the string is invalid or the unit code is inappropriate (non-duration), 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 duration units setting. Many cell formulas, however, use implicit unit syntax and are displayed in default units.
A program can create a cell whose formula displays in default units by setting the cell's Formula property to a string in implicit unit syntax. For example, if a formula specifying duration is "=10[em,E]" , the result displays as "0.0069 ed" if the DefaultDurationUnits property is visElapsedDay, and "600.0000 es" if the DefaultDurationUnits property is visElapsedSec.
Alternatively, a program can use the following statement to set the cell's result to default duration units:
| Visual Basic for Applications |
|---|
|
In this case, the result is 60 minutes if the DefaultDurationUnits property is visElapsedMin and 60 seconds if the DefaultDurationUnits property is visElapsedSec.
For details about implicit units of measure, see About Units of Measure.
See Also