www.digitalmars.com [Home] [Contents] [Prev] [Next]

2. Introducing the IDDE

This chapter introduces the Digital Mars C++ development system. The first part of the chapter describes the IDDE main window and toolboxes. The second part introduces Part Two of this manual, and outlines the steps involved in developing an application in the Digital Mars C++ IDDE.

Running Digital Mars C++ under Windows 3.1, Windows 95, and Windows NT

Digital Mars C++ ships with three different integrated development and debugging environments (IDDEs), each tailored to a specific operating system and target. The Digital Mars C++ installer program asks you to define the kind of programs you plan to develop, and then installs the appropriate IDDEs on your system. All IDDEs share the same user interface, and can build applications for DOS, Windows 3. 1, Windows 95, Windows NT 3.5, and DOSX. Minor differences between the three IDDEs are noted throughout this manual, as appropriate. Not every IDDE can debug every kind of executable. To debug a Windows NT program, for example, you need the full 32-bit IDDE running under Windows NT.

Screen images in this manual depict the Windows 3.1 IDDE, except where noted. The appearance of IDDE windows and dialog boxes under Windows NT and Windows 95 is slightly different.

Starting and exiting the IDDEs

To start the IDDE from the Program Manager, make sure that Digital Mars C++ is installed properly, then double-click on the appropriate Digital Mars C++ IDDE icon in the Digital Mars C++ program group. The IDDE main window opens at the top of your screen.

To exit the IDDE, choose one of three commands from the IDDE File menu: Exit, Exit & Save All, or Exit & Discard. Exit leaves the IDDE and returns to the Program Manager. Exit & Save All exits and saves all the changes to the current project and options. Exit & Discard exits the IDDE without saving any changes to the current project or options.

IDDE Windows and Toolboxes

In Digital Mars C++, you create, edit, and debug your application in the IDDE. The IDDE provides a variety of tools for use throughout the development process.

Unlike most Windows applications, the IDDE offers more than a single window in which to work. The IDDE is a feature-rich environment in which you work with multiple windows and toolboxes on your desktop. This section describes the general characteristics of those windows and toolboxes.

IDDE main window

The IDDE main window, shown in Figure 2-1, is positioned at the top of the desktop (workspace), which is your entire screen area. >From the IDDE main window, you can open other windows on the desktop, load projects, set project options, and perform additional tasks. Most of the actual work, such as editing program code, is done in other windows on the desktop.
	
	[Figure 2-1 IDDE main window]
As shown in Figure 2-1, the IDDE main window has the following parts: system menu, title/ status bar, main menu bar, and the minimize button. (Also shown is the Workspace toolbox docked below the main window. Docking means that the toolbox is attached to the IDDE main window, or the desktop edge.) The system menu and the minimize button are the standard Windows user interface elements. The other elements of the main window as well as the IDDE toolboxes are described in the following sections.

The title/status bar

The top line of the IDDE main window serves as both a title bar and a status bar. When you start the IDDE, the title bar displays the program name, Digital Mars C++. As actions occur in the IDDE, the title bar changes to a status bar and displays the status of the session, including the following information:

The menu bar

The IDDE main window menu bar is located below the title bar. Table 2-1 summarizes the functions of the IDDE menus.
	Table 2-1 The IDDE menu functions 

	Menu		Function 

	File		Opening and closing text files, exiting the IDDE 
	Project 	Opening, closing, and editing projects, 
			building the project, setting project 
			options 
	Debug		Switching into debugging mode, 
			controlling program execution while 
			debugging, setting debugging options 
	Environment	Creating and using workspaces, 
			customizing the IDDE 
	Resource	Creating and editing resources 
	Tools		Accessing AppExpress, ClassExpress, 
			Global Find, and your own tools 
	Window		Opening and arranging windows and 
			toolboxes 
	Help		Accessing online help 
For information on how to choose menu commands, see your Windows, Windows 95, or Windows NT documentation.

The IDDE toolboxes

The IDDE includes the following four toolboxes: Open a toolbox through the IDDE's Window menu. If the toolbox's name is checked, it appears in the workspace. If the name is not checked, select it to open the toolbox. The following sections describe the toolboxes in detail.

The Views toolbox

The Views toolbox, shown in Figure 2-2, is used to open the IDDE windows. Each of the IDDE windows is represented by an icon in the toolbox.
	
	[Figure 2-2 Views toolbox]
To open a window from the Views toolbox, click and drag the appropriate icon from the toolbox onto the desktop. Alternatively, double-click on the icon to open the window. To replace one window on the screen with another, drag the icon of the window you want into a window on the desktop. Table 2-2 lists the IDDE windows.
	Table 2-2 IDDE windows and their functions 

	Window name	Function 

	Assembly	Debugging; shows assembly-level source 
	Breakpoint	Debugging; used to work with breakpoints 
	Call		Debugging; shows call chain 
	Class Editor	Used to edit class hierarchies 
	Command Line	Debugging; provides CodeView-like interface to 
			the debugger 
	Data/ Object	Debugging; shows local or global data 
	Function	Debugging; shows the functions in your 
			application 
	Graphic Data	Debugging; shows a graphic representation of a 
			data structure 
	Hierarchy Editor Used to edit class hierarchies 
	Inspector	Debugging; shows local and global data 
	Output		Shows output of compiler, linker, and parser 
	Memory		Debugging; shows memory contents 
	Project		Displays the files in the project 
	Register	Debugging; shows contents of registers 
	Source		Used to create and edit source code 
	Spy		Debugging; used to view Windows messages 
	Thread		Debugging; shows the program's threads 
			(Windows NT only) 
	Trace		Debugging; shows trace messages 
	Watch		Debugging; used to work with watchpoints 
You can open multiple Data and Source windows. When you have more than one Data or Source window open, and then you minimize more than one of them, the IDDE adds a pop-up menu to the Data or Source icons in the Views toolbox (see Figure 2-3). A small triangle in the lower-right corner of the icon indicates that a Source or Data window is minimized.
	
	[Figure 2-3 Pop-up menu in Source icon]
To open a minimized Data or Source window:
  1. Move the cursor over the triangle in the lower-right corner of the Data or Source window icon.
  2. Click to open the pop-up menu.
  3. Choose the window title you want from the pop-up menu. That window becomes active.
Alternatively, move the cursor over the window title in the pop-up menu, then click and hold the mouse button. A window icon appears to the right (see Figure 2-3). Drag the cursor over the icon, then move the cursor over either the desktop or an open window and release the mouse button.

The Build toolbox

The Build toolbox, shown in Figure 2-4, provides quick access to project build commands.
	
	[Figure 2-4 Build toolbox]
To use the Build toolbox, click on the appropriate button in the toolbox. These buttons perform the following tasks:

The Debug toolbox

Debug toolbox icons (shown in Figure 2-5) let you efficiently choose debugging commands during a debugging session. The commands available in the Debug toolbox correspond to the commands on the IDDE Debug menu and are described in detail in the section "Debug Toolbox Icons," in Controlling and Configuring the Debugger.
	
	[Figure 2-5 Debug toolbox]

The Workspace toolbox

When you first open the IDDE, the Workspace toolbox appears docked below the IDDE main window menu bar. The Workspace toolbox is used for switching between workspaces, which are customized layouts of windows that you define. The Workspace toolbox is shown in Figure 2-6.
	
	[Figure 2-6 Workspace toolbox]
As you create new workspaces, their names appear on tabs in the Workspace toolbox. To switch to a different workspace, click on its tab. For more information on defining workspaces, see Starting a Project and Defining Workspaces.

Using toolboxes

The IDDE's Window menu lists the names of all toolboxes. When a checkmark is displayed next to the toolbox name, the toolbox appears in the current workspace. To open a toolbox, select the toolbox name from the IDDE's Window menu.

You can position a toolbox on the desktop by clicking on its title bar and dragging the toolbox to the desired position on the screen. To dock a toolbox, position it on the IDDE main window or on the edge of the screen. To undock the toolbox, click on the toolbox and drag it away from the IDDE main window or the desktop edge.

You can change the shape of a toolbox by clicking the toolbox edge and dragging the outline of the toolbox to the desired shape.

If you want to remove an icon from a toolbox, right-click on the icon you want to remove, drag it from the toolbox, and drop it.

Toolboxes can be configured with commands in their pop-up menus. To access a toolbox's pop-up menu, right-click on an empty part of the toolbox (as shown in Figure 2-7). When the first menu item, Dockable, is checked, you can dock the toolbox. The next three items (Small, Medium, and Large) let you change the size of the toolbox and its icons. The last item on the menu, Reset Palette, lets you restore any icons or buttons you have removed from the toolbox.

	
	[Figure 2-7 toolbox pop-up menu]
To identify a toolbox icon, hold the mouse cursor over the icon for a few seconds. A small yellow tag appears, showing the name of the icon. When you want to close a toolbox, click on the Close box. Each toolbox has a Close box in the upper-right corner, as shown in Figure 2-8.
	
	[Figure 2-8 Close box]

The IDDE windows

This section describes the general properties of the IDDE windows and how to work with them.

Opening and closing windows in the IDDE

Digital Mars C++ supports both standard Windows methods and a few unique methods for displaying and managing windows. In the IDDE, you can open a window in any of the following ways: When you open a Source window to edit a specific source file, the filename is added to the Window List dialog box. You can then activate this particular window from the Window List dialog box.

Each window has a Close box similar to that of a toolbox (see Figure 2-8). Click on the box to close the window.

Using the drag-and-drop feature

The Digital Mars C++ IDDE provides a drag-and-drop feature that lets you execute commands by dragging from one window onto another or onto the desktop. For example, you can drag a module's name from the project window onto the desktop in order to edit that module in a Source window. When something cannot be dropped on a particular window or the desktop, the cursor changes from that icon to a "No" sign (a circle with a diagonal line through it). Most of the drag-and-drop functionality is available in debugging mode and is described in Commands Available in Debugging Mode.

Using the IDDE

The following sections serve as an overview of Part Two of this manual and introduce you to the process involved with creating an application in the Digital Mars C++ environment.

Creating a project

Projects are integral to the Digital Mars C++ development system. You cannot build an application without creating a project. A project is a collection of source files, headers, resource files, and other components that you need to build an application.

To help you create a new project, a new tool called ProjectExpress is included. This tool lets you select the project target (the result of your development efforts), the directory for your project files, and other options. While in ProjectExpress, you can also use AppExpress to generate the framework for your application.

AppExpress is a tool that automatically generates an application framework. AppExpress lets you select from a variety of application types, then creates a working skeleton of source code and resource definitions. After the framework is generated, you can concentrate on customizing the framework and implementing the features of your application.

Using workspaces

Because the IDDE provides a variety of windows used for specialized tasks, you probably do not need all of them open simultaneously. The IDDE workspaces provide a convenient way to switch from one screen layout to another. Workspaces are task-oriented, as opposed to project-oriented. You create workspaces for different tasks, such as editing, browsing, or debugging, which you perform in different projects. The Workspace submenu of the IDDE's Environment menu provides access to workspace commands.

Creating and editing your application

Once you have created a project, you can start working on the program's code. This section introduces the IDDE tools.

Creating and editing resources

If you are writing a Windows application, you probably need to create resources such as menus and dialog boxes. Commands on the IDDE's Resource menu access the Digital Mars C++ ResourceStudio, a powerful tool for creating and editing resources.

Binding resources to classes

ClassExpress is a tool for binding resources, such as dialog box controls, to the classes in your program. You need to do this in order to be able to respond to user actions. You can launch ClassExpress by choosing ClassExpress from the IDDE's Tools menu, or from within ResourceStudio.

Editing class hierarchies

The IDDE provides two tools for editing class hierarchies: Class Editor and Hierarchy Editor. You can open a Class or Hierarchy Editor window from the Views toolbox, or from the Goto View submenu of the IDDE's Window menu. Both editors have the same functionality, but different interfaces. The Class Editor emphasizes member editing, while the Hierarchy Editor emphasizes inheritance relationships.

Editing code

While you can greatly reduce the amount of work needed to write a complex application using the tools Digital Mars C++ provides, eventually you need to edit the raw source code. The IDDE includes a powerful, scriptable text editor with features such as customizable key bindings, automatic token coloring, delimiter matching, and other features. Edit your code in the Source window, which you can open from the Views toolbox or the Goto View submenu of the IDDE's Window menu.

Debugging your application

After you write most or all of your application's source code, you need to test and debug it. You do this by switching the IDDE into debugging mode and using the commands on the IDDE's Debug menu, the Debug toolbox, and various debugging windows you open from the Views toolbox.

Using help

The following sections describe several ways to get online help in the IDDE.

The title/status bar

When you click and hold on a command in a menu, the IDDE main window title/ status bar shows you a brief description of the menu command.

The IDDE Help menu

The IDDE provides several online help systems through the IDDE Help menu. The first items on the IDDE Help menu access the IDDE Help system, shown in Figure 2-9. To navigate the IDDE Help system, click on the icon representing the type of help you need.

Alternatively, choose Search from the IDDE Help menu to find a particular topic in the IDDE Help system.

	
	[Figure 2-9 IDDE Help system]
Other commands on the Help menu access Windows API and Microsoft Foundation Class reference material.

Finally, the About Digital Mars C++ command on the IDDE Help menu displays a dialog box with version information on the Digital Mars C++ Development System.

Other ways to launch online help

To view help information for a Digital Mars C++ run-time library function, you can highlight the name of the function in a Text Editor window and type CTRL+ ALT+ F1.

You can view help topics you use frequently without navigating IDDE Help, by associating specific .HLP files with key combinations. (For example, to view help for ResourceStudio, you could map RSTUDIO. HLP with the key combination CTRL+ ALT+ F4.)

To associate a key combination with a help file, choose Edit/Browsing Settings from the IDDE's Environment menu. Click Text, then click Help files.