Last updated

API / geotoolkit / widgets / overlays / AnnotationOverlay / AnnotationOverlay

Class: AnnotationOverlay<W>

overlays.AnnotationOverlay.AnnotationOverlay

Creates default implementation of the widget annotation overlay

Example

import {AnnotationOverlay, Events as Overlay} from '@int/geotoolkit/widgets/overlays/AnnotationOverlay';
import {log} from '@int/geotoolkit/base';
const overlay = new AnnotationOverlay(widget, {
'annotationcontainer': 'geotoolkit-plot-host'
})
.on(OverlayEvents.AnnotationAdded, (event, sender, eventArgs) => {
const annotation = eventArgs.getAnnotation();
log('Annotation ' + annotation.getText() + ' added');
log('Total annotations is: ' + sender.getAnnotations().toArray().length);
})
.on(OverlayEvents.AnnotationRemoved, (event, sender, eventArgs) => {
const annotation = eventArgs.getAnnotation();
log('Annotation ' + annotation.getText() + ' removed');
log('Total annotations is: ' + sender.getAnnotations().toArray().length);
});

Type parameters

NameType
Wextends BaseWidget = BaseWidget

Hierarchy

Table of contents

Constructors
Methods

Contents

Constructors

new AnnotationOverlay&lt;W&amp;gt;(widget, options)

new AnnotationOverlay<W>(widget, options?)

Creates annotation overlay

Throws

if 'overlay' is not provided or 'overlays' layer is not exist in the parent widget

Type parameters

NameType
Wextends BaseWidget<W> = BaseWidget

Parameters

Name Type Description
widgetWparent widget to add overlay
Optional optionsOptionsoptions

Overrides

AbstractOverlay&lt;W&amp;gt;.constructor

Methods

addAnnotation

addAnnotation(annotation): IAnnotation

Add annotation

Throws

Error if annotation is null

Parameters

Name Type Description
annotationIAnnotation | Annotationannotation object

Returns

IAnnotation


clearAnnotations

clearAnnotations(silent?): AnnotationOverlay<W>

Clear annotations

Parameters

Name Type Description
Optional silentbooleansilent mode, default is true

Returns

AnnotationOverlay<W>


dispose

dispose(): void

Disposes this node, once disposes a node should not be used anymore.
Clear all listeners, and disconnect styles to avoid memory leaks.
Also aggressively 'cleanup' this node by setting some of its members to null.

Returns

void

Overrides

AbstractOverlay.dispose


editAnnotation

editAnnotation(annotation): AnnotationOverlay<W>

Edit annotation, by default it starts embedded TextArea editor

Parameters

Name Type Description
annotationIAnnotationannotation to edit

Returns

AnnotationOverlay<W>

this


getActiveAnnotation

getActiveAnnotation(): IAnnotation

Return active annotation

Returns

IAnnotation

annotation


getAnnotations

getAnnotations(filter?): Iterator<IAnnotation>

Return iterator by child nodes

Parameters

Name Type Description
Optional filter(item: IAnnotation) => booleana filter function. Returns all nodes if null

Returns

Iterator<IAnnotation>


getClassName

getClassName(): string

Returns

string

Inherited from

AbstractOverlay.getClassName


getCss

getCss(): CssStyle

Return CSS style

Returns

CssStyle


getEditorContainer

getEditorContainer(): HTMLElement

Returns HTML container with inline editors

Returns

HTMLElement

HTMLElement


getEnabled

getEnabled(): boolean

Return enabled state

Returns

boolean

enabled state

Inherited from

AbstractOverlay.getEnabled


getModel

Protected getModel(): Group<Node>

Returns

Group<Node>


getOptions

getOptions(): OptionsType

Return options

Returns

OptionsType

object


getVisible

getVisible(): boolean

Return visibility state

Returns

boolean

visible state

Inherited from

AbstractOverlay.getVisible


getWidget

getWidget(): W

Returns widget

Returns

W

widget

Inherited from

AbstractOverlay.getWidget


hasEventListener

hasEventListener(type, callback?): boolean

Check if a list of event listeners for this type contains this listener

Parameters

Name Type Description
typestringtype of event or property
Optional callbackFunctionto be called, if null, check if any callback is registered

Returns

boolean

Inherited from

AbstractOverlay.hasEventListener


isDisposed

isDisposed(): boolean

Returns whether this object has been disposed

Returns

boolean

Inherited from

AbstractOverlay.isDisposed


isSilent

isSilent(): boolean

Return true if the event dispatcher doesn't notify any events

Returns

boolean

Inherited from

AbstractOverlay.isSilent


notify

notify<E>(type, source, args?): AnnotationOverlay<W>

Notify listeners

Type parameters

NameType
Eextends string

Parameters

Name Type Description
typeEevent types
sourceAnnotationOverlay<W>of the event
Optional argsEventMap[E]arguments of the event

Returns

AnnotationOverlay<W>

this

Overrides

AbstractOverlay.notify


off

off<E>(type?, callback?): AnnotationOverlay<W>

Detach listener on event. Calling .off() with no arguments removes all attached listeners. Calling .off(type) with no callback removes all attached listeners for specific type.

Type parameters

NameType
Eextends string

Parameters

Name Type Description
Optional typeEtype of the event
Optional callback(eventType: E, sender: AnnotationOverlay<W>, args: EventMap[E]) => voidfunction to be called

Returns

AnnotationOverlay<W>

this

Overrides

AbstractOverlay.off


on

on<E>(type, callback): AnnotationOverlay<W>

Attach listener on event that will be called whenever the specified event is delivered to the target

If the callback function is already in the list of event listeners for this target, the function is not added a second time.

If a particular anonymous function is in the list of event listeners registered for a certain target, and then later in the code, an identical anonymous function is given in an "on" call, the second function will also be added to the list of event listeners for that target.

Type parameters

NameType
Eextends string

Parameters

Name Type Description
typeEtype of event or property
callback(eventType: E, sender: AnnotationOverlay<W>, args: EventMap[E]) => voidto be called

Returns

AnnotationOverlay<W>

this

Overrides

AbstractOverlay.on


onStateChanged

Protected onStateChanged(state): AnnotationOverlay<W>

Parameters

Name Type Description
state"Visible" | "Enabled"overlay state

Returns

AnnotationOverlay<W>

this

Overrides

AbstractOverlay.onStateChanged


onUpdateGeometry

Protected onUpdateGeometry(): void

Returns

void


removeAnnotation

removeAnnotation(annotation): AnnotationOverlay<W>

Remove annotation

Parameters

Name Type Description
annotationIAnnotationannotation to be removed

Returns

AnnotationOverlay<W>

this


scrollToAnnotation

scrollToAnnotation(annotation): AnnotationOverlay<W>

Scroll to annotation

Parameters

Name Type Description
annotationIAnnotationannotation

Returns

AnnotationOverlay<W>


setActiveAnnotation

setActiveAnnotation(annotation): AnnotationOverlay<W>

Set active annotation

Parameters

Name Type Description
annotationIAnnotationannotation

Returns

AnnotationOverlay<W>


setCss

setCss(style, merge?): AnnotationOverlay<W>

Sets CSS style. This style will be applied for all inserted elements

Parameters

Name Type Description
styleTypeCSS style to be applied to inserted elements
Optional mergebooleanmerge flag

Returns

AnnotationOverlay<W>

this


setEnabled

setEnabled(enabled): AnnotationOverlay<W>

Set enabled state

Parameters

Name Type Description
enabledbooleanenable or disable tools

Returns

AnnotationOverlay<W>

this

Inherited from

AbstractOverlay.setEnabled


setOptions

setOptions(options): AnnotationOverlay<W>

Set options

Parameters

Name Type Description
optionsOptionsTypeoptions

Returns

AnnotationOverlay<W>


setOrientation

setOrientation(orientation): AnnotationOverlay<W>

Set orientation

Parameters

Name Type Description
orientationOrientationoverlay orientation

Returns

AnnotationOverlay<W>

this


setSilent

setSilent(bool): AnnotationOverlay<W>

Set silent mode

Parameters

Name Type Description
boolbooleanflag to enable silent mode

Returns

AnnotationOverlay<W>

this

Inherited from

AbstractOverlay.setSilent


setVisible

setVisible(visible): AnnotationOverlay<W>

Set visibility state

Parameters

Name Type Description
visiblebooleanvisibility of overlay

Returns

AnnotationOverlay<W>

this

Inherited from

AbstractOverlay.setVisible


getClassName

Static getClassName(): string

Returns

string

Inherited from

AbstractOverlay.getClassName


getGeometry

Static getGeometry(geometryName): Function

Return known geometry

Parameters

Name Type Description
geometryNamestringgeometry name

Returns

Function

extension geometry extension


registerGeometry

Static registerGeometry(geometryName, extension): void

Register geometry extension

Parameters

Name Type Description
geometryNamestringgeometry name
extensionFunctiongeometry extension

Returns

void