<!-- $XConsortium: Core.sgm /main/9 1996/09/08 21:41:56 rws $ -->
<!-- (c) Copyright 1995 Digital Equipment Corporation. -->
<!-- (c) Copyright 1995 Hewlett-Packard Company. -->
<!-- (c) Copyright 1995 International Business Machines Corp. -->
<!-- (c) Copyright 1995 Sun Microsystems, Inc. -->
<!-- (c) Copyright 1995 Novell, Inc. -->
<!-- (c) Copyright 1995 FUJITSU LIMITED. -->
<!-- (c) Copyright 1995 Hitachi. -->

<RefEntry Id="CDEMMA.MAN6.rsml.1">
<RefMeta>
<RefEntryTitle>Core</RefEntryTitle>
<ManVolNum>library call</ManVolNum>
</RefMeta>
<RefNameDiv>
<RefName><Classname>Core</Classname></RefName>
<RefPurpose>The Core widget class
<IndexTerm>
<Primary>Core</Primary>
</IndexTerm><IndexTerm>
<Primary>widget class</Primary>
<Secondary>Core</Secondary>
</IndexTerm></RefPurpose>
</RefNameDiv>
<!-- -->
<!-- @OSF_COPYRIGHT@-->
<!-- COPYRIGHT NOTICE-->
<!-- Copyright (c) 1990, 1991, 1992, 1993 Open Software Foundation, Inc.-->
<!-- ALL RIGHTS RESERVED (MOTIF). See the file named COPY.MOTIF.DOC for-->
<!-- the full copyright text.-->
<!-- -->
<!-- HISTORY-->
<!-- -->
<!-- **-->
<!-- **-->
<!-- **  (c) Copyright 1989, 1990, 1992 by Open Software Foundation, Inc.-->
<!-- **      All Rights Reserved.-->
<!-- **-->
<!-- **  (c) Copyright 1987, 1988, 1989, by Hewlett-Packard Company-->
<!-- **-->
<!-- **  (c) Copyright 1987, 1988 by Digital Equipment Corporation,-->
<!-- **      Maynard, MA.  All Rights Reserved.-->
<!-- **-->
<!-- **-->
<RefSynopsisDiv>
<Synopsis>&npzwc;#include &lt;Xm/Xm.h>
</Synopsis>
</RefSynopsisDiv>
<RefSect1>
<Title>DESCRIPTION</Title>
<Para>Core is the Xt Intrinsic base class for windowed widgets. The
<Classname>Object</Classname> and <Classname>RectObj</Classname> classes provide support for windowless
widgets.
</Para>
<RefSect2>
<Title>Classes</Title>
<Para>All widgets are built from <Classname>Core</Classname>.
</Para>
<Para>The class pointer is <Symbol Role="Globalvar">widgetClass</Symbol>.
</Para>
<Para>The class name is <Classname>Core</Classname>.
</Para>
</RefSect2>
<RefSect2>
<Title>New Resources</Title>
<Para>The following table defines a set of widget resources used by the programmer
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 <Filename>.Xdefaults</Filename> file, remove the <SystemItem Class="Constant">XmN</SystemItem> or
<SystemItem Class="Constant">XmC</SystemItem> prefix and use the remaining letters. To specify one of the defined
values for a resource in a <Filename>.Xdefaults</Filename> file, remove the <SystemItem Class="Constant">Xm</SystemItem> 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 <Function>XtSetValues</Function> (S),
retrieved by using <Function>XtGetValues</Function> (G), or is not applicable (N/A).
</Para>
<Para><!-- --><!-- @OSF_COPYRIGHT@--><!-- COPYRIGHT NOTICE--><!-- Copyright (c) 1990, 1991, 1992, 1993 Open Software Foundation, Inc.--><!-- ALL RIGHTS RESERVED (MOTIF). See the file named COPY.MOTIF.DOC for--><!-- the full copyright text.--><!-- --><!-- HISTORY--><!-- --><!--no-op:  .in--></Para>
<InformalTable Frame="All" Remap="center" Orient="Port">
<TGroup Cols="5">
<ColSpec Rowsep="1" Colsep="1" Align="Left" Colname="1">
<ColSpec Rowsep="1" Colsep="1" Align="Left" Colname="2">
<ColSpec Rowsep="1" Colsep="1" Align="Left" Colname="3">
<ColSpec Rowsep="1" Colsep="1" Align="Left" Colname="4">
<ColSpec Rowsep="1" Align="Left" Colname="5">
<TBody>
<Row>
<Entry Align="Center" Nameend="5" Namest="1"><Literal>Core Resource Set</Literal></Entry>
</Row>
<Row>
<Entry Rowsep="1"><Literal>Name</Literal></Entry>
<Entry Rowsep="1"><Literal>Class</Literal></Entry>
<Entry Rowsep="1"><Literal>Type</Literal></Entry>
<Entry Rowsep="1"><Literal>Default</Literal></Entry>
<Entry Rowsep="1"><Literal>Access</Literal></Entry>
</Row>
<Row>
<Entry>XmNaccelerators</Entry>
<Entry>XmCAccelerators</Entry>
<Entry>XtAccelerators</Entry>
<Entry>dynamic</Entry>
<Entry>CSG</Entry>
</Row>
<Row>
<Entry>XmNancestorSensitive</Entry>
<Entry>XmCSensitive</Entry>
<Entry>Boolean</Entry>
<Entry>dynamic</Entry>
<Entry>G</Entry>
</Row>
<Row>
<Entry>XmNbackground</Entry>
<Entry>XmCBackground</Entry>
<Entry>Pixel</Entry>
<Entry>dynamic</Entry>
<Entry>CSG</Entry>
</Row>
<Row>
<Entry>XmNbackgroundPixmap</Entry>
<Entry>XmCPixmap</Entry>
<Entry>Pixmap</Entry>
<Entry>XmUNSPECIFIED_PIXMAP</Entry>
<Entry>CSG</Entry>
</Row>
<Row>
<Entry>XmNborderColor</Entry>
<Entry>XmCBorderColor</Entry>
<Entry>Pixel</Entry>
<Entry>XtDefaultForeground</Entry>
<Entry>CSG</Entry>
</Row>
<Row>
<Entry>XmNborderPixmap</Entry>
<Entry>XmCPixmap</Entry>
<Entry>Pixmap</Entry>
<Entry>XmUNSPECIFIED_PIXMAP</Entry>
<Entry>CSG</Entry>
</Row>
<Row>
<Entry>XmNborderWidth</Entry>
<Entry>XmCBorderWidth</Entry>
<Entry>Dimension</Entry>
<Entry>1</Entry>
<Entry>CSG</Entry>
</Row>
<Row>
<Entry>XmNcolormap</Entry>
<Entry>XmCColormap</Entry>
<Entry>Colormap</Entry>
<Entry>dynamic</Entry>
<Entry>CG</Entry>
</Row>
<Row>
<Entry>XmNdepth</Entry>
<Entry>XmCDepth</Entry>
<Entry>int</Entry>
<Entry>dynamic</Entry>
<Entry>CG</Entry>
</Row>
<Row>
<Entry>XmNdestroyCallback</Entry>
<Entry>XmCCallback</Entry>
<Entry>XtCallbackList</Entry>
<Entry>NULL</Entry>
<Entry>C</Entry>
</Row>
<Row>
<Entry>XmNheight</Entry>
<Entry>XmCHeight</Entry>
<Entry>Dimension</Entry>
<Entry>dynamic</Entry>
<Entry>CSG</Entry>
</Row>
<Row>
<Entry>XmNinitialResourcesPersistent</Entry>
<Entry>XmCInitialResourcesPersistent</Entry>
<Entry>Boolean</Entry>
<Entry>True</Entry>
<Entry>C</Entry>
</Row>
<Row>
<Entry>XmNmappedWhenManaged</Entry>
<Entry>XmCMappedWhenManaged</Entry>
<Entry>Boolean</Entry>
<Entry>True</Entry>
<Entry>CSG</Entry>
</Row>
<Row>
<Entry>XmNscreen</Entry>
<Entry>XmCScreen</Entry>
<Entry>Screen *</Entry>
<Entry>dynamic</Entry>
<Entry>CG</Entry>
</Row>
<Row>
<Entry>XmNsensitive</Entry>
<Entry>XmCSensitive</Entry>
<Entry>Boolean</Entry>
<Entry>True</Entry>
<Entry>CSG</Entry>
</Row>
<Row>
<Entry>XmNtranslations</Entry>
<Entry>XmCTranslations</Entry>
<Entry>XtTranslations</Entry>
<Entry>dynamic</Entry>
<Entry>CSG</Entry>
</Row>
<Row>
<Entry>XmNwidth</Entry>
<Entry>XmCWidth</Entry>
<Entry>Dimension</Entry>
<Entry>dynamic</Entry>
<Entry>CSG</Entry>
</Row>
<Row>
<Entry>XmNx</Entry>
<Entry>XmCPosition</Entry>
<Entry>Position</Entry>
<Entry>0</Entry>
<Entry>CSG</Entry>
</Row>
<Row>
<Entry>XmNy</Entry>
<Entry>XmCPosition</Entry>
<Entry>Position</Entry>
<Entry>0</Entry>
<Entry>CSG</Entry>
</Row>
</TBody>
</TGroup>
</InformalTable>
<VariableList>
<VarListEntry>
<Term><SystemItem Class="Resource">XmNaccelerators</SystemItem></Term>
<ListItem>
<Para>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.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term><SystemItem Class="Resource">XmNancestorSensitive</SystemItem></Term>
<ListItem>
<Para>Specifies whether the immediate parent of the widget receives input
events. Use the function <Function>XtSetSensitive</Function> to change the argument
to preserve data integrity (see <SystemItem Class="Resource">XmNsensitive</SystemItem>).
For shells, the default is copied from the parent's
<SystemItem Class="Resource">XmNancestorSensitive</SystemItem> resource if there is a parent; otherwise, it
is True.
For other widgets, the default is the bitwise AND of the parent's
<SystemItem Class="Resource">XmNsensitive</SystemItem> and <SystemItem Class="Resource">XmNancestorSensitive</SystemItem> resources.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term><SystemItem Class="Resource">XmNbackground</SystemItem></Term>
<ListItem>
<Para>Specifies the background color for the widget.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term><SystemItem Class="Resource">XmNbackgroundPixmap</SystemItem></Term>
<ListItem>
<Para>Specifies a pixmap for tiling the background. The first tile is
placed at the upper left corner of the widget's window.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term><SystemItem Class="Resource">XmNborderColor</SystemItem></Term>
<ListItem>
<Para>Specifies the color of the border in a pixel value.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term><SystemItem Class="Resource">XmNborderPixmap</SystemItem></Term>
<ListItem>
<Para>Specifies a pixmap to be used for tiling the border. The first tile is
placed at the upper left corner of the border.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term><SystemItem Class="Resource">XmNborderWidth</SystemItem></Term>
<ListItem>
<Para>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 <SystemItem Class="Resource">XmNshadowThickness</SystemItem> and
<SystemItem Class="Resource">XmNhighlightThickness</SystemItem> instead of <SystemItem Class="Resource">XmNborderWidth</SystemItem> to specify
border widths.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term><SystemItem Class="Resource">XmNcolormap</SystemItem></Term>
<ListItem>
<Para>Specifies the colormap that is used for conversions to the type
<Literal>Pixel</Literal> 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.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term><SystemItem Class="Resource">XmNdepth</SystemItem></Term>
<ListItem>
<Para>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.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term><SystemItem Class="Resource">XmNdestroyCallback</SystemItem></Term>
<ListItem>
<Para>Specifies a list of callbacks that is called when the widget
is destroyed.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term><SystemItem Class="Resource">XmNheight</SystemItem></Term>
<ListItem>
<Para>Specifies the inside height (excluding the border) of the widget's
window.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term><SystemItem Class="Resource">XmNinitialResourcesPersistent</SystemItem></Term>
<ListItem>
<Para>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, regardless 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.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term><SystemItem Class="Resource">XmNmappedWhenManaged</SystemItem></Term>
<ListItem>
<Para>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
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.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term><SystemItem Class="Resource">XmNscreen</SystemItem></Term>
<ListItem>
<Para>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.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term><SystemItem Class="Resource">XmNsensitive</SystemItem></Term>
<ListItem>
<Para>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
<Function>XtSetSensitive</Function> to change the sensitivity argument. Using
<Function>XtSetSensitive</Function> ensures that if a parent widget has
<SystemItem Class="Resource">XmNsensitive</SystemItem> set to False, the ancestor-sensitive flag of all its
children is appropriately set.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term><SystemItem Class="Resource">XmNtranslations</SystemItem></Term>
<ListItem>
<Para>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.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term><SystemItem Class="Resource">XmNwidth</SystemItem></Term>
<ListItem>
<Para>Specifies the inside width (excluding the border) of the widget's
window.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term><SystemItem Class="Resource">XmNx</SystemItem></Term>
<ListItem>
<Para>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.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term><SystemItem Class="Resource">XmNy</SystemItem></Term>
<ListItem>
<Para>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.
</Para>
</ListItem>
</VarListEntry>
</VariableList>
<!-- -->
<!-- @OSF_COPYRIGHT@-->
<!-- COPYRIGHT NOTICE-->
<!-- Copyright (c) 1990, 1991, 1992, 1993 Open Software Foundation, Inc.-->
<!-- ALL RIGHTS RESERVED (MOTIF). See the file named COPY.MOTIF.DOC for-->
<!-- the full copyright text.-->
<!-- -->
<!-- HISTORY-->
<!-- -->
<!-- Action Table for Core-->
</RefSect2>
<RefSect2>
<Title>Translations</Title>
<Para>There are no translations for Core.
</Para>
</RefSect2>
</RefSect1>
<RefSect1>
<Title>RELATED</Title>
<Para>&cdeman.Object;
and
&cdeman.RectObj;.
</Para>
</RefSect1>
</RefEntry>
<!--fickle 1.09 7/2/95-->
