Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ Core(Xm) — OpenDesktop Software Development System 3.0.0

Media Vault

Software Library

Restoration Projects

Artifacts Sought


 Core(Xm)                       6 January 1993                       Core(Xm)


 Name

    Core - the Core widget class

 Syntax


    #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 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 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     XtAcceleratorsdynamic            CSG
 XmNancestorSensitiveXmCSensitive        Boolean       dynamic            G
 XmNbackground       XmCBackground       Pixel         dynamic            CSG
 XmNbackgroundPixmap XmCPixmap           Pixmap        XmUNSPEC-          CSG
                                                       IFIED_PIXMAP
 XmNborderColor      XmCBorderColor      Pixel         XtDefaultForegroundCSG
 XmNborderPixmap     XmCPixmap           Pixmap        XmUNSPEC-          CSG
                                                       IFIED_PIXMAP
 XmNborderWidth      XmCBorderWidth      Dimension     1                  CSG
 XmNcolormap         XmCColormap         Colormap      dynamic            CG
 XmNdepth            XmCDepth            int           dynamic            CG
 XmNdestroyCallback  XmCCallback         XtCallbackListNULL               C
 XmNheight           XmCHeight           Dimension     dynamic            CSG
 XmNinitialResources-XmCInitialResources-Boolean       True               C
 Persistent          Persistent
 XmNmappedWhenManagedXmCMappedWhen-      Boolean       True               CSG
                     Managed
 XmNscreen           XmCScreen           Screen *      dynamic            CG
 XmNsensitive        XmCSensitive        Boolean       True               CSG
 XmNtranslations     XmCTranslations     XtTranslationsdynamic            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
            input 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 gen-
            erated 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
            widget'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,
            implying an assumption that the widget will not be destroyed dur-
            ing 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 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.

    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
            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.

 See also

    Object(Xm) and RectObj(Xm).


Typewritten Software • bear@typewritten.org • Edmonds, WA 98026