1
.\" $Xorg: XtParTTab.man,v 1.3 2000/08/17 19:42:02 cpqbld Exp $
3
.\" Copyright 1993 X Consortium
5
.\" Permission is hereby granted, free of charge, to any person obtaining
6
.\" a copy of this software and associated documentation files (the
7
.\" "Software"), to deal in the Software without restriction, including
8
.\" without limitation the rights to use, copy, modify, merge, publish,
9
.\" distribute, sublicense, and/or sell copies of the Software, and to
10
.\" permit persons to whom the Software is furnished to do so, subject to
11
.\" the following conditions:
13
.\" The above copyright notice and this permission notice shall be
14
.\" included in all copies or substantial portions of the Software.
16
.\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
17
.\" EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
18
.\" MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
19
.\" IN NO EVENT SHALL THE X CONSORTIUM BE LIABLE FOR ANY CLAIM, DAMAGES OR
20
.\" OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
21
.\" ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
22
.\" OTHER DEALINGS IN THE SOFTWARE.
24
.\" Except as contained in this notice, the name of the X Consortium shall
25
.\" not be used in advertising or otherwise to promote the sale, use or
26
.\" other dealings in this Software without prior written authorization
27
.\" from the X Consortium.
29
.\" $XFree86: xc/doc/man/Xt/XtParTTab.man,v 1.2 2001/01/27 18:20:28 dawes Exp $
32
.ds xT X Toolkit Intrinsics \- C Language Interface
34
.ds xW X Toolkit Athena Widgets \- C Language Interface
35
.ds xL Xlib \- C Language X Interface
36
.ds xC Inter-Client Communication Conventions Manual
39
.hw XtParse-Translation-Table XtAugment-Translations XtOverride-Translations XtUninstall-Translations wid-get
46
.\".if \\n(VS>=40 .vs \\n(VSu
47
.\".if \\n(VS<=39 .vs \\n(VSp
70
.de IN \" send an index entry to the stderr
77
.\" choose appropriate monospace font
78
.\" the imagen conditional, 480,
79
.\" may be changed to L if LB is too
80
.\" heavy for your eyes...
82
.ie "\\*(.T"480" .ft L
83
.el .ie "\\*(.T"300" .ft L
84
.el .ie "\\*(.T"202" .ft PO
85
.el .ie "\\*(.T"aps" .ft CW
88
.ie \\n(VS>40 .vs \\n(VSu
96
.ie t \\$1\fB\^\\$2\^\fR\\$3
97
.el \\$1\fI\^\\$2\^\fP\\$3
100
.ie t \fB\^\\$1\^\fR\\$2
101
.el \fI\^\\$1\^\fP\\$2
106
.if \\n(.$>$1 .if !'\\$2'C' .ds NO \\$2
107
.if \\n(.$ .if !'\\$1'C' .ds NO \\$1
121
. \" Note End -- doug kraft 3/85
130
.TH XtParseTranslationTable 3Xt __xorgversion__ "XT FUNCTIONS"
132
XtParseTranslationTable, XtAugmentTranslations, XtOverrideTranslations, XtUninstallTranslations \- manage translation tables
134
XtTranslations XtParseTranslationTable(\fItable\fP)
138
void XtAugmentTranslations(\fIw\fP, \fItranslations\fP)
142
XtTranslations \fItranslations\fP;
144
void XtOverrideTranslations(\fIw\fP, \fItranslations\fP)
148
XtTranslations \fItranslations\fP;
150
void XtUninstallTranslations(\fIw\fP)
155
Specifies the translation table to compile.
156
.IP \fItranslations\fP 1i
157
Specifies the compiled translation table to merge in (must not be NULL).
158
.ds Wi into which the new translations are to be merged or removed
160
Specifies the widget \*(Wi.
163
.ZN XtParseTranslationTable
164
function compiles the translation table into the opaque internal representation
167
Note that if an empty translation table is required for any purpose,
168
one can be obtained by calling
169
.ZN XtParseTranslationTable
170
and passing an empty string.
173
.ZN XtAugmentTranslations
174
function nondestructively merges the new translations into the existing widget
176
If the new translations contain an event or event sequence that
177
already exists in the widget's translations,
178
the new translation is ignored.
181
.ZN XtOverrideTranslations
182
function destructively merges the new translations into the existing widget
184
If the new translations contain an event or event sequence that
185
already exists in the widget's translations,
186
the new translation is merged in and override the widget's translation.
188
To replace a widget's translations completely, use
190
on the XtNtranslations resource and specify a compiled translation table
194
.ZN XtUninstallTranslations
195
function causes the entire translation table for widget to be removed.
197
XtAppAddActions(3Xt),
198
XtCreatePopupShell(3Xt),
199
XtParseAcceleratorTable(3Xt),