WP INSERT PICTURE

Home

4D v17

WP INSERT PICTURE


WP INSERT PICTURE ( AusschnittObj ; Bild ; Modus {; UpdateAusschnitt} )

Parameter	Typ	Beschreibung
AusschnittObj	Objekt	Objektausschnitt
Bild	Bild	Bildfeld oder -variable, oder Pfad zu Bildfeld auf der Festplatte
Modus	Lange Ganzzahl	Einfügemodus
UpdateAusschnitt	Lange Ganzzahl	Updatemodus für Ausschnitt

Beschreibung

Der Befehl WP INSERT PICTURE fügt das Bild in AusschnittObj mit dem in Modus und UpdateAusschnitt angegebenen Einfügemodus ein. Das Bild wird als Zeichen in AusschnittObj eingefügt.

In AusschnittObj übergeben Sie einen Ausschnitt.

In Bild 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, einen Pfadnamen in Bezug zur Strukturdatei der Anwendung übergeben. Sie können auch nur die Datendatei 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 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 die Position zum Einfügen des Bildes im Dokument:

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 Ziels ein
wk replace	Lange Ganzzahl	0	Ersetzt Inhalt in Ziel

Im optionalen Parameter UpdateAusschnitt übergeben Sie eine der folgenden Konstanten, ob das eingefügte Bild im Ausschnitt enthalten ist oder nicht:

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

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

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

WP Create picture range
WP INSERT DOCUMENT