Return the next HostScreenField object in an enumeration of all screen fields.

 

 

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

 

Flynet Viewer

 

See Also

 

HostScreenField | startFieldEnum | getField

 

Applies To: HostScreen object

 

---

© 2016 Inventu Corporation, Flynet LTD