keywords (Domino DTD)

Represents a Notes list field.

Containment Hierarchy

Contained by: <field>

Contains: <textlist>, <formula>

Syntax

<!ELEMENT keywords ( textlist | formula )?>

Content

( textlist | formula )?

Contains an optional <textlist> or <formula> element.

Attributes

<!ATTLIST keywords

ui

(%keywords.ui;)

"dialoglist"

borderstyle

(%keywords.borders;)

"single"

allownew

%boolean;

"false"

recalconchange

%boolean;

#IMPLIED

recalcchoices

%boolean;

"false"

columns

%integer;

#IMPLIED

helperbutton

%boolean;

"true"

%reading.order.attrs;

>

allownew

Allows users to add values not included in the current list of options.

borderstyle

Style of the border surrounding the list field; the choices are defined in the %keywords.borders; entity.

columns

Displays the options across the specified number of columns.

helperbutton

Displays the entry helper button for a dialog list field. The entry helper button is the down-arrow button that a user clicks to display a dialog box listing the field choices.

recalcchoices

Refreshes the choices in a list field when the user refreshes the document.

recalconchange

Refreshes all the fields on a form only after the user selects a value for a specific choice field.

ui

Types of list fields that the end user sees, as defined in the %keywords.ui; entity.

Defined entities for <keywords> element

The %keywords.borders; entity lists border styles for list fields.

Syntax:

<!ENTITY % keywords.borders "none | single | inset ">

The following border styles apply to the radio button and checkbox options of the %keywords.ui; entity only:

inset

Applies a rectangular, grey background behind the list field options, which clearly distinguishes the list from the form background.

none

Applies no border to group the list field choices.

single

Surrounds the list field options with a single-line black border. If the form has a background color, it also displays within the border surrounding the list options.

The %keywords.ui; entity lists the types of fields that present users with a list of choices.

Syntax:

<!ENTITY % keywords.ui "dialoglist | checkbox | radiobutton | combobox | listbox ">

checkbox

Displays options in a list with checkboxes to the left of each option. Users click the checkbox to make a selection. Users can select more than one option.

combobox

Displays a drop-down list box. Users click the down-arrow button of the drop-down list box to display the available options, then click an option to make a selection. Users can select only one option.

dialoglist

Displays an empty field with a down-arrow button beside it. When users click the down-arrow button, a Select Keywords dialog box displays listing the options. A Notes dialoglist field can be set to enable users to select only one or more than one option.

listbox

Displays a single row of a list and up and down arrows that a user can click to view the other rows in the list. Users can select only one option.

radiobutton

Displays options in a list with circles to the left of each option. Users click the circle to make a selection. Users can select only one option. Selecting a second option deselects the first option automatically.