Create application windows

When you create a new application window, the default settings reflect those of the previously created or of the currently active InTouch window. The following settings will reflect those of the previously created window:

• Window names: can have up to 32 characters and cannot include any special characters except dollar ($), pound (#) and underscore(_). When you create a window, you are only required to provide a window name. All other items are optional.

  Note: If the window name contains unsupported characters, an underscore ( _ ) replaces each unsupported character including the space character. If an application is migrated, editing the window or modifying any of the window properties will replace any special characters in the window name to underscore (_). This is applicable for all types of windows including application, frame and template.

  If you do not want it to be replaced by an "_" then in the . ini file, update WindowNameWithSpecialCharacters = 1.

• Comments: can be included for a window, but is for information purposes only. The comment appears in file listings but is not used by the application.

• Window dimension values: by default, the window dimension values are set to the dimensions of the previously created window. These values are also automatically modified if you manually change the window size by dragging the window border.

  Note: If you have specified an application target resolution that is different than your screen resolution, your application windows can exceed the canvas boundary. However, only windows within the target resolution canvas boundary will display at Run Time.

Create a new window

1. On the File menu, select New.

   The New window displays the available templates to create a new Native Window and a Frame Window.

   

2. Select the type of window you want to create from the available templates.

   Alternately, In the Search box, enter the template name based on which you want to create the window, and press Enter

3. To configure the view layout of the templates, select Icon, List, or Detail.

4. Use the Windows Properties panel to configure the basic window properties.

   The Windows Properties is classified into three categories: Appearance, Layout, and Window Style.

5. To configure the Appearance of the new window:

   • In the Name textbox, type a unique name that identifies the window.

   • In the Comment textbox, type any comments you want to associate with the window. The comment must be 60 characters or fewer.

   • Select the Window Color button to select the background color for the window.

   • Select FrameStyle for the window to display a border around the window.

     • Select Single for a single, one-dimensional border.

     • Select Double for a three-dimensional bordered window.

     • Select None for a window with no border.

       Select the ellipses next to the Name, Comment, or Window Color fields to do one of the following:

     • Reset - Returns the field value to its default value.

     • Edit - Allows to modify the details of the field.

     • Sort - Sort the Windows Properties fields in Alphabetical, Categorized, or Categorized Alphabetical order.

     • Show Description - Select to show/hide description

     • Show Toolbar - Select to show/hide toolbar.

6. To configure the layout of the new window:

   • From the Window Type dropdown, select the options to see how the window opens at run time.

     • Select the Window Type as Replace for the window to automatically close any windows it intersects with when it appears on the screen.

     • Select the Window Type as Overlay for the window to appear on top of currently open windows. It can be larger than the window(s) it is overlaying. When an overlay window closes, any windows behind it reappear. Selecting on any visible portion of a window behind an overlay window brings that window to the foreground as the active window.

     • Select the Window Type as Popup for the window to always stay on top of all other windows. Popup windows usually require a response from the user to be removed.

   • Expand the Location field to specify the window location and dimensions.

     • In the X box, type the number of pixels between the left edge of the design area and the left edge of the window being defined.

     • In the Y box, type the number of pixels between the top edge of the design area and the top edge of the window being defined.

   • Expand the Size field to specify the window Height and Width in pixels.

7. To configure the Window Style of the new window:

   • Select the Close Button check box to include a button on the title bar to close a window at design time or run time. Windows retain the close window button even after they are exported to other applications.

   • Select the Maximize Button check box to include a button on the title bar to maximize a window at design time or run time.

   • Select the Minimize Button check box to include a button on the title bar to minimize a window at design time or run time.

   • Select the Size Controls check box to enable users to resize a window in WindowMaker.

   • Select the Title Bar check box to include a title bar.

   • Select the Template check box to save the settings as a template for later use.

   • From the WindowState dropdown, select the default state of the window - Normal, Minimized, or Maximized.

8. Select OK.