Das Element <img> fügt ein Bild ein.
Das Bild kann als externe oder eingelagerte Ressource referenziert werden. Ebenso können Referenzen auf Bild-Register (Bildobjekte) dazu verwendet werden, um in Abhängigkeit vom Objekttyp (Klassen- oder Instanzobjekt) unterschiedliche Bilder anzuzeigen.
Hinweis:
Pfadangaben zu externen Bilddateien werden wie Formeln ausgewertet und sind deshalb grundsätzlich in einfache Anführungszeichen zu fügen. Erlaubte Pfadangaben sind:
<img src="'T:/image.png'">
<img src="='T:/image.png'">
<img src="'images/image.png'">
<img src="='images/image.png'">
<img src="'T:\\image.png'">
<img src="='T:\\image.png'">
<img src="'images\\image.png'">
<img src="='images\\image.png'">
Server können nicht referenziert werden, beispielsweise mit <img src="'//SRV01.MyDomain.local/images/image.png'">
Attributname | Verwendung | Attributwerte | Defaultwert | Beschreibung |
---|---|---|---|---|
src | benötigt | absoluter oder relativer Pfad | absolute oder relative Pfadangabe zu einem extern gelagerten Bild, ausgehend vom Installationsverzeichnis oder Pfad zum Bildobjekt des eingelagerten Bilds | |
tooltip | optional | Text oder Form-UI des einzublendenden Tooltips (siehe tooltip) | ||
visible | optional | true,false | true | true = Bild ist sichtbar false = Bild ist unsichtbar |
Erlaubte Unterelemente | Anzahl |
---|---|
tooltip | 0..1 |
Bildobjekte können mit Methoden manipuliert werden. Diese Methoden können beliebig kombiniert werden.
Methode | Beispiel | Beispielcode |
---|---|---|
disable | <img src="type('Documentation_UI_Configuration.ProjectLibrary.HelpObjects.Images.delta_abc').image.disable"/> | |
flipH | <imgsrc="type('Documentation_UI_Configuration.ProjectLibrary.HelpObjects.Images.delta_abc').image.flipH"/> | |
flipV | <imgsrc="type('Documentation_UI_Configuration.ProjectLibrary.HelpObjects.Images.delta_abc').image.flipV"/> | |
rotate180 | <imgsrc="type('Documentation_UI_Configuration.ProjectLibrary.HelpObjects.Images.delta_abc').image.rotate180"/> | |
rotate270 | <imgsrc="type('Documentation_UI_Configuration.ProjectLibrary.HelpObjects.Images.delta_abc').image.rotate270"/> | |
rotate90 | <imgsrc="type('Documentation_UI_Configuration.ProjectLibrary.HelpObjects.Images.delta_abc').image.rotate90"/> | |
scale | <imgsrc="type('Documentation_UI_Configuration.ProjectLibrary.HelpObjects.Images.delta_abc').image.scale(2)"/> |
Hinweis:
Für neue Form-UIs sollten nur noch Referenzen auf Bildobjekte verwendet werden.
Absolute Pfadangabe zu einer externen Bilddatei:
<line>
<img src="='C:\\Users\\Public\\EPLAN\\
EngineeringConfiguration\\2_4_20140218_0227\\install\\
icon-collection\\Rumpf.png'"/>
</line>
Ergebnis:
Relative Pfadangabe zu einer externen Bilddatei:
Referenz zu einer eingelagerten Bilddatei (siehe auch image):
<line>
<img src="type('Documentation_UI_Configuration.
ProjectLibrary.HelpObjects.Images.delta_abc').image"/>
</line>
Ergebnis:
Referenz auf ein Bild-Register, um das Bild für ein Klassenobjekt anzuzeigen (siehe auch image):
<line>
<img src="type('Documentation_UI_Configuration.
ProjectLibrary.HelpObjects.Images.nav_next').
image(this,ref('Documentation_UI_Configuration.
Mechatronic.Documentation').type)"/>
</line>
Ergebnis:
Referenz auf ein Bild-Register, um das Bild für ein Instanzobjekt anzuzeigen (siehe auch image):
<line>
<img src="type('Documentation_UI_Configuration.
ProjectLibrary.HelpObjects.Images.nav_next').
image(this,ref('Documentation_UI_Configuration.
Mechatronic.Documentation'))"/>
</line>
Ergebnis: