TMlSkinPasswordEdit

用法要点

• PasswordChar 指定用哪张图片代替字符显示（不是普通的星号字符，而是图标）。
• ShowPassword 打开后显示明文，常配合输入框内的「眼睛」图标做切换。
• XSpace、YSpace 调整密码图标之间的间距和上下位置。

示例

摘自 Demo：MlSkin.Demo.QQ登陆界面.v3.0（窗体文件 .dfm）

object edt2: TMlSkinPasswordEdit
  Left = 132
  Top = 53
  Width = 194
  Height = 30
  Cursor = crIBeam
  PasswordChar = 'MlSkinPasswordchar'
  Font.Charset = DEFAULT_CHARSET
  Font.Color = clWindowText
  Font.Height = -13
  Font.Name = 'Tahoma'
  Font.Style = []
  FontHint.Charset = DEFAULT_CHARSET
  FontHint.Color = 11711154
  FontHint.Height = -11
  FontHint.Name = 'Tahoma'
  FontHint.Style = []
  BorderNormal = '.\Res\edit_frame_normal.png'
  BorderHot = '.\Res\edit_frame_hover.png'
  EdItems = <

属性 16

名称	类型	默认值	说明
XSpace	Integer	2	密码图标之间的横向间距（像素）。
YSpace	Integer	4	密码图标的纵向偏移（像素），用来让图标垂直居中。
PasswordChar	TMlResID	—	代替字符显示的图片（圆点、星号等图标），填图片 ID 或路径。
ShowPassword	Boolean	False	是否显示明文。打开后直接显示输入的内容，常用于「显示密码」开关。
CharCase	TEditCharCase	ecNormal	字母大小写转换：原样、全大写或全小写。
FontHint	TFont	—	提示文字的字体，通常设成比正文更浅的颜色。
BorderNormal	TMlResID	—	正常状态的边框图片，填图片 ID 或路径。
BorderHot	TMlResID	—	鼠标移上或获得焦点时的边框图片。
BorderVisible	Boolean	True	是否显示边框。
ReadOnly	Boolean	False	只读，用户不能修改内容，但可以选中和复制。
Tips	TMlSkinEditTips	—	输入提示气泡的设置：边框色、底色、字体和停留时间，用于在输入框旁弹出提示。
Text	string	—	控件中显示或输入的文字。
TextHint	string	—	提示文字（占位符），内容为空时以浅色显示，例如「请输入关键字」。
MaxLength	Integer	0	最多可输入的字符数，0 表示不限制。
EdItems	TMlEditItems	—	输入框内部的小控件集合。每一项可设图片（正常/悬停/按下）、文字、位置、是否可见，用来做清空、搜索、显示密码一类的按钮。
Space	TMlSpaceSize	—	文字与边框之间的内边距（左、上、右、下），需要先打开它的 Active。

事件 1

名称	类型	默认值	说明
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 属性同样可用，用法与原生控件一致。