PLT Tools: DrScheme Extension Manual

3.28 `drscheme:unit:frame%` = `(drscheme:frame:mixin (drscheme:frame:basics-mixin frame:searchable%))`

drscheme:unit:frame% = (drscheme:frame:mixin (drscheme:frame:basics-mixin frame:searchable%))

Extends: drscheme:unit:frame<%>

Extends: drscheme:rep:context<%>

This frame inserts the Scheme and Language menus into the menu bar as it is initialized.

(instantiate drscheme:unit:frame% () (label _) [(parent _)] [(width _)] [(height _)] [(x _)] [(y _)] [(style _)] [(enabled _)] [(border _)] [(spacing _)] [(alignment _)] [(min-width _)] [(min-height _)] [(stretchable-width _)] [(stretchable-height _)]) -> drscheme:unit:frame% object
   label : string (up to 200 characters)
   parent = #f : frame% 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-resize-border no-caption no-system-menu mdi-parent mdi-child)
   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 displayed in the frame's title bar. If the frame'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 frame is always on top of its parent. Also, the parent frame may be an MDI parent frame from a new MDI child frame. Under Windows and X (for many window managers), a frame is iconized when its parent is iconized.

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

If the width or height argument is not #f, it specifies an initial size for the frame (in pixels) assuming that it is larger than the minimum size, otherwise the minimum size is used.

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

The style flags adjust the appearance of the frame on some platforms:
- 'no-resize-border -- omits the resizeable border around the window (Windows, X MWM) or grow box in the bottom right corner (Mac OS)
- 'no-caption -- omits the title bar for the frame (Windows, X MWM)
  
  (X Gnome, X KDE: the frame decoration is omitted completely when 'no-resize-border and 'no-caption are combined.)
- 'no-system-menu -- omits the system menu (Windows)
- 'mdi-child -- creates the frame as a MDI (multiple document interface) child frame, mutually exclusive with 'mdi-parent (Windows)
- 'mdi-parent -- creates the frame as a MDI (multiple document interface) parent frame, mutually exclusive with 'mdi-child (Windows)
If the 'mdi-child style is specified, the parent must be a frame with the 'mdi-parent style, otherwise an exn:application:mismatch exception is raised.

Even if the frame is not shown, a few notification events may be queued for the frame on creation. Consequently, the new frame's resources (e.g., memory) cannot be reclaimed until some events are handled, or the frame'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
    add-show-menu-items
    break-callback
    change-to-file
    clear-annotations
    disable-evaluation
    disable-evaluation
    edit-menu:between-select-all-and-find
    enable-evaluation
    ensure-defs-shown
    ensure-rep-shown
    execute-callback
    file-menu:between-open-and-revert
    file-menu:between-print-and-close
    file-menu:between-save-as-and-print
    file-menu:print-string
    file-menu:save-as-string
    file-menu:save-string
    get-break-button
    get-button-panel
    get-canvas
    get-canvas%
    get-definitions-canvas
    get-definitions-text
    get-definitions/interactions-panel-parent
    get-directory
    get-editor
    get-editor%
    get-execute-button
    get-interactions-canvas
    get-interactions-text
    get-special-menu
    get-text-to-search
    make-searchable
    on-close
    on-size
    reset-offer-kill
    set-breakables
    set-breakables
    still-untouched?
    update-save-button
    update-save-message
    update-shown

3.28 drscheme:unit:frame% = (drscheme:frame:mixin (drscheme:frame:basics-mixin frame:searchable%))

3.28 `drscheme:unit:frame%` = `(drscheme:frame:mixin (drscheme:frame:basics-mixin frame:searchable%))`