X-Designer User's Guide

X-Designer User's Guide

Sun Studio 11

819-3700-10

Contents

Introduction to X-Designer

Operating Environment

Requirements for Compiling Generated Code

Basic Concepts and Terms

Protection From Invalid Actions

The X-Designer Development Cycle

How This Manual Is Organized

2. Building the Widget Hierarchy

Introduction to the Tutorial

The Design Hierarchy

Starting and Stopping

Navigating in the Menus

Starting the Design

Adding Children to the Hierarchy

Dynamic Display of Layout

Currently Selected Widget

Multiple Selection

No Selected Widget

Adding the Buttons

Building the Menu Bar

Adding the Work Area

Building the Radio Box

Building the Row Column Array

Adding the Toggle Buttons

Adding a Window to Your Application

Creating a Second Window

Editing the Hierarchy

Display Options

Transform Widgets

Printing Your Hierarchy

Using the File Browser

The Label Resource Panel

Multiple Selection and Resources

Resource Panels in Microsoft Windows Mode

Button Widget Resources

Shared Resource Panels

Resources for Menu Items

The Keyboard Page

Designated Help Widget

RowColumn Resources

Shell Resources

Navigating in the Resource Panels

Core Resource Panel

Constraints Panel

Default Resource Settings

The Reset Command

Rejected Resource Settings

Custom Attributes

Resource Restrictions

Resource Bindings

Comparison of Resource Generation

Where to Look for More Information on Resources

4. The Layout Editor

Displaying the Layout Editor

Selection: Single, Primary and Secondary

Layout Editor Toolbar

Layout Editor File Menu

Layout Editor Edit Menu

Layout Editor View Menu

Layout Editor Layout Menu

Understanding the Default Layout

Rough Layout: the Move Mode

Attachments to the Form

Attachments Between Widgets

Aligning Widgets: the Align Mode

Aligning Widgets: Group Alignment

Proportional Spacing: the Position Mode

Using the Constraints Panel

Other Layout Widgets

Layout Editor Restrictions

5. Other Editors

Selecting Pixmaps

Editing Pixmaps

Editing the Color Palette

Using the Pixmap Editor

Compound Strings

Callback and Prelude Editing

6. Activating the Interface: Adding Your Own Code

Designating a Callback

Callback Functions

Accessing Widgets in Callbacks

Manipulating Widgets

Translations and Actions

7. Generating Code

The Generate Menu

Generate Dialog

Adding Callback Functionality

Analysis of the Primary Module

Resource File Syntax

Arranging Your Files

Customizing the Generated Files: Preludes

Module Preludes

Using the Edit Mechanism

8. Structured Code Generation and Reusable Definitions

Structured Code Generation

Function Structures

Data Structures

Method Declarations

Method Preludes

Creating a Derived Class

Modifying the Base Classes

Children Only Place Holders

Structured Code Generation and UIL

Changing Declaration Scope

The Definitions File

Modifying a Definition

Definitions and Resource Files

Online Help for Definitions

9. C++ Code Tutorial

Creating a C++ Class

Callback Methods

Adding Class Members

Creating a Derived Class

Creating a Definition

Adding a Definition to the Palette

Generating Code for a Definition

Creating an Instance

Modifying and Extending an Instance

Creating a Derived Class

Overriding a Callback Method

Definitions and Resource Files

10. Designing for Java

The Generated Java Code

Using X-Designer For Java

New Widgets for Java Classes

Generate Dialog

Moving X-Designer Designs to Visaj

Motif Widgets to Java Classes--the MWT Library

Mapping Motif Widgets to Swing Components

11. Designing for Microsoft Windows

Generating the Application

Starting in Microsoft Windows Mode

The X-Designer Window

Microsoft Windows Compliance

Compliance Failure

Manager Widgets and Layout

Pixmaps, Bitmaps and Icons

Using Third Party Widgets

Method Declarations

Application Class

Code Generation

Configuring X-Designer

12. Creating a Microsoft Windows and Motif Application

Starting Your Design

Setting Resources

Building the Application

Filling in the Stubs

Compiling the Application

Single Sourcing

13. Design Tools

Using XD/Capture From the Command Line

How to Invoke an Application With XD/Replay

Recording and Replaying From the Command Line

Getting the Most From XD/Replay

Preparing Rolling Demonstrations

Taking Screen Dumps

Extending the XD/Replay Widget Set

Adding Your Own XD/Replay Commands

Allowing Your Applications to Be Recorded and Replayed

Creating a Group

Groups as Shortcuts

Groups for Smart Code

16. Get/Set Smart Code

How the Smart Code Information Is Organized

Using Smart Code

Get/Set Smart Code

Get/Set Tutorial

17. Thin Client Smart Code

Using Thin Client Smart Code

Thin Client Smart Code Tutorial

Thin Client Server Callbacks

Server Application

Customizing the Server Connection

18. Internet Smart Code

Internet and Thin Client

Communication Protocol

Simple Internet Smart Code Tutorial

Extracting Information From HTML Data

19. Makefile Generation

Makefile Generation Options

Creating the Initial Makefile

Updating the Initial Makefile

Editing the Generated Makefile

Using Your Own Makefiles

20. Advanced Layout

Column Layout Using the RowColumn

Column Layout Using the Form

21. Hypertext Help

Setting up Help in X-Designer

Module Defaults

Finding Help Documents and Markers

Linking Help Into Your Application

Help Implementation

22. Internationalization

What Is the Problem?

Creating International Text

Localized Input in Your Application

Setting the Application Font Resource

Using Eight-Bit Characters in Shell Titles

Unsupported Locales

23. User-Defined Widgets

Using Pre-Configured Integration Kits

Generating Java Code

Generating MFC Code

How X-Designer Works

Getting Widget Information

xdconfig--the Main Dialog

Widget Attributes

Resource Memory Management

XmStringTable Resources

Motif Widgets Stop List

Generating and Compiling Code

Testing the Configuration

Configuration Functions

24. Command Line Operations

Command Line Switches for Interactive Use

Generating Code From the Command Line

Converting UIL Source to X-Designer Save Files

Converting GIL Source to X-Designer Save Files

25. Configuration

Setting up Callback and Prelude Editing

Palette Contents

Makefile Features

Dynamic Display Window

26. Command Summary

Widget Name and Variable Name

The Palette Menu

The Widget Menu

The Module Menu

The Generate Menu

Keyboard Shortcuts

27. Widget Reference

FileSelectionBox

SelectionPrompt

Shells- Dialog, Top Level, Application and Session

Mapping Motif Widgets to Microsoft Windows

Mapping Motif Resources to Microsoft Windows

28. Troubleshooting in X-Designer

X-Designer Interface

Definitions and Instances

Unsupported Locale

Resource Panels

Code Generation

XD/Replay and XD/Capture

A. XD/Replay Command Syntax

Specifying the Context of Actions

Button Actions (Simple Controls)

Menu Operations

Option Menu Operations

Keyboard Operations

Button Actions (Position Dependent Controls)

Resource Evaluation

Widget Hierarchy Analysis

Non-application Operations

Condition Clauses

Display Expressions

Widget State Expressions

Importing User-Defined Commands

XD/Replay Widget Naming Conventions

B. Motif XP Reference

Motif XP Library

Linking Error With Some Compilers

C. Getters and Setters

How to Use This Information

More Information

Label, Button and IconGadget

Text Field, Text and Scrolled Text

List, Scrolled List and SimpleSpinBox

Option Menu and ComboBox

D. The XML Export File

Using the Exported XML File

E. Application Defaults

Callback and Prelude Editing

Microsoft Windows

Generate Dialog

Comments in Generated Code

Hierarchy Colors

F. Further Reading

Books Mentioned in This Manual

Books on X and Motif

Books on C++ and Object Oriented Programming

Books on Networking and World Wide Web

Books on Internationalization

Copyright © 2003, Sun Microsystems, Inc. All rights reserved.