Changes between Initial Version and Version 1 of EasyGuiWindows


Ignore:
Timestamp:
08/30/08 06:57:02 (6 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