Modul: HTMLUI

Klasse, die es ermöglicht den Inhalte zu steuern, die im Bereich liegen, der das HTML User Interface hostet.

Methoden

focus

()

Verfügbar ab Version Applet: 9.0bwj, AppServer: 84904

Bringt das Fenster der App (App-Popup bzw. Chat-Fenster) in den Vordergrund. (Applet-only)

Beispiel:

var hostFrame = Client.getHostFrame();
hostFrame.focus();

getAppViewMode

() String

Verfügbar ab Version Applet: 9.0byl

Liefert den aktuell verwendeten AppViewMode. z.B. 'POPUP', 'OVERLAY', 'HEADERBAR'

Rückgabewert:

Beispiel:

var hostFrame = Client.getHostFrame();
var appViewMode = hostFrame.getAppViewMode();

getBrowserType

() String

Verfügbar ab Version Applet: 9.0bzp

Liefert den aktuell verwendeten Browser-Type (Nur Applet). z.B. 'JFX', 'JX', ansonsten undefined. Dies kann verwendet werden um für den veraltenden JFX-Browser eine Sonderbehandlung einzubauen.

Rückgabewert:

Beispiel:

var hostFrame = Client.getHostFrame();
var browserType = hostFrame.getBrowserType();

getBrowserVersion

() String

Verfügbar ab Version STAPP: b210331

Liefert die Versionsnummer des aktuell verwendeten (JX oder JFX) Browsers (nur STAPP), ansonsten undefined.

Rückgabewert:

Beispiel:

var hostFrame = Client.getHostFrame();
var browserVersion = hostFrame.getBrowserVersion();

setBackgroundColor

(
  • newColor
  • [durationMillis]
)

Ändert die sichtbare Hintergrundfarbe des Hostframes animiert. (Android-only)

Parameter:

  • newColor Client.Color

    Neue Farbe

  • [durationMillis] Number optional

    Millisekunden, die die Animation dauern soll. (default: 200)

Beispiel:

var hostFrame = Client.getHostFrame();
var color = Client.Color.fromRGB(0, 200, 80);
hostFrame.setBackgroundColor(color, 1000);

setIcons

(
  • path
)

Verfügbar ab Version Applet: 9.0bwj, AppServer: 84904

Setzt die Icons, die als Fenster-Icon angezeigt werden sollen. (Applet-only, nur mit AppViewMode.Popup) Die Bilder müssen von groß nach klein sortiert sein. Die größeren Bilder werden (je nach System) automatisch dann eingesetzt, wenn größere Bilder benötigt werden (z.B. in der Task-Leiste, oder beim Alt+Tab Fenster-Wechsel).

Parameter:

  • path String multiple

    Pfad zum Bild (Varargs...)

Beispiel:

var hostFrame = Client.getHostFrame();
hostFrame.setIcons('http://apps2.knuddels.biz/kimg/smileys/sm_elf_007_ball_trans.gif', 'http://apps2.knuddels.biz/kimg/smileys/sm_dice.b.gif');

setMaxSize

(
  • width
  • height
)

Setzt die maximale Größe des App-Fensters (AppViewMode.Popup oder AppViewMode.Global). Diese Einstellung hat auf manchen Clients keine Auswirkung.

Parameter:

Beispiel:

var hostFrame = Client.getHostFrame();
hostFrame.setMaxSize(400, 400);

setMinSize

(
  • width
  • height
)

Setzt die minimale Größe des App-Fensters (AppViewMode.Popup oder AppViewMode.Global). Diese Einstellung hat auf manchen Clients keine Auswirkung.

Parameter:

Beispiel:

var hostFrame = Client.getHostFrame();
hostFrame.setMinSize(400, 400);

setResizable

(
  • resizable
)

Setzt, ob das Fenster resizable ist. (Applet-only, nur mit AppViewMode.Popup)

Parameter:

Beispiel:

var hostFrame = Client.getHostFrame();
hostFrame.setResizable(true);

setSize

(
  • width
  • height
)

Verfügbar ab Version Applet: 9.0bwj, AppServer: 84516

Ändert die Größe des App-Fensters (AppViewMode.Popup), App-Overlays (AppViewMode.Overlay) oder der App-Headerbar (AppViewMode.Headerbar).

Hinweis: Für den Modus Headerbar-Modus wird die Breitenangabe ignoriert. Hier kann z.B. einfach 0 übergeben werden.

Parameter:

  • width Number

    Breite (bisher nur STAPP: 0 = nicht verändern / alten Wert beibehalten)

  • height Number

    Höhe (bisher nur STAPP: 0 = nicht verändern / alten Wert beibehalten)

Beispiel:

var hostFrame = Client.getHostFrame();
hostFrame.setSize(800, 600);

setTitle

(
  • newTitle
)

Setzt den Titel der HTML-UI. Es gibt mehrere Möglichkeiten den Title zu setzen. Diese Titel werden in folgender Priorisierung angewendet:

  1. HostFrame.setTitle()
  2. vom Server übermittelter Titel (wird nur beim Pageload ausgewertet)
  3. Titel im <title> Tag bzw. document.title (wird nur beim Pageload ausgewertet)

Parameter:

Beispiel:

var hostFrame = Client.getHostFrame();
hostFrame.setTitle('Mein Spiel...');