-C H A P T E R

C H A P T E R 8

setDisplayFieldValue

<jato:setDisplayFieldValue>

This tag invokes the DisplayField.setValue(Object) method with the provided value. This tag does not render any HTML, and may be embedded within any arbitrary HTML on the page.

This tag is only valid when enclosed by a useViewBean, containerView, or tiledView tag. This tag may not contain any body content.

Example:

<jato:setDisplayFieldValue name="numItems" value="8" valueType="int"/>

Attribute Name	Description	Notes
name	The name of the `DisplayField` peer. This peer must be a child of the current parent `ContainerView`, `TiledView`, or `ViewBean`. The DisplayField name is resolved relative to the current parent view. The view peer must be of type `<JATO package>.view.DisplayField` This name may be a qualified view path, using forward slashes ("/") as delimiters. All components in the path except the last must refer to a `ContainerView` or a derivative of `ContainerView` (such as `TiledView`). Both relative and absolute paths are possible. If a name path begins with a forward slash, the name is assumed to be relative to the root view (the `ViewBean`). If the path does not begin with a forward slash, the name is assumed to refer to a child relative to the current container. Two dots ("..") may be used to refer to the container that is the parent of the current container. Examples: `/header/orderList/customerName` (absolute from root view) `orderList/customerName` (relative to current container) ..`/footer/orderList/customerName` (relative to parent)	Req, RTExpr
value	The value that will be passed into the `DisplayField.setValue(Object)` method of the specified `DisplayField` peer.	Req RTExpr
valueType	Valid values: "string", "int", "long", "float", "double", "short", "bigdecimal", "boolean", "byte", "char", "sqldate", "sqltime", "sqltimestamp" The type to which the string representation of the value attribute will be converted before being set on the target `DisplayField`. The type conversion from the string representation must be legal or an exception will be thrown. If this attribute is omitted, the set value will be of type `String`.

Attribute Name

Description

Notes

name

The name of the DisplayField peer. This peer must be a child of the current parent ContainerView, TiledView, or ViewBean. The DisplayField name is resolved relative to the current parent view.

The view peer must be of type <JATO package>.view.DisplayField

This name may be a qualified view path, using forward slashes ("/") as delimiters. All components in the path except the last must refer to a ContainerView or a derivative of ContainerView (such as TiledView). Both relative and absolute paths are possible. If a name path begins with a forward slash, the name is assumed to be relative to the root view (the ViewBean). If the path does not begin with a forward slash, the name is assumed to refer to a child relative to the current container. Two dots ("..") may be used to refer to the container that is the parent of the current container.

Examples:

/header/orderList/customerName (absolute from root view)

orderList/customerName (relative to current container)

../footer/orderList/customerName (relative to parent)

Req, RTExpr

value

The value that will be passed into the DisplayField.setValue(Object) method of the specified DisplayField peer.

Req RTExpr

valueType

Valid values: "string", "int", "long", "float", "double", "short", "bigdecimal", "boolean", "byte", "char", "sqldate", "sqltime", "sqltimestamp"

The type to which the string representation of the value attribute will be converted before being set on the target DisplayField. The type conversion from the string representation must be legal or an exception will be thrown.

If this attribute is omitted, the set value will be of type String.