3.16  dialog%

Implements: top-level-window<%>

A dialog is a top-level window that is modal: while the dialog is shown, all other top-level windows in the dialog's eventspace are disabled.

• (instantiate dialog% () (label _) [(parent _)] [(width _)] [(height _)] [(x _)] [(y _)] [(style _)] [(enabled _)] [(border _)] [(spacing _)] [(alignment _)] [(min-width _)] [(min-height _)] [(stretchable-width _)] [(stretchable-height _)]) -> dialog% object
     label : string (up to 200 characters)
     parent = #f : frame% or dialog% object or #f
   width = #f : exact integer in [0, 10000] or #f
   height = #f : exact integer in [0, 10000] or #f
   x = #f : exact integer in [0, 10000] or #f
   y = #f : exact integer in [0, 10000] or #f
   style = null : list of symbols in '(no-caption resize-border)
   enabled = #t : boolean
     border = 0 : exact integer in [0, 1000]
     spacing = 0 : exact integer in [0, 1000]
     alignment = '(left top) : two-element list: 'left, 'center or 'right and 'top, 'center or 'bottom
   min-width = 0 : exact integer in [0, 10000]
     min-height = 0 : exact integer in [0, 10000]
     stretchable-width = #t : boolean
     stretchable-height = #t : boolean

  The label string is used as the dialog's title in its title bar. If the dialog's label is changed (see set-label ), the title bar is updated.

  The parent argument can be #f or an existing frame. Under Windows, if parent is an existing frame, the new dialog is always on top of its parent. Under Windows and X, a dialog is iconized when its parent is iconized.

  If parent is #f, then the eventspace for the new dialog is the current eventspace, as determined by current-eventspace . Otherwise, parent's eventspace is the new dialog's eventspace.

  If the width or height argument is not #f, it specifies an initial size for the dialog (in pixels) assuming that it is larger than the minimum size, otherwise the minimum size is used. Under Windows and Mac OS (and with some X window managers) dialogs are not resizeable.

  If the x or y argument is not #f, it specifies an initial location for the dialog. Otherwise, a location is selected automatically (tiling frames and dialogs as they are created).

  The style flags adjust the appearance of the dialog on some platforms:

  • 'no-caption -- omits the title bar for the dialog (Windows)

  • 'resize-border -- adds a resizeable border around the window (Windows) or grow box in the bottom right corner (Mac OS)

  Even if the dialog is not shown, a few notification events may be queued for the dialog on creation. Consequently, the new dialog's resources (e.g., memory) cannot be reclaimed until some events are handled, or the dialog's eventspace is shut down.

  For information about the enabled argument, see window<%>. For information about the border, spacing, and alignment arguments, see area-container<%>. For information about the min-width, min-height, stretchable-width, and stretchable-height arguments, see area<%>.

  
  

Methods
    on-subwindow-char
    show

All Methods
    accept-drop-files from window<%>
    add-child from area-container<%>
    after-new-child from area-container<%>
    begin-container-sequence from area-container<%>
    border from area-container<%>
    can-close? from top-level-window<%>
    can-exit? from top-level-window<%>
    center from top-level-window<%>
    change-children from area-container<%>
    client->screen from window<%>
    container-flow-modified from area-container<%>
    container-size from area-container<%>
    delete-child from area-container<%>
    enable from window<%>
    end-container-sequence from area-container<%>
    focus from window<%>
    get-alignment from area-container<%>
    get-children from area-container<%>
    get-client-size from window<%>
    get-control-font from area-container-window<%>
    get-cursor from window<%>
    get-edit-target-object from top-level-window<%>
    get-edit-target-window from top-level-window<%>
    get-eventspace from top-level-window<%>
    get-focus-object from top-level-window<%>
    get-focus-window from top-level-window<%>
    get-graphical-min-size from area<%>
    get-height from window<%>
    get-label from window<%>
    get-label-font from area-container-window<%>
    get-label-position from area-container-window<%>
    get-parent from area<%>
    get-plain-label from window<%>
    get-size from window<%>
    get-top-level-window from area<%>
    get-width from window<%>
    get-x from window<%>
    get-y from window<%>
    has-focus? from window<%>
    is-enabled? from window<%>
    is-shown? from window<%>
    min-height from area<%>
    min-width from area<%>
    move from top-level-window<%>
    on-activate from top-level-window<%>
    on-close from top-level-window<%>
    on-drop-file from window<%>
    on-exit from top-level-window<%>
    on-focus from window<%>
    on-message from top-level-window<%>
    on-move from window<%>
    on-size from window<%>
    on-subwindow-char from dialog%
        overrides on-subwindow-char from window<%>
    on-subwindow-event from window<%>
    on-superwindow-enable from window<%>
    on-superwindow-show from window<%>
    on-system-menu-char from top-level-window<%>
    on-traverse-char from top-level-window<%>
    place-children from area-container<%>
    popup-menu from window<%>
    reflow-container from area-container<%>
    refresh from window<%>
    resize from top-level-window<%>
    screen->client from window<%>
    set-alignment from area-container<%>
    set-control-font from area-container-window<%>
    set-cursor from window<%>
    set-label from window<%>
    set-label-font from area-container-window<%>
    set-label-position from area-container-window<%>
    show from dialog%
        overrides show from top-level-window<%>
        overrides show from window<%>
    spacing from area-container<%>
    stretchable-height from area<%>
    stretchable-width from area<%>