1
.\" $Xorg: XtGetSres.man,v 1.3 2000/08/17 19:42:01 cpqbld Exp $
4
.\" Copyright 1993 X Consortium
6
.\" Permission is hereby granted, free of charge, to any person obtaining
7
.\" a copy of this software and associated documentation files (the
8
.\" "Software"), to deal in the Software without restriction, including
9
.\" without limitation the rights to use, copy, modify, merge, publish,
10
.\" distribute, sublicense, and/or sell copies of the Software, and to
11
.\" permit persons to whom the Software is furnished to do so, subject to
12
.\" the following conditions:
14
.\" The above copyright notice and this permission notice shall be
15
.\" included in all copies or substantial portions of the Software.
17
.\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
18
.\" EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
19
.\" MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
20
.\" IN NO EVENT SHALL THE X CONSORTIUM BE LIABLE FOR ANY CLAIM, DAMAGES OR
21
.\" OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
22
.\" ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
23
.\" OTHER DEALINGS IN THE SOFTWARE.
25
.\" Except as contained in this notice, the name of the X Consortium shall
26
.\" not be used in advertising or otherwise to promote the sale, use or
27
.\" other dealings in this Software without prior written authorization
28
.\" from the X Consortium.
30
.\" $XFree86: xc/doc/man/Xt/XtGetSres.man,v 1.3 2001/02/09 03:47:51 tsi Exp $
33
.ds xT X Toolkit Intrinsics \- C Language Interface
35
.ds xW X Toolkit Athena Widgets \- C Language Interface
36
.ds xL Xlib \- C Language X Interface
37
.ds xC Inter-Client Communication Conventions Manual
40
.hw XtGet-Subresources XtVa-Get-Subresources wid-get
47
.\".if \\n(VS>=40 .vs \\n(VSu
48
.\".if \\n(VS<=39 .vs \\n(VSp
71
.de IN \" send an index entry to the stderr
78
.\" choose appropriate monospace font
79
.\" the imagen conditional, 480,
80
.\" may be changed to L if LB is too
81
.\" heavy for your eyes...
83
.ie "\\*(.T"480" .ft L
84
.el .ie "\\*(.T"300" .ft L
85
.el .ie "\\*(.T"202" .ft PO
86
.el .ie "\\*(.T"aps" .ft CW
89
.ie \\n(VS>40 .vs \\n(VSu
97
.ie t \\$1\fB\^\\$2\^\fR\\$3
98
.el \\$1\fI\^\\$2\^\fP\\$3
101
.ie t \fB\^\\$1\^\fR\\$2
102
.el \fI\^\\$1\^\fP\\$2
107
.if \\n(.$>$1 .if !'\\$2'C' .ds NO \\$2
108
.if \\n(.$ .if !'\\$1'C' .ds NO \\$1
122
. \" Note End -- doug kraft 3/85
131
.TH XtGetSubresources 3Xt __xorgversion__ "XT FUNCTIONS"
133
XtGetSubresources, XtVaGetSubresources \- obtain subresources
136
void XtGetSubresources(Widget \fIw\fP, XtPointer \fIbase\fP, String
137
\fIname\fP, String \fIclass\fP, XtResourceList \fIresources\fP, Cardinal
138
\fInum_resources\fP, ArgList \fIargs\fP, Cardinal \fInum_args\fP);
140
void XtVaGetSubresources(Widget \fIw\fP, XtPointer \fIbase\fP, String
141
\fIname\fP, String \fIclass\fP, XtResourceList \fIresources\fP, Cardinal
142
\fInum_resources\fP);
144
.ds Al to override resources obtained from the resource database
146
Specifies the argument list \*(Al.
149
Specifies the base address of the subpart data structure where the resources
152
Specifies the class of the subpart.
154
Specifies the name of the subpart.
155
.IP \fInum_args\fP 1i
156
Specifies the number of arguments in the argument list.
157
.IP \fInum_resources\fP 1i
158
Specifies the number of resources in the resource list.
159
.IP \fIresources\fP 1i
160
Specifies the resource list for the subpart.
161
.ds Wi that wants resources for a subpart \
162
or that identifies the resource database to search
164
Specifies the widget \*(Wi.
166
Specifies the variable arguments \*(Al.
169
.ZN XtGetSubresources
170
function constructs a name/class list from the application name/class,
171
the name/classes of all its ancestors, and the widget itself.
172
Then, it appends to this list the name/class pair passed in.
173
The resources are fetched from the argument list, the resource database,
174
or the default values in the resource list.
175
Then, they are copied into the subpart record.
177
num_args must be zero.
178
However, if num_args is zero,
179
the argument list is not referenced.
181
XtGetApplicationResources, XtVaGetApplicationResources