WR INSERT PICTURE

Version 2004 (Geändert)

WR INSERT PICTURE (Bereich; Bild; Ziel; HorizPos; VertPos; Hinten; ErsteSeite)

Der Befehl WR INSERT PICTURE fügt ein Bild im 4D Write Dokument Bereich ein, definiert durch Ziel, HorizPos und VertPos.

Bild kann ein Datenfeld oder eine Variable vom Typ Bild sein. Ist der Inhalt des Parameters kein Bild, wird der Fehler Nummer 1065 zurückgegeben.

Mit dem optionalen Parameter Ziel definieren Sie, wo das Bild eingefügt wird.

• Soll das Bild in den Textfluss eingefügt werden, übergeben Sie in Ziel den Wert Null (0) oder geben Sie keinen Parameter an. Dann werden die anderen Parameter nicht verwendet. Das Bild wird am Einfügepunkt eingesetzt oder es ersetzt die aktuelle Auswahl.

• Soll das Bild auf der Seite eingefügt werden, verwenden Sie folgende Optionen:

- Bei Ziel größer 0 erscheint das Bild auf der Seite mit der Nummer Ziel. Der Wert in Ziel muss die Seitennumerierung berücksichtigen, wie sie in den Voreinstellungen definiert wurde.

- Bei Ziel gleich -11 wird das Bild in die Seite eingefügt und erscheint nur auf den rechten Seiten, wenn die Kopfteile für gerade und ungerade Seitennummern unterschiedlich sind; sonst auf allen Seiten.

- Bei Ziel gleich -12 wird das Bild in die Seite eingefügt und erscheint nur auf den linken Seiten, wenn die Kopfteile für gerade und ungerade Seitennummern unterschiedlich sind.

Die optionalen Parameter HorizPos und VertPos werden im aktuell eingestellten Standardwert für das Dokument angezeigt. Diese beiden Parameter setzen die Koordinaten der linken oberen Ecke des Bildes in Bezug auf die linke obere Ecke der Seite.

Mit dem optionalen Parameter Hinten definieren Sie, ob das Bild im Hintergrund oder im Vordergrund liegt.

• Bei Hinten gleich 1 liegt das Bild im Hintergrund. In diesem Fall müssen Sie auf die Attribute für Text- und Absatzhintergrund achten. Wählen Sie "Nichts" aus, ist das Bild hinter dem Text sichtbar.

• Bei Hinten gleich 0 erscheint das Bild im Vordergrund.

Der optionale Parameter ErsteSeite wird allein aus Kompatibilitätsgründen beibehalten. Sie sollten ihn ab Version 2004 nicht mehr verwenden.

(1) Das folgende Beispiel zeigt eine Objektmethode, die einer Schaltfläche zugeordnet ist. Damit fügen Sie ein 4D Bild in einen 4D Write Bereich ein und verkleinern es auf 50%.

   WR INSERT PICTURE(Bereich;Logo)    `Bild aus dem Feld Logo einfügen
   WR SELECT(Bereich;4;1)    `Bild auswählen
   WR GET PICTURE SIZE(Bereich;Vert;Horiz;pictPosition)    `Bildgröße abfragen
   WR SET PICTURE SIZE(Bereich;Vert*1/2;Horiz*1/2)    `Bild anpassen

(2) Ein Beispiel zum Einfügen eines Bildes in die Seite finden Sie unter dem Befehl WR SET PICTURE IN PAGE INFO.

WR DELETE PICTURE IN PAGE.