GoTopEx

ACCPAC Common Controls

AccpacView.GoTopEx

Retrieves the first logical record in the view according to the direction and filter set in the last Browse call. This method is a network optimized version of GoTop. It allows field values to be set to the view before the operation, and also returns the field values of the requested fields, as well as the record number.

Function GoTopEx(
FieldIDs As Variant,
Values As Variant,
RecNum As Long) As Boolean

Parameters

FieldIDs

[in] an array of field IDs representing fields from which the values should be returned if a record is successfully retrieved

Values

[out] returns an array of field values for the requested fields; returns Null if no record is retrieved

RecNum

[out] returns the record number if a record is retrieved

Return Value

Returns whether a record is retrieved. Since this method always retrieves the first record, the return value is FALSE only if there is no record that satisfies the current filter. The return value is the same as GoTop.

Remarks

This function first calls GoTop, and then BlkGet to retrieve the field values. The record number is also retrieved.