XLL+ Class Library (7.0)

XlBoundPart Element

The XlBoundPart element represents the lower or upper bound of a dimension. The element can contain any or all of the following attributes: HasFixedSize, FixedSize and NamedBound. For a lower bound, the element should contain either no attributes or HasFixedSize=true and FixedSize=1. The latter case represents a 1-based array; the former case a normal 0-based array. For an upper bound, if HasFixedSize=true and FixedSize is present, then the dimension will be constrained to be of size FixedSize, and a run-time error will be generated if it is not. If NamedBound is present, then a variable will be created with the specified name, and will be set to the size of the dimension at run-time. If NamedBound is shared with any other dimension of this or of another argument, then the bounds will be constrained to be of the same size, and a run-time error will be generated if they are not.

Attributes

HasFixedSize

If HasFixedSize is set to true, then the bound will fixed to the value set in FixedSize. If it is false or omitted, then FixedSize will be ignored, and the bound will not be constrained.

FixedSize

For a lower bound, this value represents the base value of an array, and may be 0 or 1. For an upper bound, this value represents the expected size of the array in this dimension; if the array is not of this size, then an error will be raised at run-time. If HasFixedSize is false or omitted, then FixedSize will be ignored, and the bound will not be constrained.

NamedBound

If NamedBound is present in an upper bound, then a variable will be created with the specified name, and will be set to the size of the dimension at run-time. If NamedBound is shared with any other dimension of this or of another argument, then the bounds will be constrained to be of the same size, and a run-time error will be generated if they are not. NamedBound is ignored for lower bounds.

Element Information

Number of occurrences

Unlimited

Parent elements

Parts 

Child elements

(No child elements)

See Also

XLL+ Function Schema