mf_disp()

Displays a memory file in a window that is already set on the screen

Call
#include <vv_sys.h>
void mf_disp(wnp)

WINDOWPTR wnp

Pointer to a displayed window that has an associated memory file

Returns

None

 
Description

mf_disp() displays a portion of a memory file in a window. Before calling mf_disp(), the memory file must have been initialized by a call to mf_def() and text placed in the memory file by mf_rd(), mf_rowins(), or mf_rowrpl(). The memory file must be associated with the window by calling sw_mf(), and the window must be set on the screen.

If the memory file has previously been set to operate on a keyworded section with mf_kwdset(), only that section of the memory file will be displayed. Otherwise, the entire memory file is displayed.

mf_disp() uses the window's row and column origin in the memory file to determine what portion of the memory file will fall within the window. If the origin of the window in the memory file is (3, 0), for example, the first character in the fourth row of the memory file (or keyworded section thereof) will be displayed in the upper left-hand corner of the window. The origin can be set with sw_org().

If the end of the portion to be displayed is reached before the window is full, the rest of the window is cleared.

Related Functions

mf_browse(), mf_def(), mf_kwdset()

Cautions

Prior to calling mf_disp(), a memory file must be defined and lines placed in the memory file. The memory file must be associated with the specified window, and this window must be set on the screen.

mf_disp() calls internal Vermont Views functions. The VCS error reporting system will show the internal functions instead of mf_disp().


Home Contents Previous Next