Share via

NavigateToForm Method

  • Article

The NavigateToForm method navigates to a form.

Syntax

object.NavigateToForm

(

i_FormID As Number,

i_RecordID As Number = -1,

i_ParentID As Number = -1

)

Parameters

Parameter Description

i_FormID

Form to navigate to.

i_RecordID

Record to open in the form. Optional; default value is -1.

i_ParentID

Record that will be used as the parent if the user creates a new record. Optional; default value is -1.

Remarks

This method can either be used to view and edit an existing record or to create a new record.

If the i_RecordID parameter specifies an existing Record ID, then that existing record is displayed to the user. In this case the i_ParentID parameter is ignored.

If the i_RecordID parameter specifies a value of -1, then an initialized form is displayed to the user. The user can enter values and then create a new record. If the user creates a new record, then the i_ParentID parameter specifies the parent record. If the i_ParentID parameter has a value of -1, then the record created by the user will be a top-level record and will not have a parent.

This method references the current form; consequently, it should not be called from a macro where there is no current form context.

See Also

Reference

IGrooveFormsToolUIDelegate Interface
LaunchOrNavigateToURL Method
NavigateToView Method