Default Creation Options
The Default Creation Options dialog is used to
define the default characteristics for windows or dialogs created
through the New menu item, and for various types
of controls.
The Default push button in each tab is
used to reset the values entered to the IRE defaults. The Show
push button is used to display the selections made within the
example area of the tab. Once you have shown the revised window
or dialog, you can test its operation to see if this what you
want to use as your default. There are Cancel and Save buttons along the bottom of the dialog box.
- 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.
-
- Window/Dialog Tab
- You can select the type of window or
dialog box from the Type list box. If
you select dialog as the type, the relative
position list box becomes active. The include
values list box allows you to choose between
decimal and hexadecimal as the default display for
values.
-
- Styles:
- Title Bar allows for a
title to be included within the window/dialog. Note: The
OS/2 Presentation Manager limits the length of the Title
Bar text to 60 characters.
- System Menu includes a system menu
in the default window or dialog box
- Horz. Scroll Bar includes
a horizontal scroll bar in the bottom of the window or
dialog
- Vert. Scroll Bar includes
a vertical scroll bar in the right of the window or
dialog
- Visible specifies that the window
or dialog box is to be initially visible. Even if this
option is not selected, the IRE will display the window
or dialog box.
- Size Border includes a sizing
border as the frame of the window or dialog box
- Border includes a simple
border as the frame of the window or dialog
- Dialog frame includes a
dialog box frame as the frame of the window or dialog
- System Modal causes the window or
dialog box to be system modal. A system modal window or
dialog box does not allow the focus to be directed to
other windows that might be active.
- Menu includes an action
bar menu in the window. This option is not available for
dialog boxes
- Min button allows you to add a
Minimize button to the upper-right corner of the window. Note:
The Min Box check box will only be available when you
select Parent Window or Child Window radio buttons.
- Max button allows you to add a
Maximize button to the upper-right corner of the window.
Note: The Max Box check box will only be available
when you select Parent Window or Child Window.
- Hide allows you to add a Hide
button to the upper-right corner of the window. Note: The
Hide button check box will only be available when you
select Parent Window or Child Window.
- Accelerators allows you to add
Accelerators to the application. The Accelerators are
generally associated with pull-down menu items. Note: The
Accelerator check box will only be available when you
select Parent Window or Child Window. Accelerators cannot
be used be defined within Dialogs since they have to be
associated with the main application window. IRE will
consolidate the definitions into one table since the OS/2
Presentation Manager only allows one Accelerator table
per application.
- Standard sets the window as being
standard. When this option is used, all other selected
options are ignored. Note: The Standard check box
will only be available when you select Parent Window or
Child Window.
- Shell position designates that the
window size and position should be determined by the
system when it is created
- Auto Icon prevents the
WM_PAINT message from being sent to the window when it is
iconized. It is generally used to increase performance.
- DBCS status includes a
status area at the bottom of the client window when the
application is running on a DBCS-enabled system
Bidi Tab
Font &
Color Tab contains
only a dialog tab
- Push Button Tab
- The tab allows you to enter the default
size of the push button in the Width and
Height entry fields. The values entered
into the two entry fields are in dialog box units. You
can also set the default ID through the ID
field and the default text in the Text
entry field
Options:
- Default designates a push
button as the default
- Help designates a push
button as the help button
- SYSCOMMAND designates a
push button as a SYSCOMMAND button
- No Border causes the push
button to have no border. 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.
- No Focus prevents the
button from receiving the focus when selected
- Highlighted sets the
highlight state of a push button
- Icon uses an icon in
place of text within the push button
- Auto size sizes the
button such that the contents fit
- Text accepts text when
also including a bitmap or icon within the button
- Mini-icon creates a
mini-icon within the push button
- Bitmap uses bitmap in
place of text within the push button
Base Styles
- Check Box Tab
- This dialog allows you to enter the
default text to be used along with the size of the check
box when it is initially created in the Height
and Width entry fields.
Types:
- Check Box designates 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.
- Auto Check Box designates
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.
- 3 State designates 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 halftone. 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.
- Auto 3 State designates
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 halftone. 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.
Base Styles
- Radio Button Tab
- This dialog allows users to enter the
default text to be used along with the size of the radio
button when it is initially created in the Height
and Width entry fields.
Types:
- Radio Button specifies
the radio button as being simple. The application must
provide the necessary logic to deselect other radio
buttons in the group of radio buttons that this
particular one belongs to.
- Auto Radio Button toggles
an Auto Radio Button each time it is selected and
unselected. Generally, Auto Radio Buttons appear in
groups where only one button is selected at a time.
Unlike a Radio Button, the Auto Radio Button will
automatically set its state when selected by the user.
- Autosize causes the
button to be automatically sized to the text.
- No Focus prevents the
button 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. This allow
the Help Manager to correctly determine the
control ID that does have the focus and to provide the
appropriate Help Panel for the control.
- No Pointer Select
prevents a notification message from being sent when the
arrow keys are used to move between buttons in a group of
Radio Buttons or Auto Radio Buttons. The user must use
the Space Bar to select the button after the
highlight has been move to it.
Base Styles
- Horz scroll Tab and Vert. scroll Tab
- These tabs allow you to enter the size of
the scroll bar, in dialog box units, using the Width
and Height entry fields. You can also
set the default ID through the ID field.
Styles:
- Thumb Size sets the
scroll bar thumb to a given size using 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.
- Auto Track allows the
scroll bar to move when selected by the pointer instead
of an outline representation
- Auto Size changes the
size of the scroll bar to reflect the amount of data
contained within a window.
Base Styles
- List Box Tab
- This dialog allows you to enter the size
of the list box when it is initially created using the Width
and Height entry fields. You can also
enter the default text to be used in the Text
entry field.
Options:
- Multiple Selection allows
a user to select multiple items from the list presented
which can, depending on the situation, simplify the
selection process
- User Redraw allows you to
draw the items within the List Box yourself
- No Adjust Position indicates
that 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.
- Horz. Scroll adds a
Horizontal Scroll Bar to the bottom of a List Box.
- Extended Selection
selects 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: click the mouse selection button at the
start point; press Shift and click the mouse selection
button at the end point, then release Shift.
Base Styles
- Entry field Tab
- This tab allows you to enter the initial
size of the entry field when it is created and the
default text to be used. The Start and End
entry fields allow you to enter the starting and ending
index positions of the text that should be selected. The Size
entry field allows you to set the maximum number of
characters that the entry field can accept.
Options:
- Left aligned aligns the
text in the entry field with the left edge. Text entered
by the user will shift right in the entry field.
- Centered centers text in
the entry field. When text is entered by the user in the
entry field, the contents of the entry field will shift
left and right keeping the text centered in the entry
field.
- Right aligned aligns the
text in the entry field with the right edge. Text entered
by the user will shift left in the entry field.
- Auto Horz. scroll scrolls
the text in the entry field when new text is entered.
- Margin places a border
around the Entry Field allowing the user to see the
limits of the actual Entry Field.
- Auto Tab generates the
effect of a tab key when a character is added to a full
field. This only occurs when the character is added to
the end of entry field text; inserting and/or replacing a
character or characters in the middle of the text does
not cause the auto tab to be generated.
- Read Only prevents the
user from entering text in the entry field
- Command designates the
entry field as a command entry field. This provides the Help
Manager with command help if the user requests help
for this field.
- Unreadable displays
asterisks for each character of text entered by the user.
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.
- Auto size sizes the text
so the contents fit
- Any causes the entry
field to contain a mixture of double-byte and single-byte
characters
- SBCS causes the entry
field to accept single-byte characters only
- DBCS causes the entry
field to accept double-byte characters only
- Mixed designates an entry
field as being able to handle a mixture of SBCS and DBCS
characters
Base Styles
- Group Box Tab
- This tab allows you to enter the size of
the group box using the Width and Height
entry fields. The values entered into the two entry
fields are in dialog box units. You can also set the
default ID through the ID field. The
default text to be used when it is initially created is
entered in the Text entry field.
Options:
- Auto size allows the
group box to be automatically sized
Base Styles
- Text Tab
- This tab allows you to enter the size of
the text, in dialog units, using the Width
and Height entry fields. You can also
set the default ID through the ID field.
The default text to be used when it is initially created
can be entered in the Text entry field.
Options:
- Left Aligned displays the
static text left aligned within the limits of its display
rectangle
- Horz. centered displays
the static text horizontally centered within the limits
of its display rectangle
- Right Aligned displays
the static text right aligned within the limits of its
display rectangle
- Top Aligned displays the
static text top aligned within the limits of its display
rectangle
- Vert. Centered displays
the static text centered vertically within the limits of
its display rectangle
- Bottom Aligned displays
the static text bottom aligned within the limits of its
display rectangle
- Word Wrap prevents Static
Text from being clipped. This allows the text to flow to
a new line within the Static Text size rectangle if
necessary.
- Halftone displays Static
Text in a halftone
- Mnemonic allows a
mnemonic association for the text. The mnemonic is
denoted by the tilde character (~) before the letter that
is to act as the mnemonic and will appear underlined when
displayed.
- Auto size automatically
sizes the control area to the control text
Base Styles
- Frame Tab
- This tab allows you to enter the size of
the frame, in dialog box units, using the Width
and Height entry fields. You can also
set the default ID through the ID field.
The default text to be used when it is initially created
is entered in the Text entry field.
Options:
- Foreground creates a dark
frame. The color of the frame is the inverse of the
window background.
- Halftone creates a
colored frame. The color of the frame is the median of
the window background and the inverse of the window
background.
- Background creates a
frame. The color of the frame is the window background.
- Auto size automatically
sizes the control area to the control text
Base Styles
- Rectangle Tab
- This tab allows you to enter the size of
the rectangle, in dialog box units, using the Width
and Height entry fields. You can also
set the default ID through the ID field.
The default text to be used when it is initially created
is entered in the Text entry field.
Options:
- Foreground creates a
dark, solid rectangle. The color of the rectangle is the
inverse of the window background.
- Halftone creates a
colored, solid rectangle. The color of the rectangle is
the median of the window background and the inverse of
the window background.
- Background creates a
solid rectangle. The color of the rectangle is the window
background.
- Auto size sizes the
control area to the control text automatically.
Base Styles
- Combo Box
- This tab allows you to enter the size of
the combo box, in dialog box units, using the Width
and Height entry fields. You can also
set the default ID through the ID field.
The default text to be used when it is initially created
is entered in the Text entry field.
Types:
- Simple creates a Combo
Box that contains an entry field and a list box. Both the
entry field and list box will be visible at all times.
- Drop Down creates a Combo
Box that contains an entry field and a button. 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.
- Drop Down List creates a
Combo Box that contains an entry field and a button but
where the user can type into the entry field. The drop
down button appears as a downward pointing arrow on the
right edge of the entry field.
Options:
- Any causes the entry
field to contain a mixture of double-byte and single-byte
characters
- SBCS causes the entry
field to accept single-byte characters only
- DBCS causes the entry
field to accept double-byte characters only
- Mixed designates an entry
field as being able to handle a mixture of SBCS and DBCS
characters
- Horz. scroll scrolls the
text in the entry field when new text is entered
Base Styles
- MLE Tab
- This tab allows you to enter the size of
the multi-line entry field, in the Width
and Height entry fields. The values
entered into the two entry fields are in dialog box
units. You can also set the default ID through the ID
field and the default text in the Text
entry field.
The Start and End
entry fields allow you to enter the starting and ending index
positions of the text that should be selected. The Size
entry field allows you to set the maximum number of characters
that the entry field can accept.
Import/Export:
- None indicates no import
and export preference
- Text indicates text
import and export format
- No translate indicates no
translation of CR/LF combinations for import and export
- Windows format indicates
that Windows CR/LF translation should be used for import
and export
Formatting:
- Limit Horz. indicates
that the formatting rectangle should be limited
horizontally
- Limit Vert. indicates
that the formatting rectangle should be limited
vertically
- Match window indicates
that the formatting rectangle should match the window
limits
Options:
- Border causes a border to
be drawn around the multiple-line entry field
- Horz. Scroll includes a
horizontal scroll bar at the bottom of the multiple-line
entry field
- Vert. Scroll includes a
vertical scroll bar at the right of the multiple-line
entry field
- Ignore Tab prevents the
Tab and Shift+Tab keys from affecting the multiple-line
entry field
- Read Only prevents the
user from entering text in the multiple-line entry field
- Word Wrap causes the text
to fit within the multi-line entry field when you have
not used either a Horizontal Scroll Bar or Vertical
Scroll Bar styles in the Multi-Line Entry Field
- Disable Undo prevents
undo buffers from being created for the multiple-line
entry field. This reduces the memory required for the
control and also makes response faster.
Base Styles
- Spin Button
- The default text to be used along with the
size of the spin button when it is initially created is
entered in the entry fields provided in the dialog. The
dialog allows you to enter the ID symbol
and value.
You can set the entry area width of the spin
button field through the Size entry field. You
can also set the starting and ending values of the spin button
field through the Lower and Upper
entry fields. The values will only be recognized if you have
selected the Numeric only option. If the the
spin button is a servant, can specify the master ID of you the
owning spin button through the Master ID
drop-down button.
Types:
- Master designates the
spin as the master consisting of at least one single spin
field
- Servant creates a
multi-field spin button by spinning servants from the
master
Alignment:
Options:
- All characters allows any
character to be entered in the spin button spin field
- Numeric allows only
numeric values to be entered in the spin button spin
field
- Read only prevents values
from being entered in the spin button spin field
- No border creates a spin
button spin field without a border
- Fast spin enables the
spin button to increase the spin speed with time. The
speed of spinning will double every two seconds.
- Zero pad causes 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 less
Base Styles
- Container Tab
- The default Container tab is used to set
the selection type and general options. It is also used
to set the ID symbol and value.
Types:
- Extended allows the user
to select one or more container items in any combination.
This is valid for all views except the tree view.
- Multiple allows the user
to select zero or more container items. This is valid for
all views except the tree view.
- Single allows the user to
select only one container item at any given time. When a
container item is selected, the previous container item
is de-selected. This is valid for all views and is the
only type supported for the tree view.
Options:
- Auto position allows the
container items to be arranged when the window size
changes, container items are inserted, removed, sorted,
invalidated, or filtered, the font or font size changes
or the window title text changes. It is only valid with
the icon view.
- Verify pointer verifies
that the application pointers are members of the
container
- Read only prevents the
user from editing any of the text within a container
window.
- Mini Record causes the
container to interpret all container records as being
smaller than they would otherwise be.
- Mini-icons causes the
container to support mini-icons within in the
MINIRECORDCORE data structure.
- No control pointer prevents
the container from sending a WM_CONTROLPOINTER message
when a WM_MOUSEMOVE message is received by the container.
Base Styles
- Slider Tab
- The default 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:
- Horizontal positions the
slider horizontally. This is the default orientation of
the slider
- Vertical positions the
slide vertically
Shaft offset:
- Bottom or Top
(for Vertical sliders only)
- Left or Right
(for Horizontal sliders only)
- Centered
Button placement:
- Bottom or Top
(for Vertical sliders only)
- Left or Right
(for Horizontal sliders only)
Home position:
- Bottom or top
(for Vertical sliders only)
- Left or Right
(for Horizontal sliders only)
Options:
- Snap to increment positions
the slider arm on the nearest value when it is moved to a
position between two specified values on the slider
scale, such as between two tick marks. It will also
redraw the slider arm at that position.
- Owner draw notifies the
application whenever the slider shaft, the ribbon strip,
the slider arm, and the slider background are drawn
- Read only prevents the
user from interacting with the slider
- Ribbon strip colors the
slider shaft between the home position and the slider arm
with a color that is different than the shaft color
Primary scale:
- Scale 1 causes 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.
- Scale 2 causes 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.
Base Styles
- Value Set Tab
- The tab allows you to enter the size of
the value set, in dialog box units, in the Width
and Height entry fields. You can also
set the default ID through the ID field,
the default text in the Text entry field
and the number of rows and columns.
Default items:
- Bitmap treats each value
set item as a bitmap. This is the default.
- Icon treats the value set
items as icons
- Text treats each value
set item as text
- Color info treats each
value set item as a RGB color value
- Color indices treats each
value set item as an index into the logical color table
Options:
- Border creates a thin
border around the value set to allow it to delineate the
control
- Item border creates a
thin border around each value set item to allow it to be
delineated from the other items
- Scale bitmaps
automatically scales bitmaps to the size of the cell. If
this style is not used, each bitmap is centered in its
cell.
- Right to left ordering
interprets column orientation as right-to-left, instead
of the default left-to-right arrangement
- Owner Draw notifies the
application whenever the background of the value set
window is painted
Base Styles
- Notebook Tab
- The default Notebook tab is used to set
notebook back page orientation, tab position, tab type
and binding. It is also used to set the ID symbol and
value.
Back page orientation:
- Bottom right paints the
back pages on the notebook's bottom and right sides. This
is the default.
- Bottom left paints the
back pages on the notebook's bottom and left sides
- Top right paints the back
pages on the notebook's top and right sides
- Top left paints the back
pages on the notebook's top and left sides
Major tab side:
- Bottom places the major
tabs on the notebook's bottom edge. Note: Only
valid in combination with Back page Bottom Right or Back
page Bottom Left. This is the default when Back page
Bottom Left style is used.
- Top places the major tabs
on the notebook's top edge. Note: Only valid in
combination with Back page Top Right or Back page Top
Left.
- Left places the major
tabs on the notebook's left edge. Note: Only valid
in combination with Back page Bottom Left or Back page
Top Left. This is the default when Back page Top Left
style is used .
- Right places the major
tabs on the notebook's right edge. Note: Only
valid in combination with Back page Bottom Right or Back
page Top Right. This is the default when either of these
back pages styles is used.
Tab type:
- Square draws the tabs
with square edges. This is the default.
- Rounded draws the tabs
with rounded edges
- Polygon draws the tabs
with polygon edges
Status Text:
- Left left justifies the
status text on the status line. This is the default.
- Center centers the status
text on the status line
- Right right justifies the
status text on the status line
Tab text:
- Left left-justifies the
status text
- Center centers the status
text
- Right right-justifies the
status text
Binding options:
- Spiral paints a spiral
binding on the notebook
- Solid paints a solid
binding on the notebook. This is the default.
Base Styles
Circular Slider Tab
- The default Circular Slider tab is used to
set the display type and general options of the circular
slider. It is also used to set the text, ID symbol and
value.
Default items:
- Mid-point tick causes the
mid-point and end point tick marks to be longer than the
other tick marks of the circular slider
- No value buttons prevents
+ and - buttons from being displayed within the circular
slider
- No dial numbers prevents
scrollable numeric value from being displayed within the
circular slider
- No dial text prevents the
window title beneath the dial from being displayed within
the circular slider
- Direct manipulation
allows the user to select the value of change from within
the circular slider
- 360° scroll range
extends the scroll range within the circular slider to
full dial
- Proportional ticks makes
the tick marks within the circular slider proportional
- No ticks prevents tick
marks in the circular slider
- Circular value causes the
circular slider to have circular value
Base Styles
Graphic Button
- This tab allows you to enter the size of
the graphic button, in dialog box units, in the Width
and Height entry fields. You can also
set the default ID through the ID field
and the default text in the Text entry
field.
Options:
- 2 state defines a graphic
button that has two states: up and down. When the button
is in the up state, it represents an off condition.
When it is in the down state, it represents an on condition.
- Auto 2 state defines a
graphic button that has two states: up and down. When the
button is in the up state, it represents an off condition.
When it is in the down state, it represents an on condition.
- Animation displays a
series of bitmaps in an ongoing, circular fashion
- Auto animation
automatically displays a series of bitmaps in an ongoing,
circular fashion
- Highlight bitmap displays
a different bitmap when the button is in a highlighted
(i.e. selected) state
- Disable bitmap displays a
different bitmap when the button is in a disabled (i.e.
non-selectable) state
- 3D recessed text displays
the text within a recessed rectangle giving it a
"sunken" effect
- 3D raised text displays
the text within a raised rectangle giving it a
"raised" effect
Base Styles
Handwriting Tab
- This tab allows you to enter the size of
the handwriting, in dialog box units, in the Width
and Height entry fields. You can also
set the default ID through the ID field
and the default text in the Text entry
field.
Options:
- Border draws a border
around the entry area of the handwriting control
- 3D border draws a 3D
border around the entry area of the handwriting control
Base Styles
Sketch Tab
- This tab allows you to enter the size of
the sketch, in dialog box units, using the Width
and Height entry fields. You can also
set the default ID through the ID field.
Options:
- Border draws a border
around the entry area of the sketch control
- 3D border draws a 3D
border around the entry area of the sketch control
Base Styles