Delphi10.4.2--TBtnEditC控件详解

TBtnEditC控件详解

TBtnEditC 是 DevExpress VCL 库中的一个控件，继承自 TEdit，所以很多属性相似。

属性详解

A

1. **AlignWithMargins：**控制 Align 属性的对齐行为是否考虑控件的边距。
2. Anchors：指定控件在父控件中的固定位置，支持左、右、上、下边缘的锚定，以便在父控件大小改变时保持固定的位置或大小。
3. AutoSelect：控制控件获得焦点时是否自动选中文本。为 True 时，当 TBtnEditC 获得焦点时，控件中的所有文本会自动被选中。
4. AutoSize：控制控件是否根据文本和字体的大小自动调整高度。如果设置为 True，控件高度会随字体大小的改变而自动调整。

B

1. Bevel 系列属性：BevelEdges 控制控件上哪些边缘应用斜面效果。BevelInner 定义控件的内部斜面样式。BevelKind 属性控制控件的整体斜面类型。BevelOuter 定义控件的外部斜面样式。BevelWidth 控制斜面的宽度，以像素为单位。
2. BiDiMode：指定控件的双向布局模式，适用于从右到左书写的语言（如阿拉伯语和希伯来语），支持的模式有 bdLeftToRight、bdRightToLeft等。
3. BorderStyle：定义控件边框的样式，可以为 bsNone（无边框）或 bsSingle（单边框）。
4. BorderWidth：设置控件的边框宽度，以像素为单位。

C

1. CharCase：指定文本的字母大小写，可以为 ecNormal（不变）、ecUpperCase（强制大写）或 ecLowerCase（强制小写）。
2. Color：设置控件的背景颜色。
3. Constraints：控制控件的尺寸约束，可以设置最小和最大高度、宽度，防止控件缩放到不适合的大小。
4. Ctl3D：设置控件是否显示三维外观，如果为 True，控件会显示三维边框效果。
5. **Cursor：**设置当鼠标悬停在 TBtnEditC 控件上时显示的光标样式。可以为
   • crDefault：默认光标（通常是箭头）。
   • crIBeam：I形光标，通常用于文本编辑控件，表示可以输入文本。
   • crHandPoint：手形光标，通常用于指示链接或可单击区域。
   • crCross：十字光标。
   • crDrag：拖动光标，通常用于拖放操作。

6.CustomHint **：**允许开发者为 TBtnEditC 控件指定一个自定义提示（Hint）类实例。此属性可以为提示信息提供更灵活的显示样式和行为。

D

1. DragCursor：当控件被拖动时，被用于代表鼠标指针的图片。
2. DragKind：定义控件的拖放类型，可以是 dkDrag（普通拖动）或 dkDock（用于停靠操作）。
3. DragMode：定义控件的拖放模式，dmManual表示手动拖放，dmAutomatic表示自动拖放。

E

1. Enabled：控制控件是否可以交互。为 False 时，控件变为不可编辑的灰色。

F

1. Font：设置控件内文本的字体样式、大小和颜色。

H

1. Height：设置控件的高度，以像素为单位。
2. HelpContext：帮助上下文 ID，当按下 F1 键时会显示与该 ID 关联的帮助主题。
3. HelpKeyword：指定控件的帮助关键字，以便在帮助系统中查找相关主题。
4. HelpType：指定帮助类型，控制控件调用帮助时查找方式，可选择 HelpKeyword 或 HelpContext。
5. HideSelection：指定控件失去焦点时是否隐藏选中文本的高亮显示。
6. Hint：设置控件的提示信息，当鼠标悬停时显示。需要将 ShowHint 设置为 True 才会显示提示。

I

1. ImeMode：指定输入法编辑器的模式，控制控件在不同输入语言下的输入方式。
2. ImeName：指定输入法编辑器的名称，强制控件使用特定输入法

L

1. Left：指定控件在父容器中的水平位置，以像素为单位。
2. LiveBindings：启用控件与数据源之间的无代码数据绑定，使控件内容与数据源同步更新。
3. LiveBindings Designer：可视化设计工具，用于管理和配置控件的数据绑定。

M

1. Margins：设置控件的外边距，控制控件与周围元素的间距。
2. MaxLength：设置控件允许输入的最大字符数。如果为 0，则不限制字符数量。

N

1. Name：控件名称。
2. NumbersOnly：指定控件是否仅允许输入数字。为 True 时，TBtnEditC 控件只允许输入数字字符（0-9）。

O

1. OemConvert：指定 TBtnEditC 控件中的文本是否使用 OEM（Original Equipment Manufacturer）字符集转换。设为 True 时，将 Windows ANSI 字符集转换为 OEM 字符集，通常用于在 DOS 和 Windows 程序间传递文本，确保字符显示正确。

P

1. ParentColor：指定控件是否继承父控件的背景颜色。为 True 时会使用父控件的颜色。
2. ParentFont：指定控件是否继承父控件的字体设置。
3. ParentShowHint：指定控件是否继承父控件的提示信息设置。
4. *Parent前缀：指定控件是否继承父控件的。
5. PasswordChar：设置为特定字符（如 ``）后，TBtnEditC 的文本将显示为该字符，常用于密码输入框。
6. PopupMenu：设置 TBtnEditC 的快捷菜单（右键菜单）。

R

1. ReadOnly：设置控件为只读模式。为 True 时，控件内容不可更改，但可以选择文本。

S

1. ShowHint：控制是否显示提示信息。将 Hint 属性设置为相应文本，并将 ShowHint 设置为 True 即可在鼠标悬停时显示提示。
2. StyleElement：指定控件的样式元素（如边框、客户端区域、字体等）是否使用样式主题。通过设置不同的 StyleElement 值，可以分别控制控件的不同部分是否使用系统或自定义主题样式，常用于与 VCL 样式或 Windows 主题的集成。
3. StyleName：指定控件应用的样式名称。此属性允许选择应用程序中可用的特定样式，以实现个性化的外观。StyleName 仅在启用了 VCL 样式或 FireMonkey 样式的应用程序中生效。

T

1. TabOrder：设置控件在窗体中的标签顺序，决定用户按 Tab 键时的切换顺序。
2. TabStop：设置控件是否可通过 Tab 键获得焦点。为 False 时 Tab 键会跳过该控件。
3. Tag：一个整数值，通常用于存储用户定义的附加信息，如标识控件、储存额外数据等。
4. Text：TBtnEditC 中显示的文本内容。此属性可用来获取用户输入的文本或预设显示的文本。
5. TextHint：指定 TBtnEditC 控件中显示的提示文本，通常用于提供输入提示。当 TBtnEditC 为空时，TextHint 会显示在控件中，一旦用户开始输入内容，提示文本会自动消失。常用于指导用户输入特定格式或内容。
6. Top：指定控件在父容器中的垂直位置，以像素为单位。设置 Top 值可调整控件相对于父容器顶部的距离。
7. Touch：用于支持触摸屏交互的属性集合。Touch 包含与触摸功能相关的子属性，如 Gestures，它允许配置控件响应特定的手势操作（例如滑动、捏合缩放等）。此属性适合在触摸屏设备上增强用户体验。

V

1. Visible：设置控件是否可见。为 False 时，控件不可见。

W

1. Width：设置控件的宽度，以像素为单位。

---

事件属性

TBtnEditC 是 DevExpress VCL 库中的一个控件，继承自 TEdit，它扩展了编辑控件，通常带有内置按钮。以下是 TBtnEditC 常见的事件及其功能说明：

TBtnEditC 的主要事件

1. OnButtonClick：当内置按钮被单击时触发。此事件常用于响应用户的点击操作，例如打开一个选择对话框、执行搜索等。
2. OnButtonDown：当用户按下内置按钮时触发。此事件在按钮按下时立即触发，不需要等待鼠标按钮释放。可用于执行快速响应的操作，如高亮显示等。
3. OnChange：当控件中的文本内容发生变化时触发。常用于监听用户输入，即时更新相关逻辑或界面。
4. OnClick：当用户单击控件时触发，不仅限于内置按钮，也可以是控件本身的任意位置。可以用于处理控件的单击事件。
5. OnDblClick：当用户双击控件时触发。此事件可以用于一些特殊的双击操作，如快速清除文本或打开详细窗口。
6. OnEnter：当控件获得输入焦点时触发，通常用于执行进入控件的初始化操作或显示提示信息。
7. OnExit：当控件失去输入焦点时触发。常用于在控件失去焦点时进行数据验证、保存数据或隐藏提示信息。
8. OnKeyDown：当用户按下键盘上的任意键时触发。可以用来拦截按键操作，如自定义快捷键或对输入的字符进行控制。
9. OnKeyPress：当用户按下字符键（例如字母、数字等）时触发，不包括功能键。此事件可以用于限制用户输入的字符类型，例如只能输入数字或特定字符。
10. OnKeyUp：当用户释放键盘上的按键时触发。可以用于处理按键抬起的操作，通常配合 OnKeyDown 事件来实现某些组合键的效果。
11. OnMouseDown：当用户在控件上按下鼠标按钮时触发。可以用于在鼠标按下时提供视觉反馈，或执行一些快速操作。
12. OnMouseMove：当鼠标在控件上移动时触发。可以用于在鼠标经过控件时显示特定信息，或更改控件的样式。
13. OnMouseUp：当用户在控件上释放鼠标按钮时触发。常用于完成鼠标操作，例如释放鼠标后执行某些功能或清除高亮状态。
14. OnMouseEnter：当鼠标指针进入控件区域时触发。可以用来改变控件的外观，例如更改背景色，表示获得焦点。
15. OnMouseLeave：当鼠标指针离开控件区域时触发。通常用于恢复控件的外观，撤销 OnMouseEnter 中的样式更改。