GetMoreRows method (WinStudio scripts)

Applies To

IWSIDOCollection interface

Definition

Retrieves the next bunch of rows from the IDO server (if available) and appends or prepends them to the collection.

Syntax

success = object .GetMoreRows()

  Part   Description
object Required. A reference to an IDO collection object.
success Optional. A return value indicating whether any rows were added to the collection.

Remarks

This method should only be called after a Refresh or Leave Filter-In-Place action has been performed on the collection. This method is typically used in conjunction with the GetMoreRowsEnabled property and possibly the LoadInReverse property.

With the default behavior (the LoadInReverse property set to False), using the initial Refresh action or exiting Filter-In-Place gets the top n rows, and this method retrieves batches of n rows in descending order, appending them to the collection. If the LoadInReverse property is set to True, the initial Refresh gets the last n rows, and this method retrieves batches of n rows in ascending order, prepending them to the collection.

Example

Sub Main()
   ' Retrieve all primary collection rows from the server.
   ThisForm.PrimaryIDOCollection.Refresh
   While ThisForm.PrimaryIDOCollection.GetMoreRows()
   End While
End Sub