在“打开” 对话框中显示类库,并且创建一个包含该类库和所选类名称的数组。
语法
AGETCLASS(ArrayName [,cLibraryName [,cClassName [,cTitleText[,cFileNameCaption [,cButtonCaption]]]]])
返值类型
逻辑型
参数描述
指定数组的名称,在该数组中保存类库和类的名称。如果所指定的数组不存在,Visual FoxPro 会自动创建该数组。 如果该数组存在,但是大小不足以容纳类库和类的名称,则 Visual FoxPro 自动增加该数组的大小。如果该数组比所需的要大,则 Visual FoxPro 会截短该数组。如果该数组存在,并且由于关闭了“类库”对话框(通过按 ESC 键、选择了“取消”命令或单击了“关闭”按钮)而使 AGETCLASS() 返回了“假”(.F.),则该数组保持不变。如果该数组不存在,并且 AGETCLASS() 返回了“假” (.F.),则不创建该数组。
下表列出了当选择一个类时所创建数组的每个元素的内容。
| 元素 | 内容 |
| 1 | 所选类库的文件名。 |
| 2 | 所选取类的名称。 |
cLibraryName
指定当显示“打开”对话框时初始选中的类库的名称。所指定的类库的名称显示在“文件名”文本框中。如果所指定的类库不存在,或者 cLibraryName是空字符串或 null 值,则会产生一个错误。
cClassName
指定当显示“打开”对话框时在“类名”列表中初始选中的类的名称。如果所指定的类不存在,则选中“类名”列表中的第一个类。如果省略cLibraryName,或 cClassName 是 null 值,则会产生一个错误。
cTitleText
指定在“打开”对话框的标题栏显示的文本。在默认情况下,显示“打开”。
cFileNameCaption
指定在“文件名”文本框旁边显示的文本。在默认情况下,显示“文件名”。
cButtonCaption
指定 OK 按钮的标题。说明如果您选择了一个类,则 AGETCLASS()返回“真”(.T.),并且创建一个包含两个元素的一维数组。第一个元素包含所选类库的名称;第二个元素包含所选类的名称。如果退出了“类库”对话框(通过按 ESC 键、选择了“取消”命令或单击了“关闭”按钮,则返回“假”(.T.)。