样式控件
# Smart 控件使用(样式控件)
样式控件组中包含使用经典绘图、系统主题、GDI+与样式的控件,可提高制作的程序的美观性。
# 1. TscLabel
这是一个标签组件,包含了 TLabel 组件的属性与发光效果。使用 StyleElements
属性可以调整所有控件中客户端和字体的自定义颜色。以下主要介绍组件中的专有特性。
# 1.1. 属性
属性 | 功能说明 |
---|---|
GlowEffect | 调整标签的发光属性 |
ShowEllipsis | 如果此项设置为 True ,则当标签的 AutoSize 属性设置为 False 时,当文本显示长度超过标签长度时会显示省略号。 |
UseFontColorToStyleColor | 如果为 True ,则文本的颜色 Font.Color 会作为样式颜色 |
VertAlignment | 设置标签中文字垂直方向的对齐方式。scvtaTop :顶部对齐scvtaCenter :垂直居中对齐scvtaBottom :底部对齐 |
# 1.1.1. GlowEffect
property GlowEffect: TscGlowEffect;
设定控件的发光效果。
属性 | 功能说明 |
---|---|
AlphaValue | 发光的Alpha通道透明度,取值为 0-255 |
Color | 发光的颜色 |
Enabled | 设定是否启用发光效果 |
GlowSize | 发光的光晕范围 |
IntenSive | 如果设定为 True 则启用更强烈的发光效果 |
Offset | 发光效果的偏移量 |
StyleColors | 如果为 True ,则当样式处于活动状态时,TscGlowEffect 会自动调整颜色。 例如,如果您设置 Color = clHighLight 那么您将从样式中获得 clHighLight 颜色 |
# 2. TscButton
按钮控件,包含了 TButton 的基本属性事件方法,增加了许多样式与额外的特性。使用 StyleElements
属性可以调整所有控件中客户端和字体的自定义颜色。
# 2.1. 属性
属性 | 功能说明 |
---|---|
AllowAllUp | 指定是否可以同时取消选择包含此按钮的组中的所有按钮 |
Animation | 是否在按钮上启用动画效果 |
ArrowDirection | 设定按钮中箭头的方向。scadDefault :默认设置scadRight :右侧,下拉菜单位置也将从右侧开始 |
ArrowPosition | 设定按钮中箭头的位置。scapRight :右侧scapBottom :底部 |
CanFocused | 设定按钮是否允许对焦 |
ColorOptions | 使用 StyleKind = scbsColorButton 调整按钮的属性(所有按钮状态(正常、热状态、按下、聚焦禁用)的主体颜色、框架和字体)。 如果颜色值为 clNone 则颜色是透明的。还可以使用 StyleColors (默认值为 True )属性从样式中调整颜色(例如,如果您将某些颜色设置为 clBtnFace 或 clHighLight ,则按钮将从样式中获取此颜色。 |
CustomDropDown | 如果设定为 True ,则按钮可与下拉表单一起运用 |
CustomImageNormalIndex CustomImageHotIndex CustomImagePressedIndex CustomImageFocusedIndex CustomImageDisabledIndex | 不同按钮状态下选择的图片的索引号 |
CustomImages | TscImageCollection 组件。 位图属性必须在所有项目中定义,将用于自定义样式 |
Down | 设置是否保持按下的状态 |
FocusedImageIndex | 当图片处于聚焦状态时显示的图片序号 |
GalleryMenu | 绑定的 TscGalleryMenu 组件名称 |
GlowEffect | 调整按钮的发光属性 |
GroupIndex | 按钮组中的序号 |
HotImageIndex | 处于热状态的图片序号 |
ImageGlow | 是否启用图片发光效果 |
ImageIndex | 正常状态显示的图片序号 |
ImageMargin | 在按钮中定义图像区域(将忽略边距属性) |
Images | 选择图像组控件 |
Margin | 设置文本与图片之间的距离 (-1 表示文本与图片居中) |
PressedImageIndex | 按钮按下时显示的图片序号 |
RepeatClick | 在按下按钮时,启用重复 OnClick 事件 |
RepeatClickInterval | 定时器重复 OnClick 事件的时间间隔 |
ShowCaption | 设定是否在按钮上显示字幕 |
ShowFocusRect | 如果为 True ,则按钮绘制焦点矩形 |
ShowGalleryMenuFromTop | GalleryMenu 将从按钮顶部显示 |
ShowGalleryMenuFromRight | GalleryMenu 将从按钮右侧显示 |
ShowMenuArrow | 如果 GalleryMenu <> nil 或 DropDownMenu <> nil 那么箭头将在按钮上可见 |
Spacing | 图片与文本的间距 |
SplitButton | 如果为 True,则按钮具有用于下拉菜单的拆分器 |
StyleKind | 按钮的样式 |
Title | 按钮显示的标题 |
TitleFont | 按钮标题显示的文本 |
TransparentBackground | 设置是否使用透明背景 |
UseGalleryMenuCaption | 如果为 True,则按钮使用来自 GalleryMenu 项目的文字 |
UseGalleryMenuImage | 如果为 True,则按钮使用来自 GalleryMenu 项目的图像 |
UseImageIndexFromAction | 如果为 True,则控件将使用动作中的图像索引 |
UseImagesFromAction | 如果为 True,则控件将使用动作中的图像 |
WidthWithCaption WidthWithoutCaption | 设置 ShowCaption 属性时使用这些按钮宽度值 |
WordWarp | 是否使用自动换行 |
# 2.1.1. GlowEffect
设置按钮的发光效果。
属性 | 功能说明 |
---|---|
AlphaValue | 发光的Alpha通道透明度,取值为 0-255 |
Color | 发光的颜色 |
Enabled | 设定是否启用发光效果 |
FocusedColor | 设定按钮处于对焦状态时显示的颜色 |
GlowSize | 发光的光晕范围 |
IntenSive | 如果设定为 True 则启用更强烈的发光效果 |
Offset | 发光效果的偏移量 |
PressedAlphaValue | 当按钮按下时设定的发光的Alpha通道透明度,取值为 0-255 |
StyleColors | 如果为 True ,则当样式处于活动状态时,TscGlowEffect 会自动调整颜色。 例如,如果您设置 Color = clHighLight 那么您将从样式中获得 clHighLight 颜色 |
PressedColor | 控件在按下状态时显示的颜色 |
PressedGlowSize | 按钮在按下时显示的光晕的大小 |
States | 设置是否启用效果状态。scsNormal :是否使用正常状态的显示效果。scsHot :是否使用处于热状态的显示效果。scsPressed :是否使用按下状态的显示效果。scsFocused :设置是否使用对焦状态显示的效果。scsDisabled :设置是否使用禁用状态显示效果 |
# 3. TscCheckBox
包含了 TCheckBox 的属性事件方法,同时额外增加图像、不同类型与效果。
# 3.1. 属性
属性 | 功能说明 |
---|---|
AllowGrayed | 启用 cbGrayed 状态,即 State 状态中可选灰色 |
Animation | 是否在控件中启用动画 |
CanFocused | 设定控件是否允许对焦 |
Checked | 控件是否处于勾选状态 |
CustomCheckedImageIndex CustomCheckedImageHotIndex CustomCheckedImagePressedIndex CustomCheckedImageDisabledIndex CustomUnCheckedImageIndex CustomUnCheckedImageHotIndex CustomUnCheckedImagePressedIndex CustomUnCheckedImageDisabledIndex CustomGrayedImageIndex CustomGrayedImageHotIndex CustomGrayedImagePressedIndex CustomGrayedImageDisabledIndex | 设置所有状态下显示的图片的序号 |
CustomImages | TscImageCollection 组件。 位图属性必须在所有项目中定义,您将用于自定义样式 |
GlowEffect | 调整控件的发光属性 |
ImageGlow | 是否启用图片发光效果 |
ImageIndex | 正常状态显示的图片序号 |
Images | 选择图像组控件 |
Layout | 图像的布局方式blGlyphLeft :设置图像在左侧blGlyphBottom :设置图像在底部blGlyphRight :设置图像在右侧blGlyphTop :设置图像在顶部 |
ShowFocusRect | 如果为 True ,则控件绘制焦点矩形 |
Spacing | 图片与文本的间距 |
State | 单选框的状态 |
# 3.1.1. GlowEffect
设置控件的发光效果。
属性 | 功能说明 |
---|---|
AlphaValue | 发光的Alpha通道透明度,取值为 0-255 |
Color | 发光的颜色 |
Enabled | 设定是否启用发光效果 |
FocusedColor | 设定控件处于对焦状态时显示的颜色 |
GlowSize | 发光的光晕范围 |
IntenSive | 如果设定为 True 则启用更强烈的发光效果 |
Offset | 发光效果的偏移量 |
PressedAlphaValue | 当控件按下时设定的发光的Alpha通道透明度,取值为 0-255 |
StyleColors | 如果为 True ,则当样式处于活动状态时,TscGlowEffect 会自动调整颜色。 例如,如果您设置 Color = clHighLight 那么您将从样式中获得 clHighLight 颜色 |
PressedColor | 控件在按下状态时显示的颜色 |
PressedGlowSize | 控件在按下时显示的光晕的大小 |
States | 设置是否启用效果状态。scsNormal :是否使用正常状态的显示效果。scsHot :是否使用处于热状态的显示效果。scsPressed :是否使用按下状态的显示效果。scsFocused :设置是否使用对焦状态显示的效果。scsDisabled :设置是否使用禁用状态显示效果 |
# 4. TscRadioButton
包含了 TRadioButton 的属性事件方法,同时额外增加图像、不同类型与效果。
# 4.1. 属性
属性 | 功能说明 |
---|---|
AllowGrayed | 启用 cbGrayed 状态,即 State 状态中可选灰色 |
Animation | 是否在控件中启用动画 |
CanFocused | 设定控件是否允许对焦 |
Checked | 控件是否处于勾选状态 |
CustomCheckedImageIndex CustomCheckedImageHotIndex CustomCheckedImagePressedIndex CustomCheckedImageDisabledIndex CustomUnCheckedImageIndex CustomUnCheckedImageHotIndex CustomUnCheckedImagePressedIndex CustomUnCheckedImageDisabledIndex CustomGrayedImageIndex CustomGrayedImageHotIndex CustomGrayedImagePressedIndex CustomGrayedImageDisabledIndex | 设置所有状态下显示的图片的序号 |
CustomImages | TscImageCollection 组件。 位图属性必须在所有项目中定义,您将用于自定义样式 |
GlowEffect | 调整控件的发光属性 |
ImageGlow | 是否启用图片发光效果 |
ImageIndex | 正常状态显示的图片序号 |
Images | 选择图像组控件 |
Layout | 图像的布局方式blGlyphLeft :设置图像在左侧blGlyphBottom :设置图像在底部blGlyphRight :设置图像在右侧blGlyphTop :设置图像在顶部 |
ShowFocusRect | 如果为 True ,则控件绘制焦点矩形 |
Spacing | 图片与文本的间距 |
State | 单选框的状态 |
# 4.1.1. GlowEffect
设置控件的发光效果。
属性 | 功能说明 |
---|---|
AlphaValue | 发光的Alpha通道透明度,取值为 0-255 |
Color | 发光的颜色 |
Enabled | 设定是否启用发光效果 |
FocusedColor | 设定控件处于对焦状态时显示的颜色 |
GlowSize | 发光的光晕范围 |
IntenSive | 如果设定为 True 则启用更强烈的发光效果 |
Offset | 发光效果的偏移量 |
PressedAlphaValue | 当控件按下时设定的发光的Alpha通道透明度,取值为 0-255 |
StyleColors | 如果为 True ,则当样式处于活动状态时,TscGlowEffect 会自动调整颜色。 例如,如果您设置 Color = clHighLight 那么您将从样式中获得 clHighLight 颜色 |
PressedColor | 控件在按下状态时显示的颜色 |
PressedGlowSize | 控件在按下时显示的光晕的大小 |
States | 设置是否启用效果状态。scsNormal :是否使用正常状态的显示效果。scsHot :是否使用处于热状态的显示效果。scsPressed :是否使用按下状态的显示效果。scsFocused :设置是否使用对焦状态显示的效果。scsDisabled :设置是否使用禁用状态显示效果 |
# 5. TscPanel
包含了 Tpanel 中的属性事件方法,具有多种样式和边框类型、壁纸、透明度等的面板控制。
# 5.1. 属性
属性 | 功能说明 |
---|---|
Alignment | 设定文字的对齐方式 |
BorderStyle | 设定控件的边框样式 |
Caption | 控件中显示的文字内容 |
CaptionGlowEffect | 文字内容的发光效果 |
CustomImages | 额外的背景图片 |
FluentUIOpaque | 将其设置为 True 以使用 Fluent UI 获取表单的不透明区域(请参阅 TscStyledForm 组件) |
StorePainBuffer | 如果为 True,则来自样式控件的透明子控件将使用特殊的绘画缓冲区来获取父图像 |
StyleKind | 样式选项。scpsPanel :为背景使用颜色scpsToolBar :使用工具栏主题和样式scpsHeader :使用标题主题和样式scpsFormBackground :表单客户端主题和样式scpsTransparent :控件透明主题样式scpsEmpty :没有什么可画的 - 如果控件是某些控件的父控件并且它的客户端部分不可见,则可以使用它scpsEdit :使用编辑框样式scpsTabSheet :使用标签页样式背景 |
WallPaperIndex | 壁纸的索引号 |
WallPapers | 设定显示为壁纸的控件 |
# 5.1.1. CaptionGlowEffect
property CaptionGlowEffect: TscGlowEffect;
设定控件的发光效果。
属性 | 功能说明 |
---|---|
AlphaValue | 发光的Alpha通道透明度,取值为 0-255 |
Color | 发光的颜色 |
Enabled | 设定是否启用发光效果 |
GlowSize | 发光的光晕范围 |
IntenSive | 如果设定为 True 则启用更强烈的发光效果 |
Offset | 发光效果的偏移量 |
StyleColors | 如果为 True ,则当样式处于活动状态时,TscGlowEffect 会自动调整颜色。 例如,如果您设置 Color = clHighLight 那么您将从样式中获得 clHighLight 颜色 |
# 6. TscListBox
包含了 TListBox 中的属性事件方法,具有更多的特性。
# 6.1. 属性
属性 | 功能说明 |
---|---|
Images | 设定显示的图片项目 |
ImageIndex | 项目的全局图像索引。 默认值为 -1(在本例中图像索引为项目索引) |
LineColor | 行线条的颜色 |
SelectionColor | 控件的自定义选择颜色(值必须 <> clNone ) |
SelectionStyle | 选择的样式scstStyled :从主题或样式中将选区绘制为位图。scstColor :从主题或样式中绘制选择作为高亮颜色 |
SelectionTextColor | 自定义选择的文本颜色 |
ShowFocusRect | 是否显示每个项目之间的对焦矩形 |
ShowLines | 是否显示选项之间的横线 |
TitleDivider | 项目文本中的 Devider 字符串以检测标题字符串。 例如,如果 TitleDivider = @ 那么要在项目中绘制标题,您必须添加:Title1@Item1 |
WordBreak | 是否在带有分词符的项目中绘制文本 |
# 6.2. 方法
# 6.2.1. AddMRUItem
procedure AddMRUItem(Value: String);
使用此方法可以防止添加已经在列表中的项目。例如添加了以下程序:
FThis.scListBox1.AddMRUItem('aaa');
FThis.scListBox1.AddMRUItem('bbb');
FThis.scListBox1.AddMRUItem('aaa');
2
3
运行上述语句后,仅会在列表中获得:
aaa
bbb
2
# 7. TscComboBox
包含了 TComboBox 中的属性事件方法,具有更多的特性。
# 7.1. 属性
属性 | 功能说明 |
---|---|
Images | 设定显示的图片项目 |
ImageIndex | 项目的全局图像索引。 默认值为 -1(在本例中图像索引为项目索引) |
SelectionColor | 控件的自定义选择颜色(值必须 <> clNone ) |
SelectionStyle | 选择的样式scstStyled :从主题或样式中将选区绘制为位图。scstColor :从主题或样式中绘制选择作为高亮颜色 |
SelectionTextColor | 自定义选择的文本颜色 |
ShowFocusRect | 是否显示每个项目之间的对焦矩形 |
StyleKind | 设置显示的样式。scscbDefault :默认样式scscbPushButton :使用按钮样式 |
TitleDivider | 项目文本中的 Devider 字符串以检测标题字符串。 例如,如果 TitleDivider = @ 那么要在项目中绘制标题,您必须添加:Title1@Item1 |
WordBreak | 是否在带有分词符的项目中绘制文本 |
# 7.2. 方法
# 7.2.1. AddMRUItem
procedure AddMRUItem(Value: String);
使用此方法可以防止添加已经在列表中的项目。例如添加了以下程序:
FThis.scComboBox1.AddMRUItem('aaa');
FThis.scComboBox1.AddMRUItem('bbb');
FThis.scComboBox1.AddMRUItem('aaa');
2
3
运行上述语句后,仅会在列表中获得:
aaa
bbb
2
# 8. TscComboBoxEx
包含了 TComboBox 中的属性事件方法,具有更多的特性。
# 8.1. 属性
属性 | 功能说明 |
---|---|
SelectionColor | 控件的自定义选择颜色(值必须 <> clNone ) |
SelectionStyle | 选择的样式scstStyled :从主题或样式中将选区绘制为位图。scstColor :从主题或样式中绘制选择作为高亮颜色 |
SelectionTextColor | 自定义选择的文本颜色 |
StyleKind | 设置显示的样式。scscbDefault :默认样式scscbPushButton :使用按钮样式 |
# 9. TscCheckListBox
使用 TCheckListBox 组件,可包含更多的特性。
属性 | 功能说明 |
---|---|
Images | 设定显示的图片项目 |
ImageIndex | 项目的全局图像索引。 默认值为 -1(在本例中图像索引为项目索引) |
LineColor | 行线条的颜色 |
SelectionColor | 控件的自定义选择颜色(值必须 <> clNone ) |
SelectionStyle | 选择的样式scstStyled :从主题或样式中将选区绘制为位图。scstColor :从主题或样式中绘制选择作为高亮颜色 |
SelectionTextColor | 自定义选择的文本颜色 |
ShowFocusRect | 是否显示每个项目之间的对焦矩形 |
ShowLines | 是否显示选项之间的横线 |
TitleDivider | 项目文本中的 Devider 字符串以检测标题字符串。 例如,如果 TitleDivider = @ 那么要在项目中绘制标题,您必须添加:Title1@Item1 |
WordBreak | 是否在带有分词符的项目中绘制文本 |
# 10. TscPageControl
包含了 TPageControl 中的属性事件方法,具有不同的样式、页面壁纸和标签表的附加功能。
# 10.1. 属性
属性 | 功能说明 |
---|---|
FreeOnClose | 如果 True 在关闭标签页时销毁页面,否则 TabVisible 将为 False |
HideBorder | 设置显示/隐藏边框 |
HideTabs | 设置显示/隐藏标签栏 |
MouseWheelSupport | 如果设置为 True ,可使用鼠标滚轮来控制标签页的切换 |
ShowButtonDivider | 如果为 True ,则在 Style = tsFlatButtons 和 Multiline = False 时控制显示标签之间的绘制分隔线 |
ShowCloseButton | 设置是否在标签页显示关闭按钮 |
ShowFocusRect | 是否显示每个项目之间的对焦矩形 |
ShowInActiveTab | 如果为 False 则控件不绘制非活动选项卡(仅图像和文本) |
TabExtendedDraw | 如果为 True ,则控制使用扩展方法绘制选项卡的内容。 您可以使用 TabMargin 、TabSpacing 、TabLayout 、TabGlowEffect 属性来调整选项卡 |
TabGlowEffect | 标签中图片与文字的发光效果设置 |
TabImageGlow | 设置是否启用标签中的图片发光效果 |
TabLayout | 标签中图像的布局方式 |
TabMargin | 选项卡中图像和文本的边距 |
TabsInCenter | 如果设置为 True , 则 Tabs 将绘制在控制中心。 在这种情况下,TabWidth 必须 > 0 。 控件模拟此行为,并且在设计时当您单击控件时,如果您未设置 Align 属性,它可以偏移位置。此属性仅适用于 TabPosition = tpTop |
TabsOffset | 选项卡从左侧的偏移量。 此属性仅适用于 TabPosition = tpTop 。 控件模拟此行为,并且在设计时当您单击控件时,如果您未设置 Align 属性,它可以偏移位置。 在这种情况下,UpDown 控件被禁用 |
TabSpacing | 选项卡中图像和文本之间的间距 |
TabsWallPaperIndex | 标签背景的壁纸索引 |
WallPapers | 指定标签和页面的墙纸控件 |
# 10.1.1. TabGlowEffect
设置控件的发光效果。
属性 | 功能说明 |
---|---|
AlphaValue | 发光的Alpha通道透明度,取值为 0-255 |
Color | 发光的颜色 |
Enabled | 设定是否启用发光效果 |
FocusedColor | 设定控件处于对焦状态时显示的颜色 |
GlowSize | 发光的光晕范围 |
IntenSive | 如果设定为 True 则启用更强烈的发光效果 |
Offset | 发光效果的偏移量 |
PressedAlphaValue | 当控件按下时设定的发光的Alpha通道透明度,取值为 0-255 |
StyleColors | 如果为 True ,则当样式处于活动状态时,TscGlowEffect 会自动调整颜色。 例如,如果您设置 Color = clHighLight 那么您将从样式中获得 clHighLight 颜色 |
PressedColor | 控件在按下状态时显示的颜色 |
PressedGlowSize | 控件在按下时显示的光晕的大小 |
States | 设置是否启用效果状态。scsNormal :是否使用正常状态的显示效果。scsHot :是否使用处于热状态的显示效果。scsPressed :是否使用按下状态的显示效果。scsFocused :设置是否使用对焦状态显示的效果。scsDisabled :设置是否使用禁用状态显示效果 |
# 11. TscTabSheet
包含多种样式的 TTabSheet。
# 11.1. 属性
属性 | 功能说明 |
---|---|
DrawTabsWallPaper | 如果为 True,则页面使用墙纸作为选项卡 |
StyleKind | 设置页面样式sctsTabSheet :默认绘图样式sctsPanel :使用面板样式sctsToolBar :使用工具栏主题和样式sctsFormBackground :绘制表单的主题和样式 |
WallpaperIndex | 设置使用墙纸图片的序号,与 TscPageControl 中的 WallPapers 属性关联 |
# 12. TscTreeView
包含了 TTreeView 中的属性事件方法,具有不同的样式、页面壁纸和标签表的附加功能。
# 12.1. 属性
属性 | 功能说明 |
---|---|
ButtonCollapseImageIndex | 折叠图像的图像索引 |
ButtonExpandImageIndex | 展开图像的图像索引 |
ButtonImages | 展开按钮的自定义图像 |
ButtonStyle | 展开按钮的样式scebsArrow :箭头样式scebsButton :带 + 和 - 的按钮样式 |
CheckBoxes | 为表中的项目显示选择框 |
CheckHierarchy | 如果为 True ,则所有子项都将具有与父项相同的选中属性 |
Checked[Node:TTreeNode] | 树节点的值是否选中 |
DefaultDraw | 如果为 True 则在未启用样式时控件不会覆盖系统绘制 |
SelectionColor | 控件的自定义选择颜色(值必须为 <> clNone ) |
SelectionStyle | 选择的类型。scstStyled :从主题或样式中将选区绘制为位图scstColor :从主题或样式中将选区绘制为高亮颜色 |
SelectionTextColor | 自定选区的颜色 |
ShowFocusRect | 是否显示每个项目之间的对焦矩形 |
# 12.2. 事件
事件名称 | 触发条件 |
---|---|
OnNodeCheckedChanged | 当节点的选择框的状态发生变化时触发事件 |
OnNodeCheckedChanging | 使用此事件可设置允许或不允许对树节点进行状态的更改 |
OnCustomDrawItemText | 使用此事件调整项目的文本绘制 |
# 13. TscListView
包含了 TListView 中的属性事件方法,具有不同的样式、页面壁纸和标签表的附加功能。
# 13.1. 属性
属性 | 功能说明 |
---|---|
AlternateRow | 如果为 True,则控件在报告报表模式下具有交替行颜色 |
DefaultDraw | 如果为 True 则在未启用样式时控件不会覆盖系统绘制 |
ExtendedColumnDraw | 如果为 True,则控件将自动在列中绘制进度条或复选框 设置 Column.Tag = 1 绘制进度条(文本必须是'0'..'100')设置 Column.Tag = 2 以绘制复选框(选中状态的文本必须为1 ) |
SelectionColor | 控件的自定义选择颜色(值必须为 <> clNone ) |
SelectionStyle | 选择的类型。scstStyled :从主题或样式中将选区绘制为位图scstColor :从主题或样式中将选区绘制为高亮颜色 |
SelectionTextColor | 自定选区的颜色 |
ShowFocusRect | 是否显示每个项目之间的对焦矩形 |
# 14. TscEdit
包含了TEdit 中的属性事件方法,具有不同的样式、页面壁纸和标签表的附加功能。
# 14.1. 属性
属性 | 功能说明 |
---|---|
BorderKind | 设置边框的类型。scebFrame scebBottomLine scebBottomActiveLine |
ButtonImages | 按钮图像 |
ContentMarginTop ContentMarginLeft ContentMarginRight ContentMarginBottom | 如果 AutoSize 为 False ,可设置编辑框内容的边距 |
CustomBackgroundImageNormalIndex CustomBackgroundImageHotIndex CustomBackgroundImageDisabledIndex | 不同按钮状态下显示的图像 |
CustomImages | 设定 TscImageCollection 组件位图属性必须在所有项目中定义,您将用于自定义样式 |
HidePromptTextIfFocused | 如果聚焦,则隐藏编辑框提示文本 |
HintComponent | TscHint 组件显示来自编辑按钮的提示 |
LeftButton | 调整左侧的按钮,见 TscEditButton |
PromptText | 在编辑框中显示的提示信息 |
RightButton | 调整右侧的按钮,见 TscEditButton |
Transparent | 如果设置为 True ,则编辑框会显示透明底色 |
WallPaperIndex | 壁纸的索引号 |
WallPapers | 设定显示为壁纸的控件 |
# 14.2. 事件
事件名称 | 触发条件 |
---|---|
OnLeftButtonClick | 当左侧按钮点击时触发事件 |
OnRightButtonClick | 当右侧按钮点击时触发事件 |
# 15. TscEditButton
显示在编辑框中的一个可调整按钮。
# 15.1. 属性
属性 | 功能说明 |
---|---|
CustomImageNormalIndex CustomImageHotIndex CustomImagePressedIndex CustomImageDisabledIndex | 按钮状态的图像索引(必须定义 TscEdit.CustomImages ) |
DropDownMenu | 设置下拉菜单 |
Enabled | 设置是否启用按钮 |
Hint | 设置按钮的提示 |
ImageHotIndex | 处于热状态时显示的图像序号 |
ImageIndex | 图像显示序号 |
ImagePressedIndex | 处于按下状态时显示的图像序号 |
RepeatClick | 如果设置为 True ,则在按下按钮时会重复触发点击事件 |
RepeatClickInterval | 重复点击的时间间隔,以毫秒为单位 |
Show Ellipses | 按钮是否在文字较长时显示省略号 |
ShowHint | 是否为按钮显示提示信息 |
StyleKind | 按钮的样式 |
Visible | 按钮是否可见 |
# 16. TscNumericEdit
可用于整数或浮点数编辑的编辑框。
# 16.1. 属性
属性 | 功能说明 |
---|---|
CurrencyString | 显示类型的货币字符串值 |
Decimal | 设置显示小数的位数 |
DisplayFormat | 自定义显示格式 |
DisplayType | 显示的样式scedtNumeric :将文本显示为数字scedtCurrency :将文本显示为货币 |
Increment | 使用向上和向下键时的数值的增量 |
MaxValue | 编辑框中可以显示的最大值 |
MinValue | 编辑框中可以显示的最小值 |
SupportUpDownKeys | 是否允许使用上下键改变数值 |
Value | 当前值。 |
ValueType | 设置显示的数值类型cvtInteger :整数。scvtFloat :浮点数 |
# 17. TscTrackEdit
可通过下拉的轨迹条来调整编辑框中显示的数值。
# 17.1. 属性
属性 | 功能说明 |
---|---|
DblClickShowTrackBar | 设置是否可以使用双击事件打开轨迹条 |
Increment | 使用向上和向下键时的数值的增量 |
JumpWhenClick | 启用 trackbar 的 JumpWhenClick 属性(通过单击轨道区域设置值) |
MaxValue | 编辑框中可以显示的最大值 |
MinValue | 编辑框中可以显示的最小值 |
SupportUpDownKeys | 是否允许使用上下键改变数值 |
TrackBarHeight | 设置轨迹条的高度,如果设置为0则使用 Height 属性设置的高度 |
TrackBarWidth | 设置轨迹条的宽度,如果设置为 0 则使用 Width 属性设置的宽度 |
Value | 当前值 |
# 18. TscSpinEdit
可通过点击上下按键调整编辑框中显示的数值。
# 18.1. 属性
属性 | 功能说明 |
---|---|
Decimal | 设置显示小数的位数 |
DisplayType | 显示的样式scedtNumeric :将文本显示为数字scedtCurrency :将文本显示为货币 |
Increment | 使用向上和向下键时的数值的增量 |
MaxValue | 编辑框中可以显示的最大值 |
MinValue | 编辑框中可以显示的最小值 |
MouseWheelSupport | 设置是否支持使用鼠标滚轮来改变值 |
UpDownKind | 设置上下按钮的类型scupkDefault :默认样式 scupkLeftRight :显示为左右按键 |
Value | 当前值。 |
ValueType | 设置显示的数值类型cvtInteger :整数。scvtFloat :浮点数 |
# 19. TscTimeEdit
此控件可用于编辑时间。
# 19.1. 属性
属性 | 功能说明 |
---|---|
ShowMSec | 设置是否显示毫秒 |
ShowSec | 设置是否显示秒 |
ShowUpDown | 设置是否显示上下按钮 |
TimeFormat | 设置时间格式sctf24Hour :设置为24小时制sctf12Hour :设置为12小时制 |
Text | 设置时间的显示文本 |
# 19.2. 方法
# 19.2.1. DecodeTime
DecodeTime(var Hour, Min, Sec, MSec: Word);
从编辑框中获取时间并解析至变量中。
var
h,m,s,ms: word;
begin
FThis.scTimeEdit1.DecodeTime(h,m,s,ms);
end;
2
3
4
5
# 19.2.2. EncodeTime
EncodeTime(Hour, Min, Sec, MSec: Word);
将获取到的数据解析为时间格式显示于编辑框中。
FThis.scTimeEdit1.EncodeTime(12,12,12,122);
# 20. TscDateEdit
此控件可用于编辑日期。
# 20.1. 属性
属性 | 功能说明 |
---|---|
CalendarBackgroundStyle | 设置日历的背景样式sccasPanel :面板样式。sccasFormBackground :窗体背景样式。sccasEdit :编辑框样式 |
CalendarFont | 设置弹出式日历框显示的字体 |
CalendarHeight | 设置日历框显示的高度 |
CalendarWallpapers | 设置日历框显示的墙纸 |
CalendarWallpaperIndex | 设置日历框显示的墙纸序号信息 |
CalendarWidth | 设置日历框显示的宽度 |
Date | 设置编辑框显示的日期数值 |
FirstDayOfWeek | 设置一周的第一天的星期数 |
ShowToday | 设置是否显在日历框底部显示今天 项 |
TodayDefault | 设置是否将今天的日期作为默认日期显示 |
WeekNumbers | 设置是否在日历中显示周数 |
# 20.2. 事件
事件名称 | 触发条件 |
---|---|
OnDateChange | 当编辑框中的日期发生变化时触发事件 |
# 21. TscMonthCalendar
显示为月度日历。
# 21.1. 属性
属性 | 功能说明 |
---|---|
Date | 设置显示的日期 |
FirstDayOfWeek | 设置一周的第一天的星期数 |
ShowToday | 设置是否显在日历框底部显示今天 项 |
TodayDefault | 设置是否将今天的日期作为默认日期显示 |
WeekNumbers | 设置是否在日历中显示周数 |
# 21.2. 事件
事件名称 | 触发条件 |
---|---|
OnNumberClick | 当用户选择日历中的数值时触发事件 |
# 22. TscMemo
具有透明度和背景墙纸的备忘录控件。包含了 TMemo 组件的属性。
# 22.1. 属性
属性 | 功能说明 |
---|---|
CustomBackgroundImageNormalIndex CustomBackgroundImageHotIndex CustomBackgroundImageDisabledIndex | 不同按钮状态下显示的图像 |
CustomImages | 设定 TscImageCollection 组件位图属性必须在所有项目中定义,您将用于自定义样式 |
Transparent | 设置控件是否使用透明属性 |
Wallpapers | 设置使用的墙纸背景 |
WallpaperIndex | 设置使用的墙纸图片序号 |
# 23. TscRadioGroup
RadioGroup 控件,它源自 TscGroupBox 和 TscRadioButton 控件。包含了 TRadioGroup 组件的属性。
# 23.1. 属性
属性 | 功能说明 |
---|---|
ButtonsImages | 设置按钮显示的图片 |
ButtonsAnimation | 设置是否启用按钮中的动画效果 |
ButtonsGlowEffect | 设置按钮项的发光效果 |
ShowFocusRect | 设置是否显示对焦圈 |
# 23.1.1. ButtonsGlowEffect
设置按钮的发光效果。
属性 | 功能说明 |
---|---|
AlphaValue | 发光的Alpha通道透明度,取值为 0-255 |
Color | 发光的颜色 |
Enabled | 设定是否启用发光效果 |
FocusedColor | 设定按钮处于对焦状态时显示的颜色 |
GlowSize | 发光的光晕范围 |
IntenSive | 如果设定为 True 则启用更强烈的发光效果 |
Offset | 发光效果的偏移量 |
PressedAlphaValue | 当按钮按下时设定的发光的Alpha通道透明度,取值为 0-255 |
StyleColors | 如果为 True ,则当样式处于活动状态时,TscGlowEffect 会自动调整颜色。 例如,如果您设置 Color = clHighLight 那么您将从样式中获得 clHighLight 颜色 |
PressedColor | 控件在按下状态时显示的颜色 |
PressedGlowSize | 按钮在按下时显示的光晕的大小 |
States | 设置是否启用效果状态。scsNormal :是否使用正常状态的显示效果。scsHot :是否使用处于热状态的显示效果。scsPressed :是否使用按下状态的显示效果。scsFocused :设置是否使用对焦状态显示的效果。scsDisabled :设置是否使用禁用状态显示效果 |
# 23.2. 事件
事件名称 | 触发条件 |
---|---|
OnButtonClick | 当按下按钮时触发事件 |
# 24. TscCheckGoup
它源自 TscGroupBox 和 TscCheckBox 控件。
# 24.1. 属性
属性 | 功能说明 |
---|---|
ButtonsImages | 设置按钮显示的图片 |
ButtonsAnimation | 设置是否启用按钮中的动画效果 |
ButtonsGlowEffect | 设置按钮项的发光效果 |
ItemChecked[Index] | 用于获取选项是否已选中 |
ShowFocusRect | 设置是否显示对焦圈 |
# 24.1.1. ButtonsGlowEffect
设置按钮的发光效果。
属性 | 功能说明 |
---|---|
AlphaValue | 发光的Alpha通道透明度,取值为 0-255 |
Color | 发光的颜色 |
Enabled | 设定是否启用发光效果 |
FocusedColor | 设定按钮处于对焦状态时显示的颜色 |
GlowSize | 发光的光晕范围 |
IntenSive | 如果设定为 True 则启用更强烈的发光效果 |
Offset | 发光效果的偏移量 |
PressedAlphaValue | 当按钮按下时设定的发光的Alpha通道透明度,取值为 0-255 |
StyleColors | 如果为 True ,则当样式处于活动状态时,TscGlowEffect 会自动调整颜色。 例如,如果您设置 Color = clHighLight 那么您将从样式中获得 clHighLight 颜色 |
PressedColor | 控件在按下状态时显示的颜色 |
PressedGlowSize | 按钮在按下时显示的光晕的大小 |
States | 设置是否启用效果状态。scsNormal :是否使用正常状态的显示效果。scsHot :是否使用处于热状态的显示效果。scsPressed :是否使用按下状态的显示效果。scsFocused :设置是否使用对焦状态显示的效果。scsDisabled :设置是否使用禁用状态显示效果 |
# 24.2. 事件
事件名称 | 触发条件 |
---|---|
OnButtonClick | 当按下按钮时触发事件 |
# 25. TscImageCollection
设置为图片集合控件。
# 25.1. 属性
属性 | 功能说明 |
---|---|
Images | 设置可使用的图片项目 |
# 26. TscImageCollectionItem
图片集中的项目。
# 26.1. 属性
属性 | 功能说明 |
---|---|
Bitmap | 位图,基于 PNG 图像。 您会看到加载 PNG 图像的特殊对话框。 结果,您将获得带 alpha 通道的 32 位位图或 24 位位图。 对话框也可以自动调整 BitmapOptions 属性中的 alphableend 属性。绘制 32 位位图比 PNG 图像快得多。 这就是为什么最好将 PNG 图像转换为 32 位位图或 24 位位图的原因 |
BitmapOptions | 位图的相关设置项 |
Description | 在大列表中查看有关位图信息的说明 |
DrawStyle | 设置图片的绘制方式 |
Picture | 可用于显示不同格式类型的图片 *.jpg 、*.png 、*.bmp |
TileOffsetX | 图片的X方向的偏移量 |
TileOffsetY | 图片的Y方向的偏移量 |
# 27. TscPasswordEdit
具有不同样式、透明度和密码字符图像的密码编辑控件。
# 27.1. 属性
属性 | 功能说明 |
---|---|
BorderKind | 设置边框的显示类型。sccebFrame :含有边框的样式。sccebBottomLine :仅含底边的边框样式。sccebNone :无边框的样式。... |
PasswordCharImageindex | 密码掩码使用的图片序号 |
PasswordCharImages | 密码掩码使用的图片集合控件 |
PasswordCharSelectedImageIndex | 设置选择时使用的图片序号 |
PasswordKind | 设置密码字符的类型 |
Transparent | 如果设置为 True 则控件显示为透明 |
UseFontColorToStyleColor | 是否将字体颜色用作样式颜色 |
# 28. TscScrollBox
控件为带有滚动条的显示框,其中可显示其他控件。
# 28.1. 属性
属性 | 功能说明 |
---|---|
BackgroundStyle | 设置控件背景的样式 |
FullUpdate | 如果为 True ,则滚动框将在滚动后完全更新。将 AutoScroll 和 FullUpdate 属性设置为 True 以实现非纯色背景的滚动 |
StorePaintBuffer | 如果为 True ,则使用样式控件的透明子控件将使用特殊的绘画缓冲区来获取父图像 |
# 29. TscTrackBar
控件显示为轨迹条,与 TTrackBar 实现的功能相同,包含了额外的自定样式。
# 29.1. 属性
属性 | 功能说明 |
---|---|
CanFocused | 是否启用控件的对焦状态 |
JumpWhenClick | 当属性设置为 True 时,可使用鼠标点击直接切换取值 |
MaxValue | 控件设定的最大值 |
MinValue | 控件设定的最小值 |
MouseSuport | 当属性设置为 True 时,可使用鼠标点击滑轨进行操作 |
ShowFocusRect | 设置控件对焦时是否显示矩形的提示环 |
TrackOptions | 设置轨迹条的样式属性 |
ThumbOptions | 调整图像预览的选项 |
Value | 控件的设定值 |
Vertical | 轨迹条是否设置为竖向滑动的样式 |
# 29.2. 事件
事件名称 | 触发条件 |
---|---|
OnChange | 当取值发生变化时触发事件 |
OnLastChange | 当值发生变化且释放了滑块时时 |
# 30. TscProgressBar
控件显示为进度条,与 TProgressBar 实现的功能相同,包含了额外的自定样式。
# 30.1. 属性
属性 | 功能说明 |
---|---|
AnimationTimerInterval | 设定动画定时器的时间间隔 |
MaxValue | 控件设定的最大值 |
MinValue | 控件设定的最小值 |
Options | 调整控件元素与样式的设置 |
Value | 控件的设定值 |
Vertical | 控件是否设置为竖向的样式 |
# 30.2. 方法
# 30.2.1. StartAnimation
procedure StartAnimation;
启用进度条动画,可作为等待的提示信息。
# 30.2.2. StopAnimation
procedure StopAnimation;
停止进度条动画。
# 31. TscHint
控件用于设置显示提示信息,提示的信息包含标题、图片和文本。
# 31.1. 属性
属性 | 功能说明 |
---|---|
ActiveForAllApplication | 将其设置为 True 并将应用程序中的所有提示替换为来自 TscHint 组件的提示(这有助于您解决多显示器高 DPI 系统上提示的显示问题) |
AlphaBlend | 如果为 True,提示将具有 alphablend 效果 |
AlphaBlendAnimation | 启用/禁用提示的动画效果 |
AlphaBlendValue | AlphaBlend 的取值 |
LineSeparator | 行分隔符,默认值为@@ 。如果要显示多行提示,请将 LineSeparator 添加到行尾,例如:Line1@@Line2 |
# 31.2. 方法
# 31.2.1. ActiveHint
procedure ActivateHint(const AHint: string);
从光标位置激活提示。 组件获取光标位置并扫描光标掩码以检测提示的位置。
# 31.2.2. HideHint
procedure HideHint;
隐藏提示。
# 31.2.3. IsVisible
function IsVisible: Boolean;
使用此方法可获取当前提示信息是否处于显示状态。
# 32. TscRichEdit
富文本编辑框,与 TRichEdit 实现的功能相同,包含了额外的自定样式。
# 32.1. 属性
属性 | 功能说明 |
---|---|
StyleColors | 如果为 True ,则控件从样式中为字体和背景应用颜色。如果您想使用默认颜色,请将 StyleColors 设置为 False 。 |