<cell> (FormXml)

应用到: CRM 2016 on-prem, CRM Online

窗体布局元素。单元格包含要显示的标签和控件。

语法

<cell
 addedby="String"
 availableforphone=["0" | "1" | "true" | "false"]
 auto=["0" | "1" | "true" | "false"]
 colspan=Integer
 id="String"
 ischartcell=["0" | "1" | "true" | "false"]
 ispreviewcell=["0" | "1" | "true" | "false"]
 isstreamcell=["0" | "1" | "true" | "false"]
 istilecell=["0" | "1" | "true" | "false"]
 labelid="String"
 locklevel=Integer 
 rowspan=Integer 
 showlabel=["0" | "1" | "true" | "false"]
 userspacer=["0" | "1" | "true" | "false"]
 visible=["0" | "1" | "true" | "false"]
 <control />
 <events />
 <labels />
</cell>

属性和元素

The following describes the attributes, child elements, and parent elements.

属性

Attribute	Description	Type	Usage
addedby	Identifies the name of the ISV or customizer that added the element.	String	Optional
availableforphone	Specifies whether the element is available for 适用于手机的 Microsoft Dynamics CRM.	Boolean	Optional
auto	Not used.	Boolean	Optional
colspan	Represents the number of columns used in the row to display the field.	Nonnegative Integer	Optional
id	Unique identifier for the cell. See Remarks.	String (FormGuidType)	Required
ischartcell	仅供内部使用。	Boolean	Optional
ispreviewcell	Used by the dashboard designer to indicate cells in which a user can insert different components. See Remarks.	Boolean	Optional
isstreamcell	仅供内部使用。	Boolean	Optional
istilecell	仅供内部使用。	Boolean	Optional
labelid	A unique id value for the cell label.	String (FormGuidType)	Optional
locklevel	Matches the field formatting property Lock the field on the form.	Non Negative Integer	Optional
rowspan	Represents the number of rows used to display the field in the form.	Non Negative Integer	Optional
showlabel	Determines whether to display the label for the field.	Boolean	Optional
userspacer	Specifies that the cell contains a spacer.	Boolean	Optional
visible	Determines whether the cell is visible on the form by default.	Boolean	Optional

子元素

Element	Description
<labels> (FormXml)	包含窗体标签定义。
<control> (FormXml)	指定要在窗体单元格中显示的控件。
<events> (FormXml)	包含单元格或窗体的所有事件定义。

父元素

Element	Description
<row> (FormXml)	指定用于组织窗体元素的行。

备注

If you create a new <tab> (FormXml), <section> (FormXml) or <cell> (FormXml) element by copying from an existing form definition or by manually editing an exported customization.xml file you should create a new GUID value for the id attribute. You should use a tool like guidgen.exe to guarantee a unique valid GUID value. The guidgen.exe is included as part of the Windows SDK.

If you do not specify a new GUID value for the element id, you must create a new GUID value for the labelid attribute and add the labelid attribute. If you have duplicate element id values AND do not specify a unique labelid attribute value you will not be able to uninstall your solution. To address this issue you must export the default solution containing the form definitions, edit each element in the existing forms to add a unique labelid value, and then import those modified form definitions.

The auto attribute is not used. If you want the control in the cell to expand to use all the available space, set the height attribute of the parent row element to auto.

If the rowspan is greater than 1, the number of row elements within the rows element must be equal to or greater than the value of the rowspan attribute.

The ispreviewcell attribute can be used to define dashboard templates. This attribute is not valid for forms.

元素信息

Schema Type	complexType
Validation File	FormXml.xsd
Number of Occurrences	0 or more
XPath	//FormXml/forms/systemform/form/tabs/tab/columns/column/sections/section/rows/row/cell | //FormXml/forms/systemform/form/header/rows/row/cell| //FormXml/forms/systemform/form/footer/rows/row/cell

另请参阅

概念

自定义实体窗体

其他资源

Form XML reference

Microsoft Dynamics CRM 2016 and Microsoft Dynamics CRM Online
Send comments about this topic to Microsoft.
© 2015 Microsoft. All rights reserved.