Highlighting the Selection Character for a Menu Field

You can aid the user in determining what the selection character is for a menu field by highlighting this character. To use character selection, the character selection option FLDCHSELECT must be ON for the form. This is the system default.

Designer: You can change the selection character in the Designer. See the Designer User's Guide for more information. You can also change the selection character in your code, by calling the functions described below. You can make this change at any point after reading the form from the Designer library.

Code: You can change the selection character at any point after defining the menu field.

To change the position or the logical attribute of the selection character for a menu field, use the set field selection character function, sf_selectch():

void sf_selectch(ch_pos, ch_att, mfldp)

UCHAR ch_pos;

/* Position of selection character

*/

UCHAR ch_att;

/* Attribute to use for selection character

*/

MFIELDPTR mfldp;

/* Pointer to menu field 

*/

Numbering of characters in the field string starts at 0. To turn off character selection for a field, specify NOSELECT for ch_pos.

The following code example defines three menu fields and highlights the selection character (the capitalized character in the field string):

MFIELDPTR fld0p, fld1p, fld2p;



fld0p = mnf_def(0, 1, "Item 0", NULLP, NULLP, act_fp, mfmp);

fld1p = mnf_def(1, 1, "iTem 1", NULLP, NULLP, act_fp, mfmp);

fld2p = mnf_def(3, 1, "itEm 2", NULLP, NULLP, act_fp, mfmp);

sf_selectch(0, LFLDSELCH, fld0p);

sf_selectch(1, LFLDSELCH, fld1p);

sf_selectch(2, LFLDSELCH, fld2p);