L_SECT

Place text in a list header, footer, or title

WSupported on Windows

USupported on Unix

VSupported on OpenVMS

NSupported in Synergy .NET

xcall L_SECT(list_id, [text][, text_flag, ...])

Arguments

list_id

The ID of the list in which to place text. (n)

text

(optional) The text to display. (a)

text_flag

(optional) One or more of the following text flags: (n)

D_HEADER

Display text in the header section. (default)

D_FOOTER

Display text in the footer section.

D_TITLE

Display text in the title.

D_POSITION, row, col

The row and column of the text’s position

D_CLEAR

Clear the entire line of text. (default)

D_CLRBOL

Clear to the beginning of the line.

D_CLREOL

Clear to the end of the line.

D_NOCLEAR

Don’t clear the line of text.

D_COLRESIZE

Resize ActiveX list columns if the user hasn’t manually resized them. (default)

D_COLNORESIZE

Don’t resize ActiveX list columns.

D_COLFORCESIZE

Resize ActiveX list columns even if the user has manually resized them.

D_DISPLAY

Display text at the current position. (default)

D_LEFT

Left-justify the text.

D_CENTER

Center the text.

D_RIGHT

Right-justify the text.

D_VLINE

Convert “¦” characters to vertical lines for ActiveX lists or vertical bar line-drawing characters on Unix or OpenVMS. (default)

D_NOVLINE

Don’t convert “¦” characters to vertical lines for ActiveX lists or vertical bar line-drawing characters on Unix or OpenVMS.

Discussion

L_SECT clears text from and/or places text into a list header, footer, or title. By default, text is displayed at the current position (D_DISPLAY), which is generally left-justified, unless a previous call to L_SECT has changed the current position.

L_SECT clears the entire affected row (D_CLEAR) by default unless you specify one of the other clearing flags (D_CLRBOL, D_CLREOL, D_NOCLEAR).

The D_POSITION flag positions the text by specifying the row and column on which the text should begin. Toolkit positions the text before it clears or justifies text, so justification nullifies a col setting. Additionally, if you pass D_POSITION, you must pass both row and col.

On Windows, the active theme determines the location of the title; D_TITLE, has no effect.

When using D_HEADER or D_FOOTER with an ActiveX Toolkit list, use vertical bars (|) to explicitly divide column headings or footers and to set the minimum column width. If you don’t use vertical bars (or if you pass D_NOVLINE), Toolkit will divide the text in ways that may not make sense. Don’t use D_CENTER or D_RIGHT, which aren’t designed to be used in this situation.

By default, ActiveX Toolkit list columns resize automatically when a column header or footer is changed, unless the user has manually resized a column. You can change this behavior by passing D_COLNORESIZE to prevent resizing or D_COLFORCESIZE to force resizing even when a user has resized a column.

On Unix and OpenVMS, only the D_LEFT, D_CENTER, and D_RIGHT flags have any effect for D_TITLE, and the text is centered by default.

Examples

The following clears the list header by specified by mylst and then centers the message within it.

xcall l_sect(mylst, "No available items", D_HEADER, D_CLEAR, D_CENTER)