CDaoRecordset::SetPercentPosition

void SetPercentPosition( float fPosition );
throw( CDaoException, CMemoryException );

Parameters

fPosition

A number between 0 and 100.

Remarks

Call this member function to set a value that changes the approximate location of the current record in the recordset object based on a percentage of the records in the recordset.

When working with a dynaset-type or snapshot-type recordset, first populate the recordset by moving to the last record before you call SetPercentPosition. If you call SetPercentPosition before fully populating the recordset, the amount of movement is relative to the number of records accessed as indicated by the value of GetRecordCount. You can move to the last record by calling MoveLast.

Once you call SetPercentPosition, the record at the approximate position corresponding to that value becomes current.

Note   Calling SetPercentPosition to move the current record to a specific record in a recordset is not recommended. Call the SetBookmark member function instead.

For more information about navigating in recordsets, see the article DAO Recordset: Recordset Navigation in Visual C++ Programmer's Guide. For related information, see the topic "PercentPosition Property" in DAO Help.

CDaoRecordset OverviewClass MembersHierarchy Chart

See Also   CDaoRecordset::GetPercentPosition