| Parameter | Description |
|---|---|
| hoInvokingObject | Handle to the object that invokes this process. This is one of the times where hoInvokingObject will probably not be inside the invoking view (actually there is no invoking view). |
| bUnconditional | Determines how the closing of the views behaves when there are changed views in the view stack. If True, it unconditionally clears the view stack. If False, and change warnings are enabled for the changed view (see peChangedViewExitAction), it will halt the navigation with a warning. |
Procedure NavigateBegin Handle hoInvokingObject Boolean bUnconditional
| Call: | Send NavigateBegin hoInvokingObject bUnconditional |
NavigateBegin is a special case variant of the NavigateForward method.
It is used when you want the view to be the first and only view in the view stack in a mobile web application (drilldown interface). It does the following:
1. Clears the breadcrumb trail by removing all existing views from the view stack.
2. Adds itself to the view stack by sending NavigateForward.
Object oCustomer_itm is a cWebMenuItem
Set psCaption to "Customer Query"
WebRegisterPath ntNavigateBegin oSelectOrdersByCustomer
Procedure OnClick
Send NavigatePath
End_Procedure
End_Object
Note that clearing the view stack has different meanings depending on whether you have defined a dashboard object or not. If a dashboard object exists and has been assigned to the cWebApp phoDashboard property, the dashboard object is always the first item in the stack, making the view in NavigateBegin the second view in the stack. If there is no dashboard object, it will be the first view in the stack.