WSFK_PROG(3W)
NAME
wsfk_prog − set programmable soft keys
SYNOPSIS
int wsfk_prog (fd,key,label,separator);
int fd;
int key;
char *label;
char separator;
DESCRIPTION
fd is an integer file descriptor for an opened graphic window type device interface.
key is the key label number to set. 1 thru 8 are for keys f1 thru f8 respectively.
label a pointer to a null terminated character string. Only the first 16 bytes are used. If less than 16 characters are supplied, blanks are assumed for the remaining characters. Keys 1 through 8 are displayed as two rows of eight 1-byte characters. If the eighth byte is the first byte of a 2-byte character, then all bytes from the eighth byte on are shifted up by one (eight goes to nine, nine goes to ten, etc) and the eighth byte is replaced with a space. This causes the 2-byte character to be wrapped to the second line instead of being split across the lines. If the last byte is the first byte of a 2-byte character, the byte is truncated.
separator
indicates whether or not to display a horizontal line to separate the the shifted and unshifted text for the sfk. If separator is non-zero, the separator line is displayed. If separator is zero, the separator line is not displayed.
DISCUSSION
Set the displayed string for a particular programmable soft key label. When the soft keys are displayed, the specified string will be displayed for that soft key. If a soft key is selected via SELECT or locator button, the key code for that soft key will be sent.
HARDWARE DEPENDENCIES
Series 500:
HP-15 (2-byte) characters are not supported on Series 500.
SEE ALSO
DIAGNOSTICS
A return of -1 indicates failure; otherwise 0 is returned. See errno(2) for more information.
Hewlett-Packard Company — May 11, 2021