OS/2 Shareware BBS: 10 Tools/10-Tools.zip/pdd.zip/Designer.HLP

OS/2 Help File | 1998-03-05 | 499KB | 16,404 lines

ΓòÉΓòÉΓòÉ 1. Copyright ΓòÉΓòÉΓòÉ

Copyright (c) 1989-1998  Prominare Inc.  All rights reserved.


ΓòÉΓòÉΓòÉ 2. Prominare Designer Introduction ΓòÉΓòÉΓòÉ

                                 Welcome to the
                               Prominare Designer
                                   Release 5c

Please read the information provided within this window so you will become
instantly familiar with the basic operation of Prominare Designer Release 5c.

Mouse Operation

Mouse operation within Prominare Designer is quite straight forward and easy to
use.  Double clicking the mouse pointer on a control within the window or
dialogue you are designing will cause the appropriate styles dialogue to be
displayed.  Clicking the mouse pointer using button 2 on a control will cause
the selection frame to be displayed or removed from that control.

To move a control, click the mouse pointer on the control and keep button 1 of
the mouse pressed.  While the mouse button is pressed, you can then move the
mouse around within the window or dialogue with the tracking frame being
displayed showing the relative placement of the control selected.  When you
release the mouse button, the control will be moved to that location.  While
performing this operation, the x and y position of the lower left corner of the
control will be displayed within the status window in the bottom right corner
of the Prominare Designer window.

To select individual controls for a group, you only need to press the Ctrl key
and button 1 of the mouse.  When you do this, the control that you have clicked
the mouse pointer on will be added to the group of controls selected if an
existing group is present, or a new group will be started.  Also, if you click
the mouse pointer within the dialogue area and not over a control keeping both
the Ctrl key and button 1 of the mouse pressed and drag the mouse pointer over
controls, you will notice a rubber band selector being displayed thereby
allowing you to quickly select controls for a group.  After you release the
mouse button, the controls falling within the rubber band will form the group.
You can then add or remove controls from the group using the Ctrl key, button 1
combination.

To move the selected group of controls, you press the Alt key and then button 1
of the mouse keeping the mouse button depressed.  While you move the mouse
around, the tracking frame will be displayed showing the relative position the
group would have if it is moved.  The x and y positions within the status
window at the bottom of the Prominare Designer window will show the absolute
position.

You can through the Mouse tab configure how the mouse is used such that other
key/mouse combinations can be defined in place of the defaults described above.

Symbol/ID colors

The Symbol/ID drop-down, which is used to define and/or select a symbol/ID
displays the symbols in different colors.  The colors are used to denote
predefined OS/2 symbols, new symbols added to the design, symbols used within
the design and symbols not used within the design.

Menu lists symbol colors

For the menu lists, action bar menu items and sub-menus are displayed in colors
to allow you to quickly distinguish each type.


ΓòÉΓòÉΓòÉ 3. Prominare Designer Update ΓòÉΓòÉΓòÉ

                                   Welcome to
                               Prominare Designer
                                   Release 5c

Please read the information provided within this window so you will become
instantly familiar with the new features and enhancements of Prominare Designer
Release 5c.

The following describes some of the changes made to Release 5:

      Source coding rules:
           Changed Rules menu to Source menu.
           Changed MLE's to new edit control within the source coding rules
           dialogues.
           Added formatting capabilities to source code rules.
           Added break/return tab to source coding rules editing.
           Allow the exporting of the rules to an ASCII with tags to allow mass
           editing of the rules.  Then using the same file import the
           information        based on the tags.
           Replaced the Source submenu with a single dialogue containing
           notebook.
      Tool bar
           Added undo and redo buttons.
           Added a tool bar button to turn on or off the code generation.
           Added Save source code toolbar button.
      Dialogues
           Changed most notebooks to the new notetab control.
           Added a simplified New Design dialogue.
           Dialogues look correct on systems that have font defined        for
           system that is different that System Proportional.
           Added simpler dialogues for styles (basically modelled after
           DlgEdit).
           Redesigned styles dialogues to use the notetab metaphor for styles,
           fonts and        colours, bidi and pen options.
      Editing
           Added new page to align dialogue that allows selected controls to be
           shifted to a given side or sides.
           Added new push button alignment for bottom right.
           Allow use of keys to move, size and snap controls to grid.
      PMCX
           Added example of PMCX control where more than one control
           type contained within a single DLL while still maintaining
           PMCX usage in Prominare Designer.
           Added Notetab PMCX control to PMCX samples.
      Support dialogues
           Added Save button to Support dialogues to allow the user to save the
           current info and        exit.  The user can then come back to
           re-edit the info.
      Removed hard coded path for help table definition.
      Added ability to locate window or dialogue procedure for editing within a
      sizeable        dialogue.  Also allowed for spot code generation of the
      window or dialogue.
      Added support to allow dialogue font metrics to be targetted for system
      font.
      Added DLL support for code generation.
      Ability to remove imbedded tabs in the rules.
      Take into consideration those who have changed the system font to
      something else.
      Allow tab option for source files.
      Added DBCS support.

 The following describes some of the changes made to Release 5b:

      Added new OS/2 Warp Version 4.0 styles (Notebook button,   MLE Vertical
      Scroll Limit, Window/Dialogue Close button,   and Notebook tab and button
      areas).
      Added option of targeting OS/2 Warp Version 4.0.

 The following describes some of the changes made to Release 5c:

      Added UniCode support for Windows NT. -U on the   command line causes the
      UniCode filter routines   to be used.
      Inhanced notebook testing support.
      Dialog font metrics support improved.


ΓòÉΓòÉΓòÉ 4. About the Prominare Designer ΓòÉΓòÉΓòÉ

The Prominare Designer is a Presentation Manager based application for
designing Presentation Manager applications. It is used to create an
applications window including menus and dialogues.

The help facility is designed to give a context-sensitive description of the
dialogue or window you invoked help from.  It is not intended to be a tutorial.

For more information about using the help facility, select Using help on the
Help pull-down.

Windows and dialogues created through Prominare Designer are stored in in
script format (.RC) or in binary format (.RES) and internal format (.PDF).  You
use the Resource Compiler to compile the resource script (.RC file) to be able
to attach to the final executable version of the program.

Prominare Designer will automatically assign an integer value to each item you
create.  You can replace the default value with a symbolic value and integer.
These values are placed in an include (.H) file. Prominare Designer can read
and save to include files that contain comments.

The main window area of Prominare Designer is the editing area.  A window or
dialogue you are designing will be displayed in that area.  You can select a
window, dialogue or control by clicking the mouse pointer on it.  Using button
1 on the mouse allows you to adjust the item. A frame is displayed around the
selected item with the mouse pointer changing to a cross when it is over the
item.

At the bottom of the Prominare Designer window is a window containing status
information.  Within this window, information will be displayed stating the
current operation, the x and y points and width and height of the selected
item.  The relative position of the item is shown along with the type of item
selected and its symbolic value.


ΓòÉΓòÉΓòÉ 5. Prominare Designer Startup ΓòÉΓòÉΓòÉ

When you first start Prominare Designer, you will be presented with the
Prominare Designer Startup dialogue.  This dialogue allows you to select the
initial actions that will be performed.  These include starting a new design
through the New Design dialogue.  The second option allows you to open an
existing design through the File Open dialogue.  The third options allows you
to import a binary or script resource file (or extract the binary resources
from an executable or DLL) through the Import dialogue.  Finally, you can
select from a list of the last opened files.


ΓòÉΓòÉΓòÉ 6. Help for Status Area ΓòÉΓòÉΓòÉ

The status window at the bottom of the Prominare Designer window displays
information as you select items and make changes. Measurements within the
window are shown in dialogue units. Horizontally, one dialogue unit is equal to
one-quarter the width of an average character in the system font. Vertically,
one dialogue unit equals one-eighth the height of a character in the system
font.

The status window contains the following information:

 Item                          Description
 Mode                          Shows the current operating mode. Modes include
                               selecting menu items, creating, editing and
                               deleting controls, viewing, arranging and
                               saving.
 Groups                        Shows the number of controls contained within
                               the selection group.
 Control                       Shows the type of control currently selected.
                               This may be Push Button, Auto Check Box, Check
                               Box, etc. When a window is selected, it displays
                               Window. Likewise, when a dialogue is selected,
                               it displays Dialogue.
 Relative                      Shows how the current selected window, dialogue,
                               or control is positioned. For windows or
                               dialogues, the relative position may be Window,
                               Screen, or Mouse. For controls, it will always
                               be Window or Dialogue, depending on the type in
                               which it is placed.
 [x, y]                        Shows the current position of the lower left
                               corner of the selected window, dialogue, or
                               control.
 Focus                         Displays the ID symbol or value of the control
                               to receive the initial focus within a dialogue.
                               If a window is displayed, the N/A symbol is
                               displayed. If no control has been selected, the
                               Default symbol is displayed.
 Value                         Shows the current ID symbol (or value if no
                               symbol has been defined) for the window,
                               dialogue, or control selected.
 [cx, cy]                      Shows the current width and height of the
                               selected window, dialogue, or control.

 The bottom area of the status window contains an area for additional messages
 relating to the dialogue or window you are designing. When a PMCX control
 cannot be located, an error message is displayed stating which control could
 not be found. The status window is also used to display information regarding
 a selected control. For example, the cell size of a value set control is
 displayed. This helps with sizing a control that must accommodate bitmaps of a
 given size. Next to this message area are a series of check indicators that
 denote the target operating system environment under which the selected
 control can run. These are:

 Item           OS
 OS/2 1.x       OS/2 1.x
 OS/2 2.x       OS/2 2.x, OS/2 Warp 3.0 or OS/2 Warp 4.0
 MMPM/2         OS/2 Version 2.1 with MMPM/2 Version 1.1 or higher installed
 Pen for OS/2   OS/2 Version 2.1 with Pen for OS/2 Version 1.0 or higher
                installed
 Windows        Windows 3.1 or Windows NT


ΓòÉΓòÉΓòÉ 7. Help for Prominare Designer Startup ΓòÉΓòÉΓòÉ

This Prominare Designer Startup allows you to select the initial actions that
will be performed.  These include starting a new design through the New Design
dialogue.  The second option allows you to open an existing design through the
File Open dialogue.  The third options allows you to import a binary or script
resource file (or extract the binary resources from an executable or DLL)
through the Import dialogue.  Finally, you can select from a list of the last
opened files.

The Display on startup check box allows you to disable the dialogue from being
displayed when the Prominare Designer starts each time.

If you prevent the Prominare Designer Startup from being displayed and you want
to have it redisplayed, you can select the Display initial action dialogue
option within the Options tab of the Prominare Designer Default Usage dialogue.

Clicking the mouse pointer on the Start push button causes the selected action
to be performed.  Clicking the mouse pointer on the Cancel push button causes
no actions to be performed and hides the dialogue.


ΓòÉΓòÉΓòÉ 8. Help for Tool Bar ΓòÉΓòÉΓòÉ

The Tool Bar contains various button selections that allow you to easily
configure Prominare Designer or select options.

You select windows or dialogues you wish to work on through the combo-box
labeled Windows/Dialogues.  When you select the window or dialogue to work on,
it will be displayed.

To the right of the combo-box are tool bar buttons.  Each of the buttons allows
you to quickly configure Prominare Designer.

The first button of the first row:

is used start a new design.

The next button:

is used to open an existing design file.

The next button:

is used to save the design file along with the resource file and source code
files.

The next button:

is used to print the currently displayed window, dialogue or popup menu.

The next button:

is used to search the design for a specified text string, ID symbol or value.

The second of the search buttons:

is used to turn on or off the duplicate ID scanning function that is
automatically performed when you save a design.  This function checks for
duplicate IDs that will cause an error either in the resource compile of the
resource script file or in the resource binding.  A duplicate ID is considered
only on a high-level basis like menu's, dialogues, tables, resources, etc.

The first clipboard button:

is used to cut the window, dialogue or selected controls from the design and
place them on the clipboard.

The second clipboard button:

is used to copy the window, dialogue or selected controls from the design and
place them on the clipboard.

The last clipboard button:

is used to paste the window, dialogue or selected controls into the design from
the clipboard.

The next button:

is used to define the resource distribution.

The next button:

is used to enter or edit design notes for the displayed window or dialogue.

The next button:

is used to define the messages that are to be handled by the displayed window
or dialogue.

The next button:

is used to create a new window or dialogue.

The first of the group oriented buttons:

is used as the alignment mode button.  By selecting the button, you cause
Prominare Designer to display the Align Group. dialogue to be displayed.  It
will allow you to apply the final alignment to the group of controls selected.

The second group oriented button is:

which is used as the replace mode button.  By selecting the button, you cause
Prominare Designer to display the Replace Controls. dialogue to be displayed.
It will allow you to replace the selected controls with another control type or
style.

The duplicate tool bar button is:

and can be used to set Prominare Designer into duplicate control mode.  When
you select the button, each time you select a control within the window or
dialogue, the control will be duplicated.  This mode will be retained until you
turn it off by selecting the button a second time.

The mouse align tool bar button is:

is used to set the offset position from which the dialogue is to be placed when
the dialogues positioning is relative the mouse.  Selecting the tool bar button
causes the mouse pointer to change into the offset selection pointer which is
then positioned in the location where the mouse pointer should appear when the
dialogue is displayed.  The position indicators in the status window will
display the current location of the lower left corner of the dialogue in
relation to the mouse.  Once you have clicked the mouse pointer at the location
where you want the mouse pointer to be displayed when the dialogue is
displayed, the Relative Mouse Position dialogue will be displayed showing the
offset position of the lower left of the dialogue.  You can enter different
values in place of those displayed.

You can cause the same dialogue to be displayed by double clicking button 2
with the mouse pointer on the tool bar button.  This will allow you to manually
enter the value of the offset.

It should be noted that the tool bar button can only be selected when you set
the Relative option within the Window/Dialogues Styles dialogue to Mouse.

Beside the relative mouse position button is:

The set focus button is used to set the control that is to receive the initial
focus when the dialogue is first displayed.  When you select the button, you
move the mouse pointer over the controls within the dialogue. As the pointer
moves over the controls, it will change shape from an arrow to a four headed
arrow or to a circle with a slash in it.  When the pointer is the four headed
arrow, it signifies that the control can be selected as the initial focus
control.  Conversely, when the mouse pointer is a circle with a slash through
it, the control can not be selected to receive the initial focus.  The tool bar
button will return to its original shape when you have selected the required
control.

Beside the set focus button is:

The arrange controls button is used to arrange the display order of controls
within a window or dialogue.

A dialogue will be displayed with a list of all the controls in the window or
dialogue.  You can then select a control and move its relative display order to
another position.

You can also set groups and tab stops within the dialogue.

The first of the last set of buttons on the first row:

is used to display the template of the VGA display within the Prominare
Designer window when you are working on a high resolution type monitor.  This
button is only selectable when working on a screen that is in a display mode
higher than 640 x 480 (VGA).  It will show the relative sizes of a VGA screen
thereby allowing you to check you dialogue sizes against the template size.

The next button:

is used to display the Tools window.  Selecting the tool bar button causes the
Tools window to be displayed.  Selecting it when it is in the down position
will cause the Tools window to be hidden.

The last tool bar button:

is used to cause Prominare Designer to record the location of itself such that
when you exit Prominare Designer, the size and location are noted such that
when you start Prominare Designer the next time, it will be displayed in the
same location and size.

The first button of the second row beside the Window/Dialogue drop-down:

is used as the undo the previous operations.  By selecting the button, you
cause Universal Resource Editor undo the last action performed with a control
or set of controls.

The second button of the second row:

is used as the redo the previous operations.  By selecting the button, you
cause Universal Resource Editor redo the last action with a control or set of
controls that was undone.

The next button of the second row:

is used as the test button.  By selecting the button, you cause Prominare
Designer to switch from design mode to testing mode.  You can then test you
window or dialogue.  To return back from test mode to design mode, you select
the button again.

Beside the test button is:

The presentation parameters button is used to set or remove the font and colors
of the control or the group of controls that you have selected within the
window or dialogue.  When selected, it causes the Font & Color dialogue to be
displayed.  It will allow you to set the colors and fonts for the selected
controls.

Beside the presentation parameters button is:

The font button is used to set or remove the font the control or group of
controls that you have selected within the window or dialogue.  When selected,
it causes the Font dialogue to be displayed.  It will allow you to set the
fonts for the selected controls.

Beside the font button is:

The pen options allow you to set the various pen oriented options for the
selected controls that are pen centric.

Beside the pen button is:

The bidirection options allow you to set the various bidirectional options for
the selected controls.

The control limits tool bar button is:

and can be used to determine the limits of a particular display device with
respect to the controls within a window or dialogue.  Using the device
definitions entered through the Display Units dialogue, you can see if the
current control size is adequate for a given display device.  For example, if
you are using a display with a resolution of 1024 x 768, you may find that the
controls that you have set up in a dialogue appear clipped within the dialogue
when it is displayed on a system that is 640 x 480 in resolution.  When you
have selected the target device and select the Display Limits tool bar button,
a rectangle will appear around each control showing the limits that would apply
if the control was displayed on the target device selected.

To pick the target display, double click button 2 of the mouse on the button
which will cause the Display Limits dialogue to be displayed where you can
select the target device to test the limits against.

The show IDs tool bar button is:

is used to display the numeric values of each of the controls within the window
or dialogue.  The numeric values will be shown in red against a white
background within each control.

The next tool bar buttons:

is used to display the positioning grid.  Selecting the tool bar button causes
the grid to be displayed within the window or dialogues that you are designing.
It also causes the placement of controls adhere to the grid if requested.
Selecting it when it is in the down position will cause the grid to be removed.
Double clicking button 2 of the mouse while the pointer is over the tool bar
button will cause the Grid dialogue to be displayed which will allow you to
enter the size of the grid to use.

The next tool bar button:

is used to cause Prominare Designer to generate the source code for the
application you are designing without saving the design file and the resource
files.

The next tool bar button:

is used to allow the generation of source code.  When the tool bar button is in
the down position, source code will be generated otherwise when in the up
position, no source code will be generated.

The final tool bar button:

is used to cause view the source code for the window or dialogue currently
displayed.


ΓòÉΓòÉΓòÉ 9. Help for Test ΓòÉΓòÉΓòÉ

The  Tool Bar button is used to start and end the testing of a window or
dialogue.

When the button is in the up position, it denotes that you are in design mode
where you can add and remove elements from the window or dialogue you are
currently editing.  These elements include controls, menus, sub-menus, etc.

When you click the mouse pointer on the test button, you change from design
mode to test mode.  Once in test mode, you cannot add or delete design
elements.

The testing of the window or dialogue will allow you to see how your window or
dialogue feels and also test the linkages between it and other dialogues.

When you click the mouse pointer on the button a second time, you will be
placed back into design mode from test mode where you can continue to add or
remove design elements.

You can also enter or exit test mode by pressing Ctrl+T on the keyboard. The
window or dialogue that you are designing will be placed into or removed from
test mode.  Any dialogue links that are active during the testing of the window
or dialogue will be destroyed and you will be returned to design mode of the
starting window or dialogue.

Note:  If you have designed a dialogue that is linked to a menu or push button
       and you have invoked that dialogue during the testing AND that dialogue
       does not possess a system menu or push button with an ID value of DID_OK
       or DID_CANCEL, you can cause the dialogue to be dismissed by pressing
       the Esc key on the keyboard.


ΓòÉΓòÉΓòÉ 10. Help for Alignment ΓòÉΓòÉΓòÉ

The Align Controls dialogue is used to select the alignment type for the
controls selected for aligning.

You can align the selected controls either horizontally or vertically, with
equal spacing, same size and push button alignment.

The tabs within the dialogue provides the five different alignment types:

      Alignment
      Spacing
      Size
      Push buttons
      Shift

 The order that the alignment progresses is:

   1. Auto-sizing
   2. Push buttons
   3. Alignment
   4. Size
   5. Spacing
   6. Shift

 The Align push button is used to align the controls selected, whereas, the
 Cancel push button is used to cancel the alignment process.


ΓòÉΓòÉΓòÉ 11. Help for Align Controls Dialogue ΓòÉΓòÉΓòÉ

The Align Controls dialogue is used to select the alignment type for the
controls selected for aligning.

You can align the selected controls either horizontally or vertically, with
equal spacing, same size and push button alignment.

The tabs within the dialogue provides the five different alignment types:

      Alignment
      Spacing
      Size
      Push buttons
      Shift

 The order that the alignment progresses is:

   1. Auto-sizing
   2. Push buttons
   3. Alignment
   4. Size
   5. Spacing
   6. Shift

 The Align push button is used to align the controls selected, whereas, the
 Cancel push button is used to cancel the alignment process.


ΓòÉΓòÉΓòÉ 12. Help for Font & Colours ΓòÉΓòÉΓòÉ

For certain types of controls within a dialogue, you can define additional font
and colors.

The dialogue allows you to define the colors for the following areas of a
control:

     Foreground
     Background
     Highlight Foreground
     Highlight Background
     Disabled Foreground
     Disabled Background
     Border
     Active color (2.x and Warp only)
     Inactive color (2.x and Warp only)
     Active text foreground (2.x and Warp only)
     Active text background (2.x and Warp only)
     Inactive text foreground (2.x and Warp only)
     Inactive text background (2.x and Warp only)
     Shadow (2.x and Warp only)
     Shadow text (2.x and Warp only)
     Shadow highlight foreground (2.x and Warp only)
     Shadow highlight background (2.x and Warp only)
     Icon text background (2.x and Warp only)

 For certain types of controls within a dialogue, you can define additional
 font and font size.  All fonts that are available on your system will be
 selectable through the drop-down list.


ΓòÉΓòÉΓòÉ 13. Help for Fonts ΓòÉΓòÉΓòÉ

For certain types of controls within a dialogue, you can define additional font
and font size.  All fonts that are available on your system will be selectable
through the drop-down list.


ΓòÉΓòÉΓòÉ 14. Help for Set Initial Focus ΓòÉΓòÉΓòÉ

You can change the default initial focus within a dialogue by using the Set
focus Tool Bar button on the Tool Bar.

OS/2 Presentation Manager will set the default focus within a dialogue to the
first tab-stop item within the dialogue.  It also allows you to set the focus
to another control by setting the focus to another control and to inform it of
doing so.

This allows you to designate the control that you want to have the focus when
the dialogue is created.  After you have selected the the Tool Bar button, the
mouse pointer will change to a four arrow headed selection shape or a circle
with a slash through it depending on where you move the pointer.

When the pointer is the four arrow headed shape, this indicates that the
control could have the initial focus whereas when it is the circle with a
slash, the control cannot have the focus.

Once you click button 1 of the mouse on the control that is to receive the
focus, Prominare Designer will record the control selected and will generate
the appropriate code in the WM_INITDLG message handling within the dialogue
procedure.  Within the status window, the ID value for the control that is to
receive the initial focus will be shown.


ΓòÉΓòÉΓòÉ 15. Help for Replace Controls Dialogue ΓòÉΓòÉΓòÉ

The Replace Controls dialogue is used to select the replacement control type
for the controls selected.

The selected controls will have there type changed to the new type selected
from the type shown in the dialogue.  You can select from the following types:



      push button


      Check box


      Radio button


      Horizontal scroll bar


      Vertical scroll bar


      List box


      Entry field


      Groupbox


      Static text


      Frame


      Rectangle


      Icon


      Bitmap


      System icon


      Combination box


      Multiple-line entry field


      Spin button


      Container


      Slider


      Value set


      Notebook


      User defined


      Circular slider


      Graphic button


      Handwriting


      Sketch


      Child window

 When the control type selected is User defined, the User Define. dialogue will
 be displayed allowing you to select the actual user defined or custom control
 to use as the replacement type.

 The Replace push button is used to replace the controls selected, whereas, the
 Cancel push button is used to cancel the replacement process.


ΓòÉΓòÉΓòÉ 16. Help for Replace Controls ΓòÉΓòÉΓòÉ

The Replace Controls dialogue is used to select the replacement control type
for the controls selected.

The selected controls will have there type changed to the new type selected
from the type shown in the dialogue.  You can select from the following types:



      push button


      Check box


      Radio button


      Horizontal scroll bar


      Vertical scroll bar


      List box


      Entry field


      Groupbox


      Static text


      Frame


      Rectangle


      Icon


      Bitmap


      System icon


      Combination box


      Multiple-line entry field


      Spin button


      Container


      Slider


      Value set


      Notebook


      User defined


      Circular slider


      Graphic button


      Handwriting


      Sketch


      Child window

 When the control type selected is User defined, the User Define. dialogue will
 be displayed allowing you to select the actual user defined or custom control
 to use as the replacement type.

 The Replace push button is used to replace the controls selected, whereas, the
 Cancel push button is used to cancel the replacement process.


ΓòÉΓòÉΓòÉ 17. Help for Duplicate ΓòÉΓòÉΓòÉ

To aid the creating of similar controls within the current window or dialogue,
select the Duplicate Tool Bar button on the Tool Bar.

When you select a control, the control you have selected will be duplicated but
with a new ID value.

If you keep the left mouse button down while selecting the control you wish to
duplicate, the move frame around the duplicated control will be displayed
allowing you to move the duplicated control to the final position you wish to
place it.

Once you release the left mouse button, the appropriate dialogue for the type
of control you selected will be displayed allowing you to update the styles,
text and ID values of the control.

You can then select another control to duplicate or you can turn off the
control duplicate by selecting the Duplicate from the Edit pull-down.


ΓòÉΓòÉΓòÉ 18. Help for Dialogue Unit Limits Selection Dialogue ΓòÉΓòÉΓòÉ

The Dialogue Unit Limits Selection dialogue allows you to select display
conversions to use when you select the Display limits Tool Bar button.  Using
these conversions, Prominare Designer can display the rectangles that a given
device would translate to for the controls within the window or dialogue.  This
allows you to effectively check the controls within a window or dialogue for
errant display clipping without having to display the window or dialogue on a
display of a given type and resolution.

You may have noticed that if you have designed a dialogue using a device with a
1024 x 768 resolution, that when you have run the final application on a system
only having a 640 x 480 resolution, that some of the controls have been clipped
such that not all of the information for the control is displayed.

Prominare Designer uses these conversion factors to convert the dialogue units
of the control being displayed to the pixel count of such that the rectangle
would be shown relative to the current control.

To select an entry, you first select the entry within the Device drop down list
and then select the Set push button.

To ignore the values selected, click the mouse pointer on the Cancel push
button.


ΓòÉΓòÉΓòÉ 19. Help for Relative Mouse Position Dialogue ΓòÉΓòÉΓòÉ

The Relative Mouse Position dialogue is used to specify the relative position
of the lower left corner of the dialogue you are designing relative the
position of the mouse pointer when the dialogue is first displayed.

You enter the x and y offsets in the entry fields found within the dialogue.
These offsets are defined as being the distance the left corner should be
relative to the current mouse location.

For example, if you wanted the mouse pointer to be located in the dialogue at
postion 5, 5, then the lower left corner of the dialogue relative to this
position would be -5, -5 and you would enter -5 in the x offset entry field and
the same value within the y offset entry field.

The Set push button is used to accept the values entered within the entry
fields, whereas, the Cancel push button is used to reject the values entered.


ΓòÉΓòÉΓòÉ 20. Help for Relative Mouse Position ΓòÉΓòÉΓòÉ

The Relative Mouse Position dialogue is used to specify the relative position
of the lower left corner of the dialogue you are designing relative the
position of the mouse pointer when the dialogue is first displayed.

You enter the x and y offsets in the entry fields found within the dialogue.
These offsets are defined as being the distance the left corner should be
relative to the current mouse location.

For example, if you wanted the mouse pointer to be located in the dialogue at
postion 5, 5, then the lower left corner of the dialogue relative to this
position would be -5, -5 and you would enter -5 in the x offset entry field and
the same value within the y offset entry field.

The Set push button is used to accept the values entered within the entry
fields, whereas, the Cancel push button is used to reject the values entered.


ΓòÉΓòÉΓòÉ 21. Help for Show IDs ΓòÉΓòÉΓòÉ

The Show IDs Tool Bar button is used to toggle the display of the control IDs
within each of the controls.  When the button is down, the numeric ID values
for each of the controls will be displayed in red against a white background
centred within each control contained in the window or dialogue.

When the button is in the up position, the controls will be displayed in the
normal fashion.  In this case, the method of determining the control ID is to
click either button 1 or button 2 of the mouse and to view the control symbolic
ID within the status window at the bottom of the Prominare Designer window.


ΓòÉΓòÉΓòÉ 22. Help for Grid ΓòÉΓòÉΓòÉ

To change control alignment grid, double click the Grid Tool Bar button on the
Tool Bar.

To display the grid, click the button.

Note:  Small grid values will cause displaying of window or dialogue designs to
       be extremely slow and therefore should be used only as required.

 The default grid is 1 on the x axis and 1 on the y axis.  If you want the
 controls you create and move to be aligned on a different a specific increment
 in either the x or y direction, you can use the grid function to do this.

 The Grid dialogue allows you to change the control movement increments.

 You can enter the new x and y increments in the entry fields provided within
 the dialogue.

 The Set push button is used to accept the values entered within the entry
 fields, whereas, the Cancel push button is used to reject the values entered
 and to not change the grid increments.


ΓòÉΓòÉΓòÉ 23. Help for Scan Errors ΓòÉΓòÉΓòÉ

To check your design for errors either during the save process you need to
select the Scan errors Tool Bar button.  When the button is depressed, the
design will be scanned for duplicate IDs on at a level that would cause a
resource compiler error or prevent the .RES file created from being bound to
the executable or DLL. It will also scan the design for specified resource
files like icon and bitmap files to ensure that they exist and can be added to
the resource information.

Alternately, double clicking button 2 of the mouse on the Scan errors Tool Bar
button will cause the design to be immediately checked for errors.

If any errors are detected, the Design Errors dialogue will be displayed
listing errors detected.  Through the dialogue, you will be able to see each
error found within your design and be able to correct the errors.


ΓòÉΓòÉΓòÉ 24. Help for Template ΓòÉΓòÉΓòÉ

The  is used to display the templates of the common displays within the
Prominare Designer window when you are working on a high resolution type
monitor.  This button is only selectable when working on a screen that is in a
display mode higher than 640 x 480 (VGA).  It will show the relative sizes of a
VGA screen thereby allowing you to check you dialogue sizes against the
template size.


ΓòÉΓòÉΓòÉ 25. Help for Tools ΓòÉΓòÉΓòÉ

You can use the Tools window to quickly select controls that you wish to add to
a window or dialogue design.  By clicking the mouse pointer on the desired
image, Prominare Designer will change the mouse cursor from an arrow to a
representative shape with a cross hair to allow you to select the location
where the control is to be placed within the window or dialogue.

The tools window is faster than using the Control pull down menu and you can
use either.

The following explains what each of the representations within the window are:

      Push Button
      Creates a push button.

      Check Box
      Creates a check box.

      Radio Button
      Creates a radio button.

      Horz. Scroll
      Creates a horizontal scroll bar.

      Vert. Scroll
      Creates a vertical scroll bar.

      List Box
      Creates a list box.

      Entry Field
      Creates an entry field.

      Group Box
      Creates a group box.

      Text
      Creates text.

      Icon
      Creates a static icon.

      Bitmap
      Creates a static bitmap.

      Combo Box
      Creates a combo box.

      Multi-Line
      Creates a multi-line entry field.

      Spin button  (OS/2 1.3 and above)
      Creates a spin button.

      Container  (2.x and Warp only)
      Creates a container.

      Slider  (2.x and Warp only)
      Creates a slider.

      Value set (2.x and Warp only)
      Creates a value set.

      Notebook (2.x and Warp only)
      Creates a notebook.

      User defined
      Allows selection and creation of a user defined custom control.

      Circular slider (MMPM/2 only)
      Creates a circular slider.

      Graphic button (MMPM/2 only)
      Creates a graphic button.

      Handwriting control (Pen for OS/2 only)
      Creates a handwriting control.

      Sketch control (Pen for OS/2 only)
      Creates a sketch control.

      Action bar menu
      Creates an action bar menu.


ΓòÉΓòÉΓòÉ 26. Help for Save Window Position ΓòÉΓòÉΓòÉ

Select Save window position Tool Bar button to save the current position of the
Prominare Designer window so that the next time you use the program, the window
will be displayed in the current position.


ΓòÉΓòÉΓòÉ 27. Help for Group Move ΓòÉΓòÉΓòÉ

When you select a control by clicking the left mouse button while pressing the
Ctrl key at the same time, a frame will be displayed around along with a larger
outer frame.  This outer frame will expand and contract depending on the number
of controls selected and de-selected.  Selected controls will always have the
frame displayed around them.

Once you have selected all of the controls you wish to move as a group, you can
move the group by selecting a control within the group while pressing the Alt
key at the same.  Keeping the both the Alt key and the left mouse button
pressed, you can move the group to the location desired.

Once you release the left mouse button, the move frame will disappear along
with the group frame and the frames around the selected controls.


ΓòÉΓòÉΓòÉ 28. Help for Grid Dialogue ΓòÉΓòÉΓòÉ

The Grid dialogue allows you to change the control movement increments.

You can enter the new x and y increments in the entry fields provided within
the dialogue.

The Enter push button is used to accept the values entered within the entry
fields, whereas, the Cancel push button is used to reject the values entered
and to not change the grid increments.


ΓòÉΓòÉΓòÉ 29. Help for Bidirectional Support ΓòÉΓòÉΓòÉ

The bidirectional Support is used to change the bidirection characteristics of
controls within the dialogue or window you are currently designing.


ΓòÉΓòÉΓòÉ 30. Help for Pen Options ΓòÉΓòÉΓòÉ

The pen options allows you to set various pen options for controls that support
pen data.  These controls are:

      Entry field
      Multiple-line entry field
      Combo-box
      Spin button
      Handwriting control

 Note:  For the options to be available to you, you must be running Pen for
        OS/2 Version 1.03 or higher.

 You can set options for the following:

      Layouts/Resource
      Options
      Layouts/Resource
      Symbol Sets
      Include/Exclude Regions


ΓòÉΓòÉΓòÉ 31. Help for Generate Code ΓòÉΓòÉΓòÉ

When you select the Generate Code tool bar button on the Tool Bar the source
code for the application you are designing will be generated.  This will only
be possible when you allow the source code to be generated.

The design file and the resource files (either script or binary) will not be
saved.

This is a quick way of updating the source code.


ΓòÉΓòÉΓòÉ 32. Help for Save Source Code ΓòÉΓòÉΓòÉ

To cause source code to be generated for the current design, select the Save
Soruce Code tool bar button.  When you save the design, the source code will be
generated for any new elements you have added or changed.

When the tool bar button is in the down position, the source code will be
saved.  If the tool bar button is in the up position, no source code will be
saved and you cannot generate source code even through the Generate Code tool
bar button.


ΓòÉΓòÉΓòÉ 33. Help for View Source ΓòÉΓòÉΓòÉ

To view the source for the current window or dialogue, select the View Source
tool bar button.  This will cause the source for the window or dialogue to be
displayed within the View Source dialogue located at the window or dialogue
procedure.


ΓòÉΓòÉΓòÉ 34. View Source ΓòÉΓòÉΓòÉ

The View Source dialogue allows you to view and edit the source code for the
window or dialogue displayed.


ΓòÉΓòÉΓòÉ <hidden> Help for File pull-down ΓòÉΓòÉΓòÉ

The File pull-down contains commands that let you open and save files.

Press the Enter key to access the items on the File pull-down.

The menu items contained within the File pull-down are:

      New design
      Creates new design and header files.

      Open
      Opens a design file.

      Import
      Imports an existing .RES file, .RC (both OS/2 and Microsoft Windows) file
      or extracts the resources from a .DLL or .EXE file.

      Merge
      Merges an existing design file with the current design.

      Include new
      Creates a new header file.

      Include open
      Opens a header file.

      Save
      Saves the current design under current name.

      Save as
      Saves current design under a new name.

      Quick save

      Saves current design file without saving resource or .IPF files.

      Refresh .RES
      Refreshes resource files (.RES) for revised bitmap, icon, pointer and
      other external resource information.

      Include save
      Saves header file under current name.

      Include save as
      Saves header file under new name.

      Print
      Allows following printing actions:
           All
           Allows the printing of all of the windows and dialogues contained
           within the design as a group.
           Displayed
           Allows the printing of the currently displayed window or dialogue.

      Print setup
      Allows the selection and setup of a print output device.

      Save design
      Saves the current window or dialogue displayed to allow it to be recalled
      as a pre-designed window or dialogue.

      Delete design
      Deletes a pre-designed window or dialogue.

      Include view/edit
      Permits viewing and editing of header information.

      Information
      Allows the viewing of information on the current window or dialogue.


ΓòÉΓòÉΓòÉ 35. Help for Advanced New Design ΓòÉΓòÉΓòÉ

Select New design on the File pull-down to create a new design file along with
a new header file and set up the base information required for the design.

When you select New design, the New Design dialogue appears. Use it to define
the new design that you are creating.


ΓòÉΓòÉΓòÉ 36. Help for Open ΓòÉΓòÉΓòÉ

Select Open on the File pull-down to edit an existing design file.

When you select Open, the Open dialogue appears. Use it to select the design
file you want to edit.


ΓòÉΓòÉΓòÉ 37. Help for Import ΓòÉΓòÉΓòÉ

Select Import on the File pull-down to import an existing .RES file, .RC file
(both OS/2 and Microsoft Windows) or the resources from a .DLL or .EXE file.

When you select Import, the Import dialogue appears.  Use it to select the OS/2
or Windows file you want to import.


ΓòÉΓòÉΓòÉ 38. Help for Merge ΓòÉΓòÉΓòÉ

Select Merge on the File pull-down to merge an existing .RES file with the
current design.

When you select Merge, the File Merge dialogue appears.  Use it to select the
design file you want to merge with the current design.


ΓòÉΓòÉΓòÉ 39. Help for Include New ΓòÉΓòÉΓòÉ

Select Include new on the File pull-down to create a new header file.


ΓòÉΓòÉΓòÉ 40. Help for Include Open ΓòÉΓòÉΓòÉ

Select Include open on the File pull-down to open an existing header file.

When you select Include Open, the Include Open dialogue appears.  Use it to
select the file you want to use as the header file.


ΓòÉΓòÉΓòÉ 41. Help for Save ΓòÉΓòÉΓòÉ

Select Save on the File pull-down to save the file you are editing.

Note:  Use Save As to save an untitled file.


ΓòÉΓòÉΓòÉ 42. Help for Save As ΓòÉΓòÉΓòÉ

Select Save as on the File pull-down to:

     Save a new file

     Save a file:

        -  With a different name

        -  In a different directory

        -  On a different disk

 When you choose this command, the Save As dialogue appears.  Use it to enter
 the drive, path and file name for the file.  You can also enter any historical
 information or comments relating to the design being worked on.


ΓòÉΓòÉΓòÉ 43. Help for Quick Save ΓòÉΓòÉΓòÉ

Select Quick save on the File pull-down to save the design you are currently
working on.

This will only save the design file and will not save the resource script file
or .RES file.

You should use this every now and again when you want to make sure that you
have safely saved the design file.


ΓòÉΓòÉΓòÉ 44. Help for Refresh .RES ΓòÉΓòÉΓòÉ

Select Refresh .RES on the File pull-down to update and refresh the .RES files
for the current design when the external resources like bitmaps, icons and
pointers have been changed.

Only the resource files defined will be updated and the .PDF file along with
any associated sources will not be updated.


ΓòÉΓòÉΓòÉ 45. Help for Include Save ΓòÉΓòÉΓòÉ

Select Include save on the File pull-down to save the include file you are
editing.

Note:  Use Include Save As to save an untitled include file.


ΓòÉΓòÉΓòÉ 46. Help for Include Save As ΓòÉΓòÉΓòÉ

Select Include save as on the File pull-down to:

     Save a new file

     Save a file:

        -  With a different name

        -  In a different directory

        -  On a different disk

 When you choose this command, the Include Save As dialogue appears.  Use it to
 enter the drive, path and file name for the file.


ΓòÉΓòÉΓòÉ 47. Help for Print ΓòÉΓòÉΓòÉ

To print the currently displayed window or dialogue, or, to print all of the
windows and dialogues, select Print from the File pull-down.

A sub-menu will be displayed from which you can select the type of printing
that you wish to perform.  Items that can be selected are:

     All.
     Displayed.


ΓòÉΓòÉΓòÉ 48. Help for Print All ΓòÉΓòÉΓòÉ

Select Print all on the File Print pull-down to print the all windows or
dialogues that are within the design you are working on.

The Print Design dialogue will be displayed allowing you to select the general
placement of the image on the page and to specify a scaling value that is used
to scale the final image.


ΓòÉΓòÉΓòÉ 49. Help for Print Displayed ΓòÉΓòÉΓòÉ

Select Print displayed on the File Print pull-down to print the currently
displayed window or dialogue that you are working on.

The Print Design dialogue will be displayed allowing you to select the general
placement of the image on the page and to specify a scaling value that is used
to scale the final image.


ΓòÉΓòÉΓòÉ 50. Help for Printer Setup ΓòÉΓòÉΓòÉ

The Printer setup function is used to select or setup the printer for which a
window or dialogue design is to be printed on.


ΓòÉΓòÉΓòÉ 51. Help for Save Design ΓòÉΓòÉΓòÉ

Select Save design on the File pull-down to save the current window or dialogue
as a pre-designed entity that can be recalled using the Pre-designed item in
the New Dialogue/Window dialogue.

Up to 256 windows or dialogues can be saved to disk as a pre-designed entity.
When you select the Pre-designed menu item in the Edit New pull-down menu, you
will be allowed to select a pre-designed window or dialogue to use instead of
creating the window or dialogue from scratch.

You will be presented with a dialogue asking for the name in which the design
should be saved under in the design library.  You can set the design library
path using Pre-design library entry field in the Options tab of the Prominare
Designer Configuration dialogue.


ΓòÉΓòÉΓòÉ 52. Help for Delete Design ΓòÉΓòÉΓòÉ

Select Delete design on the File pull-down to delete a pre-designed window or
dialogue.

Up to 256 windows or dialogues can be saved to disk as a pre-designed entity.
When you select the Pre-designed menu item in the Edit New pull-down menu, you
will be allowed to select a pre-designed window or dialogue to use instead of
creating the window or dialogue from scratch.

You will be presented with a dialogue showing the window or dialogues that have
been created allowing you to select the design you wish to delete.


ΓòÉΓòÉΓòÉ 53. Help for Include View ΓòÉΓòÉΓòÉ

To view or edit include symbols and values, select the Include View on on the
File pull-down.

The Include View/Edit dialogue will be displayed listing all of the symbols and
corresponding values.  From this list, you can select the symbol and ID to
edit.


ΓòÉΓòÉΓòÉ 54. Help for Information ΓòÉΓòÉΓòÉ

The Information menu item on the File menu allows you to view information for
the current window or dialogue that you are working on.  The Prominare Designer
Information dialogue will display such things are the number of controls,
accelerators, action bar and sub-menu items, and help table totals.  It will
also show the resource distribution.


ΓòÉΓòÉΓòÉ 55. Help for Design Definitions ΓòÉΓòÉΓòÉ

The Basenames, OS/2 2.x, OS/2 1.x and Other tabs are used to enter the basename
for the design and the include header filename. as well as the location for the
final resource files and the .IPF filename.


ΓòÉΓòÉΓòÉ <hidden> Help for Edit pull-down ΓòÉΓòÉΓòÉ

The Edit pull-down contains commands that help you copy, delete, and change a
window or dialogues menus and controls.

Press the Enter key to access the items on the Edit pull-down.

The menu items contained within the Edit pull-down are:

      Undo
      Undos the last operation performed on a control or set of controls.

      Redo
      Redos on a control or set of controls the last undo.

      Cut
      Copies and deletes current window, dialogue or selected controls to
      clipboard.

      Copy
      Copies current window, dialogue or selected controls to clipboard.

      Paste
      Pastes a window, dialogue or controls into current design.

      Paste from file
      Allows the selection of another design file from which multiple
      dialogues, windows, resources, strings and association table items can be
      selected and pasted into the current design.

      Delete
      Allows deletion of:
          Window or Dialogue
          Control
          Action Bar Menu
          Sub-Menu Item
          Accelerator
          Association table item
          Bitmap
          Character table items
          Font
          Font directory
          Help
             -  Table
             -  Table Item
             -  Sub-Table
             -  Sub-Table Item
          Icon
          Key table items
          Message
          Pointer
          Resource
          String
          Key table items
      New
      Allow creation of a new window or dialogue, popup menu, tab, Workplace
      settings page or the selection of a predesigned library window or
      dialogue.
      Pop-up menu
      Styles
      Allows editing of the styles for the selected window, dialogue or
      control.
      Properties
      Allows the loading and memory properties to be set for:
          Accelerator Table
          Dialogue
          Message Table
          String Table


ΓòÉΓòÉΓòÉ 56. Help for Undo ΓòÉΓòÉΓòÉ

Select Undo on the Edit pull-down, or press Alt+Backspace to undo the last
operation performed on a control or set of controls.


ΓòÉΓòÉΓòÉ 57. Help for Redo ΓòÉΓòÉΓòÉ

Select Redo on the Edit pull-down, or press Shift+Alt+Backspace to redo the
last undo operation performed on a control or set of controls.


ΓòÉΓòÉΓòÉ 58. Help for Copy ΓòÉΓòÉΓòÉ

Select Copy on the Edit pull-down, or press Ctrl+Insert to copy selected window
or dialogue or controls to the Clipboard.

You can insert the window or dialogue you copy back into the design or in
another design using Paste.


ΓòÉΓòÉΓòÉ 59. Help for Paste ΓòÉΓòÉΓòÉ

Select Paste on the Edit pull-down, or press Shift+Insert to insert the window
or dialogue on the Clipboard into the design.

If window or dialogue is being pasted from the Clipboard it will replace the
current window or dialogue unless you specifically tell Prominare Designer not
to.

Note:  Use Cut or Copy to put a window or dialogue on the Clipboard.


ΓòÉΓòÉΓòÉ 60. Help for Paste from File ΓòÉΓòÉΓòÉ

Select Paste from file on the Edit pull-down, or press Alt+Insert to be able to
select another design file from which you can paste multiple selections of
dialogues, windows, bitmaps, icons, pointers, strings, message or association
table items into the current design that you are working on.

When you select the item, you will first be asked to select the design file
from which you wish to paste items from.  Once the information from this design
file has been read into memory, you will then be presented with the Paste From
File dialogue in which contains four tabs, Dialogues/Windows, Resources,
Strings/Mesages and Association Tables, which will list the available items
within each area.

You can then select items from each tab that will be pasted into the current
design.


ΓòÉΓòÉΓòÉ 61. Help for Cut ΓòÉΓòÉΓòÉ

Select Cut on the Edit pull-down, or press Shift+Delete to delete a window or
dialogue or controls from the file and copy it to the Clipboard.

You can insert the window or dialogue you cut somewhere else in this file or in
another file using Paste.


ΓòÉΓòÉΓòÉ 62. Help for Delete ΓòÉΓòÉΓòÉ

To delete a window, dialogue, control or resource, select Delete from the Edit
pull-down.

A sub-menu will be displayed in which items that you cannot delete will be
shown in a half-tone.  Items that can be selected are:

     Window or Dialogue
     Control
     Action Bar Menu
     Sub-Menu Item
     Accelerator
     Association table item
     Bitmap
     Character table items
     Font
     Font directory
     Help
        -  Table
        -  Table Item
        -  Sub-Table
        -  Sub-Table Item
     Icon
     Key table items
     Message
     Pointer
     Resource
     String
     Key table items


ΓòÉΓòÉΓòÉ 63. Help for Delete Window ΓòÉΓòÉΓòÉ

To delete a window or dialogue, select Delete Window or Delete Dialogue from
the Edit pull-down.

A message box will be displayed confirming your request to delete the displayed
window or dialogue.


ΓòÉΓòÉΓòÉ 64. Help for Delete Control ΓòÉΓòÉΓòÉ

To delete a control or controls within the current window or dialogue, select
the Delete Control from the Edit pull-down.

A dialogue will be displayed listing all of the controls contained within the
window or dialogue.  You can then select the control or controls to delete.


ΓòÉΓòÉΓòÉ 65. Help for Delete Menu ΓòÉΓòÉΓòÉ

To delete an action bar item or items within the current window, select the
Delete Action Bar Menu from the Edit pull-down.

A dialogue will be displayed listing all of the action bar menus contained
within the window.  You can then select the action bar menu or menus to delete.


ΓòÉΓòÉΓòÉ 66. Help for Delete Menu Item ΓòÉΓòÉΓòÉ

To delete a sub-menu item or items within the current window, select the Delete
Sub-Menu Item from the Edit pull-down.

A dialogue will be displayed listing all of the sub-menu items contained within
the window.  You can then select the sub-menu item or items to delete.


ΓòÉΓòÉΓòÉ 67. Help for Delete Accelerator ΓòÉΓòÉΓòÉ

To delete an accelerator item or items within the current window, select the
Delete Accelerator from the Edit pull-down.

A dialogue will be displayed listing all of the accelerator items contained
within the window.  You can then select the accelerator item or items to
delete.


ΓòÉΓòÉΓòÉ 68. Help for Delete Association Table Item ΓòÉΓòÉΓòÉ

To delete an association table item or items, select the Delete Association
item from the Edit pull-down.

A dialogue will be displayed listing all of the association table items. You
can then select the association table item or items to delete.


ΓòÉΓòÉΓòÉ 69. Help for Delete Bitmap ΓòÉΓòÉΓòÉ

To delete a bitmap item or items within the current window or dialogue, select
the Delete Bitmap from the Edit pull-down.

A dialogue will be displayed listing all of the bitmap items contained within
the window or dialogue.  You can then select the bitmap item or items to
delete.


ΓòÉΓòÉΓòÉ 70. Help for Delete Character Table Item ΓòÉΓòÉΓòÉ

To delete an character table item or items, select the Delete Character table
from the Edit pull-down.

A dialogue will be displayed listing all of the character table items. You can
then select the character table item or items to delete.


ΓòÉΓòÉΓòÉ 71. Help for Delete Font ΓòÉΓòÉΓòÉ

To delete a font item or items, select the Delete Font from the Edit pull-down.

A dialogue will be displayed listing all of the font items contained within the
window or dialogue.  You can then select the font item or items to delete.


ΓòÉΓòÉΓòÉ 72. Help for Delete Font Direcotry ΓòÉΓòÉΓòÉ

To delete a font directory, select the Delete Font directory from the Edit
pull-down.

A dialogue will be displayed listing all of the font directories. You can then
select the font directory or directories to delete.


ΓòÉΓòÉΓòÉ 73. Help for Delete Help ΓòÉΓòÉΓòÉ

To delete a help item within the current window or dialogue, select the Delete
Help from the Edit pull-down.

A sub-menu will be displayed with entries for Tables, Table Items, Sub-Tables
and Sub-Table Items.  From one of these sub-menu items, you can delete the
desired help item or items.


ΓòÉΓòÉΓòÉ 74. Help for Delete Help Table ΓòÉΓòÉΓòÉ

To delete a help table or tables within the current window or dialogue, select
the Delete Help Table from the Edit pull-down.

A dialogue will be displayed listing all of the help tables contained within
the window or dialogue.  You can then select the table item or items to delete.


ΓòÉΓòÉΓòÉ 75. Help for Delete Help Table Item ΓòÉΓòÉΓòÉ

To delete a help table item or items within the current window or dialogue,
select the Delete Help Table Item from the Edit pull-down.

A dialogue will be displayed listing all of the help table items contained
within the window or dialogue.  You can then select the table item or items to
delete.


ΓòÉΓòÉΓòÉ 76. Help for Delete Help Sub-Table ΓòÉΓòÉΓòÉ

To delete a help sub-table or sub-tables within the current window or dialogue,
select the Delete Help Sub-Table from the Edit pull-down.

A dialogue will be displayed listing all of the help sub-tables contained
within the window or dialogue.  You can then select the sub-table item or items
to delete.


ΓòÉΓòÉΓòÉ 77. Help for Delete Help Sub-Table Item ΓòÉΓòÉΓòÉ

To delete a help sub-table item or items within the current window or dialogue,
select the Delete Help Sub-Table Item from the Edit pull-down.

A dialogue will be displayed listing all of the help sub-table items contained
within the window or dialogue.  You can then select the sub-table item or items
to delete.


ΓòÉΓòÉΓòÉ 78. Help for Delete Icon ΓòÉΓòÉΓòÉ

To delete an icon or icons, select the Delete Icon from the Edit pull-down.

A dialogue will be displayed listing all of the icons contained within the
window or dialogue.  You can then select the icon or icons to delete.


ΓòÉΓòÉΓòÉ 79. Help for Delete Key Table ΓòÉΓòÉΓòÉ

To delete a key table, select the Delete Key table from the Edit pull-down.

A dialogue will be displayed listing all of the key tables. You can then select
the key table or tables to delete.


ΓòÉΓòÉΓòÉ 80. Help for Delete Message ΓòÉΓòÉΓòÉ

To delete a message or messages, select the Delete Message from the Edit
pull-down.

A dialogue will be displayed listing all of the messages contained within the
window or dialogue.  You can then select the message or messages to delete.


ΓòÉΓòÉΓòÉ 81. Help for Delete Pointer ΓòÉΓòÉΓòÉ

To delete a pointer or pointers, select the Delete Pointer from the Edit
pull-down.

A dialogue will be displayed listing all of the pointers contained within the
window or dialogue.  You can then select the pointer or pointers to delete.


ΓòÉΓòÉΓòÉ 82. Help for Delete Resource ΓòÉΓòÉΓòÉ

To delete a custom resource or resources, select the Delete Resource from the
Edit pull-down.

A dialogue will be displayed listing all of the custom resources contained
within the window or dialogue.  You can then select the resource or resources
to delete.


ΓòÉΓòÉΓòÉ 83. Help for Delete String ΓòÉΓòÉΓòÉ

To delete a string or strings, select the Delete String from the Edit
pull-down.

A dialogue will be displayed listing all of the strings contained within the
window or dialogue.  You can then select the string or strings to delete.


ΓòÉΓòÉΓòÉ 84. Help for Delete Virtual Key Table ΓòÉΓòÉΓòÉ

To delete a virtual key table, select the Delete Virtual key table from the
Edit pull-down.

A dialogue will be displayed listing all of the virtual key tables. You can
then select the virtual key table or tables to delete.


ΓòÉΓòÉΓòÉ 85. Help for New ΓòÉΓòÉΓòÉ

To create a new window/dialogue, popup menu, tab, Workplace Settings page or
select a window or dialogue from the predesigned library, select the New from
the Edit pull-down.

The  New Dialogue/Window dialogue will be displayed thereby allowing you to
select from predefined dialogue templates or select another type of window,
tab, Workplace Settings page to create.


ΓòÉΓòÉΓòÉ 86. Help for Pre-designed Window/Dialogue ΓòÉΓòÉΓòÉ

The Pre-designed Window/Dialogue dialogue is used to allow you to select the
pre-designed window or dialogue to use for the new window or dialogue that you
are creating.


ΓòÉΓòÉΓòÉ 87. Help for Pre-designed Window/Dialogue ΓòÉΓòÉΓòÉ

The Pre-designed Window/Dialogue dialogue is used to allow you to select the
pre-designed window or dialogue to use for the new window or dialogue that you
are creating.


ΓòÉΓòÉΓòÉ 88. Help for Edit Popup Menu ΓòÉΓòÉΓòÉ

To edit an popup, select the Menu Popup menu on the Edit pull-down.

A Pop-up Menu dialogue will be displayed which will allow you to change the ID
symbol and value for the popup menu.


ΓòÉΓòÉΓòÉ 89. Help for Edit Styles ΓòÉΓòÉΓòÉ

To edit the styles of a window, dialogue or control, select the Styles menu
item on the Edit menu.

This will allow you to change the text within the window, dialogue or control
along with the style.


ΓòÉΓòÉΓòÉ 90. Help for Properties ΓòÉΓòÉΓòÉ

To set the resource properties for a given resource type, select the Properties
from the Edit pull-down.

A sub-menu will be displayed allowing you to set the properties for the
following:

     Accelerator Table
     Dialogue
     Menu
     Message Table
     String Table


ΓòÉΓòÉΓòÉ 91. Help for Accelerator Properties ΓòÉΓòÉΓòÉ

Select Properties Accelerator from the Edit pull-down to edit the loading and
storage properties for the accelerators defined within window.


ΓòÉΓòÉΓòÉ 92. Help for Dialogue Properties ΓòÉΓòÉΓòÉ

Select Properties dialogue from the Edit pull-down to edit the loading and
storage properties for the dialogue displayed.


ΓòÉΓòÉΓòÉ 93. Help for Menu Properties ΓòÉΓòÉΓòÉ

Select Properties Menu from the Edit pull-down to edit the loading and storage
properties for the menus defined.


ΓòÉΓòÉΓòÉ 94. Help for Message Properties ΓòÉΓòÉΓòÉ

Select Properties Messages from the Edit pull-down to edit the loading and
storage properties for the messages defined within window or dialogue.


ΓòÉΓòÉΓòÉ 95. Help for String Properties ΓòÉΓòÉΓòÉ

Select Properties String from the Edit pull-down to edit the loading and
storage properties for the strings defined within window or dialogue.


ΓòÉΓòÉΓòÉ 96. Help for Find Pull-down ΓòÉΓòÉΓòÉ

The Find pull-down contains items you can use to search the current design for
text or a symbol/ID.

Press the Enter key to access the items on the Find pull-down.

The menu items contained within the Find pull-down are:

      Search
      Allows the searchig of a text string or symbol/ID.

      Search next
      Searchs for the next occurance of entered text string or symbol/ID.


ΓòÉΓòÉΓòÉ 97. Help for Search ΓòÉΓòÉΓòÉ

Select Search from the Find pull-down to search for an ID value or text item.
The Search dialogue will allow you to enter a text string to search for or an
ID symbol to locate.


ΓòÉΓòÉΓòÉ 98. Help for Search Next ΓòÉΓòÉΓòÉ

Select Search next from the Find pull-down to search for the next occurance an
ID value or text item.  The search will start from the next dialogue after the
current dialogue being displayed.


ΓòÉΓòÉΓòÉ 99. Help for Control Pull-down ΓòÉΓòÉΓòÉ

The Control pull-down contains items you can use to create different types of
controls within the window or dialogue you are designing.

Press the Enter key to access the items on the Control pull-down.

The menu items contained within the Control pull-down are:

      Bitmap
      Creates a static bitmap.

      Check Box
      Creates a check box.

      Circular slider (MMPM/2 only)
      Creates a circular slider.

      Combo Box
      Creates a combo box.

      Container
      Creates a container (2.0, Warp or above).

      Entry Field
      Creates an entry field.

      Frame
      Creates a frame.

      Graphic button (MMPM/2 only)
      Creates a graphic button.

      Group Box
      Creates a group box.

      Handwriting control (Pen for OS/2 only)
      Creates a handwriting control.

      Horz. Scroll
      Creates a horizontal scroll bar.

      Icon
      Creates a static icon.

      List Box
      Creates a list box.

      Menu
      Creates or edits an action bar or sub-menu item.

      Multi-Line
      Creates a multi-line entry field.

      Notebook
      Creates a notebook (2.0, Warp or above).

      Push Button
      Creates a push button.

      Radio Button
      Creates a radio button.

      Rectangle
      Creates a rectangle.

      Sketch control (Pen for OS/2 only)
      Creates a sketch control.

      Spin button
      Creates a spin button (1.3, 2.0, Warp or above).

      System Icon
      Creates a system icon.

      Text
      Creates text.

      User define
      Creates a user defined control.

      Vert. Scroll
      Creates a vertical scroll bar.

      Slider
      Creates a slider (2.0, Warp or above).

      Value Set
      Creates a value set (2.0, Warp or above).

      Window
      Creates a child window.


ΓòÉΓòÉΓòÉ 100. Help for Push Buttons ΓòÉΓòÉΓòÉ

Select Push Button on the Control pull-down menu to add a push button to the
dialogue or window currently being designed.

The arrow pointer will be changed to a placement pointer after selecting Push
Button on the Control pull-down menu.  In the status area at the bottom of the
Prominare Designer window, the [x,y] will show the current position of the
placement pointer in relation to the lower left corner of the dialogue.

By moving the placement pointer to the location you want to place the push
button, clicking button 1 of the mouse will cause the push button to be created
and the Button Styles dialogue for button styles to be displayed to allow you
to edit the text, ID symbol and value of the button.

Note:  When you select the location for the push button by clicking button 1 of
       the mouse, the lower left corner of the push button occupy this position
       and the push button will be created upwards and to the right of this
       position.


ΓòÉΓòÉΓòÉ 101. Help for Buttons ΓòÉΓòÉΓòÉ

To define the characteristics of interactive buttons within a dialogue or
window, the Button Styles dialogue can be used.

The dialogue is displayed when you select a button in the dialogue you are
designing or editing and you select the Edit Styles menu item or when you
select a button control type from the Control menu.


ΓòÉΓòÉΓòÉ 102. Help for Scroll Bars ΓòÉΓòÉΓòÉ

To define the characteristics of scroll bar within a dialogue or window, the
Scroll Styles dialogue can be used.

The dialogue is displayed when you select a scroll bar in the dialogue you are
designing or editing and you select the Edit Styles menu item or when you
select the Horz. Scroll or Vert. Scroll menu items from the Control menu.


ΓòÉΓòÉΓòÉ 103. Help for Statics ΓòÉΓòÉΓòÉ

To define the characteristics of a static control such as text, group boxes,
icons, etc. within a dialogue or window, the Static Styles dialogue can be
used.

The dialogue is displayed when you select a static control in the dialogue you
are designing or editing and you select the Edit Styles menu item or when you
select the Group Box, Text, Frame, Rectangle, Icon, or Bitmap menu items from
the Control menu.


ΓòÉΓòÉΓòÉ 104. Help for Check Boxes ΓòÉΓòÉΓòÉ

Select Check Box on the Control pull-down menu to add a check box to the
dialogue or window currently being designed.

The arrow pointer will be changed to a placement pointer after selecting Check
Box on the Control pull-down menu.  In the status area at the bottom of the
Prominare Designer window, the [x,y] will show the current position of the
placement pointer in relation to the lower left corner of the dialogue.

By moving the placement pointer to the location you want to place the check
box, clicking button 1 of the mouse will cause the check box to be created and
the Button Styles dialogue for button styles to be displayed to allow you to
edit the text, ID symbol and value of the button.

Note:  When you select the location for the check box by clicking button 1 of
       the mouse, the lower left corner of the check box occupy this position
       and the check box will be created upwards and to the right of this
       position.


ΓòÉΓòÉΓòÉ 105. Help for Radio Buttons ΓòÉΓòÉΓòÉ

Select Radio Button on the Control pull-down menu to add a radio button to the
dialogue or window currently being designed.

The arrow pointer will be changed to a placement pointer after selecting Radio
Button on the Control pull-down menu.  In the status area at the bottom of the
Prominare Designer window, the [x,y] will show the current position of the
placement pointer in relation to the lower left corner of the dialogue.

By moving the placement pointer to the location you want to place the radio
button, clicking button 1 of the mouse will cause the radio button to be
created and the Button Styles dialogue for button styles to be displayed to
allow you to edit the text, ID symbol and value of the button.

Note:  When you select the location for the radio button by clicking button 1
       of the mouse, the lower left corner of the radio button occupy this
       position and the radio button will be created upwards and to the right
       of this position.


ΓòÉΓòÉΓòÉ 106. Help for Horizontal Scroll Bars ΓòÉΓòÉΓòÉ

Select Horz. Scroll on the Control pull-down menu to add a horizontal scroll
bar to the dialogue or window currently being designed.

The arrow pointer will be changed to a placement pointer after selecting Horz.
Scroll on the Control pull-down menu.  In the status area at the bottom of the
Prominare Designer window, the [x,y] will show the current position of the
placement pointer in relation to the lower left corner of the dialogue.

By moving the placement pointer to the location you want to place the
horizontal scroll bar, clicking button 1 of the mouse will cause the horizontal
scroll bar to be created and the Scroll Styles dialogue for scroll bar styles
to be displayed to allow you to edit the ID symbol and value of the scroll bar.

Note:  When you select the location for the scroll bar by clicking button 1 of
       the mouse, the lower left corner of the scroll bar occupy this position
       and the scroll bar will be created upwards and to the right of this
       position.


ΓòÉΓòÉΓòÉ 107. Help for Vertical Scroll Bars ΓòÉΓòÉΓòÉ

Select Vert. Scroll on the Control pull-down menu to add a vertical scroll bar
to the dialogue or window currently being designed.

The arrow pointer will be changed to a placement pointer after selecting Vert.
Scroll on the Control pull-down menu.  In the status area at the bottom of the
Prominare Designer window, the [x,y] will show the current position of the
placement pointer in relation to the lower left corner of the dialogue.

By moving the placement pointer to the location you want to place the vertical
scroll bar, clicking button 1 of the mouse will cause the vertical scroll bar
to be created and the Scroll Styles dialogue for scroll bar styles to be
displayed to allow you to edit the ID symbol and value of the scroll bar.

Note:  When you select the location for the scroll bar by clicking button 1 of
       the mouse, the lower left corner of the scroll bar occupy this position
       and the scroll bar will be created upwards and to the right of this
       position.


ΓòÉΓòÉΓòÉ 108. Help for List Boxes ΓòÉΓòÉΓòÉ

Select List Box on the Control pull-down menu to add a list box to the dialogue
or window currently being designed.

The arrow pointer will be changed to a placement pointer after selecting List
Box on the Control pull-down menu.  In the status area at the bottom of the
Prominare Designer window, the [x,y] will show the current position of the
placement pointer in relation to the lower left corner of the dialogue.

By moving the placement pointer to the location you want to place the list box,
clicking button 1 of the mouse will cause the list box to be created and the
List Box Styles dialogue for list box styles to be displayed to allow you to
edit the text, ID symbol and value of the list box.

Note:  When you select the location for the list box by clicking button 1 of
       the mouse, the lower left corner of the list box occupy this position
       and the list box will be created upwards and to the right of this
       position.


ΓòÉΓòÉΓòÉ 109. Help for Entry Fields ΓòÉΓòÉΓòÉ

Select Entry Field on the Control pull-down menu to add an entry field to the
dialogue or window currently being designed.

The arrow pointer will be changed to a placement pointer after selecting Entry
Field on the Control pull-down menu.  In the status area at the bottom of the
Prominare Designer window, the [x,y] will show the current position of the
placement pointer in relation to the lower left corner of the dialogue.

By moving the placement pointer to the location you want to place the entry
field, clicking button 1 of the mouse will cause the entry field to be created
and the Entry Field Styles dialogue for entry field styles to be displayed to
allow you to edit the ID symbol and value of the entry field.

Note:  When you select the location for the entry field by clicking button 1 of
       the mouse, the lower left corner of the entry field occupy this position
       and the entry field will be created upwards and to the right of this
       position.


ΓòÉΓòÉΓòÉ 110. Help for Group Boxes ΓòÉΓòÉΓòÉ

Select Group Box on the Control pull-down menu to add a group box to the
dialogue or window currently being designed.

The arrow pointer will be changed to a placement pointer after selecting Group
Box on the Control pull-down menu.  In the status area at the bottom of the
Prominare Designer window, the [x,y] will show the current position of the
placement pointer in relation to the lower left corner of the dialogue.

By moving the placement pointer to the location you want to place the group
box, clicking button 1 of the mouse will cause the group box to be created and
the Static Styles dialogue for static styles to be displayed to allow you to
edit the text, ID symbol and value of the group box.

Note:  When you select the location for the group box by clicking button 1 of
       the mouse, the lower left corner of the group box occupy this position
       and the group box will be created upwards and to the right of this
       position.


ΓòÉΓòÉΓòÉ 111. Help for Text ΓòÉΓòÉΓòÉ

Select Text on the Control pull-down menu to add static text to the dialogue or
window currently being designed.

The arrow pointer will be changed to a placement pointer after selecting Text
on the Control pull-down menu.  In the status area at the bottom of the
Prominare Designer window, the [x,y] will show the current position of the
placement pointer in relation to the lower left corner of the dialogue.

By moving the placement pointer to the location you want to place the static
text, clicking button 1 of the mouse will cause the static text to be created
and the Statics Styles dialogue for static styles to be displayed to allow you
to edit the text, ID symbol and value of the static text.

Note:  When you select the location for the static text by clicking button 1 of
       the mouse, the lower left corner of the static text occupy this position
       and the static text will be created upwards and to the right of this
       position.


ΓòÉΓòÉΓòÉ 112. Help for Frames ΓòÉΓòÉΓòÉ

Select Frame on the Control pull-down menu to add a frame to the dialogue or
window currently being designed.

The arrow pointer will be changed to a placement pointer after selecting Frame
on the Control pull-down menu.  In the status area at the bottom of the
Prominare Designer window, the [x,y] will show the current position of the
placement pointer in relation to the lower left corner of the dialogue.

By moving the placement pointer to the location you want to place the frame,
clicking button 1 of the mouse will cause the frame to be created and the
Statics Styles dialogue for static styles to be displayed to allow you to edit
the text, ID symbol and value of the frame.

Note:  When you select the location for the frame by clicking button 1 of the
       mouse, the lower left corner of the frame occupy this position and the
       frame will be created upwards and to the right of this position.


ΓòÉΓòÉΓòÉ 113. Help for Rectangles ΓòÉΓòÉΓòÉ

Select Rectangle on the Control pull-down menu to add a rectangle to the
dialogue or window currently being designed.

The arrow pointer will be changed to a placement pointer after selecting
Rectangle on the Control pull-down menu.  In the status area at the bottom of
the Prominare Designer window, the [x,y] will show the current position of the
placement pointer in relation to the lower left corner of the dialogue.

By moving the placement pointer to the location you want to place the
rectangle, clicking button 1 of the mouse will cause the rectangle to be
created and the Statics Styles dialogue for static styles to be displayed to
allow you to edit the text, ID symbol and value of the rectangle.

Note:  When you select the location for the rectangle by clicking button 1 of
       the mouse, the lower left corner of the rectangle occupy this position
       and the rectangle will be created upwards and to the right of this
       position.


ΓòÉΓòÉΓòÉ 114. Help for Icons ΓòÉΓòÉΓòÉ

Select Icon on the Control pull-down menu to add an icon to the dialogue or
window currently being designed.

The arrow pointer will be changed to a placement pointer after selecting Icon
on the Control pull-down menu.  In the status area at the bottom of the
Prominare Designer window, the [x,y] will show the current position of the
placement pointer in relation to the lower left corner of the dialogue.

By moving the placement pointer to the location you want to place the icon,
clicking button 1 of the mouse will cause the icon to be created and the
Statics Styles dialogue for static styles to be displayed to allow you to edit
the text, ID symbol and value of the icon.

Note:  When you select the location for the icon by clicking button 1 of the
       mouse, the lower left corner of the icon occupy this position and the
       icon will be created upwards and to the right of this position.


ΓòÉΓòÉΓòÉ 115. Help for Bitmaps ΓòÉΓòÉΓòÉ

Select Bitmap on the Control pull-down menu to add a bitmap to the dialogue or
window currently being designed.

The arrow pointer will be changed to a placement pointer after selecting Bitmap
on the Control pull-down menu.  In the status area at the bottom of the
Prominare Designer window, the [x,y] will show the current position of the
placement pointer in relation to the lower left corner of the dialogue.

By moving the placement pointer to the location you want to place the bitmap,
clicking button 1 of the mouse will cause the bitmap to be created and the
Statics Styles dialogue for static styles to be displayed to allow you to edit
the text, ID symbol and value of the bitmap.

Note:  When you select the location for the bitmap by clicking button 1 of the
       mouse, the lower left corner of the bitmap occupy this position and the
       bitmap will be created upwards and to the right of this position.


ΓòÉΓòÉΓòÉ 116. Help for System Icon ΓòÉΓòÉΓòÉ

Select System Icon on the Control pull-down menu to add a system icon to the
dialogue or window currently being designed.

The arrow pointer will be changed to a placement pointer after selecting Bitmap
on the Control pull-down menu.  In the status area at the bottom of the
Prominare Designer window, the [x,y] will show the current position of the
placement pointer in relation to the lower left corner of the dialogue.

By moving the placement pointer to the location you want to place the system
icon, clicking button 1 of the mouse will cause the system icon to be created
and the Statics Styles dialogue for static styles to be displayed to allow you
to edit the text, system icon ID symbol and value.

Unlike other controls, you cannot enter values that are not a system icon.  The
system icons that can be selected are:

       SPTR_ARROW
       SPTR_TEXT
       SPTR_WAIT
       SPTR_MOVE
       SPTR_SIZENWSE
       SPTR_SIZENESW
       SPTR_SIZEWE
       SPTR_SIZENS
       SPTR_APPICON
       SPTR_ICONINFORMATION
       SPTR_ICONQUESTION
       SPTR_ICONERROR
       SPTR_ICONWARNING
       SPTR_ILLEGAL
       SPTR_FILE
       SPTR_FOLDER
       SPTR_MULTFILE
       SPTR_PROGRAM

 Note:  When you select the location for the bitmap by clicking button 1 of the
        mouse, the lower left corner of the bitmap occupy this position and the
        bitmap will be created upwards and to the right of this position.


ΓòÉΓòÉΓòÉ 117. Help for Combo Boxes ΓòÉΓòÉΓòÉ

Select Combo Box on the Control pull-down menu to add a combo box to the
dialogue or window currently being designed.

The arrow pointer will be changed to a placement pointer after selecting Combo
Box on the Control pull-down menu.  In the status area at the bottom of the
Prominare Designer window, the [x,y] will show the current position of the
placement pointer in relation to the lower left corner of the dialogue.

By moving the placement pointer to the location you want to place the combo
box, clicking button 1 of the mouse will cause the combo box to be created and
the Combo Box Styles dialogue for combo box styles to be displayed to allow you
to edit the text, ID symbol and value of the combo box.

Note:  When you select the location for the combo box by clicking button 1 of
       the mouse, the lower left corner of the combo box occupy this position
       and the combo box will be created upwards and to the right of this
       position.


ΓòÉΓòÉΓòÉ 118. Help for Multi-Line ΓòÉΓòÉΓòÉ

Select Multi-Line on the Control pull-down menu to add a multi-line entry to
the dialogue or window currently being designed.

The arrow pointer will be changed to a placement pointer after selecting
Multi-Line on the Control pull-down menu.  In the status area at the bottom of
the Prominare Designer window, the [x,y] will show the current position of the
placement pointer in relation to the lower left corner of the dialogue.

By moving the placement pointer to the location you want to place the
multi-line entry, clicking button 1 of the mouse will cause the multi-line
entry to be created and the Multi-line Entry Styles dialogue for multi-line
entry styles to be displayed to allow you to edit the text, ID symbol and value
of the multi-line entry.

Note:  When you select the location for the multi-line entry by clicking button
       1 of the mouse, the lower left corner of the multi-line entry occupy
       this position and the multi-line entry will be created upwards and to
       the right of this position.


ΓòÉΓòÉΓòÉ 119. Help for Spin Button ΓòÉΓòÉΓòÉ

Note:  Valid only for OS/2 Version 1.3 and above.

 Select Spin button on the Control pull-down menu to add a spin button to the
 dialogue or window currently being designed.

 The arrow pointer will be changed to a placement pointer after selecting Spin
 button on the Control pull-down menu.  In the status area at the bottom of the
 Prominare Designer window, the [x,y] will show the current position of the
 placement pointer in relation to the lower left corner of the dialogue.

 By moving the placement pointer to the location you want to place the spin
 button, clicking button 1 of the mouse will cause the spin button to be
 created and the Spin Button Styles dialogue for spin button styles to be
 displayed to allow you to edit the text, ID symbol and value of the spin
 button.

 Note:  When you select the location for the spin button by clicking button 1
        of the mouse, the lower left corner of the spin button occupy this
        position and the spin button will be created upwards and to the right
        of this position.


ΓòÉΓòÉΓòÉ 120. Help for Container ΓòÉΓòÉΓòÉ

Note:  Valid only for OS/2 Version 2.0. 2.1, 2.11, Warp and above.

 Select Container on the Control pull-down menu to add a container to the
 dialogue or window currently being designed.

 The arrow pointer will be changed to a placement pointer after selecting
 Container on the Control pull-down menu.  In the status area at the bottom of
 the Prominare Designer window, the [x,y] will show the current position of the
 placement pointer in relation to the lower left corner of the dialogue.

 By moving the placement pointer to the location you want to place the
 container, clicking button 1 of the mouse will cause the container to be
 created and the Container Styles dialogue for container styles to be displayed
 to allow you to edit the text, ID symbol and value of the container.

 Note:  When you select the location for the container entry by clicking button
        1 of the mouse, the lower left corner of the container occupy this
        position and the container will be created upwards and to the right of
        this position.


ΓòÉΓòÉΓòÉ 121. Help for Slider ΓòÉΓòÉΓòÉ

Note:  Valid only for OS/2 Version 2.0. 2.1, 2.11, Warp and above.

 Select Slider on the Control pull-down menu to add a slider to the dialogue or
 window currently being designed.

 The arrow pointer will be changed to a placement pointer after selecting
 Slider on the Control pull-down menu.  In the status area at the bottom of the
 Prominare Designer window, the [x,y] will show the current position of the
 placement pointer in relation to the lower left corner of the dialogue.

 By moving the placement pointer to the location you want to place the slider,
 clicking button 1 of the mouse will cause the slider to be created and the
 Slider Styles dialogue for slider styles to be displayed to allow you to edit
 the text, ID symbol and value of the slider.

 Note:  When you select the location for the slider entry by clicking button 1
        of the mouse, the lower left corner of the slider occupy this position
        and the slider will be created upwards and to the right of this
        position.


ΓòÉΓòÉΓòÉ 122. Help for Value Set ΓòÉΓòÉΓòÉ

Note:  Valid only for OS/2 Version 2.0. 2.1, 2.11, Warp and above.

 Select Value set on the Control pull-down menu to add a container to the
 dialogue or window currently being designed.

 The arrow pointer will be changed to a placement pointer after selecting Value
 set on the Control pull-down menu.  In the status area at the bottom of the
 Prominare Designer window, the [x,y] will show the current position of the
 placement pointer in relation to the lower left corner of the dialogue.

 By moving the placement pointer to the location you want to place the value
 set, clicking button 1 of the mouse will cause the value set to be created and
 the Value Set Styles dialogue for value set styles to be displayed to allow
 you to edit the text, ID symbol and value of the value set.

 Note:  When you select the location for the value set entry by clicking button
        1 of the mouse, the lower left corner of the value set occupy this
        position and the value set will be created upwards and to the right of
        this position.


ΓòÉΓòÉΓòÉ 123. Help for Notebook ΓòÉΓòÉΓòÉ

Note:  Valid only for OS/2 Version 2.0. 2.1, 2.11, Warp and above.

 Select Notebook on the Contro l pull-down menu to add a notebook to the
 dialogue or window currently being designed.

 The arrow pointer will be changed to a placement pointer after selecting
 Notebook on the Control pull-down menu.  In the status area at the bottom of
 the Prominare Designer window, the [x,y] will show the current position of the
 placement pointer in relation to the lower left corner of the dialogue.

 By moving the placement pointer to the location you want to place the
 notebook, clicking button 1 of the mouse will cause the notebook to be created
 and the Notebook Styles dialogue for notebook styles to be displayed to allow
 you to edit the text, ID symbol and value of the notebook.

 Note:  When you select the location for the notebook entry by clicking button
        1 of the mouse, the lower left corner of the notebook occupy this
        position and the notebook will be created upwards and to the right of
        this position.


ΓòÉΓòÉΓòÉ 124. Help for User Defined ΓòÉΓòÉΓòÉ

Select User define on the Control pull-down menu to select a custom control.

A dialogue will be displayed that will allow you to select from temporary
controls that you have set as well as from control libraries.

Once you have selected the control to use, the arrow pointer will be changed to
a placement pointer.  In the status area at the bottom of the Prominare
Designer window, the [x,y] will show the current position of the placement
pointer in relation to the lower left corner of the dialogue.

By moving the placement pointer to the location you want to place the user
defined control, clicking button 1 of the mouse will cause the user defined
control to be created and the User Defined Control dialogue for user defined
controls to be displayed to allow you to select the user defined or custom
control.

Note:  When you select the location for the user defined control by clicking
       button 1 of the mouse, the lower left corner of the user defined control
       occupy this position and the user defined control will be created
       upwards and to the right of this position.


ΓòÉΓòÉΓòÉ 125. Help for Circular Slider ΓòÉΓòÉΓòÉ

Note:  Valid only for OS/2 MMPM/2.

 Select Circular Slider on the Control pull-down menu to add a circular slider
 to the dialogue or window currently being designed.

 The arrow pointer will be changed to a placement pointer after selecting
 Circular Slider on the Control pull-down menu.  In the status area at the
 bottom of the Prominare Designer window, the [x,y] will show the current
 position of the placement pointer in relation to the lower left corner of the
 dialogue.

 By moving the placement pointer to the location you want to place the circular
 slider, clicking button 1 of the mouse will cause the circular slider to be
 created and the Circular Slider Styles dialogue for circular slider styles to
 be displayed to allow you to edit the text, ID symbol and value of the
 notebook.

 Note:  When you select the location for the circular slider entry by clicking
        button 1 of the mouse, the lower left corner of the circular slider
        occupy this position and the circular slider will be created upwards
        and to the right of this position.


ΓòÉΓòÉΓòÉ 126. Help for Graphic Button ΓòÉΓòÉΓòÉ

Note:  Valid only for OS/2 MMPM/2.

 Select Graphic Button on the Control pull-down menu to add a graphical button
 to the dialogue or window currently being designed.

 The arrow pointer will be changed to a placement pointer after selecting
 Graphic Button on the Control pull-down menu.  In the status area at the
 bottom of the Prominare Designer window, the [x,y] will show the current
 position of the placement pointer in relation to the lower left corner of the
 dialogue.

 By moving the placement pointer to the location you want to place the
 graphical button, clicking button 1 of the mouse will cause the graphical
 button to be created and the Graphical Button Styles dialogue for graphical
 button styles to be displayed to allow you to edit the text, ID symbol and
 value of the graphical button.

 Note:  When you select the location for the graphical button entry by clicking
        button 1 of the mouse, the lower left corner of the graphical button
        occupy this position and the graphical button will be created upwards
        and to the right of this position.


ΓòÉΓòÉΓòÉ 127. Help for Handwriting ΓòÉΓòÉΓòÉ

Note:  Valid only for Pen for OS/2.

 Select Handwriting on the Control pull-down menu to add a handwriting control
 to the dialogue or window currently being designed.

 The arrow pointer will be changed to a placement pointer after selecting
 Handwriting on the Control pull-down menu.  In the status area at the bottom
 of the Prominare Designer window, the [x,y] will show the current position of
 the placement pointer in relation to the lower left corner of the dialogue.

 By moving the placement pointer to the location you want to place the
 handwriting control, clicking button 1 of the mouse will cause the handwriting
 control to be created and the Hand Writing Styles dialogue for handwriting
 control styles to be displayed to allow you to edit the text, ID symbol and
 value of the notebook.

 Note:  When you select the location for the handwriting control entry by
        clicking button 1 of the mouse, the lower left corner of the
        handwriting control occupy this position and the handwriting control
        will be created upwards and to the right of this position.


ΓòÉΓòÉΓòÉ 128. Help for Sketch ΓòÉΓòÉΓòÉ

Note:  Valid only for Pen for OS/2.

 Select Sketch on the Control pull-down menu to add a sketch control to the
 dialogue or window currently being designed.

 The arrow pointer will be changed to a placement pointer after selecting
 Sketch on the Control pull-down menu.  In the status area at the bottom of the
 Prominare Designer window, the [x,y] will show the current position of the
 placement pointer in relation to the lower left corner of the dialogue.

 By moving the placement pointer to the location you want to place the sketch
 control, clicking button 1 of the mouse will cause the sketch control to be
 created and the Sketch Styles dialogue for sketch control styles to be
 displayed to allow you to edit the text, ID symbol and value of the notebook.

 Note:  When you select the location for the sketch control entry by clicking
        button 1 of the mouse, the lower left corner of the sketch control
        occupy this position and the sketch control will be created upwards and
        to the right of this position.


ΓòÉΓòÉΓòÉ 129. Help for Windows ΓòÉΓòÉΓòÉ

Select Window on the Control pull-down menu to add a child window to the
dialogue or window currently being designed.

The arrow pointer will be changed to a placement pointer after selecting Window
on the Control pull-down menu.  In the status area at the bottom of the
Prominare Designer window, the [x,y] will show the current position of the
placement pointer in relation to the lower left corner of the dialogue.

By moving the placement pointer to the location you want to place the child
window, clicking button 1 of the mouse will cause the child window to be
created and the Child Window Styles dialogue for window styles to be displayed
to allow you to edit the text, ID symbol and value of the child window.

Note:  When you select the location for the child window by clicking button 1
       of the mouse, the lower left corner of the child window occupy this
       position and the child window will be created upwards and to the right
       of this position.


ΓòÉΓòÉΓòÉ 130. Help for Menu ΓòÉΓòÉΓòÉ

Select Menu on the Control pull-down menu to add an action bar or sub-menu item
to the window currently being designed.

The Menu Styles dialogue for menu styles will be displayed to allow you to edit
the text, ID symbol and value of the menu item.

Note:  You can only add a menu's to windows that have had the menu style option
       selected.


ΓòÉΓòÉΓòÉ 131. Help for Resources ΓòÉΓòÉΓòÉ

To add a resource to the current window or dialogue, select the Resource
pull-down.

The menu items contained within the Resource pull-down are:

      Accelerator
      Adds an accelerator.

      Association table
      Adds an association table item.

      Bitmap
      Adds a bitmap resource.

      Character table
      Adds a character table.

      Font
      Adds a font resource.

      Font directory
      Adds a font directory.

      Help
      Adds help tables consisting of:
          Table
          Table Item
          Sub-Table
          Sub-Table Item
          Build Help Table
          Build Help Sub-Table
      Icon
      Adds an icon resource.

      Key table
      Adds a key table.

      Message
      Adds a message resource.

      Pointer
      Adds a pointer resource.

      Resource
      Adds a custom resource.

      String
      Adds a string resource.

      Virtual key table
      Adds a virtual key table.


ΓòÉΓòÉΓòÉ 132. Help for Accelerator ΓòÉΓòÉΓòÉ

Select Accelerator on the Resource pull-down menu to add an accelerator to the
design currently being worked on.

Note:  Accelerators can only be added to windows that have the Accelerator
       option selected.


ΓòÉΓòÉΓòÉ 133. Help for Association Table ΓòÉΓòÉΓòÉ

Select Association table on the Resource pull-down menu to add an association
table item to the design currently being worked on.

The Association Table dialogue will be displayed allowing you to enter the
specific association information or to edit an existing entry.


ΓòÉΓòÉΓòÉ 134. Help for Bitmap Resources ΓòÉΓòÉΓòÉ

Select Bitmap on the Resource pull-down menu to add a bitmap resource to the
window or dialogue currently being designed.

The Bitmap, Font, Icon and Pointer Resources dialogue will be displayed to
allow you to enter the ID symbol and value of the bitmap resource along with
the path and filename of the actual bitmap resource that you have created or
will be creating.


ΓòÉΓòÉΓòÉ 135. Help for Character Table ΓòÉΓòÉΓòÉ

Select Character table on the Resource pull-down menu to add an character table
item to the design currently being worked on.

The Resource Table dialogue will be displayed allowing you to enter the
specific character table or to edit an existing entry.


ΓòÉΓòÉΓòÉ 136. Help for Font Resources ΓòÉΓòÉΓòÉ

Select Font on the Resource pull-down menu to add a font resource to the window
or dialogue currently being designed.

The Bitmap, Font, Icon and Pointer Resources dialogue will be displayed to
allow you to enter the ID symbol and value of the font resource along with the
path and filename of the actual font resource that you have created or will be
creating.


ΓòÉΓòÉΓòÉ 137. Help for Font Directory ΓòÉΓòÉΓòÉ

Select Font directory on the Resource pull-down menu to add a font directory to
the design currently being worked on.

The Resource Table dialogue will be displayed allowing you to enter the
specific font directory or to edit an existing entry.


ΓòÉΓòÉΓòÉ 138. Help for Help Resources ΓòÉΓòÉΓòÉ

Select Help on the Resource pull-down menu to add a help tables to the window
or dialogue currently being designed.

The sub-menu associated with the menu item will allow you to select the type of
help you wish to add to the window or dialogue.  The items of the sub-menu are:

     Table
     Table Item
     Sub-Table
     Sub-Table Item
     Build Help Table
     Build Help Sub-Table


ΓòÉΓòÉΓòÉ 139. Help for Help Table ΓòÉΓòÉΓòÉ

To add a help table, select the Help Table on the Resource pull-down.

The Help Table dialogue  will be presented allowing you to define the help
table you wish to add for the current window or dialogue.


ΓòÉΓòÉΓòÉ 140. Help for Help Item ΓòÉΓòÉΓòÉ

To add a help table item, select the Help Table Item on the Resource pull-down.

The Help Table Items dialogue will be presented allowing you to define the help
table item you wish to add for the current window or dialogue.


ΓòÉΓòÉΓòÉ 141. Help for Help Sub-Table ΓòÉΓòÉΓòÉ

To add a help sub-table, select the Help Sub-Table on the Resource pull-down.

The Help Sub-Table dialogue will be presented allowing you to define the help
sub-table you wish to add for the current window or dialogue.


ΓòÉΓòÉΓòÉ 142. Help for Help Sub-Item ΓòÉΓòÉΓòÉ

To add a help sub-table item, select the Help Sub-Table Item on the Resource
pull-down.

The Help Sub-Table Item dialogue will be presented allowing you to define the
help sub-table item you wish to add for the current window or dialogue.


ΓòÉΓòÉΓòÉ 143. Help for Build Table ΓòÉΓòÉΓòÉ

Select Build Table on the Resource pull-down menu to build the Help Table for
the design currently being designed or edited.

A Help Table will be created based on all Help Sub-Tables defined for the
design.


ΓòÉΓòÉΓòÉ 144. Help for Build Sub-Table ΓòÉΓòÉΓòÉ

Select Build Sub-Table on the Resource pull-down menu to build the Help
Sub-Table for the window or dialogue currently being designed or edited.

A Help Sub-Table will be created based on controls that require user
interaction such as push buttons, check boxes, etc.


ΓòÉΓòÉΓòÉ 145. Help for Icon ΓòÉΓòÉΓòÉ

To add a bitmap, font, icon or pointer, select the Bitmap, Font, Icon or
Pointer on the Resource pull-down.

The Bitmap, Font, Icon and Pointer Resources dialogue will be presented
allowing you to define the bitmap, font, icon or pointer you wish to add for
the current window or dialogue.


ΓòÉΓòÉΓòÉ 146. Help for Key Table ΓòÉΓòÉΓòÉ

Select Key table on the Resource pull-down menu to add a key table item to the
design currently being worked on.

The Resource Table dialogue will be displayed allowing you to enter the
specific key table or to edit an existing entry.


ΓòÉΓòÉΓòÉ 147. Help for Message Resources ΓòÉΓòÉΓòÉ

Select Message on the Resource pull-down menu to add a message resource to the
window or dialogue currently being designed.

The Message Resources dialogue will be displayed to allow you to enter the ID
symbol and value of the message resource along with the actual message string
that you wish to add.


ΓòÉΓòÉΓòÉ 148. Help for Pointer Resources ΓòÉΓòÉΓòÉ

Select Pointer on the Resource pull-down menu to add a pointer resource to the
window or dialogue currently being designed.

The Bitmap, Font, Icon and Pointer Resources dialogue will be displayed to
allow you to enter the ID symbol and value of the pointer resource along with
the path and filename of the actual pointer resource that you have created or
will be creating.


ΓòÉΓòÉΓòÉ 149. Help for Custom Resource ΓòÉΓòÉΓòÉ

To edit a custom resource that you have defined, select the Resource on the
Resource pull-down.

The Custom Resource dialogue will be displayed listing all of the custom
resources defined for the window or dialogue from which you can select a custom
resource to change.


ΓòÉΓòÉΓòÉ 150. Help for String ΓòÉΓòÉΓòÉ

To edit a message or string, select Message or String on the Resource
pull-down.

The Message Resources dialogue will be displayed listing all of the messages or
strings defined for the window or dialogue from which you can select a message
or string to change.


ΓòÉΓòÉΓòÉ 151. Help for Virtual Key Table ΓòÉΓòÉΓòÉ

Select Virtual key table on the Resource pull-down menu to add a virtual key
table item to the design currently being worked on.

The Resource Table dialogue will be displayed allowing you to enter the
specific virtual key table or to edit an existing entry.


ΓòÉΓòÉΓòÉ 152. Help for Messages ΓòÉΓòÉΓòÉ

The Messages tab is used to select or de-select messages that are to be
included within a window or dialogue procedure.

Depending on the defaults that you selected through the Source Layout menu,
messages will have been preselected for inclusion within the window or
dialogue.

You can then select the messages that you wish to include within the window or
dialogue from the messages contained within the list and the code you have
defined for these messages will be included within your window or dialogue that
you are designing.

The messages within the displayed list will be for windows:

     WM_*
     DM_*
     HM_*

 The messages within the displayed list will be for dialogues:

     WM_*
     DM_*

 The tab will display the total number of messages contained within the list
 and will show also the total number of messages that you have selected.  Each
 message that you selected to be included is highlighted within the message
 list.


ΓòÉΓòÉΓòÉ 153. Help for Workplace Definitions ΓòÉΓòÉΓòÉ

When creating a Workplace object, it is necessary to provide Prominare Designer
with certain Definitions.

To do this, click the mouse pointer on the Definitions tab in the Window Styles
dialogue.

A tab will be displayed in which you can enter the names for various handles
required within the program or you can have Prominare Designer do it for you.

Note:  If you want Prominare Designer to generate the source code for the
       design you are working, you must do this through the Window Definitions.


ΓòÉΓòÉΓòÉ 154. Help for Child Window Definitions ΓòÉΓòÉΓòÉ

When creating a child window, it is necessary to provide Prominare Designer
with certain Definitions.

To do this, click the mouse pointer on the Definitions tab in the Child Window
Styles dialogue.

A tab will be displayed in which you can enter the names for various handles
required within the program or you can have Prominare Designer do it for you.

Note:  If you want Prominare Designer to generate the source code for the
       design you are working, you must do this through the Window Definitions.


ΓòÉΓòÉΓòÉ <hidden> Help for Source pull-down ΓòÉΓòÉΓòÉ

The Source pull-down contains items you can use to customize the default source
created through Prominare Designer.

Press the Enter key to access the items on the Source pull-down.

The menu items contained within the Rules pull-down are:

      Messages
      Allows definition of default source code for window, dialogue and
      notification messages.

      Source
      Allows definition of source code components.

      Command
      Allows the definition of WM_COMMAND source code handling.

      Layout
      Allows selection of default messages to be included as layouts for window
      and dialogue.

      Export
      Allows the exporting of the source code rules to an ASCII file which can
      then be edited using a standard text or source code editor.

      Import
      Allows the importing of editing rules from an ASCII file.


ΓòÉΓòÉΓòÉ 155. Help for Edit Default Class Source ΓòÉΓòÉΓòÉ

The Edit Default Class Source dialogue contains items you can use to define the
default class source for of window and dialogue procedures.

The dialogue contains tabs for:

      Parent window
      Secondary window
      Dialogue
      Modeless dialogue
      Child window


ΓòÉΓòÉΓòÉ 156. Help for Source Messages ΓòÉΓòÉΓòÉ

The Messages menu item of the Source pull-down contains items you can use to
define the default source for window, dialogue and notification messages that
are included within your window and dialogue procedures.

Press the Enter key to access the items on the Messages pull-down.

The menu items contained within the Messages pull-down are:

      Window
      Allows definition of default source code for window messages.

      Dialogue
      Allows definition of default source code for dialogue messages.

      Notification
      Allows definition of default source code for notification messages.


ΓòÉΓòÉΓòÉ 157. Help for Edit Window Messages ΓòÉΓòÉΓòÉ

To edit the default message handling for windows, select the Window menu item
on the Source Messages menu.  A dialogue will be displayed showing a list of
messages that are valid for windows that you create within your current design.

By selecting a message, the default source code for that message will be
displayed and you will be able to then edit that default code to suit the needs
that you may have for the application or for any other code that is generated.


ΓòÉΓòÉΓòÉ 158. Help for Source Messages Dialogue ΓòÉΓòÉΓòÉ

To edit the default message handling for dialogues, select the Dialogue menu
item on the Source Messages menu.  A dialogue will be displayed showing a list
of messages that are valid for dialogues that you create within your current
design.

By selecting a message, the default source code for that message will be
displayed and you will be able to then edit that default code to suit the needs
that you may have for the application or for any other code that is generated.


ΓòÉΓòÉΓòÉ 159. Help for Source Messages Notification ΓòÉΓòÉΓòÉ

To edit the default message handling for notification messages, select the
Notification menu item on the Source Messages menu. A dialogue will be
displayed showing a list of notification messages that are valid for the
controls that you include within your current design.

By selecting a message, the default source code for that message will be
displayed and you will be able to then edit that default code to suit the needs
that you may have for the application or for any other code that is generated.


ΓòÉΓòÉΓòÉ 160. Help for Source ΓòÉΓòÉΓòÉ

The Source menu item of the Source pull-down causes the Edit Default Source
dialogue to be displayed in which you can edit the default source code for
various components that are used to generate the source code.  These include
the module start, include header start, main() function, etc.


ΓòÉΓòÉΓòÉ 161. Help for Rules Source Modules Start ΓòÉΓòÉΓòÉ

To edit the default coding for the start of a module, select the Module start
menu item on the Rules Source menu.

A dialogue will be displayed thereby allowing you to enter the default source
code that will be used for the start of new source modules when a new source
module is first created when source code is generated by Prominare Designer.


ΓòÉΓòÉΓòÉ 162. Help for Rules Source Header Start ΓòÉΓòÉΓòÉ

To edit the default coding for the start of a header include file, select the
Header start menu item on the Rules Source menu.

A dialogue will be displayed thereby allowing you to enter the default source
code that will be used for the start of new source include headers when a new
source include header is first created when source code is generated by
Prominare Designer.


ΓòÉΓòÉΓòÉ 163. Help for Rules Source Window Declaration ΓòÉΓòÉΓòÉ

To edit the default coding for a window declaration, select the Window
declaration menu item on the Rules Source menu.

A dialogue will be displayed thereby allowing you to enter the default source
code that will be used for a window procedure when a new window procudure is
first created when source code is generated by Prominare Designer.


ΓòÉΓòÉΓòÉ 164. Help for Rules Source Child Window Declaration ΓòÉΓòÉΓòÉ

To edit the default coding for a child window declaration, select the Child
window declaration menu item on the Rules Source menu.

A dialogue will be displayed thereby allowing you to enter the default source
code that will be used for a window procedure when a new child window procudure
is first created when source code is generated by Prominare Designer.


ΓòÉΓòÉΓòÉ 165. Help for Rules Source Dialogue Declaration ΓòÉΓòÉΓòÉ

To edit the default coding for a dialogue declaration, select the Window
declaration menu item on the Rules Source menu.

A dialogue will be displayed thereby allowing you to enter the default source
code that will be used for a dialogue procedure when a new window procudure is
first created when source code is generated by Prominare Designer.


ΓòÉΓòÉΓòÉ 166. Help for Rules main() Declaration ΓòÉΓòÉΓòÉ

To edit the default coding for a main() declaration, select the main() menu
item on the Rules Source menu.

A dialogue will be displayed thereby allowing you to enter the default source
code that will be used for the main() procedure it is first created when source
code is generated by Prominare Designer.


ΓòÉΓòÉΓòÉ 167. Help for Rules Support Module Declaration ΓòÉΓòÉΓòÉ

To edit the default coding for a Support.C or Support.Cpp module, select the
Support module menu item on the Rules Source menu.

A dialogue will be displayed thereby allowing you to enter the default source
code that will be used for the body of the Support.C or Support.Cpp module when
it is first created when source code is generated by Prominare Designer.


ΓòÉΓòÉΓòÉ 168. Help for Rules Applications Definitions Module ΓòÉΓòÉΓòÉ

To edit the default coding for a AppDefs.C or AppDefs.Cpp module, select the
Application definitions menu item on the Rules Source menu.

A dialogue will be displayed thereby allowing you to enter the default source
code that will be used for the body of the AppDefs.C or AppDefs.Cpp module when
it is first created when source code is generated by Prominare Designer.


ΓòÉΓòÉΓòÉ 169. Help for Rules Applications Definitions Header Module ΓòÉΓòÉΓòÉ

To edit the default coding for a AppDefs.H or AppDefs.Hpp module, select the
Application definitions menu item on the Rules Source menu.

A dialogue will be displayed thereby allowing you to enter the default source
code that will be used for the body of the AppDefs.H or AppDefs.Hpp module when
it is first created when source code is generated by Prominare Designer.


ΓòÉΓòÉΓòÉ 170. Help for Rules XxxxRegister ΓòÉΓòÉΓòÉ

To edit the default coding for the XxxxRegister function of a PMCX control,
select the XxxxRegister menu item on the Rules Source menu.

A dialogue will be displayed thereby allowing you to enter the default source
code that will be used for the body of the XxxxRegister function when it is
first created when source code is generated by Prominare Designer.


ΓòÉΓòÉΓòÉ 171. Help for Rules XxxxQuery ΓòÉΓòÉΓòÉ

To edit the default coding for the XxxxQuery function of a PMCX control, select
the XxxxQuery menu item on the Rules Source menu.

A dialogue will be displayed thereby allowing you to enter the default source
code that will be used for the body of the XxxxQuery function when it is first
created when source code is generated by Prominare Designer.


ΓòÉΓòÉΓòÉ 172. Help for Rules XxxxStyles ΓòÉΓòÉΓòÉ

To edit the default coding for the XxxxStyles function of a PMCX control,
select the XxxxStyles menu item on the Rules Source menu.

A dialogue will be displayed thereby allowing you to enter the default source
code that will be used for the body of the XxxxStyles function when it is first
created when source code is generated by Prominare Designer.


ΓòÉΓòÉΓòÉ 173. Help for Rules XxxxWndProc ΓòÉΓòÉΓòÉ

To edit the default coding for the XxxxWndProc function of a PMCX control,
select the XxxxWndProc menu item on the Rules Source menu.

A dialogue will be displayed thereby allowing you to enter the default source
code that will be used for the body of the XxxxWndProc function when it is
first created when source code is generated by Prominare Designer.


ΓòÉΓòÉΓòÉ 174. Help for Source Command ΓòÉΓòÉΓòÉ

The Source Command pull-down contains items you can use to define the default
source for the handling of WM_COMMAND messages of window and dialogue
procedures.

Press the Enter key to access the items on the Command pull-down.

The menu items contained within the Command pull-down are:

      Menu
      Allows definition of the menu selections.

      Push Button
      Allows definition of the push button selections.

      User Button
      Allows definition of user button selections.

      User Defined
      Allows definition of user define selections.


ΓòÉΓòÉΓòÉ 175. Help for Source Command Menu ΓòÉΓòÉΓòÉ

To edit the default coding for a menu selection, select the Menu menu item on
the Source Command menu.

A dialogue will be displayed thereby allowing you to enter the default source
code for different methods when a menu item is selected within a window
procudure.  The menu item is placed within the handling of the WM_COMMAND
message and can be used to invoke other dialogues and create windows.


ΓòÉΓòÉΓòÉ 176. Help for Source Push Button ΓòÉΓòÉΓòÉ

To edit the default coding for a push button selection, select the Push Button
menu item on the Source Command menu.

A dialogue will be displayed thereby allowing you to enter the default source
code for different methods when a push button is selected within a window
procudure.  The push button is placed within the handling of the WM_COMMAND
message and can be used to invoke other dialogues and create windows.


ΓòÉΓòÉΓòÉ 177. Help for Source Command User Button ΓòÉΓòÉΓòÉ

To edit the default coding for a user button selection, select the User Button
menu item on the Source Command menu.

A dialogue will be displayed thereby allowing you to enter the default source
code for different methods when a user button is selected within a window
procudure.  The user button is placed within the handling of the WM_COMMAND
message and can be used to invoke other dialogues and create windows.


ΓòÉΓòÉΓòÉ 178. Help for RulesSource User Defined ΓòÉΓòÉΓòÉ

To edit the default coding for a user defined selection, select the User
Defined menu item on the Source Command menu.

A dialogue will be displayed thereby allowing you to enter the default source
code for different methods when a user defined is selected within a window
procudure.  The user defined is placed within the handling of the WM_COMMAND
message and can be used to invoke other dialogues and create windows.


ΓòÉΓòÉΓòÉ 179. Help for Source Layout ΓòÉΓòÉΓòÉ

The Source Layout pull-down contains items you can use to define the messages
that are to be included by default within new window and dialogues you created.

Press the Enter key to access the items on the Layout pull-down.

The menu items contained within the Layout pull-down are:

      Window
      Allows definition of the messages to include within the default code for
      windows.

      Dialogue
      Allows definition of the messages to include within the default code for
      dialogues.

      PMCX window
      Allows definition of the messages to include within the default code for
      PMCX control window.

      PMCX dialogue
      Allows definition of the messages to include within the default code for
      PMCX Styles dialogue.


ΓòÉΓòÉΓòÉ 180. Help for Source Layout Window ΓòÉΓòÉΓòÉ

To edit the default coding for a window, select the Window menu item on the
Source Layout menu.

A dialogue will be displayed thereby allowing you to select the messages that
are included by default when you create a new window.  This allows you to
through the other Source menu items, define exactly the default source code you
want to use both on an individual message basis and window procedure basis.


ΓòÉΓòÉΓòÉ 181. Help for Source Layout Dialogue ΓòÉΓòÉΓòÉ

To edit the default coding for a window, select the Dialogue menu item on the
Source Layout menu.

A dialogue will be displayed thereby allowing you to select the messages that
are included by default when you create a new dialogue.  This allows you to
through the other Source menu items, define exactly the default source code you
want to use both on an individual message basis and dialogue procedure basis.


ΓòÉΓòÉΓòÉ 182. Help for Source Layout PMCX Window ΓòÉΓòÉΓòÉ

To edit the default coding for the PMCX control window, select the PMCX window
menu item on the Source Layout menu.

A dialogue will be displayed thereby allowing you to select the messages that
are included by default when you create a new window.  This allows you to
through the other Source menu items, define exactly the default source code you
want to use both on an individual message basis and window procedure basis.


ΓòÉΓòÉΓòÉ 183. Help for Source Layout PMCX Dialogue ΓòÉΓòÉΓòÉ

To edit the default coding for the PMCX XxxxStyles dialogue, select the PMCX
dialogue menu item on the Source Layout menu.

A dialogue will be displayed thereby allowing you to select the messages that
are included by default when you create a new window.  This allows you to
through the other Source menu items, define exactly the default source code you
want to use both on an individual message basis and window procedure basis.


ΓòÉΓòÉΓòÉ 184. Text Input ΓòÉΓòÉΓòÉ

Through the dialogue, you enter the text for the source code rules component.


ΓòÉΓòÉΓòÉ 185. Message Body Edit ΓòÉΓòÉΓòÉ

Through the dialogue, you enter the code and variables for the source code
rules component.


ΓòÉΓòÉΓòÉ 186. Help for Export ΓòÉΓòÉΓòÉ

Through the Export menu item of the Source pull-down, you can have the current
source code rules exported to an ASCII file.  You can then edit this file using
a standard text or source code editor.

This may make it easier to incorporate standard source code into the source
coding rules.

The export source code rules are tagged to allow the importing of the edited
file.


ΓòÉΓòÉΓòÉ 187. Help for Import ΓòÉΓòÉΓòÉ

Through the Import menu item of the Source pull-down, you can import the
current source code rules that were exported to an ASCII file.

This may make it easier to incorporate standard source code into the source
coding rules.

The export source code rules are tagged to allow the importing of the edited
file.


ΓòÉΓòÉΓòÉ 188. Help for Source Format ΓòÉΓòÉΓòÉ

The Source Format dialogue is used to define such things as indent value for
the case statements, variables, notify blocks, etc.

It also allows you to define the comment style that can be used.

These values are then used to reformat the default code to a revised format
based on these values.


ΓòÉΓòÉΓòÉ <hidden> Help for Configure pull-down ΓòÉΓòÉΓòÉ

The Configure pull-down contains items you can use to customize the Prominare
Designer.

Press the Enter key to access the items on the Configure pull-down.

The menu items contained within the Configure pull-down are:

      Creation options
      Allows the setting of default window, dialogue and control creation
      options such as text, size and styles.

      CUA compliance
      Allows the setting of CUA compliance checking.

      Default usage
      Allows the setting of the Prominare Designer configuration.

      .DFM registration
      Allows the setting of the display units for different display types.

      PMCX and temporary controls
      Allows the definition of the location or locations where the custom
      controls are located and to register them within Prominare Designer.


ΓòÉΓòÉΓòÉ 189. Help for Default Creation Options ΓòÉΓòÉΓòÉ

The Default Creation Options dialogue is used to define the default
characteristics for windows or dialogues created through the New menu item.  It
is also allows you to define the default characteristics for various types of
controls.


ΓòÉΓòÉΓòÉ 190. Help for Default Dialogue/Window ΓòÉΓòÉΓòÉ

Yoy can set through the Dialogue/Window tab the default options that are to be
used when creating a dialogue or window.


ΓòÉΓòÉΓòÉ 191. Help for CUA Compliance Rules ΓòÉΓòÉΓòÉ

The CUA Compliance dialogue is used to define SAA Compliance rules that
Prominare Designer will follow when creating windows, dialogues and controls.

The CUA Compliance rules are checked each time you create or edit a window,
dialogue or control and if the item is non-compliant, Prominare Designer will
display an error message stating what is non-compliant.


ΓòÉΓòÉΓòÉ 192. Help for Default Usage ΓòÉΓòÉΓòÉ

Select Default Usage on the Configure pull-down to set the configuration of
various items that are used within Prominare Designer such as the path where
the master source definitions rules are located and the path where the
predesigned library is located.

When you create a new design, you can have Prominare Designer copy the rules to
the new design area to allow you to edit the source code rules for the design.

It is also used to set the custom control library items and the symbol
prefixes.


ΓòÉΓòÉΓòÉ 193. Help for .DFM registration ΓòÉΓòÉΓòÉ

The .DFM registration function is used to allow you to register Dialogue Font
Metrics (.DFM) files that can be used with display types and resolutions such
that you to easily determine if a window or dialogue you are designing will be
properly displayed on a given display.  The Display Units dialogue allows you
to define any number of displays that your program may run on.  A set of
predefined values are present such that you only need to add the displays that
you have encountered that are different than those on the list.


ΓòÉΓòÉΓòÉ 194. Help for PMCX and Temporary Controls ΓòÉΓòÉΓòÉ

The PMCX/Temporary Control Definition dialogue is used to define the custom
controls that conform to the PMCX definition and that you want to use within
Prominare Designer.

You can also use the dialogue to define a temporary control.


ΓòÉΓòÉΓòÉ 195. Help for Mouse ΓòÉΓòÉΓòÉ

The Mouse tab allows you to define how you want to use the mouse when
interacting with controls and windows within a displayed window or dialogue.

You can set the mouse/keyboard combination for the following actions:

      Select control
      Add/Subtract group item
      Move group
      Rubber band select
      Set group anchor
      Select styles dialogue
      Show info


ΓòÉΓòÉΓòÉ 196. Help for Extensions ΓòÉΓòÉΓòÉ

The Extensions tab is used to set the extensions for the include, resource
script and binary files.  You can define the extensions to use by default for:

      OS/2 1.x
      OS/2 2.x / Warp 3.0 / Warp 4.0
      Windows 3.1
      Windows NT


ΓòÉΓòÉΓòÉ <hidden> Help for Options pull-down ΓòÉΓòÉΓòÉ

The Options pull-down contains items you can use to arrange the order or
controls and menus, define the design characteristics as well as the resource
distribution for the current design.

Press the Enter key to access the items on the Options pull-down.

The menu items contained within the Options pull-down are:

      Arrange controls
      Allows arranging display order of controls.

      Arrange menus
      Allows arranging display order of menus.

      Define design
      Allows base information for design to be set.

      Resource distribution
      Allows the definition of the location or locations where the resource
      elements are to be placed.

      PMCX definition
      Allows the editing of the definition of the PMCX control for which the
      design is targeted.


ΓòÉΓòÉΓòÉ 197. Help for Arranging Controls ΓòÉΓòÉΓòÉ

To arrange the display order of controls within a window or dialogue, select
Arrange Controls on the Options pull-down menu.

The Arrange Controls dialogue will be displayed with a list of all the controls
in the window or dialogue.  You can then select a control and move its relative
display order to another position.

You can also set groups and tab stops within the dialogue.


ΓòÉΓòÉΓòÉ 198. Help for Arranging Menus ΓòÉΓòÉΓòÉ

To arrange the display order of menus within a window, select Arrange Menus on
the Options pull-down menu.

The Arrange Menus dialogue will be displayed with a list of all the menus in
the window.  You can then select a menu item and move its relative display
order to another position.


ΓòÉΓòÉΓòÉ 199. Help for Define Design ΓòÉΓòÉΓòÉ

Select Define design on the Options pull-down menu to define necessary
information that Prominare Designer needs to be able to correctly generate the
resultant resources for the design being worked on.

The information that you would enter through Define Design would be the design
base name, include header filename and .IPF filename.


ΓòÉΓòÉΓòÉ 200. Help for Resource Distribution ΓòÉΓòÉΓòÉ

To define the locations and files under which resource elements are to be
placed, select the Resource distribution menu item within the Options menu.

The Resource Distribution Definition dialogue will be displayed allowing you to
specify locations and filenames under which dialogues, windows, accelerator
tables, etc. can be placed.


ΓòÉΓòÉΓòÉ 201. Help for PMCX Definition ΓòÉΓòÉΓòÉ

To define the custom control that you are designing, you use the PMCX
definition menu item within the Options pull-down menu.

This will allow you to define the name of the custom control, author, class,
text limits, size and support.

The PMCX Creation dialogue will be displayed thereby allowing you to enter or
edit the information.


ΓòÉΓòÉΓòÉ <hidden> Help for Window list pull-down ΓòÉΓòÉΓòÉ

The Window list pull-down contains the list of applications that are currently
running.  Selecting one of the menu items causes that application to be placed
in the foreground if possible.

Only those applications that have placed an entry within the Window List will
be displayed within the menu.


ΓòÉΓòÉΓòÉ <hidden> Help for Help pull-down ΓòÉΓòÉΓòÉ

The Help pull-down contains items you can use to get different types of online
help for the Prominare Designer.

Press the Enter key to access the items on the Help pull-down.

The menu items contained within the Help pull-down are:

      Help index
      Display Help index.

      General help
      Displays General help.

      Using help
      Displays using help.

      Keys help
      Displays program keys help.

      Support
      Displays support sub-menu.

      Product information
      Displays program product information.


ΓòÉΓòÉΓòÉ 202. Help for Using Help ΓòÉΓòÉΓòÉ

Select Using help on the Help pull-down for information on how to use the
Prominare Designer help facility.


ΓòÉΓòÉΓòÉ 203. Help for General Help ΓòÉΓòÉΓòÉ

Select General Help on the Help pull-down to see the extended help panel for
the Prominare Designer.


ΓòÉΓòÉΓòÉ 204. Help for Keys help ΓòÉΓòÉΓòÉ

Select Keys Help on the Help pull-down for help on the keys you use to perform
a specific task,

When you select this item, you see a list of key groups.  Double click on one
of the groups to see the keys you use to perform the task.


ΓòÉΓòÉΓòÉ 205. Help for Help index ΓòÉΓòÉΓòÉ

Select Help Index on the Help pull-down to see the help index for the Prominare
Designer.


ΓòÉΓòÉΓòÉ 206. Help for Product Support ΓòÉΓòÉΓòÉ

Through the Help Support menu items, you can select two additional menu items.
The first one, Submit problem... is used to submit a problem report for one of
the applications you are using within the Prominare Designer.  The second menu
item Submit suggestion... is used to submit a suggestion for the Prominare
Designer.


ΓòÉΓòÉΓòÉ 207. Help for Submit Problem ΓòÉΓòÉΓòÉ

When you are experiencing problems within any of the applications provided with
the Prominare Designer, you can through the Help Support menu item submit a
problem report.  The Support Entry Form displayed provides a notebook in which
you enter information on the problem, the problem application, your machine
description along with your name, address and phone numbers.

The tabs provided are:

     Identification
     Product
     System
     Problem

 You can select the device in which the information will be printed on by
 clicking the mouse pointer on the Printer setup... push button which will
 cause the Printer Setup dialogue to be displayed.

 Once you have completed the necessary information within the notebook pages,
 you can click the mouse pointer on the Fax/Print push button.  This will cause
 the problem report information to be printed on the printer selected, or if
 you are directly faxing the information from your computer, will have the
 information faxed to the product support for your locale.


ΓòÉΓòÉΓòÉ 208. Help for Submit Suggestion ΓòÉΓòÉΓòÉ

When you have a suggestion for any of the applications provided with the
Prominare Designer, you can through the Help Support menu item submit a
suggestion.  The Suggestion Entry Form displayed provides a notebook in which
you enter information on the suggestion, the application along with your name,
address and phone numbers.

The tabs provided are:

     Identification
     Product
     Suggestion

 You can select the device in which the information will be printed on by
 clicking the mouse pointer on the Printer setup... push button which will
 cause the Printer Setup dialogue to be displayed.

 Once you have completed the necessary information within the notebook pages,
 you can click the mouse pointer on the Fax/Print push button.  This will cause
 the problem report information to be printed on the printer selected, or if
 you are directly faxing the information from your computer, will have the
 information faxed to the product support for your locale.


ΓòÉΓòÉΓòÉ 209. Help for Product information ΓòÉΓòÉΓòÉ

Select Product information on the Help pull-down menu to display copyright
information about Prominare Designer.


ΓòÉΓòÉΓòÉ 210. Help for Entry Form dialogue ΓòÉΓòÉΓòÉ

The entry form dialogue provides you with a set of tabs in which you enter
information before you print out the results or have them sent through your fax
software to Prominare support.  You need to complete each page of the forms to
allow Prominare support personnel to be able to use the information you have
submitted properly.

Please make sure that you complete the first tab, Identification, such that if
Prominare support personnel have to contact you for additional information,
they can.  Without this, your problem cannot be solved as quickly as possible.

You can select the device in which the information will be printed on by
clicking the mouse pointer on the Printer setup... push button which will cause
the Printer Setup dialogue to be displayed.

Once you have completed the necessary information within the notebook pages,
you can click the mouse pointer on the Fax/Print push button.  This will cause
the problem report information to be printed on the printer selected, or if you
are directly faxing the information from your computer, will have the
information faxed to the product support for your locale.


ΓòÉΓòÉΓòÉ 211. Help for Identification tab ΓòÉΓòÉΓòÉ

The Identification tab is used to enter information to identify yourself
including your address and phone numbers.

You can through the Reports drop down select previously submitted reports for
follow up or re-submittion with new information.  The Locale drop down allows
you to select the correct support organization.  The final support report will
have the organization where you should send the information to printed at the
top of the first form.

The Save check box is used to indicate that the report should be saved when the
report is printed or faxed.  You should use this option since it allows you to
follow up problems with additional information as required. The New push button
causes a new report to be created in which you can submit the information for.


ΓòÉΓòÉΓòÉ 212. Help for Product tab ΓòÉΓòÉΓòÉ

The Product tab is used to select the product in which you either wish to make
a suggestion for or report a problem on. When you select the Submit problem...
or Submit suggestion... menu item from within one of the Prominare Designer
applications, that application will be automatically selected.  You can select
a different one by clicking the mouse pointer on the appropriate radio button.
If you selected the Other radio button, please enter the name of the
application within the entry field provided beside it.  It can accept up to 63
characters.

Below the product radio buttons are the problem areas.  You can select from one
of the following:

      Fatal error
      Recurrent
      Intermittent
      Unknown
 These radio buttons will only be active when you are submitting a problem
 report.

 You can select the font to use for the report from the drop down list labeled
 Fonts and the font size from the drop down list labeled Size. The default font
 used when printing or faxing will depend on the printer or fax device
 selected.


ΓòÉΓòÉΓòÉ 213. Help for System info tab ΓòÉΓòÉΓòÉ

The System tab is used to enter information on your system. You should include
the brand name, model number or name and manufacturer of your computer.  You
should also include information like the video device, video memory, video
device driver (if possible), hard disk size, number of drives, network, etc.
This will allow Prominare support personnel to better understand the
constraints and configuration of your system.  The report printout will provide
the amount of memory contained on your system.


ΓòÉΓòÉΓòÉ 214. Help for Problem tab ΓòÉΓòÉΓòÉ

The Problem tab is used to enter the description of the problem.  Please
provide as much detail as possible and attach any code listing that illustrate
the problem.  The multiple-line entry field provided can accept up to 32 KB of
information


ΓòÉΓòÉΓòÉ 215. Help for Suggestion tab ΓòÉΓòÉΓòÉ

The Suggestion tab is used to enter the description of the suggestion.  Please
provide as much detail as possible and attach any code listing that illustrate
the suggestion.  The multiple-line entry field provided can accept up to 32 KB
of information.


ΓòÉΓòÉΓòÉ 216. Help for Check Box Defaults ΓòÉΓòÉΓòÉ

To define the default characteristics of check boxes when created using the
Control Check Box menu item, the Check Box tab is used.

The tab allows you to define the default styles, text and size of check boxes
when you add them to a dialogue.  The tab also allows you to preview the
styles, text and size you enter for the default.


ΓòÉΓòÉΓòÉ 217. Help for Combo Box Defaults ΓòÉΓòÉΓòÉ

To define the default characteristics of combo boxes when created using the
Control Combo Box menu item, the Combo Box tab is used.

The tab allows you to define the default styles, text and size of combo boxes
when you add them to a dialogue.  The tab also allows you to preview the
styles, text and size you enter for the default.


ΓòÉΓòÉΓòÉ 218. Help for Entry Field Defaults ΓòÉΓòÉΓòÉ

To define the default characteristics of entry fields when created using the
Control Edit menu item, the Entry Field tab is used.

The tab allows you to define the default styles, text and size of entry fields
when you add them to a dialogue.  The tab also allows you to preview the
styles, text and size you enter for the default.


ΓòÉΓòÉΓòÉ 219. Help for Group Box Defaults ΓòÉΓòÉΓòÉ

To define the default characteristics of group boxes when created using the
Control Group Box menu item, the Group Box tab is used.

The tab allows you to define the default styles, text and size of group boxes
when you add them to a dialogue.  The tab also allows you to preview the
styles, text and size you enter for the default.


ΓòÉΓòÉΓòÉ 220. Help for List Box Defaults ΓòÉΓòÉΓòÉ

To define the default characteristics of list boxes when created using the
Control List Box menu item, the List Box tab is used.

The tab allows you to define the default styles, text and size of list boxes
when you add them to a dialogue.  The tab also allows you to preview the
styles, text and size you enter for the default.


ΓòÉΓòÉΓòÉ 221. Help for MLE Defaults ΓòÉΓòÉΓòÉ

To define the default characteristics of multi-line entry when created using
the Control Multi-Line menu item, the MLE tab is used.

The tab allows you to define the default styles, text and size of multi-line
entry when you add them to a dialogue.  The tab also allows you to preview the
styles, text and size you enter for the default.


ΓòÉΓòÉΓòÉ 222. Help for Push Button Defaults ΓòÉΓòÉΓòÉ

To define the default characteristics of push buttons when created using the
Control Push Button menu item, the Push Button tab is used.

The tab allows you to define the default styles, text and size of push buttons
when you add them to a dialogue.  The tab also allows you to preview the
styles, text and size you enter for the default.


ΓòÉΓòÉΓòÉ 223. Help for Radio Button Defaults ΓòÉΓòÉΓòÉ

To define the default characteristics of radio buttons when created using the
Control Radio Button menu item, the Radio Button tab is used.

The tab allows you to define the default styles, text and size of radio buttons
when you add them to a dialogue.  The tab also allows you to preview the
styles, text and size you enter for the default.


ΓòÉΓòÉΓòÉ 224. Help for Frame Defaults ΓòÉΓòÉΓòÉ

To define the default characteristics of frames when created using the Control
Frame menu item, the Frame tab are used.

The tab allows you to define the default styles and size of the frame when you
add them to a dialogue.  The tab also allows you to preview the styles and size
you enter for the default.


ΓòÉΓòÉΓòÉ 225. Help for Rectangle Defaults ΓòÉΓòÉΓòÉ

To define the default characteristics of rectangles when created using the
Control Rectangle menu item, the Rectangle tab are used.

The tab allows you to define the default styles and size of the rectangle when
you add them to a dialogue.  The tab also allows you to preview the styles and
size you enter for the default.


ΓòÉΓòÉΓòÉ 226. Help for Scroll Bars Defaults ΓòÉΓòÉΓòÉ

To define the default characteristics of horizontal scroll bars or vertical
scroll bars when created using the Control Horz. Scroll or Control Vert. Scroll
menu items, the Horz. Scroll Bar and Vert. Scroll Bar tabs are used.

Possible styles are:

     Thumb size
     Auto track
     Auto size

 The tab allows you to define the default styles and size of the scroll bars
 when you add them to a dialogue.  The tab also allows you to preview the
 styles and size you enter for the default.


ΓòÉΓòÉΓòÉ 227. Help for Spin Button Defaults ΓòÉΓòÉΓòÉ

To define the default characteristics of spin buttons when created using the
Control Spin button menu item, the Spin Button tab is used.

The tab allows you to define the default styles and size of the spin button
when you add them to a dialogue.  The tab also allows you to preview the styles
and size you enter for the default.


ΓòÉΓòÉΓòÉ 228. Help for Container Defaults ΓòÉΓòÉΓòÉ

To define the default characteristics of containers when created using the
Control Container menu item, the Container tab is used.

The tab allows you to define the default styles and size of the container when
you add them to a dialogue or window.  The tab also allows you to preview the
styles and size you enter for the default.


ΓòÉΓòÉΓòÉ 229. Help for Slider Defaults ΓòÉΓòÉΓòÉ

To define the default characteristics of sliders when created using the Control
Slider menu item, the Slider tab is used.

The tab allows you to define the default styles and size of the slider when you
add them to a dialogue or window.  The tab also allows you to preview the
styles and size you enter for the default.


ΓòÉΓòÉΓòÉ 230. Help for Value Set Defaults ΓòÉΓòÉΓòÉ

To define the default characteristics of value sets when created using the
Control Value Set menu item, the Value Set tab is used.

The tab allows you to define the default styles and size of the value set when
you add them to a dialogue or window.  The tab also allows you to preview the
styles and size you enter for the default.


ΓòÉΓòÉΓòÉ 231. Help for Notebook Defaults ΓòÉΓòÉΓòÉ

To define the default characteristics of notebooks when created using the
Control Notebook menu item, the Notebook tab is used.

The tab allows you to define the default styles and size of the notebook when
you add them to a dialogue or window.  The tab also allows you to preview the
styles and size you enter for the default.


ΓòÉΓòÉΓòÉ 232. Help for Circular Slider Defaults ΓòÉΓòÉΓòÉ

To define the default characteristics of circular sliders when created using
the Control Circular slider menu item, the Circular slider tab is used.

The tab allows you to define the default styles and size of the circular slider
when you add them to a dialogue or window.  The tab also allows you to preview
the styles and size you enter for the default.


ΓòÉΓòÉΓòÉ 233. Help for Graphic Button Defaults ΓòÉΓòÉΓòÉ

To define the default characteristics of graphic buttons when created using the
Control Graphic button menu item, the Graphic button tab is used.

The tab allows you to define the default styles and size of the graphic button
when you add them to a dialogue or window.  The tab also allows you to preview
the styles and size you enter for the default.


ΓòÉΓòÉΓòÉ 234. Help for Handwriting Defaults ΓòÉΓòÉΓòÉ

To define the default characteristics of handwriting controls when created
using the Control Handwriting menu item, the Handwriting tab is used.

The tab allows you to define the default styles and size of the handwriting
control when you add them to a dialogue or window.  The tab also allows you to
preview the styles and size you enter for the default.


ΓòÉΓòÉΓòÉ 235. Help for Sketch Defaults ΓòÉΓòÉΓòÉ

To define the default characteristics of sketch controls when created using the
Control Sketch menu item, the Sketch tab is used.

The tab allows you to define the default styles and size of the sketch control
when you add them to a dialogue or window.  The tab also allows you to preview
the styles and size you enter for the default.


ΓòÉΓòÉΓòÉ 236. Help for Text Defaults ΓòÉΓòÉΓòÉ

To define the default characteristics of text when created using the Control
Text menu item, the Text tab is used.

The tab allows you to define the default styles, text and size of text when you
add them to a dialogue.  The tab also allows you to preview the styles, text
and size you enter for the default.


ΓòÉΓòÉΓòÉ 237. Help for Delete ΓòÉΓòÉΓòÉ

The Delete dialogue allows you to delete items such as controls, resources and
menus.

Depending on the type of item you select from the Edit Delete menu, the items
will be displayed to allow you to select the ones you want to delete.

The list box will contain a list of items that you can delete.  You can select
more than one item using the extended selection list box interface.


ΓòÉΓòÉΓòÉ 238. Help for Arrange ΓòÉΓòÉΓòÉ

To arrange the display order of controls or menus, select either the Arrange
Controls or Arrange Menus on the Options pull-down.

A dialogue will be displayed showing the current controls or menu items within
a list box.  You can then select items add move them to new positions,
effectively changing the arrangement.

The list box will contain a list of items that you can arrange.  You can select
more than one item using the extended selection list box interface.


ΓòÉΓòÉΓòÉ 239. Help for Window Styles ΓòÉΓòÉΓòÉ

When creating a window or dialogue, it is necessary to select the basic styles
of the window or dialogue.

The Window Styles allows you to do this.  Depending on whether you are creating
a window or dialogue, various style options are available.


ΓòÉΓòÉΓòÉ 240. Help for Delete List ΓòÉΓòÉΓòÉ

When you select Verify on save in either the Define Design or Advanced New
Design dialogues, the Deletion Edit List dialogue will be displayed showing the
controls and resources that you have deleted from the current design.

The dialogue will allow you to prevent selected controls and resource in the
resource script from being deleted.


ΓòÉΓòÉΓòÉ 241. Help for Note Entry ΓòÉΓòÉΓòÉ

The Note Entry dialogue is used to enter or edit a note that is to be
associated with the design.

The dialogue is presented as a notebook where you can select previously entered
note entries for editing or viewing.  You can also delete entries that are no
longer needed or add new ones.


ΓòÉΓòÉΓòÉ 242. Aligning Controls ΓòÉΓòÉΓòÉ

The Alignment dialogue is used to select the alignment type for the controls
selected for aligning.

You can align the selected controls either horizontally or vertically, with
equal spacing, same size and push button alignment.

The set of tabs within the dialogue provides the five different alignment
types:

Depending on the alignment direction, the alignment options that can be
selected are:

      Alignment
      Spacing
      Size
      Push buttons
      Shift

 The order that the alignment progresses is:

   1. Auto sizing
   2. Push buttons
   3. Alignment
   4. Size
   5. Spacing
   6. Shift

 The Align push button is used to align the controls selected, whereas, the
 Cancel push button is used to cancel the alignment process.


ΓòÉΓòÉΓòÉ 243. Dialogue Unit Limits Selection Help ΓòÉΓòÉΓòÉ

The Dialogue Unit Limits Selection dialogue allows you to select display
conversions to use when you select the Display limits Tool Bar button.  Using
these conversions, Prominare Designer can display the rectangles that a given
device would translate to for the controls within the window or dialogue.  This
allows you to effectively check the controls within a window or dialogue for
errant display clipping without having to display the window or dialogue on a
display of a given type and resolution.

You may have noticed that if you have designed a dialogue using a device with a
1024 x 768 resolution, that when you have run the final application on a system
only having a 640 x 480 resolution, that some of the controls have been clipped
such that not all of the information for the control is displayed.

Prominare Designer uses these conversion factors to convert the dialogue units
of the control being displayed to the pixel count of such that the rectangle
would be shown relative to the current control.

To select an entry, you first select the entry within the Device drop down list
and then select the Set push button.

To ignore the values selected, click the mouse pointer on the Cancel push
button.


ΓòÉΓòÉΓòÉ 244. Text/ID Symbol Definition ΓòÉΓòÉΓòÉ

Through the Text/ID Symbol dialogue, you can edit the text and the symbol for
the control, dialogue or window currently selected.  Once you have made your
changes to either the text or ID/Symbol, you can click the mouse pointer on the
Update push button to cause the information to be recorded for the control,
dialogue or window.


ΓòÉΓòÉΓòÉ 245. Help for Search and Replace Dialogue ΓòÉΓòÉΓòÉ

The Search and Replace dialogue allows you to enter text to search for within
the Search entry field and the replacement text within the Replace entry field
and when you click the mouse pointer on the Replace push button will search the
resource entry and replace the searched for text.


ΓòÉΓòÉΓòÉ 246. Help for Product Information ΓòÉΓòÉΓòÉ

The Product Information is broken up into three areas: program icon and name,
copyright notice, and information area.  The program icon and name displays the
program icon along with the full program name and version number.

Below the program icon and name is the program copyright notice.

The current date and time is displayed below the program copyright notice.

To exit the About Box, click the mouse pointer on the OK push button.


ΓòÉΓòÉΓòÉ 247. Help for Define Design Dialogue ΓòÉΓòÉΓòÉ

The Define Design dialogue allows you to enter the project basename, include
header filename and the .IPF filename.

Below these entry fields, further options are found.  Through the Target OS
selections, you can select your target operating system environment as either
OS/2 or Windows.

In the Save group, you can also inform Prominare Designer to save both the
include and .IPF files.

Deletion of resource script information is controlled through the Deletion
group.  By selecting the None option, you instruct Prominare Designer to not
remove any constructs from either the resource script for items that have been
deleted from the design.  The Don't verify will cause the deleted item
constructs to be removed from both the resource script files without any
verification whereas the Verify on save will cause a list of deletion items to
be displayed before the resource script files are saved to allow you to
pre-edit the deletion list thereby allowing you to prevent certain constructs
from being deleted.

The Set push button is used to accept the values entered within the entry
fields, whereas, the Cancel push button is used to reject the values entered
and to not save the association information.


ΓòÉΓòÉΓòÉ 248. Help for Build Help Sub-Table Dialogue ΓòÉΓòÉΓòÉ

The Build Help Sub-Table dialogue allows you to edit the Help Sub-Table created
using the Help Build Help Sub-Table on the Resource pull-down menu.

The dialogue contains a list box of the control ID symbols/values found within
the window or dialogue where interaction with the user is possible.  These
controls can be:

     Action Bar Menu Item
     Sub-Menu Item
     Push Button
     Check Box
     Radio Button
     Entry Field
     List Box
     Combo Box
     Multi-Line Entry
     Spin Button
     Container
     Slider
     Value Set
     Notebook
     User Button
     Circular slider
     Graphical button
     Handwriting
     Sketch

 At the top of the dialogue is the field for the sub-table ID symbol and value.

 There is also an entry field for the Sub-Item Size.  If you plan on using
 additional IDs within the sub-table, you should change the default value from
 2 to the number of items you wish to use in each sub-table item.

 Note:  The minimum number for Sub-Item Size is 2. Prominare Designer will
        automatically set the size to 2 if the value is less than 2.

 Below the list box are fields for each sub-table item.  You enter the ID
 symbol and value for each sub-table item selected in the list box in the
 Window ID and the Panel ID entry fields.

 If you have increased the sub-item size in the Sub-Item Size entry field, you
 can enter any additional values within the Other Values entry field.

 The Change push button is used to replace the values of the selected sub-table
 item in the list box with the values contain in the Window ID, Panel ID and
 Other Values entry fields.

 The Add push button is used to accept the values entered, whereas, the Cancel
 push button is used to reject the values entered and to not add the help
 sub-table to the window or dialogue.


ΓòÉΓòÉΓòÉ 249. Help for Build Help Table Dialogue ΓòÉΓòÉΓòÉ

The Build Help Table dialogue allows you to edit the Help Table created using
the Help Build Help Table on the Resource pull-down menu.

The dialogue contains a list box of the sub-table ID symbols or values found
within the design.

At the top of the dialogue is the field for the table ID symbol and value.

Below the list box is the field for each table item.  You enter the ID symbol
and value for each table item selected in the list box in the Window ID,
Sub-Table ID and the Extended ID entry fields.

The Change push button is used to replace the values of the selected sub-table
item in the list box with the values contain in the Window ID, Sub-Table ID and
Extended ID fields.

The Add push button is used to accept the values entered within the entry
fields, whereas, the Cancel push button is used to reject the values entered
and to not add the help table to the window or dialogue.


ΓòÉΓòÉΓòÉ 250. Help for Buttons Styles Tab ΓòÉΓòÉΓòÉ

The Buttons Styles tab is used to set button types and styles.  It is also used
to set the button text, ID symbol and value.

Possible button types are:

     Push Button
     Check Box
     Auto Check Box
     Radio Button
     Auto Radio Button
     3 State
     Auto 3 State
     User Button
     Notebook button

 You can select one of the button types or you can change from one button type
 to another.

 Button options that are possible are:

     Default
     Help
     SYSCOMMAND
     No Border
     No Focus
     No Pointer Select
     Checked
     Hilighted
     Icon
     Bitmap
     Auto size
     Text
     Mini-icon

 Base styles are:

     Visible
     Tab stop
     Group
     Disabled

 Related tabs:

     Font & colors
     Bidi

 Presentation Manager Guide and Reference:

       About Button Controls
            Button Types
            Button Styles
            Default Button Behavior
            Button Notification Messages
            Button States
            Custom Buttons
       Using Button Controls
            Using Buttons in a Dialogue Window
            Using Buttons in a Client Window
            Creating Buttons with Icons and Icon/Text Combinations
       Button Control Window Processing
            Button Control Styles


ΓòÉΓòÉΓòÉ 251. Help for Combo Box Styles Tab ΓòÉΓòÉΓòÉ

The Combo Box Styles tab is used to set a combo box's style and to set the
default text, ID symbol and value.

Possible styles are:

     Simple
     Drop Down
     Drop Down List
 Other options are:

     Any
     SBCS
     DBCS
     Mixed
     Horz. Scroll

 Base styles are:

     Visible
     Tab stop
     Group
     Disabled

 Related tabs:

     Font & colors
     Bidi
     Pen

 Presentation Manager Guide and Reference:

       About Combination-Box Controls
            Combination-Box Styles
            Combination-Box Notification Code
       Using Combination-Box Controls
       Combination-Box Control Window Processing
            Combination Box Control Styles


ΓòÉΓòÉΓòÉ 252. Help for Icon Styles Tab ΓòÉΓòÉΓòÉ

The Icon tab is used to set styles, ID symbol and value.

Base styles are:

     Visible
     Tab stop
     Group
     Disabled

 Related tabs:

     Font & colors
     Bidi

 Presentation Manager Guide and Reference:

       About Static Controls
            Keyboard Focus
            Static Control Handle
            Static Control Styles
            Default Static Control Performance
       Using Static Controls
            Using Static Control in a Dialogue Window
            Using Static Control in a Client Window
       Static Control Window Processing
            Static Control Styles


ΓòÉΓòÉΓòÉ 253. Help for List Box Styles Tab ΓòÉΓòÉΓòÉ

The List Box Styles tab is used to set a list box's style and to set the ID
symbol and value.

Possible styles are:

     Multiple Selection
     User Redraw
     No Adjust Position
     Horz. Scroll
     Extended Selection

 Base styles are:

     Visible
     Tab stop
     Group
     Disabled

 Related tabs:

     Font & colors
     Bidi

 Presentation Manager Guide and Reference:

       About List Boxes
       Using List Boxes
            Creating a List-Box Window
            Using a List Box in a Dialogue Window
            Adding or Deleting an Item in a List Box
            Responding to a User Selection in a List Box
            Handling Multiple Selections
            Creating an Owner-Drawn List Item
            Default List-Box Behavior
       List Box Control Window Processing


ΓòÉΓòÉΓòÉ 254. Help for Multi-Line Entry Styles Tab ΓòÉΓòÉΓòÉ

The Multi-Line Entry Styles tab is used to set a multi-line entry's style and
to set the default text, ID symbol and value.

Possible styles are:

     Border
     Horz. Scroll
     Vert. Scroll
     Ignore Tab
     Read Only
     Word Wrap
     Disable Undo
     Limit vertical scroll

 Base styles are:

     Visible
     Tab stop
     Group
     Disabled

 Related tabs:

     Font & colors
     Bidi
     Pen

 Presentation Manager Guide and Reference:

       About Multiple-Line Entry Field Controls
            MLE Styles
            MLE Notification Codes
            MLE Text Editing
            MLE Text Formatting
            MLE Text Import and Export Operations
            MLE Cut, Copy, and Paste Operations
            MLE Search and Replace Operations
            MLE Colours
       Using Multiple-Line Entry Field Controls
            Creating an MLE
            Importing and Exporting MLE Text
            Searching MLE Text
       Multi-Line Entry Field Control Window Processing
            Button Control Styles


ΓòÉΓòÉΓòÉ 255. Help for Scroll Bar Styles Tab ΓòÉΓòÉΓòÉ

The Scroll Bar Styles tab is used to set a scroll bar's style and to set the ID
symbol and value.

Possible styles are:

     Thumb size
     Auto track
     Auto size
 The entry fields labeled Low range, High range, Visible, and Total are used in
 conjunction with the Thumb size option.

 Related tabs:

     Font & colors
     Bidi

 Presentation Manager Guide and Reference:

       About Scroll Bars
            Scroll-Bar Creation
            Scroll-Bar Notification Messages
            Scroll Bars and the Keyboard
       Using Scroll Bars
            Creating Scroll Bars
            Retrieving a Scroll-Bar Handle
            Using the Scroll-Bar Range and Position
       Scroll Bar Control Window Processing
            Scroll Bar Control Styles


ΓòÉΓòÉΓòÉ 256. Help for Statics Styles Tab ΓòÉΓòÉΓòÉ

The Statics Styles tab is used to set statics types and styles.  It is also
used to set the static's text, ID symbol and value.

Possible static types are:

     Text
     Group Box
     Icon
     Bitmap
     Sys Icon
     Autosize
     Foreground Rect
     Halftone Rect
     Background Rect
     Foreground Frame
     Halftone Frame
     Background Frame

 You can select one of the static types or you can change from one static type
 to another.

 Text style options that are possible are:

     Left Aligned
     Horz. Aligned
     Right Aligned
     Top Aligned
     Vert. Centered
     Bottom Aligned
     Word Wrap
     Halftone
     Mnemonic
     Auto size

 Base styles are:

     Visible
     Tab stop
     Group
     Disabled

 Related tabs:

     Font & colors
     Bidi

 Presentation Manager Guide and Reference:

       About Static Controls
            Keyboard Focus
            Static Control Handle
            Static Control Styles
            Default Static Control Performance
       Using Static Controls
            Using Static Control in a Dialogue Window
            Using Static Control in a Client Window
       Static Control Window Processing
            Static Control Styles


ΓòÉΓòÉΓòÉ 257. Help for Spin Button Styles Tab ΓòÉΓòÉΓòÉ

Note:  This control is only available for OS/2 1.30 and above.  You will
       require the IBM OS/2 Warp Toolkit to be able to use this option.

 The Spin Button Styles tab is used to set master and servants for spin buttons
 as well as selecting various display styles. It is also used to set the text,
 ID symbol and value.

 Possible types are:

     Master
     Servant

 You can cause the text within the spin field to be aligned in a specific way.

 Alignment options that are possible are:

     Left
     Centered
     Right

 General options that are possible are:

     All characters
     Numeric
     Read only
     No border
     Fast spin
     Zero pad

 Base styles are:

     Visible
     Tab stop
     Group
     Disabled

 Related tabs:

     Font & colors
     Bidi
     Pen

 Presentation Manager Guide and Reference:

       About Spin Button Controls
       Using Spin Button Controls
            Creating a Spin Button
       Graphical User Interface Support for Spin Button Controls
       Spin Button Control Window Processing
            Spin Button Control Styles
            Spin Button Control Data


ΓòÉΓòÉΓòÉ 258. Help for Container Styles Tab ΓòÉΓòÉΓòÉ

Note:  This control is only available for OS/2 2.0, 2.1, 2.11, Warp and above.
       You will require the IBM OS/2 Warp Toolkit to be able to use this
       option.

 The Container tab is used to set the container selection type and other
 options. It is also used to set the ID symbol and value.

 Selection types are:

     Single
     Extended
     Multiple

 General options that are possible are:

     Auto position
     Verify pointer
     Read only
     Mini record
     Mini-icons
     No control pointer

 Base styles are:

     Visible
     Tab stop
     Group
     Disabled

 Related tabs:

     Font & colors
     Bidi

 Presentation Manager Guide and Reference:

       About Container Controls
            Container Control Functionality
            Container Items
            Container Views
       Using Container Controls
            Creating a Container
            Allocating Memory for Container Records
            Allocating Memory for Container Columns
            Inserting Container Records
            Removing Container Records
            Setting the Container Control Focus
            Using Container Views
            Changing a Container View
       Graphical User Interface Support for Container Controls
            Scrolling
            Dynamic Scrolling
            Selecting Container Items
            Providing Emphasis
            Using Direct Manipulation
       Graphical User Interface Support for Container Controls
            Positioning Container Items
            Specifying Space between Container Items
            Providing Source Emphasis
            Providing Target Emphasis
            Specifying Deltas for Large Amounts of Data
            Directing Editing of Text in a Container
            Searching for Exact Text String Matches
            Specifying Container Titles
            Specifying Fonts and Colours
            Drawing Container Items and Painting Backgrounds
            Filtering Container Items
            Optimizing Cintainer Memory Usage
       Sample Code for Container Controls
            Container Application Sample Code
       Container Control Window Processing
            Container Control Styles and Selection Types
            Container Control Data


ΓòÉΓòÉΓòÉ 259. Help for Slider Styles Tab ΓòÉΓòÉΓòÉ

Note:  This control is only available for OS/2 2.0, 2.1, 2.11, Warp and above.
       You will require the IBM OS/2 Warp Toolkit to be able to use this
       option.

 The Slider Styles tab is used to select the slider orientation, button
 placement and home position. It is also used to set the ID symbol and value.

 Orientation can be:

     Horizontal
     Vertical

 Shaft offset can be:

     Center
     Bottom
     Top
     Left
     Right

 Button placement can be:

     Bottom
     Top
     Left
     Right

 Home position can be:

     Bottom
     Top
     Left
     Right

 General options are:

     Snap to increment
     Owner draw
     Read only
     Ribbon strip

 Primary scale can be:

     Scale 1
     Scale 2

 Base styles are:

     Visible
     Tab stop
     Group
     Disabled

 Related tabs:

     Font & colors
     Bidi

 Presentation Manager Guide and Reference:

       About Slider Controls
            Linear Sliders
            Circular Sliders
       Using Slider Controls
            Creating a Linear Slider
            Retrieving Data for a Selected Slider Values
            Creating a Circular Slider
            Circular Slider Sample
       Graphical User Interface Support for Slider Controls
            Slider Navigation Techniques
       Slider Control Window Processing
            Slider Control Styles


ΓòÉΓòÉΓòÉ 260. Help for Value Set Styles Tab ΓòÉΓòÉΓòÉ

Note:  This control is only available for OS/2 2.0, 2.1, 2.11, Warp and above.
       You will require the IBM OS/2 Warp Toolkit to be able to use this
       option.

 The Value Set Styles tab is used to display type for the value set and other
 general options. It is also used to set the ID symbol and value.

 Default items can be:

     Bitmap
     Icon
     Text
     Color info
     Color indices

 General options are:

     Border
     Item border
     scale bitmaps
     Right to left ordering

 Base styles are:

     Visible
     Tab stop
     Group
     Disabled

 Related tabs:

     Font & colors
     Bidi

 Presentation Manager Guide and Reference:

       About Value Set Controls
            Value Set Styles
       Using Value Set Controls
            Creating a Value Set
            Retrieving Data for Selected Value Set Items
            Arranging Value Set Items
       Graphical User Interface Support for Value Set Controls
            Value Set Navigation Techniques
       Enhancing Value Set Controls Performance and Effectiveness
            Dynamic Resizing and Scrolling
       Value Set Control Window Processing
            Value Set Control Styles
            Value Set Control Data


ΓòÉΓòÉΓòÉ 261. Help for Notebook Styles Tab ΓòÉΓòÉΓòÉ

Note:  This control is only available for OS/2 2.0, 2.1, 2.11, Warp and above.
       You will require the IBM OS/2 Warp Toolkit to be able to use this
       option.

 The Notebook tab is used to set tab orientation, tab type and binding. It is
 also used to set the ID symbol and value.

 Backpage orientation can be:

     Bottom right
     Bottom left
     Top right
     Top left

 Major tab side can be:

     Bottom
     Top
     Left
     Right

 Tab type can be:

     Square
     Rounded
     Polygon

 Text display options are:

     Left
     Center
     Right

 Binding options are:

     Spiral
     Solid

 Base styles are:

     Visible
     Tab stop
     Group
     Disabled

 Related tabs:

     Font & colors
     Bidi

 Note:  The following styles are valid only for OS/2 Warp Version 4.0 and
        above.

 OS/2 Warp Version 4.0 styles:

     Tabbed
     Original
     Button area

 Presentation Manager Guide and Reference:

       About Notebook Controls
            Notebook Styles
       Using Notebook Controls
            Notebook Creation
            Changing Notebook Styles
            Inserting Notebook Pages
            Setting and Querying Page Information
            Associating Application Page Windows with Notebook Pages
            Deleting Notebook Pages
            Notebook Colours
       Graphical User Interface Support for Notebook Controls
            Notebook Navigation Techniques
       Enhancing Notebook Controls Performance and Effectiveness
            Dynamic Resizing and Scrolling
            Tab Painting and Positioning
       Button Control Window Processing
            Button Control Styles
            Default Colours


ΓòÉΓòÉΓòÉ 262. Help for Circular Slider Styles Tab ΓòÉΓòÉΓòÉ

Note:  This control is only available for OS/2 2.0, 2.1, 2.11, Warp and above
       and requires the IBM OS/2 Warp toolkit to be able to use this option.

 The Circular Slider Styles tab is used to set the display type and general
 options of the MMPM/2 circular slider. It is also used to set the text, ID
 symbol and value.

 Default items can be:

     Mid-point tick
     No value buttons
     No dial numbers
     No dial text
     Direct manipulation
     360┬░ scroll range
     Proportional ticks
     No ticks
     Circular value

 Base styles are:

     Visible
     Tab stop
     Group
     Disabled

 Related tabs:

     Font & colors
     Bidi

 Presentation Manager Guide and Reference:

       About Slider Controls
            Linear Sliders
            Circular Sliders
       Using Slider Controls
            Creating a Linear Slider
            Retrieving Data for a Selected Slider Values
            Creating a Circular Slider
            Circular Slider Sample
       Graphical User Interface Support for Slider Controls
            Slider Navigation Techniques
       Circular Slider Control Window Processing
            Circular Slider Control Styles


ΓòÉΓòÉΓòÉ 263. Help for Sketch Styles Tab ΓòÉΓòÉΓòÉ

Note:  This control is only available for Pen for OS/2 and requires the Pen for
       OS/2 toolkit to be able to use this option.

 The Sketch Styles tab is used to set the display type and general options of
 the Pen for OS/2 sketch control. It is also used to set the text, ID symbol
 and value.

 Default items can be:

     Border
     3D border

 Base styles are:

     Visible
     Tab stop
     Group
     Disabled

 Related tabs:

     Font & colors
     Bidi

 Pen for OS/2 Programming Guide and Reference:

       Using the Sketch Control
            How the Sketch Control Operates
            Using Sketch Controls in a Dialogue Window
            Using Sketch Controls in a Client Window
            Using Control Style Bits
            Sending Window Messages
            Receiving Notification Messages from the Sketch Control
            Sample Programs
                 Sketch/Handwriting Sample Program (APPLIC)
                 Sketch Control Sample (SKETSAMP)


ΓòÉΓòÉΓòÉ 264. Help for User Defined Temporary Control Tab ΓòÉΓòÉΓòÉ

The User Defined Temporary Control tab is used to define a custom control
commonly none as User Defined Controls. control ID and value.

Through the dialogue, you enter the classname of the control, the text and ID.

Base styles are:

     Visible
     Tab stop
     Group
     Disabled

 Related tabs:

     Font & colors
     Bidi


ΓòÉΓòÉΓòÉ 265. Help for Popup Menu Dialogue ΓòÉΓòÉΓòÉ

The Popup Menu dialogue is used to set the ID for a popup menu.

The Enter push button is used to accept the values entered within the entry
fields, whereas, the Cancel push button is used to reject the values entered
and to not change the popup menu values.

Presentation Manager Guide and Reference:

       Menus
            About Menus
                 Menu Bar and Pull-Down Menus
                 Pop-Up Menus
                 System Menu
                 Menu Items
                 Menu Access
            Using Menus
                 Defining Menu Items in a Resource File
                 Including a Menu Bar in a Standard Window
                 Creating a Pop-up Menu
                 Adding a Menu to a Dialogue Window
                 Accessing the System Menu
                 Setting and Querying Menu-Item Attributes
                 Adding and Deleting Menu Items
                 Creating a Custom Menu Item
            Menu Control Window Processing
                 Menu Control Styles
                 Menu Item Styles
                 Menu Item Attributes


ΓòÉΓòÉΓòÉ 266. Help for Prominare Designer Default Usage Dialogue ΓòÉΓòÉΓòÉ

The Prominare Designer Default Usage is used configure aspects of how you want
to use Prominare Designer.

Five tabs are provided:

     Paths
     Extensions
     Options
     Auto Label
     Mouse

 The Set push button is used to accept the value entered within the entry
 field, whereas, the Cancel push button is used to reject the values entered
 and to not change the default path.


ΓòÉΓòÉΓòÉ 267. Help for Default Creation Options Dialogue ΓòÉΓòÉΓòÉ

The Default Creation Options dialogue is used to set the defaults when creating
a new window or dialogue.

The dialogue also allows you to set the default characteristics for the
following types of controls:

     Push Button
     Check Box
     Radio Button
     Horz. Scroll
     Vert. Scroll
     List Box
     Entry Field
     Group Box
     Text
     Frame
     Rectangle
     Combo Box
     Multi-Line Entry
     Notebook
     Container
     Slider
     Value set
     Circular slider
     Graphic button
     Handwriting
     Sketch

 Note:  The Circular slider and Graphic button tabs will only be displayed if
        MMPM/2 has been installed on your system.

 Note:  The Handwriting and Sketch tabs will only be displayed if Pen for OS/2
        has been installed on your system.

 The Enter push button is used to accept the values entered within the entry
 fields, whereas, the Cancel push button is used to reject the values entered
 and to not change the defaults.


ΓòÉΓòÉΓòÉ 268. Help for Dialogue/Window Tab ΓòÉΓòÉΓòÉ

The Dialogue/Window tab is used to set the defaults when creating a new window
or dialogue.

For example, if you are creating dialogues most of time, and the dialogues you
create have a title bar along with a system menu, you can, through this
dialogue, set the defaults such that a dialogue containing a title bar and
system menu is created each time you use the New Window/Dialogue on the Edit
pull-down menu.

The basic window/dialogue default types that you can set are:

     Parent Window
     Child Window
     Dialogue

 The ID value display type that you can set are:

     Decimal
     Hex

 The basic positioning options that you can set are:

     Window
     Screen
     Mouse

 The basic styles for the window or dialogue that you can set are:

     Title Bar
     System Menu
     Horz Scroll Bar
     Vert Scroll Bar
     Visible
     Size Border
     Border
     Dialogue Frame
     System Modal
     Menu
     Min Button
     Max Button
     Hide Button
     Accelerators
     Standard
     Shell position
     Auto icon
     DBCS status
     Close button
     Task list


ΓòÉΓòÉΓòÉ 269. Help for CUA Compliance Dialogue ΓòÉΓòÉΓòÉ

The CUA Compliance is used to set the CUA Compliance rules which Prominare
Designer will use to check windows, dialogues and controls for compliance.

By selecting a compliance rule, Prominare Designer will use the rule when
creating or editng a window, dialogue or control.

The following rules can be set:

      Action Bars
           Numbered menus
           Capitalization
           Mnemonic selection
           Ordering
           Double-words
      Pull-downs
           Numbered menus
           Capitalization
           Mnemonic selection
      Dialogues
           System Menu
      Controls
           Push Button ellipsis
           Push Button mnemonic
           Capitalization
           Mnemonic selection

 The Enter push button is used to accept the values rules selected whereas, the
 Cancel push button is used to reject the any selections made and to not change
 the current rules.


ΓòÉΓòÉΓòÉ 270. Help for Delete Dialogue ΓòÉΓòÉΓòÉ

The Delete dialogue is used to select items to delete from the current window
or dialogue.

Depending on the menu item selected from the Delete on the Edit pull-down menu,
the dialogue will display within the list box the IDs and types.

You can then select the item or items to delete by clicking the mouse on the
item(s) within the list box.  You can select more than one item using the
extended selection list box interface.

Above the list box, an information area will display the number of items
selected.

The Delete push button is used to delete the selected items within the list
box, whereas, the Cancel push button is used to cancel the delete request.


ΓòÉΓòÉΓòÉ 271. Help for Design Errors Dialogue ΓòÉΓòÉΓòÉ

The Design Errors dialogue will allow you to see exactly areas within your
design that are problems with regards to resources.  These problems can be as
simple as a file missing, like that of an icon, or as severe as two resources
having the same ID value.

The dialogue consists of a list box and display fields.  Within the list box
will be the errors detected.  When you select an item within the list box the
display fields will display information regarding the error.  From this
information, you will be able to make the correction.

The dialogue is modeless in nature thereby allowing you to correct multiple
errors with the list remaining visible.  When you click the mouse pointer on
the Exit push button, the dialogue will be hidden from view and you will have
to double click button 2 of the mouse on the Scan errors Tool Bar button a
subsequent time to see if any errors remain.

The dialogue will also be displayed if you have depressed the Scan errors Tool
Bar button and you are saving your design to disk.  Any errors detected will be
displayed within the dialogue and the .RC or .RES file will not be saved.


ΓòÉΓòÉΓòÉ 272. Help for Design Notes Tab ΓòÉΓòÉΓòÉ

You enter design notes through the Design Notes notebook. You can enter the
note title, author and note entry through the entry fields provided in the tab.

To add a new note entry, you only need to simply click the mouse pointer on the
Add push button.  This will cause a new tab to be added to the notebook.  You
can then enter in the necessary information within this new page.

Deleting a note entry only involves selecting the tab that contains the entry
and then clicking the mouse pointer on the Delete push button.


ΓòÉΓòÉΓòÉ 273. Design Notes Dialogue ΓòÉΓòÉΓòÉ

You enter design notes through the Design Notes dialogue. You can enter the
note title, author and note entry through the entry fields provided in the
dialogue.

To add a new note entry, you only need to simply click the mouse pointer on the
Add push button.  This will cause a new tab to be added to the notebook.  You
can then enter in the necessary information within this new page.

Deleting a note entry only involves selecting the tab that contains the entry
and then clicking the mouse pointer on the Delete push button.


ΓòÉΓòÉΓòÉ 274. Help for Notes Tab ΓòÉΓòÉΓòÉ

You enter design notes through the Design Notes notebook. You can enter the
note title, author and note entry through the entry fields provided in the tab.

To add a new note entry, you only need to simply click the mouse pointer on the
Add push button.  This will cause a new tab to be added to the notebook.  You
can then enter in the necessary information within this new page.

Deleting a note entry only involves selecting the tab that contains the entry
and then clicking the mouse pointer on the Delete push button.


ΓòÉΓòÉΓòÉ 275. Help for Distribution Tab ΓòÉΓòÉΓòÉ

The Distribution tab is used to select the name and location for both .RC and
.RES files.  Through the list box you can select the name and location for the
resource script file and the binary resource file where the window or dialogue,
menu, acclerator and help tables are to be placed.

The values that you enter can then be selected through the tabs.


ΓòÉΓòÉΓòÉ 276. Help for Accelerator Table Resource Dialogue ΓòÉΓòÉΓòÉ

The Accelerator Table Resource dialogue is used to define, edit and delete
accelerators defined within the window you are current designing.

The dialogue will display display three list boxes.  The left list box contains
the defined accelerators.  The center list box contains a list of valid
accelerator keys.  The right list box contains a list of IDs used within the
current design.

When you select a defined accelerator ID from the left list box, the ID and
value entry fields will be completed at the bottom of the dialogue. Also, the
key options for the defined acclerator will be set.

The key options that are possible:

     Virtual Key
     Scan Code
     Char
     Help
     Alt
     Ctrl
     Shift
     SYSCOMMAND

 You can select a different accelerator key from the middle list box and/or you
 can select another ID value from the right list box.

 You can also change the key options as required.

 The Save push button is used to accept the values entered within the entry
 fields, whereas, the Cancel push button is used to reject the values entered
 and to not create the help menu.


ΓòÉΓòÉΓòÉ 277. Help for Association Table Dialogue ΓòÉΓòÉΓòÉ

The Association Table dialogue allows you to edit or define association
information for the application or DLL you are designing.

You can enter the association name, extension and icon file through the entry
fields provided within the dialogue.  You can also define the usage of
associated icons through the options:

      Default owner
      Unchangeable
      Reuse icon

 To add an item within the association table, you need to complete the areas of
 the entry fields that are applicable for the association item and then click
 the mouse pointer on the Add push button.  To edit an item, simply click the
 mouse pointer on the item you wish to edit within the list box below the entry
 fields.  The values for the item selected will be placed within the entry
 fields after which you can change the values before clicking the mouse pointer
 on the Change button.

 To delete an entry within the list box, simply click the mouse pointer on the
 item within the list and then click the mouse pointer on the Delete push
 button.

 The Save push button is used to accept the values entered within the entry
 fields, whereas, the Cancel push button is used to reject the values entered.


ΓòÉΓòÉΓòÉ 278. Help for Resource Table Dialogue ΓòÉΓòÉΓòÉ

The Resource Table dialogue allows you to enter, edit or delete a resource
definition for character tables, font directories, key tables and virtual key
tables. The type will have been determined through the menu you used before the
dialogue was invoked.

You need to enter or select a file that contains the table information, the ID
and value.

You can define the memory options for the resource through the Options group.
These include:

     Default
     Moveable
     Preload
     Discard

 You can add the item to the table list by simply clicking the mouse pointer on
 the Add push button.  If you are editing an item that you have selected from
 the list box, you can have the changes recorded by clicking the mouse pointer
 on the Change push button.  Finally, if you want to delete a defined entry,
 simply select the item from the list box and click the mouse pointer on the
 Delete push button.

 The Save push button is used to accept the values entered within the entry
 fields, whereas, the Cancel push button is used to reject the values entered.


ΓòÉΓòÉΓòÉ 279. Help for Bitmap, Font, Icon and Pointer Resources Dialogue ΓòÉΓòÉΓòÉ

The Bitmap, Font, Icon and Pointer Resources dialogue allows you to define,
edit and delete a bitmap, font, icon or pointer definition.

You define the resource you wish to enter through the Type group box.  It
contains the following options:

      Bitmap
      Default icon
      Font
      Icon
      Pointer

 You can define the memory options for the resource through the Options group.
 These include:

     Default
     Moveable
     Preload
     Discard

 To edit an item listed within the listbox, select the item which will cause
 the entry fields to display the defined information for the resource.

 The type group box will set the appropriate radio button for the type of
 resource selected.  You can select a different radio button if you want to
 change the type.

 Two list boxes allow you to locate the resource on your hard disk.  When you
 select a file from the list box, the Filename entry field will be completed
 with the filename for the resource selected.

 You can change the ID symbol and value within the fields along with the
 filename of the resource.

 The Save push button is used to accept the values entered within the entry
 fields, whereas, the Cancel push button is used to reject the values entered.


ΓòÉΓòÉΓòÉ 280. Help for Help Table Items Dialogue ΓòÉΓòÉΓòÉ

The Help Table Items dialogue allows you to define, edit and delete the Help
Table Items for the window or dialogue.

The dialogue contains two list boxes.  The first list box contains a list of
help tables defined for the window or dialogue.  The second list box contains a
list of help table items defined.

Below the list boxes are fields for each table item.  When you select a help
table item, the values for that item will be displayed within the entry fields.

You enter the ID symbol and value for each table item selected in the list box
in the Window ID, Sub-Table ID and the Extended ID fields.

The Save push button is used to accept the values entered within the entry
fields, whereas, the Cancel push button is used to reject the values entered.


ΓòÉΓòÉΓòÉ 281. Help for PMCX/Temporary Control Definition Dialogue ΓòÉΓòÉΓòÉ

The PMCX/Temporary Control Definition dialogue is used to edit the location of
a custom control contained in a dynamic-link library or to the delete the
availability of a temporary or custom control.

The list boxes allow you to select the location where the dynamic-link library
for the control that you will define.

You must designate the type of control you are defining.  Two radio buttons
allow the following options:

     Private
     Temporary

 When you select the temporary option, you can define a temporary control where
 the name you enter is used as the classname for the control.

 The Add push button is used to add the control, whereas, the Change push
 button is used to change the value of the custom user defined control.

 The Delete push button is used to delete the temporary or custom control from
 use within Prominare Designer.

 Note:  It does not delete the custom control dynamic-link library from your
        system.


ΓòÉΓòÉΓòÉ 282. Help for Custom Resource Dialogue ΓòÉΓòÉΓòÉ

The Custom Resource dialogue is used to define, edit or delete previously
entered custom resource definitions.

The dialogue displays a list of custom resources defined within the window or
dialogue you are designing.

When you select an item contained within the list box, the fields will be
completed with the information for that resource.

You can then change the Resource Type ID, ID symbol or Value.

The filename of the resource can be changed within the Filename entry field.

Two list boxes allow you to locate the resource on your hard disk.  When you
select a file from the list box, the Filename entry field will be completed
with the filename for the resource selected.

The Save push button is used to accept the values entered within the entry
fields, whereas, the Cancel push button is used to reject the values entered.


ΓòÉΓòÉΓòÉ 283. Help for Search Dialogue ΓòÉΓòÉΓòÉ

The Search dialogue is used to search for an ID symbol or text within the
dialogues or windows within your design.

The dialogue provides a multiple-line entry field in which you can enter the
text to search for labeled Text and an entry field labeled Symbol in which you
can enter the symbol to search for.

Note:  You can only search for text or a symbol not both.

 If you selected Case sensitive check box, the search will ensure that matches
 will be exact in case whereas when you don't have the check box selected, any
 matches in the letters will be permitted.

 The Search help tables check box can be used to have the search performed
 through help tables as well.  This can be useful when search for an ID symbol.

 When a match occurs, the dialogue or window that contains the match will be
 displayed and the control that the match occurred in will be selected. If the
 match occurs within a menu or accelerator table, the window or dialogue will
 still be displayed, but a message box will also be displayed denoting that the
 match occurred within the menu or accelerator table.

 When a match occurs within a help table or sub-table,the window or dialogue
 will still be displayed, but a message box will also be displayed denoting
 that the match occurred within the help table or sub-table.

 When you have entered the text or symbol to search for, you can then click the
 mouse pointer on the Search push button.  To cancel the search request, simply
 click the mouse pointer on the Cancel push button.


ΓòÉΓòÉΓòÉ 284. Help for String Resource Dialogue ΓòÉΓòÉΓòÉ

The String Resource dialogue is used to edit previously entered messages and
strings within a window or dialogue.

The dialogue displays a list of messages and strings defined within the window
or dialogue you are designing.

When you select an item contained within the list box, the fields will be
completed with the information for that resource.

You can then change the Text, ID symbol or Value.

The Save push button is used to accept the values entered within the entry
fields, whereas, the Cancel push button is used to reject the values entered.


ΓòÉΓòÉΓòÉ 285. Help for Entry Field Styles Tab ΓòÉΓòÉΓòÉ

The Entry Styles tab is used to set an entry field's style and to set the
default text, ID symbol and value and the input size.

Possible styles are:

     Left Aligned
     Centered
     Right Aligned
     Auto Horz. Scroll
     Margin
     Auto Tab
     Read Only
     Command
     Unreadable
     Any
     SBCS
     DBCS
     Mixed
     Auto size

 Base styles are:

     Visible
     Tab stop
     Group
     Disabled

 Related tabs:

     Font & colors
     Bidi
     Pen

 Presentation Manager Guide and Reference:

       About Entry Field Controls
            Entry-Field Styles
            Entry-Field Notification Codes
            Default Entry-Field Behavior
            Entry-Field Text Editing
            Entry-Field Control Copy and Paste Operations
            Entry-Field Text Retrieval
       Using Button Controls
            Creating an Entry Field in a Dialogue Window
            Creating an Entry Field in a Client Window
            Changing the Default Size of an Entry Field
            Retrieving Text From an Entry Field
       Entry Field Control Window Processing
            Entry Field Control Styles


ΓòÉΓòÉΓòÉ 286. Help for Paste From File Dialogue ΓòÉΓòÉΓòÉ

The Paste From File dialogue is used to select the items from a selected design
file that are to be pasted into the current design that you are working on.

The notebook within the dialogue contains four tabs:

     Dialogues/Window
     Resources
     Strings/Messages
     Association Table

 You select the items you wish to paste into the current design from the items
 listed on each tab.  You can select more than one item in each list.

 The Paste push button is used to paste the items selected within the lists
 into the current design, whereas, the Cancel push button is used to reject the
 values entered and to not change the default path.


ΓòÉΓòÉΓòÉ 287. Help for Help Sub-Table Item Dialogue ΓòÉΓòÉΓòÉ

The Help Sub-Table Item dialogue allows you to edit a Help Sub-Table contained
within the current window or dialogue you are designing.

Two list boxes are displayed.  The first one contains a list of Help Sub-Tables
defined within the window or dialogue.  The second list box contains the actual
Help Sub-Table Items defined.

Below the list boxes are entry fields for each sub-table item.  You enter the
ID symbol and value for each sub-table item selected in the list box in the
Window ID and the Panel ID fields.

If you have increased the sub-item size in the Sub-Item Size entry field, you
can enter any additional values within the Other Values entry field.

The SAve push button is used to accept the values entered within the entry
fields, whereas, the Cancel push button is used to reject the values entered
and to not change the help sub-table.


ΓòÉΓòÉΓòÉ 288. Help for Help Sub-Table Dialogue ΓòÉΓòÉΓòÉ

The Help Sub-Table dialogue allows you to edit a Help Sub-Table defined within
the window or dialogue you are currently designing.

A list will be displayed containing sub-tables defined within the window or
dialogue you are working with.

After selecting an item within the list box, the fields will be completed with
the sub-table information from which you can edit.

The fields are:

     Table ID
     Sub-Item Size

 Note:  The minimum number for Sub-Item Size is 2. Prominare Designer will
        automatically set the size to 2 if the value is less than 2.

 The Save push button is used to accept the values entered within the entry
 fields, whereas, the Cancel push button is used to reject the values entered
 and to not change the help sub-table item.


ΓòÉΓòÉΓòÉ 289. Help for Help Table Dialogue ΓòÉΓòÉΓòÉ

The Help Table dialogue allows you to edit a Help Table defined within the
window or dialogue you are currently designing.

A list will be displayed containing tables defined within the window or
dialogue you are working with.

After selecting an item within the list box, the fields will be completed with
the sub-table information from which you can edit.

The field is:

     Table ID

 The Save push button is used to accept the values entered within the entry
 fields, whereas, the Cancel push button is used to reject the values entered
 and to not change the help table item.


ΓòÉΓòÉΓòÉ 290. Help for Dialogue Unit Definition Dialogue ΓòÉΓòÉΓòÉ

The Dialogue Unit Definition dialogue allows you to define and edit display
conversions.  Using these conversions, Prominare Designer can display the
rectangles that a given device would translate to for the controls within the
window or dialogue.  This allows you to effectively check the controls within a
window or dialogue for errant display clipping without having to display the
window or dialogue on a display of a given type and resolution.

You may have noticed that if you have designed a dialogue using a device with a
1024 x 768 resolution, that when you have run the final application on a system
only having a 640 x 480 resolution, that some of the controls have been clipped
such that not all of the information for the control is displayed.

This dialogue allows you to register as many different devices that you have
knowledge of along with their different display characteristics and the base
conversion values.

Prominare Designer uses these conversion factors to convert the dialogue units
of the control being displayed to the pixel count of such that the rectangle
would be shown relative to the current control.

To add a new entry to the list provided, simply enter the name of the device
(it must be unique otherwise an existing entry will be selected), and press the
Enter key.  You will be notified through a message box that you are adding a
new entry.  Clicking the mouse pointer on the Yes push button will cause the
new entry to be added, conversely, clicking the mouse pointer on the No push
button will cause the name entered to be discarded.

After the previous values within the entry fields have been cleared, you can
enter the values for the device.  The utility DFM.Exe is provided for you to
determine the specific factor for a given display type and resolution.  This
utility is found within your PD5 subdirectory and can be run from any OS/2 2.x
or Warp compatible system.  It will display the current resolution, colors and
factors within a small message window. You use the factors displayed within the
window within this dialogue.

You can determine easily the values for the device you are currently using by
simply clicking the mouse pointer on the Defaults push button.  The values for
the current display will be entered into the entry fields for you.

To delete an entry, you first select the entry within the Device drop down list
and then click the mouse pointer on the Delete push button.

To save the values entered or changed, click the mouse pointer on the Save push
button.  To ignore the values entered or changed, click the mouse pointer on
the Cancel push button.


ΓòÉΓòÉΓòÉ 291. Help for Resource Distribution Definition Dialogue ΓòÉΓòÉΓòÉ

The Resource Distribution Definition dialogue allows you to define the location
and filenames for the .RC and .RES files that you can use to save various items
of your design under.

Since Prominare Designer allows for distributed resources, you can have the
dialogues of the design placed within one directory and the help files within
another.

The Resource Distribution Definition dialogue consists of a notebook containing
two tabs: .RC/.RES and Tables.

Through the .RC/.RES tab you can define the resource script file location and
name along with the .RES file location and name that can be selected through
the Distribution dialogue for dialogues, menu and accelerator tables, and help
tables.

The Tables tab is used to define the the filename and locations for the .RC and
.RES files for the association, message and string tables.

Through the Locate... push button, you locate a .RC or .RES file to use within
an entry field.  If you are within an entry filed intended for a .RC file, the
Locate dialogue will allow you to locate .RC files within your system.

Conversely, if you are within an entry field intended for a .RES file, the
Locate dialogue will allow you to locate .RES files within your system.


ΓòÉΓòÉΓòÉ 292. Help for .RC/.RES Tab ΓòÉΓòÉΓòÉ

The .RC/.RES tab is used to enter the name and location for both .RC and .RES
files.  Through the entry field labeled .RC you can enter the name and location
for the resource script file.  The entry field labeled .RES is used for the
name and location of the .RES file when such a file is produced through
Prominare Designer.

You need to complete both of the entry fields before you click the mouse
pointer on the Add push button.

To change an entry, you can select the item from the list box and then make the
changes within the entry fields before clicking the mouse pointer on the Change
push button.

You can delete an entry by selecting the desired item within the list box and
then click athe mouse pointer on the Delete push button.

The values that you enter can then be selected through the Distribution tab.


ΓòÉΓòÉΓòÉ 293. Help for Tables Tab ΓòÉΓòÉΓòÉ

The Tables tab is used to enter the name and location for both .RC and .RES
files for the association, message and string table resource files.  Through
the entry fields labeled .RC you can enter the name and location for the
resource script file.  The entry fields labeled .RES is used for the name and
location of the .RES file when such a file is produced through Prominare
Designer.


ΓòÉΓòÉΓòÉ 294. Help for Distribution Tab ΓòÉΓòÉΓòÉ

The Distribution tab is used to select the location where .RC or .RES that is
to contain the the window or dialogue or dialogue you are designing is to be
placed.

The tab contains a further set of four tabs: Window, Menu, Accelerator table
and Help tables.

If you are designing a dialogue it will contain two tabs: Window and Help
tables.

The current distribution path will be displayed above the list box within the
tabs.  You can change the path by selecting an entry within the list box.

You can instantly define the path or location where the .RC or .RES file is to
be located by simply clicking the mouse pointer on the Definitions... push
button to display the Resource Distribution Definition dialogue.


ΓòÉΓòÉΓòÉ 295. Help for Distribution Tab ΓòÉΓòÉΓòÉ

The Distribution tab is used to select the location where .RC or .RES that is
to contain the the window or dialogue or dialogue you are designing is to be
placed.

The tab contains a further set of four tabs: Window, Menu,Accelerator table and
Help tables.

If you are designing a dialogue it will contain two tabs: Window and Help
tables.

The current distribution path will be displayed above the list box within the
tabs.  You can change the path by selecting an entry within the list box.

You can instantly define the path or location where the .RC or .RES file is to
be located by simply clicking the mouse pointer on the Definitions... push
button to display the Resource Distribution Definition dialogue.


ΓòÉΓòÉΓòÉ 296. Help for Open Dialogue ΓòÉΓòÉΓòÉ

The Open dialogue allows you to open a .PDF file for editing within Prominare
Designer.

Two list boxes are found within the dialogue: one for the directory list and
one for files.

You can select a different drive or subdirectory by double clicking the mouse
pointer on the entry desired.

To select the file to open, double click on the desired file within the files
list box or enter the filename within the entry field at the top of the
dialogue.

The Open push button is used to open the file listed within the entry field,
whereas, the Cancel push button is used to cancel the values the open request.


ΓòÉΓòÉΓòÉ 297. Help for Import Dialogue ΓòÉΓòÉΓòÉ

The Import dialogue allows you to import an OS/2 or Windows 3.1 .RES, .RC file
for editing within Prominare Designer.

You can also extract the resources from a .EXE or .DLL file.

Two list boxes are found within the dialogue: one for the directory list and
one for files.

You can select a different drive or subdirectory by double clicking the mouse
pointer on the entry desired.

To select the file to open, double click on the desired file within the files
list box or enter the filename within the entry field at the top of the
dialogue.

You need to select either the OS/2 or Windows 3.1 radio button before clicking
on the Open push button or double clicking the mouse pointer on the file within
the list box.

Note:  It is very important that you select the correct radio for the resource
       file type you are trying to import since the formats are very similar
       but slightly different in some areas.  This may cause importing
       problems.

 The include path from the Prominare Designer Default Usage dialogue for the
 resource script type selected will be placed within the entry field labeled
 Include.  If you want to add additional include path information to the entry
 field, you can enter it directly or you can used the Locate path... push
 button to have the Locate Path dialogue displayed from which you can select
 the include path to use.

 The Open push button is used to open the file listed within the entry field,
 whereas, the Cancel push button is used to cancel the values the open request.


ΓòÉΓòÉΓòÉ 298. Help for File Merge Dialogue ΓòÉΓòÉΓòÉ

The File Merge dialogue allows you to open a .PDF file for merging within the
current design.

Two list boxes are found within the dialogue: one for the drive/directory list
and one for files.

You can select a different drive or subdirectory by double clicking the mouse
pointer on the entry desired.

To select the file to open. double click on the desired file within the files
list box or enter the filename within the entry field at the top of the
dialogue.

The Open push button is used to open the file listed within the entry field,
whereas, the Cancel push button is used to cancel the values the open request.


ΓòÉΓòÉΓòÉ 299. Help for Include Open Dialogue ΓòÉΓòÉΓòÉ

The Include Open dialogue allows you to open a .H file for used within
Prominare Designer.

Two list boxes are found within the dialogue: one for the drive/directory list
and one for files.

You can select a different drive or subdirectory by double clicking the mouse
pointer on the entry desired.

To select the file to open. double click on the desired file within the files
list box or enter the filename within the entry field at the top of the
dialogue.

The Open push button is used to open the file listed within the entry field,
whereas, the Cancel push button is used to cancel the values the open request.


ΓòÉΓòÉΓòÉ 300. Help for Save As Dialogue ΓòÉΓòÉΓòÉ

The Save As dialogue is used to save an untitled

The dialogue is also used to inform Prominare Designer of any additional files
that you would like saved.

The dialogue contains two tabs:

      Location
      Details

 The Save push button is used to save the design and other files. whereas, the
 Cancel push button is used to cancel the save request.


ΓòÉΓòÉΓòÉ 301. Help for Location Tab ΓòÉΓòÉΓòÉ

The Location tab is used to specify the name to save the design file under.

The tab is also used to inform Prominare Designer of any additional files that
you would like saved.  These additional files are:

     Include File
     .IPF File

 The tab is also allows you to specify the format for the saving of the
 resources.  These are:

     .RES format
     .RC format
     Object format

 You can select the location or filename through the list boxes.


ΓòÉΓòÉΓòÉ 302. Help for Details Tab ΓòÉΓòÉΓòÉ

The Details tab is used to save information such as History, Comments and
Version.


ΓòÉΓòÉΓòÉ 303. Help for Save Window/Dialogue Design Dialogue ΓòÉΓòÉΓòÉ

The File Save Window/Dialogue Design dialogue allows you to save the window or
dialogue displayed as a pre-designed window or dialogue that can be selected
through the Pre-designed option in the New Dialogue/Window dialogue.

A pre-designed window or dialogue is a single entity that when selected through
the Pre-designed option in the New Dialogue/Window dialogue allows you to use
the window or dialogue within the design you are working on thereby preventing
you from having to create the same window or dialogue all over again.

You enter the name under which the window or design should be saved within the
pre-designed library.

The Save push button is used to save the the window or dialogue, whereas, the
Cancel push button is used to cancel the save request.


ΓòÉΓòÉΓòÉ 304. Help for Delete Pre-designed Window/Dialogue Dialogue ΓòÉΓòÉΓòÉ

The Delete Pre-designed Window/Dialogue dialogue allows you to delete a
pre-designed window or dialogue.

A pre-designed window or dialogue is a single entity that when selected through
the Pre-designed menu item allows you to use the window or dialogue within the
design you are working on thereby preventing you from having to create the same
window or dialogue all over again.

You can select the windows or dialogues that you wish to delete from the list
box.

The Delete push button is used to delete the selections, whereas, the Cancel
push button is used to cancel the delete request.


ΓòÉΓòÉΓòÉ 305. Help for Print Design Dialogue ΓòÉΓòÉΓòÉ

The Print Design function is to select the positioning of the image on the
final printed page.  You can orient it horizontally and vertically.

You can also scale the image by entering the percent scale with 100% being a
full size image.

To print the details of the dialogue or window, select the Print details check
box.  This will allow you to select the font and size to print the details in.

The Print push button is used to print the window or dialogue whereas, the
Cancel push button is used to cancel the print request.


ΓòÉΓòÉΓòÉ 306. Help for Printer Setup dialogue ΓòÉΓòÉΓòÉ

The Printer Setup dialogue allows you to select the output device to print to
and to if required, set options for the printing device.

A list of output devices will be displayed within a list box in the dialogue of
the devices you have installed through the system.

The currently selected device will be selected within the list and you can then
select a different device by clicking the mouse pointer on the required output
device.

To setup the selected device, click the mouse pointer on the Setup... push
button.  This will cause the setup dialogue for the selected output device to
be displayed thereby allowing you to tailor the output to your needs.


ΓòÉΓòÉΓòÉ 307. Help for Prominare Designer Information Dialogue ΓòÉΓòÉΓòÉ

The Prominare Designer Information dialogue will display the total number of
windows and dialogues you currently have within your design. It will also show
the time that the design file was last edited.

Information for the current window or dialogue will be displayed and will show
the total number of controls, accelerators, action bar menus, sub-menus, help
tables, sub-tables, and table items.

The dialogue will also show the distribution for the various resource elements.
It will show the location and filename where the dialogue or window, menu,
accelerators and help tables resource elements will be placed.


ΓòÉΓòÉΓòÉ 308. Help for Prominare Designer Information Dialogue ΓòÉΓòÉΓòÉ

The Prominare Designer Information dialogue will display the total number of
windows and dialogues along with the number of distinct words contained you
currently have within your design. It will also show the time that the design
file was last edited.

Information for the current window or dialogue will be displayed and will show
the total number of controls, accelerators, action bar menus, sub-menus, help
tables, sub-tables, and table items.

The dialogue will also show the distribution for the various resource elements.
It will show the location and filename where the dialogue or window, menu,
accelerators and help tables resource elements will be placed.


ΓòÉΓòÉΓòÉ 309. Help for Include Save As Dialogue ΓòÉΓòÉΓòÉ

The Include Save As dialogue is used to save an untitled

Through the list boxes, you can select a location or a filename to save the
include file under.

The Save push button is used to save the include file under the name entered,
whereas, the Cancel push button is used to cancel the save request.


ΓòÉΓòÉΓòÉ 310. Help for Include View/Edit Dialogue ΓòÉΓòÉΓòÉ

The Include View/Edit dialogue allows you to edit include symbols and their ID
values.

A list box will display the ID symbols and values from which you can select
items to change or delete.

The Save push button is used to accept the changes made, whereas, the Cancel
push button is used to reject any changes made.


ΓòÉΓòÉΓòÉ 311. Help for Locate Dialogue ΓòÉΓòÉΓòÉ

The Locate dialogue allows you to locate a specific .RC or .RES file that is to
be used within an entry field of the Resource Distribution Definition dialogue.

The dialogue contains two list boxes: Directories/Drives and Files.  Through
the Directories/Drives list box you can navigate to the location where the .RC
or .RES file is located.  The Files list box will show either .RC or .RES files
depending on the type of entry field the cursor was located in.

You can select the file to use simply by clicking the mouse pointer on the file
within the Files list box and then clicking the mouse pointer on the Select
push button or you can double click the mouse pointer on the entry within the
Files list box.

If you do not want to use a file selected in the Files list box, you can simply
click the mouse pointer on the Cancel push button.


ΓòÉΓòÉΓòÉ 312. Help for Locate Path Dialogue ΓòÉΓòÉΓòÉ

The Locate Path dialogue allows you to locate the path where the toolkit header
files are located either for OS/2 or Windows.  You need to specify the correct
location of these header files when trying to import a resource script file.
Within the headers are the symbols for the styles and classes that are used to
describe the controls.

The dialogue contains a list box: Directories/Drives.  Through this list box
you can navigate to the location where the toolkit header files are located.

You can select the path to use simply by clicking the mouse pointer on the file
within the list box and then clicking the mouse pointer on the Select push
button or you can double click the mouse pointer on the entry within the list
box.

If you do not want to use a file selected in the list box, you can simply click
the mouse pointer on the Cancel push button.


ΓòÉΓòÉΓòÉ 313. Help for Paste Open Dialogue ΓòÉΓòÉΓòÉ

The Paste Open dialogue allows you to open a .PDF file for pasting within
Prominare Designer.

Two list boxes are found within the dialogue: one for the directory list and
one for files.

You can select a different drive or subdirectory by double clicking the mouse
pointer on the entry desired.

To select the file to open, double click on the desired file within the files
list box or enter the filename within the entry field at the top of the
dialogue.

The Open push button is used to open the file listed within the entry field,
whereas, the Cancel push button is used to cancel the values the open request.


ΓòÉΓòÉΓòÉ 314. Help for Standard Menu Dialogue ΓòÉΓòÉΓòÉ

The Prominare Designer can help you design the menus for the window you are
creating. Start editing the menus by either clicking on the Menu tool button or
selecting Menu in the Control menu. The Prominare Designer will first check to
see if any menu items have been defined for the window. If none are found, you
will be informed that no menus exist. It will then ask if you want to select
menus from a standard menu list. Clicking on the Yes button displays the
Standard Menus dialogueshift op clicking No displays the Menu Styles dialogue.

The Standard Menus dialogue consists of a set of eight tabs.

      System menu

      File

      Selected

      Edit

      View

      Options

      Window

      Help
  Each tab represents an action bar menu itemshift op all are taken from the
 CUA '91 Guidelines. In all cases, you must first select the check box on the
 tab that denotes the action bar item before you can select a menu item to be
 used in the menu. Click on the All button to select all action bar and menu
 items.


ΓòÉΓòÉΓòÉ 315. Help for File Menu Tab ΓòÉΓòÉΓòÉ

The File tab deals with a File menu within the action bar. Generally, this is
the first menu item in most applications. It contains the following:

 Check Box           Usage
 New                 New menu item.
 Open...             Open menu item.
 Separator           Separator menu item.
 Save                Save menu item.
 Save as...          Save as menu item.
 Separator           Separator menu item.
 Print               Print menu item.


ΓòÉΓòÉΓòÉ 316. Help for Selected Menu Tab ΓòÉΓòÉΓòÉ

The Selected tab deals with a Selected menu in the action bar. It contains the
following:

 Check box           Usage
 Open as             Open as menu item.
 Print               Print menu item.


ΓòÉΓòÉΓòÉ 317. Help for Edit Menu Tab ΓòÉΓòÉΓòÉ

The Edit tab deals with a Edit menu in the action bar. It contains the
following:

 Check box           Usage
 Undo                Undo menu item.
 Redo                Redo menu item.
 Separator           Separator menu item.
 Cut                 Cut menu item.
 Copy                Copy menu item.
 Create              Create menu item.
 Paste               Paste menu Item.
 Separator           Separator menu item.
 Clear               Clear menu item.
 Delete              Delete menu item.
 Separator           Separator menu item.
 Find                Find menu item.
 Select all          Select all menu item.
 Deselect all        Deselect all menu item.


ΓòÉΓòÉΓòÉ 318. Help for View Menu Tab ΓòÉΓòÉΓòÉ

The View tab deals with a View menu in the action bar. It contains the
following:

 Check box           Usage
 View names          View names menu item.
 Sort                Sort menu item.
 Include             Include menu item.
 Separator           Separator menu item.
 Refresh             Refresh menu item.
 Refresh now         Refresh now menu item.


ΓòÉΓòÉΓòÉ 319. Help for Options Menu Tab ΓòÉΓòÉΓòÉ

The Options tab deals with a Options menu in the action bar. It contains the
following:

 Check box           Usage
 Short menus         Short menus menu item.
 Full menus          Full menus menu item.


ΓòÉΓòÉΓòÉ 320. Help for Window Menu Tab ΓòÉΓòÉΓòÉ

The Windows tab deals with a Windows menu in the action bar. Generally, this is
the second to last menu item in most applications. It contains the following:

 Check box           Usage
 Window list         Window list menu item.


ΓòÉΓòÉΓòÉ 321. Help for Help Menu Tab ΓòÉΓòÉΓòÉ

The Help tab deals with a Help menu in the action bar. Generally, this item is
the last menu item in most applications. It contains the following:

 Check box                Usage
 Help Index               Help index menu item.
 General help             General help menu item.
 Using help               Using help menu item.
 Keys help                Keys help menu item.
 Tutorial                 Tutorial menu item.
 Separator                Separator menu item.
 Product information      Product information... menu item.


ΓòÉΓòÉΓòÉ 322. Help for System Menu Tab ΓòÉΓòÉΓòÉ

The System menu tab deals with a child system menu within the action bar.
Generally, this item is found in multiple document-style applications. It
contains the following:

 Check box           Usage
 Restore             Restore menu item.
 Move                Move menu item.
 Size                Size menu item.
 Minimize            Minimize menu item.
 Maximize            Maximize menu item.
 Separator           Separator.
 Close               Close menu item.


ΓòÉΓòÉΓòÉ 323. Help for Menu Styles Dialogue ΓòÉΓòÉΓòÉ

The Menu Styles dialogue is used to define, edit and delete action bar and
sub-menu items.

A list box will display the currently defined menu items from which you can
select the item to edit.

You must set the menu type which can be one of the following:

     Action bar
     Sub-menu

 You must set the base style that the menu item should have.  The base styles
 available for action bar items are:

     Text
     Bitmap
     Child system menu

 If you select a base style of Bitmap, you must provide the necessary code in
 your program to load the bitmap from the program's resources and to set its
 size before assigning it to the action bar item.  If you do use Bitmap as the
 base style, you do not need to enter any text for the action bar item.

 You can also set other styles that the menu item should have.  The styles
 available are:

     Separator
     Break
     Break/Separator
     Button Separator
     Help
     SYSCOMMAND
     Static
     Sub-Menu
     SYSCOMMAND
     Static

 It is also possible set attributes that the sub-menu items should have.  The
 attributes available are:

     Checked
     Framed
     No Dismiss
     Disabled
     Hilighted

 You enter the text for the menu item along with the ID symbol and value.

 When entering the text for the menu item, it is possible to use the tilde (~)
 character and the tab (\t) designations.  You usually use the tab to force
 accelerator designations to the right of the menu.

 If you do enter an accelerator designation, the accelerator will be
 automatically placed within the accelerator table.

 When you add an item, the item will be added after the last item belonging to
 the parent selected.  You can then place the item in the correct position
 later using the Arrange menus in the Options menu.

 The Enter push button is used to accept the values entered within the entry
 fields, whereas, the Cancel push button is used to reject the values entered
 and to not create the sub-menu item.

 Presentation Manager Guide and Reference:

       Menus
            About Menus
                 Menu Bar and Pull-Down Menus
                 Pop-Up Menus
                 System Menu
                 Menu Items
                 Menu Access
            Using Menus
                 Defining Menu Items in a Resource File
                 Including a Menu Bar in a Standard Window
                 Creating a Pop-up Menu
                 Adding a Menu to a Dialogue Window
                 Accessing the System Menu
                 Responding to a User's Menu Choice
                 Setting and Querying Menu-Item Attributes
                 Adding and Deleting Menu Items
                 Creating a Custom Menu Item
            Menu Control Window Processing
                 Menu Control Styles
                 Menu Item Styles
                 Menu Item Attributes


ΓòÉΓòÉΓòÉ 324. Help for Advanced New Design Dialogue ΓòÉΓòÉΓòÉ

The Advanced New Design dialogue allows you to enter the design basename,
include header filename and .IPF filename.

Below these entry fields, further options are found.  Through the Target OS
selections, you can select your target operating system environment as either
OS/2 1.x, OS/2 2.x, OS/2 3.0 or OS/2 4.0.

In the Save group, you can also inform Prominare Designer to save both the
include and .IPF files.

Deletion of resource script information is controlled through the Deletion
group.  By selecting the None option, you instruct Prominare Designer to not
remove any constructs from either the resource script files for items that have
been deleted from the design.  The Don't verify will cause the deleted item
constructs to be removed from both the resource script files without any
verification whereas the Verify on save will cause a list of deletion items to
be displayed before the resource script files are saved to allow you to
pre-edit the deletion list thereby allowing you to prevent certain constructs
from being deleted.

The Set push button is used to accept the values entered within the entry
fields, whereas, the Cancel push button is used to reject the values entered
and to not save the association information.


ΓòÉΓòÉΓòÉ 325. Help for Messages Tab ΓòÉΓòÉΓòÉ

The Messages tab is used to select or de-select messages that are to be
included within a window or dialogue procedure.

Depending on the defaults that you selected through the Source Layout menu,
messages will have been preselected for inclusion within the window or
dialogue.

You can then select the messages that you wish to include within the window or
dialogue from the messages contained within the list and the code you have
defined for these messages will be included within your window or dialogue that
you are designing.

The messages within the displayed list will be for windows:

     WM_*
     DM_*
     HM_*

 The messages within the displayed list will be for dialogues:

     WM_*
     DM_*

 The tab will display the total number of messages contained within the list
 and will show also the total number of messages that you have selected.  Each
 message that you selected to be included is highlighted within the message
 list.


ΓòÉΓòÉΓòÉ 326. Help for PMCX Creation Dialogue ΓòÉΓòÉΓòÉ

The PMCX Creation dialogue is used to define the name of the custom control,
the author, the classname and description.

It is also used to define the amount of text the control can handle, which is
between 0 and 512 bytes.

The default size of the control is also defined and can be between 0 and
32,767.

When CTLDATA is defined for the control, you need to specify the size of the
control data that needs to be reserved for the control use.  This can be
between 0 and 65,535 bytes.

You can define various styles for custom control.  These are:

     Refresh
     Variable CTLDATA
     Allows style changing
     Tabable
     Help selectable


ΓòÉΓòÉΓòÉ 327. Help for PMCX Definition Tab ΓòÉΓòÉΓòÉ

The Definition tab is used to define the PMCX control you are creating.

It is used to define the amount of text the control can handle, which is
between 0 and 512 bytes.

The default size of the control is also defined and can be between 0 and
32,767.

When CTLDATA is defined for the control, you need to specify the size of the
control data that needs to be reserved for the control use.  This can be
between 0 and 65,535 bytes.

You can define various styles for custom control.  These are:

     Refresh
     Variable CTLDATA
     Allows style changing
     Tabable
     Help selectable


ΓòÉΓòÉΓòÉ 328. Help for PMCX Messages Tab ΓòÉΓòÉΓòÉ

Through the Messages tab you can select the messages that are to be handled by
the PMCX control.

Depending on the defaults that you selected through the Source Layout menu,
messages will have been preselected for inclusion within the window or
dialogue.

You can then select the messages that you wish to include within the window or
dialogue from the messages contained within the list and the code you have
defined for these messages will be included within your window or dialogue that
you are designing.

The messages within the displayed list will be for windows:

     WM_*
     DM_*
     HM_*

 The messages within the displayed list will be for dialogues:

     WM_*
     DM_*

 The dialogue will display the total number of messages contained within the
 list and will show also the total number of messages that you have selected.
 Each message that you selected to be included is highlighted within the
 message list.


ΓòÉΓòÉΓòÉ 329. Help for Window Definitions Tab ΓòÉΓòÉΓòÉ

The window Definitions tab is used to define various handles used within the
source code.

The handles that are entered through the dialogue are:

     Queue
     Frame
     Client
     Menu

 The first entry field in the dialogue, Base is used to enter the base name for
 the handles and class information.

 By entering the base name, you can click the mouse on the Update push button
 to update the handle names and class information.

 Alternately, if you have selected the User Define check box, you can manual
 enter the necessary handle and class information.

 Even if you have used the Update push button to create the names for you, you
 can still edit them as required.

 If you want to use a function instead of inline code within the Client Window
 Procedure, enter the name of the function along with the filename for the
 message you wish to provide the function for.

 Note:  If you do not provide the definition information and you want Prominare
        Designer to generate the source code for you, Prominare Designer will
        display a message box informing you that you are missing information
        and that it will not be able to generate the source code.

 The Enter push button is used to accept the values entered within the entry
 fields, whereas, the Cancel push button is used to reject the values entered
 and to not create definition information for the window.


ΓòÉΓòÉΓòÉ 330. Help for Workplace Window Definitions Tab ΓòÉΓòÉΓòÉ


ΓòÉΓòÉΓòÉ 331. Help for Arrange Dialogue ΓòÉΓòÉΓòÉ

When you want to change the display order of items, you can use this dialogue.

A list of items will be displayed within a list box in their current order.

To change the position of an item, you only need to select the item within the
list box.You can select more than one item using the extended selection list
box interface.  The mouse pointer will change from an arrow shape to a bar
shape..  This indicates that an item has been selected and can now be moved.

When you move the mouse pointer, you will notice that the arrow will change
values from an arrow to a bar as it moves over each item.  When the pointer is
in the top half of an item, it will be a bar whereas when it is in the bottom
half of an item, it will be an arrow.

Once you have moved to the new location and the pointer is a bar shape, you
only need to press button 1 of the mouse to cause the item to be moved.

If you want to change your selection, move to the new item, making sure the
mouse pointer is an arrow shape and click button 1.

When arranging controls, two push buttons will appear in the bottom right
corner of the dialogue.  These buttons are used to add and delete group markers
and tab stops.

Upon completion of arranging the items, click on the Accept push button.


ΓòÉΓòÉΓòÉ 332. Help for Pre-designed Window/Dialogue Dialogue ΓòÉΓòÉΓòÉ

The Pre-designed Window/Dialogue dialogue allows you to select a pre-designed
window or dialogue to include within you current design.

The list box will display the descriptions of the windows or dialogues that
have been saved as pre-designed entities.

The Select push button is used to retrieve from disk the entry selected in the
list box, whereas, the Cancel push button is used to exit the dialogue without
selecting a pre-designed window or dialogue.


ΓòÉΓòÉΓòÉ 333. Help for Resource Properties Dialogue ΓòÉΓòÉΓòÉ

The Resource Properties dialogue allows you to set the loading and memory
properties for a:

     Accelerator
     Dialogue
     Message
     String

 The properties can be a combination of:

     Default
     Moveable
     Preload
     Discard

 The Set push button is used to accept the values entered, whereas, the Cancel
 push button is used to reject the values entered and to not change the
 properties.


ΓòÉΓòÉΓòÉ 334. Help for User Defined Control Dialogue ΓòÉΓòÉΓòÉ

The Select User Control dialogue is used to select a custom control defined
within a dynamic-link library or to select a temporary control.

The list box will display the current definitions available and when you select
an item, the control will be displayed in the example area.

When you click the mouse pointer on the Select push button, the mouse cursor
will change from the arrow shape to the selection shape to allow you to select
the location where the control should be placed within the dialogue or window
you are designing.

Once you have placed the control, a dialogue will be displayed allowing you to
enter the ID symbol and value, enter the control's text and to set styles if
the control supports them.

The Select push button is used to accept the control selected, whereas, the
Cancel push button is used to cancel the creation of the custom user defined
control.


ΓòÉΓòÉΓòÉ 335. Help for New Dialogue/Window Dialogue ΓòÉΓòÉΓòÉ

The New Dialogue/Window dialogue is used to select the type of window or
dialogue that you want Prominare Designer to create for you.  You can selected
from one of nine types.  The first one: is used to create a dialogue with a
system menu, title bar and three push buttons within the dialogue aligned along
the bottom of the dialogue.  The first push button is OK, the second Cancel and
the last one is Help.

The second one: is similar to the first and is used to create a dialogue with a
system menu, title bar but this time the three push buttons within the dialogue
are aligned along the right side of the dialogue.  The first push button is OK,
the second Cancel and the last one is Help.

The third one: is used to create a dialogue with a system menu, title bar and
one push button labeled OK.

The fourth one: is used to create a dialogue with a system menu, title bar and
no push buttons.

The fifth one: is used to create a tab.  This option is only valid if you have
dialogues or windows within your current design that contain a notebook
control.  When you exit the New Dialogue/Window dialogue using the Create push
button, a secondary dialogue, Notebook Parent, will be displayed where you will
need to select the parent and notebook for which the page is being created for.

The sixth one: is used to create a Workplace Settings page.  This option is
only valid if you have set the design for Workplace.

The seventh one: is used to create a popup menu.  Initially, the menu will be
invisible since it contains no menu entrys.  Once you create a menu item for it
through the Menu in the Control menu option, the popup menu will be displayed.

The eighth one: is used to select a predesigned window or dialogue.  When you
exit the New Dialogue/Window dialogue using the Create push button, a secondary
dialogue, Pre-designed library, will be displayed where you will need to the
desired window or dialogue.

The last one: is used to create a window with a system menu, title bar and
minimize and maximize buttons.

The Create push button is used to accept the selection thereby causing the
selected type of dialogue or window to be created after which the
Window/Dialogue Styles dialogue will be displayed to allow you to tailor the
final values for the dialogue or window.

The Cancel push button is used to ignore the type selected.


ΓòÉΓòÉΓòÉ 336. Help for Notebook Parent Dialogue ΓòÉΓòÉΓòÉ

The Notebook Parent dialogue is used to select the dialogue or window that
contains the notebook for which you wish to create a tab for.

The first drop-down list contains the dialogues and windows within your design
that have a notebook control.  You need to select the dialogue or window that
contains the notebook first before you can select the actual notebook for which
the page is targeted.

The second drop-down list contains the notebooks that are contained within the
dialogue or window selected through the first drop-down list.  When you select
the notebook from this drop-down list, the tab will be sized for the notebook
thereby allowing you to correctly design the page.

The Enter push button is used to accept the notebook and parent selected
whereas the Cancel push button is used to reject the values entered.


ΓòÉΓòÉΓòÉ 337. Help for Window/Dialogue Styles Dialogue ΓòÉΓòÉΓòÉ

The Window/Dialogue Styles dialogue is used to set a window's or dialogue's
styles. It is also used to set the title bar text, window ID symbol and value
along with window or dialogue description.

You also set the type of window or dialogue being set.  These types are:

     Parent Window
     Child Window
     Dialogue
     Notebook page
     WP settings page

 The relative position that the window or dialogue takes can be one of the
 following:

     Window
     Screen
     Mouse

 Note:  The relative positions are only available for Child Windows and
        Dialogues.

 The parent window for the window or dialogue can be one of the following:

     Desktop
     Main Window
     Object Window

 When you have selected the tab as the type, the drop down lists within the tab
 linkage group become active.  You are expected to select the dialogue which
 contains a notebook from the drop down labeled Dialogue. The dialogue selected
 will then be scanned for notebook definitions and the symbols of these
 notebooks will be placed within the drop down labeled Notebook.

 Once you have selected the target notebook, the necessary information for that
 notebook such as the size, tab orientation, etc. will be used as base to allow
 you to design the contents of the tab.

 Possible styles are:

     Title Bar
     System Menu
     Horz. Scroll Bar
     Vert. Scroll Bar
     Visible
     Size Border
     Border
     Dialogue Frame
     System Modal
     Menu
     Min Button
     Max Button
     Accelerators
     Standard
     Shell position
     Auto icon
     DBCS status
     Close button
     Task list

 The Enter push button is used to accept the values entered within the entry
 fields, whereas, the Cancel push button is used to reject the values entered
 and to not change the child window.

 Presentation Manager Guide and Reference:

       About Button Controls
            Button Types
            Button Styles
            Default Button Behavior
            Button Notification Messages
            Button States
            Custom Buttons
       Using Button Controls
            Using Buttons in a Dialogue Window
            Using Buttons in a Client Window
            Creating Buttons with Icons and Icon/Text Combinations
       Button Control Window Processing
            Button Control Styles
            Default Colours


ΓòÉΓòÉΓòÉ 338. Help for Deletion Edit List Dialogue ΓòÉΓòÉΓòÉ

The Deletion Edit List dialogue is used to edit the list of deleted items from
the current design that you are saving.  The items will be both deleted and
renamed items from the dialogues or windows you have created or edited.

The items will be shown within a list box in the dialogue with the ID value,
control type and applicable parent.  You select the items you wish to delete
from the list and press the Delete push button to cause the items selected to
be removed from the list and for the process of saving the design to disk to
begin.  Selecting the All push button will cause all the items within the list
box to be selected thereby allowing you to unselect items as required.

At the beginning of each entry within the dialogue, a letter will be shown
indicating the type of action performed on the object in question.  These
abbreviations are:

 Abbreviation:       Meaning:

 R                   Object renamed.

 D                   Object deleted.

 To proceed with the saving the of the resource script file, click the mouse
 pointer on the Continue push button. To exit without saving the resource file
 or source files, click the mouse pointer on the Cancel push button


ΓòÉΓòÉΓòÉ 339. Help for Bidirectional Support Dialogue ΓòÉΓòÉΓòÉ

The Bidirectional Support dialogue is used to change the bidirection
characteristics of controls within the dialogue or window you are currently
designing.

You can set the following window orientation:

     Left to right
     Right to left

 You can set the following text types:

     Visual
     Implicit

 The symmetric swapping types you can set are:

     Off
     On

 You can set the following text orientation:

     Left to right
     Right to left
     Contextual

 The word break types you can set are:

     Off
     On

 The numeric types you can set are:

     Nominal
     Pass through
     National
     Contextual

 You can set the character shape determination for:

     Display shaped
     Nominal
     Middle
     Isolated
     Save shapped
     Initial
     Final

 The Set push button is used to accept the values entered, whereas, the Cancel
 push button is used to reject the values entered.


ΓòÉΓòÉΓòÉ 340. Help for Font & Colours Dialogue ΓòÉΓòÉΓòÉ

The Font & Colours dialogue is used to change the presentation characteristics
of certain controls within the dialogue you are currently designing.

A notebook within the dialogue allows you to select the areas within a
dialogue, window, control or menu that can have the colors set.  The notebook
is divided into two tabs: Dialogues and Controls.

You select the area you want to change by selecting the check box.  A set check
box will use the color you have defined whereas a clear check box will use the
default characteristics.

Beside each check box item will be displayed a button showing the current
presentation parameter color selected.  By clicking on the button, the color
table will be displayed.

The color table to the right of the check boxes allows you to select the
presentation parameter color.  A frame will be displayed around the color you
have selected.

You can also select the font to use within the control by selecting the font
from the Fonts list box and the font size from the Size list box.  When you
select a font or font size, an example of the selected font and size will be
displayed below the list boxes.

The Set push button is used to accept the values entered, whereas, the Cancel
push button is used to reject the values entered.


ΓòÉΓòÉΓòÉ 341. Help for Dialogues Tab ΓòÉΓòÉΓòÉ

The Dialogues tab is used to change the presentation characteristics of certain
controls within the dialogue you are currently designing.

A set of check boxes allow you to set the colors for the following areas:

     Foreground
     Background
     Highlight Foreground
     Highlight Background
     Disabled Foreground
     Disabled Background
     Border
     Active color (2.x and Warp only)
     Inactive color (2.x and Warp only)
     Active text foreground (2.x and Warp only)
     Active text background (2.x and Warp only)
     Inactive text foreground (2.x and Warp only)
     Inactive text background (2.x and Warp only)
     Shadow (2.x and Warp only)
     Shadow text (2.x and Warp only)
     Shadow hilight foreground (2.x and Warp only)
     Shadow hilight background (2.x and Warp only)
     Icon text background (2.x and Warp only)


ΓòÉΓòÉΓòÉ 342. Help for Menu Tab ΓòÉΓòÉΓòÉ

The Menu tab is used to change the presentation characteristics of menu items
within the window you are currently designing.

A set of check boxes allow you to set the colors for the following areas:

     Foreground
     Background
     Highlight Foreground
     Highlight Background
     Disabled Foreground
     Disabled Background


ΓòÉΓòÉΓòÉ 343. Menu Font & colours Tab ΓòÉΓòÉΓòÉ

The Menu tab is used to change the presentation characteristics of menu items
within the window you are currently designing.

A set of check boxes allow you to set the colors for the following areas:

     Foreground
     Background
     Highlight Foreground
     Highlight Background
     Disabled Foreground
     Disabled Background


ΓòÉΓòÉΓòÉ 344. Help for Font Dialogue ΓòÉΓòÉΓòÉ

The Font dialogue is used to change the font characteristics of certain
controls within the dialogue you are currently designing.

You can select the font to use within the control by selecting the font from
the Fonts list box and the font size from the Size list box.  When you select a
font or font size, an example of the selected font and size will be displayed
below the list boxes.

The Enter push button is used to accept the values entered, whereas, the Cancel
push button is used to reject the values entered.


ΓòÉΓòÉΓòÉ 345. Help for Design Notes Dialogue ΓòÉΓòÉΓòÉ

The Design Notes dialogue is used to entry and edit note entries that you want
to include within the design.  The dialogue allows you to select existing
entries, which are denoted by the tabs within the notebook, or to create new
ones.

A title for the note can be entered along with the author name.

To clear delete an entry, click the mouse pointer on the Delete push button.
This will cause the entry within the note book to be removed and the
information to be discarded.

Adding a new note entry is done by clicking the mouse pointer on the Add push
button.  This causes a new page to be added to the notebook and to have it
placed on top to allow you to enter the information.

The Enter push button is used to accept the values entered, whereas, the Cancel
push button is used to reject the values entered.


ΓòÉΓòÉΓòÉ 346. Help for DLL Error Dialogue ΓòÉΓòÉΓòÉ

The message window is displaying error information regarding a .DLL that could
not be loaded.


ΓòÉΓòÉΓòÉ 347. Help for Duplicate Filename Dialogue ΓòÉΓòÉΓòÉ

Through the Duplicate Filename dialogue, you can enter an alternate name for a
filename that is already being used.


ΓòÉΓòÉΓòÉ 348. Help for Mouse Usage Tab ΓòÉΓòÉΓòÉ

The Mouse Usage tab allows you to define how you want to use the mouse when
interacting with controls and windows within a displayed window or dialogue.

You can set the mouse/keyboard combination for the following actions:

      Select control
      Add/Subtract group item
      Move group
      Rubber band select
      Set group anchor
      Select styles dialogue
      Show info


ΓòÉΓòÉΓòÉ 349. Help for Text/ID Symbol Definition Window ΓòÉΓòÉΓòÉ

Through the Text/ID Symbol dialogue, you can edit the text and the symbol for
the control, dialogue or window currently selected.  Once you have made your
changes to either the text or ID/Symbol, you can click the mouse pointer on the
Update push button to cause the information to be recorded for the control,
dialogue or window.


ΓòÉΓòÉΓòÉ 350. Help for Symbol Generation Tab ΓòÉΓòÉΓòÉ

The Symbol Generation Options tab is used to set the prefix values for control
symbols and to set automatic symbol generation options and duplicate checking.

Within the dialogue are various entry fields where you to set the prefix that
is to be used with a control symbol.  The following table shows the controls
that can have a prefix value defined and the default:

 Control:            Default:

 Push button         PB_

 Check box           CB_

 Radio button        RB_

 List box            LB_

 Entry field         EF_

 Group box           GB_

 Text                ST_

 Frame               FR_

 Rectangle           RC_

 Combo box           CX_

 Multi-line entry    MLE_

 Spin button         SPB_

 Container           CT_

 Slider              SLD_

 Value set           VS_

 Notebook            NB_

 Circular slider     CSLD_

 Graphic button      GRB_

 Handwriting         HW_

 Sketch              SK_

 User defined        UD_

 User button         UB_

 Window              WIN_

 Dialogue            DLG_

 Action bar          IDM_

 Sub-menu            IDM_

 Popup menu          PUM_

 tab                 NBKP_

 By selecting the Auto generate check box, Prominare Designer will generate a
 symbol for a control using the text of the control.  If you select the Use
 prefix, the prefix for define for the control will prefix the translated text.

 Also, to aid the prevention of duplicate ID symbols within the current window
 or dialogue, you can have Prominare Designer check each symbol. If a duplicate
 symbol is found, a message will be displayed alerting you.  By clicking the
 mouse pointer on the OK push button in the message, Prominare Designer will
 use the symbol defined whereas pressing the Cancel push button, you will be
 allow to change the symbol.


ΓòÉΓòÉΓòÉ 351. Help for Check Box Tab ΓòÉΓòÉΓòÉ

The Check Box tab is used to set the default check box characteristics for when
a check box is created using the Check Box on the Control pull-down menu.

The default text to be used along with the size of the check box when it is
initially created is entered in the entry fields provided in the dialogue.

The following check box types can be used as the default:

     Check Box
     Auto Check Box
     3 State
     Auto 3 State

 Button options that are possible are:

     No Focus
     Auto size

 Base styles are:

     Visible
     Tab stop
     Group
     Disabled

 The Default push button is used to reset the values entered to the Prominare
 Designer defaults.

 The Show push button is used to display the selections made within the example
 area of the tab.  And once you have shown the revised check box, you can test
 its operation to see if this what you want to use as your default.

 Presentation Manager Guide and Reference:

       About Button Controls
            Button Types
            Button Styles
            Default Button Behavior
            Button Notification Messages
            Button States
            Custom Buttons
       Using Button Controls
            Using Buttons in a Dialogue Window
            Using Buttons in a Client Window
            Creating Buttons with Icons and Icon/Text Combinations
       Button Control Window Processing
            Button Control Styles


ΓòÉΓòÉΓòÉ 352. Help for Combo Box Tab ΓòÉΓòÉΓòÉ

The Combo Box tab is used to set the default combo box characteristics for when
a combo box is created using the Combo Box on the Control pull-down menu.

The default text to be used along with the size of the combo box when it is
initially created is entered in the entry fields provided in the dialogue.

Possible styles are:

     Simple
     Drop Down
     Drop Down List
 Other options are:

     Auto Tab
     Any
     SBCS
     DBCS
     Mixed
     Horz. Scroll

 Base styles are:

     Visible
     Tab stop
     Group
     Disabled

 The Default push button is used to reset the values entered to the Prominare
 Designer defaults.

 The Show push button is used to display the selections made within the example
 area of the tab.  And once you have shown the revised combo box, you can test
 its operation to see if this what you want to use as your default.

 Presentation Manager Guide and Reference:

       About Combination-Box Controls
            Combination-Box Styles
            Combination-Box Notification Code
       Using Combination-Box Controls
       Combination-Box Control Window Processing
            Combination Box Control Styles


ΓòÉΓòÉΓòÉ 353. Help for Entry Field Tab ΓòÉΓòÉΓòÉ

The Entry Field tab is used to set the default entry field characteristics for
when an entry field is created using the Edit on the Control pull-down menu.

The default text to be used along with the size of the combo box when it is
initially created is entered in the entry fields provided in the dialogue.

Possible styles are:

     Left Aligned
     Centered
     Right Aligned
     Auto Horz. Scroll
     Margin
     Auto Tab
     Read Only
     Command
     Unreadable
     Any
     SBCS
     DBCS
     Mixed
     Auto size

 Base styles are:

     Visible
     Tab stop
     Group
     Disabled

 The Default push button is used to reset the values entered to the Prominare
 Designer defaults.

 The Show push button is used to display the selections made within the example
 area of the tab.  And once you have shown the revised entry field, you can
 test its operation to see if this what you want to use as your default.

 The Enter push button is used to accept the values entered within the entry
 fields, whereas, the Cancel push button is used to reject the values entered
 and to not change the default entry field.

 Presentation Manager Guide and Reference:

       About Button Controls
            Button Types
            Button Styles
            Default Button Behavior
            Button Notification Messages
            Button States
            Custom Buttons
       Using Button Controls
            Using Buttons in a Dialogue Window
            Using Buttons in a Client Window
            Creating Buttons with Icons and Icon/Text Combinations
       Button Control Window Processing
            Button Control Styles
            Default Colours


ΓòÉΓòÉΓòÉ 354. Help for Group Box Tab ΓòÉΓòÉΓòÉ

The Group Box tab is used to set the default group box characteristics for when
a group box is created using the Group Box on the Control pull-down menu.

The default text to be used along with the size of the group box when it is
initially created is entered in the entry fields provided in the dialogue.

Possible styles are:

     Auto size

 Base styles are:

     Visible
     Tab stop
     Group
     Disabled

 The Default push button is used to reset the values entered to the Prominare
 Designer defaults.

 The Show push button is used to display the selections made within the example
 area of the tab.  And once you have shown the revised group box, you can test
 its operation to see if this what you want to use as your default.

 Presentation Manager Guide and Reference:

       About Static Controls
            Keyboard Focus
            Static Control Handle
            Static Control Styles
            Default Static Control Performance
       Using Static Controls
            Using Static Control in a Dialogue Window
            Using Static Control in a Client Window
       Static Control Window Processing
            Static Control Styles


ΓòÉΓòÉΓòÉ 355. Help for Paths Tab ΓòÉΓòÉΓòÉ

The Paths tab is used to set the path where pre-designed windows or dialogues
are to be stored when you use the Save design menu item in the File pull-down
menu.

Additional entry fields are provided to allow you to define the location where
your OS/2 and Microsoft Windows headers are located for when you want to import
OS/2 and Microsoft Windows .RC files.  You would use these paths when you
dynamically set the INCLUDE= environment and the include path has not been
formally defined within your environment.

You also can set the manner in which the Prominare Designer references paths to
resources such as icons, bitmaps, etc.  The Fixed check box causes the
Prominare Designer to construct the full path to the file being referenced.
This includes the drive designation and sub-directories.  The Relative check
box cause the Prominare Designer to use the path/file as entered or selected.
This allows for easier moment of files from one system or drive to another.


ΓòÉΓòÉΓòÉ 356. Help for Extensions Tab ΓòÉΓòÉΓòÉ

The Extensions tab is used to set the extensions for the include, resource
script and binary files.  You can define the extensions to use by default for:

      OS/2 1.x
      OS/2 2.x / Warp 3.0 / Warp 4.0
      Windows 3.1
      Windows NT


ΓòÉΓòÉΓòÉ 357. Help for List Box Tab ΓòÉΓòÉΓòÉ

The List Box tab is used to set the default list box characteristics for when a
list box is created using the List Box on the Control pull-down menu.

The default text to be used along with the size of the list box when it is
initially created is entered in the entry fields provided in the dialogue.

Possible styles are:

     Multiple Selection
     User Redraw
     No Adjust Position
     Horz. Scroll
     Extended Selection

 Base styles are:

     Visible
     Tab stop
     Group
     Disabled

 The Default push button is used to reset the values entered to the Prominare
 Designer defaults.

 The Show push button is used to display the selections made within the example
 area of the tab.  And once you have shown the revised list box, you can test
 its operation to see if this what you want to use as your default.

 Presentation Manager Guide and Reference:

       About List Boxes
       Using List Boxes
            Creating a List-Box Window
            Using a List Box in a Dialogue Window
            Adding or Deleting an Item in a List Box
            Responding to a User Selection in a List Box
            Handling Multiple Selections
            Creating an Owner-Drawn List Item
            Default List-Box Behavior
       List Box Control Window Processing


ΓòÉΓòÉΓòÉ 358. Help for MLE Tab ΓòÉΓòÉΓòÉ

The MLE tab is used to set the default multi-line entry characteristics for
when a multi-line entry is created using the Multi-Line on the Control
pull-down menu.

The default text to be used along with the size of the list box when it is
initially created is entered in the entry fields provided in the dialogue.

Possible styles are:

     Border
     Horz. Scroll
     Vert. Scroll
     Ignore Tab
     Read Only
     Word Wrap
     Disable Undo
     Limit vertical scroll

 Base styles are:

     Visible
     Tab stop
     Group
     Disabled

 The Default push button is used to reset the values entered to the Prominare
 Designer defaults.

 The Show push button is used to display the selections made within the example
 area of the tab.  And once you have shown the revised multi-line entry, you
 can test its operation to see if this what you want to use as your default.

 Presentation Manager Guide and Reference:

       About Multiple-Line Entry Field Controls
            MLE Styles
            MLE Notification Codes
            MLE Text Editing
            MLE Text Formatting
            MLE Text Import and Export Operations
            MLE Cut, Copy, and Paste Operations
            MLE Search and Replace Operations
            MLE Colours
       Using Multiple-Line Entry Field Controls
            Creating an MLE
            Importing and Exporting MLE Text
            Searching MLE Text
       Multi-Line Entry Field Control Window Processing
            Button Control Styles


ΓòÉΓòÉΓòÉ 359. Help for Push Button Tab ΓòÉΓòÉΓòÉ

The Push Button tab is used to set the default push button characteristics for
when a push button is created using the Push Button on the Control pull-down
menu.

The default text to be used along with the size of the psuh button when it is
initially created is entered in the entry fields provided in the dialogue.

Button options that are possible are:

     Default
     Help
     SYSCOMMAND
     No Border
     No Focus
     Icon
     Auto size
     Text
     Mini-icon

 Base styles are:

     Visible
     Tab stop
     Group
     Disabled

 The Default push button is used to reset the values entered to the Prominare
 Designer defaults.

 The Show push button is used to display the selections made within the example
 area of the tab.  And once you have shown the revised push button, you can
 test its operation to see if this what you want to use as your default.

 Presentation Manager Guide and Reference:

       About Button Controls
            Button Types
            Button Styles
            Default Button Behavior
            Button Notification Messages
            Button States
            Custom Buttons
       Using Button Controls
            Using Buttons in a Dialogue Window
            Using Buttons in a Client Window
            Creating Buttons with Icons and Icon/Text Combinations
       Button Control Window Processing
            Button Control Styles


ΓòÉΓòÉΓòÉ 360. Help for Radio Button Tab ΓòÉΓòÉΓòÉ

The Radio Button tab is used to set the default radio button characteristics
for when a check box is created using the Radio Button on the Control pull-down
menu.

The default text to be used along with the size of the radio button when it is
initially created is entered in the entry fields provided in the dialogue.

The following radio button types can be used as the default:

     Radio Button
     Auto Radio Button

 Button options that are possible are:

     No Focus
     No Pointer Select
     Auto size

 Base styles are:

     Visible
     Tab stop
     Group
     Disabled

 The Default push button is used to reset the values entered to the Prominare
 Designer defaults.

 The Show push button is used to display the selections made within the example
 area of the tab.  And once you have shown the revised radio button, you can
 test its operation to see if this what you want to use as your default.

 Presentation Manager Guide and Reference:

       About Button Controls
            Button Types
            Button Styles
            Default Button Behavior
            Button Notification Messages
            Button States
            Custom Buttons
       Using Button Controls
            Using Buttons in a Dialogue Window
            Using Buttons in a Client Window
            Creating Buttons with Icons and Icon/Text Combinations
       Button Control Window Processing
            Button Control Styles


ΓòÉΓòÉΓòÉ 361. Help for Frame Tab ΓòÉΓòÉΓòÉ

The Frame dialogue is used to set the default frame characteristics for when a
rectangle or frame is created using the Frame on the Control pull-down menu.

The default text along with the size of the frame when it is initially created
is entered in the entry fields provided in the dialogue.

The following styles can be used as the default:

     Foreground
     Halftone
     Background
     Auto size

 Base styles are:

     Visible
     Tab stop
     Group
     Disabled

 The Default push button is used to reset the values entered to the Prominare
 Designer defaults.

 The Show push button is used to display the selections made within the example
 area of the tab.  And once you have shown the revised frame, you can test its
 operation to see if this what you want to use as your default.

 Presentation Manager Guide and Reference:

       About Static Controls
            Keyboard Focus
            Static Control Handle
            Static Control Styles
            Default Static Control Performance
       Using Static Controls
            Using Static Control in a Dialogue Window
            Using Static Control in a Client Window
       Static Control Window Processing
            Static Control Styles


ΓòÉΓòÉΓòÉ 362. Help for Rectangle Tab ΓòÉΓòÉΓòÉ

The Rectangle dialogue is used to set the default rectangle characteristics for
when a rectangle is created using the Rectangle on the Control pull-down menu.

The default text along with the size of the rectangle when it is initially
created is entered in the entry fields provided in the dialogue.

The following styles can be used as the default:

     Foreground
     Halftone
     Background
     Auto size

 Base styles are:

     Visible
     Tab stop
     Group
     Disabled

 The Default push button is used to reset the values entered to the Prominare
 Designer defaults.

 The Show push button is used to display the selections made within the example
 area of the tab.  And once you have shown the revised rectangle, you can test
 its operation to see if this what you want to use as your default.

 Presentation Manager Guide and Reference:

       About Static Controls
            Keyboard Focus
            Static Control Handle
            Static Control Styles
            Default Static Control Performance
       Using Static Controls
            Using Static Control in a Dialogue Window
            Using Static Control in a Client Window
       Static Control Window Processing
            Static Control Styles


ΓòÉΓòÉΓòÉ 363. Help for Scroll Bars Tab ΓòÉΓòÉΓòÉ

The Scroll Bar tab is used to set the default horizontal or vertical scroll bar
characteristics for when a horizontal or vertical scroll bar is created using
the Horz Scroll or Vert Scroll on the Control pull-down menu.

The size of the scroll bar when it is initially created is entered in the entry
fields provided in the dialogue.

The Default push button is used to reset the values entered to the Prominare
Designer defaults.

The Show push button is used to display the selections made within the example
area of the tab.  And once you have shown the revised scroll bar, you can test
its operation to see if this what you want to use as your default.


ΓòÉΓòÉΓòÉ 364. Help for Horz. Scroll Tab ΓòÉΓòÉΓòÉ

The Horz. Scroll tab is used to set the default horizontal scroll bar
characteristics for when a horizontal scroll bar is created using the Horz
Scroll on the Control pull-down menu.

The size of the scroll bar when it is initially created is entered in the entry
fields provided in the dialogue.

Base styles are:

     Visible
     Tab stop
     Group
     Disabled

 The Default push button is used to reset the values entered to the Prominare
 Designer defaults.

 The Show push button is used to display the selections made within the example
 area of the tab.  And once you have shown the revised scroll bar, you can test
 its operation to see if this what you want to use as your default.

 Presentation Manager Guide and Reference:

       About Scroll Bars
            Scroll-Bar Creation
            Scroll-Bar Notification Messages
            Scroll Bars and the Keyboard
       Using Scroll Bars
            Creating Scroll Bars
            Retrieving a Scroll-Bar Handle
            Using the Scroll-Bar Range and Position
       Scroll Bar Control Window Processing
            Scroll Bar Control Styles


ΓòÉΓòÉΓòÉ 365. Help for Vert. Scroll Tab ΓòÉΓòÉΓòÉ

The Vert. Scroll Bar tab is used to set the default vertical scroll bar
characteristics for when a vertical scroll bar is created using the Vert Scroll
on the Control pull-down menu.

The size of the scroll bar when it is initially created is entered in the entry
fields provided in the dialogue.

Base styles are:

     Visible
     Tab stop
     Group
     Disabled

 The Default push button is used to reset the values entered to the Prominare
 Designer defaults.

 The Show push button is used to display the selections made within the example
 area of the tab.  And once you have shown the revised scroll bar, you can test
 its operation to see if this what you want to use as your default.

 Presentation Manager Guide and Reference:

       About Scroll Bars
            Scroll-Bar Creation
            Scroll-Bar Notification Messages
            Scroll Bars and the Keyboard
       Using Scroll Bars
            Creating Scroll Bars
            Retrieving a Scroll-Bar Handle
            Using the Scroll-Bar Range and Position
       Scroll Bar Control Window Processing
            Scroll Bar Control Styles


ΓòÉΓòÉΓòÉ 366. Help for Text Tab ΓòÉΓòÉΓòÉ

The Text tab is used to set the default static text characteristics for when
static text is created using the Text on the Control pull-down menu.

The default text along with the size of the static text when it is initially
created is entered in the entry fields provided in the dialogue.

Text style options that are possible are:

     Left Aligned
     Horz. Aligned
     Right Aligned
     Top Aligned
     Vert. Centered
     Bottom Aligned
     Word Wrap
     Halftone
     Mnemonic
     Auto size

 Base styles are:

     Visible
     Tab stop
     Group
     Disabled

 The Default push button is used to reset the values entered to the Prominare
 Designer defaults.

 The Show push button is used to display the selections made within the example
 area of the tab.  And once you have shown the revised static text, you can
 test its operation to see if this what you want to use as your default.

 Presentation Manager Guide and Reference:

       About Static Controls
            Keyboard Focus
            Static Control Handle
            Static Control Styles
            Default Static Control Performance
       Using Static Controls
            Using Static Control in a Dialogue Window
            Using Static Control in a Client Window
       Static Control Window Processing
            Static Control Styles


ΓòÉΓòÉΓòÉ 367. Help for Container Tab ΓòÉΓòÉΓòÉ

Note:  This control is only available for OS/2 2.0, 2.1, 2.11, Warp and above.
       You will require the IBM OS/2 2.0 Toolkit to be able to use this option.

 The Container tab is used to set the selection type and general options. It is
 also used to set the ID symbol and value.

 Selection types are:

     Extended
     Multiple
     Single

 General options that are possible are:

     Auto position
     Verify pointer
     Read only
     Mini record
     Mini-icons
     No control pointer

 Base styles are:

     Visible
     Tab stop
     Group
     Disabled

 The Default push button is used to reset the values entered to the Prominare
 Designer defaults.

 The Show push button is used to display the selections made within the example
 area of the tab.  And once you have shown the revised container, you can test
 its operation to see if this what you want to use as your default.

 Presentation Manager Guide and Reference:

       About Container Controls
            Container Control Functionality
            Container Items
            Container Views
       Using Container Controls
            Creating a Container
            Allocating Memory for Container Records
            Allocating Memory for Container Columns
            Inserting Container Records
            Removing Container Records
            Setting the Container Control Focus
            Using Container Views
            Changing a Container View
       Graphical User Interface Support for Container Controls
            Scrolling
            Dynamic Scrolling
            Selecting Container Items
            Providing Emphasis
            Using Direct Manipulation
       Graphical User Interface Support for Container Controls
            Positioning Container Items
            Specifying Space between Container Items
            Providing Source Emphasis
            Providing Target Emphasis
            Specifying Deltas for Large Amounts of Data
            Directing Editing of Text in a Container
            Searching for Exact Text String Matches
            Specifying Container Titles
            Specifying Fonts and Colours
            Drawing Container Items and Painting Backgrounds
            Filtering Container Items
            Optimizing Cintainer Memory Usage
       Sample Code for Container Controls
            Container Application Sample Code
       Container Control Window Processing
            Container Control Styles and Selection Types
            Container Control Data


ΓòÉΓòÉΓòÉ 368. Help for Slider Tab ΓòÉΓòÉΓòÉ

Note:  This control is only available for OS/2 2.0, 2.1, 2.11, Warp and above.
       You will require the IBM OS/2 2.0 Toolkit to be able to use this option.

 The Slider tab is used to set the slider orientation, display offset, button
 placement and home position. It is also used to set the ID symbol and value.

 Orientation can be:

     Horizontal
     Vertical

 Shaft offset can be:

     Center
     Bottom
     Top
     Left
     Right

 Button placement can be:

     Bottom
     Top
     Left
     Right

 Home position can be:

     Bottom
     Top
     Left
     Right

 General options are:

     Snap to increment
     Owner draw
     Read only
     Ribbon strip

 Primary scale can be:

     Scale 1
     Scale 2

 Base styles are:

     Visible
     Tab stop
     Group
     Disabled

 The Default push button is used to reset the values entered to the Prominare
 Designer defaults.

 The Show push button is used to display the selections made within the example
 area of the tab.  And once you have shown the revised slider, you can test its
 operation to see if this what you want to use as your default.

 Presentation Manager Guide and Reference:

       About Slider Controls
            Linear Sliders
            Circular Sliders
       Using Slider Controls
            Creating a Linear Slider
            Retrieving Data for a Selected Slider Values
            Creating a Circular Slider
            Circular Slider Sample
       Graphical User Interface Support for Slider Controls
            Slider Navigation Techniques
       Slider Control Window Processing
            Slider Control Styles


ΓòÉΓòÉΓòÉ 369. Help for Value Set Tab ΓòÉΓòÉΓòÉ

Note:  This control is only available for OS/2 2.0, 2.1, 2.11, Warp and above.
       You will require the IBM OS/2 2.0 Toolkit to be able to use this option.

 The Value Set tab is used to set the display type and general options of the
 value set. It is also used to set the ID symbol and value.

 Default items can be:

     Bitmap
     Icon
     Text
     Color info
     Color indices

 General options are:

     Border
     Item border
     scale bitmaps
     Right to left ordering

 Base styles are:

     Visible
     Tab stop
     Group
     Disabled

 The Default push button is used to reset the values entered to the Prominare
 Designer defaults.

 The Show push button is used to display the selections made within the example
 area of the tab.  And once you have shown the revised value set, you can test
 its operation to see if this what you want to use as your default.

 Presentation Manager Guide and Reference:

       About Value Set Controls
            Value Set Styles
       Using Value Set Controls
            Creating a Value Set
            Retrieving Data for Selected Value Set Items
            Arranging Value Set Items
       Graphical User Interface Support for Value Set Controls
            Value Set Navigation Techniques
       Enhancing Value Set Controls Performance and Effectiveness
            Dynamic Resizing and Scrolling
       Value Set Control Window Processing
            Value Set Control Styles
            Value Set Control Data


ΓòÉΓòÉΓòÉ 370. Help for Spin Button Tab ΓòÉΓòÉΓòÉ

The Spin Button tab is used to spin button type, alignment and general options.
It is also used to set the text, ID symbol and value.

Backpage orientation can be:

Possible types are:

     Master
     Servant

 You can cause the text within the spin field to be aligned in a specific way.

 Alignment options that are possible are:

     Left
     Centered
     Right

 General options that are possible are:

     All characters
     Numeric
     Read only
     No border
     Fast spin
     Zero pad

 Base styles are:

     Visible
     Tab stop
     Group
     Disabled

 Related tabs:

     Font & colors
     Bidi
     Pen

 The Default push button is used to reset the values entered to the Prominare
 Designer defaults.

 The Show push button is used to display the selections made within the example
 area of the tab.  And once you have shown the revised spin button, you can
 test its operation to see if this what you want to use as your default.

 Presentation Manager Guide and Reference:

       About Spin Button Controls
       Using Spin Button Controls
            Creating a Spin Button
       Graphical User Interface Support for Spin Button Controls
       Spin Button Control Window Processing
            Spin Button Control Styles
            Spin Button Control Data


ΓòÉΓòÉΓòÉ 371. Help for Notebook Tab ΓòÉΓòÉΓòÉ

Note:  This control is only available for OS/2 2.0, 2.1, 2.11, Warp and above.
       You will require the IBM OS/2 2.0 Toolkit to be able to use this option.

 The Notebook tab is used to set notebook backpage orientation, tab position,
 tab type and binding. It is also used to set the text, ID symbol and value.

 Backpage orientation can be:

     Bottom right
     Bottom left
     Top right
     Top left

 Major tab side can be:

     Bottom
     Top
     Left
     Right

 Tab type can be:

     Square
     Rounded
     Polygon

 Text display options are:

     Left
     Center
     Right

 Binding options are:

     Spiral
     Solid

 Base styles are:

     Visible
     Tab stop
     Group
     Disabled

 Note:  The following styles are valid only for OS/2 Warp Version 4.0 and
        above.

 OS/2 Warp Version 4.0 styles:

     Tabbed dialogue
     Button area

 The Default push button is used to reset the values entered to the Prominare
 Designer defaults.

 The Show push button is used to display the selections made within the example
 area of the tab.  And once you have shown the revised notebook, you can test
 its operation to see if this what you want to use as your default.

 Presentation Manager Guide and Reference:

       About Notebook Controls
            Notebook Styles
       Using Notebook Controls
            Notebook Creation
            Changing Notebook Styles
            Inserting Notebook Pages
            Setting and Querying Page Information
            Associating Application Page Windows with Notebook Pages
            Deleting Notebook Pages
            Notebook Colours
       Graphical User Interface Support for Notebook Controls
            Notebook Navigation Techniques
       Enhancing Notebook Controls Performance and Effectiveness
            Dynamic Resizing and Scrolling
            Tab Painting and Positioning
       Button Control Window Processing
            Button Control Styles
            Default Colours


ΓòÉΓòÉΓòÉ 372. Help for Graphic Button Tab ΓòÉΓòÉΓòÉ

Note:  This control is only available for OS/2 2.0, 2.1, 2.11, Warp and above
       and requires the MMPM/2 or Warp toolkit to be able to use this option.

 The Graphic Button tab is used to set the display type and general options of
 the MMPM/2 graphic button. It is also used to set the ID symbol and value.

 Default items can be:

     2 state
     Auto 2 state
     Animation
     Auto animation
     Hilite bitmap
     Disable bitmap
     3D recessed text
     3D raised text

 Base styles are:

     Visible
     Tab stop
     Group
     Disabled

 The Default push button is used to reset the values entered to the Prominare
 Designer defaults.

 The Show push button is used to display the selections made within the example
 area of the tab.  And once you have shown the revised graphic button, you can
 test its operation to see if this what you want to use as your default.

 Presentation Manager Guide and Reference:

       Graphic Button Control
            WinRegisterGraphicButton
            Control Data
            Styles
            Control Messages


ΓòÉΓòÉΓòÉ 373. Help for Circular Slider Tab ΓòÉΓòÉΓòÉ

Note:  This control is only available for OS/2 2.0, 2.1, 2.11, Warp and above
       and requires the MMPM/2 or Warp toolkit to be able to use this option.

 The Circular Slider tab is used to set the display type and general options of
 the circular slider. It is also used to set the ID symbol and value.

 Default items can be:

     Mid-point tick
     No value buttons
     No dial numbers
     No dial text
     Direct manipulation
     360┬░ scroll range
     Proportional ticks
     No ticks
     Circular value

 Base styles are:

     Visible
     Tab stop
     Group
     Disabled

 The Default push button is used to reset the values entered to the Prominare
 Designer defaults.

 The Show push button is used to display the selections made within the example
 area of the tab.  And once you have shown the revised circular slider, you can
 test its operation to see if this what you want to use as your default.

 Presentation Manager Guide and Reference:

       About Slider Controls
            Linear Sliders
            Circular Sliders
       Using Slider Controls
            Creating a Linear Slider
            Retrieving Data for a Selected Slider Values
            Creating a Circular Slider
            Circular Slider Sample
       Graphical User Interface Support for Slider Controls
            Slider Navigation Techniques
       Slider Control Window Processing
            Slider Control Styles


ΓòÉΓòÉΓòÉ 374. Help for Handwriting Tab ΓòÉΓòÉΓòÉ

Note:  This control is only available for Pen for OS/2 and requires the Pen for
       OS/2 toolkit to be able to use this option.

 The Handwriting tab is used to set the display type and general options of the
 handwriting control. It is also used to set the ID symbol and value.

 Default items can be:

     Border
     3D border

 Base styles are:

     Visible
     Tab stop
     Group
     Disabled

 The Default push button is used to reset the values entered to the Prominare
 Designer defaults.

 The Show push button is used to display the selections made within the example
 area of the tab.  And once you have shown the revised handwriting control, you
 can test its operation to see if this what you want to use as your default.

 Pen for OS/2 Programming Guide and Reference:

       Using the Boxed Handwriting Control and Pen-Aware PM Controls
            Boxed Handwriting Control
                 Creating a Window in Boxed Mode
                      Using Default Values for  Handwriting Control
                 Using Handwriting Controls in a Dialogue Window
                 Sizing a Boxed Handwriting Control
                 Gestures Support by the HWX Control
            Pen-Aware PM Controls
                 Using the Flat Structures
                 Using the Non-Flat Structures
                 Creating a Single-Line Entry-Field Control with a Non-Flat
                Structure
                 Creating a Multi-Line Entry-Field Control with a Non-Flat
                Structure
                 Creating a Multi-Line Entry-Field Control with a Flat
                Structure
                 Changing the Metrics and Restricting Recognition for an MLE
                 Creating a Combo Box Control
                 Creating a Spin Button Control
                 Gestures Supported by the Pen-Aware Controls
            Sample Programs
                 Handwriting Control Sample (HWX_SAMP)
                 Sketch/Handwriting Sample Program


ΓòÉΓòÉΓòÉ 375. Help for Sketch Tab ΓòÉΓòÉΓòÉ

Note:  This control is only available for Pen for OS/2 and requires the Pen for
       OS/2 toolkit to be able to use this option.

 The Sketch tab is used to set the display type and general options of the
 sketch control. It is also used to set the ID symbol and value.

 Default items can be:

     Border
     3D border

 Base styles are:

     Visible
     Tab stop
     Group
     Disabled

 The Default push button is used to reset the values entered to the Prominare
 Designer defaults.

 The Show push button is used to display the selections made within the example
 area of the tab.  And once you have shown the revised sketch control, you can
 test its operation to see if this what you want to use as your default.

 Pen for OS/2 Programming Guide and Reference:

       Using the Sketch Control
            How the Sketch Control Operates
            Using Sketch Controls in a Dialogue Window
            Using Sketch Controls in a Client Window
            Using Control Style Bits
            Sending Window Messages
            Receiving Notification Messages from the Sketch Control
            Sample Programs
                 Sketch/Handwriting Sample Program (APPLIC)
                 Sketch Control Sample (SKETSAMP)


ΓòÉΓòÉΓòÉ 376. Help for Configure Options Tab ΓòÉΓòÉΓòÉ

Select Options tabs is used to set the auto sizing option where the target
display type is used to size the control.  For example, if you are working on a
system that is 1024 x 768, there will be a good chance that the controls you
are using will be clipped on a VGA (640 x 480) system if the limits to the
control are based on the text that is shown within the control.  By selecting
this option, the auto sizing within the alignment dialogue Sizing tab will
target the font metrics of the target VGA instead of using the font metrics of
the 1024 x 768.  This will help to ensure that the control when displayed on
the VGA system is not clipped.

You can also specify the time frequency for the auto-saving of the design
information through the Frequency spin-field.

The display of the startup dialogue is specified through the Display initial
action dialogue check box.  By selecting this option, the Prominare Designer
Startup dialogue will be displayed.

The Radix group is used to set the display radix of the ID values.  The radix
can be either Decimal or Hexadecimal

The Clear entry fields group is used to set the manor in which the entry fields
within the following dialogues handled when an entry is added or changed.
These are:

     Accelerator Tables Resource
     String Resource
     Message Resource
     Bitmap, Font, Icon and Pointer Resource
     Custom Resource
     Help Table
     Help Sub-Table
     Help Table Items
     Help Sub-Table Item
     Association Table
     Resource Table
     Menu Styles

 To allow the the entry fields to be cleared after you have added an item,
 select the On add check box.  To allow the entry fields to be cleared after
 you have changed an item, select the On change check box.


ΓòÉΓòÉΓòÉ 377. Help for Options Tab ΓòÉΓòÉΓòÉ

The Options tab is used to the margins, control spacing, grid values, source
code tab usage, source code right margins and the push button spacing as well
as select the display radix for the status window.

It also allows you to define how the entry fields should operate in dialogues
that allow you to edit or enter multiple items such menus, bitmaps, pointers.
etc.  You can specify that the entry fields be cleared on an add operation
and/or on a change operation.


ΓòÉΓòÉΓòÉ 378. Help for Index Colours Tab ΓòÉΓòÉΓòÉ

The Index colors tab contains the index colors that you can select for use the
color of a selected presentation parameter.

The colors will be displayed within a 3 x 6 grid from which you can select the
desired color.  The proper name of the color will be displayed beside this
grid.


ΓòÉΓòÉΓòÉ 379. Help for RGB Colours Tab ΓòÉΓòÉΓòÉ

The RGB colors tab contains three spin buttons in which you can enter the
values that are to be used as the RGB color along with a color circle that can
also be used to select the desired color from.

When you enter a value within one of the spin fields, the cross hair of the
color circle will be moved to the corresponding location of the RGB color.

Conversely, when you move the cross hair of the color circle to the desired
color, the spin fields will be updated to the value of the RGB color selected.


ΓòÉΓòÉΓòÉ 380. Help for .RC/.RES Tab ΓòÉΓòÉΓòÉ

The .RC/.RES tab is used to enter the name and location for both .RC and .RES
files.  Through the entry field labeled .RC you can enter the name and location
for the resource script file.  The entry field labeled .RES is used for the
name and location of the .RES file when such a file is produced through
Prominare Designer.

You need to complete both of the entry fields before you click the mouse
pointer on the Add push button.

To change an entry, you can select the item from the list box and then make the
changes within the entry fields before clicking the mouse pointer on the Change
push button.

You can delete an entry by selecting the desired item within the list box and
then click athe mouse pointer on the Delete push button.

The values that you enter can then be selected through the Resource
Distribution dialogue.


ΓòÉΓòÉΓòÉ 381. Help for Search and Replace ΓòÉΓòÉΓòÉ

The Search and Replace dialogue allows you to enter text to search for within
the Search entry field and the replacement text within the Replace entry field
and when you click the mouse pointer on the Replace push button will search the
resource entry and replace the searched for text.


ΓòÉΓòÉΓòÉ 382. Help for Window/Dialogue Tab ΓòÉΓòÉΓòÉ

The Window or Dialogue tab is used to select the location and filename that the
window or dialogue resource information should be placed within.  Since
Prominare Designer allows you to distribute the resources of the design, you
need to select the location and file under which this information is to be
placed.

The files and locations that the dialogue or window information can be placed
is contained within a list box.  You only need to select the desired file and
location within the list box by clicking the mouse pointer on the desired item.

The location and file will be displayed above the list box.


ΓòÉΓòÉΓòÉ 383. Help for Menu Tab ΓòÉΓòÉΓòÉ

The Menu tab is used to select the location and filename that the menu resource
information should be placed within.  Since Prominare Designer allows you to
distribute the resources of the design, you need to select the location and
file under which this information is to be placed.

The files and locations that the menu information can be placed is contained
within a list box.  You only need to select the desired file and location
within the list box by clicking the mouse pointer on the desired item.

The location and file will be displayed above the list box.


ΓòÉΓòÉΓòÉ 384. Help for Accelerator Table Tab ΓòÉΓòÉΓòÉ

The Accelerator table tab is used to select the location and filename that the
accelerator resource information should be placed within.  Since Prominare
Designer allows you to distribute the resources of the design, you need to
select the location and file under which this information is to be placed.

The files and locations that the accelerator information can be placed is
contained within a list box.  You only need to select the desired file and
location within the list box by clicking the mouse pointer on the desired item.

The location and file will be displayed above the list box.


ΓòÉΓòÉΓòÉ 385. Help for Help Tables Tab ΓòÉΓòÉΓòÉ

The Help tables tab is used to select the location and filename that the help
table resource information should be placed within.  Since Prominare Designer
allows you to distribute the resources of the design, you need to select the
location and file under which this information is to be placed.

The files and locations that the help table information can be placed is
contained within a list box.  You only need to select the desired file and
location within the list box by clicking the mouse pointer on the desired item.

The location and file will be displayed above the list box.


ΓòÉΓòÉΓòÉ 386. Help for Resources Tab ΓòÉΓòÉΓòÉ

The Resource tab is used to select the location and filename that the resource
information should be placed within.  Since Prominare Designer allows you to
distribute the resources of the design, you need to select the location and
file under which this information is to be placed.

The files and locations that the resource information can be placed is
contained within a list box.  You only need to select the desired file and
location within the list box by clicking the mouse pointer on the desired item.

The location and file will be displayed above the list box.


ΓòÉΓòÉΓòÉ 387. Help for Alignment Tab ΓòÉΓòÉΓòÉ

The Alignment tab is used to select the alignment type for the controls within
the group of controls selected.

For horizontal alignment, the first selection: indicates that you do not want
any horizontal alignment.

The second selection: indicates that you want the controls aligned left
justified.

The third selection: indicates that you want the controls aligned
centerjustified.

The last selection: indicates that you want the controls aligned right
justified.

For vertical alignment, the first selection: indicates that you do not want any
vertical alignment.

The second selection: indicates that you want the controls aligned top
justified.

The third selection: indicates that you want the controls aligned
centerjustified.

The last selection: indicates that you want the controls aligned bottom
justified.


ΓòÉΓòÉΓòÉ 388. Help for Spacing Tab ΓòÉΓòÉΓòÉ

The Spacing tab is used to select the spacing type for the controls within the
group of controls selected.

The first selection: indicates that you do not want any special sizing for the
controls selected.

The second selection: indicates that you want the controls selected to be
spaced horizontally within the window or dialogue.  The controls will be
started from the margin specified on the left and spaced across from left to
right.

The last selection: indicates that you want the controls selected to be spaced
vertically within the window or dialogue.  The controls will be started from
the margin specified on the bottom and spaced across from bottom to top.


ΓòÉΓòÉΓòÉ 389. Help for Shift Tab ΓòÉΓòÉΓòÉ

The Shift tab is used to shift the group of controls selected to the
orientation position selected within the tab.

The first selection: indicates that you do not want any special shifting for
the controls selected.

The second selection: indicates that you want the controls selected to be
shifted to the top edge of the dialogue or window.

The third selection: indicates that you want the controls selected to be
shifted to the right edge of the dialogue or window.

The fourth selection: indicates that you want the controls selected to be
shifted to the bottom edge of the dialogue or window.

The fifth selection: indicates that you want the controls selected to be
shifted to the left edge of the dialogue or window.

The sixth selection: indicates that you want the controls selected to be
shifted to the top right of the dialogue or window.

The seventh selection: indicates that you want the controls selected to be
shifted to the bottom right of the dialogue or window.

The eighth selection: indicates that you want the controls selected to be
shifted to the bottom left of the dialogue or window.

The last selection: indicates that you want the controls selected to be shifted
to the top left of the dialogue or window.


ΓòÉΓòÉΓòÉ 390. Help for Size Tab ΓòÉΓòÉΓòÉ

The Size tab is used to select the method in which the selected group of
controls are automatically sized and/or equally sized.

The top row is used to indicate that you wish to have the selected controls
automatically sized for the text.  The button and text controls will be sized
such that the limits of the control are based on the visible text.

The first selection: indicates that you do not want any auto-sizing for the
controls selected.

The second selection: indicates that you want the controls selected to be
auto-sized.

The next row is used to indicate that you want the controls selected to be
sized based on the anchor control either vertically or horizontally.

The first selection: indicates that you do not want any special sizing for the
controls selected.

The second selection: indicates that you want the controls selected to be equal
in width.

The last selection: indicates that you want the controls selected to be equal
in height.


ΓòÉΓòÉΓòÉ 391. Help for Push Buttons Tab ΓòÉΓòÉΓòÉ

The Push buttons tab is used to select the method in which push buttons within
the group selected are aligned and spaced within the dialogue or window you are
designing.

The first selection: indicates that you do not want any special push button
alignment for the push buttons that may be within the group of controls
selected.

The second selection: indicates that you want the push buttons that may be
within the group of controls selected aligned at the bottom of the dialogue or
window.

The second last selection: indicates that you want the push buttons that may be
within the group of controls selected aligned at the right side of the dialogue
or window starting from the top of the dialogue or window.

The last selection: indicates that you want the push buttons that may be within
the group of controls selected aligned at the bottom side of the dialogue or
window starting from the right moving to the left of the dialogue or window.


ΓòÉΓòÉΓòÉ 392. Help for Dialogues/Windows Tab ΓòÉΓòÉΓòÉ

The Dialogues/Windows tab is used to select the dialogues and windows that you
wish to paste into the current design from the file selected.

Each of the dialogues and windows contained within the design file selected
will be shown within the list box.  Each item will contain the dialogue or
window description, ID and type.

You can select more that one item that is to be pasted into the design you are
working on using the list box extended selection interface.

Note:  Any ID conflicts of the dialogues or windows that are pasted into the
       current design will have new ID values.


ΓòÉΓòÉΓòÉ 393. Help for Resources Tab ΓòÉΓòÉΓòÉ

The Resources tab is used to select the resources that you wish to paste into
the current design from the file selected.

Each of the resources contained within the design file selected will be shown
within the list box.  Each item will contain the resource file, ID and type.

You can select more that one item that is to be pasted into the design you are
working on using the list box extended selection interface.

Note:  Any ID conflicts of the resources that are pasted into the current
       design will have new ID values.


ΓòÉΓòÉΓòÉ 394. Help for Strings/Messages Tab ΓòÉΓòÉΓòÉ

The Strings/Messages tab is used to select the strings and messages that you
wish to paste into the current design from the file selected.

Each of the strings and messages contained within the design file selected will
be shown within the list box.  Each item will contain the string or message
text, ID and type.

You can select more that one item that is to be pasted into the design you are
working on using the list box extended selection interface.

Note:  Any ID conflicts of the strings or messages that are pasted into the
       current design will have new ID values.


ΓòÉΓòÉΓòÉ 395. Help for Association Table Tab ΓòÉΓòÉΓòÉ

The Association Table tab is used to select the association table items that
you wish to paste into the current design from the file selected.

Each of the association table items contained within the design file selected
will be shown within the list box.  Each item will contain the association
name, extension and icon.

You can select more that one item that is to be pasted into the design you are
working on using the list box extended selection interface.


ΓòÉΓòÉΓòÉ 396. Help for Pen Options Dialogue ΓòÉΓòÉΓòÉ

The Pen Options dialogue allows you to set various pen options for controls
that support pen data.  These controls are:

      Entry field
      Multiple-line entry field
      Combo-box
      Spin button
      Handwriting control

 Note:  For the options to be available to you, you must be running Pen for
        OS/2 Version 1.03 or higher.

 You can set options for the following:

      Layouts/Resource
      Options
      Layouts/Resource
      Symbol Sets
      Include/Exclude Regions


ΓòÉΓòÉΓòÉ 397. Help for Layouts/Resource Tab ΓòÉΓòÉΓòÉ

The Layouts/Resource tab allows you to specify the name of the DLL that
contains the pointer resources if these resources do not reside within the
executable.  You enter the name of the DLL within the entry field Name.

These pointers can be selected or entered through the ID fields labeled
Proximity and Writing.  The Proximity pointer is is used by the pen sub-system
when-ever the pointer is within the proximity of the control.  The Writing
pointer is used when-ever writing within the control is occurring.

You can specify the line layout width and spacing within the entry fields Width
and Spacing.  If you want to use the pen system defaults for these values, you
can simply click the mouse pointer on the Defaults check box.  You can also
select the color that is to be used from the color selections.

When you are selecting the pen options for the handwriting control, you can
specify the box layout instead of the line layout.  In this case, you can set
the box width and height through the entry fields Width and Height.  If you
want to use the pen system defaults for these values, you can simply click the
mouse pointer on the Defaults check box.  You can also select the color that is
to be used from the color selections.


ΓòÉΓòÉΓòÉ 398. Help for Options Tab ΓòÉΓòÉΓòÉ

Through the Options tab, you can set the various options that are to be used by
the pen sub-system when pen is being used with the control.

For the trigger, you can set the following:

      Exit proximity
      Lift off
      Timeout

 For the language modeling, you can set the following:

      Word case
      Sentence case
      Alphanumeric
      Punctuation

 For the recoginition form, you can select one of the following:

      Boxed
      Lined
      Unlined

 For the dictionary influence, you can select one of the following:

      None
      Advise
      Force
      Reject

 You can also for the dictionary influence, you can set the following:

      Case force

 For the symbol set, you can set the following:

      Full
      Lowercase
      Uppercase
      Digit
      Punctuation
      Special


ΓòÉΓòÉΓòÉ 399. Help for Inks Tab ΓòÉΓòÉΓòÉ

The Inks tab allows you to specify the type of inking that should occur within
the control.

The first two options determine how this tab can be used.  If you select the
System option, you cannot select any options within the tab.  Conversely, if
you select the Window option, you can select the options within the tab.

The line width options are:

      Default

      Normal

      Thick

 The color is selected from the color set and the line type is selected from
 the line set.

 The mix that is used to draw the lines can be one of the following:

      Default

      Or

      Overpaint

      Leave alone

      Xor

      And

      Subtract

      Mask src not

      Zero

      Not merge src

      Not xor src

      Invert

      Merge src not

      Not copy src

      Merge not src

      Not mask src

      One


ΓòÉΓòÉΓòÉ 400. Help for Symbol Sets Tab ΓòÉΓòÉΓòÉ

Through the Symbol sets tab you can select the symbol sets that the pen
sub-system is to use.  The upper set of symbols is the gesture set.  You can
select any combination of gestures to include within the symbol set.

Likewise, you can select any combination of the character symbols that are
found below the gestures.


ΓòÉΓòÉΓòÉ 401. Help for Include/Exclude Tab ΓòÉΓòÉΓòÉ

The Include/exclude tab is used to define the include region along with the
exlcude regions that the pen sub-system is to use.  The include region by
default is defined to be the entire display. You can define a smaller area (in
dialogue units) through the entry fields x, y, Width and Depth.

The exlcude regions are defined for the controls that can receive input from
the user.  Generally, you want to define the areas that should be excluded from
the input include region such that if the pen is moved to one of these areas,
that area receives the focus just like it would if you were using the mouse.

To define the controls that should be excluded, you select the items within the
list box.  You can select more than one control to exclude at a time by using
the list box extended selection techniques.


ΓòÉΓòÉΓòÉ 402. Help for Edit Windows Message Dialogue ΓòÉΓòÉΓòÉ

The Edit Windows Message dialogue is used to select and edit the default code
for messages that will be received by a window and that can be included as the
default message handling for a window that you are designing.

You select the message to view or edit by select the message from the Message
combination box.  After selecting the message, the default code will be
displayed within the read-only edit field below the combination box.

To edit the comments defined for the message, select the tab labeled Comments.
The body of the message handling can be edited by selecting the tab labeled
Body.  Finally, to edit the break or return of the message, select the tab
labeled break/return.

To clear the defined code for the message, select the Clear push button.

The default code for the message can be set by selecting the push button
labeled Defaults.  This will cause the defined source code to be:

                       /*                                               */
   case WM_* :
       breakshift op

To define the formating rules for use by the Format and Format all push
buttons, select the Define format... push button.  This will cause the Source
Format dialogue to be displayed through which you can define the comment type
and the indent levels for the source code when it is formatted.

The Save push button is used to accept the values entered, whereas, the Cancel
push button is used to reject the values entered.


ΓòÉΓòÉΓòÉ 403. Help for Edit Dialogues Message Dialogue ΓòÉΓòÉΓòÉ

The Edit Dialogues Message dialogue is used to select and edit the default code
for messages that will be received by a dialogue and that can be included as
the default message handling for a dialogue that you are designing.

You select the message to view or edit by select the message from the Message
combination box.  After selecting the message, the default code will be
displayed within the read-only multi-line entry field below the combination
box.

To edit the comments defined for the message, select the tab labeled Comments.
The body of the message handling can be edited by selecting the tab labeled
Body.  Finally, to edit the break or return of the message, select the tab
labeled break/return.

To clear the defined code for the message, select the Clear push button.

The default code for the message can be set by selecting the push button
labeled Defaults.  This will cause the defined source code to be:

                       /*                                               */
   case WM_* :
       breakshift op

To define the formating rules for use by the Format and Format all push
buttons, select the Define format... push button.  This will cause the Source
Format dialogue to be displayed through which you can define the comment type
and the indent levels for the source code when it is formatted.

The Save push button is used to accept the values entered, whereas, the Cancel
push button is used to reject the values entered.


ΓòÉΓòÉΓòÉ 404. Help for Edit Notify Messages Dialogue ΓòÉΓòÉΓòÉ

The Edit Notify Messages dialogue is used to select and edit the default code
for notification messages that will be received by a window or dialogue and
that can be included as the default message handling for a window or dialogue
that you are designing within the WM_CONTROL message.

You select the message to view or edit by select the message from the Message
combination box.  After selecting the message, the default code will be
displayed within the read-only multi-line entry field below the combination
box.

To edit the comments defined for the message, select the tab labeled Comments.
The body of the message handling can be edited by selecting the tab labeled
Body.  Finally, to edit the break or return of the message, select the tab
labeled break/return.

To clear the defined code for the message, select the Clear push button.

The default code for the message can be set by selecting the push button
labeled Defaults.  This will cause the defined source code to be:

                        /*                                              */
           case BN_CLICKED :
              switch ( SHORT1FROMMP(mp1) )
                   {
                   case <id>
                        breakshift op
                   }
              breakshift op

To define the formating rules for use by the Format and Format all push
buttons, select the Define format... push button.  This will cause the Source
Format dialogue to be displayed through which you can define the comment type
and the indent levels for the source code when it is formatted.

The Save push button is used to accept the values entered, whereas, the Cancel
push button is used to reject the values entered.


ΓòÉΓòÉΓòÉ 405. Help for Edit Source Dialogue ΓòÉΓòÉΓòÉ

The Edit Source dialogue is used to edit the code of various areas, with the
area selected shown beside the Area label.

Generally, you enter or edit the default code for:

     Module start
     Header start
     Window declaration
     Dialogue declaration

 For the coding for a window declaration could be:

  #pragma subtitle("   Client Window - Client Window Procedure")
  #pragma page( )

  /* --- <pfnWndProc> --------------------------------------------------- */
  /*                                                                      */
  /*     This function is used to process the messages sent to the        */
  /*     applications client window.                                      */
  /*                                                                      */
  /*     Upon Entry:                                                      */
  /*                                                                      */
  /*     HWND   hWndshift op = Window Handle                                     */
  /*     ULONG  msgshift op  = PM Message                                        */
  /*     MPARAM mp1shift op  = Message Parameter 1                               */
  /*     MPARAM mp2shift op  = Message Parameter 2                               */
  /*                                                                      */
  /*     Upon Exit:                                                       */
  /*                                                                      */
  /*     <pfnWndProc> = Message Handling Result                           */
  /*                                                                      */
  /* -------------------------------------------------------------------- */

  MRESULT EXPENTRY <pfnWndProc>(HWND hWnd, ULONG msg, MPARAM mp1, MPARAM mp2)

  {
  <localvars>

  switch ( msg )
     {
     <statements>
                          /* Default message processing                   */
     default :
         return(<defwinproc>(hWnd, msg, mp1, mp2))shift op
     }
  return(0L)shift op
  }

 You can use the following macro symbols within a command definition:

     <-date->
     <-file->
     <localvars>
     <pfnDlgProc>
     <pfnWndProc>
     <statements>
     <defwinproc>

 The Enter push button is used to accept the values entered, whereas, the
 Cancel push button is used to reject the values entered.


ΓòÉΓòÉΓòÉ 406. Help for Edit Command Definitions Dialogue ΓòÉΓòÉΓòÉ

The Edit Command Definitions dialogue is used to select and edit the default
code for various invocation methods.

Generally, the methods that are available are:

     Nothing
     if ( WinDlgBox(...) )
     WinDlgBox(...)
     WinLoadDlg(...)
     WinCreateWindow(...)
     WinCreateStdWindow(...)
     DID_OK
     DID_CANCEL

 When you select a method, you enter how the method should be completed.  For
 example, the default source for the if ( WinDlgBox(...) ) could be:


      case <id> :
          if ( WinDlgBox(HWND_DESKTOP, <hwndFrame>, <pfnDlgProc>,
                         (HMODULE)NULL, <idDlg>, NULL) )
              {
              }
          breakshift op

 You can use the following macro symbols within a command definition:

     <id>
     <idActionBar>
     <idButton>
     <idDlg>
     <idMenu>
     <DID_OK>
     <DID_CANCEL>

 You enter local variables that are to be used by the definition in the edit
 control labeled Local variables.  The body of the command for the method is
 entered in the edit control labeled Body.

 The definition can be deleted by selecting the Clear push button.


ΓòÉΓòÉΓòÉ 407. Help for Edit Text Dialogue ΓòÉΓòÉΓòÉ

The Edit Text dialogue is used to edit the default code for the area selected.

The Save push button is used to accept the values entered, whereas, the Cancel
push button is used to reject the values entered.


ΓòÉΓòÉΓòÉ 408. Help for Body Tab ΓòÉΓòÉΓòÉ

The Body tab is used to edit the default code for the messages selected.
Through the edit control labeled Local variables you can enter the local
variables that are required by the message handling.

The actual message handling code is entered through the edit control labeled
Body source code.


ΓòÉΓòÉΓòÉ 409. Help for Prologue Tab ΓòÉΓòÉΓòÉ

The Prologue tab is used to select and edit the default code for messages that
will be received by a window and that can be included as the default message
handling for a window that you are designing.


ΓòÉΓòÉΓòÉ 410. Help for Source Code Layout Dialogue ΓòÉΓòÉΓòÉ

The Source Code Layout dialogue is used to select select messages that are to
be used as the default for each new window or dialogue created.

You select the message to include from the Message combination box.  You view
the messages selected in the Selected combination box.

The source code as it would appear within a source file the first time it was
created is displayed in the read-only multi-line entry field below the
combination boxes.

To add a message, select the message from the Message combination box and click
the Add push button.

To clear the messages selected thus far, click on the Clear push button.

The Enter push button is used to accept the values entered, whereas, the Cancel
push button is used to reject the values entered.


ΓòÉΓòÉΓòÉ 411. Help for Comments Tab ΓòÉΓòÉΓòÉ

The Comments tab is used to select and edit the default comment for messages
that will be received by a window and that can be included as the default
message handling for a window that you are designing.


ΓòÉΓòÉΓòÉ 412. Help for Body Tab ΓòÉΓòÉΓòÉ

The Body tab is used to edit the default code for the messages selected.
Through the edit control labeled Local variables you can enter the local
variables that are required by the message handling.

The actual message handling code is entered through the edit control labeled
Body source code.


ΓòÉΓòÉΓòÉ 413. Help for break/return Tab ΓòÉΓòÉΓòÉ

The break/return tab is used to edit the default code for the break or return
of a message that will be received by a window and that can be included as the
default message handling for a window that you are designing.


ΓòÉΓòÉΓòÉ 414. Help for Edit Command Definitions ΓòÉΓòÉΓòÉ

The current tab is used to select and edit the default code for various
invocation methods.

Generally, the methods that are available are:

     Default
     if ( WinDlgBox(...) )
     WinDlgBox(...)
     WinLoadDlg(...)
     WinCreateWindow(...)
     WinCreateStdWindow(...)
     DID_OK
     DID_CANCEL

 When you select a method, you enter how the method should be completed.  For
 example, the default source for the if ( WinDlgBox(...) ) could be:


      case <id> :
          if ( WinDlgBox(HWND_DESKTOP, <hwndFrame>, <pfnDlgProc>,
                         (HMODULE)NULL, <idDlg>, NULL) )
              {
              }
          breakshift op

 You can use the following macro symbols within a command definition:

     <id>
     <idActionBar>
     <idButton>
     <idDlg>
     <idMenu>
     <DID_OK>
     <DID_CANCEL>

 You enter local variables that are to be used by the definition in the
 multi-line entry field labeled Local variables.  The body of the command for
 the method is entered in the multi-line entry field labeled Body.

 The definition can be deleted by selecting the Clear push button at the bottom
 of the dialogue.


ΓòÉΓòÉΓòÉ 415. Help for Source Definition Tab ΓòÉΓòÉΓòÉ

The Definition tab contains the composed source for the message selected.


ΓòÉΓòÉΓòÉ 416. Help for Source Definition Tab ΓòÉΓòÉΓòÉ

Within the tab is an edit control where you can enter or edit the source code
definition for a paraticular area.


ΓòÉΓòÉΓòÉ 417. Help for Edit Default Class Source Dialogue ΓòÉΓòÉΓòÉ

The Edit Default Class Source dialogue allows you to enter and edit the the
source code for the class definitions that are used to create the class
definition for the application your are designing.  The areas for which you can
define the class definitions for are:

      Parent window
      Secondary window
      Dialogue
      Modeless dialogue
      Child window

 Each area has a separate tab in which the class definition can be defined.


ΓòÉΓòÉΓòÉ 418. Help for Source Format Dialogue ΓòÉΓòÉΓòÉ

The Source Format dialogue allows you to define the indent levels for various
areas within a source code rule as well as the comment style.

These values are then used when you click on the Format or Format all push
buttons contained within the Edit Window Messages, Edit Dialogue Messages or
Edit Notification Messages dialogues.

You can set the indent levels for the case, comment, source boday, variables
and notify areas.

The indent value is then use to place the particular item at that column
position.  For example if the case indent was 4, the c of the case keyword
would be at column position 4.

For the comment type, simple is

/* This is a comment */
Left is

/*
 *This is a comment
 */
and block is

/********************/
/*This is a comment */
/********************/


ΓòÉΓòÉΓòÉ 419. Help for Export Source Rules Dialogue ΓòÉΓòÉΓòÉ

The Export Source Rules dialogue is used to export the source coding rules to
an ASCII file that can be edited using a standard text or source code editor.

You can specify the name underwhich the source code rules are to be exported
within the entry field labeled Filename..

You can select the directory to place the file by selecting the area through
the list box below the entry field.

Once you have edited the source code rules, you can then import them back using
the Source Import menu item.


ΓòÉΓòÉΓòÉ 420. Help for Import Source Rules Dialogue ΓòÉΓòÉΓòÉ

The Import Source Rules dialogue allows you to open a file containing the
source coding rules that was exported through the Export Source Rules dialogue
and edited using a standard text or source code editor.

Two list boxes are found within the dialogue: one for the directory list and
one for files.

You can select a different drive or subdirectory by double clicking the mouse
pointer on the entry desired.

To select the file to open, double click on the desired file within the files
list box or enter the filename within the entry field at the top of the
dialogue.

The Open push button is used to open the file listed within the entry field,
whereas, the Cancel push button is used to cancel the values the open request.


ΓòÉΓòÉΓòÉ 421. Help for Parent Window ΓòÉΓòÉΓòÉ

When working with a design, there is usually one main window for the design.
This window is generally known as the Parent Window .

The Parent Window is in most cases a descendant of the Desktop but can also be
a descendant of an Object Window.

Generally, when the Parent Window is a descendant of the Desktop, the window
created can be shown and hidden at will whereas when it is a descendant of an
Object Window, the Parent Window is never visible and it does not have a size.

The Parent Window can have descendants which can be either Child Windows or
Dialogues.

Note:  There can only be one Parent Window defined within Prominare Designer.


ΓòÉΓòÉΓòÉ 422. Help for Child Window ΓòÉΓòÉΓòÉ

A Child Window is window which is used to provide secondary information in
conjunction with the main Parent Window of the program.

The Child Window can be a descendant of either the Desktop or the Main Window.

When the Child Window is a descendant of the Desktop, the window can be moved
anywhere on the desktop.  When the Main Window is moved or minimized, the Child
Window usually is not affected.

When it is a descendant of the Main Window, it can only be moved within the
Main Window.  When the Main Window is moved or minimized, the Child Window is
moved or hidden with it.


ΓòÉΓòÉΓòÉ 423. Help for Dialogue ΓòÉΓòÉΓòÉ

A Dialogue is window which is used to provide either information or a means of
allowing the user to enter specific data to the program.

By default, the dialogue is a child of the Main Window.

The Dialogue cannot have menus or general acclerators associated with them but
can have most other styles that a normal window can have.


ΓòÉΓòÉΓòÉ 424. Help for Notebook Page ΓòÉΓòÉΓòÉ

A Notebook page is window which is used to provide either information or a
means of allowing the user to enter specific data to the program which is
associated to a specific notebook that is contained within a window or
dialogue.

To aid in the design of a notebook page, a notebook is displayed which is the
size of the notebook associated in the notebook linkage group.


ΓòÉΓòÉΓòÉ 425. Help for WP Settings Page ΓòÉΓòÉΓòÉ

A WP Settings page is a window which is used to provide either information or a
means of allowing the user to enter specific data to the program which is
associated to a specific notebook that is contained within a Workplace Settings
page.

To aid in the design of a Workplace Settings page, a Workplace Settings
notebook is displayed.


ΓòÉΓòÉΓòÉ 426. Help for Decimal ΓòÉΓòÉΓòÉ

If you want the display of ID symbols to be decimal, select the Decimal radio
button.  Alternately, if you want the display of the ID symbols to be
hexidecimal, select the Hex radio button.


ΓòÉΓòÉΓòÉ 427. Help for Hex ΓòÉΓòÉΓòÉ

If you want the display of ID symbols to be hexidecimal, select the Hex radio
button.  Alternately, if you want the display of the ID symbols to be
hexidecimal, select the Decimal radio button.


ΓòÉΓòÉΓòÉ 428. Help for Title Bar Style ΓòÉΓòÉΓòÉ

If you want a window or dialogue to have a Title Bar which allows the user to
select the title bar to move it around, select the Title Bar check box.

The Title Bar, as its name suggests, allows for a title to be included within
it.  This should be a short description that best exemplifies the contents of
the window or the task of the dialogue.

Note:  The OS/2 Presentation Manager limits the length of the Title Bar text to
       60 characters.


ΓòÉΓòÉΓòÉ 429. Help for System Menu Style ΓòÉΓòÉΓòÉ

The System Menu, which is located in the upper-left hand corner of a window or
dialogue.  It is not the same as the action bar and pull-down menus.  It is
mainly controlled and defined by the OS/2 Presentation Manager.

You usually include a System Menu in the main program window.

The System Menu generates WM_SYSCOMMAND messages instead of WM_COMMAND messages
and generally you allow these messages to be passed back to the system.


ΓòÉΓòÉΓòÉ 430. Help for Horz. Scroll Bar Style ΓòÉΓòÉΓòÉ

The Horz. Scroll Bar style allows you to add a Horizontal Scroll Bar to the
bottom of a window or dialogue.  You can use the Horizontal Scroll Bar to allow
the user to scroll the window horizontally.  You must provide the necessary
code to allow this in a manner that suits your application.


ΓòÉΓòÉΓòÉ 431. Help for Vert. Scroll Bar Style ΓòÉΓòÉΓòÉ

The Vert. Scroll Bar style allows you to add a Vertical Scroll Bar to the right
side of a window or dialogue.  You can use the Vertical Scroll Bar to allow the
user to scroll the window vertically.  You must provide the necessary code to
allow this in a manner that suits your application.


ΓòÉΓòÉΓòÉ 432. Help for Visible Style ΓòÉΓòÉΓòÉ

By selecting the Visible check box, you allow the window or dialogue to be
shown as soon as it is created.  There may be instances where you would prefer
to resize the window or dialogue when it is created and by not selecting
Visible, the window or dialogue will remain hidden until you resize it and then
show it.


ΓòÉΓòÉΓòÉ 433. Help for Size Border Style ΓòÉΓòÉΓòÉ

If you want to allow the user to resize the window or dialogue, you should
select the Size Border check box.

A size border will be used as the window frame and when the mouse pointer
passes over the border, the pointer will change its shape to a double header
arrow.

When the pointer is the doulbe headed arrow shape and button 1 on the mouse is
pressed, the user will be able to resize the window or dialogue as required.


ΓòÉΓòÉΓòÉ 434. Help for Border Style ΓòÉΓòÉΓòÉ

The Border check box is used to create a simple border for the window or
dialogue.  This type of frame does not allow resizing by the user and usually
appears as a single line surronding the window or dialogue.


ΓòÉΓòÉΓòÉ 435. Help for Dialogue Frame Style ΓòÉΓòÉΓòÉ

The Dialogue Frame check box is used to create a Dialogue Frame border for the
window or dialogue.  The Dialogue Frame border is the same color as the Title
Bar if one has been specified for the window or dialogue. Like the Border
style, it does not allow resizing by the user and will have some width and
depth to it.


ΓòÉΓòÉΓòÉ 436. Help for System Modal Style ΓòÉΓòÉΓòÉ

The System Modal check box is used to designate the window or dialogue as being
modal.  When used, the user will only be able to interact with that window or
dialogue.

CAUTION:
System modal should generally not be used by windows since the user will only
be able to interact with that window and will not be able to select others that
he or she has opened.


ΓòÉΓòÉΓòÉ 437. Help for Menu Style ΓòÉΓòÉΓòÉ

The Menu allows you to add an action bar menu and pull-downs to the window you
are designing.

Note:  The Menu check box will allow be available when you select Parent Window
       or Child Window radio buttons.  Menus cannot be used within Dialogues.


ΓòÉΓòÉΓòÉ 438. Help for Min Button Style ΓòÉΓòÉΓòÉ

The Min button check box allows you to add a Minimize button to the upper-right
corner of the window.

The Minimize button will allow the user to minimize the window.

When the window is minimized, the Icon for the application is placed on the
desktop.

Note:  The Min Box check box will only be available when you select Parent
       Window or Child Window radio buttons.  The Minimize button cannot be
       used within Dialogues.


ΓòÉΓòÉΓòÉ 439. Help for Max Button Style ΓòÉΓòÉΓòÉ

The Max button check box allows you to add a Maximize button to the upper-right
corner of the window.

The Maximize button will allow the user to maximize the window.

When the window is maximized, the entire desktop is replaced with the
application's window.

Note:  The Max Box check box will only be available when you select Parent
       Window or Child Window radio buttons.  The Maximize button cannot be
       used within Dialogues.


ΓòÉΓòÉΓòÉ 440. Help for Min/Max Button Style ΓòÉΓòÉΓòÉ

The Min/Max button allows you to add a Minimize button to the upper-right
corner of the window.

The Minimize button will allow the user to minimize the window whereas the
Maximize button will allow the user to maximize the window.

When the window is minimized, the Icon for the application is placed on the
desktop or within the Minimize Window Viewer.

When the window is maximized, the entire desktop is replaced with the
application's window.

Note:  The Min/Max button is only used when you select Standard.


ΓòÉΓòÉΓòÉ 441. Help for Hide Button Style ΓòÉΓòÉΓòÉ

The Hide button check box allows you to add a Hide button to the upper-right
corner of the window.

The Hide button will allow the user to hide the window.

When the window is hidden, the window is placed within the Minimized Window
Viewer.

Note:  The Hide button check box will only be available when you select Parent
       Window or Child Window radio buttons.  The Maximize button cannot be
       used within Dialogues.


ΓòÉΓòÉΓòÉ 442. Help for Accelerators Style ΓòÉΓòÉΓòÉ

The Accelerators check box allows you to add a Accelerators to the application.

The Accelerators are generally associated with pull-down menu items.

When the window is maximized, the the entire desktop is replaced with the
application's window.

An example accelerator key is:

Paste    Shift+Ins

The Shift+Ins is the accelerator defined for the Paste pull-down menu item.

Note:  The Accelerator check box will only be available when you select Parent
       Window or Child Window radio buttons.  Accelerators cannot be used be
       defined within Dialogues since they have to be associated with the main
       application window.  You can define Accelerators within a Parent Window
       and any Child Windowsshift op Prominare Designer will consolidate the
       definitions into one table since the OS/2 Presentation Manager only
       allows one Accelerator table per application.


ΓòÉΓòÉΓòÉ 443. Help for Standard Style ΓòÉΓòÉΓòÉ

The Standard check box can be used to create a Standard window.  A Standard
window includes the following styles:

     Title Bar
     System Menu
     Size Border
     Menu
     Min/Max Box
     Accelerators

 Note:  The Standard check box will only be available when you select Parent
        Window or Child Window radio buttons.


ΓòÉΓòÉΓòÉ 444. Help for Shell Position Style ΓòÉΓòÉΓòÉ

The Shell position style is used to designate that the window size and position
should be determined by the system when it is created.


ΓòÉΓòÉΓòÉ 445. Help for Window Style ΓòÉΓòÉΓòÉ

The Window radio button is used to set the relative position of the Dialogue
being designed relative to the Parent Window.

Note:  The Window radio button will only be available when you select the
       Dialogue radio button.


ΓòÉΓòÉΓòÉ 446. Help for Screen Style ΓòÉΓòÉΓòÉ

The Screen radio button is used to set the relative position of the Dialogue
being designed relative to the Desktop.

Note:  The Screen radio button will only be available when you select the
       Dialogue radio button.


ΓòÉΓòÉΓòÉ 447. Help for Mouse Style ΓòÉΓòÉΓòÉ

The Mouse radio button is used to set the relative position of the Dialogue
being designed relative to the mouse pointer position.

Note:  The Mouse radio button will only be available when you select the
       Dialogue radio button.


ΓòÉΓòÉΓòÉ 448. Help for Desktop Style ΓòÉΓòÉΓòÉ

The Desktop radio button is used to set the parent of the window being
designed.  When the window is a descendant of the Desktop, the user, depending
on the controls you have added to the window, will have the ability to move the
window around on the OS/2 Presentation Manager Desktop.

Note:  The Desktop radio button will only be available when you select the
       Parent Window or Child Window radio buttons.


ΓòÉΓòÉΓòÉ 449. Help for Main Window Style ΓòÉΓòÉΓòÉ

The Main Window radio button is used to set the parent of the window being
designed.  When the window is a descendant of the Main Window, the user,
depending on the controls you have added to the window, will only have the
ability to move the window within the window that it is a descendant of.

Note:  The Desktop radio button will only be available when you select the
       Child Window radio button.


ΓòÉΓòÉΓòÉ 450. Help for Object Window Style ΓòÉΓòÉΓòÉ

The Object Window radio button is used to set the parent of the window being
designed.  When the window is a descendant of an Object Window, the window will
not be visible.

Generally, Object Windows are used within a separate thread of the application
to allow a background task to be perform but still have access to the OS/2
Presentation Manager messaging facilities.

Object windows can also be used as a separate program that acts as a background
task but where you would still like to be able to display dialogues or message
boxes to inform the user of significant events or errors.

Note:  The Object Window radio button will only be available when you select
       the Parent Window or Child Window radio buttons.


ΓòÉΓòÉΓòÉ 451. Help for Text Style ΓòÉΓòÉΓòÉ

The Text radio button is used to designate a menu item as an item that the OS/2
Presentation Manager should display as text.

The text that you provide for the menu item is used as the text for the final
menu item.

Prominare Designer will show the menu item with the text you enter for it.


ΓòÉΓòÉΓòÉ 452. Help for Bitmap Style ΓòÉΓòÉΓòÉ

The Bitmap radio button is used to designate a menu item as being a bitmap.

Any text that you enter for the menu item will be ignored since the OS/2
Presentation Manager will use a bitmap that you supply as the actual menu item.

Prominare Designer will simulate the bitmap that you supply similar to below:

Note:  When using the Bitmap style, you will have to provide the necessary code
       to load and size the bitmap and associate it to the menu item.

 The following is an example of loading the bitmap and associating it to the
 menu item within your source code:

  VOID AddBitmapMenu( )

  {
  HBITMAP  hBMshift op      /* Bitmap Handle    */
  HWND     hSubMenushift op /* Sub-Menu Handle  */
  HPS      hPSshift op      /* PS Handle        */
  MENUITEM mishift op       /* Menu Item Holder */

  hPS = WinGetPS(hwndWinEdit)shift op

  hBM = GpiLoadBitmap(hPS, NULL, 7,
                      32L, 16L)shift op

  WinSendMsg(hSubMenu =
             WinWindowFromID(hwndWindow, FID_MENU),
             MM_QUERYITEM,
             MPFROM2SHORT(IDM_BITMAP, 1),
             MPFROMP(&mi))shift op

  mi.hItem = (ULONG)hBMshift op
  WinSendMsg(hSubMenu, MM_SETITEM,
             MPFROM2SHORT(0, 1),
             MPFROMP(&mi))shift op

  WinReleasePS(hPS)shift op
  }


ΓòÉΓòÉΓòÉ 453. Help for Separator Style ΓòÉΓòÉΓòÉ

When you to place a dividing line between menu items, select the Separator
check box.

It is sometimes useful to do this since it will allow you to group like menu
items together and will make the menu visually easier to use.


ΓòÉΓòÉΓòÉ 454. Help for Break Style ΓòÉΓòÉΓòÉ

The Break check check box allows you to create a multiple column menu if it is
a pull down or it will create a multiple line action bar menu.

The menu item that you associate the Break with will be the last item in the
column or line.


ΓòÉΓòÉΓòÉ 455. Help for Break/Separator Style ΓòÉΓòÉΓòÉ

The Break/Separator check box allows you to create a multiple column menu with
a separating line between the columns.


ΓòÉΓòÉΓòÉ 456. Help for Button Separator Style ΓòÉΓòÉΓòÉ

The Button Separator check box allows you to create an action bar menu item
activated only by the mouse.  The text of the action bar item is centered
instead of being left justified.

This is usually used to place an action bar item on the right side of the
action bar.

Note:  It is possible to use the Button Separator style with pull-down menu
       items but it is not recommended.


ΓòÉΓòÉΓòÉ 457. Help for Sub-Menu Style ΓòÉΓòÉΓòÉ

The Sub-Menu check box is used to designate a pull-down menu item as a
Sub-Menu.

The menu item when shown will have an arrow on the far right indicating to the
user that further menu items are available.

To create the menu items for the sub-menu, you select the Sub-Menu on the
Control pull-down menu and select the menu item you have created with the
Sub-Menu style.


ΓòÉΓòÉΓòÉ 458. Help for Help Style ΓòÉΓòÉΓòÉ

The Help check box is used to specify that when the menu item is selected, a
WM_HELP message be sent to the window containing the menu item.


ΓòÉΓòÉΓòÉ 459. Help for SYSCOMMAND Style ΓòÉΓòÉΓòÉ

The SYSCOMMAND check box is used to specify that when the menu item is
selected, a WM_SYSCOMMAND message be sent to the window containing the menu
item.


ΓòÉΓòÉΓòÉ 460. Help for Child System Menu ΓòÉΓòÉΓòÉ

The Child system menu menu style is used to create a child system menu within
the action bar for applications that are using a MDI type of interface.


ΓòÉΓòÉΓòÉ 461. Help for Static Style ΓòÉΓòÉΓòÉ

The Static menu style is not used presently within OS/2 and is provided within
Prominare Designer for consistancy.


ΓòÉΓòÉΓòÉ 462. Help for Group Style ΓòÉΓòÉΓòÉ

The Group menu style is not used presently within OS/2 and is provided within
Prominare Designer for consistancy.


ΓòÉΓòÉΓòÉ 463. Help for Single Style ΓòÉΓòÉΓòÉ

The Single menu style is not used presently within OS/2 and is provided within
Prominare Designer for consistancy.


ΓòÉΓòÉΓòÉ 464. Help for Owner Draw Style ΓòÉΓòÉΓòÉ

Owner draw is used to designate that the menu item that will be drawn by using
code defined within the owner window instead of having the system provide the
drawing.


ΓòÉΓòÉΓòÉ 465. Help for Checked Attribute ΓòÉΓòÉΓòÉ

The Checked attribute is used to place a check mark beside the pull-down menu
item.


ΓòÉΓòÉΓòÉ 466. Help for Disabled Attribute ΓòÉΓòÉΓòÉ

The Disabled attribute is used to disable the menu item.

When Disabled, the user cannot select the item.


ΓòÉΓòÉΓòÉ 467. Help for Framed Attribute ΓòÉΓòÉΓòÉ

The Framed attribute is used to place a frame around the pull-down menu item.

The frame appears as a heavy border.


ΓòÉΓòÉΓòÉ 468. Help for Hilighted Attribute ΓòÉΓòÉΓòÉ

The Hilighted attribute is used to highlight the pull-down menu item.

The menu item, when displayed, will be have its colors inverted.


ΓòÉΓòÉΓòÉ 469. Help for No Dismiss Attribute ΓòÉΓòÉΓòÉ

The No Dismiss attribute causes the menu item to remain displayed after being
selected.


ΓòÉΓòÉΓòÉ 470. Help for Virtual Key ΓòÉΓòÉΓòÉ

The Virtual Key check box is used to designate the key selected is a virtual
key.


ΓòÉΓòÉΓòÉ 471. Help for Scan Code ΓòÉΓòÉΓòÉ

The Scan Code check box is used to designate the key selected is a scan code
key.


ΓòÉΓòÉΓòÉ 472. Help for Char ΓòÉΓòÉΓòÉ

The Char check box is used to designate the key selected is a character key.


ΓòÉΓòÉΓòÉ 473. Help for Help ΓòÉΓòÉΓòÉ

The Help check box is used to designate the key selected as a help key.

Note:  The key will be translated into a WM_HELP message.


ΓòÉΓòÉΓòÉ 474. Help for Alt ΓòÉΓòÉΓòÉ

The Alt check box is used to designate the key selected be used with the Alt
key.


ΓòÉΓòÉΓòÉ 475. Help for Ctrl ΓòÉΓòÉΓòÉ

The Ctrl check box is used to designate the key selected be used with the Ctrl
key.


ΓòÉΓòÉΓòÉ 476. Help for Shift ΓòÉΓòÉΓòÉ

The Shift check box is used to designate the key selected be used with the
Shift key.


ΓòÉΓòÉΓòÉ 477. Help for SYSCOMMAND ΓòÉΓòÉΓòÉ

The SYSCOMMAND check box is used to cause the key selected to be translated
into a WM_SYSCOMMAND message.


ΓòÉΓòÉΓòÉ 478. Help for Icon Resources ΓòÉΓòÉΓòÉ

To include an icon within your application, select the Icon resource type.

You must create the icon through an editor such as the Icon Editor provided in
the OS/2 Programmer's Toolkit.


ΓòÉΓòÉΓòÉ 479. Help for Font Resources ΓòÉΓòÉΓòÉ

To include an font resource within your application, select the Font resource
type.

You must create the font through an editor such as the Font Editor provided in
the OS/2 Programmer's Toolkit.


ΓòÉΓòÉΓòÉ 480. Help for Bitmap Resources ΓòÉΓòÉΓòÉ

To include an bitmap within your application, select the Bitmap resource type.

You must create the bitmap through an editor such as the Icon Editor provided
in the OS/2 Programmer's Toolkit.


ΓòÉΓòÉΓòÉ 481. Help for Pointer Resources ΓòÉΓòÉΓòÉ

To include an pointer within your application, select the Pointer resource
type.

You must create the pointer through an editor such as the Icon Editor provided
in the OS/2 Programmer's Toolkit.


ΓòÉΓòÉΓòÉ 482. Help for String Resources ΓòÉΓòÉΓòÉ

To include a string resource within your application, select the String
resource type.

A string could be the text within a message box or the application's title bar.

Strings are useful if you need to distribute your application in another
language.

Since all of the strings are localized, it will make translation of the strings
and their replacement easier rather than having to search through all of the
application's source code for them.


ΓòÉΓòÉΓòÉ 483. Help for Message Resources ΓòÉΓòÉΓòÉ

To include a message resource within your application, select the Message
resource type.

A string could be the text within a message box or a dialogue.

Messages are useful if you need to distribute your application in another
language.

Since all of the messages are localized, it will make translation of the
messages and their replacement easier rather than having to search through all
of the application's source code for them.


ΓòÉΓòÉΓòÉ 484. Help for Custom Resources ΓòÉΓòÉΓòÉ

To include a custom resource within your application, select the Custom
resource type.

A custom resource can a file containing many text lines, such as a poem or a
set of instructions in free format.

Like other resources, you need to load the custom resource from the
application's resources before you can use them.

Note:  For an excellent discussion of custom resources, consult Charles
       Petzold's OS/2 Presentation Manager Programming, Ziff-Davis Press,
       Emeryville, California, ISBN 1-56276-123-4), Chapter 12, Bitmaps, Icons,
       Pointers, and Stringsshift op pp. 636-645, Program-defined Resources.


ΓòÉΓòÉΓòÉ 485. Help for Default Memory Options ΓòÉΓòÉΓòÉ

The Default memory option allows you to let the OS/2 Presentation Manager use
the default loading and memory options.

The defaults are:

     Load On Call
     Moveable
     Discardable


ΓòÉΓòÉΓòÉ 486. Help for Moveable Memory Options ΓòÉΓòÉΓòÉ

The Moveable memory option allows you to designate the resource item as
moveable.

This allows OS/2 Presentation Manager to move the resource as necessary to
compact memory.


ΓòÉΓòÉΓòÉ 487. Help for Preload Memory Options ΓòÉΓòÉΓòÉ

The Preload memory option allows you to designate the resource item to be
loaded when the application starts.


ΓòÉΓòÉΓòÉ 488. Help for Discard Memory Options ΓòÉΓòÉΓòÉ

The Discard memory option allows you to designate the resource item as
discardable.

Discardable resource items are discarded as required by the OS/2 Presentation
Manager when it needs the memory the resource is using.

The resource item would then be reloaded the next time it is needed within the
application.


ΓòÉΓòÉΓòÉ 489. Help for Left Aligned Style ΓòÉΓòÉΓòÉ

The Left Aligned style forces the text within the Entry Field to be left
justified.

As text is entered into the Entry Field, it will expand to the right.


ΓòÉΓòÉΓòÉ 490. Help for Centered Style ΓòÉΓòÉΓòÉ

The Centered style forces the text within the Entry Field to be centered.

As text is entered into the Entry Field, it will expand to both the left and to
the right keeping the text centered.


ΓòÉΓòÉΓòÉ 491. Help for Right Aligned Style ΓòÉΓòÉΓòÉ

The Right Aligned style forces the text within the Entry Field to be right
justified.

As text is entered into the Entry Field, it will expand to the left.


ΓòÉΓòÉΓòÉ 492. Help for Auto Horz Scroll Style ΓòÉΓòÉΓòÉ

To allow the text within the Entry Field to scroll within the field, the Auto
Horz Scroll style should be used.

This allows the user to see portions of the text within the Entry Field when it
is longer than the Entry Field itself.


ΓòÉΓòÉΓòÉ 493. Help for Margin Style ΓòÉΓòÉΓòÉ

The Margin style is used to place a border around the Entry Field allowing the
user to see the limits of the actual Entry Field.

When you do not use the Margin style, the mouse pointer will still change its
shape to an I-Beam when it passes over the marginless entry field allowing the
user to see that input is possible.


ΓòÉΓòÉΓòÉ 494. Help for Auto Tab Style ΓòÉΓòÉΓòÉ

The Auto Tab style indicates that when the field is filled when a character is
added to it, the effect of a tab key will be generated.  This only occurs when
the character is added to the end of entry field textshift op inserting and/or
replacing a character or characters in the middle of the text does not cause
the autotab to be generated.

The auto tab style is generally used with fixed-length entry fields where it
may be faster for the user to type in a fixed number of characters and then
have the cursor automatically move to the next field to allow a virtual
continuous typing interface.


ΓòÉΓòÉΓòÉ 495. Help for Read Only Style ΓòÉΓòÉΓòÉ

The Read Only style cause the entry field to be read only.

When an entry field is read only, no characters are permitted to be input into
the text.  You can, however, use the copy interface to the clipboard.

It is possible to dynamically change the read only state of the entry field
through the EM_SETREADONLY message.


ΓòÉΓòÉΓòÉ 496. Help for Command Style ΓòÉΓòÉΓòÉ

The Command style designates that the entry field as a command entry field.
This is used by the Help Manager to provide command help if the user requests
help for this field.

Note:  Only entry field within each dialogue may have this style.


ΓòÉΓòÉΓòÉ 497. Help for Unreadable Style ΓòÉΓòÉΓòÉ

The Unreadable style causes the text that is entered by the user to be
displayed as asterisks for each character.  Generally, this style is used to
create password entry fields.

Note:  To create an entry field that does not show what is being typed, use
       presentation parameters to cause the foreground and background to be the
       same color.


ΓòÉΓòÉΓòÉ 498. Help for Any Style ΓòÉΓòÉΓòÉ

The Any style causes the text that is entered by the users to be a mixture SBCS
and DBCS characters.  When the number of characters of the entry field is
exceeded, an alarm is sounded and the last character entered is ignored.

This style is the default style for an entry field.


ΓòÉΓòÉΓòÉ 499. Help for SBCS Style ΓòÉΓòÉΓòÉ

The SBCS style is used to designate an entry field as being able to handle only
single byte characters.  When the number of characters of the entry field is
exceeded, an alarm is sounded and the last character entered is ignored.


ΓòÉΓòÉΓòÉ 500. Help for DBCS Style ΓòÉΓòÉΓòÉ

The DBCS style is used to designate an entry field as being able to handle only
double byte characters.  When the number of characters of the entry field is
exceeded or a SBCS character is entered, an alarm is sounded and the last
character entered is ignored.


ΓòÉΓòÉΓòÉ 501. Help for Mixed Style ΓòÉΓòÉΓòÉ

The Mixed style is used to designate an entry field as being able to handle a
mixture of SBCS and DBCS characters.


ΓòÉΓòÉΓòÉ 502. Help for Push Button Style ΓòÉΓòÉΓòÉ

The Push Button style is used to designate the button as a Push Button.

A Push Button is usually used to start or stop an operation, or it can be used
to signal the acceptance or rejection.

Push Buttons are used within dialogues most often as OK and Cancel.

The OS/2 Presentation Manager provides two constants that can be used for the
OK and Cancel Push Buttons.  These are:

 Symbol:             Value:
 DID_OK              1
 DID_CANCEL          2

 You should use the DID_OK as the symbol for the OK Push Button and DID_CANCEL
 as the symbol for the Cancel Push Button.

 Prominare Designer predefines these two symbols for your use when you use
 these symbols for the two Push Buttons.  The following is an example of the
 source code generated:

  case WM_COMMAND :
    switch ( COMMANDMSG(&msg)->cmd )
      {
      case DID_OK :
        WinDismissDlg(hWnd, 1)shift op
        breakshift op

      case DID_CANCEL :
        WinDismissDlg(hWnd, 0)shift op
        breakshift op
      }
    breakshift op

 Note:  A Push Button sends a WM_COMMAND message to its owner window.


ΓòÉΓòÉΓòÉ 503. Help for Notebook Button Style ΓòÉΓòÉΓòÉ

Note:  This style option is valid only for OS/2 Warp Version 4.0 and above

 The Notebook Button style is used to designate the button as a notebook button
 used with a OS/2 Warp Version 4.0 tabbed notebook.

 Creates a notebook button, which is identical to a pushbutton except that when
 it is created as a child of a notebook page it becomes a button in the common
 button area of the notebook page. If the button is not in a notebook page it
 will be indistinguishable from a pushbutton.

  case WM_COMMAND :
    switch ( COMMANDMSG(&msg)->cmd )
      {
      case ID_NOTEBOOKBUTTON :
        breakshift op
      }
    breakshift op

 Note:  A Notebook Button sends a WM_COMMAND message to its owner window.


ΓòÉΓòÉΓòÉ 504. Help for Check Box Style ΓòÉΓòÉΓòÉ

The Check Box style is used to designate the button as a Check Box.

A Check Box is toggled each time it is selected and unselected.

Check Boxes are generally used to set or clear an application feature.

Unlike an Auto Check Box, you will have to send messages to the Check Box to
set its state when selected by the user.

To set the Check Box, this can be done as follows:

WinSendDlgItemMsg(hWnd, ICB,
                  BM_SETCHECK,
                  MPFROMSHORT(1),
                  0L)shift op

To clear the Check Box, this can be done as follows:

WinSendDlgItemMsg(hWnd, ICB,
                  BM_SETCHECK,
                  MPFROMSHORT(0),
                  0L)shift op

Note:  A Check Box sends a WM_CONTROL message to its owner window.


ΓòÉΓòÉΓòÉ 505. Help for Auto Check Box Style ΓòÉΓòÉΓòÉ

The Auto Check Box style is used to designate the button as an Auto Check Box.

An Auto Check Box is toggled each time it is selected and unselected.

Auto Check Boxes are generally used to set or clear an application feature.

Unlike a Check Box, the Auto Check Box will automatically set its state when
selected by the user.

Note:  A Auto Check Box sends a WM_CONTROL message to its owner window.


ΓòÉΓòÉΓòÉ 506. Help for Radio Button Style ΓòÉΓòÉΓòÉ

The Radio Button style is used to designate the button as a Radio Button.

A Radio Button is toggled each time it is selected and unselected.

Generally, Radio Buttons appear in groups where only one button is is selected
at a time.  The group of Radio Buttons usually provide an exclusive choice
amongst related options.

Unlike an Auto Radio Button, you will have to send messages to the Radio Button
to set its state when selected by the user.

To set the Radio Button, this can be done as follows:

WinSendDlgItemMsg(hWnd, IRB,
                  BM_SETCHECK,
                  MPFROMSHORT(1),
                  0L)shift op

To clear the Radio Button, this can be done as follows:

WinSendDlgItemMsg(hWnd, IRB,
                  BM_SETCHECK,
                  MPFROMSHORT(0),
                  0L)shift op

Note:  A Radio Button sends a WM_CONTROL message to its owner window.


ΓòÉΓòÉΓòÉ 507. Help for Auto Radio Button Style ΓòÉΓòÉΓòÉ

The Auto Radio Button style is used to designate the button as an Auto Radio
Button.

An Auto Radio Button is toggled each time it is selected and unselected.

Generally, Auto Radio Buttons appear in groups where only one button is is
selected at a time.  The group of Radio Buttons usually provide an exclusive
choice amongst related options.

Unlike a Radio Button, the Auto Radio Button will automatically set its state
when selected by the user.

Note:  A Auto Radio Button sends a WM_CONTROL message to its owner window.


ΓòÉΓòÉΓòÉ 508. Help for 3 State Check Box Style ΓòÉΓòÉΓòÉ

The 3 State Check Box style is used to designate the button as a 3 State Check
Box.

A 3 State Check Box is toggled each time it is selected.  The appearance will
be selected, unselected or halftoned.

3 State Check Boxes are generally used to set or clear an application feature.

Unlike an Auto 3 State Check Box, you will have to send messages to the Check
Box to set its state when selected by the user.

To set the 3 State Check Box, this can be done as follows:

WinSendDlgItemMsg(hWnd, ICB,
                  BM_SETCHECK,
                  MPFROMSHORT(1),
                  0L)shift op

To clear the 3 State Check Box, this can be done as follows:

WinSendDlgItemMsg(hWnd, ICB,
                  BM_SETCHECK,
                  MPFROMSHORT(0),
                  0L)shift op

Note:  A 3 State Check Box sends a WM_CONTROL message to its owner window.


ΓòÉΓòÉΓòÉ 509. Help for Auto 3 State Check Box Style ΓòÉΓòÉΓòÉ

The Auto 3 State Check Box style is used to designate the button as an Auto 3
State Check Box.

An Auto  3 State Check Box is toggled each time it is selected.  The appearance
will be selected, unselected or halftoned.

Auto 3 State Check Boxes are generally used to set or clear an application
feature.

Unlike a 3 State Check Box, the Auto Auto 3 Check Box will automatically set
its state when selected by the user.

Note:  A Auto 3 State Check Box sends a WM_CONTROL message to its owner window.


ΓòÉΓòÉΓòÉ 510. Help for User Button Style ΓòÉΓòÉΓòÉ

The User Button style is used to designate the button as a User Button.

A User Button is generally used to created a button whose appearance is
different from the OS/2 Presentation Manager's predefined buttons.

The User Button is sent a BN_PAINT message each time it needs to be drawn and
when it is highlighted.


ΓòÉΓòÉΓòÉ 511. Help for Default Options ΓòÉΓòÉΓòÉ

The Default option is used to designate a Push Button as the default when the
user presses the ENTER key within the dialogue when not within a Multi-Line
Entry Field.

The Push Button will appear with a thick border to indicate to the user that it
is the default.

Note:  A Default option is only available with Push Buttons.


ΓòÉΓòÉΓòÉ 512. Help for Help Options ΓòÉΓòÉΓòÉ

The Help option is used to designate a Push Button as the help button.

When the user selects the help button, a WM_HELP message will be generated
instead of a WM_COMMAND.

Note:  A Help option is only available with Push Buttons.


ΓòÉΓòÉΓòÉ 513. Help for SYSCOMMAND Options ΓòÉΓòÉΓòÉ

The SYSCOMMAND option is used to designate a Push Button as a SYSCOMMAND
button.

When the user selects the help button, a WM_SYSCOMMAND message will be
generated instead of a WM_COMMAND.

Note:  A SYSCOMMAND option is only available with Push Buttons.


ΓòÉΓòÉΓòÉ 514. Help for No Border Options ΓòÉΓòÉΓòÉ

The No Border option is used to cause the Push Button to not have a border
drawn for it.

A Push Button with the No Border option will only have the text of the button
drawn but will still operate like a Push Button.

Note:  A No Border option is only available with Push Buttons.


ΓòÉΓòÉΓòÉ 515. Help for No Focus Options ΓòÉΓòÉΓòÉ

The No Focus option is used to prevent the button from from receiving the focus
when selected.

For example, it is recommended that the help button use this option to prevent
it from receiving the focus to allow the Help Manager to correctly determine
the control ID that currently does have the focus and to provide the
appropriate Help Panel for the control.


ΓòÉΓòÉΓòÉ 516. Help for No Pointer Select Options ΓòÉΓòÉΓòÉ

The No Pointer Select option is used to prevent a notification message to be
sent when the arrow keys are used within a group of Radio Buttons or Auto Radio
Buttons to move between each button.

The user must use the Space Bar to select the button after the highlight has
been move to it.

Note:  A No Pointer Select option is only available with Radio Buttons.


ΓòÉΓòÉΓòÉ 517. Help for Checked Options ΓòÉΓòÉΓòÉ

The Checked option is used to set the state of a radio button, check box or 3
state check box.

Selecting the option causes the button to be selected when the dialogue is
first displayed.


ΓòÉΓòÉΓòÉ 518. Help for Hilight Options ΓòÉΓòÉΓòÉ

The Hilight option is used to set the highlight state of a Push Button.

Note:  A Hilight option is only available with a Push Button.


ΓòÉΓòÉΓòÉ 519. Help for Text Style ΓòÉΓòÉΓòÉ

The Text style designates the item as Static Text

Static Text is non-interactive, meaning the user cannot interact within it.


ΓòÉΓòÉΓòÉ 520. Help for Group Box Style ΓòÉΓòÉΓòÉ

The Group Box style is used to create a frame with a text label.

Group Boxes are useful in grouping like elements thereby providing a visible
separation between controls within a dialogue.


ΓòÉΓòÉΓòÉ 521. Help for Icon Style ΓòÉΓòÉΓòÉ

The Icon style is used to create a static Icon within a dialogue.

Usually, the Icon is placed within the About Box to allow the user visually see
the Icon of the program is it would appear on the desktop when the application
is minimized.

You should select the Icon on the Resource pull-down to define the final icon
within the application.

You must create the icon through an editor such as the Icon Editor provided in
the OS/2 Programmer's Toolkit.


ΓòÉΓòÉΓòÉ 522. Help for Bitmap Style ΓòÉΓòÉΓòÉ

The Bitmap style is used to create a static Bitmap within a dialogue.

You should select the Bitmap on the Resource pull-down to define the final
bitmap within the application.

You must create the bitmap through an editor such as the Icon Editor provided
in the OS/2 Programmer's Toolkit.


ΓòÉΓòÉΓòÉ 523. Help for System Icon Style ΓòÉΓòÉΓòÉ

The System Icon style is used to create a static System Icon within a dialogue.

Usually, the System Icon is placed within a dialogue to explain a point of
interest.

Since the System Icon is using a predefined icon with the OS/2 Presentation
Manager, special rules apply to how you define it.

Unlike other controls, you cannot enter values that are not a System Icon
designation.  The system icons that can be selected are:

       SPTR_ARROW
       SPTR_TEXT
       SPTR_WAIT
       SPTR_MOVE
       SPTR_SIZENWSE
       SPTR_SIZENESW
       SPTR_SIZEWE
       SPTR_SIZENS
       SPTR_APPICON
       SPTR_ICONINFORMATION
       SPTR_ICONQUESTION
       SPTR_ICONERROR
       SPTR_ICONWARNING
       SPTR_ILLEGAL
       SPTR_FILE
       SPTR_FOLDER
       SPTR_MULTFILE
       SPTR_PROGRAM


ΓòÉΓòÉΓòÉ 524. Help for Foreground Rect Style ΓòÉΓòÉΓòÉ

The Foreground Rect style is used to create a dark, solid rectangle.

The color of the rectangle is the inverse of the window background.


ΓòÉΓòÉΓòÉ 525. Help for Halftone Rect Style ΓòÉΓòÉΓòÉ

The Halftone Rect style is used to create a colored, solid rectangle.

The color of the rectangle is the median of the window background and the
inverse of the window background.


ΓòÉΓòÉΓòÉ 526. Help for Background Rect Style ΓòÉΓòÉΓòÉ

The Background Rect style is used to created a solid rectangle.

The color of the rectangle is the window background.


ΓòÉΓòÉΓòÉ 527. Help for Foreground Frame Style ΓòÉΓòÉΓòÉ

The Foreground Frame style is used to create a dark frame.

The color of the frame is the inverse of the window background.


ΓòÉΓòÉΓòÉ 528. Help for Halftone Frame Style ΓòÉΓòÉΓòÉ

The Halftone Frame style is used to create a colored frame.

The color of the frame is the median of the window background and the inverse
of the window background.


ΓòÉΓòÉΓòÉ 529. Help for Background Frame Style ΓòÉΓòÉΓòÉ

The Background Rect style is used to created a frame.

The color of the frame is the window background.


ΓòÉΓòÉΓòÉ 530. Help for Left Aligned Style ΓòÉΓòÉΓòÉ

The Left Aligned text style is used to left justify the text entered for the
Static Text style.

Note:  A Left Aligned style is only available with the Text style.


ΓòÉΓòÉΓòÉ 531. Help for Horz Aligned Style ΓòÉΓòÉΓòÉ

The Horz. Aligned text style is used to center the text entered for the Static
Text style.

Note:  A Horz. Aligned style is only available with the Text style.


ΓòÉΓòÉΓòÉ 532. Help for Right Aligned Style ΓòÉΓòÉΓòÉ

The Right Aligned text style is used to right justify the text entered for the
Static Text style.

Note:  A Right Aligned style is only available with the Text style.


ΓòÉΓòÉΓòÉ 533. Help for Top Aligned Style ΓòÉΓòÉΓòÉ

The Top Aligned text style is used to top justify the text entered for the
Static Text style.

Note:  A Top Aligned style is only available with the Text style.


ΓòÉΓòÉΓòÉ 534. Help for Vert Centered Style ΓòÉΓòÉΓòÉ

The Vert. Centered text style is used to vertically center the text entered for
the Static Text style.

Note:  A Vert. Centered style is only available with the Text style.


ΓòÉΓòÉΓòÉ 535. Help for Bottom Aligned Style ΓòÉΓòÉΓòÉ

The Bottom Aligned text style is used to bottom justify the text entered for
the Static Text style.

Note:  A Bottom Aligned style is only available with the Text style.


ΓòÉΓòÉΓòÉ 536. Help for Word Wrap Style ΓòÉΓòÉΓòÉ

The Word Wrap text style is used to prevent text entered for the Static Text
style from being clipped.

This allows the text to flow to a new line within the Static Text size
rectangle if necessary.

Note:  A Word Wrap style is only available with the Text style.


ΓòÉΓòÉΓòÉ 537. Help for Halftone Style ΓòÉΓòÉΓòÉ

The Halftone text style is used to display the text entered in a halftone for
the Static Text style.

Note:  A Halftone style is only available with the Text style.


ΓòÉΓòÉΓòÉ 538. Help for Mnemonic Style ΓòÉΓòÉΓòÉ

The Mnemonic text style is used to draw a the character within text entered for
the Static Text style following the mnemonic character (~) with mnemonic
emphasis.

Note:  A Mnemonic style is only available with the Text style.


ΓòÉΓòÉΓòÉ 539. Help for Multiple Selection Style ΓòÉΓòÉΓòÉ

To allow multiple items to be selected within a List Box use Multiple Selection
style.

This will allow a user to select multiple items from the list presented which
can, depending on the situation, simply the selection process.


ΓòÉΓòÉΓòÉ 540. Help for No Adjust Position Style ΓòÉΓòÉΓòÉ

By using the No Adjust Position style, the List Box will not be moved or
adjusted in size when the list box items cannot evenly fit within the display
area of the list box.


ΓòÉΓòÉΓòÉ 541. Help for User Redraw Style ΓòÉΓòÉΓòÉ

When you want to draw the items within the List Box yourself, use the User
Redraw style.

Consult the OS/2 Programmer's Reference for more information on drawing list
box items.


ΓòÉΓòÉΓòÉ 542. Help for Horz Scroll Style ΓòÉΓòÉΓòÉ

To add a Horizontal Scroll Bar to the bottom of a List Box, use the Horz Scroll
style.

This will allow the user to scroll the contents of the list box horizontally
when items within it.


ΓòÉΓòÉΓòÉ 543. Help for Simple Style ΓòÉΓòÉΓòÉ

To create a Combo Box that just contains an entry field and a list box, use the
Simple style.

Both the entry field and list box will be visible at all times.

The user can then select an item within the list box to insert into the entry
field.


ΓòÉΓòÉΓòÉ 544. Help for Drop Down Style ΓòÉΓòÉΓòÉ

To create a Combo Box that just contains an entry field and button, use the
Drop Down style.

The drop down button appears as a downward pointing arrow on the right edge of
the entry field.

When the user selects the drop down button, the list box will appear where the
user can then select an item within the list box to insert into the entry
field.


ΓòÉΓòÉΓòÉ 545. Help for Drop Down List Style ΓòÉΓòÉΓòÉ

To create a Combo Box that just contains an entry field and button but where
the user can type into the entry field, use the Drop Down style.

The drop down button appears as a downward pointing arrow on the right edge of
the entry field.

When the user selects the drop down button, the list box will appear where the
user can then select an item within the list box to insert into the entry
field.


ΓòÉΓòÉΓòÉ 546. Help for Thumb Size Style ΓòÉΓòÉΓòÉ

Selecting the Thumb Size option indicates that you wish to set the scroll bar
thumb to a given size through the entry fields labeled Low range, High range,
Visible and Total.

This gives visual feedback to the user regarding the relative number of items
that can be scrolled and what number is visible.


ΓòÉΓòÉΓòÉ 547. Help for Auto Track Style ΓòÉΓòÉΓòÉ

Selecting the Auto Track option is used to allow the scroll bar to move when
selected by the mouse pointer instead of an outline representation.


ΓòÉΓòÉΓòÉ 548. Help for Border Style ΓòÉΓòÉΓòÉ

To create a border for a Multi-Line Entry Field, use Border style.


ΓòÉΓòÉΓòÉ 549. Help for Horizontal Scroll Style ΓòÉΓòÉΓòÉ

To include a horizontal scroll bar at the bottom of a Multi-Line Entry Field,
use the Horizontal Scroll style.

This will allow the user to scroll horizontally the contents of the Multi-Line
Entry Field.


ΓòÉΓòÉΓòÉ 550. Help for Vertical Scroll Style ΓòÉΓòÉΓòÉ

To include a vertical scroll bar on the right side of a Multi-Line Entry Field,
use the Vertical Scroll style.

This will allow the user to scroll vertically the contents of the Multi-Line
Entry Field.


ΓòÉΓòÉΓòÉ 551. Help for Ignore Tab Style ΓòÉΓòÉΓòÉ

To cause the Multi-Line Entry Field to ignore the Tab Key, select the Ignore
Tab style.

This will prevent the Multi-Line Entry Field from acting on the Tab Key.


ΓòÉΓòÉΓòÉ 552. Help for Read Only Style ΓòÉΓòÉΓòÉ

To cause the Multi-Line Entry Field to not allow any input or editing of its
contents, use the Read Only style.


ΓòÉΓòÉΓòÉ 553. Help for Word Wrap Style ΓòÉΓòÉΓòÉ

When you have not used either a Horizontal Scroll Bar or Vertical Scroll Bar
styles in the Multi-Line Entry Field and want to text to fit within the
Multi-Line Entry Field, use the Word Wrap style.

This will cause the text to be formatted to fit within the Multi-Line Entry
Field by breaking a word off of a line onto the next if it will not fit on the
line.


ΓòÉΓòÉΓòÉ 554. Help for Master Type ΓòÉΓòÉΓòÉ

The Master type is used to designate the spin as the master consisting of at
least one single spin field.


ΓòÉΓòÉΓòÉ 555. Help for Servant Type ΓòÉΓòÉΓòÉ

The Servant type is used to create a multi-field spin button by spinning
servants from the master.


ΓòÉΓòÉΓòÉ 556. Help for Left Style ΓòÉΓòÉΓòÉ

The Left style is used to left justify the text of a spin button spin field.


ΓòÉΓòÉΓòÉ 557. Help for Centered Style ΓòÉΓòÉΓòÉ

The Centered style is used to center the text of a spin button spin field.


ΓòÉΓòÉΓòÉ 558. Help for Right Style ΓòÉΓòÉΓòÉ

The Left style is used to right justify the text of a spin button spin field.


ΓòÉΓòÉΓòÉ 559. Help for All Characters Style ΓòÉΓòÉΓòÉ

The All characters style is used to allow any character to be entered in the
spin button spin field.


ΓòÉΓòÉΓòÉ 560. Help for Numeric Style ΓòÉΓòÉΓòÉ

The Numeric style is used to allow only numeric values to be entered in the
spin button spin field.


ΓòÉΓòÉΓòÉ 561. Help for Read Only Style ΓòÉΓòÉΓòÉ

The Read only style is used to prevent values from being entered in the spin
button spin field.


ΓòÉΓòÉΓòÉ 562. Help for No Border Style ΓòÉΓòÉΓòÉ

The No border style is used to create a spin button spin field without a
border.


ΓòÉΓòÉΓòÉ 563. Help for Fast Spin Style ΓòÉΓòÉΓòÉ

The Fast spin style is used to enable the spin button to increase the spin
speed with time.  The speed of spinning will double every two seconds.


ΓòÉΓòÉΓòÉ 564. Help for Zero Pad Style ΓòÉΓòÉΓòÉ

The Zero pad style is used to cause the output number to be padded at the front
with zeroes between the first non-zero digit number and the field width, or 11
characters whichever is the lesser.


ΓòÉΓòÉΓòÉ 565. Help for Auto Icon Style ΓòÉΓòÉΓòÉ

The Auto icon style is used to cause performance optimization. When repainting
iconized frames, OS/2 Presentation Manager will redraw the icon and will not
send a WM_PAINT message to the application.


ΓòÉΓòÉΓòÉ 566. Help for Entry Field Auto Size Style ΓòÉΓòÉΓòÉ

The Auto Size style is used to cause the text to be sized such that the
contents fit.


ΓòÉΓòÉΓòÉ 567. Help for Buttons Icon Style ΓòÉΓòÉΓòÉ

The Icon style is used to cause an icon to be used in place of text within the
push button.


ΓòÉΓòÉΓòÉ 568. Help for Buttons Mini-Icon Style ΓòÉΓòÉΓòÉ

The Mini-icon style is used to cause an mini-icon within the push button.


ΓòÉΓòÉΓòÉ 569. Help for Buttons Text Style ΓòÉΓòÉΓòÉ

The Text style is used to cause an text within the push button when also
including a bitmap or icon within the button.


ΓòÉΓòÉΓòÉ 570. Help for Buttons Bitmap Style ΓòÉΓòÉΓòÉ

The Bitmap style is used to cause an bitmap to be used in place of text within
the push button.


ΓòÉΓòÉΓòÉ 571. Help for Buttons Auto Size Style ΓòÉΓòÉΓòÉ

The Auto Size style is used to cause the button to be sized such that the
contents fit.


ΓòÉΓòÉΓòÉ 572. Help for DBCS Status Style ΓòÉΓòÉΓòÉ

The DBCS status style is used within Double-Byte Character Set (DBCS) enabled
applications to cause a status window to be displayed at the bottom of the
frame window.  This window displays additional information to the user through
the DBCS facilities.


ΓòÉΓòÉΓòÉ 573. Help for Close Button Style ΓòÉΓòÉΓòÉ

The Close Button style is used to add a close button to the title bar of the
window or dialogue.

Note:  This style option is only available on OS/2 Warp Version 4 and above.


ΓòÉΓòÉΓòÉ 574. Help for Task List Style ΓòÉΓòÉΓòÉ

The Task list style is used to the current window or dialogue title to the
application entry within the task list.


ΓòÉΓòÉΓòÉ 575. Help for Scroll Bar Auto Size Style ΓòÉΓòÉΓòÉ

The Auto Size style is used to cause the scroll bar to change size reflecting
the amount of data contained within a window.


ΓòÉΓòÉΓòÉ 576. Help for Static Auto Size Style ΓòÉΓòÉΓòÉ

The Auto Size style is used to cause the static control to be sized such that
the contents fit.


ΓòÉΓòÉΓòÉ 577. Help for Extended Selection Style ΓòÉΓòÉΓòÉ

The Extended Selection style is used to cause the extended selection user
interface to be enabled for the list box.


ΓòÉΓòÉΓòÉ 578. Help for Auto Tab Style ΓòÉΓòÉΓòÉ

The Auto Tab style indicates that when the field is filled when a character is
added to it, the effect of a tab key will be generated.  This only occurs when
the character is added to the end of entry field textshift op inserting and/or
replacing a character or characters in the middle of the text does not cause
the autotab to be generated.

The auto tab style is generally used with fixed-length entry fields where it
may be faster for the user to type in a fixed number of characters and then
have the cursor automatically move to the next field to allow a virtual
continuous typing interface.


ΓòÉΓòÉΓòÉ 579. Help for Any Style ΓòÉΓòÉΓòÉ

The Any style causes the text that is entered by the users to be a mixture SBCS
and DBCS characters.  When the number of characters of the entry field is
exceeded, an alarm is sounded and the last character entered is ignored.

This style is the default style for an entry field.


ΓòÉΓòÉΓòÉ 580. Help for SBCS Style ΓòÉΓòÉΓòÉ

The SBCS style is used to designate an entry field as being able to handle only
single byte characters.  When the number of characters of the entry field is
exceeded, an alarm is sounded and the last character entered is ignored.


ΓòÉΓòÉΓòÉ 581. Help for DBCS Style ΓòÉΓòÉΓòÉ

The DBCS style is used to designate an entry field as being able to handle only
double byte characters.  When the number of characters of the entry field is
exceeded or a SBCS character is entered, an alarm is sounded and the last
character entered is ignored.


ΓòÉΓòÉΓòÉ 582. Help for Mixed Style ΓòÉΓòÉΓòÉ

The Mixed style is used to designate an entry field as being able to handle a
mixture of SBCS and DBCS characters.


ΓòÉΓòÉΓòÉ 583. Help for Horz Scroll Style ΓòÉΓòÉΓòÉ

To add a Horizontal Scroll Bar to the bottom of a List Box, use the Horz Scroll
style.

This will allow the user to scroll the contents of the list box horizontally
when items within it.


ΓòÉΓòÉΓòÉ 584. Help for Disable Undo Style ΓòÉΓòÉΓòÉ

The Disable Undo style is used to prevent the multiple-line entry field from
allowing undo actions.


ΓòÉΓòÉΓòÉ 585. Help for Limit Vertical Scroll Style ΓòÉΓòÉΓòÉ

Note:  This style option is only valid for OS/2 Warp Version 4.0 and above.

 The Limit Vertical Scroll style is used to display the last MLE line at the
 bottom of the screen page. When this style is not used, the MLE control shows
 an empty space between the last MLE line and the bottom of the screen page.


ΓòÉΓòÉΓòÉ 586. Help for Extend Selection Style ΓòÉΓòÉΓòÉ

The Extend Selection style is used to allow the user to select one or more
container items.  It allows the user to select one item, a range of items or
even multiple ranges of items.


ΓòÉΓòÉΓòÉ 587. Help for Auto Position Style ΓòÉΓòÉΓòÉ

The Auto Position style is used to cause container items to be displayed in the
icon view to be arranged when the user does one of the following:

     The window size changes

     Container items are inserted, removed, sorted, invalidated, or filtered

     The font or font size changes

     The window title text changes.

 In all of these cases, container items are arranged the same as when the
 CM_ARRANGE message is sent.

 Note:  The Auto Position style is only valid when it is used with the icon
        view.


ΓòÉΓòÉΓòÉ 588. Help for Verify Pointers Style ΓòÉΓòÉΓòÉ

The Verify Pointers style is used to cause the verification of the application
pointers as being members of the container before they are used.

Notes

   1. The CCS_VERIFYPOINTERS style bit does not verify the validity of a
      pointer. It only verifies whether a pointer is a member of a container's
      linked list.

   2. After your code has been developed and tested, you may want to remove the
      CCS_VERIFYPOINTERS style bit in order to improve the container's
      performance. Otherwise, the container will attempt to verify all
      pointers, which will slow its response to actions that users perform.


ΓòÉΓòÉΓòÉ 589. Help for Multiple Selection Style ΓòÉΓòÉΓòÉ

The Multiple Selection style is used to allow the user to select zero or more
container items.


ΓòÉΓòÉΓòÉ 590. Help for Single Selection Style ΓòÉΓòÉΓòÉ

The Single Selection style is used to allow the user to only one container item
at any given time.

When a container item is selected, the previous container item selected is
de-selected.


ΓòÉΓòÉΓòÉ 591. Help for Mini Record Style ΓòÉΓòÉΓòÉ

The Mini record style is used to cause the container to interpret all container
records as being smaller than they would otherwise be. If a CM_ALLOCRECORD
message is received, all records are interpreted and allocated according to the
information in the MINIRECORDCORE data structure instead of the RECORDCORE data
structure, which is used if this style is not specified.


ΓòÉΓòÉΓòÉ 592. Help for Mini Icons Style ΓòÉΓòÉΓòÉ

The Mini icons style is used to cause the container to support mini-icons
within in the MINIRECORDCORE data structure.


ΓòÉΓòÉΓòÉ 593. Help for No Control Pointer Style ΓòÉΓòÉΓòÉ

The No control pointer style is used to prevent the container from sending a
WM_CONTROLPOINTER message when a WM_MOUSEMOVE message is received by the
container.


ΓòÉΓòÉΓòÉ 594. Help for Read Only Style ΓòÉΓòÉΓòÉ

The Read Only style is used to prevent the user from editing any of the text
within a container window.  When this style is not used, the user can edit any
text in a container window unless you set the read-only attributes within the
appropriate data structures:

      CA_TITLEREADONLY Sets the container title to read-only. This is an
      attribute of the CNRINFO data structure's flWindowAttr field.

      CRA_RECORDREADONLY Sets text fields in records to read-only. This is an
      attribute of the RECORDCORE and MINIRECORDCORE data structures'
      flRecordAttr field.

      Note:  If the CCS_MINIRECORDCORE style bit is specified when a container
      is created, the MINIRECORDCORE should be used instead of RECORDCORE and
      PMINIRECORDCORE should be used instead of PRECORDCORE in all applicable
      data structures and messages.

      CFA_FIREADONLY Sets column data to read-only. This is an attribute of the
      FIELDINFO data structure's flData field.

      CFA_FITITLEREADONLY Sets column headings to read-only. This is an
      attribute of the FIELDINFO data structure's flTitle field.


ΓòÉΓòÉΓòÉ 595. Help for Horizontal Style ΓòÉΓòÉΓòÉ

The Horizontal style is used to cause the slider to be positioned horizontally.
The slider arm can move left and right on the slider shaft. A scale can be
placed on top of the slider shaft, below the slider shaft, or in both places.
This is the default orientation of the slider.


ΓòÉΓòÉΓòÉ 596. Help for Vertical Style ΓòÉΓòÉΓòÉ

The Vertical style is used to cause the slider to be positioned vertically. The
slider arm can move up and down the slider shaft. A scale can be placed on the
left side of the slider shaft, on the right side of the slider shaft, or in
both places.


ΓòÉΓòÉΓòÉ 597. Help for Buttons Bottom Style ΓòÉΓòÉΓòÉ

The Buttons Bottom style is used to cause the slider to include incremental
slider buttons.  They are placed at the bottom of the slider shaft and cause
the slider arm to move by one position, either up or down, in the direction
indicated by the selected button.

Note:  This is valid for vertical sliders only.


ΓòÉΓòÉΓòÉ 598. Help for Buttons Top Style ΓòÉΓòÉΓòÉ

The Buttons Top style is used to cause the slider to include incremental slider
buttons.  They are placed at the top of the slider shaft and cause the slider
arm to move by one position, either up or down, in the direction indicated by
the selected button.

Note:  This is valid for vertical sliders only.


ΓòÉΓòÉΓòÉ 599. Help for Buttons Right Style ΓòÉΓòÉΓòÉ

The Buttons Right style is used to cause the slider to include incremental
slider buttons.  They are placed at the right of the slider shaft and cause the
slider arm to move by one position, either left or right, in the direction
indicated by the selected button.

Note:  This is valid for horizontal sliders only.


ΓòÉΓòÉΓòÉ 600. Help for Buttons Left Style ΓòÉΓòÉΓòÉ

The Buttons Left style is used to cause the slider to include incremental
slider buttons.  They are placed at the left of the slider shaft and cause the
slider arm to move by one position, either left or right, in the direction
indicated by the selected button.

Note:  This is valid for horizontal sliders only.


ΓòÉΓòÉΓòÉ 601. Help for Bottom Style ΓòÉΓòÉΓòÉ

The Bottom style is used to cause the slider to be positioned at the bottom of
the slider window.

Note:  This is valid for horizontal sliders only.


ΓòÉΓòÉΓòÉ 602. Help for Top Style ΓòÉΓòÉΓòÉ

The Top style is used to cause the slider to be positioned at the top of the
slider window.

Note:  This is valid for horizontal sliders only.


ΓòÉΓòÉΓòÉ 603. Help for Left Style ΓòÉΓòÉΓòÉ

The Left style is used to cause the slider to be positioned at the left of the
slider window.

Note:  This is valid for vertical sliders only.


ΓòÉΓòÉΓòÉ 604. Help for Right Style ΓòÉΓòÉΓòÉ

The Right style is used to cause the slider to be positioned at the right of
the slider window.

Note:  This is valid for vertical sliders only.


ΓòÉΓòÉΓòÉ 605. Help for Snap to Increment Style ΓòÉΓòÉΓòÉ

The Snap to Increment style is used to cause the slider arm, when moved to a
position between two specified values on the slider scale, such as between two
tick marks, to be positioned on the nearest value and to be redrawn at that
position.

When the style is not specified, the slider arm remains at the position to
which it was moved.


ΓòÉΓòÉΓòÉ 606. Help for Owner Draw Style ΓòÉΓòÉΓòÉ

The Owner Draw style is used to cause the application to be notified whenever
the slider shaft, the ribbon strip, the slider arm, and the slider background
are to be drawn.


ΓòÉΓòÉΓòÉ 607. Help for Read Only Style ΓòÉΓòÉΓòÉ

The Read Only style is used to cause the slider to be created as a read-only
slider.

This means that the user cannot interact with the slider. It is used merely as
a mechanism to present a quantity to the user, such as the percentage of
completion of an ongoing task. Visual differences for a read-only slider
include a narrow slider arm, no slider buttons and no detents.


ΓòÉΓòÉΓòÉ 608. Help for Ribbon Strip Style ΓòÉΓòÉΓòÉ

The Ribbon Strip style is used to cause the slider to fill the slider shaft
between the home position and the slider arm, as the slider arm moves, with a
color that is different than the shaft color.


ΓòÉΓòÉΓòÉ 609. Help for Primary Scale 1 Style ΓòÉΓòÉΓòÉ

The Primary Scale 1 style is used to cause the slider to use the increment and
spacing specified for scale 1 as the incremental value for the positioning of
the slider arm.

Scale 1 is displayed above the slider shaft of a horizontal slider and to the
right of the slider shaft of a vertical slider. This is the default for a
slider.


ΓòÉΓòÉΓòÉ 610. Help for Primary Scale 2 Style ΓòÉΓòÉΓòÉ

The Primary Scale 2 style is used to cause the slider to use the increment and
spacing specified for scale 2 as the incremental value for the positioning of
the slider arm.

Scale 2 is displayed below the slider shaft of a horizontal slider and to the
left of the slider shaft of a vertical slider.


ΓòÉΓòÉΓòÉ 611. Help for Home Bottom Style ΓòÉΓòÉΓòÉ

The Home Bottom style is used to cause the slider to use the bottom of the
slider as the base value for incrementing.

This is the default for vertical sliders.

Note:  This is valid for vertical sliders only.


ΓòÉΓòÉΓòÉ 612. Help for Home top Style ΓòÉΓòÉΓòÉ

The Home Top style is used to cause the slider to use the top of the slider as
the base value for incrementing.

Note:  This is valid for vertical sliders only.


ΓòÉΓòÉΓòÉ 613. Help for Home Right Style ΓòÉΓòÉΓòÉ

The Home Right style is used to cause the slider to use the right of the slider
as the base value for incrementing.

Note:  This is valid for horizontal sliders only.


ΓòÉΓòÉΓòÉ 614. Help for Home Left Style ΓòÉΓòÉΓòÉ

The Home Left style is used to cause the slider to use the left of the slider
as the base value for incrementing.

This is the default for horizontal sliders.

Note:  This is valid for horizontal sliders only.


ΓòÉΓòÉΓòÉ 615. Help for Center Style ΓòÉΓòÉΓòÉ

The Center style is used to cause the slider to be centered in the slider
window. This is the default positioning of the slider.


ΓòÉΓòÉΓòÉ 616. Help for Value Set Bitmap Style ΓòÉΓòÉΓòÉ

The Bitmap style is used to cause each value set item to be treated as a
bitmap.  This is the default.


ΓòÉΓòÉΓòÉ 617. Help for Value Set Icon Style ΓòÉΓòÉΓòÉ

The Icon style is used to cause the value set item to be treated as icons.


ΓòÉΓòÉΓòÉ 618. Help for Value Set Text Style ΓòÉΓòÉΓòÉ

The Text style is used to cause each value set item to be treated as text.


ΓòÉΓòÉΓòÉ 619. Help for Color Index Style ΓòÉΓòÉΓòÉ

The Color Index style is used to cause each value set item to be treated as an
index into the logical color table.


ΓòÉΓòÉΓòÉ 620. Help for Value Set Color Info Style ΓòÉΓòÉΓòÉ

The Color info style is used to cause each value set item to be treated as a
RGB color value.


ΓòÉΓòÉΓòÉ 621. Help for Value Set Border Style ΓòÉΓòÉΓòÉ

The Border style is used to cause a thin border around the value set to allow
it to delineate the control.


ΓòÉΓòÉΓòÉ 622. Help for Value Set Item Border Style ΓòÉΓòÉΓòÉ

The Item Border style is used to cause a thin border around each value set item
to allow it to be delineated from the other items.

Note:  The VS_ITEMBORDER style is useful for items that are hard to see, such
       as faint colors or patterns.


ΓòÉΓòÉΓòÉ 623. Help for Value Set Scale Bitmaps Style ΓòÉΓòÉΓòÉ

The Scale Bitmaps style is used to cause the value set to automatically scale
bit maps to the size of the cell.

If this style is not used, each bit map is centered in its cell. Also, if the
cell is smaller than the bit map, the bit map is clipped to the size of the
cell.


ΓòÉΓòÉΓòÉ 624. Help for Right to Left Ordering Style ΓòÉΓòÉΓòÉ

The Right to Left Ordering style is used to cause the value set to interpret
column orientation as right-to-left, instead of the default left-to-right
arrangement. This means columns are numbered from right-to-left with the
rightmost column being 1 and counting up as you move left. Home is the
rightmost column and end is the leftmost column.

There is no visible difference between a value set ordered left-to-right and a
value set ordered right-to-left. Therefore, if your application uses multiple
value sets, the ordering of the items should be consistent in each value set to
avoid confusing the user.

Note:  The VS_RIGHTTOLEFT style is used on creation of the control. Changing
       this style after creation causes unexpected results.


ΓòÉΓòÉΓòÉ 625. Help for Owner Draw Style ΓòÉΓòÉΓòÉ

The Owner Draw style is used to cause the application to be notified whenever
the background of the value set window is to be painted.


ΓòÉΓòÉΓòÉ 626. Help for Backpage Bottom Right Style ΓòÉΓòÉΓòÉ

The Backpage Bottom Right style is used to cause the back pages to be painted
on the notebook's bottom and right sides. This is the default.


ΓòÉΓòÉΓòÉ 627. Help for Backpage Bottom Left Style ΓòÉΓòÉΓòÉ

The Backpage Bottom Left style is used to cause the back pages to be painted on
the notebook's bottom and left sides.


ΓòÉΓòÉΓòÉ 628. Help for Backpage Top Right Style ΓòÉΓòÉΓòÉ

The Backpage Top Right style is used to cause the back pages to be painted on
the notebook's top and right sides.


ΓòÉΓòÉΓòÉ 629. Help for Backpage Top Left Style ΓòÉΓòÉΓòÉ

The Backpage Top Left style is used to cause the back pages to be painted on
the notebook's top and left sides.


ΓòÉΓòÉΓòÉ 630. Help for Major Tab Right Style ΓòÉΓòÉΓòÉ

The Major Tab Right style is used to cause the major tabs to be placed on the
notebook's right edge.

Note:  Only valid in combination with Backpage Bottom Right or Backpage Top
       Right. This is the default when either of these back pages styles is
       used.


ΓòÉΓòÉΓòÉ 631. Help for Major Tab Left Style ΓòÉΓòÉΓòÉ

The Major Tab Left style is used to cause the major tabs to be placed on the
notebook's left edge.

Note:  Only valid in combination with Backpage Bottom Left or Backpage Top
       Left. This is the default when Backpage Top Left style is used.


ΓòÉΓòÉΓòÉ 632. Help for Major Tab Top Style ΓòÉΓòÉΓòÉ

The Major Tab Top style is used to cause the major tabs to be placed on the
notebook's top edge.

Note:  Only valid in combination with Backpage Top Right or Backpage Top Left.


ΓòÉΓòÉΓòÉ 633. Help for Major Tab Bottom Style ΓòÉΓòÉΓòÉ

The Major Tab Bottom style is used to cause the major tabs to be placed on the
notebook's bottom edge.

Note:  Only valid in combination with Backpage Bottom Right or Backpage Bottom
       Left. This is the default when Backpage Bottom Left style is used.


ΓòÉΓòÉΓòÉ 634. Help for Square Tabs Style ΓòÉΓòÉΓòÉ

The Square Tabs style is used to cause the tabs to be drawn with square edges.
This is the default.


ΓòÉΓòÉΓòÉ 635. Help for Rounded Tabs Style ΓòÉΓòÉΓòÉ

The Rounded Tabs style is used to cause the tabs to be drawn with rounded
edges.


ΓòÉΓòÉΓòÉ 636. Help for Polygon Tabs Style ΓòÉΓòÉΓòÉ

The Polygon Tabs style is used to cause the tabs to be drawn with polygon
edges.


ΓòÉΓòÉΓòÉ 637. Help for Status Text Left Style ΓòÉΓòÉΓòÉ

The Status Text Left style is used to cause the status text to be left
justified on the status line.  This is the default.


ΓòÉΓòÉΓòÉ 638. Help for Status Text Center Style ΓòÉΓòÉΓòÉ

The Status Text Center style is used to cause the status text to be centered on
the status line.


ΓòÉΓòÉΓòÉ 639. Help for Status Text Right Style ΓòÉΓòÉΓòÉ

The Status Text Right style is used to cause the status text to be right
justified on the status line.


ΓòÉΓòÉΓòÉ 640. Help for Spiral Style ΓòÉΓòÉΓòÉ

The Spiral style is used to cause a spiral binding to be painted on the
notebook.


ΓòÉΓòÉΓòÉ 641. Help for Solid Style ΓòÉΓòÉΓòÉ

The Spiral style is used to cause a solid binding to be painted on the
notebook.  This is the default.


ΓòÉΓòÉΓòÉ 642. Help for Tabbed ΓòÉΓòÉΓòÉ

The Tabbed style is used to create a notebook using the new OS/2 Warp Version
4.0 tab style.  Conversely, the Original style is used to created a
conventional notebook.


ΓòÉΓòÉΓòÉ 643. Help for Button Area ΓòÉΓòÉΓòÉ

The Button Area style is used to create space above or below the notebook page
for a set of push buttons.


ΓòÉΓòÉΓòÉ 644. Help for Action Bar ΓòÉΓòÉΓòÉ

An Action Bar menu item allows the user to select a menu item which may or may
not display a pull-down menu.

Since the Action Bar can be selected using either the mouse or the keyboard, it
is considered an interactive control and will be selected as a Help Sub-Menu
Item when building the Help Sub-Table.


ΓòÉΓòÉΓòÉ 645. Help for Sub-Menu ΓòÉΓòÉΓòÉ

A Sub-Menuitem allows the user to select a menu item from a pull-down menu.

Since the Sub-Menu item can be select using either the mouse or the keyboard,
it is considered an interactive control and will be selected as a Help Sub-Menu
Item when building the Help Sub-Table.


ΓòÉΓòÉΓòÉ 646. Help for Push Button ΓòÉΓòÉΓòÉ

A Push Button allows the user to perform an action within a window or dialogue.

Since the Push Button can be selected using either the mouse or the keyboard,
it is considered an interactive control and will be selected as a Help Sub-Menu
Item when building the Help Sub-Table.


ΓòÉΓòÉΓòÉ 647. Help for Check Box ΓòÉΓòÉΓòÉ

A Check Box allows the user to toggle an option on or off within a window or
dialogue.

Since the check Box can be selected using either the mouse or the keyboard, it
is considered an interactive control and will be selected as a Help Sub-Menu
Item when building the Help Sub-Table.


ΓòÉΓòÉΓòÉ 648. Help for Radio Button ΓòÉΓòÉΓòÉ

A Radio Button allows the user to select an option within a group of options in
a window or dialogue.

Since the Radio Button can be selected using either the mouse or the keyboard,
it is considered an interactive control and will be selected as a Help Sub-Menu
Item when building the Help Sub-Table.


ΓòÉΓòÉΓòÉ 649. Help for Entry Field ΓòÉΓòÉΓòÉ

An Entry Field allows the user to enter text into the window or dialogue.

Since the Entry Field can be selected using either the mouse or the keyboard,
it is considered an interactive control and will be selected as a Help Sub-Menu
Item when building the Help Sub-Table.


ΓòÉΓòÉΓòÉ 650. Help for List Box ΓòÉΓòÉΓòÉ

A List Box allows the user to select from a list of items within a window or
dialogue.

Since the List Box can be selected using either the mouse or the keyboard, it
is considered an interactive control and will be selected as a Help Sub-Menu
Item when building the Help Sub-Table.


ΓòÉΓòÉΓòÉ 651. Help for Combo Box ΓòÉΓòÉΓòÉ

A Combo Box allows the user to enter or select items within a window or
dialogue.

Since the Combo Box can be selected using either the mouse or the keyboard, it
is considered an interactive control and will be selected as a Help Sub-Menu
Item when building the Help Sub-Table.


ΓòÉΓòÉΓòÉ 652. Help for Multi-Line Entry ΓòÉΓòÉΓòÉ

A Multi-Line Entry allows the user to enter text into the window or dialogue
through an an entry field or to select predefined items from a drop down list
box.

Since the Multi-Line Entry can be selected using either the mouse or the
keyboard, it is considered an interactive control and will be selected as a
Help Sub-Menu Item when building the Help Sub-Table.


ΓòÉΓòÉΓòÉ 653. Help for Spin Button ΓòÉΓòÉΓòÉ

A Spin Button allows the user to select predefined items within a group of
fields by clicking the mouse pointer on a arrowed button.

Since the Spin Button can be selected using either the mouse or the keyboard,
it is considered an interactive control and will be selected as a Help Sub-Menu
Item when building the Help Sub-Table.


ΓòÉΓòÉΓòÉ 654. Help for Container ΓòÉΓòÉΓòÉ

A Container allows the user to place a group of objects within a gathering
control.

Since the Container can be selected using either the mouse or the keyboard, it
is considered an interactive control and will be selected as a Help Sub-Menu
Item when building the Help Sub-Table.


ΓòÉΓòÉΓòÉ 655. Help for Slider ΓòÉΓòÉΓòÉ

A Slider allows the user to position a sliding indicator relative to a given
scale.

Since the Slider can be selected using either the mouse or the keyboard, it is
considered an interactive control and will be selected as a Help Sub-Menu Item
when building the Help Sub-Table.


ΓòÉΓòÉΓòÉ 656. Help for Value Set ΓòÉΓòÉΓòÉ

A Value Set allows the user to select from a displayed group of similar items.

Since the Value Set can be selected using either the mouse or the keyboard, it
is considered an interactive control and will be selected as a Help Sub-Menu
Item when building the Help Sub-Table.


ΓòÉΓòÉΓòÉ 657. Help for Notebook ΓòÉΓòÉΓòÉ

A Notebook allows the user to place a group of objects within a gathering
control.

Since the Notebook can be selected using either the mouse or the keyboard, it
is considered an interactive control and will be selected as a Help Sub-Menu
Item when building the Help Sub-Table.


ΓòÉΓòÉΓòÉ 658. Help for User Button ΓòÉΓòÉΓòÉ

A User Button allows the user to perform an action within a window or dialogue.

Since the User Button can be selected using either the mouse or the keyboard,
it is considered an interactive control and will be selected as a Help Sub-Menu
Item when building the Help Sub-Table.


ΓòÉΓòÉΓòÉ 659. Help for Circular Slider ΓòÉΓòÉΓòÉ

A Circular Slider allows the user to position a sliding indicator relative to a
given scale within MMPM/2 applications.

Since the Circular Slider can be selected using either the mouse or the
keyboard, it is considered an interactive control and will be selected as a
Help Sub-Menu Item when building the Help Sub-Table.


ΓòÉΓòÉΓòÉ 660. Help for Graphical Button ΓòÉΓòÉΓòÉ

A Graphical Button allows the user to perform an action within a window or
dialogue.

Since the Graphical Button can be selected using either the mouse or the
keyboard, it is considered an interactive control and will be selected as a
Help Sub-Menu Item when building the Help Sub-Table.


ΓòÉΓòÉΓòÉ 661. Help for Handwriting Control ΓòÉΓòÉΓòÉ

A Handwriting Control allows the user to enter information using a pen device
window or dialogue.

Since the Handwriting Control can be selected using either the mouse or pen
device, it is considered an interactive control and will be selected as a Help
Sub-Menu Item when building the Help Sub-Table.


ΓòÉΓòÉΓòÉ 662. Help for Sketch Control ΓòÉΓòÉΓòÉ

A Sketch Control allows the user to enter information using a pen device window
or dialogue.

Since the Sketch Control can be selected using either the mouse or pen device,
it is considered an interactive control and will be selected as a Help Sub-Menu
Item when building the Help Sub-Table.


ΓòÉΓòÉΓòÉ 663. Help for Visible Style ΓòÉΓòÉΓòÉ

Makes a control visible.  If the style is not used, the control will be
invisible.  To make the control visible you use the following:

WinShowWindow(WinWindowFromID(hwndDialogue, idControl), 1)shift op


ΓòÉΓòÉΓòÉ 664. Help for Group Style ΓòÉΓòÉΓòÉ

Specifies the first control of a group of controls in which the user can move
from one control to the next with the direction keys.  All controls defined
after the first control with the group style belong to the same group. The next
control with the group style ends the first group and starts a new group.


ΓòÉΓòÉΓòÉ 665. Help for Disabled Style ΓòÉΓòÉΓòÉ

Used to disable mouse and keyboard input to the control.  You can use this
option to temporarily prevent the user from using the control.  The control can
be enabled using:

WinEnableWindow(WinWindowFromID(hwndDialogue, idControl), 1)shift op


ΓòÉΓòÉΓòÉ 666. Help for Tab Stop Style ΓòÉΓòÉΓòÉ

Specifies one of any number of controls through which the user can move by
tabbing.  The tab key moves the focus to the next control with the tab stop
style.


ΓòÉΓòÉΓòÉ 667. Help for Extended-Selection List Boxes ΓòÉΓòÉΓòÉ

Extended selection is an enhanced form of multiple selection you can use to
select discontinuous ranges of items within the list box.

Extended selection works similar to multiple selection except you use shift or
control keys. The control key allows discontinuous selection like multiple
selection. The shift key allows range selection as an editor would.


ΓòÉΓòÉΓòÉ 668. Help for Using Help Menu ΓòÉΓòÉΓòÉ

The Using help menu item within the Help pull-down menu is generally used to
provide information on how to access the Using help within the Help Manager.

IBM CUA Guidelines suggest that the following menu items are provided to
promote consistancy:

     Help index
     General help
     Using help
     Keys help
     Product information


ΓòÉΓòÉΓòÉ 669. Help for General Help Menu ΓòÉΓòÉΓòÉ

The General help menu item is used to provide information about the contents of
the application's main window.

IBM CUA Guidelines suggest that the following menu items are provided to
promote consistancy:

     Help index
     General help
     Using help
     Keys help
     Product information


ΓòÉΓòÉΓòÉ 670. Help for Keys Help Menu ΓòÉΓòÉΓòÉ

The Keys help menu item is used to provide information for the key assignments
used within the application.

IBM CUA Guidelines suggest that the following menu items are provided to
promote consistancy:

     Help index
     General help
     Using help
     Keys help
     Product information


ΓòÉΓòÉΓòÉ 671. Help for Help Index Menu ΓòÉΓòÉΓòÉ

The Help index menu item is used to display an alphabetic list of all help
index entries for the application.

IBM CUA Guidelines suggest that the following menu items are provided to
promote consistancy:

     Help index
     General help
     Using help
     Keys help
     Product information


ΓòÉΓòÉΓòÉ 672. Help for Production Information Menu ΓòÉΓòÉΓòÉ

The Product information menu item is used to allow your application to display
a dialogue or window containing the application icon, application name and
copyright notice.

IBM CUA Guidelines suggest that the following menu items are provided to
promote consistancy:

     Help index
     General help
     Using help
     Keys help
     Product information


ΓòÉΓòÉΓòÉ 673. Help for Numbered Menu ΓòÉΓòÉΓòÉ

The CUA Advanced Interface Design Guide states that for action bars and
pull-downs, "you should not number choices".

Since the user can easily select menu items when interacting with the
application and to provide consistancy across applications, you should refrain
from using a number as a menu choice.

Note:  An exception to this rule occurs in Multiple Document Interface
       applications in the Window pull-down.  Since the bottom part of the
       Window pull-down is used to allow the user to change the active window,
       an application usually provides a variable list of choices.

The CUA Advanced Interface Design Guide states that the "pull-down must have
the number of the choice assigned as its mnemonic.  In that case, use the
accepted capitalization"


ΓòÉΓòÉΓòÉ 674. Help for Capilization ΓòÉΓòÉΓòÉ

The CUA Advanced Interface Design Guide states that "you should capitalize only
the first letter of a choice unless it contains an acronym, abbreviation, or
proper noun that is normally capitalized.".


ΓòÉΓòÉΓòÉ 675. Help for Mnemonic Selection ΓòÉΓòÉΓòÉ

The CUA Advanced Interface Design Guide states that you should give each action
bar, pull-down or button choice "a unique single-character mnemonic that can be
used to select the choice.".

A mnemonic is a single character that allows the user to quickly select a
choice from the keyboard.  CUA recommends that all applications support
mnemonics.


ΓòÉΓòÉΓòÉ 676. Help for Push Button Mnemonic ΓòÉΓòÉΓòÉ

The CUA Advanced Interface Design Guide states that you should give each push
button choice "a unique single-character mnemonic that can be used to select
the choice.".

A mnemonic is a single character that allows the user to quickly select a
choice from the keyboard.  CUA recommends that all applications support
mnemonics.


ΓòÉΓòÉΓòÉ 677. Help for Action Bar Ordering ΓòÉΓòÉΓòÉ

The CUA Advanced Interface Design Guide states that you should "place the
action bar choices, as applicable, in the following order:

     File
     Edit
     Any application-specific choices, in order according to frequency of use.
      These may include View and Options.
     Help"


ΓòÉΓòÉΓòÉ 678. Help for Action Bar Double Words ΓòÉΓòÉΓòÉ

The CUA Advanced Interface Design Guide states that "you should use only
single-word choices.".

This ensures that no confusion arises when the user views the action bar menu
items since blank space is used to separate each action bar item.


ΓòÉΓòÉΓòÉ 679. Help for Dialogue System Menu ΓòÉΓòÉΓòÉ

The CUA Advanced Interface Design Guide states that the user can "select the
Close action from the system menu of the dialogue box.".

This normally applies when you include a title bar in the dialogue.  If no
title bar is present, the rule is not applied by Prominare Designer.


ΓòÉΓòÉΓòÉ 680. Help for Push Button Ellipsis ΓòÉΓòÉΓòÉ

The CUA Advanced Interface Design Guide states that you should "not leave any
space between the push button text and an ellipsis.".

This normally applies when you include a push button where the action
associated with the push button results in another dialogue box.


ΓòÉΓòÉΓòÉ 681. Help for Menu Foreground Color ΓòÉΓòÉΓòÉ

To change the default foreground color within the menu item, use the Foreground
check box to select another color.

A colored button immediately to the right of the check box allows you to to
display the color table to select the desired color.

From the color table, you select the color you want and then select the Set
push button to set the color.


ΓòÉΓòÉΓòÉ 682. Help for Menu Background Color ΓòÉΓòÉΓòÉ

To change the default background color within the menu item, use the Background
check box to select another color.

A colored button immediately to the right of the check box allows you to to
display the color table to select the desired color.

From the color table, you select the color you want and then select the Set
push button to set the color.


ΓòÉΓòÉΓòÉ 683. Help for Menu Highlight Foreground Color ΓòÉΓòÉΓòÉ

To change the default highlight foreground color within the menu item, use the
Highlight Foreground check box to select another color.

A colored button immediately to the right of the check box allows you to to
display the color table to select the desired color.

From the color table, you select the color you want and then select the Set
push button to set the color.


ΓòÉΓòÉΓòÉ 684. Help for Menu Highlight Background Color ΓòÉΓòÉΓòÉ

To change the default highlight background color within the menu item, use the
Highlight Background check box to select another color.

A colored button immediately to the right of the check box allows you to to
display the color table to select the desired color.

From the color table, you select the color you want and then select the Set
push button to set the color.


ΓòÉΓòÉΓòÉ 685. Help for Menu Disabled Foreground Color ΓòÉΓòÉΓòÉ

To change the default disabled foreground color within the menu item, use the
Disabled Foreground check box to select another color.

A colored button immediately to the right of the check box allows you to to
display the color table to select the desired color.

From the color table, you select the color you want and then select the Set
push button to set the color.


ΓòÉΓòÉΓòÉ 686. Help for Menu Disabled Background Color ΓòÉΓòÉΓòÉ

To change the default disabled background color within the menu item, use the
Disabled Background check box to select another color.

A colored button immediately to the right of the check box allows you to to
display the color table to select the desired color.

From the color table, you select the color you want and then select the Set
push button to set the color.


ΓòÉΓòÉΓòÉ 687. Help for Foreground Color ΓòÉΓòÉΓòÉ

To change the default foreground color within the control, use the Foreground
check box to select another color.

A colored button immediately to the right of the check box allows you to to
display the color table to select the desired color.

From the color table, you select the color you want and then select the Set
push button to set the color.


ΓòÉΓòÉΓòÉ 688. Help for Background Color ΓòÉΓòÉΓòÉ

To change the default background color within the control, use the Background
check box to select another color.

A colored button immediately to the right of the check box allows you to to
display the color table to select the desired color.

From the color table, you select the color you want and then select the Set
push button to set the color.


ΓòÉΓòÉΓòÉ 689. Help for Highlight Foreground Color ΓòÉΓòÉΓòÉ

To change the default highlight foreground color within the control, use the
Highlight Foreground check box to select another color.

A colored button immediately to the right of the check box allows you to to
display the color table to select the desired color.

From the color table, you select the color you want and then select the Set
push button to set the color.


ΓòÉΓòÉΓòÉ 690. Help for Highlight Background Color ΓòÉΓòÉΓòÉ

To change the default highlight background color within the control, use the
Highlight Background check box to select another color.

A colored button immediately to the right of the check box allows you to to
display the color table to select the desired color.

From the color table, you select the color you want and then select the Set
push button to set the color.


ΓòÉΓòÉΓòÉ 691. Help for Disabled Foreground Color ΓòÉΓòÉΓòÉ

To change the default disabled foreground color within the control, use the
Disabled Foreground check box to select another color.

A colored button immediately to the right of the check box allows you to to
display the color table to select the desired color.

From the color table, you select the color you want and then select the Set
push button to set the color.


ΓòÉΓòÉΓòÉ 692. Help for Disabled Background Color ΓòÉΓòÉΓòÉ

To change the default disabled background color within the control, use the
Disabled Background check box to select another color.

A colored button immediately to the right of the check box allows you to to
display the color table to select the desired color.

From the color table, you select the color you want and then select the Set
push button to set the color.


ΓòÉΓòÉΓòÉ 693. Help for Border Color ΓòÉΓòÉΓòÉ

To change the default border color within the control, use the Border check box
to select another color.

A colored button immediately to the right of the check box allows you to to
display the color table to select the desired color.

From the color table, you select the color you want and then select the Set
push button to set the color.


ΓòÉΓòÉΓòÉ 694. Help for Active Color ΓòÉΓòÉΓòÉ

To change the active color within the control, use the Active color check box
to select another color.

A colored button immediately to the right of the check box allows you to to
display the color table to select the desired color.

From the color table, you select the color you want and then select the Set
push button to set the color.

Note:  This should be used with OS/2 2.0 and OS/2 2.1 controls only.


ΓòÉΓòÉΓòÉ 695. Help for Inactive Color ΓòÉΓòÉΓòÉ

To change the inactive color within the control, use the Inactive color check
box to select another color.

A colored button immediately to the right of the check box allows you to to
display the color table to select the desired color.

From the color table, you select the color you want and then select the Set
push button to set the color.

Note:  This should be used with OS/2 2.0 and OS/2 2.1 controls only.


ΓòÉΓòÉΓòÉ 696. Help for Active Text Foreground ΓòÉΓòÉΓòÉ

To change the active color within the control, use the Active text foreground
check box to select another color.

A colored button immediately to the right of the check box allows you to to
display the color table to select the desired color.

From the color table, you select the color you want and then select the Set
push button to set the color.

Note:  This should be used with OS/2 2.0 and OS/2 2.1 controls only.


ΓòÉΓòÉΓòÉ 697. Help for Inactive Text Foreground ΓòÉΓòÉΓòÉ

To change the inactive text foreground color within the control, use the
Inactive text foreground check box to select another color.

A colored button immediately to the right of the check box allows you to to
display the color table to select the desired color.

From the color table, you select the color you want and then select the Set
push button to set the color.

Note:  This should be used with OS/2 2.0 and OS/2 2.1 controls only.


ΓòÉΓòÉΓòÉ 698. Help for Active Text Background ΓòÉΓòÉΓòÉ

To change the active background color within the control, use the Active text
background check box to select another color.

A colored button immediately to the right of the check box allows you to to
display the color table to select the desired color.

From the color table, you select the color you want and then select the Set
push button to set the color.

Note:  This should be used with OS/2 2.0 and OS/2 2.1 controls only.


ΓòÉΓòÉΓòÉ 699. Help for Inactive Text Background ΓòÉΓòÉΓòÉ

To change the inactive text background color within the control, use the
Inactive text background check box to select another color.

A colored button immediately to the right of the check box allows you to to
display the color table to select the desired color.

From the color table, you select the color you want and then select the Set
push button to set the color.

Note:  This should be used with OS/2 2.0 and OS/2 2.1 controls only.


ΓòÉΓòÉΓòÉ 700. Help for Shadow ΓòÉΓòÉΓòÉ

To change the shadow color within the control, use the Shadow check box to
select another color.

A colored button immediately to the right of the check box allows you to to
display the color table to select the desired color.

From the color table, you select the color you want and then select the Set
push button to set the color.

Note:  This should be used with OS/2 2.0 and OS/2 2.1 controls only.


ΓòÉΓòÉΓòÉ 701. Help for Shadow Text ΓòÉΓòÉΓòÉ

To change the shadow text color within the control, use the Shadow text check
box to select another color.

A colored button immediately to the right of the check box allows you to to
display the color table to select the desired color.

From the color table, you select the color you want and then select the Set
push button to set the color.

Note:  This should be used with OS/2 Warp controls only.


ΓòÉΓòÉΓòÉ 702. Help for Shadow Hilight Foreground ΓòÉΓòÉΓòÉ

To change the shadow hilight foreground color within the control, use the
Shadow hilight foreground check box to select another color.

A colored button immediately to the right of the check box allows you to to
display the color table to select the desired color.

From the color table, you select the color you want and then select the Set
push button to set the color.

Note:  This should be used with OS/2 Warp controls only.


ΓòÉΓòÉΓòÉ 703. Help for Shadow Hilight Background ΓòÉΓòÉΓòÉ

To change the shadow hilight background color within the control, use the
Shadow hilight background check box to select another color.

A colored button immediately to the right of the check box allows you to to
display the color table to select the desired color.

From the color table, you select the color you want and then select the Set
push button to set the color.

Note:  This should be used with OS/2 Warp controls only.


ΓòÉΓòÉΓòÉ 704. Help for Icon Background ΓòÉΓòÉΓòÉ

To change the icon background color within the control, use the Icon background
check box to select another color.

A colored button immediately to the right of the check box allows you to to
display the color table to select the desired color.

From the color table, you select the color you want and then select the Set
push button to set the color.

Note:  This should be used with OS/2 Warp controls only.


ΓòÉΓòÉΓòÉ 705. Help for Private ΓòÉΓòÉΓòÉ

When you have designed a custom control that is to be private, it must be
registered by the application.  This is done by using the XxxxRegister function
that must be within custom control dynamic-link library.

You should create an import library through Import Librarian to allow your
applications to easily reference the XxxxRegister function.

Prominare Designer will include the statement:

XxxxRegister(hAB)shift op

within the main() module of the application.


ΓòÉΓòÉΓòÉ 706. Help for Temporary ΓòÉΓòÉΓòÉ

You can use temporary custom controls within your application where you provide
the necessary code to handle the control.  You would treat the control just
like a normal window.

By using the temporary option, Prominare Designer will simulate the the
temporary control within your design.


ΓòÉΓòÉΓòÉ 707. Help for 2 state ΓòÉΓòÉΓòÉ

The 2 state style is used to define a graphic button that has two states:  up
and down.  When the button is in the up state, the button represents an off
condition.  When it is in the down state, the button represents an on
condition.

When the button is pressed by the user, the owner of the button will receive a
notification message GBN_BUTTONDOWN to indicate that the button has been
pressed.  If the final state of the button is to be down, the owner of the
button must send a message to the button, GBM_SETSTATE to cause to remained
depressed.  The Auto 2 state  style can be used in place of this style to cause
the automatic up and down states to be recorded by the button and shown.


ΓòÉΓòÉΓòÉ 708. Help for Auto 2 state ΓòÉΓòÉΓòÉ

The Auto 2 state style is used to define a graphic button that has two states:
up and down.  When the button is in the up state, the button represents an off
condition.  When it is in the down state, the button represents an on
condition.

When the button is pressed by the user, if the button was in the up state, it
will show afterwards in the down state.  The reverse is true if the button was
in a down

The owner of the button will receive a notification message GBN_BUTTONDOWN to
indicate that the button has been pressed.


ΓòÉΓòÉΓòÉ 709. Help for Animation ΓòÉΓòÉΓòÉ

The Animation style is used cause the graphic button to display a series of
bitmaps.  The display of the bitmaps is performed in a circular fashion with
the first bitmap displayed, then the next until the last bitmap afterwhich
first bitmap is displayed, then the next, etc.  A message, GBM_ANIMATE must be
sent to the button to cause the animation to start and stop whereas the Auto
animation  style can be used in place of this style to cause the animation to
be started and stopped when the button is selected by the user.


ΓòÉΓòÉΓòÉ 710. Help for Auto animation ΓòÉΓòÉΓòÉ

The Auto animation style is used cause the graphic button to display a series
of bitmaps.  The display of the bitmaps is performed in a circular fashion with
the first bitmap displayed, then the next until the last bitmap afterwhich
first bitmap is displayed, then the next, etc.  When the button is selected by
the user, the action causes the animation to be started and stopped.


ΓòÉΓòÉΓòÉ 711. Help for Hilite bitmap ΓòÉΓòÉΓòÉ

 The Hilite bitmap style is used to cause the button to display a different
bitmap when the button is in a highlighted (ie. selected) state.


ΓòÉΓòÉΓòÉ 712. Help for Disable bitmap ΓòÉΓòÉΓòÉ

 The Disable bitmap style is used to cause the button to display a different
bitmap when the button is in a disabled (ie. non-selectable) state.


ΓòÉΓòÉΓòÉ 713. Help for 3D recessed text ΓòÉΓòÉΓòÉ

The 3D recessed text style is used to cause the text for the button to be
displayed within a recessed rectangle giving the effect that the text is sunken
within the button.


ΓòÉΓòÉΓòÉ 714. Help for 3D raised text ΓòÉΓòÉΓòÉ

The 3D raised text style is used to cause the text for the button to be
displayed within a raised rectangle giving the effect that the text is above
the button.


ΓòÉΓòÉΓòÉ 715. Help for Mid-point tick ΓòÉΓòÉΓòÉ

The Mid-point tick style cause the mid-point and end point tick marks to be
longer than the other tick marks of the circular slider.


ΓòÉΓòÉΓòÉ 716. Help for No value buttons ΓòÉΓòÉΓòÉ

The No value buttons style prevents + and - buttons from being displayed within
the circular slider.


ΓòÉΓòÉΓòÉ 717. Help for No dial numbers ΓòÉΓòÉΓòÉ

The No dial numbers style prevents scrollable numeric value from being
displayed within the circular slider.


ΓòÉΓòÉΓòÉ 718. Help for No dial text ΓòÉΓòÉΓòÉ

The No dial text style prevents the window title beneath the dial from being
displayed within the circular slider.


ΓòÉΓòÉΓòÉ 719. Help for Direct manipulation ΓòÉΓòÉΓòÉ

The Direct manipulation style allows the user to select the value from within
the circular slider causes the value to change.


ΓòÉΓòÉΓòÉ 720. Help for 360┬░ scroll range ΓòÉΓòÉΓòÉ

The 360┬░ scroll range style causes the scroll range to be exteneded within the
circular slider to be the full dial.


ΓòÉΓòÉΓòÉ 721. Help for Proportional Ticks ΓòÉΓòÉΓòÉ

The Proportional Ticks style causes the tick marks within the circular slider
to be proportional.


ΓòÉΓòÉΓòÉ 722. Help for No Ticks ΓòÉΓòÉΓòÉ

The No ticks style causes the circular slider to have no tick marks.


ΓòÉΓòÉΓòÉ 723. Help for Circular Value ΓòÉΓòÉΓòÉ

The Circular value style causes the circular slider to have circular value.


ΓòÉΓòÉΓòÉ 724. Help for handwriting border ΓòÉΓòÉΓòÉ

The Border style causes a border to be drawn around the entry area of the
handwriting control.


ΓòÉΓòÉΓòÉ 725. Help for 3D handwriting border ΓòÉΓòÉΓòÉ

The 3D border style causes a 3D border to be drawn around the entry area of the
handwriting control.


ΓòÉΓòÉΓòÉ 726. Help for sketch border ΓòÉΓòÉΓòÉ

The Border style causes a border to be drawn around the entry area of the
sketch control.


ΓòÉΓòÉΓòÉ 727. Help for 3D sketch border ΓòÉΓòÉΓòÉ

The 3D border style causes a 3D border to be drawn around the entry area of the
sketch control.


ΓòÉΓòÉΓòÉ 728. Help for Queue Handle ΓòÉΓòÉΓòÉ

The Queue handle is required in each OS/2 Presentation Manager program.  It
usually takes the form of:

hmqApp


ΓòÉΓòÉΓòÉ 729. Help for Frame Handle ΓòÉΓòÉΓòÉ

The Frame handle is used to contain a windows frame handle as returned by the
WinCreateStdWindow function.  It usually takes the form of:

hwndAppFrame


ΓòÉΓòÉΓòÉ 730. Help for Client Handle ΓòÉΓòÉΓòÉ

The Client handle is used to contain the windows client handle as returned
through the WinCreateStdWindow function.  It usually takes the form of:

hwndApp


ΓòÉΓòÉΓòÉ 731. Help for Menu Handle ΓòÉΓòÉΓòÉ

The Menu handle is used to contain the windows action bar handle.  Prominare
Designer will create the necessary code within the WM_CREATE message handling
to retrieve the menu handle for the application.

It usually takes the form of:

hmenuApp


ΓòÉΓòÉΓòÉ 732. Help for WM_CREATE Message ΓòÉΓòÉΓòÉ

Prominare Designer allows you specify a separate function to handle the
WM_CREATE message instead of having the main window procedure code handling the
message.

You must provide the name of the function that will handle the message along
with the name of the source file where the function will be contained.


ΓòÉΓòÉΓòÉ 733. Help for WM_INITMENU Message ΓòÉΓòÉΓòÉ

Prominare Designer allows you specify a separate function to handle the
WM_INITMENU message instead of having the main window procedure code handling
the message.

You must provide the name of the function that will handle the message along
with the name of the source file where the function will be contained.


ΓòÉΓòÉΓòÉ 734. Help for WM_COMMAND Message ΓòÉΓòÉΓòÉ

Prominare Designer allows you specify a separate function to handle the
WM_COMMAND message instead of having the main window procedure code handling
the message.

You must provide the name of the function that will handle the message along
with the name of the source file where the function will be contained.


ΓòÉΓòÉΓòÉ 735. Help for <-date-> ΓòÉΓòÉΓòÉ

The <-date-> macro is used as a marker for the current date.


ΓòÉΓòÉΓòÉ 736. Help for <-file-> ΓòÉΓòÉΓòÉ

The <-file-> macro is used as a marker for the current filename.


ΓòÉΓòÉΓòÉ 737. Help for <DID_CANCEL> ΓòÉΓòÉΓòÉ

The <DID_CANCEL> macro is used as a marker for DID_CANCEL symbol.  Generally it
is used within a case statement within the WM_COMMAND message handling.  For
the most part, this macro symbol is used on within window and dialogues that
utilize push buttons and one of the push buttons is labeled Cancel and the
DID_CANCEL symbol is used to denote it.


ΓòÉΓòÉΓòÉ 738. Help for <DID_OK> ΓòÉΓòÉΓòÉ

The <DID_OK> macro is used as a marker for DID_OK symbol.  Generally it is used
within a case statement within the WM_COMMAND message handling.  For the most
part, this macro symbol is used on within window and dialogues that utilize
push buttons and one of the push buttons is labeled OK (or appropriate label)
and the DID_OK symbol is used to denote it.


ΓòÉΓòÉΓòÉ 739. Help for <FCF> ΓòÉΓòÉΓòÉ

The <FCF> macro is used as a marker for the frame control flags used within a
WinCreateStdWindow function.  The FCF_* flags are OR'ed together and assigned
usually to a variable.


ΓòÉΓòÉΓòÉ 740. Help for <INCL> ΓòÉΓòÉΓòÉ

The <INCL> macro is used as a marker for the INCL_* definitions statements
which govern the OS/2 header files that are to be included with the source
module to aid in the compilation proces.


ΓòÉΓòÉΓòÉ 741. Help for <PDSCtrl> ΓòÉΓòÉΓòÉ

The <PDSCtrl> macro is used as a marker for the location where the
PDSGetTemplate( ) statement is to be placed within the WM_CREATE message
handling when interactive controls are used in a window. (See also<defwinproc>)


ΓòÉΓòÉΓòÉ 742. Help for <classname> ΓòÉΓòÉΓòÉ

The <classname> macro is used as a marker for the location where the window
classes are to be located.


ΓòÉΓòÉΓòÉ 743. Help for <command> ΓòÉΓòÉΓòÉ

The <command> macro is used as a marker for the location where the command
statements are to be placed.


ΓòÉΓòÉΓòÉ 744. Help for <cx> ΓòÉΓòÉΓòÉ

The <cx> macro is used as a marker for the location where the width of a window
is to be placed.


ΓòÉΓòÉΓòÉ 745. Help for <cy> ΓòÉΓòÉΓòÉ

The <cy> macro is used as a marker for the location where the height of a
window is to be placed.


ΓòÉΓòÉΓòÉ 746. Help for <defwinproc> ΓòÉΓòÉΓòÉ

The <defwinproc> macro is used as a marker for the location where the default
window procedure function is placed.  When controls are used within a window
and the PDSGetTemplate function is used (see <PDSCtrl>), the PDSDefWindowProc
is used in place of the WinDefWindowProc function.  The appropriate function
will be used in place of the macro.


ΓòÉΓòÉΓòÉ 747. Help for <hwndClient> ΓòÉΓòÉΓòÉ

The <hwndClient> macro is used as a marker for the location where the client
window handle variable is used.


ΓòÉΓòÉΓòÉ 748. Help for <hwndFrame> ΓòÉΓòÉΓòÉ

The <hwndFrame> macro is used as a marker for the location where the frame
window handle variable is used.


ΓòÉΓòÉΓòÉ 749. Help for <hwndParent> ΓòÉΓòÉΓòÉ

The <hwndParent> macro is used as a marker for the location where the parent
window handle variable is used.


ΓòÉΓòÉΓòÉ 750. Help for <id> ΓòÉΓòÉΓòÉ

The <id> macro is used as a marker for the location where an ID symbol or value
is used.


ΓòÉΓòÉΓòÉ 751. Help for <idActionBar> ΓòÉΓòÉΓòÉ

The <idActionBar> macro is used as a marker for the location where an ID symbol
or value for an action menu is used.


ΓòÉΓòÉΓòÉ 752. Help for <idButton> ΓòÉΓòÉΓòÉ

The <idButton> macro is used as a marker for the location where an ID symbol or
value for a push button is used.


ΓòÉΓòÉΓòÉ 753. Help for <idDlg> ΓòÉΓòÉΓòÉ

The <idDlg> macro is used as a marker for the location where an ID symbol or
value for a dialogue is used.


ΓòÉΓòÉΓòÉ 754. Help for <idMenu> ΓòÉΓòÉΓòÉ

The <idMenu> macro is used as a marker for the location where an ID symbol or
value for a menu item is used.


ΓòÉΓòÉΓòÉ 755. Help for <include> ΓòÉΓòÉΓòÉ

The <include> macro is used as a marker for the location where #include
statements are to be placed.


ΓòÉΓòÉΓòÉ 756. Help for <localvars> ΓòÉΓòÉΓòÉ

The <localvars> macro is used as a marker for the location where local
variables defined for messages included within a window or dialogue procedure
are to be placed.  This location should be within the scope definitions of the
compiler that you are using.


ΓòÉΓòÉΓòÉ 757. Help for <notify> ΓòÉΓòÉΓòÉ

The <notify> macro is used as a marker for the location where notification
messages are to be placed.  This is generally used in conjunction with the
WM_CONTROL message.


ΓòÉΓòÉΓòÉ 758. Help for <pfnDlgProc> ΓòÉΓòÉΓòÉ

The <pfnDlgProc> macro is used as a marker for the location where dialogue
procedure name is to be placed.


ΓòÉΓòÉΓòÉ 759. Help for <pfnWndProc> ΓòÉΓòÉΓòÉ

The <pfnWndProc> macro is used as a marker for the location where window
procedure name is to be placed.


ΓòÉΓòÉΓòÉ 760. Help for <statements> ΓòÉΓòÉΓòÉ

The <statements> macro is used as a marker for the location where message
statements are to be placed within a window or dialogue procedure.


ΓòÉΓòÉΓòÉ 761. Help for <statics> ΓòÉΓòÉΓòÉ

The <statics> macro is used as a marker for the location where static variables
are to be placed within a source module.


ΓòÉΓòÉΓòÉ 762. Help for <style> ΓòÉΓòÉΓòÉ

The <style> macro is used as a marker for the location where style flags are to
be placed.


ΓòÉΓòÉΓòÉ 763. Help for <titlebar> ΓòÉΓòÉΓòÉ

The <titlebar> macro is used as a marker for the location where the title bar
text is to be placed.


ΓòÉΓòÉΓòÉ 764. Help for <x> ΓòÉΓòÉΓòÉ

The <x> macro is used as a marker for the location where the x co-ordinate of
the window is to be placed.


ΓòÉΓòÉΓòÉ 765. Help for <y> ΓòÉΓòÉΓòÉ

The <x> macro is used as a marker for the location where the y co-ordinate of
the window is to be placed.


ΓòÉΓòÉΓòÉ 766. Help for text type visual ΓòÉΓòÉΓòÉ

The visual text type causes a certain piece of text to have no sub-segments.


ΓòÉΓòÉΓòÉ 767. Help for text type implicit ΓòÉΓòÉΓòÉ

The implicit text type causes the text to be represented as the orders of the
characters as they are typed on the keyboard.


ΓòÉΓòÉΓòÉ 768. Help for window orientation left to right ΓòÉΓòÉΓòÉ

The left to right window orientation causes the window to have its orientation
in the bottom left corner.


ΓòÉΓòÉΓòÉ 769. Help for window orientation right to left ΓòÉΓòÉΓòÉ

The right to left window orientation causes the window to have its orientation
in the bottom right corner.


ΓòÉΓòÉΓòÉ 770. Help for text orientation left to right ΓòÉΓòÉΓòÉ

The left to right text orientation causes the text to be displayed starting
from the left and moving to the right.


ΓòÉΓòÉΓòÉ 771. Help for text orientation right to left ΓòÉΓòÉΓòÉ

The right to left text orientation causes the text to be displayed starting
from the right and moving to the left.


ΓòÉΓòÉΓòÉ 772. Help for text orientation contextual ΓòÉΓòÉΓòÉ

The contextual text orientation causes the text to be displayed either left to
right or right to left based upon the first strong character.


ΓòÉΓòÉΓòÉ 773. Help for numerals nominal ΓòÉΓòÉΓòÉ

The nominal numerals causes the display of only nominal (i.e. Arabic) numerals.


ΓòÉΓòÉΓòÉ 774. Help for numerals pass through ΓòÉΓòÉΓòÉ

The pass through numerals causes the display as stored.


ΓòÉΓòÉΓòÉ 775. Help for numerals national ΓòÉΓòÉΓòÉ

The national numerals causes the display of only national (i.e. Hindi)
numerals.


ΓòÉΓòÉΓòÉ 776. Help for numerals contextual ΓòÉΓòÉΓòÉ

The contextual numerals causes the numerals to be displayed based on the
surronding text.


ΓòÉΓòÉΓòÉ 777. Help for symmetric swapping off ΓòÉΓòÉΓòÉ

The off symmetric swapping causes the characters such as brackets, braces and
parentheses to not be swapped.


ΓòÉΓòÉΓòÉ 778. Help for symmetric swapping on ΓòÉΓòÉΓòÉ

The off symmetric swapping causes the characters such as brackets, braces and
parentheses to be swapped.


ΓòÉΓòÉΓòÉ 779. Help for word break off ΓòÉΓòÉΓòÉ

The off word break determination prevents word recognition.


ΓòÉΓòÉΓòÉ 780. Help for word break on ΓòÉΓòÉΓòÉ

The on word break determination allows word recognition.


ΓòÉΓòÉΓòÉ 781. Help for character shape determination display shaped ΓòÉΓòÉΓòÉ

The display shaped character shape determination causes the text that is stored
in a nominal/base shape to be automatically shaped upon display.


ΓòÉΓòÉΓòÉ 782. Help for character shape determination save shaped ΓòÉΓòÉΓòÉ

The display shaped character shape determination is already shaped and ready
for display.


ΓòÉΓòÉΓòÉ 783. Help for character shape determination nominal ΓòÉΓòÉΓòÉ

The nominal character shape determination is displayed and stored in its
nominal (base) shapes.


ΓòÉΓòÉΓòÉ 784. Help for character shape determination initial ΓòÉΓòÉΓòÉ

The initial character shape determination is already shaped and ready for
display.


ΓòÉΓòÉΓòÉ 785. Help for character shape determination middle ΓòÉΓòÉΓòÉ

The middle character shape determination is already shaped and ready for
display.


ΓòÉΓòÉΓòÉ 786. Help for character shape determination final ΓòÉΓòÉΓòÉ

The final character shape determination is already shaped and ready for
display.


ΓòÉΓòÉΓòÉ 787. Help for character shape determination isolated ΓòÉΓòÉΓòÉ

The isolated character shape determination is already shaped and ready for
display.


ΓòÉΓòÉΓòÉ <hidden> Help for Accelerator Keys ΓòÉΓòÉΓòÉ

The following accelerator keys are defined for use within Prominare Designer:

 Key            Function

 Ctrl+A         Save As.

 Ctrl+C         Edit styles of selected control.

 Ctrl+D         Duplicate control.

 Ctrl+F         Set focus.

 Ctrl+G         Order controls.

 Ctrl+I         Align controls.

 Ctrl+L         Tools windows.

 Ctrl+M         Order menu items.

 Ctrl+N         File new.

 Ctrl+O         Open.

 Ctrl+P         Save window position.

 Ctrl+R         Replace controls.

 Ctrl+S         File save.

 Ctrl+T         Test mode.

 Ctrl+V         Show window/dialogue list.

 Ctrl+W         Edit new dialogue/window.

 F4             Search next.

 Del            Delete.

 Shift+Del      Cut.

 Ctrl+Ins       Copy.

 Shift+Ins      Paste.

 Alt+Ins        Edit Paste from file.

 Alt+Ctrl+M     File merge.

 Alt+Backspace  Undo.

 Shift+Alt+Backspace Redo.


ΓòÉΓòÉΓòÉ 788. Help for Keys ΓòÉΓòÉΓòÉ

Double click on one of the following groups to get help for keys that do a
specific task:

     Accelerator keys
     Cursor movement keys
     Editing keys
     Text selection keys
     Action bar keys
     Menu keys
     Dialogue keys
     System keys


ΓòÉΓòÉΓòÉ <hidden> Help for Action bar keys ΓòÉΓòÉΓòÉ

Use these keys to select the System icon and action bar items.

 Key:           Function:

 F10            Switches between the action bar and the design area.

 Shift+Esc      Switches between the System icon and the design area.

 Right          Highlights the next action bar item or the System icon.

 Left           Highlights the previous action bar item or the System icon.

 Enter          Accesses the pull-down of the highlighted action bar item or
                System icon.

 Mnemonic       The mnemonic key is the key corresponding with the underlined
                letter in the action bar items.  It accesses the pull-down of
                the action bar item containing the mnemonic.

 Escape         Returns to the design area.


ΓòÉΓòÉΓòÉ <hidden> Help for Menu keys ΓòÉΓòÉΓòÉ

Use these keys to select pull-down items.

 Key:           Function:

 Up             Moves up one pull-down item.

 Down           Moves down one pull-down item.

 Enter          Selects the highlighted pull-down item.

 Mnemonic       The mnemonic key is the key corresponding with the underlined
                letter in the pull-down items.  It selects the pull-down item
                containing the mnemonic.

 Escape         Closes the pull-down.


ΓòÉΓòÉΓòÉ <hidden> Help for Dialogue keys ΓòÉΓòÉΓòÉ

Use these keys to select dialogue box items.

 Key:          Function:

 Tab           Moves to the next control group on the dialogue.

 Shift+Tab     Moves to the previous control group on the dialogue.

 Right         Moves to the next button on the dialogue.

 Left          Moves to the previous button on the dialogue.

 Up            Moves up one item in a selection box.

 Down          Moves down one item in a selection box.

 Page Up       Scrolls up one page in a selection box with scroll bars.

 Page Down     Scrolls down one page in a selection box with scroll bars.

 Spacebar      Switches a check box on and off.

 Enter         Starts the activity for the selected push button.

 Escape        Exits the dialogue.


ΓòÉΓòÉΓòÉ <hidden> Help for System keys ΓòÉΓòÉΓòÉ

Use these keys to switch between, move, and size Presentation Manager windows.

 Key:                Function:

 Alt+Tab             Switches to the next Presentation Manager window.

 Alt+Shift+Tab       Switches to the previous Presentation Manager window.

 Alt+Esc             Switches to the next application (including
                     non-Presentation Manager applications).

 Ctrl+Esc            Switches to the Task List.

 Alt+F4              Closes the active window.

 Alt+F5              Restores the active window.

 Alt+F7              Moves the active window.

 Alt+F8              Sizes the active window.

 Alt+F9              Minimizes the active window.

 Alt+F10             Maximizes the active window.


ΓòÉΓòÉΓòÉ 789. Help for Clipboard ΓòÉΓòÉΓòÉ

The Clipboard holds the window or dialogue that you Cut or Copy.

The Clipboard can only hold one block of window or dialogue at a time.  When
you Cut or Copy window or dialogue, any window or dialogue that is already in
the Clipboard is replaced.

When you use Paste window or dialogue, the window or dialogue in the Clipboard
is inserted into the file.


ΓòÉΓòÉΓòÉ <hidden> Help for Cursor movement keys ΓòÉΓòÉΓòÉ

Use these keys to move the cursor in an entry field.

 Key:          Function:

 Up            Moves the cursor up one line.

 Down          Moves the cursor down one line.

 Right         Moves the cursor right one character.

 Left          Moves the cursor left one character.

 Ctrl+Right    Moves the cursor to the beginning of the next word.

 Ctrl+Left     Moves the cursor to the beginning of the previous word.

 Home          Moves the cursor to the beginning of the current line.

 End           Moves the cursor to the end of the current line.

 Ctrl+Home     Moves the cursor to the beginning of the first line in the file.

 Ctrl+End      Moves the cursor to the end of the last line in the file.

 Page Up       Scrolls the window or dialogue up one window.

 Page Down     Scrolls the window or dialogue down one window.


ΓòÉΓòÉΓòÉ <hidden> Help for Editing keys ΓòÉΓòÉΓòÉ

Use these keys to edit the text in the file.

 Key:              Function:

 Insert            Switches between insert and overtype mode.

                   In insert mode, new text is inserted at the cursor position,
                   moving the existing text to the right.

                   In overtype mode, the new text replaces the existing text.

 Delete            If text is selected, the selected text is deleted.

                   If no text is selected, the character to the right of the
                   cursor is deleted, and any remaining characters to the right
                   of the cursor are shifted left.

 Backspace         If text is selected, the selected text is deleted.

                   If no text is selected, the character to the left of the
                   cursor is deleted, and any remaining characters to the right
                   of the cursor are shifted left.

 Ctrl+Delete       Deletes all characters from the cursor to the end of the
                   current line.

 Shift+Del         Cuts the selected text out of the file and saves it in the
                   Clipboard.

 Ctrl+Ins          Copies the selected from the file and saves it in the
                   Clipboard.

 Shift+Ins         Pastes the text in the Clipboard into the file at the cursor
                   position.

                   If text is selected, the Clipboard text will replace the
                   selected text.

                   If no text is selected, the Clipboard text is inserted at
                   the cursor position.

 Alt+Backspace     Undoes the last change made


ΓòÉΓòÉΓòÉ <hidden> Help for Text selection keys ΓòÉΓòÉΓòÉ

Use these keys to select text and extend existing selected areas of text.

CAUTION:
 If an area of text is selected, pressing any character key, the Backspace key,
or the Delete key deletes the selected text from the entry field.

 Key:                Function:

 Shift+arrow         Selects text or extends a selection in the direction of
                     the arrow.

 Shift+Home          Selects text or extends a selection to the beginning of
                     the current line.

 Shift+End           Selects text or extends a selection to the end of the
                     current line.

 Shift+Ctrl+Right    Selects text or extends a selection to the beginning of
                     the next word.

 Shift+Ctrl+Left     Selects text or extends a selection to the beginning of
                     the previous word.

 Shift+Ctrl+Home     Selects text or extends a selection to the beginning of
                     the file.

 Shift+Ctrl+End      Selects text or extends a selection to the end of the
                     file.


ΓòÉΓòÉΓòÉ 790. Help for Styles Dialogue ΓòÉΓòÉΓòÉ

The styles dialogue allows you to set the text, ID symbol/value, options, and
various styles for a control you have selected.  Depending on your target
operating system environment, you will be able to set options for the
bidirectional and pen support.

The first tab, Styles, allows you set the various styles, text, ID symbol/value
and options options for the control.  This tab will differ from one control to
another unless the control is part of a family of controls (such as buttons and
statics) and you are using the Expert mode of the Prominare Designer.

The second tab, Font & colors, is used to set the font and colors for the
control.

The third tab, Bidi, will only be available when you have targeted Warp.  This
tab allows you to set the bidirectional options for the control.

The final tab, Pen, will only be available when you have targeted Warp and only
for entry fields, multiple-line entry fields, spin buttons, combination boxes
and handwriting controls.  This tab allows you to set the pen options for the
control.


ΓòÉΓòÉΓòÉ 791. Help for Bidi Tab ΓòÉΓòÉΓòÉ

The Bidi tab is used to change the bidirection characteristics of controls
within the dialogue or window you are currently designing.

You can set the following window orientation:

     Left to right
     Right to left

 You can set the following text types:

     Visual
     Implicit

 The symmetric swapping types you can set are:

     Off
     On

 You can set the following text orientation:

     Left to right
     Right to left
     Contextual

 The word break types you can set are:

     Off
     On

 The numeric types you can set are:

     Nominal
     Pass through
     National
     Contextual

 You can set the character shape determination for:

     Display shaped
     Nominal
     Middle
     Isolated
     Save shapped
     Initial
     Final


ΓòÉΓòÉΓòÉ 792. Help for Bitmap Styles ΓòÉΓòÉΓòÉ

The Bitmap styles are used to set ID symbol and value and base styles.

Base styles are:

     Visible
     Tab stop
     Group
     Disabled

 Related tabs:

     Font & colors
     Bidi

 Presentation Manager Guide and Reference:

       About Static Controls
            Keyboard Focus
            Static Control Handle
            Static Control Styles
            Default Static Control Performance
       Using Static Controls
            Using Static Control in a Dialogue Window
            Using Static Control in a Client Window
       Static Control Window Processing
            Static Control Styles


ΓòÉΓòÉΓòÉ 793. Help for Check Box Styles Tab ΓòÉΓòÉΓòÉ

The Check box tab is used to set button types and styles.  It is also used to
set the button text, ID symbol and value.

Button types that are possible are:

     Auto

     3 state

 Button options that are possible are:

     No Focus
     No Pointer Select
     Checked
     Auto size

 Base styles are:

     Visible
     Tab stop
     Group
     Disabled

 Related tabs:

     Font & colors
     Bidi

 Presentation Manager Guide and Reference:

       About Button Controls
            Button Types
            Button Styles
            Default Button Behavior
            Button Notification Messages
            Button States
            Custom Buttons
       Using Button Controls
            Using Buttons in a Dialogue Window
            Using Buttons in a Client Window
            Creating Buttons with Icons and Icon/Text Combinations
       Button Control Window Processing
            Button Control Styles
            Default Colours


ΓòÉΓòÉΓòÉ 794. Help for Push Button Styles Tab ΓòÉΓòÉΓòÉ

The Push Button Styles tab is used to set button types and styles.  It is also
used to set the button text, ID symbol and value.

Button options that are possible are:

     Default
     Help
     SYSCOMMAND
     No Border
     No Focus
     Hilighted
     Icon
     Bitmap
     Auto size
     Text
     Mini-icon

 Base styles are:

     Visible
     Tab stop
     Group
     Disabled

 Related tabs:

     Font & colors
     Bidi

 Presentation Manager Guide and Reference:

       About Button Controls
            Button Types
            Button Styles
            Default Button Behavior
            Button Notification Messages
            Button States
            Custom Buttons
       Using Button Controls
            Using Buttons in a Dialogue Window
            Using Buttons in a Client Window
            Creating Buttons with Icons and Icon/Text Combinations
       Button Control Window Processing
            Button Control Styles
            Default Colours


ΓòÉΓòÉΓòÉ 795. Help for User Button Styles Tab ΓòÉΓòÉΓòÉ

The User Button Styles tab is used to set button types and styles.  It is also
used to set the button text, ID symbol and value.

Base styles are:

     Visible
     Tab stop
     Group
     Disabled

 Related tabs:

     Font & colors
     Bidi

 Presentation Manager Guide and Reference:

       About Button Controls
            Button Types
            Button Styles
            Default Button Behavior
            Button Notification Messages
            Button States
            Custom Buttons
       Using Button Controls
            Using Buttons in a Dialogue Window
            Using Buttons in a Client Window
            Creating Buttons with Icons and Icon/Text Combinations
       Button Control Window Processing
            Button Control Styles
            Default Colours


ΓòÉΓòÉΓòÉ 796. Help for Radio Button Styles Tab ΓòÉΓòÉΓòÉ

The Radio Buttons Styles tab is used to set button types and styles.  It is
also used to set the button text, ID symbol and value.

Button options that are possible are:

     Auto
     No focus
     No pointer select
     Checked
     Hilighted
     Auto size

 Base styles are:

     Visible
     Tab stop
     Group
     Disabled

 Related tabs:

     Font & colors
     Bidi

 Presentation Manager Guide and Reference:

       About Button Controls
            Button Types
            Button Styles
            Default Button Behavior
            Button Notification Messages
            Button States
            Custom Buttons
       Using Button Controls
            Using Buttons in a Dialogue Window
            Using Buttons in a Client Window
            Creating Buttons with Icons and Icon/Text Combinations
       Button Control Window Processing
            Button Control Styles
            Default Colours


ΓòÉΓòÉΓòÉ 797. Help for Rectangle Styles Tab ΓòÉΓòÉΓòÉ

The Rectangle Styles tab is used to set rectangle styles.  It is also used to
set the ID symbol and value.

Possible rectangle types are:

     Foreground
     Halftone
     Background

 Base styles are:

     Visible
     Tab stop
     Group
     Disabled

 Related tabs:

     Font & colors
     Bidi

 Presentation Manager Guide and Reference:

       About Static Controls
            Keyboard Focus
            Static Control Handle
            Static Control Styles
            Default Static Control Performance
       Using Static Controls
            Using Static Control in a Dialogue Window
            Using Static Control in a Client Window
       Static Control Window Processing
            Static Control Styles


ΓòÉΓòÉΓòÉ 798. Help for Text Styles Tab ΓòÉΓòÉΓòÉ

The Text tab is used to set text styles.  It is also used to set the text, ID
symbol and value.

Text style options that are possible are:

     Left Aligned
     Horz. Aligned
     Right Aligned
     Top Aligned
     Vert. Centered
     Bottom Aligned
     Word Wrap
     Halftone
     Mnemonic
     Auto size

 Base styles are:

     Visible
     Tab stop
     Group
     Disabled

 Related tabs:

     Font & colors
     Bidi

 Presentation Manager Guide and Reference:

       About Static Controls
            Keyboard Focus
            Static Control Handle
            Static Control Styles
            Default Static Control Performance
       Using Static Controls
            Using Static Control in a Dialogue Window
            Using Static Control in a Client Window
       Static Control Window Processing
            Static Control Styles


ΓòÉΓòÉΓòÉ 799. Help for Group Box Styles Tab ΓòÉΓòÉΓòÉ

The Groupbox Styles dialogue is used to set group box styles.  It is also used
to set the group box text, ID symbol and value.

Group box style options that are possible are:

     Halftone
     Mnemonic

 Base styles are:

     Visible
     Tab stop
     Group
     Disabled

 Related tabs:

     Font & colors
     Bidi

 Presentation Manager Guide and Reference:

       About Static Controls
            Keyboard Focus
            Static Control Handle
            Static Control Styles
            Default Static Control Performance
       Using Static Controls
            Using Static Control in a Dialogue Window
            Using Static Control in a Client Window
       Static Control Window Processing
            Static Control Styles


ΓòÉΓòÉΓòÉ 800. Help for Handwriting Styles Tab ΓòÉΓòÉΓòÉ

Note:  This control is only available for Pen for OS/2 and requires the Pen for
       OS/2 toolkit to be able to use this option.

 The Handwriting tab is used to set the display type and general options of the
 Pen for OS/2 handwriting control. It is also used to set the text, ID symbol
 and value.

 Default items can be:

     Border
     3D border

 Base styles are:

     Visible
     Tab stop
     Group
     Disabled

 Related tabs:

     Font & colors
     Bidi
     Pen

 Pen for OS/2 Programming Guide and Reference:

       Using the Boxed Handwriting Control and Pen-Aware PM Controls
            Boxed Handwriting Control
                 Creating a Window in Boxed Mode
                      Using Default Values for  Handwriting Control
                 Using Handwriting Controls in a Dialogue Window
                 Sizing a Boxed Handwriting Control
                 Gestures Support by the HWX Control
            Pen-Aware PM Controls
                 Using the Flat Structures
                 Using the Non-Flat Structures
                 Creating a Single-Line Entry-Field Control with a Non-Flat
                Structure
                 Creating a Multi-Line Entry-Field Control with a Non-Flat
                Structure
                 Creating a Multi-Line Entry-Field Control with a Flat
                Structure
                 Changing the Metrics and Restricting Recognition for an MLE
                 Creating a Combo Box Control
                 Creating a Spin Button Control
                 Gestures Supported by the Pen-Aware Controls
            Sample Programs
                 Handwriting Control Sample (HWX_SAMP)
                 Sketch/Handwriting Sample Program


ΓòÉΓòÉΓòÉ 801. Help for Circular Slider Styles Tab ΓòÉΓòÉΓòÉ

Note:  This control is only available for OS/2 MMPM/2 or Warp and requires the
       Warp toolkit to be able to use this option.

 The Circular Slider tab is used to set the display type and general options of
 the MMPM/2 circular slider. It is also used to set the text, ID symbol and
 value.

 Default items can be:

     Mid-point tick
     No value buttons
     No dial numbers
     No dial text
     Direct manipulation
     360┬░ scroll range
     Proportional ticks
     No ticks
     Circular value

 Base styles are:

     Visible
     Tab stop
     Group
     Disabled

 Related tabs:

     Font & colors
     Bidi

 Presentation Manager Guide and Reference:

       About Slider Controls
            Linear Sliders
            Circular Sliders
       Using Slider Controls
            Creating a Linear Slider
            Retrieving Data for a Selected Slider Values
            Creating a Circular Slider
            Circular Slider Sample
       Graphical User Interface Support for Slider Controls
            Slider Navigation Techniques
       Slider Control Window Processing
            Slider Control Styles


ΓòÉΓòÉΓòÉ 802. Help for Graphic Button Styles Tab ΓòÉΓòÉΓòÉ

Note:  This control is only available for OS/2 2.0, 2.1, 2.11, Warp and above
       and requires the MMPM/2 or Warp toolkit to be able to use this option.

 The Graphic Button tab is used to set the display type and general options of
 the MMPM/2 graphic button. It is also used to set the text, ID symbol and
 value.

 Default items can be:

     2 state
     Auto 2 state
     Animation
     Auto animation
     Hilite bitmap
     Disable bitmap
     3D recessed text
     3D raised text

 Base styles are:

     Visible
     Tab stop
     Group
     Disabled

 Related tabs:

     Font & colors
     Bidi

 Presentation Manager Guide and Reference:

       Graphic Button Control
            WinRegisterGraphicButton
            Control Data
            Styles
            Control Messages


ΓòÉΓòÉΓòÉ 803. Help for System Icon Styles Tab ΓòÉΓòÉΓòÉ

The System Icon style is used to create a static System Icon within a dialogue.

Usually, the System Icon is placed within a dialogue to explain a point of
interest.

Since the System Icon is using a predefined icon with the OS/2 Presentation
Manager, special rules apply to how you define it.

Unlike other controls, you cannot enter values that are not a System Icon
designation.  The system icons that can be selected are:

       SPTR_ARROW
       SPTR_TEXT
       SPTR_WAIT
       SPTR_MOVE
       SPTR_SIZENWSE
       SPTR_SIZENESW
       SPTR_SIZEWE
       SPTR_SIZENS
       SPTR_APPICON
       SPTR_ICONINFORMATION
       SPTR_ICONQUESTION
       SPTR_ICONERROR
       SPTR_ICONWARNING
       SPTR_ILLEGAL
       SPTR_FILE
       SPTR_FOLDER
       SPTR_MULTFILE
       SPTR_PROGRAM

 Base styles are:

     Visible
     Tab stop
     Group
     Disabled

 Presentation Manager Guide and Reference:

       About Static Controls
            Keyboard Focus
            Static Control Handle
            Static Control Styles
            Default Static Control Performance
       Using Static Controls
            Using Static Control in a Dialogue Window
            Using Static Control in a Client Window
       Static Control Window Processing
            Static Control Styles


ΓòÉΓòÉΓòÉ 804. Help for Child Window Styles Tab ΓòÉΓòÉΓòÉ

The Child Window Styles tab is used to set child window styles. It is also used
to set the title bar text, window ID symbol and value along with the function
name and source file filename.

Possible styles are:

     Title Bar
     System Menu
     Horz. Scroll
     Vert. Scroll
     Visible
     Size Border
     Border
     Dialogue Frame
     System Modal
     Min Button
     Max Button
     Auto icon

 Related tabs:

     Font & colors
     Bidi
     Pen

 Presentation Manager Guide and Reference:

       About Windows
            Desktop Window and Desktop-Object Window
            Window Relationships
            Application Windows
            Window Input and Output
            Window Creation
            Window Classes
            Window Styles
            Window Handles
            Window Size and Position
            Window Data
            Window Resources
            Maximized and Minimized Windows
            Window Visibility
            Window Destruction
       Using Windows
            Creating a Top-Level Frame Window
            Creating an Object Window
            Querying Window Data
            Changing the Parent Window
            Finding a Parent, Child, or Owner Window
            Retrieving the Handle of a Child or Owned Window
            Enumerating Top-Level Windows
            Moving and Sizing a Window
            Redrawing Windows
            Changing the Z-Order of Windows
            Showing or Hiding a Window
            Maximizing, Minimizing, and Restoring a Frame Window
            Destroying a Window


ΓòÉΓòÉΓòÉ 805. Help for Dialogue/Window Styles ΓòÉΓòÉΓòÉ

The Dialogue/Window Styles dialogue allows you to set the text, ID
symbol/value, options, and various styles for a dialogue, notebook page or
window you have selected or are creating.  Depending on your target operating
system environment, you will be able to set options for the bidirectional
support.

The first tab, Styles, allows you set the various styles, text, ID symbol/value
and options options for the dialogue, notebook page or window.

The second tab, Distribution, allows you select the resource script or binary
file where the dialogue or window information should be recorded.

The third tab, Notes, allows you enter and/or view design notes for the
dialogue, notebook page or window.

The fourth tab, Font & colors, is used to set the font and colors for the
dialogue, notebook page or window.

The last tab, Bidi, will only be available when you have targeted Warp.  This
tab allows you to set the bidirectional options for the window or dialogue.


ΓòÉΓòÉΓòÉ 806. Help for Window/Dialogue Styles Tab ΓòÉΓòÉΓòÉ

The Window/Dialogue Styles tab is used to set a window's or dialogue's styles.
It is also used to set the title bar text, window ID symbol and value along
with window or dialogue description.

You also set the type of window or dialogue being set.  These types are:

     Parent Window
     Child Window
     Dialogue
     Notebook page
     WP settings page

 The relative position that the window or dialogue takes can be one of the
 following:

     Window
     Screen
     Mouse

 Note:  The relative positions are only available for Child Windows and
        Dialogues.

 The parent window for the window or dialogue can be one of the following:

     Desktop
     Main Window
     Object Window

 When you have selected the tab as the type, the drop down lists within the tab
 linkage group become active.  You are expected to select the dialogue which
 contains a notebook from the drop down labeled Dialogue. The dialogue selected
 will then be scanned for notebook definitions and the symbols of these
 notebooks will be placed within the drop down labeled Notebook.

 Once you have selected the target notebook, the necessary information for that
 notebook such as the size, tab orientation, etc. will be used as base to allow
 you to design the contents of the tab.

 Possible styles are:

     Title Bar
     System Menu
     Horz. Scroll Bar
     Vert. Scroll Bar
     Visible
     Size Border
     Border
     Dialogue Frame
     System Modal
     Menu
     Min Button
     Max Button
     Accelerators
     Standard
     Shell position
     Auto icon
     DBCS status

     Distribution
     Notes
     Font & colors
     Bidi

 Presentation Manager Guide and Reference:

       About Windows
            Desktop Window and Desktop-Object Window
            Window Relationships
            Application Windows
            Window Input and Output
            Window Creation
            Window Classes
            Window Styles
            Window Handles
            Window Size and Position
            Window Data
            Window Resources
            Maximized and Minimized Windows
            Window Visibility
            Window Destruction
       Using Windows
            Creating a Top-Level Frame Window
            Creating an Object Window
            Querying Window Data
            Changing the Parent Window
            Finding a Parent, Child, or Owner Window
            Retrieving the Handle of a Child or Owned Window
            Enumerating Top-Level Windows
            Moving and Sizing a Window
            Redrawing Windows
            Changing the Z-Order of Windows
            Showing or Hiding a Window
            Maximizing, Minimizing, and Restoring a Frame Window
            Destroying a Window


ΓòÉΓòÉΓòÉ 807. Help for ID Tab ΓòÉΓòÉΓòÉ

The ID tab of the Popup Menu dialogue is used to set the ID for a popup menu as
well as a description.

Related tabs:

     Distribution
     Font & colors
     Bidi


ΓòÉΓòÉΓòÉ 808. Help for User Defined Tab ΓòÉΓòÉΓòÉ

The User Defined Temporary Control tab is used to define a custom control
commonly none as User Defined Controls. control ID and value.

Through the tab, you enter the classname of the control, the text and ID.

Related tabs:

     Font & colors
     Bidi


ΓòÉΓòÉΓòÉ 809. Help for DLL Error Message Box ΓòÉΓòÉΓòÉ

The DLL error message box is informing you that one of the DLLs used by the
Prominare Designer could not be loaded or that a DLL function entry point could
not be found.

Check to make sure that the DLL is in the proper location or that your LIBPATH
statement points to it if the DLL could not be found.

When the DLL function entry point could not be found, make sure that the DLL
has not be corrupted.


ΓòÉΓòÉΓòÉ 810. Help for Duplicate Filename ΓòÉΓòÉΓòÉ

If you have entered a .DFM filename which is already registered within the
Prominare Designer, the Duplicate Filename dialogue will be displayed to allow
you to select an alternate name.

The original name will be displayed above an entry field in which you can enter
the new name.


ΓòÉΓòÉΓòÉ 811. Help for PMCX/Temporary Controls Definitions ΓòÉΓòÉΓòÉ

The PMCX/Temporary Controls Definitions dialogue is used to define the custom
controls that conform to the PMCX definition and that you want to use within
Prominare Designer.

You can also use the dialogue to define a temporary control.


ΓòÉΓòÉΓòÉ 812. Help for Resource Distribution Definition ΓòÉΓòÉΓòÉ

To define the locations and files under which resource elements are to be
placed, select the Resource distribution menu item within the Options menu.

The Resource Distribution Definition dialogue will be displayed allowing you to
specify locations and filenames under which dialogues, windows, accelerator
tables, etc. can be placed.


ΓòÉΓòÉΓòÉ 813. Help for Locate ΓòÉΓòÉΓòÉ

The Locate dialogue is used to locate a resource file which is used as part of
the resource distribution.  The file will either be a .RC or .RES file.  The
file search type is based on which entry field of the Resource Distribution
Definition dialogue resides in.


ΓòÉΓòÉΓòÉ 814. Help for Locate Path ΓòÉΓòÉΓòÉ

The Locate Path dialogue is used to locate a path to use.


ΓòÉΓòÉΓòÉ 815. Help for Notebook Parent ΓòÉΓòÉΓòÉ

The Notebook Parent dialogue is used to select the parent dialogue and notebook
for which a notebook page is to be modeled after.


ΓòÉΓòÉΓòÉ 816. Help for Standard Menu's ΓòÉΓòÉΓòÉ

The Standard Menu's dialogue is used to select from CUA standard menu
definitions.  You can select any or all of the items suggested.


ΓòÉΓòÉΓòÉ 817. Help for PMCX/Temporary Control Selection Dialogue ΓòÉΓòÉΓòÉ

The PMCX/Temporary Control Selection dialogue is used to select PMCX controls
that you have added or to select a user defined class.


ΓòÉΓòÉΓòÉ 818. Help for New Design ΓòÉΓòÉΓòÉ

The New Design dialogue is used to start a new design that may consist of
windows, menus, dialogues, bitmaps, icons, pointers or other such resources.


ΓòÉΓòÉΓòÉ 819. Help for Styles ΓòÉΓòÉΓòÉ

The styles dialogue allows you to set the text, ID symbol/value, options, and
various styles for a control you have selected.  Depending on your target
operating system environment, you will be able to set options for the
bidirectional and pen support.

The first tab, Styles, allows you set the various styles, text, ID symbol/value
and options options for the control.  This tab will differ from one control to
another unless the control is part of a family of controls (such as buttons and
statics) and you are using the Expert mode of the Prominare Designer.

The second tab, Font & colors, is used to set the font and colors for the
control.

The third tab, Bidi, will only be available when you have targeted Warp.  This
tab allows you to set the bidirectional options for the control.

The final tab, Pen, will only be available when you have targeted Warp and only
for entry fields, multiple-line entry fields, spin buttons, combination boxes
and handwriting controls.  This tab allows you to set the pen options for the
control.


ΓòÉΓòÉΓòÉ 820. Help for Window/Dialogue Styles ΓòÉΓòÉΓòÉ

The Dialogue/Window Styles dialogue allows you to set the text, ID
symbol/value, options, and various styles for a dialogue, notebook page or
window you have selected or are creating.  Depending on your target operating
system environment, you will be able to set options for the bidirectional
support.

The first tab, Styles, allows you set the various styles, text, ID symbol/value
and options options for the dialogue, notebook page or window.

The second tab, Distribution, allows you select the resource script or binary
file where the dialogue or window information should be recorded.

The third tab, Notes, allows you enter and/or view design notes for the
dialogue, notebook page or window.

The fourth tab, Font & colors, is used to set the font and colors for the
dialogue, notebook page or window.

The last tab, Bidi, will only be available when you have targeted Warp.  This
tab allows you to set the bidirectional options for the window or dialogue.


ΓòÉΓòÉΓòÉ 821. Help for Base Tab ΓòÉΓòÉΓòÉ

The Base tab is used to enter the basename for the design and the include
header filename.

The basename is used as the name of the design file (.PDF), the resource files
and the header include file.


ΓòÉΓòÉΓòÉ 822. Help for Source Directory Tab ΓòÉΓòÉΓòÉ

The tab is used to enter the location where you have your source code files.
The target operating environment is denoted by the tab text.


ΓòÉΓòÉΓòÉ 823. Help for Other Tab ΓòÉΓòÉΓòÉ

The Other tab is used to enter the name for the .IPF file which will contain
the help information for the application you are designing.  This is used when
you ask for the .IPF to be created when you save your design information.


ΓòÉΓòÉΓòÉ 824. Help for New Design ΓòÉΓòÉΓòÉ

The New Design allows you to enter the design basename and include header
filename.

Below these entry fields, further options are found.  Through the Target OS
selections, you can select your target operating system environment as:

 Option                   Description
 Windows                  Selecting this option causes the design to be
                          oriented around the Microsoft Windows 3.x
                          environment. Resource script file and source code
                          will be based on the Microsoft Windows 3.x APIs.
 Windows NT               Selecting this option causes the design to be
                          oriented around the Microsoft Windows NT environment.
                          Resource script file and source code will be based on
                          the Microsoft Windows NT APIs.
 OS/2 1.x                 Selecting this option causes the design to be
                          oriented around the OS/2 1.x Presentation Manager
                          environment. The resource script file will be based
                          on the OS/2 1.x Presentation Manager.
 OS/2 2.x                 Selecting this option causes the design to be
                          oriented around the OS/2 2.x Presentation Manager
                          environment. The resource script file will be based
                          on the OS/2 2.x Presentation Manager.
 OS/2 3.0                 Selecting this option causes the design to be
                          oriented around the OS/2 Warp 3.0 Presentation
                          Manager environment. The resource script file will be
                          based on the OS/2 Warp Presentation Manager.
 OS/2 4.0                 Selecting this option causes the design to be
                          oriented around the OS/2 Warp 4.0 Presentation
                          Manager environment. The resource script file will be
                          based on the OS/2 Warp Presentation Manager.

 Through the Language/Class library selections, you can select your target
 language/class library:

 Option                   Description
 C                        Selects C as the language used for source code
                          generation.
 C++                      Selects C++ as the language used for source code
                          generation.
 CommonView               Selects CommonView class libraries as the source code
                          generation technique.
 IBM UI Classes Selects IBM User Interface class libraries as the source code
 generation technique.
 Borland OWL              Selects Borland OWL class libraries as the source
                          code generation technique.
 ObjectPM                 Selects ObjectPM class libraries as the source code
                          generation technique.

 This particular dialogue is a simplified version of the Advanced New Design
 dialogue. To set other features such as deletion control, resource output
 type, etc., you can use the Define Design dialogue which is accessed through
 the Define design menu item of the Options menu.


ΓòÉΓòÉΓòÉ 825. Help for Definitions Tab ΓòÉΓòÉΓòÉ

The Definitions tab allows you to enter the design basename, include header
filename, target operating system environment source directories and .IPF
filename.

Through the Resource format selections, you can select your target resource
format as:

 Option                   Description
 .RES                     Selecting this option causes the OS/2 resources to be
                          saved directly to a .RES file instead of to a
                          resource script file (.RC), which must be compiled
                          with the Resource Compiler. The major advantage here
                          is this feature is inherently faster than the
                          resource compiler. It also allows for features
                          specific to resources, such as the control focus
                          feature, to be enabled.
 .RC                      Selecting this option causes the resources to be
                          saved to a resource script file that must be compiled
                          by the Resource Compiler.
 Borland .RC              Selecting this option causes the resources to be
                          saved to a resource script file that must be compiled
                          by the Borland Resource Compiler.

 Through the Rules selections, you can select your source rules:

 Option                   Description
 Use master               When you select this option, all source code is
                          generated using the master rules contained in the
                          directory specified through the Prominare Designer
                          Default Usage dialogue.
 Use project              To use rules for generating source code specific to
                          the project you are creating, select this option. A
                          copy of the master rules is copied into the project
                          subdirectory, allowing you to edit the default source
                          code rules through the Source menu.

 Through the Save selections, you can select your save options:

 Option                   Description
 Include header file      Selecting this option causes Prominare Designer to
                          save the include file (.H) when symbols have been
                          added.
 Source code files        Selecting this option causes Prominare Designer to
                          save source files each time the design file is saved
                          through the File Save or File Save As menus. If no
                          source files exist, they are createdshift op if the
                          existing source files are found, any new design
                          information added to the design file is incorporated
                          into the source files.
 .IPF file                Selecting this option causes Prominare Designer to
                          update .IPF files each time the design file is saved
                          through the File Save or File Save As menus. If no
                          .IPF file exists, one is created. If an existing .IPF
                          file is found, any new design information added to
                          the design file is incorporated into the .IPF file.

 Through the Deletion selections, you can select your delection control
 options:

 Option                   Description
 None                     Prevents advanced deletion control: items deleted or
                          renamed in the design are properly deleted or renamed
                          within the resource script, include header, and .IPF
                          files.
 Don't verify             Enables advanced deletion control: items deleted or
                          renamed are properly deleted or renamed in the design
                          within the resource script, include header, and .IPF
                          files.
 Verify on save           When you save a design, displays a dialogue showing
                          all items that have been deleted or renamed, allowing
                          you to ensure that they are properly deleted within
                          the resource script, include header, and .IPF files.
                          (See Edit Deletion List)

 Through the Target OS selections, you can select your target operating
 environment:

 Option                   Description
 Windows                  Selecting this option causes the design to be
                          oriented around the Microsoft Windows 3.x
                          environment. Resource script file and source code
                          will be based on the Microsoft Windows 3.x APIs.
 Windows NT               Selecting this option causes the design to be
                          oriented around the Microsoft Windows NT environment.
                          Resource script file and source code will be based on
                          the Microsoft Windows NT APIs.
 OS/2 1.x                 Selecting this option causes the design to be
                          oriented around the OS/2 1.x Presentation Manager
                          environment. The resource script file will be based
                          on the OS/2 1.x Presentation Manager.
 OS/2 2.x                 Selecting this option causes the design to be
                          oriented around the OS/2 2.x Presentation Manager
                          environment. The resource script file will be based
                          on the OS/2 2.x Presentation Manager.
 OS/2 3.0                 Selecting this option causes the design to be
                          oriented around the OS/2 Warp 3.0 Presentation
                          Manager environment. The resource script file will be
                          based on the OS/2 Warp Presentation Manager.
 OS/2 4.0                 Selecting this option causes the design to be
                          oriented around the OS/2 Warp 4.0 Presentation
                          Manager environment. The resource script file will be
                          based on the OS/2 Warp Presentation Manager.

 Through the Language/Class library selections, you can select your
 language/class library:

 Option                   Description
 C                        Selects C as the language used for source code
                          generation.
 C++                      Selects C++ as the language used for source code
                          generation.
 CommonView               Selects CommonView class libraries as the source code
                          generation technique.
 IBM UI Classes           Selects IBM User Interface class libraries as the
                          source code generation technique.
 Borland OWL              Selects Borland OWL class libraries as the source
                          code generation technique.
 ObjectPM                 Selects ObjectPM class libraries as the source code
                          generation technique.

 Through the App type selections, you can select your application type:

 Option                   Description
 Presentation Manager     Bases the design on a normal OS/2 Presentation
                          Manager-type application.
 Workplace                Bases the design on a Workplace Shell-type
                          application.
 PMCX control             Bases the design on a PMCX control.
 DLL                      Bases the design on a DLL where not main() function
                          is generated.

 In the Save group, you can also inform Prominare Designer to save both the
 include and .IPF files.

 Deletion of resource script information is controlled through the Deletion
 group.  By selecting the None option, you instruct Prominare Designer to not
 remove any constructs from either the resource script files for items that
 have been deleted from the design.  The Don't verify will cause the deleted
 item constructs to be removed from both the resource script files without any
 verification whereas the Verify on save will cause a list of deletion items to
 be displayed before the resource script files are saved to allow you to
 pre-edit the deletion list thereby allowing you to prevent certain constructs
 from being deleted.


ΓòÉΓòÉΓòÉ 826. Help for Advanced New Design Definitions Tab ΓòÉΓòÉΓòÉ

The Definitions tab allows you to enter the design basename, include header
filename, target operating system environment source directories and .IPF
filename.

Through the Resource format selections, you can select your target resource
format as:

 Option                   Description
 .RES                     Selecting this option causes the OS/2 resources to be
                          saved directly to a .RES file instead of to a
                          resource script file (.RC), which must be compiled
                          with the Resource Compiler. The major advantage here
                          is this feature is inherently faster than the
                          resource compiler. It also allows for features
                          specific to resources, such as the control focus
                          feature, to be enabled.
 .RC                      Selecting this option causes the resources to be
                          saved to a resource script file that must be compiled
                          by the Resource Compiler.
 Borland .RC              Selecting this option causes the resources to be
                          saved to a resource script file that must be compiled
                          by the Borland Resource Compiler.

 Through the Rules selections, you can select your source rules:

 Option                   Description
 Use master               When you select this option, all source code is
                          generated using the master rules contained in the
                          directory specified through the Prominare Designer
                          Default Usage dialogue.
 Use project              To use rules for generating source code specific to
                          the project you are creating, select this option. A
                          copy of the master rules is copied into the project
                          subdirectory, allowing you to edit the default source
                          code rules through the Source menu.

 Through the Save selections, you can select your save options:

 Option                   Description
 Include header file      Selecting this option causes Prominare Designer to
                          save the include file (.H) when symbols have been
                          added.
 Source code files        Selecting this option causes Prominare Designer to
                          save source files each time the design file is saved
                          through the File Save or File Save As menus. If no
                          source files exist, they are createdshift op if the
                          existing source files are found, any new design
                          information added to the design file is incorporated
                          into the source files.
 .IPF file                Selecting this option causes Prominare Designer to
                          update .IPF files each time the design file is saved
                          through the File Save or File Save As menus. If no
                          .IPF file exists, one is created. If an existing .IPF
                          file is found, any new design information added to
                          the design file is incorporated into the .IPF file.

 Through the Deletion selections, you can select your delection control
 options:

 Option                   Description
 None Prevents advanced deletion control: items deleted or renamed in the
 design are properly deleted or renamed within the resource script, include
 header, and .IPF files.
 Don't verify             Enables advanced deletion control: items deleted or
                          renamed are properly deleted or renamed in the design
                          within the resource script, include header, and .IPF
                          files.
 Verify on save           When you save a design, displays a dialogue showing
                          all items that have been deleted or renamed, allowing
                          you to ensure that they are properly deleted within
                          the resource script, include header, and .IPF files.
                          (See Edit Deletion List)

 Through the Target OS selections, you can select your target operating
 environment:

 Option                   Description
 Windows                  Selecting this option causes the design to be
                          oriented around the Microsoft Windows 3.x
                          environment. Resource script file and source code
                          will be based on the Microsoft Windows 3.x APIs.
 Windows NT               Selecting this option causes the design to be
                          oriented around the Microsoft Windows NT environment.
                          Resource script file and source code will be based on
                          the Microsoft Windows NT APIs.
 OS/2 1.x                 Selecting this option causes the design to be
                          oriented around the OS/2 1.x Presentation Manager
                          environment. The resource script file will be based
                          on the OS/2 1.x Presentation Manager.
 OS/2 2.x                 Selecting this option causes the design to be
                          oriented around the OS/2 2.x Presentation Manager
                          environment. The resource script file will be based
                          on the OS/2 2.x Presentation Manager.
 OS/2 3.0                 Selecting this option causes the design to be
                          oriented around the OS/2 Warp 3.0 Presentation
                          Manager environment. The resource script file will be
                          based on the OS/2 Warp Presentation Manager.
 OS/2 4.0                 Selecting this option causes the design to be
                          oriented around the OS/2 Warp 4.0 Presentation
                          Manager environment. The resource script file will be
                          based on the OS/2 Warp Presentation Manager.

 Through the Language/Class library selections, you can select your
 language/class library:

 Option                   Description
 C                        Selects C as the language used for source code
                          generation.
 C++                      Selects C++ as the language used for source code
                          generation.
 CommonView               Selects CommonView class libraries as the source code
                          generation technique.
 IBM UI Classes           Selects IBM User Interface class libraries as the
                          source code generation technique.
 Borland OWL              Selects Borland OWL class libraries as the source
                          code generation technique.
 ObjectPM                 Selects ObjectPM class libraries as the source code
                          generation technique.

 Through the App type selections, you can select your application type:

 Option                   Description
 Presentation Manager     Bases the design on a normal OS/2 Presentation
                          Manager-type application.
 Workplace                Bases the design on a Workplace Shell-type
                          application.
 PMCX control             Bases the design on a PMCX control.
 DLL                      Bases the design on a DLL where not main() function
                          is generated.


ΓòÉΓòÉΓòÉ 827. Help for File Distribution Tab ΓòÉΓòÉΓòÉ

The Distribution tab is used to select the location where .RC or .RES that is
to contain the the window or dialogue or dialogue you are designing is to be
placed.

The tab contains a set of tabs which if you are designing a window will contain
four tab: Window, Menu,Accelerator table and Help tables.

If you are designing a dialogue it will contain two tab: Window and Help
tables.

The current distribution path will be displayed above the list box within the
tabs.  You can change the path by selecting an entry within the list box.

You can instantly define the path or location where the .RC or .RES file is to
be located by simply clicking the mouse pointer on the Definitions... push
button to display the Resource Distribution Definition dialogue.


ΓòÉΓòÉΓòÉ 828. Help for Pen Tab ΓòÉΓòÉΓòÉ

The pen options allows you to set various pen options for controls that support
pen data.  These controls are:

      Entry field
      Multiple-line entry field
      Combo-box
      Spin button
      Handwriting control

 Note:  For the options to be available to you, you must be running Pen for
        OS/2 Version 1.03 or higher.

 You can set options for the following:

      Layouts/Resource
      Options
      Layouts/Resource
      Symbol Sets
      Include/Exclude Regions


ΓòÉΓòÉΓòÉ 829. Help for Font & Colours Tab ΓòÉΓòÉΓòÉ

The Font & Colours tab is used to change the presentation characteristics of
certain controls within the dialogue you are currently designing.

You can select the areas within a dialogue, window, control that can have the
colors set.

You select the area you want to change by selecting the check box.  A set check
box will use the color you have defined whereas a clear check box will use the
default characteristics.

Beside each check box item will be displayed a button showing the current
presentation parameter color selected.  By clicking on the button, the color
table will be displayed.

These area are:

     Foreground
     Background
     Highlight Foreground
     Highlight Background
     Disabled Foreground
     Disabled Background
     Border
     Active color (2.x and Warp only)
     Inactive color (2.x and Warp only)
     Active text foreground (2.x and Warp only)
     Active text background (2.x and Warp only)
     Inactive text foreground (2.x and Warp only)
     Inactive text background (2.x and Warp only)
     Shadow (2.x and Warp only)
     Shadow text
     Shadow hilight foreground
     Shadow hilight background
     Icon text background

 The color table to the right of the check boxes allows you to select the
 presentation color.  A frame will be displayed around the color you have
 selected.

 You can also select the font to use within the control by selecting the font
 from the Fonts list box and the font size from the Size list box.  When you
 select a font or font size, an example of the selected font and size will be
 displayed below the list boxes.


ΓòÉΓòÉΓòÉ 830. Help for Index Tab ΓòÉΓòÉΓòÉ

The Index colors tab contains the index colors that you can select for use the
color of a selected presentation parameter.

The colors will be displayed within a 3 x 6 grid from which you can select the
desired color.  The proper name of the color will be displayed beside this
grid.


ΓòÉΓòÉΓòÉ 831. Help for RGB Tab ΓòÉΓòÉΓòÉ

The RGB colors tab contains three spin buttons in which you can enter the
values that are to be used as the RGB color along with a color circle that can
also be used to select the desired color from.

When you enter a value within one of the spin fields, the cross hair of the
color circle will be moved to the corresponding location of the RGB color.

Conversely, when you move the cross hair of the color circle to the desired
color, the spin fields will be updated to the value of the RGB color selected.


ΓòÉΓòÉΓòÉ 832. Help for Mouse Pointers ΓòÉΓòÉΓòÉ

The following mouse pointers are used within Prominare Designer:

      General
           Duplicate mode active selection pointer

           Arrange controls/menu insertion location pointer

           Duplicate mode active move control pointer

           Move control pointer

           Select focus control invalid selection pointer

           Select parent window pointer

           Select focus control selection pointer

           Select mouse relative position pointer

      Creation
      The red cross hair is the location where control will be created.
           Bitmap

           Check box

           Circular slider

           Combination box

           Container

           Entry field

           Frame/rectangle

           Graphical button

           Group box

           Handwriting

           Horizontal scroll bar

           Icon

           List box

           Multiple-line entry field

           Notebook

           Push button

           Radio button

           Sketch

           Slider

           Spin button

           Static text

           System icon

           User defined or PMCX control

           User button

           Vertical scroll bar

           Value set

           Child window

      Move
           Bitmap

           Check box

           Circular slider

           Combination box

           Container

           Entry field

           Frame/rectangle

           Graphical button

           Group box

           Handwriting

           Horizontal scroll bar

           Icon

           List box

           Multiple-line entry field

           Notebook

           Push button

           Radio button

           Sketch

           Slider

           Spin button

           Static text

           System icon

           User defined or PMCX control

           User button

           Value set

           Vertical scroll bar

           Child window


ΓòÉΓòÉΓòÉ 833. Help for Error Messages ΓòÉΓòÉΓòÉ

A problem occurred trying to decode the resource information. 'filename' may
not be a valid OS/2 resource file.

      While importing a resource file for a specified OS/2 resource, a problem
      occurred when decoding the information. Make sure that the file you
      specified is a true OS/2 binary resource file.

 A problem occurred trying to decode the resource information. 'filename' may
 not be a valid Windows 3.1 resource file. While importing a resource file for
 a specified Windows 3.1 resource, a problem occurred when decoding the
 information. Make sure that the file you specified is a true Windows 3.1
 binary resource file.

 A problem occurred trying to decode the resource information. 'filename' may
 not be a valid Windows NT resource file.

      While importing a resource file for a specified Windows NT resource, a
      problem occurred when decoding the information. Make sure that the file
      you specified is a true Windows NT binary resource file.

 Accelerator table specified for window but no accelerators defined!

      The window you created specified the association of an accelerator table
      but you have not defined any accelerators. The application will not run
      without a properly defined accelerator table. Either remove the
      accelerator table association in the Window/Dialogue Styles dialogue or
      add an accelerator.

 Action Bar menu must be selected!

      To relate a menu item to its parent, you must select the Action Bar item
      to which the menu item should belong.

 Another control using ID symbol!

      Within the dialogue or window on which you are working, another control
      is using the ID symbol you entered or selected. To ensure proper control
      referencing, each control should have a unique ID symbol/value--unless
      the control is a non-interactive control such as static text, a group
      box, a bitmap, an icon, etc.

 Another control using ID value!

      Within the dialogue or window on which you are working, another control
      is using the ID value you entered. To ensure proper control referencing,
      each control should have a unique ID value--unless the control is a
      non-interactive control such as static text, a group box, a bitmap, an
      icon, etc.

 Association name must be entered!

      When defining an association table item, you must provide an association
      name.

 Basename must be entered!

      When creating a new design, you must enter the basename under which the
      design will be known.

 Cannot find :euserdoc. within IPF file.

      During the scanning phase of the IPF file save, the :euserdoc. tag could
      not be found. This tag is used to mark the end of the IPF file and is the
      location where missing help panels are placed. Since the tag is missing,
      the writing of the missing panel information will not be performed
      because the file may be corrupted.

 Cannot find notebook page parent 'id'. Converting to normal dialogue.

      Because the notebook page parent could not be found, the notebook page
      could not be sized properly. Since the parent is missing, the notebook
      page is automatically converted to a dialogue without any control
      information being lost.

 Cannot load required Prominare Designer DLL 'filename.DLL! Exiting Prominare
 Designer.

      A dynamic link library (DLL) required by Prominare Designer could not be
      opened. Locate the required DLL on the distribution diskettes or CD-ROM
      and copy the DLL to the directory containing your other DLLs.

 Cannot merge old format file!

      Open file through File Open and then save it before trying merge. An
      older version design has been detected as the merge file. The merge
      routines can only merge current design versions with the file you are
      working on. As a solution, open the file you wish to merge and then save
      it back to disk. The file conversion routines will then have saved the
      information in a newer format compatible to the design you are working
      on.

 Classname must be entered!

      You must enter the classname for the user-defined temporary control you
      are creating. Since these controls are not part of OS/2 Presentation
      Manager, the name must be registered, like that of a window, if the
      control is to be created properly.

 Could not create .DFM file.

      An error occurred in trying to save the .DFM file. Make sure that there
      is enough room on your disk to save the information.

 Could not create popup menu window!

      An error occurred in trying to create the popup menu window. Make sure
      that you are not running too many applications that require a great
      number of PM resources.

 Could Not Find Block End in 'filename'!

      While analyzing the existing file to determine any differences between
      the information contained in memory and that in the file, Prominare
      Designer determined that the file contained an unbalanced set of braces
      ({ }) or BEGIN / END statements. Because of this imbalance, Prominare
      Designer will not attempt to generate any further resource script
      statements.

 Could not load popup menu template!

      An error occurred in trying to load the popup menu template from one of
      the Prominare Designer resource DLLs. Make sure that the LIBPATH variable
      contains the path to the DLLs of Prominare Designer..

 Could not open dialogue font metrics file: 'filename'

      The selected .DFM file could not be opened.  Check to make sure that it
      is present and that it is not a sharing violation.

 CUA Non-Compliance: Action Bar text is not a single word!

      IBM CUA states that action bar items should be a single word. Click on
      the Cancel button to return to the dialogue where you are defining the
      action bar item. If you select the OK button, the definition you entered
      will be used.

 CUA Non-Compliance: First letter non-capital in 'control' text!

      IBM CUA states that controls should begin with a capitalized word. Click
      on the Cancel button to return to the dialogue where you are defining the
      control. If you select the OK push button, the definition you entered
      will be used. The control can be Button, Group Box, Static Text, Action
      Bar, or Sub-Menu.

 CUA Non-Compliance: Menu starts with numeric in 'control' text!

      IBM CUA states that menu items should begin with a capitalized word and
      not a numeric value. Click on the Cancel button to return to the dialogue
      where you are defining the menu item. If you select the OK push button,
      the definition you entered will be used. The control can be Action Bar or
      Sub-Menu.

 CUA Non-Compliance: Missing Mnemonic in 'control'!

      IBM CUA states that interactive controls should have a selection
      mnemonic. Click on the Cancel button to return to the dialogue where you
      are defining the control. If you select the OK push button, the
      definition you entered will be used. The control can be Push Button,
      Button, Action Bar, or Sub-Menu.

 CUA Non-Compliance: Missing System Menu with Title Bar!

      IBM CUA states that dialogues containing a title bar should also have a
      system menu. Click on the Cancel button to return to the dialogue where
      you are defining the dialogue. If you select the OK push button, the
      definition you entered will be used.

 CUA Non-Compliance: No 'Text' provided in 'control'!

      IBM CUA states that interactive controls should have a text description
      and not appear blank. Click on the Cancel button to return to the
      dialogue where you are defining the action bar item. If you select the OK
      push button, the definition you entered will be used. The control can be:
      Push Button, Button, Action Bar or Sub-Menu.

 CUA Non-Compliance: Second word starts with capital in 'control' text!

      IBM CUA states that only the first word of a control should be
      capitalized unless it is a proper noun. Click on the Cancel button to
      return to the dialogue where you are defining the control. If you select
      the OK push button, the definition you entered will be used. The control
      can be: Button, Group Box, Static Text, Action Bar or Sub-Menu.

 CUA Non-Compliance: Space between Push Button text and ellipsis (...)!

      IBM CUA states that push buttons that invoke another dialogue should use
      the ellipsis (...) denotation and that no space appear between the push
      button text and the ellipsis. Click on the Cancel button to return to the
      dialogue where you are defining the push button. If you select the OK
      push button, the definition you entered will be used.

 Description must be completed.

      To allow compatibility with the design library, the description of the
      window or dialogue being created or edited must be entered. Since the
      design library allows similar IDs to be used for a designed window or
      dialogue, the description is used to select the desired window or
      dialogue.

 Design file requested is for a later version of Prominare Designer!

      This version of Prominare Designer is not compatible with the design file
      and cannot read it! You have attempted to read a newer version design
      file into Prominare Designer. Use the correct version of Prominare
      Designer to edit the design file.

 Duplicate description entered!

      The description you have entered for the window or dialogue has already
      been entered for another window or dialogue. Enter a unique description.

 Duplicate filename entered!!

      The filename you have entered for the window or dialogue has already been
      entered for another window or dialogue. Enter a different filename.

 Dynamic-Link Library not found!

      When entering or editing the name of a custom control library, make sure
      that the correct path and filename are being used. You cannot register
      the control library with Prominare Designer if it cannot find the actual
      DLL.

 Edit information limit reached!! Save design to reset list.

      The internal limit for deletion edit information has been reached. The
      list is 8,128 items in size. Saving the current design information clears
      the list for reuse.

 Error saving design file 'filename'. File has been saved as temporary file
 'tempfile'.

      An error was detected while saving the current design file. The original
      design file is still intactshift op the new design information has been
      saved to the temporary file denoted in the message. If this error is
      consistent, you may be requested to submit the file to your technical
      service representative.

 Example control creation failed!!!

      The example control could not be created for some reason. If the control
      is part of a PMCX library that you have constructed, make sure that the
      control is operating properly.

 Example too large to show!

      This message appears when you are trying to display a control default.
      The default value for the control size is too large to display in the
      example area. Prominare Designer will fit the control to the example
      area, allowing you to view it, but will use the actual defined default
      size for the control when you add it a window or dialogue.

 'filename.DLL' could not be loaded.

      The PMCX dynamic link library you have selected was not found, or it was
      corrupt. Make sure that the correct path for the custom control was
      entered in the Prominare Designer Default Usage dialogue.

 filename not saved completely since number of bytes to write does not equal
 that written!!

      An error was detected while saving the design file. The number of bytes
      supposed to be written out does not equal the number of bytes that the
      file system has reported writing out. If this problem is consistent, you
      may want to submit the problem design file and the circumstances to your
      service representative.

 'filename' not saved completely since number of bytes to write does not equal
 that written!!

      During the write of a file, it was determined that the amount of data
      that was to be written to disk did not equal the actual amount written.
      There may be a problem in writting to the disk. You may want to try
      saving the file to a different drive if possible.

 'filename' is read only! Cannot save the design.

      You have attempted to save a design file that is marked read-only. Change
      the read-only status of the file before trying to save a subsequent time.
      Alternately, save the file under a different name.

 'filename' not saved completely since 'Drive x:' is full!!

      An error was detected while writing out the design file. A check by the
      file save routines has determined that there may not be enough room
      remaining on the drive where the file was to be saved. If this is the
      case, try freeing up some space on the drive, or save the design file to
      another drive.

 'function' function not found in 'filename' DLL.

      The function within the PMCX dynamic-link library that you have selected
      was not found. If you have created the PMCX library yourself, make sure
      that the function was exported through the definitions file. If the
      function is from a vendor, contact the vendor directly to report the
      problem.

 Filename must be entered.

      You must specify a filename for the resource you are defining.

 Header file name not specified. Cannot create or update .IPF file.

      To be able to create and update .IPF files, a header file must be
      included in the design.

 Help Sub-Table must be selected!

      For the help sub-table item that you are defining to be correctly
      referenced, you must reference it to a defined help sub-table. Help
      sub-table item items belong to a help sub-table.

 Help Table must be selected!

      To correctly define the help table item that you are defining so it can
      be correctly referenced, you must reference a defined help table. Help
      table item items belong to a help table.

 ID value cannot be zero!

      The ID value for a window, control, and/or dialogue must be in the range
      of 1 to 65,535 or 0x0001 to 0xffff.

 ID value not given!

      You cannot create a control without an ID value. OS/2 Presentation
      Manager uses the control ID to internally identify each of the controls
      within a window or dialogue. Use the symbol ID to aid you in describing
      the actual control, both in the resource script and source files.

 Include symbol limit reached.

      Cannot add new include symbol The total number of include symbols
      (including the pre-defined OS/2 symbols used within Prominare Designer)
      is 10,240.

 Internal Error: PD1010 : NULL String

      An internal error has been detected within Prominare Designer.. This is
      the result of a string being recorded and the string pointer for the
      string somehow ending up as a NULL pointer. Please save the resulting
      temporary file and report the error to your technical service
      representative.

 Invalid ID symbol!

      The ID symbol that you have entered contains an invalid character. The
      only valid characters accepted for the ID symbol are:
      a - z A - Z 0 - 9 _
      The symbol cannot begin with a number and cannot contain any spaces.

 Invalid path and/or filename entered!

      An invalid path or filename has been entered. Check to make sure that the
      path exists and that the filename does not contain invalid characters.

 Memory Device Context could not be opened.

      A memory device context required for a bitmap or printing operation could
      not be opened. If the error is consistent, please report it to your
      technical service representative.

 Memory Presentation Space could not be created.

      A memory presentation space required for a bitmap or printing operation
      could not be opened. If the error is consistent, please report it to your
      technical service representative.

 Missing icon for parent window 'id'!

      Ensure that icon symbol is the same as parent window symbol. When
      analyzing the design information for a window, Prominare Designer did not
      find the associated icon definition. Add the icon definition using the
      Icon... item in the Resource menu.

 No item selected!

      You will receive this message if you try to associate an ID without
      actually selecting an ID from the list box.

 No memory available!

      When trying to add or create a new design item, Prominare Designer ran
      out of memory.

 No more controls available!

      When trying to add or create a new design item, Prominare Designer ran
      out of internal index storage space. Try reducing the number of items
      within the window or dialogue.

 No more windows, dialogue or popup menu holders available!

      When you receive this error, you have reached the internal limits of
      Prominare Designer. A simple solution is to break the design file into
      smaller pieces.

 Not an OS/2 2.x Linear Executable (LX) format file.

      An attempt to extract resources has occurred from what looked like a
      linear executable format fileshift op in fact, it has been determined
      that the file is not an OS/2 2.x linear executable format file. Make sure
      that the file has not been corrupted.

 Not an OS/2 or Windows 3.x New Executable (NE) format file.

      An attempt to extract resources has occurred from what looked like an
      OS/2 1.x or Windows 3.x executable format fileshift op in fact, it has
      been determined that the file is not an OS/2 2.x (or Warp) or Windows 3.x
      executable format file. Make sure that the file has not been corrupted.

 Notebook page notebook linkage not selected!

      When defining a notebook page, you need to specify the parent notebook
      and dialogue or windowshift op otherwise the notebook page cannot be
      properly sized to the parent notebook.

 Notebook page parent dialogue linkage not selected!

      When defining a notebook page, you need to specify the parent notebook
      and dialogue or windowshift op otherwise the notebook page cannot be
      properly sized to the parent notebook.

 Parent menu must be selected!

      When adding a new sub-menu, you must select the parent menu to which the
      sub-menu belongs. Sub-menus cannot appear on their own.

 Parent window already defined!

      You are trying to create a second parent window for the applicationshift
      op OS/2 Presentation Manager allows only one parent window for an
      application.

 Parent window cannot be a descendent of Main window.

      You cannot have the parent window as a descendent of the main window of
      your design.  The parent window should be a descendent of either an
      object window or the desktop.

 Printer Device Context could not be opened.

      A printer device context required for a printing operation could not be
      opened. If this error is consistent, please report it to your technical
      service representative.

 Printer Presentation Space could not be created.

      A printer presentation space required for a printing operation could not
      be opened. If this error is consistent, please report it to your
      technical service representative.

 Prominare Designer Help could not be loaded!

      The help for Prominare Designer could not be found. Make sure that the
      help file is within a path defined in the HELP environment variable.
      Alternately, place the help file in the same directory that contains
      DESIGNER.EXE.

 Resource script filename not defined!!

      When saving the resources to either a .RC file and no filenames are
      defined, you will receive this message and the resources will not have
      been saved.  You will need to select the Options Resources distribution
      menu item to define the final resource files.

 There are no distribution files defined!!

      Use Options Resources distribution to define target resource files and
      distribution paths. When saving the resources to either a .RC or .RES
      file and no filenames are defined, you will receive this message and the
      resources will not have been saved.  You will need to select the Options
      Resources distribution menu item to define the final resource files.

 Unable to create test dialogue.

      The test dialogue to be created could not be created. If this problem is
      consistent, please inform your technical service representative.

 Prominare Designer Help could not be loaded!

      The help for Prominare Designer could not be found. Make sure that the
      help file is within a path defined in the HELP environment variable.
      Alternately, place the help file in the same directory that contains
      DESIGNER.EXE.


ΓòÉΓòÉΓòÉ 834. Help for Query messages ΓòÉΓòÉΓòÉ

'filename.PDF already exists! Replace?

      You will receive this message when you try to save a new design and a
      design file already exists with the name you have given the current file.
      You can either click on the Yes button to replace the existing file with
      the new design or click on the No button to cancel the save operation.

 Accelerator already defined using different values! Replace?

      You will receive this message when you have used an accelerator in the
      menu item text and the accelerator designation entered is already being
      used. You can replace the existing accelerator with the current one by
      clicking on the Yes button. To cancel the addition of the accelerator to
      the accelerator table, click No.

 Correlate include file with ID's?

      When you are importing a resource file (.RES) and you have already loaded
      an include header file, Prominare Designer will ask if you want it to try
      to resolve the IDs in the resource file to the IDs in the include header
      file. If you select Yes, Prominare Designer will try to match included
      symbols to the IDs. There may be situations where different symbols have
      the same valueshift op Prominare Designer will use the first one
      encountered in the include file for the symbol in the resource
      translation.

 Create default bitmap?

      The filename specified for the bitmap was not foundshift op here you are
      asked if you wish to create a default bitmap for the filename specified.
      Selecting Yes will create a default bitmap that you can later edit to
      suit the final needs of the bitmap.

 Create default icon?

      The filename specified for the icon was not foundshift op here you are
      asked if you wish to create a default icon for the filename specified.
      Selecting Yes will create a default icon that you can later edit to suit
      the final needs of the icon.

 Create default pointer?

      The filename specified for the pointer was not foundshift op here you are
      asked if you wish to create a default pointer for the filename specified.
      Selecting Yes will create a default pointer to be created that you can
      later edit to suit the final needs of the pointer.

 Delete dialogue?

      When you select the Edit Delete Dialogue menu item, Prominare Designer
      will prompt you with this verification message before it actually deletes
      the dialogue. All controls that belong to the dialogue, including any
      resources, will be deleted if you select Yes..

 Delete window?

      When you select the Edit Delete Window menu item, Prominare Designer will
      prompt you with this message for verification before it actually deletes
      the window. All controls that belong to the window, including any menus,
      accelerators, and help tables will be deleted if you select Yes.

 Delete child window controls?

      When deleting a child window, you will be asked if the controls that are
      owned by the child window are to be deleted. If you want to check the
      controls, select Noshift op they will be deleted if you select Yes..

 Do you want a new include (.H) file as well?

      When you select the File New design... menu item and an include header
      file is already open, Prominare Designer will ask if you want to start a
      new one to go along with the new design file. Select Yes to discard the
      current include header file or No to keep the one in memory.

 Help Sub-table already exists. Replace?

      If Prominare Designer determines that a help sub-table already exists for
      the dialogue or window for which you want to build a table, you will
      first be prompted to replace it. If you click on the Yes button,
      Prominare Designer will discard the previous version of the help
      sub-table and build a new one that you can edit. Selecting No cancels the
      help sub-table build request.

 Help Table already exists. Replace?

      If Prominare Designer determines that a help table already exists for the
      dialogue or window for which you want to build a table, you will first be
      prompted to replace it If you click on the Yes button, Prominare Designer
      will discard the previous version of the help table and build a new one
      that you can edit. Selecting No cancels the help table build request.

 Merge header file?

      When merging a design file from disk with the current design file, if the
      header files are different you will be asked if you want to merge the
      headers. Clicking on the Yes button will merge the headers.

 New display type entered, add?

      When defining a new .DFM file for use within Prominare Designer, if the
      display type is not defined within the list you will be asked if
      Prominare Designer should add the display type you have defined to the
      list.

 No include file opened yet for import correlation, open one now?

      If you have clicked on the Yes button for the correlation message and
      Prominare Designer determines that no header file has yet been read in,
      you will be given an opportunity to read in the include file before the
      resources are imported.

 Replace existing dialogue?

      If you have a dialogue displayed and select Paste in the Edit menu,
      Prominare Designer will ask if you want to replace the displayed dialogue
      with the one from the clipboard. Click on the Yes button to replace the
      dialogue or window contained in the clipboard with the displayed
      dialogue. Selecting No will cause the current dialogue to be saved in
      memory before the dialogue or window from the clipboard is pasted into
      the current design file and displayed.

 Replace existing file: 'filename'?

      You will receive this message when you are saving a window or dialogue to
      the pre-design library and a file using the same name already exists in
      the library. You can replace the existing file with the new one by
      clicking on the Yes push button. If you click No, you will return to the
      dialogueЧwhere you can enter another name to save the file under.

 Replace existing window?

      If you have a window displayed and you select the Paste item in the Edit
      menu, Prominare Designer will ask if you want to replace the displayed
      dialogue with the one from the clipboard. Click on the Yes button to
      replace the dialogue or window contained in the clipboard with the
      displayed dialogue. Select No to cause the current window to be saved in
      memory before the dialogue or window from the clipboard is pasted into
      the current design file and displayed.

 Save current file: 'filename'?

      You will see this question when you exit Prominare Designer, open a
      design file, or start a new file, if the current design file has not been
      saved. Click on the Yes button to save the current design file to disk.
      Select No to discard any changes made to the design file. Click on the
      Cancel button to cancel the initial request.

 Save include file: 'filename'?

      You will see this question whenever you exit Prominare Designer, open a
      design file, start a new one, or save the current design file, if the
      current include header file has not been saved. Click on the Yes button
      to save the current design file to disk. Select No to discard any changes
      made to the include header file. Click on the Cancel button to cancel the
      initial request.  Time stamp of design does not match original time
      stamp!

 Replace file?

      When you are saving a design file and Prominare Designer determines that
      the date and time stamp of the design file does not match that of the
      file on disk, you will be asked to verify the saving of the file over the
      file on disk. Selecting the Yes push button will cause the file on disk
      to be replaced. Selecting No will cancel the save process.


ΓòÉΓòÉΓòÉ 835. Informational Messages ΓòÉΓòÉΓòÉ

Design errors encountered. Display Error List?

      During scanning of the design information, it has been found that
      duplicate IDs exist or that specified files are missing. Clicking on the
      Yes button will display the Design Errors dialogue. You will then be able
      to correct the errors listed within the dialogue.

 'filename' not found, open new header file?

      The header file saved within the design could not be opened.  If   you
      click on the Yes push button, you will be able to select a   different
      header file to use.  If you click on the No push button,   the header
      file will be reconstructed using the information   contained within the
      design file.

 If minimized dialogue becomes hidden, press Esc key to cause dialogue to close
 or click the mouse on the Test toolbar button to exit test mode.

      When your dialogue has a minimize button and you enter Test mode within
      Prominare Designer, you will be warned regarding the appearance   that
      the dialogue has disappeared and how you can continue.

 If minimized window becomes hidden, press Esc key to cause window to close or
 click the mouse on the Test toolbar button to exit test mode.

      When your window has a minimize button and you enter Test mode within
      Prominare Designer, you will be warned regarding the appearance   that
      the window has disappeared and how you can continue.

 Include path different from default.  Update?

      When importing a .RC file and you have changed the include path,   you
      can have this new include path saved for the next time you   import a .RC
      file.  Clicking on the Yes push button will cause   the include path to
      be saved.

 No bitmap defined for bitmap item, do you want to add one now?

      When adding a static bitmap to a window or dialogue, or were   defining a
      bitmap for a push button control and the   ID of the bitmap is not
      matched against any bitmap resources   you have defined, Prominare
      Designer will ask you if   you want to create a new bitmap for this
      bitmap item.   Clicking on the Yes push button will cause Bitmap, Font,
      Icon   and Pointer Resources dialogue to be displayed.

 No design errors encountered.

      During scanning of the design information, no design errors were
      encountered.

 No icon defined for the icon item, do you want to add one now?

      When adding a static icon to a window or dialogue, or were   defining an
      icon for a push button control and the   ID of the icon is not matched
      against any bitmap resources   you have defined, Prominare Designer will
      ask you if   you want to create a new icon for this icon item.   Clicking
      on the Yes push button will cause Bitmap, Font, Icon   and Pointer
      Resources dialogue to be displayed.

 No icon defined for the window, do you want to add one now?

      When adding a minimized button to a window  and the   ID of the bitmap is
      not matched against any icon resources   you have defined, Prominare
      Designer will ask you if   you want to create a new icon for this window.
      Clicking on the Yes push button will cause Bitmap, Font, Icon   and
      Pointer Resources dialogue to be displayed.

 No Interactive Controls Found. Help Sub-Table Was Not Created!

      You will receive this message if you direct Prominare Designer to build a
      help sub-table and it cannot find interactive controls such as buttons,
      entry fields, list boxes, combination boxes, multi-line entry fields, or
      menus. If you want help for a window or dialogue without any interactive
      controls, use the Resource Help Sub-Table menu item to create an empty
      table.

 No menu's exist!  Select from standard menu's?

      When first creating your menu's, Prominare Designer   will ask you if you
      want to create your menu's from a set   of standard menu's.  Clicking the
      mouse pointer on the Yes   push button will cause the Standard Menu's
      dialogue to be   displayed from which you can select items to include as
      the starting point of your menu.

 No more windows or dialogue to search.

      When searching and the all windows and dialogues have been searched for
      a specified text string or ID, this message will inform you that the
      search is complete.

 No Sub-Tables Found. Help Table Was Not Created!

      You will receive this message if you direct Prominare Designer to build a
      help table and it cannot find any help sub-tables. You should build the
      help sub-tables before building the help table.

 Printing Active: Cancel Print?

      If you are exiting Prominare Designer and it is   still printing a
      design, you will be questioned as to   whether or not the printing should
      be canceled.  Clicking   on the Yes push button will cause the printing
      to be   aborted and Prominare Designer will close.  Clicking   on the No
      push button will cause the printing to continue and   the exit request
      will be ignored.

 Single '\\' detected in position %d within control text! Ignore?

      If you have placed a single \ within the text of a control,   Prominare
      Designer will ask you if this was truly what   you intended.  If you are
      saving directly to a binary resource   file (.RES) or to an object file
      (.OBJ), this is not generally   a problem.  But, if you are saving to a
      .RC file, the \ may be   interpreted by the resource compiler as the
      start of an escape   sequence.  If you click the mouse pointer on the Yes
      push button,   the single slash will be left alone.  Clicking on the No
      push button will prevent you from exiting the styles dialogue.

 String not found.

      The string for which you were searching was not found within any of the
      windows or dialogues.

 Symbol entered could not be found within any of the windows or dialogue
 designs!

      The symbol for which you were searching was not found within any of the
      windows or dialogues.

 Symbol found in Action bar!

      The symbol for which you were searching was found within the action bar
      of the window being displayed.

 Symbol found in Help sub-table item!

      The symbol for which you were searching was found within the help
      sub-table item of the window or dialogue being displayed.

 Symbol found in Help sub-table!

      The symbol for which you were searching for was found within the help
      sub-table of the window or dialogue being displayed.

 Symbol found in Help table item!

      The symbol for which you were searching was found within the help table
      item of the window or dialogue being displayed.

 Symbol found in Help table!

      The symbol for which you were searching was found within the help table
      of the window or dialogue being displayed.

 Symbol found in Pop-up menu item!

      The symbol for which you were searching was found within the pop-up menu
      being displayed.

 Symbol found in Sub-menu item!

      The symbol for which you were searching was found within the sub-menu
      item of the window being displayed.

 Symbol found in accelerator table definition!

      The symbol for which you were searching was found within accelerator
      table of the window being displayed.

 Symbol found in association table resource!

      The symbol for which you were searching was found within action bar of
      the window being displayed.

 Symbol found in bitmap resource!

      The symbol for which you were searching was found within the association
      table.

 Symbol found in character table resource!

      The symbol for which you were searching was found within character table
      resource.

 Symbol found in custom resource!

      The symbol for which you were searching was found within the custom
      resources.

 Symbol found in default icon resource!

      The symbol for which you were searching was found as the default icon.

 Symbol found in font directory resource!

      The symbol for which you were searching was found within the font
      directory.

 Symbol found in font resource!

      The symbol that you were searching for was found within font resources.

 Symbol found in icon resource!

      The symbol for which you were searching was found within icon resources.

 Symbol found in key table resource!

      The symbol for which you were searching was found within key table
      resources.

 Symbol found in message table resource!

      The symbol for which you were searching was found within message table
      resources.

 Symbol found in pointer resource!

      The symbol for which you were searching was found within pointer
      resources.

 Symbol found in string table resource!

      The symbol for which you were searching was found within string table
      resources.

 Symbol found in virtual key table resource!

      The symbol for which you were searching was found within virtual key
      table resources.

 Text and symbol entered could not be found within any of the windows or
 dialogue designs!

      The text and symbol for which you were searching was not found within any
      of the windows or dialogues.

 Text entered could not be found within any of the windows or dialogue designs!

      The text for which you were searching was not found within any of the
      windows or dialogues.


ΓòÉΓòÉΓòÉ 836. Script Preprocessor Messages ΓòÉΓòÉΓòÉ

#if / #ifdef stack overflow

      Too many #if or #ifdef directives nesting have been encountered. A
      maximum of 32 nestings can be handled by the preprocessor.

 Cannot create pre-processed output file 'filename'

      The preprocessed output for the script file could not be saved. Make sure
      that you have enough space on your hard drive and that you do not have a
      read-only file of the form filename..PP residing where the preprocessed
      file would be placed.

 Cannot open include file 'filename'

      The include file specified could not be found or opened.

 Expected ) not found

      The expected ) was not found.

 Expecting #endif directive

      The expected #endif directive was not found.

 Identifier too large for parsing buffer

      The identifier is too large for the parsing buffer, which has a limit of
      512 characters.

 Invalid constant found value

      The constant value was deemed to be invalid for the type usage.

 Invalid integer constant expression

      The integer constant expression was deemed invalid.

 Macro buffer overflow

      The macro buffer has overflowed, since the macro expansion is greater
      than 2,040 characters.

 Macro nesting exceeded limit of 256

      You can only have 256 nested macros.

 Missing ) in #if directive

      The expected ) in the #if directive was not found.

 Nested includes exceeded limit of 32

      You can only have up to 32 nested #include directives.

 Too many #else directives

      An unexpected #else directive was found.  Usually, you have an unbalanced
      number of #if and #endif directives.

 Too many #endif directives

      An unexpected #endif directive was found. Usually, in this situation, you
      have an unbalanced number of #if / #ifdef and #endif directives.

 Too many ) in #if directive

      An unexpected ) was found in the #if directive.

 Unequal #if / #ifdef / #elif / #else / #endif directives

      A mismatch in the number of #if / #ifdef / #elif / #else / #endif
      directives was detected.

 Unequal ()

      The number of ( ) was found not to be equal.

 Unexpected end of file 'filename'

      The end of file was detected and was not yet expected.

 Unknown 'identifier' directive

      The identifier is not a valid directive.


ΓòÉΓòÉΓòÉ 837. Help for Script Import Filter Messages ΓòÉΓòÉΓòÉ

Accelerator type required: (CHAR SCANCODE or VIRTUALKEY)

      The expected accelerator type of CHAR, SCANCODE, or VIRTUALKEY was not
      found within the statement.

 BEGIN expected in Accelerator Table

      A BEGIN was expected at the start of the accelerator table.

 BEGIN expected in Association Table

      A BEGIN was expected at the start of the association table.

 BEGIN expected in Help Table - 'ID'

      A BEGIN was expected at the start of the help table.

 BEGIN expected in Help sub-table - 'ID'

      A BEGIN was expected at the start of the help sub-table.

 BEGIN expected in Message Table

      A BEGIN was expected at the start of the message table.

 BEGIN expected in RCDATA

      A BEGIN was expected at the start of the RCDATA.

 BEGIN expected in String Table

      A BEGIN was expected at the start of the string table.

 BEGIN expected in dialogue or window template

      A BEGIN was expected at the start of the dialogue or window template.

 BEGIN expected in dialogue template

      A BEGIN was expected at the start of the dialogue template.

 BEGIN expected in menu - 'ID'

      A BEGIN was expected at the start of the menu.

 BEGIN expected in VERSIONINFO

      A BEGIN was expected at the start of the VERSIONINFO

 CTLDATA not allowed on MENUITEM

      You cannot use CTLDATA statements with menu items.

 Codepage value must be numeric: symbol

      The code page specified was not a numeric value.

 Codepage value not in legal range

      The codepage specified was not a valid codepage for the type of script
      being imported.

 Comma expected after item string - 'item'

      A comma was expected after the item.

 Conflicting or redundant memory or load options

      A set of memory or load flags specified are contradictory.

 Control Character out of range [^A - ^Z]

      The accelerator character is not within the range of A through Z.

 END expected in Dialogue - 'ID'

      The END statement was expected for the end of the dialogue template
      definition.

 END expected in menu - 'ID'

      The END statement was expected for the end of the menu definition.

 Expected '('

      An expected ( was not found.

 Expected ')'

      An expected ) was not found.

 Expected Comma following Application name

      A comma was expected after the application name within the association
      table statement.

 Expected Comma following file extension

      A comma was expected after the file extension within the association
      table statement.

 Expected HELPITEM in help table - 'ID'

      The expected HELPITEM statement within the help table was not found.

 Expected ID value for MENUITEM - 'ID at line number x'

      The expected ID value for the menu item was not found.

 Expected Menu String - 'text'

      The expected text string was not found within the menu statement.

 Expected Numerical Dialogue constant: 'symbol'

      The expected constant was not found.

 Expected String in message table

      The expected string was not found in the message table.

 Expected String in string table

      The expected string was not found in the string table.

 Expected application name in Association Table

      The expected application name in the association table was not found.

 Expected comma in Accelerator Table

      The expected comma was not found within the accelerator table.

 Expected file extension in Association Table

      The expected file extension in the association table was not found.

 Expected help sub-item in help sub-table - 'symbol'

      The expected help sub-item was not found.

 Expected numeric SUBITEMSIZE in help sub-table - 'symbol'

      The expected numeric value associated with the SUBITEMSIZE was not found.

 Expected numeric command value

      The expected numeric command value was not found.

 Expected numeric constant in Message Table

      The ID for the message table item was not found.

 Expected numeric constant in String Table

      The ID for the string table item was not found.

 Expected parent window ID in HelpTable - 'symbol'

      The ID for the parent window within the help table was not found.

 Expected string or constant Accelerator command

      The expected command for the accelerator was not found.

 Expecting number for FONT - got 'symbol'

      The expected numeric value for the FONT was not found.

 Expecting number for ID - got 'symbol'

      The expected ID value was not found.

 Expression evaluates to a negative value

      The expression evaluates to a negative value where a negative value is
      not permitted.

 Expression had divide by 0

      Divide by 0 found within the expression.

 File not found: filename

      The specified file was not found.

 FONT Italic flag missing

      The italic flag for the FONT was missing.

 FONT Weight missing

      The weight for the FONT was missing.

 Illegal empty BEGIN/END block found

      An empty BEGIN / END block was found.

 Illegal ordinal value - negative number: 'value'

      The ordinal value must be within the range of 0x0000 and 0xffff.

 Illegal ordinal value: 'value'

      The ordinal value must be within the range of 0x0000 and 0xffff.

 Invalid Accelerator option

      The accelerator option specified was invalid or unknown.

 Invalid Accelerator

      The accelerator being defined is invalid.

 Invalid Dialogue or Window token - 'token'

      The token found is invalid or unknown.

 Invalid control character

      The control character specified is invalid.

 Invalid key value

      The key value specified is invalid.

 Invalid resource type

      The resource type specified is invalid.

 Invalid token - 'token'. Only one top level window allowed

      The token is invalid for the construct used within.

 Language missing!

      The language ID was missing from the LANGUAGE statement.

 MENU name or ID ordinal missing

      The menu string ordinal or numeric ID ordinal were missing.

 Multiple CTLDATA specified - using last specified set

      Only one CTLDATA statement can be used with a control.

 Multiple PRESPARAM specified - using last specified set

      Differing PRESPARAM values specified. You should not redefine a
      presentation parameter within the same control.

 Non-numeric template ID in dialogue or window template

      The ID value for the dialogue or window template must be within the range
      of 0x0000 and 0xffff.

 Presentation Parameters must follow BEGIN - ignored

      When using presentation parameters within menus, the PRESPARAM statement
      must follow the BEGIN statement.

 Resource Type keyword expected - 'symbol'

      A resource type keyword was expected.

 Resource name/id expected - 'symbol'

      Resource name or ID expected was not found.

 String literal too long must be less than 255 characters

      The string within the message or string table is too long. Strings can
      only be 255 characters in length.

 String not allowed for resource ID 'symbol'

      OS/2 IDs must be a numeric value in the range of 0x0000 through 0xffff.

 Sub-language missing!

      The sub-language ID was missing from the LANGUAGE statement.

 Text string expected in CAPTION - 'symbol'

      The text string expected within the caption was not found.

 Text string expected in CLASS - 'symbol'

      The text string expected within the class statement was not found.

 Text string expected in FONT - 'symbol'

      The text string expected within the font statement was not found.

 Text string or ordinal expected in Control - 'symbol'

      The text string or ordinal value expected within the control statement
      was not found.

 Unbalanced Parentheses

      The ( ) combination are unbalanced.

 Undefined keyword or key name: 'symbol'

      An undefined keyword or name was found.

 Unexpected end of file in string literal

      Unexpected end of file was encountered.

 Unexpected text after SEPARATOR - 'symbol'

      The text encountered within the separator statement was not expected.

 Unexpected value in RCDATA

      The value encountered within the RCDATA was not expected.

 Unknown Menu SubType - 'symbol'

      The menu subtype is invalid.

 Unsupported Resource Type - 'FKALONG'

      FKALONG resource types are not supported. Remove them from the script
      file and re-import.

 Unsupported Resource Type - 'FKASHORT'

      FKASHORT resource types are not supported. Remove them from the script
      file and re-import.

 VERSION ID missing!

      The ID value was missing from the VERSION statement.


ΓòÉΓòÉΓòÉ 838. Help for Common Error Messages ΓòÉΓòÉΓòÉ

'filename' invalid filename! Must be 8.3 format.

      The filename you have entered is not a valid DOS (FAT) file system name.
      If you are using the traditional FAT system, you will not be able to use
      long filenames. Only long filenames can be used when your drive has been
      formatted for the OS/2 High Performance File System (HPFS).

 Access to file 'filename' denied by OS/2 file system.

      The OS/2 file system will not allow access to the file in question.

 Disk Full.

      As the error suggests, the disk that you are saving files to is full. You
      can either try saving to another disk, or remove files from the current
      one.

 Disk write protected.

      If you are saving to a floppy diskette and have forgotten to remove the
      protection tab, or in the case of 3.5" diskettes, placed the slider into
      protect position, you will receive this error. Remove the disk protect
      tab or place the slider in the normal position and try saving again.

 Error: Unexpected OS/2 error x..

      If you receive this error, please report it to technical support.

 Invalid Drive.

      The drive to which you are trying to save does not exist on your system.
      Make sure that you are entering the proper drive designation when giving
      the full path and filename. If you are saving to a known drive (i.e.
      Drive C:), this message may indicate hardware problems.

 Locking violation on file 'filename'.

      This error message means that a Prominare Designer application was trying
      to save the file filename while another application had access to the
      file. Since the Prominare Designer application did not have rights to the
      file, it could not save to it.

 Not an OS/2 or DOS disk.

      The disk to which you are trying to save is not an OS/2- or
      DOS-compatible disk. It is either unformatted or has been formatted for
      another system. Check the drive designation and try saving the file to a
      known OS/2 or DOS disk.

 Read Fault.

      This is generally a hardware error. If it persists, have your system
      checked.

 Sharing violation on 'filename'.

      This error message means that a Prominare Designer application was trying
      to save the file filename while another application had access to the
      file. Since the Prominare Designer application did not have rights to the
      file, it could not save to it.

 Write Fault.

      This is generally a hardware error. If it persists, have your system
      checked.


ΓòÉΓòÉΓòÉ 839. Help for Edit Control ΓòÉΓòÉΓòÉ

The Edit Control is a fully functional control for the editing of text. It
provides many features that are found in traditional editors but at a control
level.

The control is composed of a toolbar, editing window and a status window.

The toolbar of the control consists of the following buttons:

Cut:

Copy:

Paste:

Find:

Find & Replace:

Rectangular selection for copy, cut and paste:

Sort and sort setup:

Swap case:

Swap letter:

Swap word:

Undelete:

Options:

Through the editing window you enter and/or edit the text contained within the
window.  You can use the standard keys to perform the editing like the Delete,
Backspace, Tab and Insert keys.  The arrow cursor keys can be used to move the
insert point or overtype point around within the text.  To the immediate left
of the window is a margin which is used to allow you to select complete lines
of text while pressing the left mouse button.

The status window at the bottom of the control displays the current line and
column positions as well as the last line number.  Additional information
showing the insert or overtype mode, the block of selected text, and the key
states.


ΓòÉΓòÉΓòÉ 840. Help for Symbol Lookup ΓòÉΓòÉΓòÉ

The Symbol Lookup dialogue is used to lookup an ASCII value/symbol and paste it
within the current file at the current cursor location.

The character list box will display the characters in ascending order of value
from ASCII 0 to ASCII 255.

When you select a character within the list box, the character will be
displayed within the Selected group along with the decimal and hexadecimal
values.

You can change the code page of the displayed character set by selecting the
desired code page from the spin button located below the displayed character
information.

To paste the selected character into the source file you are working on, click
the mouse pointer on the Paste push button.


ΓòÉΓòÉΓòÉ 841. Help for Cut ΓòÉΓòÉΓòÉ

The Cut operation is used to cut the selected text from edit control and to
copy it to the clipboard.  The Paste function can then be used to paste the
text into the edit control in another location or into another file.

When using the mouse, you can press Button 2 to cause the context menu to be
displayed which contains a Cut menu item for the cutting of the text to the
clipboard.

Accelerator key:  Shift+Del


ΓòÉΓòÉΓòÉ 842. Help for Copy ΓòÉΓòÉΓòÉ

The Copy operation is used to copy the selected text to the clipboard.  The
Paste operation can then be used to paste the text into the edit control in
another location or into another file.

Accelerator key:  Ctrl+Ins


ΓòÉΓòÉΓòÉ 843. Help for Paste ΓòÉΓòÉΓòÉ

The Paste operation is used to paste text that has been copied to the clipboard
into the file starting a the current line or cursor position.

When using the mouse, you can press Button 2 to cause the context menu to be
displayed which contains a Paste menu item for the pasting of the text from the
clipboard into the edit control at the current location.

Accelerator key:  Shift+Ins


ΓòÉΓòÉΓòÉ 844. Help for Swap Word ΓòÉΓòÉΓòÉ

The Swap Word operation is used to swap two adjoining words starting from the
current cursor location.

Accelerator key:  Shift+F5


ΓòÉΓòÉΓòÉ 845. Help for Swap Letter ΓòÉΓòÉΓòÉ

The Swap Letter operation is used to swap two adjoining characters at the
current cursor location.

Accelerator key:  Shift+F6


ΓòÉΓòÉΓòÉ 846. Help for Swap Case ΓòÉΓòÉΓòÉ

The Swap Case operation is used to swap the current case of the letter where
the cursor is located.  This can be useful when the Caps Lock key has been left
on by mistake.

Accelerator key:  Shift+F7


ΓòÉΓòÉΓòÉ 847. Help for Cut Square ΓòÉΓòÉΓòÉ

Select the toolbar button to switch the selection mode from line mode to
rectangular mode. Line selection mode causes the selection of the text to
follow the text within the selected lines whereas rectangular mode causes the
selection of the text to start from the upper left corner of the selection to
the bottom right thereby creating a rectangular box.

When performing a cut, copy or paste operation, the state of this button
determines how the operation should be performed.  When the button is in the up
position, line mode is used such that the end of each line is interpreted as
the next line should begin in column position one.  Conversely, when the button
is down, when the end of a line is found, the beginning of the next line is
located at the column where the cursor is located.


ΓòÉΓòÉΓòÉ 848. Help for Undelete ΓòÉΓòÉΓòÉ

The Undelete operation is used to undelete text that has been deleted using the
Del key, the F2 Delete Word, Line Delete (F6) function and the Backspace key.
Up to 64 deleted items will be saved.

Accelerator key:  Alt+F2


ΓòÉΓòÉΓòÉ 849. Help for Duplicate Line ΓòÉΓòÉΓòÉ

The Duplicate operation is used to duplicate the line the cursor is currently
on.

Accelerator key:  F7


ΓòÉΓòÉΓòÉ 850. Help for Find Last ΓòÉΓòÉΓòÉ

The Find last operation is used to repeat the last find operation.

Accelerator key:  F9


ΓòÉΓòÉΓòÉ 851. Help for Find ΓòÉΓòÉΓòÉ

The Find dialogue is used to enter or select a string to search for within the
current source file.

A list box will contain a list of strings that you can select from. These
strings will have been previously used.  By selecting a string, you can edit
the string within the edit field and this string will replace the selected one
in the list box.

If you are entering a new string, the string entered will be automatically
placed in the list box for the next time you select the function.

If the string entered is found starting from the current line and cursor
position, the cursor will be placed at the first character of the string.

You can enter up to the number of items you specified through the Options
dialogue.

Options you can selected are Case sensitive. The Case sensitive option when
selected causes the search to only make exact matches in case.  When the option
is not selected, a search of text that matches letters but not case can occur.

Like the number of items to be contained within the lists, you can specify
through the Options dialogue the default Case sensitive option such that the
method you wish to use is always selected.

The direction of the search is governed by the direction options Up and Down.
By default the direction will be from the current location down through the
file towards the last line in the file where the search will end.

A range in which the search operation should be confined is entered through the
two spin buttons within the range group.  The spin button label Start is the
starting line number from which the operation is to begin and the spin button
labeled End is the ending line number that the operation is to end.


ΓòÉΓòÉΓòÉ 852. Help for Find & Replace ΓòÉΓòÉΓòÉ

The Find & Replace dialogue is used to enter or select the text string that is
to be replaced by another text string.

A list box, titled Search List, will contain a list of strings that you can
select from to use as the search string.

A second list box, titled Replace List will contain a list of strings that you
can select from to use as the replacement string.

In both cases, these strings will have been previously used.  By selecting a
string, you can edit the string within the edit field and this string will
replace the selected one in the list box.

If you are entering a new string, the string entered will be automatically
placed in the list box for the next time you select the function.

If the string entered is found starting from the current line and cursor
position, the cursor will be placed at the first character of the string.

You can enter up to the number of items you specified through the Options
dialogue.

Options you can selected are Verify and Case sensitive. The Verify option
causes a replacement verification message to be displayed allowing you to skip
a replacement of text found.  The Case sensitive option when selected causes
the search to only replace exact matches in case.  When the option is not
selected, a replacement of text that matches letters but not case can occur.

Like the number of items to be contained within the lists, you can specify
through the Options dialogue the default Verify and Case sensitive options such
that the method you wish to use is always selected.

The direction of the search is governed by the direction options Up and Down.
By default the direction will be from the current location down through the
file towards the last line in the file where the search will end.

A range in which the search and replace operation should be confined is entered
through the two spin buttons within the range group.  The spin button label
Start is the starting line number from which the operation is to begin and the
spin button labeled End is the ending line number that the operation is to end.


ΓòÉΓòÉΓòÉ 853. Help for Find & Replace Verify ΓòÉΓòÉΓòÉ

The Find & Replace Verify window is used to verify the replacement of text that
was searched for and found.  Clicking on the Yes push button will cause the
highlighted text to be replaced.  Clicking on the No push button will leave the
hightlighted text as is.

The Cancel push button when selected causes the search to stop.

The Replace all push buttom will cause all remaining matches of the search text
to be replaced without any further verification.


ΓòÉΓòÉΓòÉ 854. Help for Edit Options ΓòÉΓòÉΓòÉ

The Edit Options is used to define various editing characteristics for the file
being edited.  These options are:

     Find, Find & Replace item count
     Right margin
     Code page
     Fonts and sizes
     Auto save
     Tab stops
     Case sensitive
     Verify replacement

 By selecting the items check box, you either turn off or on the feature.

 You can specify the number of list items that each of the Find and the Find &
 Replace dialogues can handle through the Find / Replace items area.  Through
 the entry fields labeled Find and Find and replace you enter the number of
 items that are to be retained within the search list from which you can select
 items from.  The default number of items contained in each list is 24 items.

 You can specify the right margin in which each line is governed by through the
 entry field labeled Right margin.  You can enter a value between 25 and 4,096.
 All other values are illegal and will cause the margin to be automatically set
 to its previous value.  The default value for the margin is 120.

 You can specify the code page in which to display the source files through the
 spin button labeled Code page.  Valid code pages are:

 Code Page:          Country:

 437                 US English

 850                 Latin 1 Multilingual

 852                 Latin 2 Multilingual

 857                 Turkey

 860                 Portuguese

 861                 Iceland

 863                 Canadian French

 865                 Norwegian

 932                 Japanese

 1004                Desktop publishing

 The font in which to use within the source files is selected through the drop
 down list labeled Fonts and the size in which to display it in can be selected
 through the Size drop down list. Fonts that you can selected when running
 under OS/2 2.0 are: Courier and System Monospaced.  When running under OS/2
 2.1, an additional font System VIO is available.

 You can specify through the Auto save options the time between auto saving
 when you have selected auto save through the Auto save check box.  The time in
 minutes is specified through the Time between saves entry field.  You can
 cause the prompting of the save by selecting the Prompt on save check box.

 Tabs and the setting of tab positions is performed through the Tabs area.  The
 specification of tab positions is governed by the Running and Fixed increment
 radio buttons.  When you select the Running option, you can specify a set of
 tab positions through the Values entry field.  These positions do not need to
 be of equal increments and you can specify up to 25 different positions.  When
 you select the Fixed increment option, tab positions are calculated based on
 the fixed increment you specify within the Values entry field.  For example,
 if you specify 4 for the fixed increment, the first tab position will be the
 beginning of the line, the next position will be 4 and the position after that
 one will be 8, and so on.

 You can have the Tab key when pressed insert spaces thereby pushing any text
 to the right by selecting the Insert check box.  When this option is not
 selected, the pressing of the Tab key will cause the cursor location to be
 moved to the next tab position.

 The Replace spaces option when selected will compress the file when it is
 saved using the tab compression character (character 9) for spaces when you
 have selected the Running option otherwise it will use the fixed value
 specified.  It uses the standard of tab stops of 8 positions starting at
 position 9.  By default, the Replace spaces option is selected.

 The Case sensitive option is used by the Find functions.  When selected, the
 Find functions are case insensitive.  The default option is case sensitivity.

 The Verify replacement function is used by the Find & Replace function.  When
 verify is selected, each time a matching string is found, you will be prompted
 to verify the replacement of the string.


ΓòÉΓòÉΓòÉ 855. Help for Goto Line ΓòÉΓòÉΓòÉ

The Goto Line dialogue is used to move to a new current line within the file
being edited.

Valid line numbers are 1 through to the last line in the file.


ΓòÉΓòÉΓòÉ 856. Help for Sort Options ΓòÉΓòÉΓòÉ

The Sort Options function is used to define the starting and ending columns
along with the direction the  quic pic button will use.

 The starting column is entered through the entry field labeled Starting column
and the ending column is entered through the entry field labeled Ending column.

The direction of the sort is specified through the options Ascending and
Descending radio buttons.


ΓòÉΓòÉΓòÉ 857. Set Next ID ΓòÉΓòÉΓòÉ

To change the next ID value generated by the Next ID button, enter the new
value within the entry field and click the mouse pointer on the Use button.