Home | All Classes | Main Classes | Annotated | Grouped Classes | Functions |

[Home] [Next: Quick Start]

## Preface

### Introduction

This manual presents TQt Designer, a tool for designing and implementing user interfaces built with the TQt multiplatform GUI toolkit. TQt Designer makes it easy to experiment with user interface design. At any time you can generate the code required to reproduce the user interface from the files TQt Designer produces, changing your design as often as you like. If you used an earlier version you will find yourself immediately productive in the new version since the interface is very similar. And you will also find new widgets and new and improved functionality which have been developed as a result of your feedback.

TQt Designer helps you build user interfaces with layout tools that move and scale your widgets (controls in Windows terminology) automatically at runtime. The resulting interfaces are both functional and attractive, comfortably suiting your users' operating environments and preferences. TQt Designer supports TQt's signals and slots mechanism for type-safe communication between widgets. TQt Designer includes a code editor which you can use to embed your own custom slots inside the generated code. Those who prefer to separate generated code from hand crafted code can continue to use the subclassing approach pioneered in the first version of TQt Designer.

The manual introduces you to TQt Designer by leading you through the development of example applications. The first seven chapters are tutorials, each designed to be as self-contained as possible. Every chapter, except the first three, assumes that you are familiar with the material in chapters two and three which cover the basics of building a TQt application with TQt Designer. Here's a brief overview of the chapters:

- Chapter one, Quick Start, is a fast hands-on tutorial that takes you through the creation of a short, simple dialog application. The aim of this chapter is to give you a feel for how TQt Designer works, with explanations and details deferred to later chapters.

- Chapter two, Creating a Main Window Application, introduces TQt Designer and takes you step by step through the creation of a small but fully functional application. Along the way you will learn how to create a main window with menus, toolbars and a status bar. Most of the application's implementation will be covered, but the custom dialogs are deferred until chapter three. In the course of this chapter you will use the form and property editors to customize the application. You'll also learn how to use TQt's signals and slots mechanism and TQt Designer's built-in code editor to make the application functional. We will also explain how to use `qmake` to generate a Makefile so that you can compile and run the application.

- In chapter three, Creating Dialogs, we will create the custom dialogs required by the main window application created in chapter two. In addition to demonstrating various ways of creating dialogs, you will also learn how to lay out forms using the layout tools.

- Chapter four, The Designer Approach, provides information on the TQt Designer approach to developing applications, and explains some of the rationale behind TQt Designer.

- Chapter five, Subclassing and Dynamic Dialogs, will show you how to subclass a form; this allows you to clearly separate the user interface from the underlying code that implements its functionality. Additional information on `qmake` and `uic` is included in this chapter. This chapter will also explain how you can dynamically load dialogs from `.ui` files into your application using TQWidgetFactory and how to access the widgets and sub-widgets of these dialogs.

- Chapter six, Creating Custom Widgets, explains how you can create your own custom widgets. Both the simple method, that was introduced with the first version of TQt Designer, and the new more powerful method using plugins, are explained.

- Chapter seven, Creating Database Applications introduces TQt's SQL classes and takes you through an example that demonstrates how to execute SQL queries and how to set up master-detail relationships, perform drilldown and handle foreign keys.

- Chapter eight, Customizing and Integrating TQt Designer, focuses on TQt Designer itself, showing you how to customize Designer, how to integrate Designer with Visual Studio and how to create Makefiles.

The remaining chapters provide reference material that explains TQt Designer's menu options, toolbars, key bindings, dialogs, wizards, and windows in detail.

### What You Should Know

This manual assumes that you have some basic knowledge of C++ and the TQt GUI toolkit. If you need to learn more about C++ or TQt there are a vast number of C++ books available, and a small but increasing number of TQt books. TQt comes with extensive online documentation and many example applications that you can try.

The Enterprise Edition of TQt includes the TQt SQL module. In Creating Database Applications we demonstrate how to build SQL applications with TQt Designer; this chapter requires some knowledge of SQL and relational databases.

### What's New in TQt Designer for TQt 3.0?

This version of TQt Designer has a great deal more functionality than its predecessor. For example, the code for custom slots can be edited directly in TQt Designer; main windows with actions, toolbars and menus can be created; layouts that incorporate splitters can be used; and plugins allow you to package any number of custom widgets and make them available to TQt Designer. Many other enhancements have been incorporated, from small improvements in the user interface to improved efficiency, for example the ability to share pixmaps across all the forms in an application.

This version of TQt Designer introduces project files which make it easy to switch between all the forms in an application, and to maintain a common set of database settings and images. Although subclassing is fully supported, writing code directly in TQt Designer offers a number of benefits which are covered in The Designer Approach chapter. A new library, `libtqui`, has also been introduced which allows you to load dialogs dynamically at runtime from TQt Designer's `.ui` files. This allows you to provide your application's users with considerable interface customizability without them needing to use C++.

Although the new version of TQt Designer introduces new approaches and techniques you can ignore these aspects and simply use it in exactly the same way as you used the version supplied with TQt 2.x, if you just want a simple but powerful single dialog visual design tool.

#### What's New in TQt Designer for TQt 3.1?

- TQt Designer now features a start-up dialog for fast access to recently used files, etc. (It can be switched off if you don't want it.)

- The signals and slots dialog has changed significantly. It is far easier to use and much faster for creating lots of connections in one go. You can still click and drag to create connections, but the new dialog is much quicker.

- Widgets are now accessible using the Toolbox. (All the original toolbars are still available.) This provides the same easy access as toolbar buttons, and also shows the names of the widgets and takes up less space.

- TQWidgetStack is now available as a container widget. The new example demonstrates its use.

- `.ui.h` files may now contain arbitrary C++, including `const` definitions, `#include`s, plain functions, etc.

- When you select multiple-widgets their common properties are shown in the property editor and can be changed collectively.

#### What's New in TQt Designer for TQt 3.2?

- The tool box widget used by TQt Designer since TQt 3.1 is now available as a TQt widget for use in your own programs. The widget is called TQToolBox.

- The menu editor in TQt Designer has been redesigned to make it easier to visually design application main windows.

- Numerous small improvements to usability have also been incorporated in this version.

> TQt Designer

### Feedback

If you have any comments, suggestions, criticisms or even praise regarding this manual, please let us know at `doc@trolltech.com`. Bug reports on TQt or TQt Designer should be sent to qt-bugs@trolltech.com. You might also like to join the qt-interest mailing list, which TQt Designer's developers read and contribute to; see http://lists.trolltech.com for further details.

[Home] [Next: Quick Start]