TMlSkinToolbar

用法要点

• 按钮在 Items 集合里添加，每项可设文字、图标序号、类型（普通按钮 / 分隔条等）、是否可用。
• 图标来自 Images（标准 ImageList）或 ButtonImage（多状态图片）。
• 按钮尺寸用 ButtonWidth、ButtonHeight；打开 AutoButtonWidth 则按文字长度自动决定宽度，MaxButtonWidth 限制上限。
• 工具栏放不下时会出现滚动按钮，ScrollButtonVisible 控制是否显示、ScrollSize 设定滚动按钮大小。
• 背景可以用颜色加透明度（Alpha），也可以用 BackgroundImage 贴图，贴法由 BackgroundFillType 决定。
• 点击按钮触发 OnItemClick，事件参数里带着被点的项。

示例

摘自 Demo：MlSkin.Demo.360云盘.v3.0（窗体文件 .dfm）

object mlskntlbr1: TMlSkinToolbar
  Left = 0
  Top = 0
  Width = 201
  Height = 586
  Color = 16644854
  Items = <
  ...

属性 28

名称	类型	默认值	说明
AllowArrowKeys	Boolean	False	是否允许用方向键在按钮之间移动焦点。
AutoButtonWidth	Boolean	False	按钮宽度是否随文字长度自动调整；关掉则统一使用 ButtonWidth。
DelayRefresh	Boolean	False	延迟刷新。批量修改按钮时打开可减少重绘次数。
TextOffset	TMlBtnItemOffset	—	按钮文字的偏移量（X、Y）。
Items	TMlSkinToolbarItems	—	工具栏上的按钮集合。每一项可设文字、图标序号（正常/悬停/按下/禁用）、类型、是否可用、是否按下，以及关联的 Action。
Images	TCustomImageList	—	按钮图标来源的 ImageList，项里的图标序号就是指向这个列表。
ButtonImage	TPngPictures	—	按钮底图（多状态图片），决定按钮正常、悬停、按下时的背景。
ButtonWidth	Integer	48	按钮宽度（像素）。
MaxButtonWidth	Integer	0	按钮最大宽度（像素），0 表示不限制。打开 AutoButtonWidth 后用它防止按钮过宽。
ButtonHeight	Integer	48	按钮高度（像素）。
SpaceSize	Integer	3	按钮之间的间距（像素）。
MultiLine	Boolean	False	按钮放不下时是否换行显示。
DropdownMenuOffset	TMlBtnItemOffset	—	下拉菜单弹出位置的偏移量（X、Y）。
ScrollSize	Integer	15	两端滚动按钮的大小（像素）。
ScrollButtonVisible	Boolean	True	按钮放不下时是否显示两端的滚动按钮。
MarginSize	Integer	20	工具栏内容与边缘的间距（像素）。
MarginTextSize	Integer	2	图标与文字之间的间距（像素）。
PressedOffset	Integer	0	按钮按下时内容偏移的像素数。
Alpha	Byte	192	工具栏背景的透明度，0 为完全透明、255 为不透明。
BorderSides	TSides	—	画哪几条边框（上、下、左、右可任意组合）。
BorderColor	TColor	$00D9CBBA	边框颜色。
BackgroundImage	TMlResID	—	工具栏背景图片，填图片 ID 或路径。
BackgroundFillType	TMlPngFillType	ftNormal	背景图片的铺法：原样、平铺、自动拉伸、居中、拉伸、渐变。
BackgroundOffsetX	Integer	0	背景图片的横向偏移（像素）。
BackgroundOffsetY	Integer	0	背景图片的纵向偏移（像素）。
DoubleBorder	Boolean	True	双层边框，在边框内侧再画一条线。
FontHot	TFont	—	鼠标移上去时使用的字体。
FontDown	TFont	—	按下时使用的字体。

事件 5

名称	类型	默认值	说明
OnItemClick	TToolbarClickEvent	—	点击按钮时触发，事件参数里带着被点击的项。
OnItemDown	TToolbarClickEvent	—	按钮被按下时触发（早于点击完成）。
OnItemFocusChanged	TNotifyEvent	—	焦点在按钮之间移动时触发。
OnDrawItem	TMlToolbarItemDrawEnvent	—	自绘按钮事件，需要自己画某一项时使用。
OnButtonWidthChanged	TToolbarButtonWidthEvent	—	按钮宽度变化后触发（多在 AutoButtonWidth 打开时）。

TMlSkinCustomPanel 的属性 1

名称	类型	默认值	说明
Color	TColor	clWhite	控件的底色。Transparent 打开时不生效。

TMlSkinCustomPanel 的事件 1

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

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