U_MODREND

Modify the current rendition scheme

xcall U_MODREND([number], [descriptions], [windows], [areas], [field_numbers][, help_id])

Arguments

number

(optional) The number of user renditions to use. The default is 0. (n)

descriptions

(optional) The array of user rendition descriptions. If an array is not specified and user renditions are used, a default description is supplied. (a)

windows

(optional) The array of window IDs for user renditions on UNIX and OpenVMS. Each window is placed by a move 0,0. If an array is not specified and user renditions are used, a default window is created. All created windows are deleted upon exit of this subroutine. (Ignored on Windows.) (n)

areas

(optional) The array of which areas within windows will be affected on UNIX and OpenVMS. These areas can be added together for combined effects. If areas is 0, then none are affected. The default is all three areas. (Ignored on Windows.) (n)

D_RND_AREA = Processing area.

D_RND_BRDR = Border area.

D_RND_TITLE = Title area.

field_numbers

(optional) The array of field numbers that will be affected on UNIX or OpenVMS or WFN_ALL to affect all fields. The default is none. (Ignored on Windows.) (n)

help_id

(optional) The help identifier. (a)

Discussion

U_MODREND enables the user to modify the current rendition scheme without saving the changes. (U_EDITREND saves and restores renditions.)

U_MODREND cannot set the Input Field Processing rendition on Windows (though it can on UNIX and OpenVMS).

It cannot set the following on any platform: Disabled Input Field, Read-only Input Field Display, and Read-Only Field Processing. (These can be set only by U_REND and can be set only on UNIX and OpenVMS.)

U_MODREND modifies the rendition scheme that is held in memory and does not call any of the renditions file manipulation routines. So you can save the rendition scheme in any manner you choose.

U_MODREND recognizes the following menu entry names if they are included in a placed menu column:

O_CANCEL	Cancel changes.
O_EXIT	Exit.
O_HELP	Call the EHELP_METHOD subroutine and pass help_id.
O_DEFAULT	Set renditions to their default values.
O_PALETTE	Modify a color palette.
S_UP	Move to the previous selection window item.
S_DOWN	Move to the next selection window item.
S_LEFT	Move to the selection item in the previous column.
S_RIGHT	Move to the selection item in the next column.

Any other menu entries cause this subroutine to return with g_select set to true and g_entnam set to the selected menu entry.

O_EXIT causes U_MODREND to return to the calling program, but it does not clear g_select and g_entnam. This enables a layered calling routine to continue a seamless exit.

If a time-out occurs, g_select is set to true and g_entnam is set to the entry name specified in tkctl.def for g_time_entry. By default, g_time_entry is defined as “O_TIMEOUT”.