trm_screen_dump()

Purpose

Performs an ASCII screen dump

Syntax

trm_screen_dump()

Description

This function has a similar effect to pressing the <Print Scrn> key. The current screen textual image is apended to the SCREEN.PRN file. It is saved in an internal format suitable for display by the DP4ED utility.

Note that:

• Icons, bitmaps and VCR buttons are ignored
• Radio buttons are drawn as ( ) or (o)
• Checkboxes are drawn as [ ] or [x]
• Buttons are drawn as <>
• Frames and lines are represented by +, - and | characters
• Text within controls is always left-justified and may overflow the frame

The row and column position of each control is calculated by dividing the pixel position by the width or height of the system font. The result is rounded up or down. The size is calculated similarly, except that the size is always rounded up. One limitation of this function is that where extra spacing is allocated between lines of text - for example in menu maps or in maps containing framed edit controls - you may see a blank line. This is unavoidable if the relative alignment of controls from different maps is to be preserved. Where the row and column position of controls overlap, it is impossible to predict where the control will appear in the dump. This causes maps containing line controls to be dumped incorrectly.

For a WYSIWYG dump, use the Windows Print Screen facilities.