Index for Section 3X

Alphabetical listing for X

Bottom of page

XmActivateProtocol(3X)
OSF/Motif
NAME
  XmActivateProtocol - A VendorShell function that activates a protocol

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

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

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

DESCRIPTION
  XmActivateProtocol activates a protocol.  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, and so on) to persist, even
  though the client may choose to temporarily resign from the interaction.
  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.

  XmActivateWMProtocol is a convenience interface.  It calls
  XmActivateProtocol 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
  VendorShell(3X), XmActivateWMProtocol(3X), XmInternAtom(3X)

Index for Section 3X

Alphabetical listing for X

Top of page