DspRichTextLoad

Loads a copy of the file Filename into the rich text object) at animation point AN. (The rich text object may have been created using either the DspRichTextLoad function or the PageRichTextFile function.)

The animation point at which a copy of the rich text file (for example, an RTF report) will display. This AN needs to match that of a rich text object (created using either the DspRichText function, or the PageRichTextFile function), or the copy of the file will not be loaded into anything, and will not display.

The name of the file to be copied and loaded into the rich text object at the specified animation point. The filename needs to be entered in quotation marks "".

If you are loading a copy of an RTF report, the report needs to already have been run and saved to a file. Remember that the filename for the saved report comes from the File Name field in the Devices form. The location of the saved file needs to also be included as part of the filename. For example, if the filename in the Devices form listed [Data];RepDev.rtf, then you would need to enter "[Data]\repdev.rtf" as your argument. Alternatively, you can manually enter the path, for example, "c:\MyApplication\data\repdev.rtf".

If you are keeping a number of history files for the report, instead of using the extension rtf, you need to change it to reflect the number of the desired history file, for example, 001.

// This will look in the [Data] path (as specified in the

Citect.ini file), and load a copy of the file DayRep.rtf into the

rich text object at animation point 57. //

DspRichTextLoad(57,"[Data]\DayRep.rtf");

// This will look in the [Data] path (as specified in the

Citect.ini file), and load a copy of the history file DayRep.003

into the rich text object at animation point 908. //

DspRichTextLoad(908, "[Data]\DayRep.003");

// This will load a copy of the history file

f:\MyApplication\data\DayRep.006, into the rich text object at animation

point 908. //

DspRichTextLoad(908, "f:\MyApplication\data\DayRep.006");