(new frame% [label label] [ [parent parent] [width width] [height height] [x x] [y y] [style style] [enabled enabled] [border border] [spacing spacing] [alignment alignment] [min-width min-width] [min-height min-height] [stretchable-width stretchable-width] [stretchable-height stretchable-height]]) → (is-a?/c frame%) label : label-string? parent : (or/c (is-a?/c frame%) false/c) = #f width : (or/c (integer-in 0 10000) false/c) = #f height : (or/c (integer-in 0 10000) false/c) = #f x : (or/c (integer-in -10000 10000) false/c) = #f y : (or/c (integer-in -10000 10000) false/c) = #f
(listof (one-of/c 'no-resize-border 'no-caption 'no-system-menu 'hide-menu-bar 'toolbar-button 'float 'metal)) = null enabled : any/c = #t border : (integer-in 0 1000) = 0 spacing : (integer-in 0 1000) = 0
(list/c (one-of/c 'left 'center 'right) (one-of/c 'top 'center 'bottom)) = '(center top) min-width : (integer-in 0 10000) = graphical-minimum-width min-height : (integer-in 0 10000) = graphical-minimum-height stretchable-width : any/c = #t stretchable-height : any/c = #t
The parent argument can be #f or an existing frame. On Windows, if parent is an existing frame, the new frame is always on top of its parent. On Windows and Unix (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:
omits the resizeable border around the window (Windows, Unix) or grow box in the bottom right corner (Mac OS X)
omits the title bar for the frame (Windows, Mac OS X, Unix)
omits the system menu (Windows)
includes a toolbar button on the frame’s title bar (Mac OS X); a click on the toolbar button triggers a call to on-toolbar-button-click
hides the menu bar and dock when the frame is active (Mac OS X) or asks the window manager to make the frame fullscreen (Unix)
causes the frame to stay in front of all other non-floating windows (Windows, Mac OS X, Unix); on Mac OS X, a floating frame shares the focus with an active non-floating frame; when this style is combined with 'no-caption, then showing the frame does not cause the keyboard focus to shift to the window, and on Unix, clicking the frame does not move the focus; on Windows, a floating frame has no taskbar button
ignored (formerly supported for Mac OS X)
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<%>.
See also set-status-text.
A frame’s iconization can be changed by the user, and such changes do not go through this method. A program cannot detect when a frame has been iconized except by polling is-iconized?.
A window’s maximization can be changed by the user, and such changes do not go through this method; use on-size to monitor size changes.
Default implementation: If maximize? is #f, the window is restored, otherwise it is maximized.
When the match corresponds to a complete shortcut combination, the menu item’s callback is called (before on-menu-char returns).
If the event does not correspond to a complete shortcut combination, the event may be handled anyway if it corresponds to a mnemonic in the menu bar (i.e., an underlined letter in a menu’s title, which is installed by including an ampersand in the menu’s label). If a mnemonic match is found, the keyboard focus is moved to the menu bar (selecting the menu with the mnemonic), and #t is returned.
(send a-frame on-subwindow-char receiver event) → boolean? receiver : (is-a?/c window<%>) event : (is-a?/c key-event%)
(or (send this on-menu-char event) (send this on-system-menu-char event) (send this on-traverse-char event))