Cell.ResultForce Property
| Visio Automation Reference |
Sets a cell's value, even if the cell's formula is protected with the GUARD function. Read/write.
Version Information
Version Added: Visio 2.0
Syntax
expression.ResultForce(UnitsNameOrCode)
expression A variable that represents a Cell object.
Parameters
| Name | Required/Optional | Data Type | Description |
|---|---|---|---|
| UnitsNameOrCode | Required | Variant | The units to use when setting the cell's value. |
Return Value
Double
Remarks
Use the ResultForce method to set a cell's value even if the cell's formula is protected with a GUARD function. If the string is invalid, an error is generated.
Setting the ResultForce property is similar to setting a cell's ResultFromIntForce property. The difference is that the ResultFromIntForce property accepts an integer for the value of the cell, whereas the ResultForce property accepts a floating point number.
You can specify UnitsNameOrCode as an integer or a string value. For example, the following statements all set UnitsNameOrCode to inches.
Cell.ResultForce(visInches) = newValue
Cell.ResultForce(65) = newValue
Cell.ResultForce("in") = newValue where "in" can also be any of the alternate strings representing inches, such as "inch", "in.", or "intCounter".
For a complete list of valid unit strings along with their corresponding Automation constants (integer values), see About Units of Measure.
Automation constants for representing units are declared by the Visio type library in member VisUnitCodes.
To specify internal units, pass a zero-length string (""). Internal units are inches for distance and radians for angles. To specify implicit units, you must use the Formula property.
See Also