Contents
About this guide
Intended audience
Organization
Associated documents
Conventions
1 Introduction to DEC VUIT
Features and benefits
Role of DEC VUIT in application development
Differences between DEC VUIT and UIL
Summary of unsupported UIL features
2 Building an interface: the basics
Parts Box and work area
Create objects
Create widgets
Create other objects
Duplicate objects
Duplicate widgets
Duplicate other objects
Delete objects
Delete widgets
Delete other objects
Modify a widget's size, position, and label
Modify size
Modify position
Modify label
Build the widget tree
Create a toplevel widget
Create a widget as a child of another widget
Name a child widget
Modify a widget definition
Access the Widget Editor
Widget Editor layout
Add resources to a widget definition
Remove resources from a widget definition
Commit or roll back changes to a widget definition
Modify a widget tree
With the Reparent function
With Children of Current Widget dialog
Add a child by reference
Remove a child from a controls list
3 Try it out
Start the DEC VUIT session
Create a new UIL source file
Modify module header
Get help on widgets
Build the main window
Create literals for specifying position
Build the menu bar
Populate the menu bar with cascade buttons
Reorder children in a menu
Reposition Help cascade button to far right
Build a pulldown menu for each cascade button
Change attributes of push button
Specify color
Specify font
Specify icon to fill background of main window
Create color_table literal
Define icon for XmNbackgroundPixmap
Build the form dialog
Set XmNresizePolicy and resize the form dialog
Specify position using expressions
Specify form dialog is initially unmanaged at run time
Attach menu bar to form dialog
Define pulldown menu
Attach scrolled window to menu bar and form dialog
Add XmList widget and specify item list
Set scrolling policy for scrolled window
Specify callbacks
Define callback procedures
Create literals for use in callback tag
Create integer_table literal for callback tag
Add callback resources
Reference procedures and literal
Test the sample application
Remove User Procedure action from proc_manage
Save UIL description of interface
Generate application files
Execute the build procedure
Run the application
4 Customize the DEC VUIT interface
Choose fonts for Parts Box and browsers
Rearrange the Parts Box
Layout of Parts Box entries
Syntax for default Parts Box
Specify default resources for widget creation
Syntax for default resources
Specify default resources by class
Customize accelerators for menu items
Simplify the DEC VUIT interface
5 Add your own widgets to the Parts Box
Extend DEC VUIT with your widgets
Describe widget in WML and create binary database
Add widget class name to application resource file
Register your widget with MRM
Build a new executable image of DEC VUIT
Load binary database and run DEC VUIT
6 Get consistency with literals and lists
Work with literals
Create a literal definition
Modify a literal definition
Access the Literal Editor through the Widget Editor
Access the Literal Editor through the Literal Manager
Flowthrough modification of a literal value
Reference a literal in a widget definition
Remove a literal reference
Delete a literal
Work with lists
Create a list definition
Modify a list definition
Reference a list in a widget definition
Override value specified by a list reference
Remove a list reference
Delete a list
Create literals and lists with the Widget Editor
7 File management
Create a new source file
Specify search path
Define file hierarchy
Create new include file
Specify name of include file
Populate include file
Add a reference to an existing include file
Remove a reference to an include file
Specify module header
Use a widget definition as a template
Create include file containing template
Add include file and duplicate template
Remove reference to include file
8 Tips on working with forms
Build a form: the concepts
Attachment types
Relative attachments
Physical attachments
Common uses for attachments
Repositioning
Elasticity
Alignment
Design decisions
Build a form: the mechanics
Change default resizing behavior of form
Modify attachment type
Modify offset or position value
Attach to a widget
Modify multiple siblings in a form
Build a form: an example
Build burgers_box
Build fries_box
Build drinks_box
Add push buttons to control_box
9 Test drive the interface
Run interface simulation
Generate application files
Template files
Interface management routines
Example: Generate VUIT_SQRT application
Examine userwritten procedures
Generate main program and build procedure
Modify build procedure
Execute build procedure and run application
When prototyping is finished...
A Shortcuts
Manipulate widgets
Create objects from Widget Editor
Get help
Specify attachments in forms
Access object editors from Widget Editor
Access object editor from object manager
Access object manager from object editor
B Data type editors: a quick reference
Methods for binding values
Immediate binding
Literal binding
List binding
Bitmap binding
Expression binding
Identifier binding
Simple data type editors
ASCIZ string table
Create an asciz_table literal
Insert entry in table
Reorder entries in table
Reference a literal in table
Remove entry from table
Callback
Define new callback procedure
Use identifier for callback tag
Search for defined procedure names
Specify multiple procedures per callback
Change calling order of procedures
Remove procedure reference
Color
Specify colors by name
Specify colors on a color monitor
Specify colors on a monochrome display
Color table
Compound string
Compound string table
Font
Specify font value not available on your server
Font list
Add font list entry
Reorder font list entries
Remove font list entry
Integer table
Create an integer_table literal
Insert entry in table
Reorder entries in table
Remove entry from table
Pixmap
Icon Editor layout
Specify width and height of an icon
Specify fatbit size
Specify colors for an icon
Specify current color
Drawing functions
Translation table
Widget ID
Tables
Table 1 Conventions used in this manual
Table 2 Suggested modifications for unsupported UIL features
Table 3 Relationship between UIL and DEC VUIT objects
Table 4 Data type editors and related UIL functions
Table 5 Location of DEC VUIT application resource file
Table 6 Qualifiers for defining default resources
Table 7 Size and position calculations in control_box form
Table 8 Templates for code generation
Table 9 Interface management routines for code generation
Table 10 Files for VUIT_SQRT demo application
Table 11 Color models supported by display type
Table 12 Icon Editor drawing functions