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

 

 

Beschreibung

 

Mit diesem Befehl wird der Inhalt eines im Report definierten Zeichnung-Feldes mit einem im Notes-Dokument gespeicherten Grafik-Attachment oder einer im Design vorhandenen Image-Resource gefüllt. Werden die Felder des Reports über diesen Befehl mit Daten gefüllt, so entspricht die Zuordnung der Daten, zu den Feldern im Report, der Reihenfolge der NTPSendField-Aufruf im Script.

Alle im Report definierten Felder werden als ein Datensatz definiert. Mit NTPSendField, NTPSendRTField und/oder NTPSendDrawingField werden die Felder dieses Datensatzes nacheinander gefüllt, bis der Funktionsaufruf NTPEndDocument diesen Datensatz abschliesst und alle Felder "zurücksetzt", d .h. den Inhalt der Felder bzw. des Datensatzes leert.

 

Hinweis: Mit dieser Funktion können neben der Übergabe von Grafik-Attachments aus einem Notes-Dokument auch Image-Resourcen, die im Design der Datenbank gespeichert sind, übergeben werden. Weitere Informationen finden Sie weiter unten bei der Beschreibung der Parameter <UNID> und <AttachmentName>.

 

Hinweis: Die Grafik-Attachments/Image-Resourcen, für die im Report definierten Zeichnungs-Felder, können durch direkte Referenzierung, d .h. durch Angabe des Feldnamens, mit der Funktion NTPSendDrawingFieldByName übergeben werden. Ein Mischung von NTPSendDrawingField und NTPSendDrawingFieldByName ist nicht erlaubt.

 

Hinweis: Mit der Funktion NTPSendDrawingField werden aus Notes-Dokumenten komplette Grafik-Attachments/Image-Resourcen an den Report bzw. an die Zeichnungsfelder übergeben. Zur Übergabe von absoluten Pfadangaben, die auf Grafik-Dateien verweisen, sind die Funktionen NTPSendField oder NTPSendFieldByName zu benutzen.

 

 

Deklaration für Lotus Script

 

Declare Function 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 das bei Aufruf von NTPInit  oder NTPInitFromDatabase zurückgeliefert wurde.

 

<ServerName> (STRING)

Name des Servers auf dem die Datenbank <DatabaseName> liegt. Leerstring für lokal.

 

<DatabaseName> (STRING)

Name der Datenbank aus der die Daten gelesen werden sollen und auf dem <ServerName> liegt

 

 

Je nach Verwendung der Funktion, müssen die beiden letzten Parameter mit unterschiedlichen Werten gefüllt werden.

 

Bei der Übergabe von Grafik-Attachments:

<UNID> (STRING)

Notes Unique Document ID des Dokuments, das aus <ServerName> und <DatabaseName> gelesen werden soll.

 

<AttachmentName> (STRING)

Name (Dateiname) des Grafik-Attachments, welcher bei der Objekt-Klasse "NotesEmbeddedObject" und dem Property "Name" in Lotus Script zurückgeliefert wird.

 

Bei der Übergabe von Image-Resourcen:

<UNID> (STRING)

Benutzung der Konstanten NTPCONST_IMAGERESOURCE

 

<AttachmentName> (STRING)

Dateiname der Image-Resource (wie im "Lotus Domino Designer" angezeigt)

 

 

Rückgabe

 

<ErrorCode> (LONG)

Nummer des aufgetretenen Fehlers (0 = kein Fehler)