### 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:

- Left
- Centered
- Right

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