Visual InterDev

RecordsetNavbar Design-Time Control

See Also      Tasks      Properties

Creates a RecordsetNavbar script object, which creates a set of HTML buttons for moving through a recordset. The RecordsetNavbar is capable of updating records in a recordset.

Remarks

You can set the properties of the RecordsetNavbar control at design time using the Properties window and the RecordsetNavbar Properties dialog box.

The RecordsetNavbar allows you to move the cursor position within the recordset to which it is bound. To bind the RecordsetNavbar to a Recordset control, set the RecordsetNavbar's Recordset property to the name of a Recordset control on the page.

To automatically update the recordset with data from all controls on the page that are bound to the same Recordset control as the RecordsetNavbar, set the UpdateOnMove property to True. The default is False.

There are four possible buttons on the RecordsetNavbar: "First," "Previous," "Next," and "Last." On the Format tab of the RecordsetNavbar Properties dialog box you can individually select each of the four buttons. You can also specify whether you want text or images on the buttons. Add spaces to the captions of the buttons to change their size.

Note   The scripting platform specifies where an object's script is run - either on the client (Microsoft^® Internet Explorer 4.0 DHTML) or on the server (ASP). Thus, the scripting platform determines whether the object is available under Client Objects & Events or Server Objects & Events in the Script Outline window.

For the RecordsetNavbar control, the Scripting Platform property is specified on the General tab of the RecordsetNavbar Properties dialog box. For more information, see the DTCScriptingPlatform property. For detailed information about choosing a scripting platform, see Writing Script for Script Objects.

Scripting Notes

To control how the RecordsetNavbar is displayed, call the show, hide, isVisible, getAlignment, and setAlignment methods.

To cancel move methods, call the cancelOperation and isOperationCancelled methods.

To return an individual button, call the getButton method.

For more information about the run-time object, see RecordsetNavbar Script Object. For information on scripting and objects, see Scripting with Design-Time Controls and Script Objects.