Image

Mit dem Image-Control können Sie einen Bildbereich bzw. einen leeren Rahmen vordefinieren, in den Sie eine Grafik einbinden können, um Ihre Dialoge individuell zu gestalten. Sie können dazu auch eine URL angeben, von der die angezeigte Grafik dynamisch geladen wird.

Als mögliche Grafikformate sind JPG, PNG, GIF, ICO und BMP vorgesehen. Die Grafik darf höchstens eine Größe von 50 KB haben.

Anmerkung: Beim Importieren der Grafik in den Dialog wird versucht, sie zu komprimieren bzw. sie wird in ein JPG-Format konvertiert. Die Maximalgröße 50 KB bezieht sich auf die konvertierte Grafik. Daher kann es sein, dass Sie eine Bitmap-Datei, die größer als 50 KB ist, trotzdem importiert werden kann, weil sie nach der Komprimierung 50 KB nicht mehr überschreitet.

Sollten Sie Grafiken benötigen, deren Größe 50 KB überschreitet, können Sie im ClassicDesk im Bereich Einstellungen auf der Registerkarte Optionen > Sonstiges im Feld Maximale Bildgröße die maximale Größe der Grafiken anpassen.



Wichtig: Bedenken Sie, dass große Grafiken das Öffnen des Dialogs deutlich verlangsamen können.

Eigenschaften

Neben den Standard-Eigenschaften hat dieses Control die folgenden Eigenschaften:

Image

Über diese Eigenschaft wählen Sie die Grafik aus, die in den Dialog eingefügt werden soll.

Wählen Sie die Schaltfläche ... am Ende der Zeile und wählen Sie im Auswahldialog die gewünschte Grafik aus.



SizeMode

Diese Eigenschaft bestimmt, in welcher Weise die eingefügte Grafik im Control positioniert wird.

Die verfügbaren Werte sind im Dropdownmenü ausgelistet.



Beispielhaft wird im Folgenden eine Grafik der Größe 58 x 80 Pixel



in einem Image-Control mit fester Größe (150 x 100 Pixel) positioniert.



Wert Ergebnis Beispiel
Normal Die Grafik wird in ihrer Originalgröße links oben ausgerichtet im Control positioniert.

Achtung: Ist die Grafik größer als das Control, wird sie nicht ganz angezeigt.
StrechImage Die Grafik wird sowohl in der Länge als auch in der Breite auf den kompletten Bereich des Controls gestreckt.

Achtung: Dabei wird u. U. das Seitenverhältnis verändert.
AutoSize Die Größe des Controls wird auf die Größe der Grafik angepasst.

Achtung: Dabei gehen die von Ihnen eingestellten Werte der Eigenschaften „Height“ und „Width“ verloren.
CenterImage Die Grafik wird sowohl in der Höhe als auch in der Breite im Control zentriert.

Hinweis: Die Größe der Grafik wird dabei nicht verändert.
Zoom Die Grafik wird so in das Control eingefügt, dass sie es bestmöglich ausfüllt, das Seitenverhältnis aber beibehalten wird.

URL

Über diese Eigenschaft können Sie die URL einer Internetseite eingeben, von der die anzuzeigende Grafik dynamisch geladen werden soll. Die Grafik wird so im Control positioniert, wie es über die Eigenschaft „SizeMode“ definiert wird.

Merke: Verwenden Sie die vollständige URL inkl. „https://www...“.

Methoden

Für dieses Control stehen keine Methoden zur Verfügung.

Tastenkombinationen

Für dieses Control stehen keine Tastenkombinationen zur Verfügung.