NameValueAdd

See Also: NamedValueGet, NamedValueIndex, NamedValueRemove, OnGetNavigateForwardData

Purpose

Adds or replaces a name and value to a tNameValuePair array that is part of tWebNavigateData during forward navigation in a mobile web application (drilldown interface).

Returns an array of tNameValuePair data with the updated name/value data.

Return Type

Integer

Syntax

Use NameValuePairFunctions.pkg

Function NamedValueAdd Global tNameValuePair[] Data String sName String sValue Returns tNameValuePair[]

where

• Data: An array of tNameValuePair data that will be searched. Usually the tWebNavigateData.NamedValue member.
• sName: The name that will be searched for.
• sValue: The value that will be added for this name.

What It Does

NamedValueAdd adds a name and value to a tNameValuePair array during navigation in a mobile web application (drilldown interface).

If the name does not yet exist in the array, the name/value pair will be added as a new array element. If the name exists, the value will be updated. The name search is case insensitive.

Procedure OnGetNavigateForwardData tWebNavigateData ByRef NavigateData Handle hoToView

    Get NamedValueAdd NavigateData.NamedValues "Header" "New Order" to NavigateData.NamedValues

End_Procedure