next up previous contents
Next: Customizing the Window Creation Up: Creating a Custom Window Previous: The Example   Contents

Designing the Window with GUIDE

Consistent naming conventions make the task of adding a new window easier. Give the new window a short, descriptive name. For purposes of exposition, the new window will be called trial. (In all the instructions which follow, you should replace the word trial with the name of the panel which you are creating.) Create a subdirectory $DSTOOL_USER/trial for the new code and resulting library.

We suggest the GUIDE program be used to construct the new interface window, not only because it simplifies the design process, but also because it actually produces most of the C language code needed to build the window. The parts which you must write or modify involve the handlers and any part of the window which must vary according to the dynamical system (eg., the number of fields may depend on the dimension of the phase space).

We will assume that a simple window consists entirely of a control panel with panel items. These panel items are composed of buttons, text fields, and settings. Here are the conventions to be followed while using GUIDE:

1.
Name the GUIDE generated file trial.G.

2.
Name the window win and the control panel pan.
3.
Event handlers are NOT necessary for simple windows.

4.
All text field items can use the same notify handler. Name it trial_text_notify.

5.
All settings items can use the same notify handler. Name it trial_settings_notify.

6.
Each button item should have its own notify handler. Name them using the form trial_buttonname_notify.

7.
If there is to be a variable number of text fields or settings, then create only one of each type as a template.

Run gxv on the file trial.G by typing gxv trial.G in order to generate GUIDE's C code for the new window.


next up previous contents
Next: Customizing the Window Creation Up: Creating a Custom Window Previous: The Example   Contents
root
1998-11-02