NamedValueGet - cWebObject

Gets the value for the passed name of a tNameValuePair array that is part of tWebNavigateData during navigation in a mobile web application (drilldown interface)

Type: Function

Return Data Type: String

Parameters: tNameValuePair[] Data String sName

ParameterDescription
DataAn array of tNameValuePair data that will be searched. Usually the tWebNavigateData.NamedValue member.
sNameThe name that will be searched for.


Return Value

Returns the value for the name as a string. If the value is not found, it returns an empty string.


Syntax
Function NamedValueGet tNameValuePair[] Data String sName Returns String

Call: Get NamedValueGet Data sName to StringVariable


Description

NamedValueGet is used to retrieve the value for a named pair during forward and back navigation in a mobile web application (drilldown interface).

It performs a case-insensitive search for the passed name. If a match is found, the function will return the value for that name. If a match is not found, it returns an empty string.

Get NamedValueGet NavigateData.NamedValues "InvtHeader" to sValue
Get NamedValueGet NavigateData.NamedValues "RenderThis" to bRender
WebSet pbRender of oHeader to bRender
WebSet psCaption of oHeader to sValue


If you need to actually know if a named value pair exists, you can use NamedValueIndex to determine this and retrieve the value.

See Also

NamedValueAdd | NamedValueIndex | NamedValueRemove | OnGetNavigateForwardData | tWebNavigateData.tNameValuePair