<dnnfilelist>

A custom control, used to allow the user to select a file in the DNN file system.

 

ATTRIBUTES:

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.

class

Name of the CSS Class used to style the text box (Optional) [String value]

extensions

Enables you to filter the type of files loaded into the (Optional) [String value]

control at runtime. Do that by providing a comma-delimited list of file extensions. Some examples:

- Images: jpg,gif,png

- Text Files: txt

- HTML Files: htm,html

If extensions is blank or not specified, all files will be loaded into the control.

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]

required

If true, the user will be required to enter a value (Optional) [true or false]

errormessage

If the field is required but has not been filled out by the user, XMod will display the contents of this attribute. If this attribute isn't specified, XMod will default to "FieldName Is Required" (Optional) (new to version 3.0)

 

ADDITIONAL ATTRIBUTES (New to Version 4.0)

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.

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.

height

The height of the control, specified in units

tabindex

The tab order of the control.

width

The width of the control, specified in units.

Client-Side Events

Javascript can be attached to certain events raised by this control. Click the link for more information.

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

<dnnfilelist ref="dnnfile2" extensions="jpg,gif" required="true">

  <label>Choose A File: </label>

</dnnfilelist>