Description
显示窗体 和 编辑窗体 控件充当用于显示和查看整个记录的容器。 每个容器可以保存一组 卡片 控件,这些控件显示单个字段或提供更新这些字段的方法。 每个卡片都有一个 DataField 属性,该属性指定其工作记录的字段。
预定义卡片是为不同的数据类型和用户体验定义的。 例如,可能有一张卡片可以使用 文本输入 控件编辑数字字段,这非常适合用于键盘。 另一张卡片可能支持改用 滑块 控件编辑数字。 选中窗体控件后,可以在右侧窗格中轻松基于字段选择卡片。
卡片本身包含控件。 卡片的控件构成了显示和编辑单个字段的体验。 例如,数字卡可能包含 一个标签 控件,以提供字段的显示名称,以及 一个文本输入 控件,以便为字段的值提供编辑器。 该卡片可能还有一个 标签 控件,该控件显示发生的任何验证错误,以及公共星号的 Label 控件,以指示字段是必需的。
可以通过调整预定义卡的大小、移动卡片、隐藏卡片、向其添加控件以及进行其他更改来自定义预定义卡片的控件。 也可以从完全空白的卡片(即“自定义卡片”)开始,从头开始添加控件。
预定义卡片默认 处于锁定状态 。 在锁定的卡片中,只能修改卡片的某些属性或卡片中的控件,并且不能删除锁定的卡片。 可以在高级视图的“视图”选项卡上显示卡片锁并解锁它。 如果属性已锁定且无法修改,则它会显示在其名称旁边的锁图标。 解锁卡片是一项高级活动,应谨慎完成,因为卡的自动公式生成将不再发生,并且无法重新锁定卡。
在窗体的容器中, ThisItem 记录可用,并包含记录的所有字段。 例如, 卡片的默认属性 通常设置为 ThisItem。FieldName。
可以使用 Parent 引用来配置控件以引用卡片的属性。 例如,控件应使用 Parent.Default 从数据源中读取字段的初始状态。 通过使用 Parent 而不是直接访问所需的信息,卡片可以更好地封装,并且无需中断内部公式即可将其更改为其他字段。
有关如何自定义、解锁和创建卡片的示例,请参阅 “了解数据卡 ”。
键属性
DataField – 此卡片显示和编辑的记录中的字段的名称。
- 将名称指定为用双引号(例如 ,“Name”)括起来的单个静态字符串,而不是公式。
- 通过将 卡片的 DataField 属性设置为 空白来取消绑定。 对于未绑定的卡片, 将忽略“有效 ”和 “更新 ”属性。
默认值 – 用户更改控件之前控件的初始值。
- 对于卡片中的每个控件,请将此属性设置为 Parent.Default ,以根据数据源引用字段的默认值。 例如,将 滑块的默认属性 设置为 Parent.Default ,以确保用户以该滑块的泛型值开头。
DisplayMode – 值可以是 “编辑”、“视图 ”或 “禁用”。 配置卡片内的控件是否允许用户输入(编辑)、仅显示数据(视图)还是禁用(已禁用)。
- 通过配置此属性(默认绑定到窗体的行为),允许在编辑窗体和视图窗体中使用单个卡片。
- 在 视图 模式下,子控件(如 文本输入、 下拉列表、 日期选取器 )将仅显示文本值,并且不会呈现任何交互式元素或修饰。
DisplayName – 数据源中字段的用户友好名称。
- DataSourceInfo 函数从数据源提供此元数据。
- 卡片中的控件应使用 Parent.DisplayName 来引用字段的名称。
错误 – 验证失败时要为此字段显示的用户友好错误消息。
- 调用 SubmitForm 时设置此属性。
- 该消息根据数据源的元数据和检查卡的 Required 属性描述验证问题。
必需 – 卡片是否编辑数据源的字段必须包含值。
- DataSourceInfo 函数提供数据源中所需的元数据。
- 卡片中的控件应使用 Parent.Required 来确定该卡片的字段是否是必需的。
更新 – 要写回字段数据源的值。
- 使用此属性的公式从卡片的编辑控件中提取值,以便写回数据源。 例如,将卡片的 Update 属性设置为 Slider.Value ,以使用该卡片中的滑块中的值更新数据源。
宽度 – 控件的左边缘和右边缘之间的距离。
WidthFit – 控件是否自动水平增长以填充容器控件(如 编辑窗体 控件)中的任何空白空间。 如果多个卡的此属性设置为 true,则空间将划分为两者。 有关详细信息,请参阅 “了解数据窗体布局”。
其他属性
BorderColor – 控件边框的颜色。
BorderStyle – 控件的边框是 Solid、 Dashed、 Dotted 还是 None。
BorderThickness – 控件边框的粗细。
填充 – 控件的背景色。
高度 – 控件的上边缘和下边缘之间的距离。
有效 – 卡片 或 编辑表单 控件是否包含有效的条目,准备提交到数据源。
可见 – 控件是显示还是隐藏。
X – 控件左边缘与其父容器(如果没有父容器,则为屏幕)左边缘之间的距离。 对于包含多个列的容器中的 Card 控件,此属性确定卡片所在的列。
Y – 控件上边缘与其父容器(如果没有父容器,则为屏幕)上边缘之间的距离。 对于包含多行的容器中的 卡片 控件,此属性确定卡片所在的行。
例子
有关示例,请参阅 “了解数据卡 ”和 “了解数据表单”布局 。
辅助功能指南
颜色对比度
在以下两者之间必须有足够的颜色对比度:
屏幕阅读器支持
- DisplayName 必须存在。