NTPSendDrawingField ( <ReportHandle>, <FieldName>, <ServerName>, <DatabaseName>, <UNID>, <AttachmentName> ) -> <ErrorCode>

 

 

Description

 

This command is used to fill a drawing field defined in a report either with an graphics attachment saved in a Notes document or an image resource saved in the design of a Notes database. If the fields of the report are filled with data using this command, then every field in the report is accessed directly via its name, that is there is a direct assignment of the data to the fields. If however the data is to be allocated in accordance with the sequence of fields defined in the report, use the NTPSendDrawingField function.

All fields defined in the report are defined as a single dataset. By using NTPSendFieldByName, NTPSendRTFieldByNameand/or NTPSendDrawingFieldByName these fields are filled consecutively until the function call NTPEndDocument closes this dataset and "resets" all fields, that is empties the contents of the fields respectively the dataset.

 

 

Note: This function allows both the passing of graphics file attachments as well as image resources which are saved in a database's design. Additional information may be found in the <UNID> and <AttachmentName> parameter descriptions.

 

 

Note: A mix of NTPSendDrawingField and NTPSendDrawingFieldByName is not possible.

 

 

Note: By using the function NTPSendDrawingField complete graphics attachments/image resources are passed to the drawing fields. In order to pass absolute path names which refer to graphics files, use the functionsNTPSendField or NTPSendFieldByName.

 

 

Declaration for Lotus Script

 

DeclareFunction NTPSendDrawingFieldByName Lib "NTP.DLL" ( ByVal ReportHandle As Long, ByVal FieldName As String, ByVal ServerName As String, ByVal DatabaseName As String, ByVal UNID As String, ByVal AttachmentName As String ) As Long

 

 

Parameter

 

<ReportHandle> (LONG)

Report handle, returned by callingNTPInit or NTPInitFromDatabase.

 

<FieldName> (STRING)

The name of the field to be filled with contents

 

<ServerName> (STRING)

Name of the server on which the database <DatabaseName> is to be found. Pass an empty string for local databases.

 

<DatabaseName> (STRING)

Name of the database from which data is to be read and which is to be found on the <ServerName>

 

 

Depending on the use of the function, the last two parameters have to be filled with different values.

 

When passing graphics attachments:

<UNID> (STRING)

Notes Unique Document ID of the document which is read by <ServerName> and <DatabaseName>.

 

<AttachmentName> (STRING)

Name (file name) of the graphics attachment, which is returned by the object class "NotesEmbeddedObject" and the property "Name" in Lotus Script.

 

When passing image resources:

<UNID> (STRING)

Using the constant NTPCONST_IMAGERESOURCE

 

<AttachmentName> (STRING)

File name of the image resource (as shown in the "Lotus Domino Designer")

 

 

Return value

 

<ErrorCode> (LONG)

Number of the error returned (0 = no error)