comparison lispref/windows.texi @ 34390:7d0d54bf89f4

(Window Start): Update documentation for `pos-visible-in-window-p'.

34389:779f5314f5fa

If @var{noforce} is non-@code{nil}, and @var{position} would place point
off screen at the next redisplay, then redisplay computes a new window-start
position that works well with point, and thus @var{position} is not used.
@end defun

@defun pos-visible-in-window-p &optional position window fully
This function returns @code{t} if @var{position} is within the range of
text currently visible on the screen in @var{window}.  If @var{fully} is
non-@code{nil}, then locations that are partially obscured are not
considered visible.  It returns @code{nil} if @var{position} is scrolled
vertically out of view.  The argument @var{position} defaults to the
current position of point; @var{window}, to the selected window.  Here
is an example:

@example
@group
(or (pos-visible-in-window-p
     (point) (selected-window))
    (recenter 0))
@end group
@end example

The @code{pos-visible-in-window-p} function considers only vertical
scrolling.  If @var{position} is out of view only because @var{window}
has been scrolled horizontally, @code{pos-visible-in-window-p} returns
@code{t} anyway.  @xref{Horizontal Scrolling}.
@end defun

@node Textual Scrolling
@section Textual Scrolling
@cindex textual scrolling

34390:7d0d54bf89f4

If @var{noforce} is non-@code{nil}, and @var{position} would place point
off screen at the next redisplay, then redisplay computes a new window-start
position that works well with point, and thus @var{position} is not used.
@end defun

@defun pos-visible-in-window-p &optional position window partially
This function returns @code{t} if @var{position} is within the range of
text currently visible on the screen in @var{window}.  It returns
@code{nil} if @var{position} is scrolled vertically or horizontally out
of view.  Locations that are partially obscured are not considered
visible unless @var{partially} is non-@code{nil}.  The argument
@var{position} defaults to the current position of point in
@var{window}; @var{window}, to the selected window.

Here is an example:

@example
@group
(or (pos-visible-in-window-p
     (point) (selected-window))
    (recenter 0))
@end group
@end example
@end defun

@node Textual Scrolling
@section Textual Scrolling
@cindex textual scrolling