TMlSkinIconButtonList

用法要点

• 每格的大小用 ItemWidth 和基类的 ItemHeight 设定，间距用 ItemSpaceSize。
• AutoDrag 打开后可以拖动图标调整顺序；ShakeInEdit 让编辑状态下的图标抖动，提示可以拖动或删除。
• MultiChecked 打开后可以多选。
• 点击图标触发 OnClickItem，点击删除按钮触发 OnDeleteClick。

示例

摘自 Demo：MlSkin.Demo.按钮列表组件.v3.0（窗体文件 .dfm）

object lst1: TMlSkinIconButtonList
  Left = 14
  Top = 48
  Width = 361
  Height = 369
  Items = <>
  Images = il1
  ItemWidth = 60
  ItemHeight = 80
  ShakeInEdit = True
  OnClickItem = lst1ClickItem
  Anchors = [akLeft, akTop, akBottom]
end

属性 24

名称	类型	默认值	说明
AutoDrag	Boolean	True	是否允许拖动图标调整顺序。
AlignWithItems	TMlItemHAlign	ihaLeft	项目在控件内的水平对齐方式：ihaLeft 靠左、ihaCenter 居中、ihaRight 靠右。
CaptionVisible	Boolean	True	是否显示文字。做纯图标按钮时关掉。
CaptionWordWarp	Boolean	True	图标下方的文字是否换行显示。
Items	TMlIconButtonItems	—	控件的项目集合，在对象检查器里展开可逐项编辑。
Images	TCustomImageList	—	图标来源的 ImageList。
ItemWidth	Integer	—	每一项的宽度（像素）。
ItemHeight	Integer	—	每一项的高度（像素）。
ItemSpaceSize	Integer	10	项目之间的间距（像素）。
ItemHotImage	TMlResID	—	鼠标移到图标上时显示的背景图片。
MarginBorderSize	Integer	10	内容与控件边缘的间距（像素）。
MultiChecked	Boolean	True	是否允许同时选中多个图标。
ShakeInEdit	Boolean	False	编辑状态下图标是否抖动，用来提示可以拖动或删除（类似手机桌面的编辑模式）。
ScrollSize	Integer	30	滚动条的宽度（像素）。
PressedOffset	Integer	1	按下时内容向右下偏移的像素数，用来做按下去的效果，0 表示不偏移。
HideScrollbar	Boolean	False	是否隐藏滚动条（内容仍然可以滚动）。
Alpha	Byte	192	透明度，0 为完全透明、255 为不透明。
BorderSides	TSides	—	画哪几条边框（上、下、左、右可任意组合）。
BorderColor	TColor	$00D9CBBA	边框颜色。
Color	TColor	clWhite	控件的底色。Transparent 打开时不生效。
BackgroundImage	TMlResID	—	背景图片，填图片资源 ID 或图片文件路径。
BackgroundOffsetX	Integer	0	背景图片的横向偏移（像素）。
BackgroundOffsetY	Integer	0	背景图片的纵向偏移（像素）。
DoubleBorder	Boolean	True	双层边框，在边框内侧再画一条线。

事件 6

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

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 属性同样可用，用法与原生控件一致。