User Tools

Site Tools


window_declare_a_dialog_window_.htm
Navigation:  Language Reference > 6 - Windows >====== WINDOW (declare a dialog window) ====== Previous pageReturn to chapter overviewNext page

NewC7.jpg

label     WINDOW( 'title ')  [,AT( )] [,CENTER] [,SYSTEM] [,MAX] [,ICON( )] [,STATUS( )] [,HLP( )]

[,CURSOR( )] [,MDI] [,MODAL] [,MASK] [,FONT( )] [,GRAY][,TIMER( )]
[,ALRT( )] [,ICONIZE] [,MAXIMIZE] [,MSG( )] [,PALETTE( )] [,DROPID( )] [,IMM]
[,AUTO] [,COLOR( )] [,TOOLBOX] [,DOCK( )] [,DOCKED( )] [,LAYOUT( )]
[, TILED ] [, HSCROLL ] [, DOUBLE ]
CENTERED VSCROLL NOFRAME
HVSCROLL RESIZE
[ MENUBAR
menus and/or items
END ]
[ TOOLBAR
Controls
END ]
Controls
END

blk2blue.jpg

WINDOW Declares a document window or dialog box.
label A valid Clarion label. A label is required.
title A string constant containing the window's title text (PROP:Text).
AT Specifies the initial size and location of the window (PROP:AT). If omitted, default values are selected by the runtime library.
CENTER Specifies that the window's initial position is centered on screen relative to its parent window, by default (PROP:CENTER). This attribute takes effect only if at least one parameter of the AT attribute is omitted.
SYSTEM Specifies the presence of a system menu (PROP:SYSTEM).
MAX Specifies the presence of a maximize control (PROP:MAX).
ICON Specifies the presence of a minimize control, and names a file or standard icon identifier for the icon displayed when the window is minimized (PROP:ICON).
STATUS Specifies the presence of a status bar for the window (PROP:STATUS).
HLP Specifies the “Help ID” associated with the window (PROP:HLP).
CURSOR Specifies a mouse cursor to display when the mouse is positioned over the window (PROP:CURSOR). This cursor is inherited by the WINDOW's controls unless overridden on the individual control.
MDI Specifies that the window conforms to normal MDI child-window behavior (PROP:MDI).
MODAL Specifies the window is “system modal” and must be closed before the user may do anything else (PROP:MODAL).
MASK Specifies pattern input editing mode of all entry controls in this window (PROP:MASK).
FONT Specifies the default font for all controls in this window (PROP:FONT).
GRAY Specifies that the window has a gray background for use with 3-D look controls (PROP:GRAY).
TIMER Specifies periodic timed event generation (PROP:TIMER).
ALRT Specifies “hot” keys active when the window has focus (PROP:ALRT).
ICONIZE Specifies the window is opened as an icon (PROP:ICONIZE).
MAXIMIZE Specifies the window is maximized when opened (PROP:MAXIMIZE).
MSG Specifies a string constant containing the default text to display in the status bar for all controls in the window (PROP:MSG).
PALETTE Specifies the number of hardware colors used for graphics in the window (PROP:PALETTE).
DROPID Specifies the window may serve as a drop target for drag-and-drop actions (PROP:DROPID).
IMM Specifies the window generates events whenever it is moved or resized (PROP:IMM).
AUTO Specifies all window controls' USE variables re-display on screen each time through the ACCEPT loop (PROP:AUTO).
COLOR Specifies a background color for the WINDOW and default background and selected colors for the controls in the WINDOW (PROP:COLOR).
TOOLBOX Specifies the window is “always on top” and its controls never retain focus (PROP:TOOLBOX).
DOCK Specifies a window with the TOOLBOX attribute is dockable (PROP:DOCK).
DOCKED Specifies a window with the DOCK attribute is opened docked (PROP:DOCKED).
LAYOUT Indicates the orientation of window controls and field sequence. A style of (1) essentially “flips” the window controls' display as a mirror image of the layout specified in the Window Formatter. Default field navigation moves from right to left. (PROP:LAYOUT)
WALLPAPER Specifies the background image to display in the window's client area (PROP:WALLPAPER). The image stretches to fill the entire client area of the window unless the TILED or CENTERED attribute is also present.
TILED Specifies the WALLPAPER image displays at its default size and is tiled to fill the entire client area of the window (PROP:TILED).
CENTERED Specifies the WALLPAPER image displays at its default size and is centered in the entire client area of the window (PROP:CENTERED).
HSCROLL Specifies a horizontal scroll bar is automatically added to the window when any scrollable portion of the window lies horizontally outside the visible area (PROP:HSCROLL).
VSCROLL Specifies a vertical scroll bar is automatically added to the window when any scrollable portion of the window lies vertically outside the visible area (PROP:VSCROLL).
HVSCROLL Specifies both vertical and horizontal scroll bars are automatically added to the window when any scrollable portion of the window lies outside the visible area.
DOUBLE Specifies a double-width frame around the window (PROP:DOUBLE).
NOFRAME Specifies a window with no frame (PROP:NOFRAME).
RESIZE Specifies a thick frame around the window, which does allow window resizing (PROP:RESIZE).
MENUBAR Defines a menu structure (optional).
menus and/or items MENU and/or ITEM declarations that define the menu selections.
TOOLBAR Defines a toolbar structure (optional).
controls Control declarations that define tools available on the TOOLBAR, or the control fields in the WINDOW.

A WINDOW declares a document window or dialog box which may contain controls, and may be used to display output to the user. When the WINDOW is first opened, it remains hidden until the first DISPLAY statement or ACCEPT loop is encountered. This enables any changes to be made to the appearance before it is displayed. Any previously opened WINDOW on the same execution thread is disabled. Events for the WINDOW are processed by the first ACCEPT loop encountered after the WINDOW is first opened.

A WINDOW automatically receives a single-width border frame unless one of the DOUBLE, NOFRAME, or RESIZE attributes are specified. Screen coordinates are measured in dialog units. A dialog unit is defined as one-quarter the average character width and one-eighth the average character height of the font specified in the WINDOW's FONT attribute (or the system font, if no FONT attribute is specified on the WINDOW).

A WINDOW with the MODAL attribute is system modal; it takes exclusive control of the computer. This means that any other progam running in the background halts its execution until the MODAL WINDOW is closed. Therefore, the MODAL attribute should be used only when absolutely necessary. Also, the RESIZE attribute is ignored, and the WINDOW cannot be moved when the MODAL attribute is present.

A WINDOW without the MDI attribute, when opened in an MDI program on an MDI execution thread, is application modal. This means that the user must respond before moving to any other window in the application. The user may, however, move to any other program running in Windows at the time. Non-MDI windows may be opened either before or after an APPLICATION is opened, and may be on the same execution thread as the APPLICATION or any MDI child window (application modal) or their own thread (not application modal).

A WINDOW with the MDI attribute is an MDI “child” window. MDI “child” windows are clipped to the APPLICATION frame and automatically moved when the frame is moved, and can be totally concealed by minimizing the parent APPLICATION. MDI “child” windows are modeless; the user may change to the top window of another execution thread, within the same application or any other application running in Windows, at any time. An MDI “child” window must not be on the same execution thread as the APPLICATION. Therefore, any MDI “child” window called directly from the APPLICATION must be in a separate procedure so the START procedure can be used to begin a new execution thread. Once started, multiple MDI “child” windows may be called in the new thread.

The MENUBAR specified in a WINDOW with the MDI attribute is automatically merged into the “Global menu” (from the APPLICATION) when the WINDOW receives focus unless either the WINDOW's or APPLICATION's MENUBAR has the NOMERGE attribute. A MENUBAR specified in a WINDOW without the MDI attribute is never merged into the “Global menu”–it always appears in the window itself.

The TOOLBAR specified in a WINDOW with the MDI attribute is automatically merged into the “Global toolbar” (from the APPLICATION) when the WINDOW receives focus, unless either the WINDOW's or APPLICATION's TOOLBAR has the NOMERGE attribute. The toolbar specified in a WINDOW without the MDI attribute is never merged into the “Global toolbar”–it always appears in the window itself.

A WINDOW with the TOOLBOX attribute is automatically “always on top” and its controls do not retain focus (just as if they all had the SKIP attribute). This creates a window whose controls all behave in the same manner as controls in the toolbar. Normally, a WINDOW with the TOOLBOX attribute would be executed in its own thread.

Events Generated:

EVENT:PreAlertKey The user pressed an ALRT attribute hot key.
EVENT:AlertKey The user pressed an ALRT attribute hot key.
EVENT:CloseWindow The window is closing.
EVENT:CloseDown The application is closing.
EVENT:OpenWindow The window is opening.
EVENT:LoseFocus The window is losing focus to another thread.
EVENT:GainFocus The window is gaining focus from another thread.
EVENT:Docked A TOOLBOX window has been docked.
EVENT:Undocked A TOOLBOX window has been undocked.
EVENT:Timer The TIMER attribute has triggered.
EVENT:Move The user is moving the window. CYCLE aborts the move.
EVENT:Moved The user has moved the window.
EVENT:Size The user is resizing the window. CYCLE aborts the resize.
EVENT:Sized The user has resized the window.
EVENT:Restore The user is restoring the window's previous size. CYCLE aborts the resize.
EVENT:Restored The user has restored the window's previous size.
EVENT:Maximize The user is maximizing the window. CYCLE aborts the resize.
EVENT:Maximized The user has maximized the window.
EVENT:Iconize The user is minimizing the window. CYCLE aborts the resize.
EVENT:Iconized The user has minimized the window.
EVENT:Completed AcceptAll (non-stop) mode has finished processing all the window's controls.
EVENT:DDErequest A client has requested a data item from this Clarion DDE server application.
EVENT:DDEadvise A client has requested continuous updates of a data item from this Clarion DDE server application.
EVENT:DDEexecute A client has executed a DDEEXECUTE statement to this Clarion DDE server application.
EVENT:DDEpoke A client has sent unsolicited data to this Clarion DDE server application.
EVENT:DDEdata A DDE server has supplied an updated data item to this Clarion client application.
EVENT:DDEclosed A DDE server has terminated the DDE link to this Clarion client application.

Related Procedures:

ACCEPT, ALERT, EVENT, POST, REGISTER, UNREGISTER, YIELD, ACCEPTED, CHANGE, CHOICE, CLOSE, CONTENTS, CREATE, DESTROY, DISABLE, DISPLAY, ENABLE, ERASE, FIELD, FIRSTFIELD, FOCUS, GETFONT, GETPOSITION, HELP, HIDE, INCOMPLETE, LASTFIELD, MESSAGE, MOUSEX, MOUSEY, OPEN, POPUP, SELECT, SELECTED, SET3DLOOK, SETCURSOR, SETFONT, SETPOSITION, SETTARGET, UNHIDE, UPDATE

Example:

!MDI child window with system menu, minimize and maximize buttons, status bar,

! scroll bars, a resizable frame, with menu and toolbar which are merged into the

!application's menubar and toolbar:

MDIChild WINDOW('Child One'),MDI,SYSTEM,MAX,ICON('Icon.ICO'),STATUS,HVSCROLL,RESIZE

     MENUBAR

      MENU('File'),USE(?FileMenu)

       ITEM('Close'),USE(?CloseFile)

      END

      MENU('Edit'),USE(?EditMenu)

       ITEM('Undo'),USE(?UndoText),KEY(CtrlZ),STD(STD:Undo)

       ITEM('Cu&t'),USE(?CutText),KEY(CtrlX),STD(STD:Cut)

       ITEM('Copy'),USE(?CopyText),KEY(CtrlC),STD(STD:Copy)

       ITEM('Paste'),USE(?PasteText),KEY(CtrlV),STD(STD:Paste)

      END

      END

      TOOLBAR

      BUTTON('Cut'),USE(?CutButton),ICON(ICON:Cut),STD(STD:Cut)

      BUTTON('Copy'),USE(?CopyButton),ICON(ICON:Copy),STD(STD:Copy)

      BUTTON('Paste'),USE(?PasteButton),ICON(ICON:Paste),STD(STD:Paste)

      END

      TEXT,HVSCROLL,USE(Pre:Field)

      BUTTON('&OK'),USE(?Exit),DEFAULT

    END

!Non-MDI, system menu, maximize button, status bar, non-resizable frame,

NonMDI WINDOW('Dialog Window'),SYSTEM,MAX,STATUS

       TEXT,HVSCROLL,USE(Pre:Field),MSG('Enter some text here')

       BUTTON('&OK'),USE(?Exit),DEFAULT

      END

!System-modal window with non-resizable frame, with only a message and Ok button:

ModalWin WINDOW('Modal Window'),MODAL

         IMAGE(ICON:Exclamation)

         STRING('An ERROR has occurred')

         BUTTON('&OK'),USE(?Exit),DEFAULT

        END

See Also:

ACCEPT

APPLICATION

window_declare_a_dialog_window_.htm.txt · Last modified: 2021/04/15 15:57 (external edit)