XTSOLsetPropLabel(3)

NAME | SYNOPSIS | DESCRIPTION | PARAMETERS | ATTRIBUTES | RETURN VALUES | ERRORS | SEE ALSO

NAME

XTSOLsetPropLabel- Set the CMW label associated with a property hanging on a window

SYNOPSIS

#include <tsol/Xtsol.h>

Display *display;
Window window;
Atom property;
bclabel_t *cmwlabel;
enum setting_flag flag;

XTSOLsetPropLabel(*display, window, property, *cmwlabel, labelFlag);

DESCRIPTION

XTSOLsetPropLabel() is used to change the CMW label associated with a property hanging on a window. The client must have the PRIV_WIN_DAC_WRITE, PRIV_WIN_MAC_WRITE, and PRIV_WIN_UPGRADE_SL privileges.

PARAMETERS

display

Specifies a pointer to the Display structure; returned from XOpenDisplay().

window

Specifies the ID of the window whose property's CMW label you want to change.

property

Specifies the property atom.

cmwlabel

Specifies a pointer to a CMW label structure which contains a CMW label. Only a portion (depends on labelFlag) of the CMW label needs to be specified. The unspecified portion of the CMW label is not interpreted by the server.

labelFlag

Specifies which portion of the CMW label will be changed. Possible values are: SETCL_ALL and SETCL_SL.

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Availability	SUNWxwplt (available only on Trusted Solaris systems)
MT-Level	MT-Unsafe

RETURN VALUES

None

ERRORS

BadAccess

Lack of privilege

BadWindow

Not a valid window

BadAtom

Not a valid atom

BadValue

Not a valid labelFlag or cmwlabel

SEE ALSO

XTSOLgetPropAttributes(3), XTSOLgetPropLabel(3)

Trusted Solaris 8  Last Revised 30 Sep 1999

NAME | SYNOPSIS | DESCRIPTION | PARAMETERS | ATTRIBUTES | RETURN VALUES | ERRORS | SEE ALSO