| 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并指定自定义对话框状态来返回其他值。
如果指定的表单是任何类型的无模式对话框,此函数将立即返回,并返回一个对话框标识符,每次创建一个新对话框时它都会递增。
如果指定的窗体是文件对话框,则该函数在对话框关闭之前不会返回。如果文件对话框允许多重选择,则返回所选文件名的列表;否则返回单个选定的文件名作为字符串。