用法要点
- 数值用
Value 读写,范围由 MinValue 和 MaxValue 限定。
StepSize 是每次点箭头增减的步长,默认为 1。
- 点击上下箭头分别触发
OnUpButtonClick 和 OnDownButtonClick。
示例
摘自 Demo:MlSkin.Demo.滚动消息栏.v3.0(窗体文件 .dfm)
object se1: TMlSkinSpinEdit
Left = 211
Top = 34
Width = 58
Height = 26
Cursor = crIBeam
MinValue = 1
MaxValue = 1000
Value = 15
FontHint.Charset = DEFAULT_CHARSET
FontHint.Color = 11711154
FontHint.Height = -11
FontHint.Name = 'Tahoma'
FontHint.Style = []
BorderNormal = 'MlSkinBorderNormal'
BorderHot = 'MlSkinBorderHot'
Text = '15'
EdItems = <
...
属性 13
| 名称 | 类型 | 默认值 | 说明 |
|---|
MinValue | Integer | 0 | 允许的最小值。 |
MaxValue | Integer | 100 | 允许的最大值。 |
StepSize | Integer | 1 | 点一次上下箭头增减的步长,默认为 1。 |
Value | Integer | 0 | 当前数值,超出 MinValue~MaxValue 时会被限制回范围内。 |
FontHint | TFont | — | 提示文字的字体,通常设成比正文更浅的颜色。 |
BorderNormal | TMlResID | — | 正常状态的边框图片,填图片 ID 或路径。 |
BorderHot | TMlResID | — | 鼠标移上或获得焦点时的边框图片。 |
ReadOnly | Boolean | False | 只读,用户不能修改内容,但可以选中和复制。 |
Text | string | — | 控件中显示或输入的文字。 |
TextHint | string | — | 提示文字(占位符),内容为空时以浅色显示,例如「请输入关键字」。 |
MaxLength | Integer | 0 | 最多可输入的字符数,0 表示不限制。 |
EdItems | TMlEditItems | — | 输入框内部的小控件集合。每一项可设图片(正常/悬停/按下)、文字、位置、是否可见,用来做清空、搜索、显示密码一类的按钮。 |
Space | TMlSpaceSize | — | 文字与边框之间的内边距(左、上、右、下),需要先打开它的 Active。 |
事件 3
| 名称 | 类型 | 默认值 | 说明 |
|---|
OnUpButtonClick | TNotifyEvent | — | 点击向上箭头按钮时触发。 |
OnDownButtonClick | TNotifyEvent | — | 点击向下箭头按钮时触发。 |
OnChange | TNotifyEvent | — | 内容改变时触发。 |
TMlSkinPngEdit 的属性 3
| 名称 | 类型 | 默认值 | 说明 |
|---|
TextHintHideInKey | Boolean | False | 提示文字何时消失:打开后光标进入不消失,直到真正输入字符才隐藏。 |
CursorColor | TColor | clBlack | 光标(插入符)的颜色。 |
DisableIME | Boolean | False | 禁用输入法,只能输入英文和数字,适合账号、序列号一类的输入框。 |
TMlSkinCustomControl 的属性 5
| 名称 | 类型 | 默认值 | 说明 |
|---|
About | TMlAboutInfo | — | 设计期属性。在对象检查器里双击会弹出 MlSkin 的关于窗口,显示组件版本信息;运行时没有作用,也不会保存到 dfm。 |
Transparent | Boolean | True | 背景是否透明。打开后控件不画自己的底色,直接显示窗体的背景(图片或颜色)。 |
Color | TColor | clWhite | 控件的底色。Transparent 打开时不生效。 |
AutoInvalidate | Boolean | False | 内容变化时是否自动重绘。动态改属性看不到变化时可以打开。 |
EraseBackground | Boolean | False | 绘制前是否擦除背景。界面闪烁时可以调整这个开关。 |
TMlSkinCustomControl 的事件 4
| 名称 | 类型 | 默认值 | 说明 |
|---|
OnDPIChanged | TMlDPIChangedEvent | — | 屏幕 DPI 改变时触发(例如窗口被拖到另一块不同缩放的显示器上),可在这里重新调整自绘内容。 |
OnBackgroundChanging | TMlBackgroundEvent | — | 背景即将改变时触发,可在这里干预要绘制的背景。 |
OnBackgroundChanged | TMlCustomDrawEvent | — | 背景绘制完成后触发,可在背景之上继续自绘内容。 |
OnVisibleChanged | TNotifyEvent | — | 控件显示或隐藏时触发。 |
本页只列出 MlSkin 新增的属性和事件;Align、Anchors、Font、OnClick 等标准 VCL 属性同样可用,用法与原生控件一致。