DoCmd.GoToRecord Method (Access)

 DoCmd.GoToRecord Method (Access)

The GoToRecord method carries out the GoToRecord action in Visual Basic.

Syntax

expression.GoToRecord(ObjectType, ObjectName, Record, Offset)

expression A variable that represents a DoCmd object.

Parameters

Name

Required/Optional

Data Type

Description

ObjectType

Optional

AcDataObjectType

A AcDataObjectType constant that specifies the type of object that contains the record you want to make current.

ObjectName

Optional

Variant

A string expression that's the valid name of an object of the type selected by the objecttype argument.

Record

Optional

AcRecord

A AcRecord constant that specifies the record to make the current record. The default value is acNext.

Offset

Optional

Variant

A numeric expression that represents the number of records to move forward or backward if you specify acNext or acPrevious for the record argument, or the record to move to if you specify acGoTo for the record argument. The expression must result in a valid record number.

Remarks

You can use the GoToRecord method to make the specified record the current record in an open table, form, or query result set.

If you leave the objecttype and objectname arguments blank (the default constant, acActiveDataObject, is assumed for objecttype), the active object is assumed.

You can use the GoToRecord method to make a record on a hidden form the current record if you specify the hidden form in the objecttype and objectname arguments.

Example

The following example uses the GoToRecord method to make the seventh record in the form Employees current:

VBA 
DoCmd.GoToRecord acDataForm, "Employees", acGoTo, 7