Laden eigener Icons

Owned by Matthias Thiele
Last updated: Aug. 20, 2019

Icons finden Ihren Einsatz fast überall innerhalb des Viewers. Grundsätzlich werden alle benötigten Icons innerhalb der Jadice Document Platform bereitgestellt. Es ist jedoch ohne Probleme möglich eigene Icons in den Viewer zu integrieren. 

Zusammengehörige Icons werden geordnet in einer PNG-Datei im Ressourcen-Ordner des Projekts abgelegt. Theoretisch sind auch andere Formate möglich, jedoch eignet sich das Format PNG aufgrund der Transparenz besonders gut. Es bietet sich außerdem der Einfachheit halber an, alle Icons gleichgroß zu gestalten.

basicIcons.png - Beispieldatei mit Icons

Neben der PNG-Datei muss ebenfalls eine gleichnamige Properties-Datei im selben Verzeichnis existieren. In dieser kann der Name der Icons, sowie die Größe und Position festgelegt werden.

Am Anfang der Datei steht immer die Dateiendung der zugehörigen Bilddatei (siehe Beispiel-Konfigurationsdatei). Daraufhin kann in jeder Zeile ein Icon definiert werden. Die Syntax der Definition sieht folgendermaßen aus:

Mit "$" gekennzeichnete Zeichen müssen angepasst werden

icon.$iconName.rectangle=$x,$y,$w,$h

In diesem Beispiel sind alle Icons 24x24 Pixel groß. 

basicIcons.properties - Konfigurationsdatei zu der Icon-Bilddatei
extension=png

icon.OPEN.rectangle=0,0,24,24
icon.SAVE.rectangle=24,0,24,24
icon.CLOSEDOC.rectangle=48,0,24,24
icon.INFO.rectangle=72,0,24,24


icon.PREVPAGE.rectangle=0,24,24,24
icon.NEXTPAGE.rectangle=24,24,24,24
icon.FIRSTPAGE.rectangle=48,24,24,24
icon.LASTPAGE.rectangle=72,24,24,24

Daraufhin können die Icons durch folgenden Code geladen werden:

Laden eines Icons
final IconManager iconManager = IconManager.getInstance("/annotations/icons/basicIcons");
final Icon icon = iconManager.getIcon("OPEN");

Verwandte Artikel