NTPSendDrawingField

 

NTPSendDrawingField ( <ReportHandle>, <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, the assigning of the data to the fields in the report is done in the sequence of theNTPSendField-calls in the script.

All fields defined in the report are defined as a dataset. By using NTPSendField, NTPSendRTField and/or NTPSendDrawingField these fields are filled consecutively until the function callNTPEndDocument 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: The graphics attachments/image resources that are intended for the drawing fields defined in a report may be referred to directly by setting the field name with the function NTPSendDrawingFieldByName. 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 NTPSendDrawingField Lib "NTP.DLL" ( ByVal ReportHandle As Long, 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.

 

<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)

Use of 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)