NTPInitFromDatabase ( <ReportName>, <ServerName>, <DatabaseName>, <ShowHideMessages> ) -> <ErrorCode>

 

 

Beschreibung

 

Initalisierung eines neuen Reports. Die Funktion liefert als Rückgabe ein Handle (Report-Handle), mit dem alle anderen Funktionen diesen neu erstellten Report ansprechen können. Die meisten Funktionen von NotesToPaper erwarten als ersten Parameter dieses Report-Handle. Das Report-Handle behält solange seine Gültigkeit, bis der Report entweder über NTPCancel abgebrochen oder mit NTPProcessReport... ausgeführt wurde. Mit diesem Befehl kann nur ein neuer Report initialisiert werden, dessen Reportlayout in einer Datenbank gespeichert ist. Soll hingegen das Reportlayout von der Dateiebene benutzt werden, so ist der Befehl NTPInit zu benutzen.

 

 

Deklaration für Lotus Script

 

Declare Function NTPInitFromDatabase Lib "NTP.DLL" ( ByVal ReportName As String, ByVal ServerName As String, ByVal DatabaseName As String, ByVal ShowHideMessages As Long ) As Long

 

 

Parameter

 

<ReportName> (STRING)

Der Name des Reports, der gedruckt werden soll. Der Name kann entweder fest hinterlegt oder durch den Befehl NTPReportList oder NTPReportListFromDatabase durch den Endanwender bestimmt werden. Der hier angegebene Name ist der Name unter dem der Report in NotesToPaper Setup angelegt wurde.

 

<ServerName> (STRING)

Name des Servers auf dem die Datenbank liegt aus der das Reportlayout geholt werden soll. Wird ein leerer Inhalt übergeben, handelt es sich um eine lokale Datenbank. Der Servername sollte in der Form übergeben werden, wie er von der Klasse "NotesDatabase" zurückgeliefert wird.

 

<DatabaseName> (STRING)

Name der Datenbank die die Reportlayouts enthält. Der Datenbankname kann Unterverzeichnisse enthalten und muss relativ zum Notes-Daten-Verzeichnis angegeben werden (z. B. "Demo\Ntp.Nsf")

 

<ShowHideMessages> (LONG)

Modus für die Ausgabe von Fehlermeldungen. Mögliche Werte:

NTPPROCESS_SHOWMESSAGES

NTPPROCESS_HIDEMESSAGES

 

 

Rückgabe

 

<ErrorCode> (LONG)

Ist der <ErrorCode> negativ, so ist ein Fehler aufgetreten. Ein Rückgabewert >=0 ist das Report-Handle für die weiteren Befehle wie z. B. NTPSendField.