guidedtour/win.html

   1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
   2 <html><head>
   3
   4
   5   <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
   6
   7
   8   <meta name="keywords" content="WindowMaker,windowmaker,window manager,Window Maker"><title>WindowMaker Guided tour - Index</title>
   9
  10
  11
  12
  13   <link href="title.css" rel="stylesheet" type="text/css"></head>
  14 <h1>
  15 <center>Windows</center>
  16 </h1>
  17
  18 <center><a href="index.html">Back
  19 to Index</a>
  20 </center>
  21
  22 <ul>
  23
  24   <li><a href="#desc">Description</a></li>
  25   <li><a href="#focus">Focusing</a></li>
  26   <li><a href="#order">Reordering</a></li>
  27   <li><a href="#move">Moving</a></li>
  28   <li><a href="#max">Maximizing</a></li>
  29   <li><a href="#mini">Miniturizing</a></li>
  30   <li><a href="#size">Resizing</a></li>
  31   <li><a href="#shade">Shading</a></li>
  32   <li><a href="#hide">Hiding</a></li>
  33   <li><a href="#close">Closing</a></li>
  34   <li><a href="#menu">Commands menu</a></li>
  35 </ul>
  36
  37 <h2><a id="desc">Description</a></h2>
  38
  39 <p>General layout of a window:</p>
  40
  41 <ul>
  42
  43   <li>
  44     <p><em>Titlebar</em>: Gives the name of the application, document
  45 or window. It's color (usually) indicates the focus state (active or
  46 inactive window). I say (usually) because some styles and themes do not
  47 provide different colors for focused or unfocused windows - although
  48 this is rare (and, I might add, cruel!).</p>
  49   </li>
  50   <li>
  51     <p><em>Miniaturize button</em>:
  52 Clicking on the left button of the titlebar iconifies the window.</p>
  53   </li>
  54   <li>
  55     <p><em>Close button</em>:
  56 Clicking on the right button of the titlebar closes the window or kills
  57 the application.</p>
  58   </li>
  59   <li>
  60     <p><em>Resizebar</em>:
  61 The bottom part of the window. Dragging the resizebar with the mouse
  62 resizes the window.</p>
  63   </li>
  64   <li><em>Client area</em>:
  65 The window content. It can be an application, some text, a picture... </li>
  66 </ul>
  67
  68 <h2><a id="focus">Focusing</a></h2>
  69
  70 <p>A window can be in two states: focused or unfocused. The focused
  71 window is the active window, the one receiving keystrokes. It's
  72 titlebar has a differentiated color (usually!). Dialog windows or
  73 panels opened
  74 from a main window, automatically get the focus. As soon as they are
  75 closed, the main window gets the focus back.</p>
  76
  77 <p>Two modes are available to focus a window:</p>
  78
  79 <ul>
  80
  81   <li>
  82     <p><em>Click to focus mode</em>: clicking on any part of the window
  83 activates it.</p>
  84   </li>
  85   <li>
  86     <p><em>Focus follows mouse mode</em>: moving the mouse pointer over
  87 the window activates it. </p>
  88   </li>
  89 </ul>
  90
  91 <h2><a id="order">Reordering</a></h2>
  92
  93 <p>Windows can overlap other windows, in which case some will hide all
  94 or part of others. Clicking on the titlebar or resizebar with the left
  95 mouse button brings a window to the "front" (gives that window focus).
  96 Selecting a window from the window list menu does the same.</p>
  97
  98 <p>Some key bindings are provided and are very useful when a window is
  99 hidden behind others.</p>
 100
 101 <ul>
 102
 103   <li>
 104     <p><em>Meta key + click on the titlebar with left mouse button</em>-<br>
 105 sends the window to the back and gives focus to the topmost window.</p>
 106   </li>
 107   <li>
 108     <p><em>Meta key + click on the client area with left mouse button</em>-<br>
 109 brings the window to the front and focuses it.</p>
 110   </li>
 111   <li>
 112     <p><em>Meta key + Up Arrow key</em>-<br>
 113 brings the current focused window to the front.</p>
 114   </li>
 115   <li>
 116     <p><em>Meta key + Down Arrow key</em>-<br>
 117 sends the current focused window to the back.</p>
 118   </li>
 119 </ul>
 120
 121 <p>Many window attributes can be modified from the attributes panel in
 122 the window commands menu (clicking the right mouse button on the
 123 titlebar). From version 0.62.0, window cycling was changed to Windows
 124 style (Alt-Tab).</p>
 125
 126 <h2><a id="move">Moving</a></h2>
 127
 128 <p>Clicking on the titlebar of a window and dragging it with the left
 129 mouse button pressed moves the window.
 130 The little box in the middle indicates the current position in pixels
 131 relative to the top left corner of the screen (+0 +0).
 132 Extra key bindings give more flexibility.
 133 - Dragging the titlebar with middle mouse button: moves the window
 134 without changing it's stacking order.
 135 - Dragging the titlebar + Ctrl key: moves the window without focusing
 136 it.
 137 - Dragging the client area or the resizebar + Meta key: moves the
 138 window.</p>
 139
 140 <h2><a id="max">Maximizing</a></h2>
 141
 142 <p>Double-clicking the titlebar while holding the Ctrl key resizes the
 143 window's height to full screen.</p>
 144
 145 <p>Double-clicking the titlebar while holding the Shift key resizes the
 146 window's width to full screen.</p>
 147
 148 <p>Double-clicking the titlebar while holding both Ctrl and Shift keys
 149 resizes the window's height and width to full screen.
 150 Double-clicking the titlebar while holding Ctrl or Shift key restores
 151 the initial size of the window.</p>
 152
 153 <p>To prevent a maximized window from covering the dock, the "Keep on
 154 top" option must be selected from the dock menu.</p>
 155
 156 <h2><a id="mini">Miniaturizing</a></h2>
 157
 158 <p>Clicking the miniaturize button (the left one on the titlebar)
 159 shrinks the window into a miniwindow with an icon and a title and
 160 places it at the bottom of the screen. Hitting the assigned shortcut
 161 does the same. (Default is Meta + m.)</p>
 162
 163 <p>The miniwindow is different from the application icon in that the
 164 miniwindow cannot be docked.</p>
 165
 166 <p>Double-clicking in the miniwindow restores a miniaturized window.
 167 Double-clicking in an application icon with the middle mouse button
 168 restores all miniaturized and hidden windows of this application.</p>
 169
 170 <h2><a id="size">Resizing</a></h2>
 171
 172 <p>The resizebar, at the bottom of the window, is divided into three
 173 regions: left end region, middle region and right end region.</p>
 174
 175 <p>Depending upon the region you click, the resize operation is
 176 constrained to one direction. </p>
 177
 178 <p>Clicking in the middle region of the resizebar and dragging it
 179 vertically changes the window's height.</p>
 180
 181 <p>Clicking in either the left or right region of the resizebar and
 182 dragging it horizontally changes the window's width. </p>
 183
 184 <p>Dragging with Shift key pressed gives the same result. Clicking in
 185 either end region of the resizebar and dragging it diagonally changes
 186 both height and width.</p>
 187
 188 <p>Key bindings give more options.</p>
 189
 190 <ul>
 191
 192   <li>
 193     <p>Dragging the window in the client area with the right mouse
 194 button + Meta key resizes the window.</p>
 195   </li>
 196   <li>
 197     <p>Dragging the resizebar with the middle mouse button resizes the
 198 window without bringing it to the front.</p>
 199   </li>
 200   <li>
 201     <p>Dragging the resizebar + Ctrl key resizes the window without
 202 focusing it.</p>
 203   </li>
 204 </ul>
 205
 206 <h2><a id="shade">Shading</a></h2>
 207
 208 <p>Double-clicking on the titlebar of a window shades it.
 209 This means the window rolls up to it's titlebar. A shaded window has
 210 almost the same properties as a normal window. It can be miniaturized
 211 or closed.</p>
 212
 213 <p>From version 0.80.0, you can shade/unshade a window using a mouse
 214 wheel on its titlebar. This of course, assumes your system is able to
 215 manage a mouse wheel. The WMGLOBAL file in you $HOME/GNUstep/Defaults
 216 should contain two new directives : MouseWheelUp and MouseWheelDown.</p>
 217
 218 <h2><a id="hide">Hiding</a></h2>
 219
 220 <p>Clicking the the miniaturize button (the left one on the titlebar)
 221 with the right mouse button hides the application.
 222 Using the middle mouse button unhides the application, simultaneously
 223 opening the windows list menu and selecting the hidden application.
 224 (Pressing both buttons at once with a two buttons mouse does the same
 225 on some OSes.) If this doesn't work, use the F11 key binding (the
 226 default) to open the windows list menu.</p>
 227
 228 <h2><a id="close">Closing</a></h2>
 229
 230 <p>Clicking the close button (the right one on the titlebar) closes the
 231 window. When the close button has a different form (not an X), it means
 232 an application is running in that window.
 233 Double-clicking in this close button kills the application. This can be
 234 done too with <em>Ctrl key + clicking the close button</em>.</p>
 235
 236 <p>Usually, it's much better to exit an application from inside
 237 (through it's menu, for instance).</p>
 238
 239 <h2><a id="menu">Commands menu</a></h2>
 240
 241 <p>Clicking on the titlebar of a window with the right mouse button
 242 opens a menu containing commands applying to this window. The keyboard
 243 shortcut Ctrl + Esc can replace the click on the titlebar. Esc closes
 244 this menu.</p>
 245
 246 <p><strong>List of Commands Menu commands:</strong></p>
 247
 248 <p><em>Maximize/Unmaximize</em>:<br>
 249 Either maximizes or returns the window to it's initial state.</p>
 250
 251 <p><em>Miniaturize</em>:<br>
 252 Miniaturizes the window (miniwindow). The keyboard shortcut is Meta + m.</p>
 253
 254 <p><em>Shade/Unshade</em>: Shades (or unshades) the window.</p>
 255
 256 <p><em>Hide</em>:<br>
 257 Hides all windows of the application. Clicking on the application icon
 258 unhides the windows.</p>
 259
 260 <p><em>Hide Others</em>:<br>
 261 From version 0.80.1 it is possible to hide all others windows. The
 262 window list menu allows to unhide selecting the window to redisplay.</p>
 263
 264 <p><em>Resize/Move</em>:<br>
 265 When this menu option is selected, the window is ready to be moved or
 266 resized (the little box with coordinates is displayed inside the
 267 window). Clicking on the titlebar deselects the option.</p>
 268
 269 <p><em>Select</em>:<br>
 270 Obviously selects the window which then can be moved or resized...
 271 Reselecting this option deselects the window.</p>
 272
 273 <p><em>Move to</em>:<br>
 274 Allows to move the window to another workspace (if existing!).</p>
 275
 276 <p><em>Attributes</em>:<br>
 277 Opens the attributes panel to edit attributes and options for the
 278 window.</p>
 279
 280 <p>Five options are available in this panel: Window specification,
 281 Window attributes, Advanced options, Icon and initial workspace and
 282 application specific.</p>
 283
 284 <ul>
 285
 286   <li>Window specification: Defines that the configuration will apply
 287 to windows having their WM_CLASS property set to the selected name.
 288 This is because windows can have different names.
 289 From version 0.65.0, you can select the window to get the right
 290 specification.</li>
 291   <li>
 292     <p>Window attributes: selecting the corresponding checkbox allows
 293 to: </p>
 294     <ul>
 295       <li>disable titlebar</li>
 296       <li>disable resizebar</li>
 297       <li>disable close button</li>
 298       <li>disable miniaturize button</li>
 299       <li>disable border</li>
 300       <li>keep on top</li>
 301       <li>keep at bottom</li>
 302       <li>omnipresent</li>
 303       <li>start miniaturized</li>
 304       <li>start maximized</li>
 305       <li>full screen maximization</li>
 306     </ul>
 307   </li>
 308   <li>
 309     <p>Advanced options: selecting the corresponding checkbox allows
 310 to: </p>
 311     <ul>
 312       <li>don't bind keyboard shortcuts</li>
 313       <li>don't bind mouse clicks</li>
 314       <li>don't show in the window list</li>
 315       <li>don't let the window take focus</li>
 316       <li>keep inside screen</li>
 317       <li>ignore "Hide others"</li>
 318       <li>ignore "Save session"</li>
 319       <li>emulate application icon</li>
 320     </ul>
 321   </li>
 322   <li>
 323     <p>Icon and initial workspace: allow to </p>
 324     <ul>
 325       <li>choose an icon browsing directories</li>
 326       <li>ignore client supplied icon when selecting the checkbox</li>
 327       <li>define initial workspace</li>
 328     </ul>
 329   </li>
 330   <li>
 331     <p>Application specific: selecting checkboxes allows to:</p>
 332     <ul>
 333       <li>start hidden or with no application icon</li>
 334       <li>collapse application icons (from version 0.65.0)</li>
 335     </ul>
 336   </li>
 337   <li>
 338     <p>From version 0.80.0 a new checkbox is available : "Shared
 339 application icon". It replaces the "Collapse application icon"
 340 checkbox. That is, you can have many open windows from the same
 341 application with only one appicon. This feature is on by default except
 342 for some incompatible applications. This behavior can be defined for
 343 all windows in the Window Specification inspector selecting the
 344 Defaults for all windows checkbox.</p>
 345   </li>
 346 </ul>
 347
 348 <p>You can revert to the old behavior changing SharedAppIcon to "No" in
 349 the WMWindowAttributes file, either in the global domain or in the
 350 local domain : $HOME/GNUstep/Defaults.</p>
 351
 352 <p><em>Options</em>:</p>
 353
 354 <p>Submenu options allow to:</p>
 355
 356 <ul>
 357
 358   <li>to keep the window on top</li>
 359   <li>to keep the window at bottom</li>
 360   <li>to keep the window omnipresent</li>
 361   <li>to set shortcuts for the window</li>
 362 </ul>
 363
 364 <p>Ten shortcuts are available as soon as they have been set in the
 365 keyboard shortcut dialog. The shortcuts to define are those named
 366 "Shortcut for window + figure". Then, using the defined shortcut gives
 367 the focus to the window.</p>
 368
 369 <p><em>Close</em>:<br>
 370 Closes the window</p>
 371
 372 <p><em>Kill</em>:<br>
 373 Kills the application.
 374 Usually, an application must be closed from inside (menu or other
 375 means). This option is especially reserved for "emergency" cases.</p>
 376
 377 </body></html>