<<

Inhaltsverzeichnis

Suchen

>>

 

LOAD_PICTURE

 

 

Funktion

 

 

Syntax:

LOAD_PICTURE(<Zeile>,<Spalte>,<Höhe in Zeilen>,<Breite in Spalten>,<Modus>,<Löschen>,<Bildname>

[,<Handle>,<Vom Server Laden>])

 

<Zeile>

= <NUM-AUSDRUCK>

<Spalte>

= <NUM-AUSDRUCK>

<Höhe in Zeilen>

= <NUM-AUSDRUCK>

<Breite in Spalten>

= <NUM-AUSDRUCK>

<Modus>

= <NUM-AUSDRUCK>

<Löschen>

= <NUM-AUSDRUCK>

<Bildname>

= <STRING-AUSDRUCK>

<Handle>

= <NUM-AUSDRUCK>

<Vom Server Laden>

= <NUM-AUSDRUCK>

 

 

Bedeutung:

Zeigt ein Bild am Bildschirm an.

 

LOAD_PICTURE liefert folgende Ergebniswerte:

 

0: kein Fehler

-1: Fenster nicht gefunden

7500: Bild nicht gefunden

 

Achtung: NOREPAINT hat keine Wirkung bei LOAD_PICTURE im Html-Programm.

 

<Zeile> und <Spalte> legen die Position fest, an der sich die linke obere Ecke des Bildes befindet.

 

<Höhe in Zeilen> und <Breite in Spalten> legen die Größe in Zeilen und Spalten fest, in der das Bild dargestellt werden soll. Diese beiden Parameter haben nur eine Bedeutung bei <Modus> = 1.

 

<Handle> legt fest, in welchem Fenster das Bild angezeigt wird. <Handle> kann die Windowtiefe oder die Identifizierungsnummer eines Splitwindows oder eines WINDOWCALL-Windows enthalten. Fehlt der Parameter <Handle>, so wird das Bild auf der aktuellen Maske angezeigt.

 

Über die Variable EBUS_PAINT wird gesteuert, wann das Bild angezeigt wird. Ist EBUS_PAINT <> -1, so wird das Bild beim Zeichnen des Bildschirm als erstes gezeichnet. Das bedeutet, das nachfolgende Zeichenfunktionen wie z.B. FILLRECT das Bild überschreiben. Ist EBUS_PAINT = -1, so wird das Bild in der Reihenfolge der Zeichenfunktionen ausgeführt.

 

Beispiel 1:
EBUS_PAINT = 0

H% = FILLRECT(...)

H% = LOAD_PICTURE(...)

Das Bild wird vor FILLRECT(..) gezeichnet und möglicherweise von FILLRECT(...) überdeckt.

 

Beispiel 2:

EBUS_PAINT = -1

H% = FILLRECT(...)

H% = LOAD_PICTURE(...)

Zuerst wird FILLRECT(..) ausgeführt und dann LOAD_PICTURE. Das Bild überdeckt möglicherweise den von FILLRECT gezeichneten Bereich.

 

Es können auch Bilder über das WEB geladen werden. Dazu muss der <Bildname> mit einem der folgenden Präfixe beginnen:

 

http:

https:

ftp:

ftps:

 

Parameter:

Zeile

Zeilenposition der linken oberen Ecke des Bildes

 

Spalte

Spaltenposition der linken oberen Ecke des Bildes

 

Höhe in Zeilen

Höhe des Bildes in Zeilen. Dieser Parameter hat nur eine Bedeutung bei <Modus> = 1.

 

Breite in Spalten

Breite des Bildes in Spalten. Dieser Parameter hat nur eine Bedeutung bei <Modus> = 1.

 

Modus

0: Das Bild wird in der Originalgröße angezeigt.

1: Das Bild wird auf die durch <Höhe in Zeilen> und <Breite in Spalten> festgelegte Größe vergrößert oder verkleinert.

2: Das Bild füllt das gesamte aktuelle Window bzw. Mainwindow aus. Es wird dabei automatisch vergrößert bzw. verkleinert. <Zeile> und <Spalte> haben in diesem Fall keine Bedeutung.

 

Löschen

Dieser Parameter legt fest, ob bereits vorhandene Bilder im aktuellen Window gelöscht werden sollen.

 

Ist <Löschen> = 1, so werden alle im aktuellen Window vorhandenen Bilder gelöscht, bevor das neue Bild angezeigt wird.

 

Ist <Löschen> = 2, so wird nur das Bild an Position <Zeile>,<Spalte> gelöscht.

 

Ist <Löschen> <> 1 und <> 2, so werden keine Bilder gelöscht.

 

Achtung: Wird ein Bild an derselben Position und mit denselben Parametern wie ein vorheriges Bild geladen und wird das alte Bild nicht gelöscht, so liegen dann zwei Bilder übereinander.

 

Bildname

Name des Bildes

 

Bei Html-Programmen muss das Bild mit #ADD_IMAGE bereitgestellt werden wenn <Vom Server Laden> = 0 ist.

 

Handle

Enthält die Windowtiefe oder die Identifizierungsnummer eines Splitwindows oder eines WINDOWCALL-Windows.

 

Vom Server Laden

Legt bei 2T-Programmen fest, ob das Bild vom Server oder Client geladen werden soll. Normalerweise werden die Bilder vom Client geladen. Ist <Vom Server Laden> = 1, so wird das Bild vom Server geladen und an den Client übertragen. Das Fehlen dieses Parameters ist gleichbedeutend mit <Vom Server Laden> = 0.

 

Beispiel:

H% = LOAD_PICTURE(5,10,0,0,0,0,"Photo.jpg")

IF H% <> 0

THEN ... Fehler ...

ENDIF

 

Siehe auch:

MOVE_PICTURE

REMOVE_PICTURE

IMAGE_TRANSPARENTCOLOR

PLAY_PICTURES

EBUS_PAINT

EBUS_PICTURE_CACHING