模型驱动窗体上嵌入的画布应用包含名为 ModelDrivenFormIntegration 的特殊控件。 此控件负责将上下文数据从主机模型驱动的窗体带入嵌入式画布应用。
重要
要与 ModelDrivenFormIntegration 控件交互，画布应用必须通过经典表单设计器在模型驱动表单的画布应用控件属性中选择自定义进行创建。 更多信息：使用传统体验嵌入画布应用
本文介绍控件 ModelDrivenFormIntegration 上可用的属性和动作。 在经典窗体设计器中使用 Canvas 应用控件属性 UI 创建画布应用时，可在 Power Apps Studio 中自定义此控件。
mod
| 属性或操作 | 描述 |
|---|---|
| DataSource | 应设置为连接到主机模型驱动窗体的父表的数据源。 在嵌入新画布应用时自动设置。 在嵌入现有画布应用时，可以从画布应用树视图配置 ModelDrivenFormIntegration 数据源。 DataSource 的值应始终引用应用嵌入到的窗体的表。 该值不应通过任何方式进行筛选或修改。 |
| 项目 | 支持嵌入式画布应用访问主机模型驱动窗体中的行的只读属性。 举例来说，要获取名称为 accountnumber 且显示名称为 Account Number 的列的值，您可以使用 ModelDrivenFormIntegration.Item.accountnumber 或 ModelDrivenFormIntegration.Item.'Account Number'。 |
| OnDataRefresh | 此属性中的公式在主机模型驱动窗体保存数据时接受评估。 请使用它来刷新连接到主机模型驱动窗体的父表的数据源，并执行设置或更新变量这样的其他操作。 举例来说，将其设置为下面的公式将刷新客户数据源，并将名为 CurrentAccountNumber 的变量设置为当前行的客户编号列的值。 Refresh(Accounts); Set(CurrentAccountNumber, ModelDrivenFormIntegration.Item.'Account Number') OnDataRefresh 操作应仅用于刷新嵌入式画布应用中的数据。 我们不建议您使用 OnDataRefresh 操作来保存嵌入式画布应用中的更改。 详细信息：在嵌入式画布应用中保存数据 |
| RefreshForm | 刷新主机模型驱动窗体上的数据。 请参阅在主机窗体上执行预定义操作了解详细信息。 |
| SaveForm | 保存主机模型驱动窗体上的数据。 请参阅在主机窗体上执行预定义操作了解详细信息。 |
| NavigateToMainForm | 在主机模型驱动窗体上导航到主窗体并显示指定行。 请参阅在主机窗体上执行预定义操作了解详细信息。 |
| NavigateToView | 在主机模型驱动窗体中导航到视图。 请参阅在主机窗体上执行预定义操作了解详细信息。 |
| OpenQuickCreateForm | 打开表的默认快速创建窗体。 请参阅在主机窗体上执行预定义操作了解详细信息。 |
| 数据 | 框架用于将某些关键数据从主机模型驱动窗体发送到嵌入式画布应用的只读属性。 请勿使用此属性。 使用“项目”访问主机模型驱动窗体中的行。 |
在应用启动时，ModelDrivenFormIntegration 控件数据不可用
在应用启动时，ModelDrivenFormIntegration.Item 属性不能保证提供数据。 应用应设计为使用类似 !IsBlank(ModelDrivenFormIntegration.Item)表达式等待此数据，或者应用应使用类似 LookUp(Accounts, Account = GUID(First(ModelDrivenFormIntegration.Data).ItemId))表达式显式检索记录。
另请参阅
在模型驱动的窗体上嵌入画布应用
在模型驱动窗体上添加嵌入式画布应用
从嵌入的画布应用内在主机窗体上执行预定义操作
共享嵌入式画布应用
嵌入式画布应用使用指南