NAME

XSetWMProtocols — set a window’s XA_WM_PROTOCOLS property. 

SYNOPSIS

Status XSetWMProtocols(display, w, protocols, \ count)
   Display ∗display;
   Window w;
   Atom ∗protocols;
   int count;

ARGUMENTS

displaySpecifies a connection to an X server; returned from XOpenDisplay(). 

wSpecifies the window. 

protocolsSpecifies the list of protocols. 

countSpecifies the number of protocols in the list. 

RETURNS

Zero on failure, non-zero on success. 

AVAILABILITY

Release 4 and later. 

DESCRIPTION

XSetWMProtocols() sets the XA_WM_PROTOCOLS property on the specified window to the list of atoms specified by the protocols argument.  The property is stored with a type of ATOM and a format of 32.  If it cannot intern the XA_WM_PROTOCOLS atom, XSetWMProtocols() returns a zero status.  Otherwise, it returns a non-zero status. 

The list of standard protocols at present is as follows:

WM_TAKE_FOCUSAssignment of keyboard focus

WM_SAVE_YOURSELFSave client state warning

WM_DELETE_UNKNOWNRequest to delete top-level window

For more information, see Volume One, Chapter 10, Interclient Communication. 

ERRORS

BadAlloc
BadWindow

SEE ALSO

XGetWMProtocols(). 

Xlib Reference Manual