= Windows =

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 ==

{{{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''