MPF企业版-标签说明【03】 【QQ群：206378966】

好消息，MPF计划2017年11月份全部开源关注【QQ群：206378966】。

1.   MPF标签

        下面表格描述了MPF定义的标签，应用范围说明了标签作用的控件以及其所有派生的子控件。

1.1.  Element

1.1.1.      Name

类型	默认值	应用范围	只读性
String	null	Element	读写
取值	任意字符串
说明	元素名称，在同一个布局文件中应该设置为唯一；

 

1.1.2.      Opacity

类型	默认值	应用范围	只读性
float	1.0	Element	读写
取值	取值0至1
说明	控件的透明度，取值从0到1。

 

1.1.3.      Visibility

类型	默认值	应用范围	只读性
int	Visible	Element	读写
取值	Collapsed：不可见，不占用区域 Hidden：不可见，但是占用区域 Visible：可见
说明	控件的可见属性。

 

1.1.4.      RenderTransform

类型	默认值	应用范围	只读性
Transform	null	Element	读写
取值	派生至Transform各种转换对象
说明	控件渲染转换对象，目前实现RotateTransform、ScaleTransform等各种转换，结合Timeline可用于实现各种动画效果，目前仅支持代码设置。

 

1.1.5.      ClipToBounds

类型	默认值	应用范围	只读性
Boolean	True	Element	读写
取值	True或False
说明	设置控件是否裁剪其子控件。

 

1.1.6.      IsEnabled

类型	默认值	应用范围	只读性
Boolean	True	Element	只读
取值	True或False
说明	设置控件是否可以接收鼠标和键盘事件。

 

1.1.7.      IsMouseOver

类型	默认值	应用范围	只读性
Boolean	False	Element	只读
取值	True或False
说明	鼠标在控件上值为True，否则False。

 

1.1.8.      IsFocused

类型	默认值	应用范围	只读性
Boolean	False	Element	只读
取值	True或False
说明	标记控件是否拥有焦点，为True表示拥有焦点。

 

1.1.9.      IsKeyboardFocused

类型	默认值	应用范围	只读性
Boolean	False	Element	只读
取值	True或False
说明	直接拥有焦点的控件此属性为True。

 

1.1.10.   IsKeyboardFocusWithin

类型	默认值	应用范围	只读性
Boolean	False	Element	只读
取值	True或False
说明	如果其子控件拥有焦点，则为True，否则False。

 

1.1.11.   HitTestFilterAction

类型	默认值	应用范围	只读性
int	Continue	Element	读写
取值	Continue：接收鼠标测试； Stop：停止鼠标测试； ContinueSkipSelf：跳过本控件鼠标测试； ContinueSkipChildren：测试本控件但跳过其所有子控件 ContinueSkipSelfAndChildren：跳过本控件和其所有子控件鼠标测试。
说明	设置控件接收鼠标测试的行为方式，enum类型为HitTestFilterAction。

 

1.1.12.   IsMouseCaptured

类型	默认值	应用范围	只读性
Boolean	False	Element	只读
取值	True或False
说明	直接拥有鼠标控制权的控件此属性为True。

 

1.1.13.   IsMouseCaptureWithin

类型	默认值	应用范围	只读性
Boolean	False	Element	只读
取值	True或False
说明	如果其子控件获取鼠标控制权，则为True，否则False

 

1.1.14.   Focusable

类型	默认值	应用范围	只读性
Boolean	False	Element	读写
取值	True或False
说明	设置控件是否能够拥有焦点，如果为True表示控件可以拥有焦点。

 

1.1.15.   DataContext

类型	默认值	应用范围	只读性
Object	null	Element	读写
取值	任意Object以及Object的子类
说明	此属性保存控件的数据上下文，绑定时会自动查找此属性保存值的指定属性，如果用户的数据需要进行绑定，则可以通过此属性设置自己定义的数据类。

 

1.1.16.   Tag1、Tag2、Tag3

类型	默认值	应用范围	只读性
Object	null	Element	读写
取值	任意Object以及Object的子类
说明	此属性用来帮助用户保存自己定义的数据对象。

 

1.2.  FrameworkElement

1.2.1.      Width

类型	默认值	应用范围	只读性
Integer	Auto	FrameworkElement	读写
取值	Auto或大于等于0的整数。
说明	控件元素的宽度；

 

1.2.2.      Height

类型	默认值	应用范围	只读性
Integer	Auto	FrameworkElement	读写
取值	Auto或大于等于0的整数。
说明	控件元素的高度；

 

1.2.3.      MinWidth

类型	默认值	应用范围	只读性
Integer	Auto	FrameworkElement	读写
取值	Auto或大于等于0的整数。
说明	控件元素的最小宽度，布局时控件的最终宽度不能小于此设定值；

 

1.2.4.      MinHeight

类型	默认值	应用范围	只读性
Integer	Auto	FrameworkElement	读写
取值	Auto或大于等于0的整数。
说明	控件元素的最小高度，布局时控件的最终高度不能小于此设定值；

 

1.2.5.      MaxWidth

类型	默认值	应用范围	只读性
Integer	Auto	FrameworkElement	读写
取值	Auto或大于等于0的整数。
说明	控件元素的最大宽度，布局时控件的最终宽度不能大于此设定值；

 

1.2.6.      MaxHeight

类型	默认值	应用范围	只读性
Integer	Auto	FrameworkElement	读写
取值	Auto或大于等于0的整数。
说明	控件元素的最大高度，布局时控件的最终高度不能大于此设定值；

 

1.2.7.      Margin

类型	默认值	应用范围	只读性
ORect	ORect::Empty	FrameworkElement	读写
取值	Empty，全为0。
说明	控件元素和父元素的边距，根据布局方式绝对其值意义；

 

1.2.8.      VerticalAlignment

类型	默认值	应用范围	只读性
Integer	Top	FrameworkElement	读写
取值	Top：靠上对齐； Center：居中对齐； Bottom：靠下对齐； Stretch：拉升至父控件
说明	控件元素垂直方向的布局方式；

 

1.2.9.      HorizontalAlignment

类型	默认值	应用范围	只读性
Integer	Left	FrameworkElement	读写
取值	Left：靠左对齐； Center：居中对齐； Right：靠右对齐； Stretch：拉升至父控件
说明	控件元素水平方向的布局方式；

 

1.2.10.   ToolTip

类型	默认值	应用范围	只读性
Object	Null	FrameworkElement	读写
取值	任意对象。
说明	鼠标进入控件时提示信息；

 

1.2.11.   Style

类型	默认值	应用范围	只读性
Style	Null	FrameworkElement	读写
取值	Style样式对象。
说明	应用到控件元素的风格样式，由Style节点定义；

 

1.3.  Control

1.3.1.      Template

类型	默认值	应用范围	只读性
ControlTemplate	null	Control	读写
取值	ControlTemplate
说明	控件元素的模版，可以通过此属性定制控件的外观显示；

 

1.3.2.      Background

类型	默认值	应用范围	只读性
Brush	null	Control	读写
取值	刷子对象（从Brush继承）
说明	控件元素的背景画刷，请参考资源类型说明；

 

1.3.3.      BorderBrush

类型	默认值	应用范围	只读性
Brush	null	Brush	null
取值	刷子对象（从Brush继承）
说明	控件元素的边框画刷，BorderThickness不为空时有效，请参考资源类型说明；

 

1.3.4.      Foreground

类型	默认值	应用范围	只读性
Brush	null	Brush	null
取值	刷子对象（从Brush继承）
说明	控件元素的前景画刷，请参考资源类型说明，这里目前仅支持SolidColorBrush画刷；

 

1.3.5.      BorderThickness

类型	默认值	应用范围	只读性
ORect	null	Control	读写
取值	ORect（左上右下边框）
说明	控件元素的边框宽度，可以通过此属性定制控件的边框显示；

 

1.3.6.      Padding

类型	默认值	应用范围	只读性
ORect	null	Control	读写
取值	ORect（左上右下边框）
说明	控件元素的内边距，控件的内容距离控件的边距；

 

1.3.7.      TabIndex

类型	默认值	应用范围	只读性
Integer	null	Control	读写
取值	Integer，大于等于0
说明	控件元素的Tab索引（按tab键是切换的顺序）；

 

1.3.8.      IsTabStop

类型	默认值	应用范围	只读性
Boolean	null	Control	读写
取值	True或False
说明	控件元素是否接收tab键导航，此值需要结合Focusable使用；

 

1.4.  ControlContent

1.4.1.      Content

类型	默认值	应用范围	只读性
Object	null	ControlContent	读写
取值	任意对象
说明	控件的内容，需要结合ContentTemplate定义的内容模版显示；

 

1.4.2.      ContentTemplate

类型	默认值	应用范围	只读性
DataTemplate	TextBlock	ControlContent	读写
取值	数据模版，默认使用TextBlock显示。
说明	此控件元素的内容模版，可以通过此属性定义内容的外观呈现；

 

1.5.  ItemsControl

1.5.1.      ItemsPanel

类型	默认值	应用范围	只读性
ItemsPanelTemplate	VisualizeStackPanel	ItemsControl	读写
取值	项容器模版，默认使用VisualizeStackPanel虚拟化面板
说明	定义项控件的项容器模版，可以是从Panel派生的面板；

 

1.5.2.      ItemTemplate

类型	默认值	应用范围	只读性
DataTemplate	TextBlock	ItemsControl	读写
取值	默认通过TextBlock显示项的ToString()内容。
说明	项内容的显示模版，此为数据模版，可以通过此属性定义项内容的呈现模版；

 

1.6.  ButtonBase

1.6.1.      IsPressed

类型	默认值	应用范围	只读性
Boolean	False	ButtonBase	读写
取值	True或False
说明	控件鼠标按下或抬起设置该值；

 

1.7.  ToggleButton

1.7.1.      IsThreeState

类型	默认值	应用范围	只读性
Boolean	False	ToggleButton	读写
取值	True或False
说明	标识控件是否支持三态：选中、未选、中间状态(没有选中也没有不选中)；

 

1.7.2.      IsChecked

类型	默认值	应用范围	只读性
Boolean	False	ToggleButton	读写
取值	True、False或null
说明	标识控件三态：选中、未选、中间状态(没有选中也没有不选中)；

 

1.8.  Panel

1.8.1.      IsItemsHost

类型	默认值	应用范围	只读性
Boolean	False	Panel	读写
取值	True或False
说明	面板如果是项的容器，则为True，否则False。

 

1.8.2.      ZIndex

类型	默认值	应用范围	只读性
Integer	0	Panel	读写
取值	大于0的整数
说明	控件Z方向的索引，通过设置该值能够改变控件的显示顺序；

 

1.8.3.      Background

类型	默认值	应用范围	只读性
Brush	null	Panel	读写
取值	画刷，从Brush继承的。
说明	面板的背景画刷；