Programmatische Verwaltung von Kopf- und Fußzeilen in 4D Write Pro

Wir haben mehrere Kundenanfragen erhalten, ob es möglich ist, die Vorlage4D Write Pro mit Kopf- und Fußzeilen zu verwenden, um andere Dokumente auf der Grundlage dieser Vorlage zu erstellen. Nun, wir haben Sie erhört und dies ist in 4D v16 R5 verfügbar.

4D Write Pro wurde um eine Reihe neuer Befehle erweitert, um diese Anforderung zu erfüllen. Einige dieser Befehle können verwendet werden, um Verweise auf Kopf-, Körper- und Fußzeilen in Dokumenten zu erhalten. Andere sind praktisch, um einen Verweis auf den Rahmen (Kopfzeile, Fußzeile usw.) zu erhalten, in dem sich der Cursor gerade befindet, oder um den Cursor auf einen bestimmten Rahmen zu setzen.

Beispiel Datenbank

Einen Verweis auf Kopf- oder Fußzeilen oder den Textkörper erhalten

Neue 4D-Befehle – WP Get header, WP Get body und WP Get footer – wurden hinzugefügt, damit Entwickler einen Verweis auf eine beliebige Kopf- oder Fußzeile für das Dokument oder für einen bestimmten Abschnitt erhalten können.

Diese Referenzen können dann verwendet werden, um zugehörige Bereiche zu erhalten, Dokumente zu erstellen usw. Das Ziel ist es, den Inhalt eines beliebigen Rahmens (ganz oder teilweise) zu kopieren und in einen anderen Rahmen desselben Dokuments oder in ein anderes neues oder bestehendes Dokument einzufügen.

Code-Beispiel

// Get the header from a template and put it in the header of the main document
$source:=WP Get header(mytemplate;1) // first section
$rangeSource :=WP Get range($source;wk start text;wk end text)
$tempoc :=WP New($rangeSource)

$target :=WP Get header(myDocument;1) // first section
$rangeTarget :=WP Get range($target;wk start text;wk end text)
WP INSERT DOCUMENT ($rangeTarget;$tempoc;wk replace)

Den Cursor auf einen bestimmten Rahmen setzen

Bei der Erstellung umfangreicher Dokumente durch Programmierung möchten Sie vielleicht nacheinander einige Informationen zuerst in die Kopfzeile, dann in die Fußzeile und schließlich wieder in den Hauptteil des Dokuments einfügen. Das bedeutet, dass Sie eine Möglichkeit brauchen, um in den verschiedenen Dokumentrahmen zu navigieren.

Der Befehl WP Get frame wird verwendet, um den Verweis auf den Rahmen zu erhalten, in dem sich der Cursor gerade befindet: Kopfzeile, erste Kopfzeile, Hauptteil, erste Fußzeile usw. Der Befehl WP SET FRAME hat die umgekehrte Funktion. Er platziert den Cursor innerhalb eines bestimmten Rahmens , sofern dieser Rahmen im Dokument vorhanden ist.

Code-Beispiele

Nehmen wir an, Sie möchten den Cursor in die Hauptkopfzeile bewegen:

WP SET FRAME(*; "WParea";wk current section default header)

Wenn Sie sicherstellen wollen, dass der Benutzer den Cursor in eine Kopf- oder Fußzeile gesetzt hat:

$frame:=WP Get frame(*; "WParea")
If ($frame=wk body)
ALERT ("Bitte wählen Sie eine Fußzeile oder eine Kopfzeile aus")
End if