Im Unterschied zu einem Overlay behält ein Control seine Position auf der Karte bei, ein Overlay bewegt sich mit der Karte mit. Ein Control sollten sie also implementieren, wenn sie eine feste Position auf der Karte einnehmen wollen, wie in diesem Bespiel.
Ein Overlay stellt Daten in Abhängigkeit von der Karte dar, z.B. die Visualisierung einer BoundingBox, welche von geografischen Koordinaten abhängig ist. Das entsprechende Beispiel finden Sie in unserem Beispiel für ein BoundingBox-Overlay
Dieses Control dunkelt die Teile der Karte ab, die nicht zur Stage gehören und dient ausschließlich der Visualisierung. Ein Control verschiebt sich mit der Karte nicht mit, sondern liegt immer über der Karte. Das führt unter anderem dazu, die abgedunkelten Teile der Karte nicht auf MouseEvents reagieren.
Bei Benutzung der FalkMapStage
ohne diese Control reagiert natürlich die gesamte Karte auf MouseEvents.
Implementiert man dieses Feature nicht als Control sondern als FalkOverlay
, reagiert die gesamte
Karte auf MouseEvents, ein Beispiel dazu findet sich im Beispiel
FalkMap: BoundingBox Overlay.
Dieses Overlay verdeutlicht aber nicht die Arbeitsweise der FalkMapStage
.