ScrollNextRow PowerScript function
Description
Scrolls to the next instance of the document in a RichTextEdit
control or RichTextEdit DataWindow. A RichTextEdit control has multiple
instances of its document when it shares data with a DataWindow.
The next instance of the document is associated with the next row
in the DataWindow.
For syntax specific to DataWindow controls
and child DataWindows, see the ScrollNextRow method
for DataWindows in the DataWindow Reference or the online Help.
Controls
DataWindow and RichTextEdit controls
Syntax
1 |
<span>rtename</span>.<span>ScrollNextRow</span> ( ) |
Argument |
Description |
---|---|
rtename |
The name of the RichTextEdit or DataWindow The DataWindow object in the DataWindow control must be a RichTextEdit |
Return Values
Integer. Returns 1 if it succeeds and
-1 if an error occurs.
Usage
When the RichTextEdit shares data with a DataWindow, the RichTextEdit contains
multiple instances of the document, one instance for each row.
ScrollNextRow advances to the next instance
of the RichTextEdit document. In contrast, repeated calls to ScrollNextPage advance
through all the pages of the document instance and then on to the
pages for the next row.
Examples
This statement scrolls to the next instance of the
document in the RichTextEdit control rte_1.
Each document instance is associated with a row of data.
1 |
rte_1.<span>ScrollNextRow</span>() |