Index for Section 3X

Alphabetical listing for X

Bottom of page

XmDeactivateProtocol(3X)
OSF/Motif
NAME
  XmDeactivateProtocol - A VendorShell function that deactivates a protocol
  without removing it

SYNOPSIS
  #include <Xm/Xm.h>
  #include <Xm/Protocols.h>

  void XmDeactivateProtocol (shell, property, protocol)
	  Widget shell;
	  Atom property;
	  Atom protocol;

  void XmDeactivateWMProtocol (shell, protocol)
	  Widget shell;
	  Atom protocol;

DESCRIPTION
  XmDeactivateProtocol deactivates a protocol without removing it.  It
  updates the handlers and the property, if the shell is realized.  It is
  sometimes useful to allow a protocol's state information (callback lists,
  etc.) to persist, even though the client may choose to temporarily resign
  from the interaction. The main use of this capability is to gray/ungray
  f.send_msg entries in the Mwm system menu.  This is supported by allowing a
  protocol to be in one of two states:	active or inactive.  If the protocol
  is active and the shell is realized, the property contains the protocol
  Atom. If the protocol is inactive, the Atom is not present in the property.

  XmDeactivateWMProtocol is a convenience interface.  It calls
  XmDeactivateProtocol with the property value set to the atom returned by
  interning WM_PROTOCOLS.

  shell
      Specifies the widget with which the protocol property is associated

  property
      Specifies the protocol property

  protocol
      Specifies the protocol atom (or an int type cast to Atom)

  For a complete definition of VendorShell and its associated resources, see
  VendorShell(3X).

SEE ALSO
  mwm(1X), VendorShell(3X), XmDeactivateWMProtocol(3X), XmInternAtom(3X)

Index for Section 3X

Alphabetical listing for X

Top of page