TMlSkinComboBoxEx

用法要点

• 候选项放在 Values 里，勾选状态改变时触发 OnCheckStateChanged。
• 适合做多选筛选条件一类的界面，选完的内容会显示在输入框中。

示例

摘自 Demo：MlSkin.Demo.增强下拉列表功能演示.v5.x（窗体文件 .dfm）

object MlSkinComboBoxEx2: TMlSkinComboBoxEx
  Left = 8
  Top = 139
  Width = 137
  Height = 26
  Cursor = crIBeam
  TextHintHideInKey = True
  DisableIME = True
  BorderNormal = 'MlSkinBorderNormal'
  BorderHot = 'MlSkinBorderHot'
  Items.Strings = (
  'Travel'
  'Beverage'
  'Automotive'
  'Education'
  'CPG'
  'Government'
  'Nonprofit'
  'Email'
  'Event Screen'

属性 13

名称	类型	默认值	说明
BorderNormal	TMlResID	—	正常状态的边框图片，填图片 ID 或路径。
BorderHot	TMlResID	—	鼠标移上或获得焦点时的边框图片。
BorderVisible	Boolean	True	是否显示边框。
CharCase	TEditCharCase	ecNormal	字母大小写转换：原样、全大写或全小写。
Items	TStrings	—	控件的项目集合，在对象检查器里展开可逐项编辑。
ItemIndex	Integer	-1	当前选中项的序号，从 0 开始，-1 表示没有选中。
ItemHeight	Integer	23	每一项的高度（像素）。
Style	TMlSkinCustomComboBoxStyle	csDropDown	绘制样式。
Options	TComboBoxExOptions	—	该控件的一组选项设置，展开后可分别调整。
Values	TStrings	—	下拉候选项列表，每一项前面带勾选框。
Text	string	—	控件中显示或输入的文字。
EdItems	TMlEditItems	—	输入框内部的小控件集合。每一项可设图片（正常/悬停/按下）、文字、位置、是否可见，用来做清空、搜索、显示密码一类的按钮。
FontHint	TFont	—	提示文字的字体，通常设成比正文更浅的颜色。

事件 4

名称	类型	默认值	说明
OnChange	TNotifyEvent	—	内容改变时触发。
OnCheckStateChanged	TItemCheckStateChangedEvent	—	某一项的勾选状态改变时触发。
OnCloseUp	TNotifyEvent	—	下拉列表收起时触发。
OnDropDown	TNotifyEvent	—	下拉列表弹出时触发。

TMlSkinPngEdit 的属性 4

名称	类型	默认值	说明
TextHint	string	—	提示文字（占位符），内容为空时以浅色显示，例如「请输入关键字」。
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 属性同样可用，用法与原生控件一致。