Form-Show

Function Name dcl-Form-Show
Syntax   (dcl-Form-Show <CONTROL> {PositionX [as Long]} {PositionY [as Long]})
Syntax  
(File Dialog)
(dcl-Form-Show <CONTROL> {InitialDirectory [as String]} {InitialFilename [as String]} {DefaultExtension [as String]})
Return Type Long, String, or List of Strings
Applies To Control Bar, File Dialog, Modal Dialog, Modeless Dialog, Palette

此方法实例化一个新的OpenDCL对话框窗体。如果包含可选的PositionX和PositionY参数,则表单的初始位置为PositionX,PositionY(在父窗口客户端坐标中指定)。文件对话框使用备用语法,分别具有初始目录,初始文件名和默认文件扩展名的可选参数。

如果指定的窗体是模态对话框,则该函数不会返回,直到对话框关闭,并返回一个长的值,指示对话框状态。如果对话框被取消(例如通过按[Esc]),返回值为2;如果通过按[Enter]键关闭,则返回值为1.可以通过从事件处理程序调用Form-Close并指定自定义对话框状态来返回其他值。

如果指定的表单是任何类型的无模式对话框,此函数将立即返回,并返回一个对话框标识符,每次创建一个新对话框时它都会递增。

如果指定的窗体是文件对话框,则该函数在对话框关闭之前不会返回。如果文件对话框允许多重选择,则返回所选文件名的列表;否则返回单个选定的文件名作为字符串。