manpagez: man pages & more
man Core(3)
Home | html | info | man
Core(library call)                                          Core(library call)




NAME

       Core -- The Core widget class


SYNOPSIS

       #include <Xm/Xm.h>


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  pro-
       grammer  to specify data. The programmer can also set the resource val-
       ues 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 remaining letters (in either lowercase or uppercase,
       but  include  any  underscores 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.  Note  that
                 the  default  accelerators  for  any  widget  will  always be
                 installed, no matter whether this resource  is  specified  or
                 not.

       XmNancestorSensitive
                 Specifies whether the immediate parent of the widget receives
                 input events. Use the function XtSetSensitive to  change  the
                 argument  to preserve data integrity (see XmNsensitive).  For
                 shells, the default is copied from the parent's XmNancestorS-
                 ensitive  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 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 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 0 (zero) means that no border shows.  Note that you
                 should use resources  like  XmNshadowThickness  and  XmNhigh-
                 lightThickness  instead  of  XmNborderWidth to specify border
                 widths.

       XmNcolormap
                 Specifies the colormap that is used for  conversions  to  the
                 type  Pixel  for  this widget instance. When this resource is
                 changed, previously generated 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.   Other-
                 wise, 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
                 widget's window.

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

       XmNmappedWhenManaged
                 If this resource is set to True, it maps the widget (makes it
                 visible) as soon as it is both realized and managed.  If this
                 resource is set to False, the client is responsible for  map-
                 ping  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  par-
                 ent.

       XmNsensitive
                 Determines  whether a widget receives input events. If a wid-
                 get 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 sensitivity argument. Using XtSetSensitive ensures
                 that  if  a  parent widget 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  occur.   Note  that  the default translations for any
                 widget will always  be  installed,  no  matter  whether  this
                 resource is specified or not.

       XmNwidth  Specifies the inside width (excluding the border) of the wid-
                 get'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 inside 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 inside corner of the parent window.

   Translations
       There are no translations for Core.


RELATED

       Object(3) and RectObj(3).



                                                            Core(library call)

openMotif 2.3.1 - Generated Fri Nov 28 18:04:59 CST 2008
© manpagez.com 2000-2024
Individual documents may contain additional copyright information.