XTSOLgetPropLabel(3X11TSOL)

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

NAME

XTSOLgetPropLabel- Get 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;

XTSOLgetPropLabel(display, window, property, cmwlabel);

DESCRIPTION

Client requires the PRIV_WIN_DAC_READ and PRIV_WIN_MAC_READ privileges. XTSOLgetPropLabel() is used to get the CMW label associated with a property hanging on a window.

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 get.

property

Specifies the property atom.

cmwlabel

Returns a CMW label that is the current CMW label of the specified property. This label contains an SL. Client needs to provide a bclabel_t type storage and passes the address of this storage as the function argument. Client must provide a pointer to bclabel_t.

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

SEE ALSO

XTSOLgetPropAttributes(3X11TSOL), XTSOLsetPropLabel(3X11TSOL)

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