Non-standard. Do not use!
This object is a Microsoft extension and is only supported in Internet Explorer.

The VBArray object provides access to Visual Basic safe arrays.

Syntax

varName = new VBArray(safeArray)

Parameters

varName
The variable name to which the VBArray is assigned.
safeArray
A VBArray value.

Remarks

VBArrays are read-only, and cannot be created directly. The safeArray argument must have obtained a VBArray value before being passed to the VBArray constructor. This can only be done by retrieving the value from an existing ActiveX or other object.

VBArrays can have multiple dimensions. The indices of each dimension can be different. The dimensions method retrieves the number of dimensions in the array; the lbound and ubound methods retrieve the range of indices used by each dimension.

Example

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 converts the Visual Basic safe array to a JavaScript array. 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  
         document.writeln(k)  
         k = k + 1  
      Next  
      document.writeln("<br />")  
   Next  
   CreateVBArray = a  
End Function  
-->  
</script>  

<script type="text/javascript">  
<!--  
function VBArrayTest(vbarray){  
   var a = new VBArray(vbarray);  
   var b = a.toArray();  
   var i;  
   for (i = 0; i < 9; i++)   
   {  
      document.writeln(b[i]);  
   }  
}  
-->  
</script>  
</head>  

<body>  
<script type="text/javascript">  
<!--  
   VBArrayTest(CreateVBArray());  
-->  
</script>  
</body>

Properties

The VBArray object has no properties.

Methods

VBArray.dimensions
Returns the number of dimensions in a VBArray.
VBArray.getItem
Returns the item at the specified location.
VBArray.lbound
Returns the lowest index value used in the specified dimension of a VBArray.
VBArray.toArray
Returns a standard JavaScript array converted from a VBArray.
VBArray.ubound
Returns the highest index value used in the specified dimension of the VBArray.

Requirements

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 8.x Store apps.

See also

Document Tags and Contributors

Contributors to this page: khorne3, erikadoyle
Last updated by: khorne3,