4D v16
WP INSERT PICTURE
- 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
WP INSERT PICTURE
| WP INSERT PICTURE ( AusschnittObj ; Bild ; Modus {; UpdateAusschnitt} ) | ||||||||
| Parameter | Typ | Beschreibung | ||||||
| AusschnittObj | Objekt |
|
Objektausschnitt | |||||
| Bild | Bild, String |
|
Bildfeld oder -variable, oder Pfad zu Bildfeld auf der Festplatte | |||||
| Modus | Lange Ganzzahl |
|
Einfügemodus | |||||
| UpdateAusschnitt | Lange Ganzzahl |
|
Modus bei aktualisiertem Ausschnitt | |||||
Der Befehl WP INSERT PICTURE fügt das Bild in AusschnittObj mit dem in Modus angegebenen Einfügemodus ein. Das Bild wird als Zeichen in AusschnittObj eingefügt.
In AusschnittObj übergeben Sie einen gültigen Objektausschnitt von 4D Write Pro. Da AusschnittObj ein Teil eines 4D Write Pro Dokuments ist, lässt es sich über die Funktionen , WP Get bookmark range oder WP Get range erstellen.
In Bild können Sie folgendes übergeben:
- Referenz auf ein 4D Feld bzw. eine Variable vom Typ Bild
- oder String mit dem Pfad zu einer Bilddatei auf der Festplatte, in der Syntax des jeweiligen Betriebssystems.
Sie können den kompletten Pfadnamen, einen Pfadnamen in Bezug zur Strukturdatei der Anwendung oder nur die Datendatei übergeben. Im letzten Fall muss die Datei auf derselben Ebene wie die Strukturdatei der Datenbank liegen und es ist eine Dateiendung erforderlich.
Jedes von 4D unterstützte Bildformat ist verwendbar (siehe Abschnitt Überblick über Bilder). Die Liste der verfügbaren Bildformate erhalten Sie über den Befehl PICTURE CODEC LIST. Enthält Bild verschiedene Formate (Codecs), behält 4D Write Pro im Dokument nur ein Format für die Anzeige und ein Format zum Drucken bei (falls unterschiedlich). Es werden automatisch die am besten passenden Formate ausgewählt.
Im Parameter Modus übergeben Sie eine der folgenden Konstanten für den Einfügemodus des Bildes im Dokument:
| Konstante | Typ | Wert | Kommentar |
| wk append | Lange Ganzzahl | 2 | Fügt Inhalt am Ende des Ausschnitts ein |
| wk prepend | Lange Ganzzahl | 1 | Fügt Inhalt am Anfang des Ausschnitts ein |
| wk replace | Lange Ganzzahl | 0 | Ersetzt Inhalt des Ausschnitts |
Im optionalen Parameter UpdateAusschnitt übergeben Sie eine der folgenden Konstanten für Einfügen im Ausschnitt oder nicht:
| Konstante | Typ | Wert | Kommentar |
| wk exclude from range | Lange Ganzzahl | 1 | Eingefügter Inhalt wird nicht in aktualisierten Ausschnitt eingefügt |
| wk include in range | Lange Ganzzahl | 0 | Eingefügter Inhalt wird in aktualisierten Ausschnitt eingefügt (Standard) |
Ohne den Parameter UpdateAusschnitt wird das eingefügte Bild standardmäßig in den Ausschnitt eingefügt.
In diesem Beispiel kann der Benutzer das gewünschte Bild zum Einfügen in den Ausschnitt wählen und erhält eine Meldung, wenn das Bild nicht eingefügt werden konnte:
C_OBJECT($wpRange)
$wpRange:=WP Get selection([EXAMPLES]wpDoc)
C_BOOLEAN($fail)
$fail:=False
//Benutzer fragen, welches Bild von der Festplatte eingefügt werden soll
$imgRef:=Open document("")
//Bricht der Benutzer nicht ab
If(OK=1)
//Ist die Datei ein unterstütztes Bildformat
If(Is picture file(document))
// das vom Benutzer gewählte Bild einfügen
WP INSERT PICTURE($wpRange;document;wk replace)
Else
$fail:=True
End if
Else
$fail:=True
End if
//schlägt das Einfügen fehl, Meldung an Benutzer senden
If($fail)
ALERT("Einfügen des Bildes ist fehlgeschlagen")
End if
Produkt: 4D
Thema: 4D Write Pro Programmiersprache
Erstellt: 4D v16
4D Write Pro Handbuch ( 4D v16)
