WP INSERT PICTURE

Home

4D v20 R7

WP INSERT PICTURE


WP INSERT PICTURE ( targetObj ; picture ; mode {; rangeUpdate} )

Parameter	Typ	Beschreibung
targetObj	Objekt	Range oder Element oder 4D Write Pro Dokument
picture	Bild	Bildfeld oder -variable, oder Pfad zu Bildfeld auf der Festplatte
mode	Lange Ganzzahl	Einfügemodus
rangeUpdate	Lange Ganzzahl	Updatemodus für Range

Beschreibung

Der Befehl WP INSERT PICTURE fügt picture in targetObj ein, gemäß den Parametern mode und rangeUpdate. Das Bild wird als Zeichen in targetObj eingefügt.

In targetObj übergeben Sie:

Range
Element (Tabelle / Zeile / Absatz / Haupt- / Kopf- / Fußteil / Bild im Textfluß / Abschnitt / Unterabschnitt) oder
4D Write Pro Dokument.

In picture können Sie folgendes übergeben:

Feld oder Variable vom Typ Bild oder
Dateipfad (String) zu einer Bilddatei auf der Festplatte, in der Syntax des jeweiligen Betriebssystems.
Sie können den kompletten Pfadnamen oder einen Pfadnamen in Bezug zur Strukturdatei der Anwendung übergeben. Sie können auch nur den Dateinamen angeben, dann 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 picture 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 mode übergeben Sie eine der folgenden Konstanten für den Einfügemodus:

Konstante	Typ	Wert	Kommentar
wk append	Lange Ganzzahl	2	Fügt Inhalt am Ende des Ziels ein
wk prepend	Lange Ganzzahl	1	Fügt Inhalt am Anfang des Elements ein
wk replace	Lange Ganzzahl	0	Ersetzt Inhalt in Ziel

Ist targetObj ein Range, können Sie im optionalen Parameter rangeUpdate eine der folgenden Konstanten übergeben, ob das eingefügte Bild im Range enthalten ist oder nicht:

Konstante	Typ	Wert	Kommentar
wk exclude from range	Lange Ganzzahl	1	Eingefügter Inhalt ist nicht im aktualisierten Range enthalten
wk include in range	Lange Ganzzahl	0	Eingefügter Inhalt ist im aktualisierten Range enthalten (Standard)

Ohne den Parameter rangeUpdate ist das eingefügte Bild standardmäßig im Range enthalten.

Ist targetObj kein Range, wird rangeUpdate ignoriert.

Beispiel

In diesem Beispiel kann der Benutzer das gewünschte Bild zum Einfügen in den Range 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

Siehe auch

Download HDI database
WP INSERT DOCUMENT
WP Picture range