Parents: ScreenGroup, Screen
Children: Field
Used By: ScreenMap, activeMapName
Description
The FieldMap tag is used as a container for Field tags, which define named screen locations. The FieldMap tag corresponds to the ScreenMap object definition in the Flynet Viewer COM object.
At runtime, the HostScreen object property activeMapName is used to set the active map. Whenever a screen is recognized through either the waitForScreen or getScreenName methods (of the HostScreen object), the default FieldMap is loaded and will be used by any subsequent mappedGet, mappedSet, mappedRowGet or mappedRowSet methods.
A FieldMap can have either a ScreenGroup or Group tag as a parent. When the ScreenGroup tag is the parent, all children Screen definitions of the parent ScreenGroup have access to the FieldMap.
In the case where a Screen has no FieldMap defined, but there is a map for the Screen tag's parent ScreenGroup, the FieldMap defined in the ScreenGroup will be the default FieldMap for the Screen.
Attributes
Name |
Type |
Description |
name |
optional |
default="default"
The fieldmap name is used to qualify the active map in a HostScreen object. |
multiRow |
optional |
default="no"
When "yes" it identifies that this map defines a multirow field set. Used principally for documentation and code generation.
when yes, the c# code generator in the Mapper application will generate read/write methods with a rowIndex as a parameter. |