comparison lispref/frames.texi @ 62853:0a1026721b52

(Window Frame Parameters): Document user-size. Shorten entry for top by referring to left.
author Richard M. Stallman <rms@gnu.org>
date Sun, 29 May 2005 08:24:18 +0000
parents 08abb83f8aec
children 99e9892a51d9 01137c1fdbe9
comparison
equal deleted inserted replaced
62852:1ea7b7eb50a9 62853:0a1026721b52
360 be sure the position you specify is not ignored, specify a 360 be sure the position you specify is not ignored, specify a
361 non-@code{nil} value for the @code{user-position} parameter as well. 361 non-@code{nil} value for the @code{user-position} parameter as well.
362 362
363 @item top 363 @item top
364 The screen position of the top edge, in pixels, with respect to the 364 The screen position of the top edge, in pixels, with respect to the
365 top edge of the screen. The value may be a positive number @var{pos}, 365 top edge of the screen. It works just like @code{left}, except vertically
366 or a list of the form @code{(+ @var{pos})} which permits specifying a 366 instead of horizontally.
367 negative @var{pos} value.
368
369 A negative number @minus{}@var{pos}, or a list of the form @code{(-
370 @var{pos})}, actually specifies the position of the bottom edge of the
371 window with respect to the bottom edge of the screen. A positive value
372 of @var{pos} counts toward the top. @strong{Reminder:} if the
373 parameter is a negative integer @minus{}@var{pos}, then @var{pos} is
374 positive.
375
376 Some window managers ignore program-specified positions. If you want to
377 be sure the position you specify is not ignored, specify a
378 non-@code{nil} value for the @code{user-position} parameter as well.
379 367
380 @item icon-left 368 @item icon-left
381 The screen position of the left edge @emph{of the frame's icon}, in 369 The screen position of the left edge @emph{of the frame's icon}, in
382 pixels, counting from the left edge of the screen. This takes effect if 370 pixels, counting from the left edge of the screen. This takes effect if
383 and when the frame is iconified. 371 and when the frame is iconified.
415 pixels, call @code{frame-pixel-height}; see @ref{Size and Position}.) 403 pixels, call @code{frame-pixel-height}; see @ref{Size and Position}.)
416 404
417 @item width 405 @item width
418 The width of the frame contents, in characters. (To get the height in 406 The width of the frame contents, in characters. (To get the height in
419 pixels, call @code{frame-pixel-width}; see @ref{Size and Position}.) 407 pixels, call @code{frame-pixel-width}; see @ref{Size and Position}.)
408
409 @item user-size
410 This does for the size parameters @code{height} and @code{width} what
411 the @code{user-position} parameter (see above) does for the position
412 parameters @code{top} and @code{left}.
420 413
421 @item fullscreen 414 @item fullscreen
422 Specify that width, height or both shall be set to the size of the screen. 415 Specify that width, height or both shall be set to the size of the screen.
423 The value @code{fullwidth} specifies that width shall be the size of the 416 The value @code{fullwidth} specifies that width shall be the size of the
424 screen. The value @code{fullheight} specifies that height shall be the 417 screen. The value @code{fullheight} specifies that height shall be the