Mercurial > emacs
comparison lispref/windows.texi @ 59702:b0a08eb3f2eb
(Window Start): Fix `pos-visible-in-window-p'
return value. Third element FULLY replaced by PARTIAL which
specifies number of invisible pixels if row is only partially visible.
(Textual Scrolling): Mention auto-window-vscroll.
(Vertical Scrolling): New defvar auto-window-vscroll.
author | Kim F. Storm <storm@cua.dk> |
---|---|
date | Sun, 23 Jan 2005 13:30:22 +0000 |
parents | 6f8d4406a676 |
children | c0d4e9df6ed2 befae6bafecb |
comparison
equal
deleted
inserted
replaced
59701:5f125540565b | 59702:b0a08eb3f2eb |
---|---|
1343 non-@code{nil} anyway. @xref{Horizontal Scrolling}. | 1343 non-@code{nil} anyway. @xref{Horizontal Scrolling}. |
1344 | 1344 |
1345 If @var{position} is visible, @code{pos-visible-in-window-p} returns | 1345 If @var{position} is visible, @code{pos-visible-in-window-p} returns |
1346 @code{t} if @var{partially} is @code{nil}; if @var{partially} is | 1346 @code{t} if @var{partially} is @code{nil}; if @var{partially} is |
1347 non-@code{nil}, it returns a list of the form @code{(@var{x} @var{y} | 1347 non-@code{nil}, it returns a list of the form @code{(@var{x} @var{y} |
1348 @var{fully})}, where @var{x} and @var{y} are the pixel coordinates | 1348 @var{partial})}, where @var{x} and @var{y} are the pixel coordinates |
1349 relative to the top left corner of the window, and @var{fully} is | 1349 relative to the top left corner of the window, and @var{partial} is |
1350 @code{t} if the character after @var{position} is fully visible and | 1350 @code{nil} if the character after @var{position} is fully visible; |
1351 @code{nil} otherwise. | 1351 otherwise it is a cons @code{(@var{rtop} . @var{rbot})} where the |
1352 @var{rtop} and @var{rbot} specify the number of invisible pixels at | |
1353 the top and bottom of the row at @var{position}. | |
1352 | 1354 |
1353 Here is an example: | 1355 Here is an example: |
1354 | 1356 |
1355 @example | 1357 @example |
1356 @group | 1358 @group |
1394 | 1396 |
1395 The textual scrolling functions (aside from | 1397 The textual scrolling functions (aside from |
1396 @code{scroll-other-window}) have unpredictable results if the current | 1398 @code{scroll-other-window}) have unpredictable results if the current |
1397 buffer is different from the buffer that is displayed in the selected | 1399 buffer is different from the buffer that is displayed in the selected |
1398 window. @xref{Current Buffer}. | 1400 window. @xref{Current Buffer}. |
1401 | |
1402 If the window contains a row which is taller than the height of the | |
1403 window (for example in the presense of a large image), the scroll | |
1404 functions will adjust the window vscroll to scroll the partially | |
1405 visible row. To disable this feature, Lisp code may bind the variable | |
1406 `auto-window-vscroll' to @code{nil} (@pxref{Vertical Scrolling}). | |
1399 | 1407 |
1400 @deffn Command scroll-up &optional count | 1408 @deffn Command scroll-up &optional count |
1401 This function scrolls the text in the selected window upward | 1409 This function scrolls the text in the selected window upward |
1402 @var{count} lines. If @var{count} is negative, scrolling is actually | 1410 @var{count} lines. If @var{count} is negative, scrolling is actually |
1403 downward. | 1411 downward. |
1619 @end example | 1627 @end example |
1620 | 1628 |
1621 If @var{pixels-p} is non-@code{nil}, @var{lines} specifies a number of | 1629 If @var{pixels-p} is non-@code{nil}, @var{lines} specifies a number of |
1622 pixels. In this case, the return value is @var{lines}. | 1630 pixels. In this case, the return value is @var{lines}. |
1623 @end defun | 1631 @end defun |
1632 | |
1633 @defvar auto-window-vscroll | |
1634 If this variable is non-@code{nil}, the line-move, scroll-up, and | |
1635 scroll-down functions will automatically modify the window vscroll to | |
1636 scroll through display rows that are taller that the height of the | |
1637 window, for example in the presense of large images. | |
1638 @end defvar | |
1624 | 1639 |
1625 @node Horizontal Scrolling | 1640 @node Horizontal Scrolling |
1626 @section Horizontal Scrolling | 1641 @section Horizontal Scrolling |
1627 @cindex horizontal scrolling | 1642 @cindex horizontal scrolling |
1628 | 1643 |