Run Menu

The Run Menu displays commands for testing forms and projects and for using tools that affect or report on how a program runs. The commands on the menu are:

• Run Project -- Run the current project by calling the project Init Function. The default project init function creates and displays the main form.

  When you run a project (as opposed to running a single form with Run Form), the windows of the project are created in their own window hierarchy (or hierarchies), completely separate from IDE window hierarchy. This is done so that running the project from the IDE will emulate the eventual standalone application as closely as possible for more complete debugging.

  But this also means that IDE keyboard shortcuts are not available while the running project windows are selected, and the entire running project may get buried behind the IDE, since the whole IDE is always either in front of or in back of the entire running project. You can switch between the running project and the IDE as you would between two applications, by using the Windows Task Bar or the Alt-Tab gesture.

  The behavior is different when running a single form (with the Run Form command). In that case, the running window will be owned by the invisible IDE owner window, and therefore it can be intermingled among the various IDE windows and you can still use IDE keyboard shortcuts and so on. If you run a project when it is already running, the current running instance is first halted (and its windows are closed) and then the project is run again from scratch.

• Run Form -- Run the currently-selected form; that is, create and display the window associated with the currently-selected form.

  When you run a form, the running window for the form is owned by the invisible IDE owner window. Therefore, the running window behaves as if it were part of the IDE. That is, the window may be intermingled among the various IDE windows, and the IDE keyboard shortcuts may still be used. This is done so that the IDE is still conveniently available while quickly testing single forms.

  This behavior is different from the behavior when running the whole project by choosing the Run Project menu command or clicking the Run button on the Toolbar. When a project is run, the project's windows are created in their own hierarchy completely separate from the IDE, so that the running project will emulate the eventual standalone application as nearly as possible for more complete debugging.

  If you run a form which is already running, the current running window is first closed, and then it is created and run again from scratch.

• Stop -- Stops the running form or project and removes the active windows built from forms.

• Interrupt -- Tries to interrupt current computation. It may be what needs to be interrupted prevents the Run menu from displaying. The keyboard equivalent is the Pause key and pressing it may perform the interrupt.

• Trace -- Starts tracing the currently selected symbol.

• Untrace -- Stops tracing of the selected symbol.

• Untrace All -- Stops all tracing.

• Retrace -- This command on the Run menu causes functions that were being traced when Run | Untrace All was chosen to again be traced. Also, if choosing Run | Untrace resulted in nothing being traced, Retrace causes the last object traced to be traced again.

• Trace Status -- Prints information about what is being traced to the status bar.

• Trace Dialog -- Displays the Trace Dialog.

• Set Breakpoint -- Set a breakpoint at the selected symbol.

• Remove Breakpoint -- Remove the breakpoint associated with the selected symbol.

• Remove All Breakpoints -- Remove all breakpoints.

• Break Status -- Prints to the Project Window status bar information about what is breakpointed.

• Runtime Analyzer Control -- Displays a submenu with the following choices:
  • Start/Resume Sampling: if no runtime analysis has been started, start data collection. If an analysis is being run but data collection is suspended (with Suspend Sampling), resume data collection.
  • Suspend Sampling: suspends data collection until Start/Resume Sampling is clicked.
  • Stop: stops data collection. After clicking this command, runtime analysis data is ready for analysis. Starting sampling again will destroy current data.
  • Runtime Analyzer Status: prints information about the runtime analyzer (whether sampling is going on, etc.) to the status bar of the Project Window.

• Runtime Analyzer Control Dialog -- Displays the Runtime Analyzer Control dialog, which provides tools for controlling the runtime analyzer.

• Runtime Analyzer Results Dialog -- Displays the Runtime Analyzer Results dialog, which displays information about runtime analysis data.

Copyright (c) 1998-2006, Franz Inc. Oakland, CA., USA. All rights reserved.
Documentation for Allegro CL version 7.0. has had minimal revisions compared to the 6.2 page.
Created 2005.9.20.