SharePointLookupFormControlProperties Type
The List Lookup control allows users to make selections based on values in a SharePoint list. The selection the user makes can be used to filter the available values in another List Lookup control on the form.
This topic describes the syntax of the FormControlProperty complex element with the type attribute of SharePointLookupFormControlProperties.
Syntax
<d2p1:FormControlProperties xmlns:d2p1="http://schemas.datacontract.org/2004/07/Nintex.Forms.SharePoint.FormControls" i:type="d2p1:SharePointLookupFormControlProperties">
<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-f73675005e15</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:ControlCssClass i:nil="true" />
<d2p1:ControlMode>String</d2p1:ControlMode>
<d2p1:CustomErrorMessage i:nil="true" />
<d2p1:CustomValidationFunction i:nil="true" />
<d2p1:DataField i:nil="true" />
<d2p1:DataFieldDisplayName i:nil="true" />
<d2p1:ExposeClientIdAsJavascriptVariable>Boolean</d2p1:ExposeClientIdAsJavascriptVariable>
<d2p1:ExposedClientIdJavascriptVariable i:nil="true" />
<d2p1:HelpText i:nil="true" />
<d2p1:HelpTextSet i:nil="true" />
<d2p1:IsEnabled>Boolean</d2p1:IsEnabled>
<d2p1:IsRequired>Boolean</d2p1:IsRequired>
<d2p1:Name i:nil="true" />
<d2p1:RequiredErrorMessage i:nil="true" />
<d2p1:UseCustomValidation>Boolean</d2p1:UseCustomValidation>
<d2p1:AllowMultipleValues>Boolean</d2p1:AllowMultipleValues>
<d2p1:CascadeFilterControl i:nil="true" />
<d2p1:CascadeFilterControlId>String</d2p1:CascadeFilterControlId>
<d2p1:CascadeFilterField i:nil="true" />
<d2p1:CascadeFilterValue i:nil="true" />
<d2p1:CascadeType>String</d2p1:CascadeType>
<d2p1:CustomNoneText i:nil="true" />
<d2p1:DataFieldLookupText i:nil="true" />
<d2p1:DefaultValue i:nil="true" />
<d2p1:DummyWeb i:nil="true" />
<d2p1:EmptyFilterAction>String</d2p1:EmptyFilterAction>
<d2p1:FilterFieldInternalFieldName i:nil="true" />
<d2p1:FilterFieldType i:nil="true" />
<d2p1:InternalFieldName i:nil="true" />
<d2p1:IsNewLookup>Boolean</d2p1:IsNewLookup>
<d2p1:LookupField>String</d2p1:LookupField>
<d2p1:LookupList i:nil="true" />
<d2p1:LookupView i:nil="true" />
<d2p1:LookupWeb i:nil="true" />
<d2p1:MultipleDisplayMode>String</d2p1:MultipleDisplayMode>
<d2p1:PrependId>Boolean</d2p1:PrependId>
<d2p1:RefDataId i:nil="true" />
<d2p1:RepeatColumns>Integer</d2p1:RepeatColumns>
<d2p1:RepeatDirection>String</d2p1:RepeatDirection>
<d2p1:RepeatLayout>String</d2p1:RepeatLayout>
<d2p1:SingleDisplayMode>String</d2p1:SingleDisplayMode>
<d2p1:UnlimitedLengthInDocumentLibrary>Boolean</d2p1:UnlimitedLengthInDocumentLibrary>
<d2p1:UseCustomNoneText>Boolean</d2p1:UseCustomNoneText>
</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..1 |
The line style. Values include: Bottom, Left, Right, and Top. |
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 | List Lookup | 1..1 |
The display name. |
FormControlTypeUniqueId | String | c0a89c70-0781-4bd4-8623-f73675005e15 | 1..1 |
The form control type unique id. |
FormType | String | ListForm | 1..1 |
The type of the form. |
InRepeater | Boolean | false | 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 | Boolean | false | 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 | Boolean | false | 1..1 |
True if this instance is locked; otherwise, false. |
IsVisible | Boolean | true | 1..1 |
True if this instance is visible; otherwise, false. |
PaddingWidth | Integer | 0 | 1..1 |
The width of the padding. |
TabIndex | Integer | 0 | 1..1 |
The index of the tab. |
UniqueId | String | Guid | 1..1 |
The unique id. For more information see "Guid Structure" on MSDN/ |
VariableSource | String | NotSet | 1..1 |
The source. Values include: External, SharePoint, Unspecified, and Workflow. |
VerticalAlign | String | blank | 1..1 |
The width of the padding. Valid values include:
|
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. |
ControlCssClass | String | blank | 1..1 |
The control CSS class. |
ControlMode | String | Auto | 1..1 |
Species the mode of the control. Valid values include:
|
CustomErrorMessage | String | blank | 1..1 |
The required error message. |
CustomValidationFunction | String | blank | 1..1 |
The custom validation function. |
DataField | String | blank | 1..1 |
The binding path field name. |
DataFieldDisplayName | String | blank | 1..1 |
The display name of the data field. |
ExposeClientIdAsJavascriptVariable | Boolean | false | 1..1 |
True if expose client id as JavaScript variable; otherwise, false. |
ExposedClientIdJavascriptVariable | String | blank | 1..1 |
The exposed client id JavaScript variable. |
HelpText | String | blank | 1..1 |
The help text. |
HelpTextSet | String | blank | 1..1 |
The help text set. |
IsEnabled | Boolean | true | 1..1 |
True if this instance is enabled; otherwise, false. |
IsRequired | Boolean | false | 1..1 |
True if this instance is required; otherwise, false. |
Name | String | blank | 1..1 |
The name of the control. |
RequiredErrorMessage | String | blank | 1..1 |
The required error message. |
UseCustomValidation | Boolean | false | 1..1 |
True if use custom validation; otherwise, false. |
AllowMultipleValues | Boolean | false | 1..1 | True if to allow multiple values; otherwise, false. |
CascadeFilterControl | String | blank | 1..1 | The cascade filter control. |
CascadeFilterControlId | String | 00000000-0000-0000-0000-000000000000 | 1..1 | Guid. The cascade filter control ID. |
CascadeFilterField | String | blank | 1..1 | The cascade filter field. |
CascadeFilterValue | String | blank | 1..1 | The cascade filter value. |
CascadeType | String | None | 1..1 |
The type of the cascade. Valid values include:
|
CustomNoneText | String | blank | 1..1 | The custom none text. |
DataFieldLookupText | String | blank | 1..1 | The binding path field name. |
DefaultValue | String | blank | 1..1 |
True if default value; otherwise, false. |
DummyWeb | String | blank | 1..1 | The dummy web. |
EmptyFilterAction | String | ShowNone | 1..1 |
The empty filter action. Valid values include:
|
FilterFieldInternalFieldName | String | blank | 1..1 | The SharepointGroupId. |
FilterFieldType | String | blank | 1..1 | The SharepointGroupId. |
InternalFieldName | String | blank | 1..1 | The SharepointGroupId. |
IsNewLookup | Boolean | true | 1..1 | True if new lookup; otherwise, false. |
LookupField | String | Title | 1..1 | The lookup field |
LookupList | String | blank | 1..1 | The name of the lookup list. |
LookupView | String | blank | 1..1 | The lookup view. |
LookupWeb | String | blank | 1..1 | The lookup web id. |
MultipleDisplayMode | String | Default |
1..
|
The multiple display mode. Valid values include:
|
PrependId | Boolean | false | 1..1 | True if to prepend id; otherwise, false. |
RefDataId | String | blank | 1..1 | The reference data ID. |
RepeatColumns | Integer | 1 | 1..1 | The repeat columns. |
RepeatDirection | String | Horizontal | 1..1 |
The repeat direction. Valid values include:
|
RepeatLayout | String | Table | 1..1 |
The repeat layout. Valid values include:
|
SingleDisplayMode | String | DropDownList | 1..1 |
The single display mode. Valid values include:
|
UnlimitedLengthInDocumentLibrary | Boolean | false | 1..1 | True if to allow unlimited length in document library; otherwise, false. |
UseCustomNoneText | Boolean | false | 1..1 | True if [use default none text]; otherwise, false. |
Example
The following example contains an example of the complex element.
<d2p1:FormControlProperties xmlns:d2p1="http://schemas.datacontract.org/2004/07/Nintex.Forms.SharePoint.FormControls" i:type="d2p1:SharePointLookupFormControlProperties">
<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>List Lookup</d2p1:DisplayName>
<d2p1:FormControlTypeUniqueId>c0a89c70-0781-4bd4-8623-f73675005e15</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>3716168f-a69b-4a7a-ae8a-98f08136d5f8</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:ControlCssClass i:nil="true" />
<d2p1:ControlMode>Auto</d2p1:ControlMode>
<d2p1:CustomErrorMessage i:nil="true" />
<d2p1:CustomValidationFunction i:nil="true" />
<d2p1:DataField i:nil="true" />
<d2p1:DataFieldDisplayName i:nil="true" />
<d2p1:ExposeClientIdAsJavascriptVariable>false</d2p1:ExposeClientIdAsJavascriptVariable>
<d2p1:ExposedClientIdJavascriptVariable i:nil="true" />
<d2p1:HelpText i:nil="true" />
<d2p1:HelpTextSet i:nil="true" />
<d2p1:IsEnabled>true</d2p1:IsEnabled>
<d2p1:IsRequired>false</d2p1:IsRequired>
<d2p1:Name i:nil="true" />
<d2p1:RequiredErrorMessage i:nil="true" />
<d2p1:UseCustomValidation>false</d2p1:UseCustomValidation>
<d2p1:AllowMultipleValues>false</d2p1:AllowMultipleValues>
<d2p1:CascadeFilterControl i:nil="true" />
<d2p1:CascadeFilterControlId>00000000-0000-0000-0000-000000000000</d2p1:CascadeFilterControlId>
<d2p1:CascadeFilterField i:nil="true" />
<d2p1:CascadeFilterValue i:nil="true" />
<d2p1:CascadeType>None</d2p1:CascadeType>
<d2p1:CustomNoneText i:nil="true" />
<d2p1:DataFieldLookupText i:nil="true" />
<d2p1:DefaultValue i:nil="true" />
<d2p1:DummyWeb i:nil="true" />
<d2p1:EmptyFilterAction>ShowNone</d2p1:EmptyFilterAction>
<d2p1:FilterFieldInternalFieldName i:nil="true" />
<d2p1:FilterFieldType i:nil="true" />
<d2p1:InternalFieldName i:nil="true" />
<d2p1:IsNewLookup>true</d2p1:IsNewLookup>
<d2p1:LookupField>Title</d2p1:LookupField>
<d2p1:LookupList i:nil="true" />
<d2p1:LookupView i:nil="true" />
<d2p1:LookupWeb i:nil="true" />
<d2p1:MultipleDisplayMode>Default</d2p1:MultipleDisplayMode>
<d2p1:PrependId>false</d2p1:PrependId>
<d2p1:RefDataId i:nil="true" />
<d2p1:RepeatColumns>1</d2p1:RepeatColumns>
<d2p1:RepeatDirection>Horizontal</d2p1:RepeatDirection>
<d2p1:RepeatLayout>Table</d2p1:RepeatLayout>
<d2p1:SingleDisplayMode>DropDownList</d2p1:SingleDisplayMode>
<d2p1:UnlimitedLengthInDocumentLibrary>false</d2p1:UnlimitedLengthInDocumentLibrary>
<d2p1:UseCustomNoneText>false</d2p1:UseCustomNoneText>
</d2p1:FormControlProperties>