TMlSkinTagsBox

用法要点

• 标签放在 Items 集合里，每项有文字、颜色、是否可用。
• DeleteButton 设置标签上的删除按钮外观，点击时触发 OnDeleteClick。
• 标签尺寸用 ItemHeight、ItemMinWidth 和 ItemSpaceSize 调整。
• 点击标签触发 OnClickItem；需要自定义标签外观时用 OnDrawItem 自绘。

示例

摘自 Demo：MlSkin.Demo.标记框(Tags)（窗体文件 .dfm）

object MlSkinTagsBox1: TMlSkinTagsBox
  Left = 8
  Top = 41
  Width = 424
  Height = 152
  Transparent = False
  RoundRadius = 14
  DeleteButton.Visible = False
  Items = <
  ...

属性 18

名称	类型	默认值	说明
RoundRadius	Integer	12	标签的圆角半径（像素）。
DeleteButton	TMlSkinColorControls_DeleteButton	—	标签上删除按钮的设置：图片、大小、是否显示。点击后触发 OnDeleteClick。
Items	TMlTagsBoxItems	—	标签集合。每一项可设文字、颜色、是否可用和是否显示。
ItemMinWidth	Integer	60	单个标签的最小宽度（像素）。
ItemHeight	Integer	25	标签的高度（像素）。
ItemSpaceSize	Integer	10	标签之间的间距（像素）。
MarginBorderSize	Integer	10	标签区域与控件边缘的间距（像素）。
ScrollSize	Integer	30	滚动条的宽度（像素）。
HideScrollbar	Boolean	False	是否隐藏滚动条（内容仍可滚动）。
Alpha	Byte	192	透明度，0 为完全透明、255 为不透明。
BorderSides	TSides	—	画哪几条边框（上、下、左、右可任意组合）。
BorderColor	TColor	$00D9CBBA	边框颜色。
Color	TColor	clWhite	控件的底色。Transparent 打开时不生效。
BackgroundFillType	TMlPngFillType	ftNormal	背景图片的铺法：ftNormal 原样、ftTile 平铺、ftAutoStretch 自动拉伸、ftCenter 居中、ftStretch 拉伸铺满、ftGradient 渐变。
BackgroundImage	TMlResID	—	背景图片，填图片资源 ID 或图片文件路径。
BackgroundOffsetX	Integer	0	背景图片的横向偏移（像素）。
BackgroundOffsetY	Integer	0	背景图片的纵向偏移（像素）。
DoubleBorder	Boolean	True	双层边框，在边框内侧再画一条线。

事件 7

名称	类型	默认值	说明
OnClickItem	TItem	—	点击某个标签时触发。
OnDrawItem	TMlTagsBoxItemDrawEnvent	—	绘制标签时触发，可自定义标签的外观。
OnDeleteClick	TItemDeleteEvent	—	点击标签上的删除按钮时触发，通常在这里把该项从 Items 中移除。
OnGetCursor	TMlGetCursorEvent	—	取鼠标指针形状时触发，可针对不同区域返回不同指针。
OnHotChanged	TItemHot	—	鼠标悬停的标签发生变化时触发。
OnFocusChanging	TStateChange	—	焦点标签即将改变时触发。
OnChanged	TNotifyEvent	—	状态或数值改变后触发。

TMlSkinCustomPanel 的事件 1

名称	类型	默认值	说明
OnCustomDraw	TMlCustomDrawEvent	—	自绘事件，可在控件画完后继续绘制自己的内容。

TMlSkinCustomControl 的属性 4

名称	类型	默认值	说明
About	TMlAboutInfo	—	设计期属性。在对象检查器里双击会弹出 MlSkin 的关于窗口，显示组件版本信息；运行时没有作用，也不会保存到 dfm。
Transparent	Boolean	True	背景是否透明。打开后控件不画自己的底色，直接显示窗体的背景（图片或颜色）。
AutoInvalidate	Boolean	False	内容变化时是否自动重绘。动态改属性看不到变化时可以打开。
EraseBackground	Boolean	False	绘制前是否擦除背景。界面闪烁时可以调整这个开关。

TMlSkinCustomControl 的事件 4

名称	类型	默认值	说明
OnDPIChanged	TMlDPIChangedEvent	—	屏幕 DPI 改变时触发（例如窗口被拖到另一块不同缩放的显示器上），可在这里重新调整自绘内容。
OnBackgroundChanging	TMlBackgroundEvent	—	背景即将改变时触发，可在这里干预要绘制的背景。
OnBackgroundChanged	TMlCustomDrawEvent	—	背景绘制完成后触发，可在背景之上继续自绘内容。
OnVisibleChanged	TNotifyEvent	—	控件显示或隐藏时触发。

本页只列出 MlSkin 新增的属性和事件；Align、Anchors、Font、OnClick 等标准 VCL 属性同样可用，用法与原生控件一致。