TMlSkinSearchEdit

用法要点

• 候选内容放在 Items 里，输入过程中自动筛选并弹出下拉列表。
• Options 里可设下拉列表的宽高、行高、选中颜色，以及是否启用拼音过滤（输入首字母匹配中文项）。
• 下拉弹出和收起分别触发 OnDropDown 和 OnCloseUp。

示例

摘自 Demo：MlSkin.QQ聊天软件.v3.0（窗体文件 .dfm）

object edt4: TMlSkinSearchEdit
  Left = 0
  Top = 60
  Width = 235
  Height = 27
  Cursor = crIBeam
  Margins.Left = 1
  Margins.Top = 1
  Margins.Right = 1
  Margins.Bottom = 2
  TextHint = 'TextHint'
  FontHint.Charset = DEFAULT_CHARSET
  FontHint.Color = 11711154
  FontHint.Height = -11
  FontHint.Name = 'Tahoma'
  FontHint.Style = []
  BorderNormal = 'MlSkinBorderNormal'
  BorderHot = 'MlSkinBorderHot'
  EdItems = <
  ...

属性 11

名称	类型	默认值	说明
FontHint	TFont	—	提示文字的字体，通常设成比正文更浅的颜色。
BorderNormal	TMlResID	—	正常状态的边框图片，填图片 ID 或路径。
BorderHot	TMlResID	—	鼠标移上或获得焦点时的边框图片。
ReadOnly	Boolean	False	只读，用户不能修改内容，但可以选中和复制。
Text	string	—	控件中显示或输入的文字。
TextHint	string	—	提示文字（占位符），内容为空时以浅色显示，例如「请输入关键字」。
MaxLength	Integer	0	最多可输入的字符数，0 表示不限制。
EdItems	TMlEditItems	—	输入框内部的小控件集合。每一项可设图片（正常/悬停/按下）、文字、位置、是否可见，用来做清空、搜索、显示密码一类的按钮。
Space	TMlSpaceSize	—	文字与边框之间的内边距（左、上、右、下），需要先打开它的 Active。
Items	TStrings	—	候选项列表。输入时按内容筛选并弹出下拉列表。
Options	TSEPopupListOptions	—	下拉列表的设置：宽度、高度、行高、选中项与普通项的颜色和字体颜色、边框颜色，以及是否启用拼音过滤（输入拼音首字母匹配中文项）。

事件 3

名称	类型	默认值	说明
OnChange	TNotifyEvent	—	内容改变时触发。
OnCloseUp	TNotifyEvent	—	下拉列表收起时触发。
OnDropDown	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 属性同样可用，用法与原生控件一致。