<captcha>

Used to accept help ensure that the form is being submitted by a human being. When included in the form, it displays a random series of letters and numbers on a randomly colored background. The user must type the letters and numbers he or she sees into a textbox for verification. If input value matches what is displayed in the image, the submission is accepted. If they do not match, the form is not submitted. The <captcha> control uses the DotNetNuke CAPTCHA control under-the-hood. As with all XMod tags, the <captcha> tag has a required child tag: <label> .

ATTRIBUTES <input>:

ref	Name of the field whose value you wish to insert (Required) [String value] Names must begin with a letter and may only include letters, numbers and the underscore character.
text	The help text to display to the user. The text is displayed above the input box where the user enters the captcha value.
errormessage	The text that will be displayed to the user if the text he/she enters does not match the value displayed in the image. IMPORTANT: Most XMod controls accept all lower-case attribute names or are case-insensitive. However, the ErrorMessage attribute of the underlying DNN captcha control will not recognize this property if you do not capitalize at least the E or M in the attribute.
errorstyle-cssclass	The CSS class used to style the error message (typically "NormalRed")
captchachars	A non-delimited series of characters to be used in the values displayed to the users. This is optional.
captchaheight	The height (Unit) of the captcha image (optional)
captchalength	The number of characters to include in the captcha value. The default value is 6. (optional)
captchawidth	The width (Unit) of the captcha image (optional)
width	Specifies the width of the full control. Values are specified in Units
height	Specifies the height of the full control. Values are specified in Units

ADDITIONAL ATTRIBUTES

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)
backcolor	Color of the background of the control.
bordercolor	Color of the border around the control
borderstyle	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.
Font Properties	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.
forecolor	Color of the text within the control.
tabindex	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.

CHILD TAGS

label	The caption used to identify the control
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.

ATTRIBUTES <info>:

See <info> tag topic

EXAMPLE

<label>Validation</label>

</captcha>