MapOverlayManager

Manager für clientseitige Overlays, die über der Karte an einer "Geo-Position" dargestellt werden sollen.

Objekte dieser Klasse können nicht direkt erstellt werden. Eine Instanz steht unter der Eigenschaft overlays innerhalb eines MapAdapters oder des MapControls zur Verfügung.

Methods
Methods
add(overlay)

Fügt einen neues Overlay hinzu oder ersetzt ein bestehendes mit der gleichen Id. Sollen mehrere Overlays nacheinander eingefügt werden, wird empfohlen die Methoden suspendPainting und resumePainting vor bzw. nach dem Hinzufügen aufzurufen, um eine fortwährende Aktualisierung der Anzeige zu unterbinden.

		
  glbMap.overlays.add({
      id:"OVL_A",
      group:"POIS",
      zIndex:20,
      gx:5422344,
      gy:5612337,
      html:[
          "<div onclick='alert(\"Overlay angeklickt\");' ",
          "     style='position:absolute; border:1px solid white; background-color:red; ",
          "            color:white; font-weight:bold; cursor:pointer; text-align:center; ",
          "            width:20px; height:20px; top:-10px; left:-10px;'>",
          "#",
          "</div>"
      ]
  });
parameters
object overlay

Konfigurationsobjekt mit den Angaben:

double gx

X-Wert geografisch

double gy

Y-Wert geografisch

string|string[] html

HTML Fragment, welches auf der Karte angezeigt werden soll. Statt der String-Verkettung "Objekt "+id+" hier" empfiehlt sich aus Performancegründen die Array-Schreibweise ["Objekt ",id," hier"]. Ankerpunkt ist die linke obere Ecke. Um eine Zentrierung zu erreichen, muss mit passenden Style-Angaben gearbeitet werden (siehe Beispiel).

string [id]

Id für das Overlay, um es später gezielt zu löschen oder zu überschreiben. Wird keine Id angegeben, dann wird intern eine generische Id hochgezählt

string [group]

Gruppenname für das Overlay, um später gezielt alle Overlays einer Gruppe entfernen zu können

(Standardwert: "_DEFAULT_")
string [zIndex]

Z-Index für das Overlay

(Standardwert: 0)
getByGroup(group)

Gibt alle Overlays, mit dem angegebenen Gruppennamen zurück

parameters
string group

Gruppenname

getById(id)

Gibt das Overlay mit der angegebenen Id zurück

parameters
string id

Id des Overlays

paint()

Zeichnet die Overlays neu. Ein expliziter Aufruf dieser Methode ist i.d.R. nicht nötig, da die Methoden add, remove..., resumePainting dies mit tun.

remove(id)

Entfernt das Overlay mit der angegebenen Id

parameters
string id

Id des Overlays

removeAll()

Entfernt alle Overlays

removeGroup(group)

Entfernt alle Overlays, mit dem angegebenen Gruppennamen.

parameters
string group

Gruppenname

resumePainting()

Reaktiviert den automatischen Aufruf der Paint-Methode aus den übrigen Instanzmethoden und ruft einmal paint() auf.

suspendPainting()

Deaktiviert den automatischen Aufruf der Paint-Methode aus den übrigen Instanzmethoden. Diese Methode sollte vor dem Hinzufügen einer größeren Anzahl von Overlays aufgerufen werden.