Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

ubound Method (VBArray) (JavaScript)

Returns the highest index value used in the specified dimension of the VBArray.

safeArray.ubound(dimension)

safeArray

Required. A VBArray object.

dimension

Optional. The dimension of the VBArray for which the higher bound index is wanted. If omitted, ubound behaves as if a 1 was passed.

If the VBArray is empty, the ubound method returns undefined. If dim is greater than the number of dimensions in the VBArray, or is negative, the method generates a "Subscript out of range" error.

The following example consists of three parts. The first part is VBScript code to create a Visual Basic safe array. The second part is JavaScript code that determines the number of dimensions in the safe array and the upper bound of each dimension. Both of these parts go into the <HEAD> section of an HTML page. The third part is the JavaScript code that goes in the <BODY> section to run the other two parts.

<head>
<script type="text/vbscript">
<!--
Function CreateVBArray()
   Dim i, j, k
   Dim a(2, 2)
   k = 1
   For i = 0 To 2
      For j = 0 To 2
         a(j, i) = k
         k = k + 1
      Next
   Next
   CreateVBArray = a
End Function
-->
</script>

<script type="text/javascript">
<!--
function VBArrayTest(vba)
{
   var i;
   var a = new VBArray(vba);
   var s = "";
   for (i = 1; i <= a.dimensions(); i++)
   {
      s += "The upper bound of dimension ";
      s += i + " is ";
      s += a.ubound(i);
      s += ".<br />";
   }
   return (s);
}
-->
</script>
</head>

<body>
<script type="text/javascript">
   document.write(VBArrayTest(CreateVBArray()));
</script>
</body>

Supported in the following document modes: Quirks, Internet Explorer 6 standards, Internet Explorer 7 standards, Internet Explorer 8 standards, Internet Explorer 9 standards, and Internet Explorer 10 standards. Not supported in Windows Store apps. See Version Information.

Applies To: VBArray Object (JavaScript)

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft