Progress
Results Administration
and Development Guide
Feature Procedures
Feature procedures are Progress procedures that meet certain information interface requirements for Results. All feature procedures require a character input parameter and a logical output parameter. Consider the following template for a feature procedure:
These notes refer to the commented numbers in the template:
- Results requires a character input parameter to pass argument values specified in the Argument field of the Feature Editor. All feature procedures must have this input parameter even if you did not specify argument values in the Argument field.
The Progress 4GL supplies several language elements that allow you to parse strings, parse lists, and convert character values into different data types. For more information about these and other language elements, see the Progress Language Reference.
- This logical output parameter determines whether the Results window redisplays when the feature procedure finishes executing. If the feature procedure changes the current query or current view of the query, set the value of this output parameter to TRUE.
You can code feature procedures to perform all types of processing including interactive and noninteractive processing. Results supplies a complete API that you can use within a feature procedure to access and manipulate information. The Results API is based on a set of procedures and shared variables that contain information about the current state of the Results application and the current query in Results. For more information about the Results API see the "Results Application Programming Interface (API)" section.
Feature procedures can manipulate the Results application window, display a dialog box, or display a secondary application window. To implement a feature procedure that displays a second window, use the following technique to manage user focus and multiple windows in Results:
The commented numbers in the code refer to the notes below:
- Create a variable to hold the widget handle of the Results window.
- Place the widget handle of the Results window into the new variable. The CURRENT–WINDOW session handle returns the widget handle of the Results window.
- Minimize the Results window and disable it for user input while the feature procedure displays the second window.
- Restore the Results window and enable it for user input after the user closes the second window.
See the "Generating New Queries" section for a sample feature procedure. See the Progress Language Reference for a reference entry for each language element in the Progress 4GL.
Copyright © 2004 Progress Software Corporation www.progress.com Voice: (781) 280-4000 Fax: (781) 280-4095 |