VARVALUE Property

PLBCMP GUI Only

The VARVALUE property allows assignment of the value of the VARIANT in accordance with the VARTYPE of the object. The property uses the following format:

VARVALUE={value}

Note the following:

VARVALUE may be used in CREATE, SETPROP, or GETPROP statements of a VARIANT or CONTROL object.
{value} is a decimal number, a Numeric Variable, a Character Variable, an AUTOMATION object, a VARIANT object, a VARIANT array, a DIM array, or an Expression.
When used in a SETPROP instruction and {value} is a DIM array reference with no specified index, a VARIANT BSTR may be set with a total length greater than 65535.
When used in a GETPROP instruction to accept a DIM array reference with no specified index, a VARIANT BSTR with a total length greater than 65535 may be retrieved. When a DIM array is used in this manner, the BSTR data is moved into each array element starting with the first array element and continuing with each successive array element as determined by a row major sequence until BSTR data or the DIM array elements are exhausted. If the BSTR data is exhausted, any additional DIM array elements beyond that point are set to NULL. The EOS flag is set if there is an insufficient number of array elements to contain all of the BSTR data.
If the object type specifies the $VT_ARRAY variant array type, a CREATE or SETPROP will set the value of the first VARIANT ARRAY element and the GETPROP operation will retrieve the first variant array value.