Function Reference

首页  后退  前进

GUICtrlCreateInput

 

创建输入框(Input)控件.

 

GUICtrlCreateInput ( "text", left, top [, width [, height [, style = -1 [, exStyle = -1]]]] )

参数

text

控件显示的文本.

left

控件左侧的位置. 若此值为 -1, 则根据 GUICoordMode() 的设置计算左侧位置.

top

控件上方的位置. 若此值为 -1, 则根据 GUICoordMode() 的设置计算顶部位置.

width

[可选] 控件的宽度(默认使用先前的宽度).

height

[可选] 控件的高度(默认使用先前的高度).

style

[可选] 控件的样式. 查看附录 GUI 控件样式表.

默认样式 ( -1) : $ES_LEFT, $ES_AUTOHSCROLL

强制样式 : 如果没有 $ES_READONLY 则仅有 $WS_TABSTOP. $ES_MULTILINE 始终重置.

exStyle

[可选] 控件的扩展样式. 查看附录 扩展样式表.

默认值 ( -1) : $WS_EX_CLIENTEDGE

返回值

成功:

返回控件标识符(控件ID).

失败:

返回 0.

备注

要获得控件的值, 查看 GUICtrlRead().

设置或者修改控件信息, 参考 GUICtrlUpdate...() 函数.

 

定义输入密码(输入字符将被星号隐藏)的输入框控件, 则请使用 $ES_PASSWORD 样式.

 

如果要让控件接受文件拖放, 添加 WS_EX_ACCEPTFILES 扩展样式GUICreate() 并设置状态为 $GUI_DROPACCEPTED.

拖动多个文件会被 "|" 分割开, 可以使用 GUICtrlRead() 读取文件名称.

 

使用上面列出的值必须将 #include <EditConstants.au3> 语句写入脚本中.

 

默认大小 $GUI_DOCKHEIGHT.

相关

GUICoordMode (Option), GUICtrlCreateUpdown, GUICtrlRead, GUICtrlSetLimit, GUICtrlUpdate..., GUIGetMsg

函数示例

#include <GUIConstantsEx.au3>
#include <MsgBoxConstants.au3>
#include <WindowsConstants.au3>
Example()
Func Example()
    GUICreate(" My GUI input acceptfile", 320, 120, @DesktopWidth / 2 - 160, @DesktopHeight / 2 - 45, -1, $WS_EX_ACCEPTFILES)
    Local $idFile = GUICtrlCreateInput("", 10, 5, 300, 20)
    GUICtrlSetState(-1, $GUI_DROPACCEPTED)
    GUICtrlCreateInput("", 10, 35, 300, 20) ; will not accept drag&drop files
    Local $idBtn = GUICtrlCreateButton("Ok", 40, 75, 60, 20)
    GUISetState(@SW_SHOW)
    ; Loop until the user exits.
    While 1
        Switch GUIGetMsg()
            Case $GUI_EVENT_CLOSE
                ExitLoop
            Case $idBtn
                ExitLoop
        EndSwitch
    WEnd
    MsgBox($MB_SYSTEMMODAL, "drag drop file", GUICtrlRead($idFile))
EndFunc   ;==>Example

----------------------------------------