NTPSendField

 

NTPSendField ( <ReportHandle>, <Data> ) -> <ErrorCode>

 

 

Description

 

This command fills the field of a report with a value. If the field of a report are filled using this command, the sequence in which the fields are filled with data is equivalent to the NTPSendField calls in the script.

All fields defined in a report are viewed as a data set. By using NTPSendField and/or NTPSendRTField these fields are filled one by one until the data set is closed by calling the function NTPEndDocument and this in turn "resets" all fields, meaning the field contents as well as the data set is emptied.

 

 

Note: The values for the fields defined in a report may be passed by means of a direct reference of the field names and use of the NTPSendFieldByName function. Mixing NTPSendField and NTPSendFieldByName is not allowable.

 

 

Note: The function NTPSendField does not allow the passing of formatted rich text fields. These fields have to be filled using the commands NTPSendRTField or NTPSendRTFieldByName.

 

 

Declaration for Lotus Script

 

Declare Function NTPSendField Lib "NTP.DLL" ( ByVal ReportHandle As Long, ByVal Data As String ) As Long

 

 

Parameter

 

<ReportHandle> (LONG)

Report handle, returned by calling NTPInit or NTPInitFromDatabase.

 

<Data> (STRING)

The field content to be sent.

 

 

Return value

<ErrorCode> (LONG)

Number of the error encountered (0 = no error)