column (Domino DTD)

Represents a view column.

Containment Hierarchy

Contained by: <folder>, <view>

Contains: <font>, <columnheader>, <datetimeformat>, <numberformat>, <code>

Syntax

<!ELEMENT column ( font?, columnheader?, datetimeformat?, numberformat?, code* )>

Content

font?, columnheader?, datetimeformat?, numberformat?, code*

Contains optional <font>, <columnheader>, <datetimeformat>, and <numberformat> elements, followed by any number of <code> elements.

Attributes

<!ATTLIST column

align

(%simple.aligns;)

#IMPLIED

showasicons

%boolean;

"false"

resizable

%boolean;

"true"

responsesonly

%boolean;

"false"

hidden

%boolean;

"false"

twisties

%boolean;

"false"

sort

(%sort.orders;)

#IMPLIED

sortnocase

%boolean;

#IMPLIED

sortnoaccent

%boolean;

#IMPLIED

separatemultiplevalues

%boolean;

"false"

categorized

%boolean;

"false"

resort

(%resort.options;)

#IMPLIED

resorttoview

%string;

#IMPLIED

resort2

(%sort.orders;)

#IMPLIED

resort2column

%integer;

#IMPLIED

totals

(%totals.options;)

#IMPLIED

hidedetailrows

%boolean;

#IMPLIED

showaslinks

%boolean;

#IMPLIED

itemname

CDATA

#IMPLIED

width

%number;

#IMPLIED

listseparator

(%list.separators;)

#IMPLIED

flatinr5

%boolean;

#IMPLIED

%reading.order.attrs;

>

align

Alignment of data in a column, as defined in the %simple.aligns; entity.

categorized

If true, categorizes a view, grouping all rows containing a specified value under a row displaying that value as the row heading.

flatinr5

If true, displays categorized columns created in Release 4 as flat columns in Release 5 or later.

hidden

If true, hides the column.

hidedetailrows

If true, hides the content of a column's rows and instead displays only the column total row. The style of the total row is defined in the totals attribute.

itemname

Name assigned to the column for programmatic use; similar to an alias assigned to design elements.

listseparator

Multi-value separators as defined in the %list.separators; entity. A column cannot contain the "blankline" option.

resizable

If true, users can resize the column by clicking and dragging the column borders.

resort

Users can click the column header to reverse the sort order (between ascending or descending) or to jump to a different view. See the %resort.options; entity for a list of options.

resort2

Users can sort a second column in a specified sorting order.

resort2column

If a value is supplied in the resort2 attribute, specifies the column that the secondary sort applies to.

resorttoview

If the resort attribute equals view, specifies the name of the view to jump to.

responsesonly

If true, displays response documents only.

showasicons

If true, displays column values as icons. For instance, if the value of a column row is 61, a key icon (which resides in a Notes file directory) displays instead of the number value.

sort

Sorting order as defined in the %sort.orders; entity.

sortnoaccent

Indicates whether to sort a column without regard to accent. By default, accent-sensitive sorting is not selected.

sortnocase

Indicates whether to sort a column without regard to case. By default, case-sensitive sorting is not selected.

separatemultiplevalues

If true, displays values from a multi-value field on separate rows.

showaslinks

If true, displays each value in the column as a link on the Web. This option overrides the default behavior of Domino, which designates to display only the values in the left-most column as links on the Web.

totals

Displays the column's total row in the style defined in the %totals.options; entity.

twisties

If true, displays a twistie when the row is expandable. A twistie is an icon that indicates that an expanded category in a view can be collapsed and a collapsed category can be expanded. Default is false.

width

Column width measured by the number of characters that can fit across a column.

Defined entities for <column> element

The %sort.orders; entity lists the sorting orders for a view column.

Syntax:

<!ENTITY % sort.orders " ascending | descending | none ">

The %resort.options; entity lists the options to set up user-sorted view column.

Syntax:

<!ENTITY % resort.options " %sort.orders;| both | toview ">

both

Users can toggle between ascending and descending sort orders.

toview

Displays a jump icon in the column header, indicating that a user can click the header to change to a different view.

The %totals.options; entity lists the types of totals you can display in the total row of a column.

Syntax:

<!ENTITY % totals.options "none | total | averageperchild | percentoverall | percentparent | averageperentry ">

averageperchild

Average of the numeric values per sub-category entry.

averageperentry

Average of the numeric values per document.

none

Does not display any totals.

percentoverall

Percentage of the numeric value for each document as it relates to the average for the rest of the view.

percentparent

Percentage of the numeric value for each category as it relates to the average for the rest of the view.

total

Grand total of the numeric values of all the main documents.

Example