7.5

Table Of Contents

GetNextDataPage(procedure)

Advance to the next data page of the sample data file. Note that this command may have unpredicted behavior if not used cor-

rectly in documents that use a user-defined emulation.

This command should only be executed when printermode is not in design mode. The result will be incorrect on screen, but

there will be no

unexpected behaviors. Therefore, the only solution is for end-users to make sure the command doesn't get executed while in

Design mode by bracketing it within a if(&printermode<>0) ... endif()

structure.

Syntax

getnextdatapage()

GRestore (procedure)

This command restores all system parameters previously saved with the gsave command. If no gsave command was issued

previously, the results are unpredictable. For more information, refer to the gsave command.

Syntax

grestore()

Argument

None

Code Sample Example

See "GSave (procedure)" (page 567).

GSave (procedure)

This command saves all current system parameters, which can later be restored using the grestore command. By bracketing

parts of your PlanetPress Talk programs with gsave/grestore commands, you can make sure the current system state is

preserved and remains unaffected by whatever operations your program executes. For instance, each PlanetPress object,

once converted to its PlanetPress Talk scripting language equivalent, begins with a gsave command and ends with a gre-

store, thus ensuring objects do not interfere with each other, or with the system.

The system parameters gsave saves include current line width, current stroke color, and current fill color.

Syntax

gsave()

Argument

None

Code Sample Example

In this example, the current position is set first and saved.