NavigateToForm Method
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