|Version 1 (modified by zzkt, 7 years ago) (diff)|
Windows represent an area on the screen that allows the user to enter and view information. Windows are top-level views -- they have no container.
window (view view-nib-mixin) [class]
A class representing windows. Additional initargs:
:window-kind -- the window kind determines the appearance of a window. It should be one of the following keywords: :alert, :modal, :floating, :document, :utility, :help, :sheet, :toolbar, :overlay, :sheet-alert, :drawer. The default is :document.
:window-position -- initializes the window position, see set-window-position.
:window-position-reference -- the reference location for window-position, see optional argument to set-window-position.
:window-title -- initializes the window title, see set-window-title.
:window-hide -- leaves the window hidden, see window-show.
:window-close-p -- creates a window with a close button (true by default for standard windows).
:window-minimize-p -- creates a window with a minimize button (true by default for standard windows).
:window-zoom-p -- creates a window with a zoom button (true by default for standard windows).
:window-resize-p -- creates a window with a resize control (true by default for standard windows).
TODO: :window-toolbar-p -- not yet…
TODO: :in-window-cycle-p, :in-window-menu-p ?
(window-kind window) [method]
Returns the kind of window as a keyword.
(set-window-position window position &optional reference) [method]
Sets the position of window. position can be a point, representing a position in global coordinates, or it can be one of :center, :cascade, :cascade-start, :alert, in which case the window will be centered, cascaded, or put in alert position relative to reference. reference can be a window, or the keyword :main-screen, or a list `(:screen ,some-window). TODO: if had a rep of <screen>, could have window--screen func instead of this :screen kludge.
(window-position window position &optional reference) [method]
Returns the position of window as a point in global coordinates.
(set-window-title window title) [method]
Sets the title of window to title.
(window-title window) [method]
Returns the window's title.
(window-hide window) [method]
Makes the window invisible (not shown on screen).
(window-show window) [method]
Makes the window visible and selects it.
(window-hidden-p window) [method]
True if window is hidden.
(window-close-p window) [method]
Returns true if the window was created with a close button.
(window-minimize-p window) [method]
Returns true if the window was created with a minimize button.
(window-zoom-p window) [method]
Returns true if the window was created with a zoom button.
(window-resize-p window) [method]
Returns true if the window was created with a resize control.
(window-close window) [method]
Close the window. TODO: If can arrange to make this be called when user closes the window (as in MCL), then won't need a closing hook, they can just write :before methods.
(window-select window) [method]
Brings window to the front, actives it, and shows it if it is hidden. The previously active window is deactivated.
(windows &key class) [function]
Returns all windows of class class (default t). TODO: add other useful keywords for filtering, see mcl.
TODO: front-window, next-window, map-windows, (find-window title)
TODO: modal dialogs