RepeaterFormControlProperties Type

The Repeating Section is a control that can contain a set of other controls, and allows a user of the form to insert multiple instances (rows) of the set as required. A typical use is an expenses form where each row is an expense item.

This topic describes the syntax of the FormControlProperty complex element with the type attribute of RepeaterFormControlProperties.

Syntax


<d2p1:FormControlProperties i:type="d2p1:RepeaterFormControlProperties">
      <d2p1:Border>
        <LinePosition>Top</LinePosition>
        <LinePosition>Bottom</LinePosition>
        <LinePosition>Left</LinePosition>
        <LinePosition>Right</LinePosition>
      </d2p1:Border>
      <d2p1:BorderColor>String</d2p1:BorderColor>
      <d2p1:BorderStyle>String</d2p1:BorderStyle>
      <d2p1:BorderWidth>Integer</d2p1:BorderWidth>
      <d2p1:CanResizeAtRuntime>Boolean</d2p1:CanResizeAtRuntime>
      <d2p1:ControlVersion>String</d2p1:ControlVersion>
      <d2p1:CssClass i:nil="true" />
      <d2p1:DisplayName>String</d2p1:DisplayName>
      <d2p1:FormControlTypeUniqueId>c0a89c70-0781-4bd4-8623-f73675005e16</d2p1:FormControlTypeUniqueId>
      <d2p1:FormType>String</d2p1:FormType>
      <d2p1:InRepeater>Boolean</d2p1:InRepeater>
      <d2p1:InsertReferences xmlns:d4p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays" />
      <d2p1:InternalPropertyBag xmlns:d4p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays" />
      <d2p1:IsDirty>Boolean</d2p1:IsDirty>
      <d2p1:IsLocked>Boolean</d2p1:IsLocked>
      <d2p1:IsVisible>Boolean</d2p1:IsVisible>
      <d2p1:PaddingWidth>Integer</d2p1:PaddingWidth>
      <d2p1:TabIndex>Integer</d2p1:TabIndex>
      <d2p1:UniqueId>String</d2p1:UniqueId>
      <d2p1:VariableSource>String</d2p1:VariableSource>
      <d2p1:VerticalAlign>String</d2p1:VerticalAlign>
      <d2p1:BackgroundColor i:nil="true" />
      <d2p1:Bold>Boolean</d2p1:Bold>
      <d2p1:FontColor i:nil="true" />
      <d2p1:FontFamily i:nil="true" />
      <d2p1:FontFamilyItemId i:nil="true" />
      <d2p1:FontSize i:nil="true" />
      <d2p1:FontSizeItemId i:nil="true" />
      <d2p1:HorizontalAlignment>String</d2p1:HorizontalAlignment>
      <d2p1:Italics>Boolean</d2p1:Italics>
      <d2p1:StrikeThrough>Boolean</d2p1:StrikeThrough>
      <d2p1:ThemeClass i:nil="true" />
      <d2p1:Underline>Boolean</d2p1:Underline>
      <d2p1:AddLinkText i:nil="true" />
      <d2p1:AlternateItemCssClass>String</d2p1:AlternateItemCssClass>
      <d2p1:BackImageUrl></d2p1:BackImageUrl>
      <d2p1:DataField i:nil="true" />
      <d2p1:DefaultRows>Integer</d2p1:DefaultRows>
      <d2p1:DefaultValue i:nil="true" />
      <d2p1:HideAddDeleteLinks>Boolean</d2p1:HideAddDeleteLinks>
      <d2p1:IsRichText>Boolean</d2p1:IsRichText>
      <d2p1:ItemCssClass>String</d2p1:ItemCssClass>
      <d2p1:MaximumRows>Integer</d2p1:MaximumRows>
      <d2p1:MinimumRows>Integer</d2p1:MinimumRows>
      <d2p1:Name i:nil="true" />
      <d2p1:Title i:nil="true" />
</d2p1:FormControlProperties>

        

Element Characteristics

Characteristic Description
Data type and length String
Default value None
Cardinality 1..1: Required element that occurs only once.

Element Attributes

Attribute Description
  Required

Relationships

Relationship Element
Parent element FormForm/FormControls
Child elements See the child element table.

Parent Element Namespace

Prefix Namespace
d2p1 http://schemas.datacontract.org/2004/07/Nintex.Forms.FormControls

Parent Element

Attribute Description
  Required

Child Elements

Name Data Type Default value Cardinality Description
Border String blank 1..*

The line style. Values include: Bottom, Left, Right, and Top.

<LinePosition>Top</LinePosition> <LinePosition>Bottom</LinePosition> <LinePosition>Left</LinePosition> <LinePosition>Right</LinePosition>

BorderColor String #000000 1..1

The color of the line.

BorderStyle String Solid 1..1

The line style. Values include: Dashed, Dotted, Double, Groove, Inset, None, None, NotSet, Outset, Ridge, and Solid. For more information see the base enumeration documentation on MSDN.

BorderWidth Integer 2 1..1

The width of the line in pixels.

CanResizeAtRuntime Boolean true 1..1

Indicates if the control can resize at run time.

ControlVersion String 101.1.1.0 1..1

The version number of the control.

CssClass String blank 1..1

The CSS class.

DisplayName String Repeating Section 1..1

The display name.

FormControlTypeUniqueId c0a89c70-0781-4bd4-8623-f73675005e16 blank 1..1

The form control type unique id.

FormType ListForm blank 1..1

The type of the form.

InRepeater false blank 1..1

Value is true if in repeater; otherwise, false.

InsertReferences String blank 1..*

The insert references.

InternalPropertyBag String blank 1..*

The internal property bag.

IsDirty false blank 1..1

True if the object is dirty; otherwise, false. The value indicating whether the control exists in any layout. If this flag is set then it is safe to delete the control from the list.

IsLocked false blank 1..1

True if this instance is locked; otherwise, false.

IsVisible true blank 1..1

True if this instance is visible; otherwise, false.

PaddingWidth 0 blank 1..1

The width of the padding.

TabIndex 0 blank 1..1

The index of the tab.

UniqueId 7e2aa755-fe21-48e9-bf33-97a0ec433331 blank 1..1

The unique id. For more information see "Guid Structure" on MSDN/

VariableSource Unspecified blank 1..1

The source. Values include: External, SharePoint, Unspecified, and Workflow.

VerticalAlign NotSet blank 1..1

The width of the padding. Valid values include:

  • Bottom

    Text or object is aligned with the bottom of the enclosing control.

  • Middle

    Text or object is aligned with the center of the enclosing control.

  • NotSet

    Vertical alignment is not set.

  • Top

    Text or object is aligned with the top of the enclosing control.

BackgroundColor String blank 1..1

The color of the background.

Bold Boolean false 1..1

True if bold; otherwise, false.

FontColor String blank 1..1

The color of the font.

FontFamily String blank 1..1

The font family.

FontFamilyItemId String blank 1..1

The font family item id.

FontSize String blank 1..1

The size of the font.

FontSizeItemId String blank 1..1

The font size item id.

HorizontalAlignment String NotSet 1..1

The horizontal alignment. Values include: Center, Justify, Left, NotSet, and Right. For more information, see "Horizontal Enumeration" in MSDN.

Italics Boolean false 1..1

True if italics; otherwise, false.

StrikeThrough Boolean false 1..1

True if [strike through]; otherwise, false.

ThemeClass String blank 1..1

The theme class.

Underline Boolean false 1..1

True if use custom validation; otherwise, false.

AddLinkText String blank 1..1 The add new row link text.
AlternateItemCssClass String nf-item-alternating 1..1 The alternate item CSS class.
BackImageUrl String blank 1..1 The URL of the background image.
DataField String blank 1..1 The binding path field name.
DefaultRows Integer 1 1..1 The default no of rows to display by the repeater.
DefaultValue String blank 1..1

True if default value; otherwise, false.

HideAddDeleteLinks Boolean false 1..1

True if default value; otherwise, false.

IsRichText Boolean false 1..1 true if this instance is rich text; otherwise, false.
ItemCssClass String nf-item 1..1 The item CSS class.
MaximumRows Integer 10000 1..1 The maximum rows to display by the repeater.
MinimumRows Integer 1 1..1 The minimum rows to display by the repeater.
Name String blank 1..1

The name of the control.

Title String blank 1..1 The title.

Example

The following example contains an example of the complex element.



<d2p1:FormControlProperties i:type="d2p1:RepeaterFormControlProperties">
      <d2p1:Border>
        <LinePosition>Top</LinePosition>
        <LinePosition>Bottom</LinePosition>
        <LinePosition>Left</LinePosition>
        <LinePosition>Right</LinePosition>
      </d2p1:Border>
      <d2p1:BorderColor>#000000</d2p1:BorderColor>
      <d2p1:BorderStyle>Solid</d2p1:BorderStyle>
      <d2p1:BorderWidth>2</d2p1:BorderWidth>
      <d2p1:CanResizeAtRuntime>true</d2p1:CanResizeAtRuntime>
      <d2p1:ControlVersion>101.1.1.0</d2p1:ControlVersion>
      <d2p1:CssClass i:nil="true" />
      <d2p1:DisplayName>Repeating Section</d2p1:DisplayName>
      <d2p1:FormControlTypeUniqueId>c0a89c70-0781-4bd4-8623-f73675005e16</d2p1:FormControlTypeUniqueId>
      <d2p1:FormType>ListForm</d2p1:FormType>
      <d2p1:InRepeater>false</d2p1:InRepeater>
      <d2p1:InsertReferences xmlns:d4p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays" />
      <d2p1:InternalPropertyBag xmlns:d4p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays" />
      <d2p1:IsDirty>false</d2p1:IsDirty>
      <d2p1:IsLocked>false</d2p1:IsLocked>
      <d2p1:IsVisible>true</d2p1:IsVisible>
      <d2p1:PaddingWidth>0</d2p1:PaddingWidth>
      <d2p1:TabIndex>0</d2p1:TabIndex>
      <d2p1:UniqueId>7e2aa755-fe21-48e9-bf33-97a0ec433331</d2p1:UniqueId>
      <d2p1:VariableSource>Unspecified</d2p1:VariableSource>
      <d2p1:VerticalAlign>NotSet</d2p1:VerticalAlign>
      <d2p1:BackgroundColor i:nil="true" />
      <d2p1:Bold>false</d2p1:Bold>
      <d2p1:FontColor i:nil="true" />
      <d2p1:FontFamily i:nil="true" />
      <d2p1:FontFamilyItemId i:nil="true" />
      <d2p1:FontSize i:nil="true" />
      <d2p1:FontSizeItemId i:nil="true" />
      <d2p1:HorizontalAlignment>NotSet</d2p1:HorizontalAlignment>
      <d2p1:Italics>false</d2p1:Italics>
      <d2p1:StrikeThrough>false</d2p1:StrikeThrough>
      <d2p1:ThemeClass i:nil="true" />
      <d2p1:Underline>false</d2p1:Underline>
      <d2p1:AddLinkText i:nil="true" />
      <d2p1:AlternateItemCssClass>nf-item-alternating</d2p1:AlternateItemCssClass>
      <d2p1:BackImageUrl></d2p1:BackImageUrl>
      <d2p1:DataField i:nil="true" />
      <d2p1:DefaultRows>1</d2p1:DefaultRows>
      <d2p1:DefaultValue i:nil="true" />
      <d2p1:HideAddDeleteLinks>false</d2p1:HideAddDeleteLinks>
      <d2p1:IsRichText>false</d2p1:IsRichText>
      <d2p1:ItemCssClass>nf-item</d2p1:ItemCssClass>
      <d2p1:MaximumRows>10000</d2p1:MaximumRows>
      <d2p1:MinimumRows>1</d2p1:MinimumRows>
      <d2p1:Name i:nil="true" />
      <d2p1:Title i:nil="true" />
</d2p1:FormControlProperties>


        

Related information

Form XML Complex Elements