ArborX

wdr

Longname: w indow dr aw   Open the Documentation Legend
Released: not available 
Created: not available 
See also: trf wtp

Summary
 Redraws one or more document windows. During making changes to your document it is sometimes necessary to reformat your document and re-display any parts that have changed. This is because 3B2 strikes a balance between showing you the changes you have just made, and keeping things fast enough to allow you to work at a sensible pace.
Example extract

This example redraws the entire screen:

 wdr

Syntax (SVNNA)
wdr Ø
wdr toggle:i
wdr window:n (  box:n (  x1, x2:n (  y1, y2:n  )  )  )
Ø:

Redraws the whole screen.
toggle:i
-  Turns off redraw.
+  Turns redraw back on.
These are the only form of the wdr keyword that should be used by user. The following parameters are designed to be used internally by 3B2 only, therefore use of these parameters may result in unpredictable results.
window:n

Specifies the number of the window to be redrawn. The numbers are assigned relative to the order in which they were opened, for example the first window is one. The window id of the top window can be obtained using the getvar 01504 (named doc.window.id) for example: boxit ^[doc.window.id]^

The wtp macro redraws only the top window, and is therefore more efficient than wdr if only one window needs to be redrawn.

Window numbers begin at one and increment for every document opened. If a document is closed that window id number becomes free and the lowest free number will be assigned to the next document opened. Note that the numbers on the Window menu alongside the filenames are not the window id numbers. The only way to determine a window id number is to use the getvar 01504 (named doc.window.id).

Example

This example redraws the part of the work area that is in the region (0,0)->(100,100) of window one:

 wdr 1,0,0,0,100,100
box:n
0  Work area.
1  Top bar.
2  Side bar.
3  Edit bar.
xl, xr:

The left and right coordinates within the box. These coordinates are in pixels, so for example if you are running a desktop resolution of 800x600 the screen coordinates are 0,0 to 799,599. These coordinates are relative to the top left corner of the Windows MDI document window. They are not relative to the position of the yellow bar or anything else, even if you specify the box argument as 3 (for edit bar).
yt, yb:

The top and bottom coordinates within the box.
Users should only be invoking wdr as follows:

wdr +

wdr -

All of the other parameters are designed to be used internally by 3B2 only, therefore use of any parameters other than the three listed above may result in unpredictable results.

Document created on 08-Feb-2003, last reviewed on 18-Jun-2003 (revision 1)