comarray( ) 函数

请参阅

指定如何向 COM 对象传递数组。

语法

COMARRAY(oObject [, nNewValue])

返回值类型

数值型

参数

oObject

对 COM 对象的一个对象引用。

nNewValue

指定如何向 oObjec 指定的 COM 对象传递数组。下表列出了 nNewValue 的设置,以及数组是如何传递给 COM 对象的。

nNewValue 说明
0 数组是基于零的数组,并且按值传递。
1 (默认) 数组是基于一的数组,并且按值传递。与早期版本的 Visual FoxPro 兼容。
10 数组是基于零的数组,并且按引用传递。
11 数组是基于一的数组,并且按引用传递。

使用 COMARRAY()时不带 nNewValue 参数,可以返回当前设置。

说明

早期版本的 Visual FoxPro 只能向 COM 对象按值传递数组。另外,向 COM 对象传递的数组也是假设为基于一的,也就是说,数组中的第一个元素、行和列是用 1 引用的。

但是,有些 COM 对象需要将数组按引用传递给它们,或者数组是基于零的(数组中的第一个元素、行和列用 0 引用。),或者两者都需要。COMARRAY()允许您指定如何向 COM 对象传递数组,并且假设您知道应该如何向 COM 对象传递数组。

注意,只有当使用下列语法向 COM 对象传递数组时才能使用 COMARRAY(?:

oComObject.方法(@MyArray)

如果省略 @ 符号,则只向 COM 对象传递数组的第一个元素,COMARRAY()函数不起作用。