Return the next HostScreenField object in an enumeration of all screen fields.
HostScreenField HostScreen.nextEnumField() |
Arguments
HostScreen
Required. HostScreen object.
Remarks
Must be preceded by an initial startFieldEnum method.
The first call to nextEnumField after the initial startFieldEnum will be the first physical field on the screen. Note that if the attribute byte for the first field is at the end of the screen then the position of that field may be reported at a very high position, but is still the first field on the screen. (The attribute may appear at the end of the screen so that an entry field can start on row1 col1).
After all fields have been returned, a NULL will be returned, signaling the end of the field enumeration.
The following c# example demonstrates the use of startFieldEnum and nextEnumField:
string GetScreenFieldsText(HostScreen oScreen)
{
StringBuilder sb=new StringBuilder();
oScreen.startFieldEnum();
HostScreenField field=oScreen.nextEnumField();
while(field!=null)
{
string text=string.Format("[{0},{1}]='{2}'\r\n", field.row, field.col, field.value);
sb.Append(text);
field=oScreen.nextEnumField();
}
return sb.ToString();
}
Requirements
Inventu Viewer+
See Also
HostScreenField | startFieldEnum | getField
Applies To: HostScreen object
© 2022 Inventu Corporation
