XSetWMProto(3x) — HPUX 9.05

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.

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