Putting It All Together

4

Much of OLIT programming is figuring out how the various widgets work, and how to assemble them into a user interface. The best way to teach this is to show it in a real OLIT program. The program described in this chapter, Translator.c, translates a some common English expressions into several foreign languages. Examine the run-time application and the commented source code to get an idea of some of the issues involved in creating an OLIT application.

You may obtain Translator.c and the its helper files (Makefile, and Resources_translator) by sending mail to greg.kimura@Eng.sun.com with the subject line "OLIT Quick-Start Programs". To compile and execute Translator.c, copy Translator.c, Makefile, and

Resources_translator into a work directory. Set the environmental variable XENVIRONMENT to ./Resources_translator. Enter make<return> to make. Enter Translator<return> to run.¹

Figure 4-1

Translator translates some common English words into several different languages. Here's how to use it:

Selected a language by pulling down the abbreviated menu button and highlighting the desired language. The language will be displayed next to the abbreviated menu button.
Select the type of words you wish to translate by pressing the Salutations, Affirmations, Niceties, or Gender buttons.
Press one of the Oblong buttons for a translation of the desired word. The translated word will appear next to the label Translation:.

Table 4-1 lists the variables in Translator.c. Code Example 4-1 shows the resource file for Translator.c. Code Example 4-2 lists the source code.

1. Note that if you are not using OpenWindows 3.2 or Asian OpenWindows 3.1, you may have trouble compiling this program unless you remove the line which reads OlToolkitInitialize((XtPointer)NULL);

Table 4-1

Variable	Type	Description
abbrevmb	AbbrevMenuButton	Pulldown menu button for the Language buttons.
answer	StaticText	Foreign language translation of pressed button.
control_area	ControlArea	Manager widget.
goodbye_button	OblongButton	Right word button.
hello_button	OblongButton	Left word button.
holder	Exclusives	An Exclusives widget used to hold the RectButtons.
i	int	Counter.
israel[]	char	Israeli language button labels. Yiddish and Hebrew.
israeli_buttons	OblongButtons	Yiddish and Hebrew selection button widgets.
israeli_menu	MenuButton	Israeli MenuButton widget.
isrl_menu	MenuShell	,MenuShell subwidget of israeli_menu.
lang_button_cb()	void	Callback procedure called when a language (lang_button) is selected. Puts the name of the language next to the AbbreviatedMenuButton.
lang_buttons[]	char	Labels for the language selection buttons. English, Spanish, Japanese, German, French, Swahili
language_buttons[]	OblongButtons	English, Spanish, Japanese, German, French, Swahili selection button widgets.
lang_label	StaticText	Language: label to the left of the abbreviated menu button.
lang_menu	MenuShell	MenuShell subwidget of abbrevmb.
new_header_cb()	void	Callback procedure called when the hello and goodbye button are selected. Sets application header to the string in the Hello/Goodbye buttons.
opposites[]	char	Names of the word pairs. Salutations, Affirmations, Niceties, Gender.
opposites_cb()	void	Callback procedure called when an opposites button (Salutations, Affirmations, Niceties, and Gender) is selected. When button is selected, the corresponding word pair is displayed in the Hello and Goodbye buttons.

Table 4-1

Variable	Type	Description
Opposites[]	RectButtons	Opposites selection buttons. Salutations, Affirmations, Niceties, Gender.
opposites[]	char	Opposites selection button labels. Salutations, Affirmations, Niceties, Gender.
preview_lang	StaticText	Previews the selected language.
spacer_button	OblongButton	Used to create a blank space between the Goodbye button and "Language".
toplevel	TopLevelShell	Top level shell widget.
translation	StaticText	Static label. "Translations:"
translation_cb()	void	Callback executed when a word button is pressed. Matches word and language. Prints out the foreign language translation.