OnGetNavigateBackData - cBaseLocalControlHost

Called during a NavigateClose operation, used to pass data back for a non-relational lookup in a mobile web application (drilldown interface)

Type: Event

Parameters: tWebNavigateData ByRef NavigateData Handle hoBackToView

ParameterDescription
NavigateData (ByRef)Can be used to change any of the data members of the tWebNavigateData struct
hoBackToViewHandle of the object being navigated from


Syntax
Procedure OnGetNavigateBackData tWebNavigateData ByRef NavigateData Handle hoBackToView

Description

The OnGetNavigateBackData event is called during a NavigateClose operation in a mobile web application (drilldown interface).

It is sent to the callback object that was passed to the NavigateCancel method. This callback object should be an object within the view being closed or possibly the view itself.

Typically, this would be used when you are passing data back for a non-relational lookup. For example, you might set a name/value pair in the NamedValues member in this event. That NamedValues member would then be used by the invoking view to update a data entry object (DEO) value within the view. The will be used most often when the Navigate-From type (NavigateData.eNavigateType) is nfUndefined.

For example, if the object being closed was a non-relational list, like a validation table, you might update the selected value as follows:

Procedure OnGetNavigateBackData tWebNavigateData ByRef NavigateData
    String sValue
    WebGet psCurrentRowID to sValue
    Get NamedValueAdd NavigateData.NamedValues "ReturnValue" sValue to NavigateData.NamedValues
End_Procedure


While you may use the data in the tWebNavigateData.eNavigateType struct member array directly, you are encouraged to use the NamedValueAdd and NamedValueGet interfaces.

See Also

OnGetNavigateForwardData | GetNavigateData