Changes between Initial Version and Version 1 of EasyGuiWindows


Ignore:
Timestamp:
Aug 30, 2008, 6:57:02 AM (11 years ago)
Author:
zzkt
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • EasyGuiWindows

    v1 v1  
     1= Windows =
     2
     3Windows represent an area on the screen that allows the user to enter and view information. Windows are top-level views -- they have no container.
     4
     5== Window ==
     6
     7{{{window (view view-nib-mixin) [class]}}}
     8
     9A class representing windows. Additional initargs:
     10
     11'':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.
     12
     13'':window-position'' -- initializes the window position, see set-window-position.
     14
     15'':window-position-reference'' -- the reference location for window-position, see optional argument to set-window-position.
     16
     17'':window-title'' -- initializes the window title, see set-window-title.
     18
     19'':window-hide'' -- leaves the window hidden, see window-show.
     20
     21'':window-close-p'' -- creates a window with a close button (true by default for standard windows).
     22
     23'':window-minimize-p'' -- creates a window with a minimize button (true by default for standard windows).
     24
     25'':window-zoom-p'' -- creates a window with a zoom button (true by default for standard windows).
     26
     27'':window-resize-p'' -- creates a window with a resize control (true by default for standard windows).
     28
     29''TODO: '':window-toolbar-p'' -- not yet…''
     30
     31''TODO: :in-window-cycle-p, :in-window-menu-p ? ''
     32
     33
     34{{{(window-kind window) [method]}}}
     35
     36Returns the kind of window as a keyword.
     37
     38{{{(set-window-position window position &optional reference) [method]}}}
     39
     40Sets 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.''
     41
     42{{{(window-position window position &optional reference) [method]}}}
     43
     44Returns the position of window as a point in global coordinates.
     45
     46{{{(set-window-title window title) [method]}}}
     47
     48Sets the title of window to ''title''.
     49
     50{{{(window-title window) [method]}}}
     51
     52Returns the window's title.
     53
     54{{{(window-hide window) [method]}}}
     55
     56Makes the window invisible (not shown on screen).
     57
     58{{{(window-show window) [method]}}}
     59
     60Makes the window visible and selects it.
     61
     62{{{(window-hidden-p window) [method]}}}
     63
     64True if window is hidden.
     65
     66{{{(window-close-p window) [method]}}}
     67
     68Returns true if the window was created with a close button.
     69
     70{{{(window-minimize-p window) [method]}}}
     71
     72Returns true if the window was created with a minimize button.
     73
     74{{{(window-zoom-p window) [method]}}}
     75
     76Returns true if the window was created with a zoom button.
     77
     78{{{(window-resize-p window) [method]}}}
     79
     80Returns true if the window was created with a resize control.
     81
     82{{{(window-close window) [method]}}}
     83
     84Close 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.''
     85
     86{{{(window-select window) [method]}}}
     87
     88Brings window to the front, actives it, and shows it if it is hidden. The previously active window is deactivated.
     89
     90{{{(windows &key class) [function]}}}
     91
     92Returns all windows of class ''class'' (default t). ''TODO: add other useful keywords for filtering, see mcl.''
     93
     94''TODO: front-window, next-window, map-windows, (find-window title)''
     95
     96''TODO: modal dialogs''
     97