4D v16
Per Programmierung auf Dokumentinhalte zugreifen
- 4D Write Pro Handbuch
-
- 4D Write Pro Programmiersprache
-
- Über 4D Write Pro Objekte
- Befehle aus dem Kapitel Objekte (Formulare) verwenden
- Befehle aus dem Kapitel Mehrfachstil Text verwenden
- Per Programmierung auf Dokumentinhalte zugreifen
- 4D Write Pro Konstanten
- WP CREATE BOOKMARKNew
- WP DELETE BOOKMARKNew
- WP EXPORT DOCUMENT
- WP EXPORT VARIABLE
- WP GET ATTRIBUTES
- WP Get bookmark rangeNew
- WP GET BOOKMARKSNew
- WP Get page countNew
- WP Get paragraphs
- WP Get pictures
- WP Get range
- WP Get selection
- WP Import document
- WP INSERT BREAKNew
- WP INSERT DOCUMENTNew
- WP INSERT PICTURENew
- WP Is font style supported
- WP NewUpd
- WP PRINTUpd
- WP RESET ATTRIBUTES
- WP SELECT
- WP SET ATTRIBUTES
- WP USE PAGE SETUP
- 4D Write Pro Attribute
Per Programmierung auf Dokumentinhalte zugreifen
4D Write Pro bietet einen ganzen Satz Befehle, um Attribute für Text und Bilder in Ihren Dokumenten zu verwalten. Damit können 4D Entwickler für 4D Write Pro Dokumente eigene Benutzeroberflächen gestalten, z.B. mit Schaltflächen, Menüs, Optionsfeldern. Befehle lassen sich auf das ganze Dokument oder spezifische Ausschnitte anwenden, die entweder durch eine Benutzerauswahl oder über eigene Werte definiert werden. Verfügbare Eigenschaften sind Einheit des Dokuments, Ränder, Füllen, Hintergrund, Einstellungen für Absatz, Farben, Schriften, Schriftstile und Bildeigenschaften.
Das Objekt der Objektbibliothek 4D Write Pro Area beispielsweise verwendet einige dieser Funktionalitäten für eine ansprechende Benutzeroberfläche in 4D Write Pro:
Es gibt mehrere Befehle zum Verwalten von Auswahlen im Dokument. Da ausgewählter Text nicht-sichtbare Tags für Formatierung enthalten kann, arbeitet 4D Write Pro mit Ausschnitten. Ein Ausschnitt ist ein Objekt, das einen Teil in einem 4D Write Pro Dokument darstellt.
- WP Get range( wpArea ; StartAusschnitt ; EndeAusschnitt ) -> objAusschnitt: Gibt einen neuen Ausschnitt mit den Parametern für Start und Ende zurück.
- ( {*;} wpArea ) -> objAusschnitt: Gibt einen neuen Ausschnitt gemäß der aktuellen Benutzerauswahl zurück.
- WP Get pictures( objAusschnitt ) -> objAusschnitt: Gibt einen neuen Ausschnitt zurück, der nur die Bilder enthält.
- WP Get paragraphs( objAusschnitt ) -> objAusschnitt: Gibt einen neuen Ausschnitt zurück, der nur die Absätze enthält.
- WP SELECT( {*;} wpArea {; objAusschnitt}{; StartAusschnitt ; EndeAusschnitt} ): Wählt den Text, der zum Ausschnitt gehört.
4D Write Pro ermöglicht, dynamische Referenzen, genannt Lesezeichen, zu Ausschnitten anzulegen und einzusetzen. Sie werden einem spezifischen Ausschnitt in einem 4D Write Pro Dokument zugeordnet.
Lesezeichen sind dynamisch, d.h. wenn der Benutzer Text, der zum Lesezeichen gehört, verschiebt, erweitert und verkleinert, wird der zugeordnete Bereich automatisch aktualisiert und das Lesezeichen bezieht sich weiterhin auf denselben Ausschnitt im Dokument. Hierzu ein Beispiel:
- Sie erstellen ein Lesezeichen mit Namen "MyBM" zum Text "Hallo Welt" auf Seite 20 im Dokument.
- Dann fügen Sie zu Beginn des Dokuments 50 Seiten hinzu
- Über das Lesezeichen "MyBM" können Sie weiterhin automatisch auf den gleichen Text "Hallo Welt" zugreifen, jetzt auf Seite 70 des Dokuments
Ein Dokument kann eine unbegrenzte Zahl an Lesezeichen haben. Im gleichen Ausschnitt sind mehrere Lesezeichen möglich und Lesezeichen Ausschnitte können sich auch überlappen. Lesezeichen werden nicht mit den Befehlen MissingRef oder WP New importiert (Lesezeichen im Zieldokument lassen sich nicht überschreiben).
Ein angelegtes Lesezeichen wird im Dokument gespeichert. Lesezeichen werden mit dem Dokument gesichert und lassen sich über verschiedene Befehle verwalten. Sie können auch als Referenzteile einer Vorlage dienen. Diese Teile werden dann automatisch mit Daten aus der Anwendung zusammengefügt, um dynamische Ausgabedokumente, wie z.B. Rechnungen oder Kataloge zu erstellen.
Es gibt verschiedene Befehle zum Verwalten von Lesezeichen:
- WP CREATE BOOKMARK erstellt ein neues Lesezeichen von einem Ausschnitt
- erhält alle definierten Lesezeichen in einem Dokument
- WP Get bookmark range findet einen Ausschnitt über ein vorhandenes Lesezeichen
- WP DELETE BOOKMARK löscht ein Lesezeiche
Diese Befehle können die verschiedenen Attribute des Dokuments erhalten oder setzen:
- WP SET ATTRIBUTES( objAusschnitt | wpDoc ; attribName ; attribWert {; attribName2 ; attribWert2 ; ... ; attribNameN ; attribWertN} ): setzt ein oder mehrere Attribut/Wert Paare im Dokument oder Ausschnitt.
- WP GET ATTRIBUTES( objAusschnitt | wpDoc ; attribName ; attribWert {; attribName2 ; attribWert2 ; ... ; attribNameN ; attribWertN} ): erhält den aktuellen Wert der Attribute im Dokument oder Ausschnitt.
- WP RESET ATTRIBUTES( objAusschnitt ; attribName {; attribName2 ; ... ; attribNameN } ): setzt die Attributwerte im Dokument oder Ausschnitt erneut.
Weitere Informationen dazu finden Sie im Abschnitt 4D Write Pro Attribute.
Diese Funktion meldet, ob ein bestimmter Stil für den Ausschnitt unterstützt wird:
- WP Is font style supported( objAusschnitt ; wpSchriftStil ) -> wahr oder falsch: Meldet, ob ein Ausschnitt einen bestimmten Stil unterstützt (hilfreich zum Gestalten einer Oberfläche).
Produkt: 4D
Thema: 4D Write Pro Programmiersprache
Geändert: 4D v16
4D Write Pro Handbuch ( 4D v16)
