NAME

XmuMakeAtom − create an AtomPtr to cache Atom/Display pairs. 

SYNOPSIS

#include <X11/Xmu/Atoms.h>

AtomPtr XmuMakeAtom(name)
      char∗ name;

Inputs

nameSpecifies the Atom name. 

Returns

An initialized AtomPtr for the string name. 

DESCRIPTION

XmuMakeAtom() creates and initializes an AtomPtr, which is an opaque object that contains a string and a list of cached Atoms for that string—one Atom for each display. 

USAGE

Use XmuMakeAtom() to initialize an AtomPtr with a string, then use XmuInternAtom() to obtain the Atom that corresponds to that string for a particular display.  Since a widget may be instantiated on more than one display, widget code should be sure that it is using the correct Atom.  In widget code, you can call XmuMakeAtom() from your class_initialize() procedure, storing the resulting AtomPtr in a global variable or class field, and then call XmuInternAtom() with that AtomPtr and the display in your code whenever you need the Atom. 

Atoms are used when requesting or converting selection values in a widget or an application.  This and the related Xmu Atom functions provide client-side caching and help avoid roundtrips to the server.  There are also a number of very useful predefined Atom macros in <X11/Xmu/Atoms.h>.  These macros (XA_TEXT(d), for example) each take a display argument and return the appropriate Atom for that display.  They are named to complement the predefined Atoms from <X11/Xatom.h>. 

STRUCTURES

AtomPtr is an opaque type. 

SEE ALSO

XmuGetAtomName(6), XmuInternAtom(6), XmuInternStrings(6), XmuNameofAtom(6).