NAME

wsetlabel − set label in window border

SYNOPSIS

int wsetlabel(fd,label);
int fd;
char *label;

DESCRIPTION

fd is an integer file descriptor for an opened window type device interface. 

label is a pointer to a null-terminated character string to be displayed as the label in the border of the window, the title in the SFK area, the title in the popup menu for this window, and the label in the icon for the window. 

DISCUSSION

This call sets the label to be displayed in the border of a window, the title in the SFK area, the title in the popup menu for the window, and the label in the icon for the window. 

Only the first 12 bytes of a label are displayed, except for the label in the border of a graphics window type, in which up to 128 bytes are displayed.  If the last byte in a label is the first byte of a 2-byte character, then the character is ignored and not displayed. 

HARDWARE DEPENDENCIES

Series 500:
Graphics window labels can contain no more than 12 characters on Series 500.

HP-15 (2-byte) characters are not supported on Series 500. 

SEE ALSO

wborder(1). 

DIAGNOSTICS

A return of -1 indicates failure; otherwise 0 is returned.  See errno(2) for more information.

Hewlett-Packard Company  —  May 11, 2021