Specifications

Athena Widget Set libXaw 1.0.7
insert-char( ) This action may only be attached to a key event. When the inter-
national resource is false,this action calls XLookupString to
translate the event into a (rebindable) Latin-1 character
(sequence) and inserts it into the text at the insert point. When
the international resource is true,characters are passed to the
input method via XwcLookupString, and anycommitted string
returned is inserted into the text at the insert point.
insert-string(string[,string,...]) This action inserts each string into the text at the insert point
location. Any string beginning with the characters "0x" followed
by an evennumber of hexadecimal digits is interpreted as a hexa-
decimal constant and the corresponding string is inserted instead.
This hexadecimal string may represent up to 50 8-bit characters.
When theinternational resource is true,ahexadecimal string is
intrepeted as being in a multi-byte encoding, and a hexadecimal
or regular string will result in an error message if it is not legalin
the current locale.
display-caret(state,when)This action allows the insert point to be turned on and off. The
state argument specifies the desired state of the insert point. This
value may be anyofthe string values accepted for Boolean
resources (e.g. on, True, off, False,etc.). If no arguments are
specified, the default value is True.The when argument speci-
fies, for EnterNotify or LeaveNotify ev ents whether or not the
focus field in the event is to be examined. If the second argu-
ment is not specified, or specified as something other than
always then if the action is bound to an EnterNotify or
LeaveNotify ev ent, the action will be taken only if the focus
field is True.Anaugmented binding that might be useful is:
*Text.Translations: #override \
<FocusIn>: display-caret(on) \n\
<FocusOut>: display-caret(off)
focus-in( )
focus-out( ) These actions do not currently do anything.
search(direction,[string]) This action activates the search popup. The direction must be
specified as either forward or backward.The string is optional
and is used as an initial value for the Search for:string. For fur-
ther explanation of the search widget see the section on Text
Searches.
multiply(value)The multiply action allows the user to multiply the effects of
manyofthe text actions. Thus the following action sequence
multiply(10) delete-next-word() will delete 10 words. It does not
matter whether these actions takeplace in one event or many
ev e nts. Using the default translations the key sequence Control-
u, Control-d will delete 4 characters. Multiply actions can be
chained, thus multiply(5) multiply(5) is the same as multiply(25).
If the string reset is passed to the multiply action the effects of
all previous multiplies are removedand a beep is sent to the dis-
play.
form-paragraph( ) This action removesall the Carriage Returns from the current
paragraph and reinserts them so that each line is as long as possi-
ble, while still fitting on the current screen. Lines are broken at
word boundaries if at all possible. This action currently works
79