embeddedcontrol (Domino DTD)

Represents an embedded control. An embedded control is a field in a form or mail memo that has been cut and pasted or forwarded.

Containment Hierarchy

Contained by: %richtext.nonhot.inline;

Contains: <text>, <font>, <embeddedkeywords>

Syntax

<!ELEMENT embeddedcontrol ( text? , font? , embeddedkeywords? )>

Content

text?, font?, embeddedkeywords?

Contains optional <text>, <font>, and <embeddedkeywords> elements.

Attributes

<!ATTLIST embeddedcontrol

type

(%embeddedcontrol.type;)

#IMPLIED

borderstyle

(%keywords.borders;)

#IMPLIED

columns

%integer;

"1"

alignwithbaseline

%boolean;

"false"

allowmultilines

%boolean;

"true"

width

%lenpct;

#IMPLIED

widthtype

(%embedded.fit.types;)

"fixed"

height

%length;

#IMPLIED

bgcolor

%color;

#IMPLIED

%reading.order.attrs;

>

alignwithbaseline

Boolean. If true, aligns the control's baseline with paragraph's. This attribute cannot be set to true if the type attribute is listbox.

allowmultilines

Boolean. If true, specifies that the control can span more than one row. For instance, displays your options in multiple rows if you have New Line set as the Display separator value for a list field.

bgcolor

Background color for the embedded control.

borderstyle

Defines the style of the control's border. Can by any of the styles defined in the %keywords.borders; entity.

columns

Number of columns in the embedded control.

height

Height of the embedded control.

type

Identifies the type of control being embedded. The options are defined in the %embeddedcontrol.type; entity.

width

Width, in inches, of the embedded control.

widthtype

Specifies how to size the control in relation to the design element it is embedded in. Can be any of the options in the %embedded.fit.types; entity.

Defined entities for <embeddedcontrol> element

The %embeddedcontrol.type; entity defines the types of controls that can be embedded.

Syntax:

<!ENTITY % embeddedcontrol.type "checkbox | combobox | edit | listbox | radiobutton ">

checkbox

A Notes check box field, which 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

A Notes combobox field, which 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.

edit

A standard field, can be a text, number, date/time or other field, set to display in the Native OS style, which is the style defined by the current user's operating system.

listbox

A Notes listbox field, which 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

A Notes radio button field, which 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.