1Core(library call) Core(library call)
2
6 Core — The Core widget class
7
9 #include <Xm/Xm.h>
10
12 Core is the Xt Intrinsic base class for windowed widgets. The Object
13 and RectObj classes provide support for windowless widgets.
14 Classes
16 All widgets are built from Core.
17 The class pointer is widgetClass.
19 The class name is Core.
21 New Resources
23 The following table defines a set of widget resources used by the pro‐
24 grammer to specify data. The programmer can also set the resource val‐
25 ues for the inherited classes to set attributes for this widget. To
26 reference a resource by name or by class in a .Xdefaults file, remove
27 the XmN or XmC prefix and use the remaining letters. To specify one of
28 the defined values for a resource in a .Xdefaults file, remove the Xm
29 prefix and use the remaining letters (in either lowercase or uppercase,
30 but include any underscores between words). The codes in the access
31 column indicate if the given resource can be set at creation time (C),
32 set by using XtSetValues (S), retrieved by using XtGetValues (G), or is
33 not applicable (N/A).
34 ┌───────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
36 │ │ Core Resource Se│t │ │ │
37 │Name │ Class │ Type │ Default │ Access │
38 ├──────────────────────────────┼───────────────────────────────┼────────────────┼──────────────────────┼────────┤
39 │XmNaccelerators │ XmCAccelerators │ XtAccelerators │ dynamic │ CSG │
40 ├──────────────────────────────┼───────────────────────────────┼────────────────┼──────────────────────┼────────┤
41 │XmNancestorSensitive │ XmCSensitive │ Boolean │ dynamic │ G │
42 ├──────────────────────────────┼───────────────────────────────┼────────────────┼──────────────────────┼────────┤
43 │XmNbackground │ XmCBackground │ Pixel │ dynamic │ CSG │
44 ├──────────────────────────────┼───────────────────────────────┼────────────────┼──────────────────────┼────────┤
45 │XmNbackgroundPixmap │ XmCPixmap │ Pixmap │ XmUNSPECIFIED_PIXMAP │ CSG │
46 ├──────────────────────────────┼───────────────────────────────┼────────────────┼──────────────────────┼────────┤
47 │XmNborderColor │ XmCBorderColor │ Pixel │ XtDefaultForeground │ CSG │
48 ├──────────────────────────────┼───────────────────────────────┼────────────────┼──────────────────────┼────────┤
49 │XmNborderPixmap │ XmCPixmap │ Pixmap │ XmUNSPECIFIED_PIXMAP │ CSG │
50 ├──────────────────────────────┼───────────────────────────────┼────────────────┼──────────────────────┼────────┤
51 │XmNborderWidth │ XmCBorderWidth │ Dimension │ 1 │ CSG │
52 ├──────────────────────────────┼───────────────────────────────┼────────────────┼──────────────────────┼────────┤
53 │XmNcolormap │ XmCColormap │ Colormap │ dynamic │ CG │
54 ├──────────────────────────────┼───────────────────────────────┼────────────────┼──────────────────────┼────────┤
55 │XmNdepth │ XmCDepth │ int │ dynamic │ CG │
56 ├──────────────────────────────┼───────────────────────────────┼────────────────┼──────────────────────┼────────┤
57 │XmNdestroyCallback │ XmCCallback │ XtCallbackList │ NULL │ C │
58 ├──────────────────────────────┼───────────────────────────────┼────────────────┼──────────────────────┼────────┤
59 │XmNheight │ XmCHeight │ Dimension │ dynamic │ CSG │
60 ├──────────────────────────────┼───────────────────────────────┼────────────────┼──────────────────────┼────────┤
61 │XmNinitialResourcesPersistent │ XmCInitialResourcesPersistent │ Boolean │ True │ C │
62 ├──────────────────────────────┼───────────────────────────────┼────────────────┼──────────────────────┼────────┤
63 │XmNmappedWhenManaged │ XmCMappedWhenManaged │ Boolean │ True │ CSG │
64 ├──────────────────────────────┼───────────────────────────────┼────────────────┼──────────────────────┼────────┤
65 │XmNscreen │ XmCScreen │ Screen * │ dynamic │ CG │
66 ├──────────────────────────────┼───────────────────────────────┼────────────────┼──────────────────────┼────────┤
67 │XmNsensitive │ XmCSensitive │ Boolean │ True │ CSG │
68 ├──────────────────────────────┼───────────────────────────────┼────────────────┼──────────────────────┼────────┤
69 │XmNtranslations │ XmCTranslations │ XtTranslations │ dynamic │ CSG │
70 ├──────────────────────────────┼───────────────────────────────┼────────────────┼──────────────────────┼────────┤
71 │XmNwidth │ XmCWidth │ Dimension │ dynamic │ CSG │
72 ├──────────────────────────────┼───────────────────────────────┼────────────────┼──────────────────────┼────────┤
73 │XmNx │ XmCPosition │ Position │ 0 │ CSG │
74 ├──────────────────────────────┼───────────────────────────────┼────────────────┼──────────────────────┼────────┤
75 │XmNy │ XmCPosition │ Position │ 0 │ CSG │
76 ├──────────────────────────────┼───────────────────────────────┼────────────────┼──────────────────────┼────────┤
77 └──────────────────────────────┴───────────────────────────────┴────────────────┴──────────────────────┴────────┘
78 XmNaccelerators
79 Specifies a translation table that is bound with its actions
80 in the context of a particular widget. The accelerator table
81 can then be installed on some destination widget. Note that
82 the default accelerators for any widget will always be
83 installed, no matter whether this resource is specified or
84 not.
85 XmNancestorSensitive
87 Specifies whether the immediate parent of the widget receives
88 input events. Use the function XtSetSensitive to change the
89 argument to preserve data integrity (see XmNsensitive). For
90 shells, the default is copied from the parent's XmNancestorS‐
91 ensitive resource if there is a parent; otherwise, it is
92 True. For other widgets, the default is the bitwise AND of
93 the parent's XmNsensitive and XmNancestorSensitive resources.
94 XmNbackground
96 Specifies the background color for the widget.
97 XmNbackgroundPixmap
99 Specifies a pixmap for tiling the background. The first tile
100 is placed at the upper left corner of the widget's window.
101 XmNborderColor
103 Specifies the color of the border in a pixel value.
104 XmNborderPixmap
106 Specifies a pixmap to be used for tiling the border. The
107 first tile is placed at the upper left corner of the border.
108 XmNborderWidth
110 Specifies the width of the border that surrounds the widget's
111 window on all four sides. The width is specified in pixels. A
112 width of 0 (zero) means that no border shows. Note that you
113 should use resources like XmNshadowThickness and XmNhigh‐
114 lightThickness instead of XmNborderWidth to specify border
115 widths.
116 XmNcolormap
118 Specifies the colormap that is used for conversions to the
119 type Pixel for this widget instance. When this resource is
120 changed, previously generated pixel values are not affected,
121 but newly generated values are in the new colormap. For
122 shells without parents, the default is the default colormap
123 of the widget's screen. Otherwise, the default is copied
124 from the parent.
125 XmNdepth Specifies the number of bits that can be used for each pixel
127 in the widget's window. Applications should not change or set
128 the value of this resource as it is set by the Xt Intrinsics
129 when the widget is created. For shells without parents, the
130 default is the default depth of the widget's screen. Other‐
131 wise, the default is copied from the parent.
132 XmNdestroyCallback
134 Specifies a list of callbacks that is called when the widget
135 is destroyed.
136 XmNheight Specifies the inside height (excluding the border) of the
138 widget's window.
139 XmNinitialResourcesPersistent
141 Specifies whether or not resources are reference counted. If
142 the value is True when the widget is created, the resources
143 referenced by the widget are not reference counted, regard‐
144 less of how the resource type converter is registered. An
145 application that expects to destroy the widget and wants to
146 have resources deallocated should specify a value of False.
147 The default is True, implying an assumption that the widget
148 will not be destroyed during the life of the application.
149 XmNmappedWhenManaged
151 If this resource is set to True, it maps the widget (makes it
152 visible) as soon as it is both realized and managed. If this
153 resource is set to False, the client is responsible for map‐
154 ping and unmapping the widget. If the value is changed from
155 True to False after the widget has been realized and managed,
156 the widget is unmapped.
157 XmNscreen Specifies the screen on which a widget instance resides. It
159 is read only. When the Toolkit is initialized, the top-level
160 widget obtains its default value from the default screen of
161 the display. Otherwise, the default is copied from the par‐
162 ent.
163 XmNsensitive
165 Determines whether a widget receives input events. If a wid‐
166 get is sensitive, the Xt Intrinsics' Event Manager dispatches
167 to the widget all keyboard, mouse button, motion, window
168 enter/leave, and focus events. Insensitive widgets do not
169 receive these events. Use the function XtSetSensitive to
170 change the sensitivity argument. Using XtSetSensitive ensures
171 that if a parent widget has XmNsensitive set to False, the
172 ancestor-sensitive flag of all its children is appropriately
173 set.
174 XmNtranslations
176 Points to a translations list. A translations list is a list
177 of events and actions that are to be performed when the
178 events occur. Note that the default translations for any
179 widget will always be installed, no matter whether this
180 resource is specified or not.
181 XmNwidth Specifies the inside width (excluding the border) of the wid‐
183 get's window.
184 XmNx Specifies the x-coordinate of the upper left outside corner
186 of the widget's window. The value is relative to the upper
187 left inside corner of the parent window.
188 XmNy Specifies the y-coordinate of the upper left outside corner
190 of the widget's window. The value is relative to the upper
191 left inside corner of the parent window.
192 Translations
194 There are no translations for Core.
195
197 Object(3) and RectObj(3).
198 Core(library call)