TMlSkinCountBar

翻页栏控件,显示页码和上一页、下一页按钮,用于分页浏览。

分类
列表与下拉框
所在单元
uMlSkinCountBar.pas
继承自
TMlSkinCustomCountBarTMlSkinCustomIconButtonListTMlSkinCustomPanelTMlSkinCustomControl

用法要点

  • 总页数用 NumCount 设定;点上一页、下一页分别触发 OnPreviousClickOnNextClick
  • 页码改变时触发 OnNumChanged,在这里加载对应页的数据。
  • Kinds 决定显示哪些部分(页码、上下页按钮、跳转框等)。
  • 普通页码和当前页的颜色、字体分开设置:ColorNormalColorFocusFontFocus

示例

摘自 Demo:MlSkin.Demo.翻页栏+透明背景ListBox.v.3.0(窗体文件 .dfm)

object mlcb1: TMlSkinCountBar
  Left = 1
  Top = 428
  Width = 591
  Height = 34
  Color = 16185078
  FontFocus.Charset = DEFAULT_CHARSET
  FontFocus.Color = clWhite
  FontFocus.Height = -13
  FontFocus.Name = 'Tahoma'
  FontFocus.Style = []
  ColorNormal = clWhite
  OnSkipClick = mlcb1SkipClick
  OnNumChanged = mlcb1NumChanged
  Font.Charset = DEFAULT_CHARSET
  Font.Color = clWindowText
  Font.Height = -13
  Font.Name = 'Tahoma'
  Font.Style = []
  Alpha = 196

属性 20

名称类型默认值说明
AlignWithItemsTMlItemHAlignihaLeft项目在控件内的水平对齐方式:ihaLeft 靠左、ihaCenter 居中、ihaRight 靠右。
AlignVerticalWithItemsTMlItemVAlignihavTop项目在控件内的垂直对齐方式:顶端、居中或底端。
CaptionVisibleBooleanTrue是否显示文字。做纯图标按钮时关掉。
ItemWidthInteger每一项的宽度(像素)。
ItemHeightInteger每一项的高度(像素)。
ItemSpaceSizeInteger10项目之间的间距(像素)。
MarginBorderSizeInteger10内容与控件边缘的间距(像素)。
KindsTCountKinds翻页栏显示哪些部分,可多选:页码、上一页/下一页按钮、跳转输入框等。
NumCountCardinal5总页数。
FontFocusTFont当前页码的字体。
ColorNormalTColor$00EEEEEE普通页码的底色。
ColorFocusTColor$004966FE当前页码的底色。
AlphaByte192透明度,0 为完全透明、255 为不透明。
BorderSidesTSides画哪几条边框(上、下、左、右可任意组合)。
BorderColorTColor$00D9CBBA边框颜色。
ColorTColorclWhite控件的底色。Transparent 打开时不生效。
BackgroundImageTMlResID背景图片,填图片资源 ID 或图片文件路径。
BackgroundOffsetXInteger0背景图片的横向偏移(像素)。
BackgroundOffsetYInteger0背景图片的纵向偏移(像素)。
DoubleBorderBooleanTrue双层边框,在边框内侧再画一条线。

事件 8

名称类型默认值说明
OnDrawItemTMlIconButtonItemDrawEnvent绘制某一项时触发,可以自定义该项的外观。
OnGetCursorTMlGetCursorEvent取鼠标指针形状时触发,可针对不同区域返回不同指针。
OnHotChangedTItemHot鼠标悬停的项目发生变化时触发。
OnFocusChangingTStateChange焦点项目即将改变时触发。
OnNextClickTNotifyEvent点击「下一页」时触发。
OnPreviousClickTNotifyEvent点击「上一页」时触发。
OnSkipClickTNotifyEvent使用跳转框跳到指定页时触发。
OnNumChangedTNotifyEvent当前页码改变后触发,在这里加载该页的数据。
TMlSkinCustomPanel 的事件 1
名称类型默认值说明
OnCustomDrawTMlCustomDrawEvent自绘事件,可在控件画完后继续绘制自己的内容。
TMlSkinCustomControl 的属性 4
名称类型默认值说明
AboutTMlAboutInfo设计期属性。在对象检查器里双击会弹出 MlSkin 的关于窗口,显示组件版本信息;运行时没有作用,也不会保存到 dfm。
TransparentBooleanTrue背景是否透明。打开后控件不画自己的底色,直接显示窗体的背景(图片或颜色)。
AutoInvalidateBooleanFalse内容变化时是否自动重绘。动态改属性看不到变化时可以打开。
EraseBackgroundBooleanFalse绘制前是否擦除背景。界面闪烁时可以调整这个开关。
TMlSkinCustomControl 的事件 4
名称类型默认值说明
OnDPIChangedTMlDPIChangedEvent屏幕 DPI 改变时触发(例如窗口被拖到另一块不同缩放的显示器上),可在这里重新调整自绘内容。
OnBackgroundChangingTMlBackgroundEvent背景即将改变时触发,可在这里干预要绘制的背景。
OnBackgroundChangedTMlCustomDrawEvent背景绘制完成后触发,可在背景之上继续自绘内容。
OnVisibleChangedTNotifyEvent控件显示或隐藏时触发。

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

离线帮助文档需要离线查阅时,可下载 PDF / CHM 版帮助文档。