Core(3X)

Core --The Core widget class

As shipped in IRIX 6.5.30. Unchanged since IRIX 6.5.

NAME
     Core --The Core widget class

SYNOPSIS
     #include <Xm/Xm.h>


VERSION
     This page documents version 1.2 of the Motif library.

DESCRIPTION
     Core  is  the Xt Intrinsic base class for windowed widgets.  The Object and
     RectObj classes provide support for windowless widgets.

   Classes
     All widgets are built from Core.

     The class pointer is widgetClass.

     The class name is Core.

   New Resources
     The following table defines a set of widget resources used by the  program-
     mer  to  specify data.  The programmer can also set the resource values for
     the inherited classes to set attributes for this widget.   To  reference  a
     resource  by  name  or by class in a .Xdefaults file, remove the XmN or XmC
     prefix and use the remaining letters.  To specify one of the defined values
     for a resource in a .Xdefaults file, remove the Xm prefix and use  the  re-
     maining  letters  (in either lowercase or uppercase, but include any under-
     scores between words).  The codes in the  access  column  indicate  if  the
     given  resource  can  be set at creation time (C), set by using XtSetValues
     (S), retrieved by using XtGetValues (G), or is not applicable (N/A).

                                              Core Resource Set
Name                            Class                           Type             Default                Access
---------------------------------------------------------------------------------------------------------------
XmNaccelerators                 XmCAccelerators                 XtAccelerators   dynamic                CSG
XmNancestorSensitive            XmCSensitive                    Boolean          dynamic                G
XmNbackground                   XmCBackground                   Pixel            dynamic                CSG
XmNbackgroundPixmap             XmCPixmap                       Pixmap           XmUNSPECIFIED_PIXMAP   CSG
XmNborderColor                  XmCBorderColor                  Pixel            XtDefaultForeground    CSG
XmNborderPixmap                 XmCPixmap                       Pixmap           XmUNSPECIFIED_PIXMAP   CSG
XmNborderWidth                  XmCBorderWidth                  Dimension        1                      CSG
XmNcolormap                     XmCColormap                     Colormap         dynamic                CG
XmNdepth                        XmCDepth                        int              dynamic                CG
XmNdestroyCallback              XmCCallback                     XtCallbackList   NULL                   C
XmNheight                       XmCHeight                       Dimension        dynamic                CSG
XmNinitialResourcesPersistent   XmCInitialResourcesPersistent   Boolean          True                   C
XmNmappedWhenManaged            XmCMappedWhenManaged            Boolean          True                   CSG
XmNscreen                       XmCScreen                       Screen *         dynamic                CG
XmNsensitive                    XmCSensitive                    Boolean          True                   CSG
XmNtranslations                 XmCTranslations                 XtTranslations   dynamic                CSG
XmNwidth                        XmCWidth                        Dimension        dynamic                CSG
XmNx                            XmCPosition                     Position         0                      CSG
XmNy                            XmCPosition                     Position         0                      CSG


     XmNaccelerators
               Specifies a translation table that is bound with its  actions  in
               the  context  of  a particular widget.  The accelerator table can
               then be installed on some destination widget.

     XmNancestorSensitive
               Specifies whether the immediate parent of the widget receives in-
               put events.  Use the function XtSetSensitive to change the  argu-
               ment  to  preserve  data integrity (see XmNsensitive below).  For
               shells, the default is copied from the parent's XmNancestorSensi-
               tive resource if there is a parent; otherwise, it is  True.   For
               other  widgets,  the  default  is the bitwise AND of the parent's
               XmNsensitive and XmNancestorSensitive resources.

     XmNbackground
               Specifies the background color for the widget.

     XmNbackgroundPixmap
               Specifies a pixmap for tiling the background.  The first tile  is
               placed at the upper left-hand corner of the widget's window.

     XmNborderColor
               Specifies the color of the border in a pixel value.

     XmNborderPixmap
               Specifies  a  pixmap to be used for tiling the border.  The first
               tile is placed at the upper left-hand corner of the border.

     XmNborderWidth
               Specifies the width of the border  that  surrounds  the  widget's
               window  on  all four sides.  The width is specified in pixels.  A
               width of zero means that no border shows.

     XmNcolormap
               Specifies the colormap that is used for conversions to  the  type
               Pixel  for this widget instance.  When changed, previously gener-
               ated pixel values are not affected, but  newly  generated  values
               are in the new colormap.  For shells without parents, the default
               is  the  default colormap of the widget's screen.  Otherwise, the
               default is copied from the parent.

     XmNdepth  Specifies the number of bits that can be used for each  pixel  in
               the  widget's  window.  Applications should not change or set the
               value of this resource as it is set by the Xt Intrinsics when the
               widget is created.  For shells without parents,  the  default  is
               the default depth of the widget's screen.  Otherwise, the default
               is copied from the parent.

     XmNdestroyCallback
               Specifies  a  list of callbacks that is called when the widget is
               destroyed.

     XmNheight Specifies the inside height (excluding the border)  of  the  wid-
               get's window.

     XmNinitialResourcesPersistent
               Specifies whether or not resources are reference counted.  If the
               value  is  True  when the widget is created, the resources refer-
               enced by the widget are not reference counted, regardless of  how
               the  resource  type converter is registered.  An application that
               expects to destroy the widget and wants to have resources deallo-
               cated should specify a value of False.  The default is True,  im-
               plying an assumption that the widget will not be destroyed during
               the life of the application.

     XmNmappedWhenManaged
               If  set  to True it maps the widget (makes it visible) as soon as
               it is both realized and managed.  If set to False, the client  is
               responsible  for  mapping and unmapping the widget.  If the value
               is changed from True to False after the widget has been  realized
               and managed, the widget is unmapped.

     XmNscreen Specifies  the  screen on which a widget instance resides.  It is
               read only.  When the Toolkit is initialized, the top-level widget
               obtains its default value from the default screen of the display.
               Otherwise, the default is copied from the parent.

     XmNsensitive
               Determines whether a widget receives input events.  If  a  widget
               is  sensitive, the Xt Intrinsics' Event Manager dispatches to the
               widget all keyboard, mouse button,  motion,  window  enter/leave,
               and  focus  events.   Insensitive  widgets  do  not receive these
               events.  Use the function XtSetSensitive to change the  sensitiv-
               ity argument.  Using XtSetSensitive ensures that if a parent wid-
               get has XmNsensitive set to False, the ancestor-sensitive flag of
               all its children is appropriately set.

     XmNtranslations
               Points  to a translations list.  A translations list is a list of
               events and actions that are to be performed when the  events  oc-
               cur.

     XmNwidth  Specifies the inside width (excluding the border) of the widget's
               window.

     XmNx      Specifies  the  x-coordinate  of the upper left outside corner of
               the widget's window.  The value is relative to the upper left in-
               side corner of the parent window.

     XmNy      Specifies the y-coordinate of the upper left  outside  corner  of
               the widget's window.  The value is relative to the upper left in-
               side corner of the parent window.


   Translations
     There are no translations for Core.

RELATED INFORMATION
     Object(3X) and RectObj(3X).

                                                                        Core(3X)