NEW TO VERSION 4.0
Used to select a user from the current portal and assign the user as the one that initially created the record. This control is not required. XMod normally automatically assigns the user without any intervention on your part. However, this control has been added for those situations where administrators or moderators create a record on behalf of a user. This is especially useful in combination with XMod's ability to show a user only those records he/she has added. As with all XMod tags, the <adduserpicker> tag has a required child tag: <label> and several optional child tags.
|
ref |
Name of the control. This value must be unique within the form an must be a single word. (Required) [String value] Names must begin with a letter and may only include letters, numbers and the underscore character. |
|
class |
Name of the CSS Class used to style the control (Optional) [String value] |
|
width |
Specifies the width of the control. Values can be specified in various measurements: Pixel (px) "1px" Point (pt) "1pt" Centimeter (cm) "1cm" Millimeter (mm) "1mm" Inch (in) "1in" Em (em) "1em" |
|
roles |
A comma-delimited list of role names. If specified, only users that are members of the roles will be listed. |
|
displayfield |
This attribute determines what data will be displayed to the user. Valid values are:
|
|
noneselected |
This can be set to true or false. If true or if the attribute isn't specified, the control will create a "(None Selected)" list item or display the text provided in the noneselectedtext attribute if provided. |
|
noneselectedtext |
If noneselected is true or not specified, the control will display this attribute's value. If this attribute is not specified, "(None Selected)" will be used. |
|
style |
Same as the HTML style attribute.It allows you to apply CSS styling to the element (e.g. "color: red; border: solid 1px black;") (Optional). [String value] |
|
accesskey |
In browsers that support it, this property can be set to a character on the keyboard that can be used to set focus to the control. For instance, setting the value to F allows the user to access the control by pressing Alt+F on their keyboard (for Windows machines) |
|
Color of the background of the control. |
|
|
Color of the border around the control |
|
|
Style of the border around the control. |
|
|
borderwidth |
Width of the border around the control specified in units |
|
enabled |
Whether the control accepts input. May not work in older browsers. Valid values are true and false. The default value is true. |
|
A series of attributes such as font-bold, font-size, etc. that allow you to control how the text in the control is displayed. Click the link for more for the list of properties and their description. |
|
|
Color of the text within the control. |
|
|
The tab order of the control. |
|
|
tooltip |
In those browsers that support it, this attribute specifies the text displayed in the tooltip when the mouse is over the control. |
|
onfocus |
Javascript specified here will be executed when the input control receives focus. |
|
onblur |
Javascript specified here will be executed when the input control loses focus. |
|
onchange |
Javascript specified here will be executed when the contents of the input control have changed |
|
Javascript can be attached to certain events raised by this control. Click the link for more information. |
|
The caption used to identify the control |
|
|
Tells XMod to perform validation on the control. See <validate> attributes for more info. |
|
|
This child tag can be used for most anything but is typically used to display more information (usually in a help-related context) about the data entry item. |
<adduserpicker ref="AddUser" displayfield="userfullname">
<label>Assign Record to </label>
</adduserpicker>