NavigateBegin - cWebView

Used when you want the view to be the first and only view in the view stack in a mobile web application (drilldown interface)

Type: Procedure

Parameters

Parameter	Type	Description
hoInvokingObject	Handle	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	Boolean	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.

Syntax

Procedure NavigateBegin Handle hoInvokingObject Boolean bUnconditional

Call Example

Send NavigateBegin hoInvokingObject bUnconditional

Description

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:

Clears the breadcrumb trail by removing all existing views from the view stack.
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.