aardio 文档

win.ui.ctrl.datetimepick 库模块帮助文档

win.ui.ctrl 成员列表 #

win.ui.ctrl.datetimepick() #

时间控件

返回对象:datetimepickObject

datetimepickObject 成员列表 #

datetimepickObject._parentForm #

返回创建控件的容器窗口(win.form对象),所有窗口控件都拥有此只读属性。
对于使用窗体设计器创建的窗口,也就是返回设计时窗体容器。

即使子窗口移除子窗口样式、更改父子关系,或以 orphanWindow显示,
控件的 _parentForm 始终都不会改变

返回对象:winform

datetimepickObject.bottom #

底部坐标

datetimepickObject.capture #

是否捕获全局鼠标消息

datetimepickObject.checked #

或取设置控件选中状态
创建控件的参数中指定style=_DTS_SHOWNONE

datetimepickObject.className #

运行时类名

datetimepickObject.clientRect #

获取控件客户区块位置(::RECT结构体)

datetimepickObject.close() #

关闭控件窗口

datetimepickObject.cls #

设计时类名

datetimepickObject.disabled #

是否禁用

datetimepickObject.getClientRect() #

控件客户区块位置(::RECT结构体)

返回对象:rectObject

datetimepickObject.getFont() #

控件字体(::LOGFONT结构体)

返回对象:logfontObject

datetimepickObject.getParent() #

返回父窗口

返回对象:staticObject

datetimepickObject.getPos() #

返回相对坐标,宽,高
x,y,cx,cy=win.getPos(hwnd)

datetimepickObject.getRange() #

返回两个time()对象:时间范围下限,时间范围上限
如果未调用setRange()指定上限或下限,相应值返回为空

datetimepickObject.getRect() #

控件区块位置(::RECT结构体)

datetimepickObject.getRect(true) #

控件屏幕区块位置(::RECT结构体)

datetimepickObject.height #

高度

datetimepickObject.hwnd #

控件句柄

datetimepickObject.id #

控件ID

datetimepickObject.invalidate(/可选使用::RECT()对象指定客户区/) #

使窗口绘图区无效

datetimepickObject.invalidate(/可选使用::RECT()对象指定客户区/,0) #

使窗口绘图区无效
不刷新背景

datetimepickObject.left #

左侧坐标

datetimepickObject.modifyStyle(remove,add,swpFlags) #

修改窗口样式,所有参数都是可选参数,
@remove 用数值指定要移除的样式,可使用 WS 前缀的常量
@add 用数值指定要添加的样式,可使用 WS 前缀的常量
@swpFlags 可选用数值指定调整窗口选项,可使用 SWP 前缀的常量
如果指定了 @swpFlag ,则使用该参数调用::SetWindowPos
细节请参考 win.modifyStyle 函数源码

datetimepickObject.modifyStyleEx(remove,add,swpFlags) #

修改窗口扩展样式,所有参数都是可选参数,
@remove 用数值指定要移除的样式,可使用 WS_EX 前缀的常量
@add 用数值指定要添加的样式,可使用 WS_EX 前缀的常量
@swpFlags 可选用数值指定调整窗口选项,可使用 SWP 前缀的常量
如果指定了 @swpFlag ,则使用该参数调用::SetWindowPos
细节请参考 win.modifyStyle 函数源码

datetimepickObject.postMessage(msg,wParam,lParam) #

投递窗口消息到消息队列中
此函数用法请参考 ::User32.PostMessage

datetimepickObject.redraw() #

刷新

datetimepickObject.right #

右侧坐标

datetimepickObject.sendMessage(msg,wParam,lParam) #

发送窗口消息
此函数用法请参考 ::User32.SendMessage

datetimepickObject.setFocus() #

设置焦点

datetimepickObject.setFont(指定字体) #

指定LOGFONT字体对象,或逻辑字体句柄

datetimepickObject.setFont(混入字体属性) #

datetimepickObject.setFont(point=10;name="宋体");

datetimepickObject.setFormat("yyyy-MM-dd hh:m:s dddd") #

使用无百分号风格时间格式串,详细说明请参考 _DTM_SETFORMAT 消息文档。
除了空格和标点符号不需要用引号包围,
其他非格式化字符(例如中文字符或英文字母)必须包含在单引号中。

datetimepickObject.setParent(控件对象) #

改变父窗口

datetimepickObject.setPos(x坐标,y坐标,宽,高,插入位置,参数) #

调整窗口位置或排序,所有参数可选
同时指定x,y坐标则移动位置
同时指定宽高则改变大小
指定插入位置(句柄或_HWND前缀常量)则调整Z序

datetimepickObject.setRange(时间下限,时间上限) #

设置时间范围,参数为time()对象
可省略其中一个参数,仅指定下限或仅指定上限

datetimepickObject.setRect(rc) #

设置控件区块位置(::RECT结构体)

datetimepickObject.setRect(rc,true) #

设置控件屏幕区块位置(::RECT结构体)

datetimepickObject.show(true) #

显示控件

datetimepickObject.text #

控件文本,也就是格式化以后实际显示的时间字符串

datetimepickObject.theme #

外观主题,例如
winform.button.theme = "Explorer"
winform.button.theme = false

datetimepickObject.time #

获取或设置时间,值为 time 对象。
写入属性值时支持可使用 time 构造函数转换为时间对象的参数。
在读取此属性值时,保留上次设置此属性的时间对象使用的 format 字段

返回对象:timeObject

datetimepickObject.top #

顶部坐标

datetimepickObject.update() #

重绘invalidate函数指定的区块

datetimepickObject.value #

获取或设置时间,值为 time 对象。
写入属性值时支持可使用 time 构造函数转换为时间对象的参数。
在读取此属性值时,保留上次设置此属性的时间对象使用的 format 字段

返回对象:timeObject

datetimepickObject.visible #

当前控件窗口是否显示。
仅检查当前窗口的可见性样式(窗口 是否具有 _WS_VISIBLE 样式)。
不考虑父窗口是否可见,不考虑是否被其他窗口遮挡。
如果需要同时判断父窗口的可见性,应改用 win.isVisible 函数。

datetimepickObject.width #

宽度

datetimepickObject 事件列表 #

datetimepickObject.onDateTimeChanged #

datetimepickObject.onDateTimeChanged = function(dateTime,none){
    /*控件变更值回调此函数,  
dateTime 为变更后的 time 对象,  
none 为 1 则控件值为空,否则为有效时间*/ 
}

datetimepickObject.onFocusGot #

datetimepickObject.onFocusGot = function(){
    /*控件得到焦点回调此函数*/   
}

datetimepickObject.onFocusLost #

datetimepickObject.onFocusLost = function(){
    /*控件失去焦点回调此函数*/
}

自动完成常量

_DTM_GETMCFONT=0x100A
_DTM_GETMONTHCAL=0x1008
_DTM_SETMCFONT=0x1009
_DTN_CLOSEUP=0xFFFFFD0F
_DTN_DATETIMECHANGE=0xFFFFFD09
_DTN_DROPDOWN=0xFFFFFD0E
_DTN_FIRST2=0xFFFFFD0F
_DTN_WMKEYDOWN=0xFFFFFD0B
_DTS_SHOWNONE=2

Markdown 格式