Microsoft® JScript™ VBArray Object | Language Reference Version 3

See Also Methods Properties

##### Description

> Provides access to Visual Basic safe arrays.

##### Syntax

> new VBArray(safeArray)

> The safeArray is 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.

> The following example consists of three parts. The first part is VBScript code to create a Visual Basic safe array. The second part is JScript code that converts the VB safe array to a JScript array. Both of these parts go into the <HEAD> section of an HTML page. The third part is the JScript code that goes in the <BODY> section to run the other two parts.

> >     <HEAD>
> >     <SCRIPT LANGUAGE="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 LANGUAGE="JScript">
> >     <!--
> >     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 LANGUAGE="JScript">
> >     <!--
> >       VBArrayTest(CreateVBArray());
> >     -->
> >     </SCRIPT>
> >     </BODY>

© 1998 Microsoft Corporation. All rights reserved. Terms of Use.