You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: powerapps-docs/maker/model-driven-apps/form-designer-add-configure-subgrid.md
+12-2Lines changed: 12 additions & 2 deletions
Original file line number
Diff line number
Diff line change
@@ -23,22 +23,32 @@ search.app:
23
23
- D365CE
24
24
---
25
25
26
+
27
+
28
+
<!-- note from editor: I recommend removing the hyphen from "sub-grid" based on the style guide entry for sub: https://styleguides.azurewebsites.net/Styleguide/Read?id=2700&topicid=28872. I didn't change it here because I don't know how wide an impact that might have. -->
29
+
30
+
26
31
# Add and configure a sub-grid component on a form
27
32
A form that displays the details of a record can use a sub-grid component to display a list of related or unrelated records in a tabular format. Makers can add and configure a sub-grid component using the form designer.
28
33
29
34
## Add a sub-grid component
30
-
You add a sub-grid component the same way as you add any other component. More information: [Add, move or delete components on a form](add-move-configure-or-delete-components-on-form.md)
35
+
You add a sub-grid component the same way as you add any other component. More information: [Add, configure, move, or delete components on a form](add-move-configure-or-delete-components-on-form.md)
31
36
32
37
## Configure a sub-grid component
33
38
These are the properties available to configure when using a sub-grid component on a form using the form designer.
34
39
40
+
41
+
42
+
<!--note from editor: Drop-down should be used as an adjective only. Please add "list," "menu," or whatever else is appropriate with drop-down in line 50. -->
43
+
44
+
35
45
|Area |Name |Description |
36
46
|---------|---------|---------|
37
47
|**Display options**|**Label**| The localizable label for the sub-grid visible to users. <br /><br />This property is required.|
38
48
|**Display options**|**Name**| The unique name for the sub-grid that is used when referencing it in scripts. The name can contain only alphanumeric characters and underscores. <br /><br />This property is required. |
39
49
|**Display options**|**Hide on phone**| The sub-grid can be hidden to render a condensed version of the form on phone screens. |
40
50
|**Display options**|**Show related records**| When selected, the sub-grid displays only records related to the current record that is displayed on the form. <br /><br />The **Entity** drop-down is also filtered to only list entities that are related to the current entity. |
41
-
|**Display options**|**Entity**| The entity whose records you want to display in the sub-grid. <br /><br />When **Show related records** is selected the list of entities is filtered to show only entities that are related to the current entity. In addition to the entity name the name of the lookup field is also displayed in parentheses. |
51
+
|**Display options**|**Entity**| The entity whose records you want to display in the sub-grid. <br /><br />When **Show related records** is selected, the list of entities is filtered to show only entities that are related to the current entity. In addition to the entity name, the name of the lookup field is also displayed in parentheses. |
42
52
|**Display options**|**Default view**| The view of the entity selected in the **Entity** property that will be used to get and display the list of records in the sub-grid. |
43
53
|**Display options**|**Allow users to change view**| When selected, app users can change from the **Default view** to another view of the entity selected in the **Entity** property. |
44
54
|**Display options**|**Show all views**| When selected, app users can change from the **Default view** to all other views of the entity selected in the **Entity** property. <br /><br />This property is only available when **Allow users to change view** is selected. |
0 commit comments