2.1. Element

定义

Element是最基本的控件，也是其他控件的基类。

属性

Parent

当前控件的父控件，默认值 nullptr。类型只能是Element*。

温馨提示：直接被Window接管时，Parent必须为 nullptr。

属性类型	Local, 只读
影响范围	AffectsDesiredSize, AffectsLayout

Children

当前控件的子控件。类型只能是DynamicArray<Element>。

属性类型	Local, 只读
影响范围	AffectsDesiredSize, AffectsLayout

Visible

是否在视觉中可见。默认值true。类型只能是bool。

属性类型	Local, Specified, Computed, 从样式表继承属性, 从父继承属性
影响范围	AffectsDisplay

Enabled

是否接受用户的操控。如果被禁用，那么鼠标点击等均无法做出响应。默认值true。类型只能是bool。

属性类型	Local, Specified, 从样式表继承属性, 从父继承属性
影响范围	无

Active

表示控件拥有的激活类型。 只接受以下值或其按位或：

constexpr auto Inactive = 0x00000000;
constexpr auto Mouse = 0x00000001;
constexpr auto Keyboard = 0x00000002;

温馨提示：如果控件需要同时被鼠标以及键盘激活，那么使用 “Mouse | Keyboard”即可。

属性类型	Local, Specified, 从样式表继承属性, 从父继承属性
影响范围	无

Width

控件建议的宽度。只接受整数输入。默认值 -1。

温馨提示： 取实际大小请考虑Extent属性。

属性类型	Local, Specified, 从样式表继承属性, 感应DPI
影响范围	AffectsDesiredSize

Height

控件建议的高度。只接受整数输入。默认值 -1。

温馨提示： 取实际大小请考虑Extent属性。

属性类型	Local, Specified, 从样式表继承属性, 感应DPI
影响范围	AffectsDesiredSize

MinSize

控件的最小大小。

属性类型	Local, Specified, 从样式表继承属性, 感应DPI
影响范围	AffectsLayout, AffectsParentLayout, AffectsBounds, AffectsDisplay

MaxSize

控件的最大大小。

属性类型	Local, Specified, 从样式表继承属性, 感应DPI
影响范围	AffectsLayout, AffectsParentLayout, AffectsBounds, AffectsDisplay

X

相对于父控件的X轴偏移。只接受整数输入。默认值 0。

温馨提示： X 属性仅在绝对布局中生效。取实际坐标请考虑Location属性。

属性类型	Local, Specified, 感应DPI
影响范围	无

Y

相对于父控件的Y轴偏移。只接受整数输入。默认值 0。

温馨提示： Y 属性仅在绝对布局中生效。取实际坐标请考虑Location属性。

属性类型	Local, Specified, 感应DPI
影响范围	无

Location

相对于父控件的坐标。类型只接受Point。

属性类型	Local, 只读
影响范围	AffectsBounds

Extent

控件的大小（既：宽，高信息）。类型只接受Size。

属性类型	Local, 只读
影响范围	AffectsLayout, AffectsBounds

Layout

控件的布局接口。类型只接受Layout*。默认值 nullptr。

属性类型	Local
影响范围	AffectsLayout, AffectsBounds

Margin

控件的外边距。控件与控件之间的距离。类型只接受Rect，分别表示左上右下，默认值 0, 0, 0, 0。

温馨提示：绝对布局时，此属性无法正常发挥作用。

属性类型	Local, Specified, 从样式表继承属性, 感应DPI
影响范围	AffectsParentDesiredSize, AffectsParentLayout

Padding

控件的内边距。控件边缘到内容的距离。类型只接受Rect，分别表示左上右下，默认值 0, 0, 0, 0。

属性类型	Local, Specified, 从样式表继承属性, 感应DPI
影响范围	AffectsDisplay, AffectsDesiredSize

BorderThickness

边框宽度。类型只接受Rect，分别表示左上右下边框的宽度，默认值 0, 0, 0, 0。

属性类型	Local, Specified, 从样式表继承属性, 感应DPI
影响范围	AffectsDesiredSize, AffectsDisplay

BorderStyle

边框的类型。只允许一下值：

// 实心方形边框（默认值）
Solid = 0,
// 拥有凸起效果的方形边框
Raised = 0,
// 拥有凹陷效果的方形边框
Sunken = 0,
// 圆角边框
Rounded = 0,

属性类型	Local, Specified, 从样式表继承属性
影响范围	AffectsDisplay

BorderColor

边框的颜色。只接受ARGB或者RBG。默认是透明色。

属性类型	Local, Specified, 从样式表继承属性
影响范围	AffectsDisplay

Background

背景。目前只接受ARGB或者RBG，未来计划支持矢量图等。默认是透明色。

属性类型	Local, Specified, 从样式表继承属性
影响范围	AffectsDisplay

Foreground

前景色。目前只接受ARGB或者RBG，默认是透明色。

属性类型	Local, Specified, 从样式表继承属性
影响范围	AffectsDisplay