API / geotoolkit / charts / widgets / ChartWidget / ChartWidget
widgets.ChartWidget.ChartWidget
ChartWidget extends AnnotatedWidget and provides API for storing, showing and synchronizing different charts.
Example
import {Data} from '@int/geotoolkit/charts/Data';
import {ChartType} from '@int/geotoolkit/charts/ChartType';
import {ChartWidget} from '@int/geotoolkit/charts/widgets/ChartWidget';
import {AnnotationLocation} from '@int/geotoolkit/layout/AnnotationLocation'
const data = new Data({…});
const widget = new ChartWidget({
'data': data,
'axes': {
'xAxis-1': { // axis identifier, see geotoolkit/charts/Axis for options
'location': AnnotationLocation.South,
'min': 0,
'grid': {
'visible': false
}
},
'yAxis-1': {…}
}
});
// add charts based on the data provided (see :
widget.addChart({
'type': ChartType.LineChart,
// data series identifiers
'series': {
'x': 'data-series-1',
'y': 'data-series-2'
},
// connect to the axis:
'axes': {
'x': 'xAxis-1',
'y': 'yAxis-1'
}
});↳
ChartWidget
Constructors
Methods
Css Properties
| Name | Type | Description |
|---|---|---|
selectionmode | SelectionMode | Selection mode for tooltip, selection and crosshair tools. It shows how to highlight charts and display tooltip |
usedesiredoffset | boolean | Use getDesiredOffset from AbstractChart to calculate limits |
Constructors
• new ChartWidget(options?)
ChartWidget extends AnnotatedWidget and provides API for storing, showing and synchronizing different charts
| Name | Type | Description |
|---|---|---|
Optional options | Options | widget options |
AnnotatedWidget.constructor
Methods
▸ addAxis(axis, location, connectedObject?): Object
add new axis and connect with object
| Name | Type | Description |
|---|---|---|
axis | Axis | Options | new axis instance or options |
location | AnnotationLocation | location of annotation for adding new axis |
Optional connectedObject | Group<Node> | connected object of axis |
Object
▸ addAxis(options, location, connectedObject?): Object
add new axis and connect with object
| Name | Type | Description |
|---|---|---|
options | PolarAxisOptions | polar axis options |
location | PolarAnnotationLocation | location of annotation for adding new axis |
Optional connectedObject | Group<Node> | connected object of axis |
Object
AnnotatedWidget.addAxis
▸ addBaseLayer(baseLayer): ChartWidget
Add baseLayer to container
this
▸ addChart(options): ChartWidget
Adds chart to the widget
Example
import {ChartType} from '@int/geotoolkit/charts/ChartType';
// setup data series:
widget.setDataSource([{
'id': 'Manufacturing',
'data': [1, 2, 3, ...]
}, {
'id': 'Sales & Distribution',
'data': [10, 20, 30, ...]
}]);
...
widget.addChart({
'type': ChartType.LineChart,
'series': {
'y': 'Manufactoring'
}
});| Name | Type | Description |
|---|---|---|
options | ChartOptions | chart options |
this
▸ addChild(node): ChartWidget
Add a child node
this
▸ addCssClass(cssclass): ChartWidget
Adds new css class to node
| Name | Type | Description |
|---|---|---|
cssclass | string | string[] | css class name('s) |
this
▸ addInvalidateHandler(handler): ChartWidget
Add invalidate handler
Deprecated
since 4.0, use Node.on instead
| Name | Type | Description |
|---|---|---|
handler | Function | handler to be notified about invalidation |
this
AnnotatedWidget.addInvalidateHandler
▸ addLegend(options): LegendPanel
Creates legend, scrollable panel and interactive tools for the options provided. If legend already exists, does nothing.
Example
widget.addLegend({
// use known types to create legend items automatically (from charts)
// use custom string item for user setup
'type': LegendType.Color3d,
'alignment': AnchorType.LeftTop,
'offset': new Point(60, 40)
});| Name | Type | Description |
|---|---|---|
options | LegendOptions | LegendPanel | legend options |
▸ Protected addLegendInteral(options): LegendPanel
| Name | Type |
|---|---|
options | LegendOptions | LegendPanel |
AnnotatedWidget.addLegendInteral
▸ addOverlay(overlay): ChartWidget
Add overlay to container
this
▸ addTitle(location, options): void
Add title to annotation
| Name | Type | Description |
|---|---|---|
location | AnnotationLocation | of the title |
options | TitleOptions | title options |
void
▸ adjustPosition(area?, vAlign?, hAlign?): ChartWidget
Adjust position of node to specified area
| Name | Type | Description |
|---|---|---|
Optional area | Rect | specified area. Default to Parent Model Limits |
Optional vAlign | string | vertical alignment. It can be "top", "bottom", "center". Defaults to "top". |
Optional hAlign | string | horizontal alignment It can be "left", "right", "center". Defaults to "left". |
this
AnnotatedWidget.adjustPosition
▸ Protected applyOpacity(context): ChartWidget
This method is called to apply opacity if it is specified on the rendering context. The default implementation sets global alpha on the rendering context
| Name | Type | Description |
|---|---|---|
context | RenderingContext | Rendering Context |
this
▸ Protected applyResponsiveStyle(): void
Apply a responsive style rules it is exists
void
AnnotatedWidget.applyResponsiveStyle
▸ beginExport(): ChartWidget
Prepares object before exporting and saving state
▸ canSwapAxes(axis1, axis2): boolean
Check if swapping axes is doable.
Invalid swap cases are:
a) axis(-es) ID(s) is(are) not defined;
b) axis(-es) doesn't (don't) belong to the widget;
c) the pair of axes represent "x" and "y" dimensions, and one of the axes is shared between two or more charts in the widget while the other ones differ.
boolean
▸ changeBaseLayerOrder(overlay, order, anchor?): ChartWidget
Changes the z-order of the baseLayer.
| Name | Type | Description |
|---|---|---|
overlay | Node | |
order | NodeOrder | position to be added |
Optional anchor | Node | anchor node to specify changeOrder with respect to this node |
this
AnnotatedWidget.changeBaseLayerOrder
▸ changeChartOrder(chart, order, anchor?): ChartWidget
Changes order of the charts being rendered.
| Name | Type | Description |
|---|---|---|
chart | AbstractChart | any chart added to the widget |
order | NodeOrder | position to be added |
Optional anchor | AbstractChart | anchor chart to specify changeOrder with respect to this chart |
this
▸ changeChildOrder(node, order, anchor?): ChartWidget
changes the z-order of the nodes being rendered.
| Name | Type | Description |
|---|---|---|
node | Node | any child added in the Composite node |
order | NodeOrder | position to be added |
Optional anchor | Node | anchor node to specify changeOrder with respect to this node |
this
AnnotatedWidget.changeChildOrder
▸ changeOverlayOrder(overlay, order, anchor?): ChartWidget
Changes the z-order of the overlay.
| Name | Type | Description |
|---|---|---|
overlay | Node | child overlay |
order | NodeOrder | position to be added |
Optional anchor | Node | anchor node to specify changeOrder with respect to this node |
this
AnnotatedWidget.changeOverlayOrder
▸ checkCollision(context): boolean
Check culling Returns true if object is inside of renderable area
| Name | Type | Description |
|---|---|---|
context | RenderingContext | Rendering Context |
boolean
true if node is collided
AnnotatedWidget.checkCollision
▸ clear(): ChartWidget
▸ clearBaseLayers(disposeBaseLayers?): ChartWidget
Remove all child baseLayers from group
| Name | Type | Description |
|---|---|---|
Optional disposeBaseLayers | boolean | automatically dispose baseLayers. If it is true then method dispose is called for each baseLayer, false by default |
this
AnnotatedWidget.clearBaseLayers
▸ clearCache(): ChartWidget
Clear cache
this
▸ clearCharts(): ChartWidget
Removes all charts
this
▸ clearChildren(disposeChildren?): ChartWidget
Remove all child nodes from this composite group
| Name | Type | Description |
|---|---|---|
Optional disposeChildren | boolean | automatically dispose children. If it is true then method dispose is called for each child. |
this
▸ clearOverlays(disposeOverlays?): ChartWidget
Remove all child overlays from group
| Name | Type | Description |
|---|---|---|
Optional disposeOverlays | boolean | automatically dispose overlays. If it is true then method dispose is called for each overlay, false by default |
this
All subclasses should override copyConstructor or provide custom implementation for this method
clone
▸ connect(object, model, orientation?, autoSize?): ChartWidget
Synchronizes object with a model
| Name | Type | Description |
|---|---|---|
object | Axis | Group<Node> | object to be synchronized |
model | Group<Node> | AbstractChart | source model |
Optional orientation | Orientation | horizontal or vertical |
Optional autoSize | boolean | true if object and model share the same device size in the orientation, true by default if not specified |
this
▸ connectStyle(style, type, callback): ChartWidget
Connects style.
This convenience method subscribes a listener to given style for the specified type.
And automatically un-subscribes listener if node is disposed to prevent memory leaks
| Name | Type | Description |
|---|---|---|
style | EventDispatcher | connect style |
type | string | type of event or property |
callback | AttributeCallback<EventDispatcher> | function to be called |
this
▸ connectTool(tool): ChartWidget
Connect a new tool with a toolname to the widget
| Name | Type | Description |
|---|---|---|
tool | AbstractTool | AbstractTool[] | tool associated with the widget |
this
▸ Protected copyConstructor(src, deepCopy?): ChartWidget
Copy constructor function.
Function used as part of the cloning mechanism.
Implementations should copy the given instance state to this instance.
this
AnnotatedWidget.copyConstructor
▸ disconnect(object): ChartWidget
Disconnect an object from its source model
this
▸ disconnectStyle(style, type, callback): ChartWidget
Disconnect style
This convenience method un-subscribes a listener to given style for the specified type.
| Name | Type | Description |
|---|---|---|
style | EventDispatcher | connect style |
type | string | type of event or property |
callback | AttributeCallback<EventDispatcher> | function to be called |
this
AnnotatedWidget.disconnectStyle
▸ disconnectTool(tool): ChartWidget
Disconnect the tool from the widget
| Name | Type | Description |
|---|---|---|
tool | AbstractTool | AbstractTool[] | tool to disconnect |
this
AnnotatedWidget.disconnectTool
▸ dispose(): void
Dispose node. Clear all listeners and disconnect style to avoid memory leaks
void
▸ Protected drawBorder(localContext, bounds?): ChartWidget
Draws a rectangle at the bounding box (in parent coordinates)
| Name | Type | Description |
|---|---|---|
localContext | RenderingContext | The local rendering context |
Optional bounds | Rect | group bounds |
this
▸ enableClipping(doClip): ChartWidget
Enables or disables clipping of this node. If enabled, shapes will not be rendered outside of its bounds.
| Name | Type | Description |
|---|---|---|
doClip | boolean | enable clipping on this node |
this
AnnotatedWidget.enableClipping
▸ enableEventPropagation(enable): ChartWidget
Enable event propagation from the node hierarchy from bottom to top
This option is similar to DOM Event bubbling, which allows to get any event from child node. By default it is disabled for better performance.
Example
import {Group} from '@int/geotoolkit/scene/Group';
import {Events as SceneEvents} from '@int/geotoolkit/scene/Node';
const parentGroup = new Group()
.setName('ParentGroup')
.enableEventPropagation(true);
const childGroup = new Group()
.setName('ChildGroup');
parentGroup.addChild(childGroup);
parentGroup.on(SceneEvents.Invalidate, (eventName, sender, args) => {
// Got notifications from all children of parent group
});
childGroup.invalidate();| Name | Type | Description |
|---|---|---|
enable | boolean | enable |
this
AnnotatedWidget.enableEventPropagation
▸ enablePickingChildren(enable): ChartWidget
Enables or disables picking children
| Name | Type | Description |
|---|---|---|
enable | boolean | enable picking children |
this
AnnotatedWidget.enablePickingChildren
▸ endExport(): void
Restores object's state after exporting
void
▸ enumerateNodes(callback, target?): void
Executes a provided function once for each child node
| Name | Type | Description |
|---|---|---|
callback | Callback<Node> | provided function |
Optional target | QueryBuilder<any> | target to pass to callback as a second parameter |
void
AnnotatedWidget.enumerateNodes
▸ execute(delegate): ChartWidget
Executes delegate and return the result. It allows us to keep all initialization calls in one place,
and we do not need to scroll up or down in IDE to find how and where it was initialized.
Example
// All setters (.setName() for example) returns reference to the this.
// In order to modify inner object like LineStyle or Pattern, to get this object (property) we should call getter to get object reference.
// Then modify it as shown below in Option 1 or you can use execute methods shown in Option 2.
import {Group} from '@int/geotoolkit/scene/Group';
import {Rect} from '@int/geotoolkit/util/Rect';
// Option 1
const group = new Group()
.setName('MyGroup')
.setBounds(new Rect(0, 0, 42, 16))
.enableClipping(true)
.setTag({'type': 'sometype'});
group.getLineStyle().setPattern('pattern');
return group;
// Options 2 ( using execute method )
return group
.execute(function () {
this.getLineStyle()
.setPattern("pattern");
});| Name | Type | Description |
|---|---|---|
delegate | (this: ChartWidget) => void | Function to execute |
The result if any or this
▸ execute<T>(delegate): T
| Name |
|---|
T |
| Name | Type |
|---|---|
delegate | (this: ChartWidget) => T |
T
▸ exportToPdf(options?): Promise<IWritable>
Export a part of the container to PDF
This method sets automatically export scale and limits based on input parameters and current model scale and limits
| Name | Type | Description |
|---|---|---|
Optional options | ExportToPdfOptions | option to specify paper parameters and header and footer |
Promise<IWritable>
promise with output stream
▸ Protected filter(context): boolean
Filter node
| Name | Type | Description |
|---|---|---|
context | RenderingContext | Rendering Context |
boolean
flag filter flag ("true" to render node; "false" otherwise)
▸ fitToBounds(): ChartWidget
fit bounds to model limits
Fires
Events.ModelVisibleLimitsChanged
this
▸ getAnimationStyle(): AnimationStyle
Return animation style
animationStyle current animation style
AnnotatedWidget.getAnimationStyle
▸ getAnnotation(location): Group<Node>
return the node at the specific annotation
| Name | Type | Description |
|---|---|---|
location | AnnotationLocation | position to return the node for |
▸ getAnnotationSize(): Required<AnnotationSize>
Return sizes of all annotations or the exact one
Required<AnnotationSize>
contains size of all annotations
AnnotatedWidget.getAnnotationSize
▸ getAnnotationSize(loc): string | number
| Name | Type |
|---|---|
loc | AnnotationLocation |
string | number
AnnotatedWidget.getAnnotationSize
▸ getAutoModelLimitsMode(): boolean
Get Model Limits Logics to use when no Model Limits have been set set to true: will use parents width and height, starting at 0 set to false: will use parents bounds
boolean
mode
AnnotatedWidget.getAutoModelLimitsMode
▸ getAutoModelLimitsStrategy(): ModelLimitsStrategy
Get Model Limits Logics Strategy
strategy
AnnotatedWidget.getAutoModelLimitsStrategy
▸ getAxis(): Record<string, Axis>
Record<string, Axis>
▸ getAxis(id): Axis
| Name | Type |
|---|---|
id | string |
▸ getBaseLayer(index): Node
Return baseLayer at specified index
| Name | Type | Description |
|---|---|---|
index | number | index at which to get the baseLayer for |
track
▸ getBaseLayers<S>(predicate, modify?): Iterator<Node>
Return iterator by baseLayers nodes
| Name | Type |
|---|---|
S | extends Node<S> |
| Name | Type | Description |
|---|---|---|
predicate | (value: Node) => value is S | a filter function |
Optional modify | boolean | An option to specify if the iterator supports adding/removing items from the collection. false by default. |
▸ getBaseLayers(filter?, modify?): Iterator<Node>
Returns an iterator for child baseLayers. The iterator does not support adding or deleting items from overlays by default. If it is necessary to modify a collection of overlays, pass true as the last parameter.
Example
// Gets a writable iterator
const it = node.getOverlays(null, true);| Name | Type | Description |
|---|---|---|
Optional filter | (node: Node) => boolean | A filter function. Returns all overlays if null. |
Optional modify | boolean | An option to specify if the iterator supports adding/removing items from the collection. false by default. |
An iterator for child overlays.
▸ getBaseLayersCount(): number
Returns amount of baseLayers
number
AnnotatedWidget.getBaseLayersCount
▸ getBounds(): Rect
Get the bounds in the parents model space. If bounds are not set, then parent model limits are used.
current bounds
▸ getCache(): Cache
Return cache strategy to be used to cache children nodes
cache
▸ getCenterModelLimits(): Rect
Return model limits
annotated model limits
AnnotatedWidget.getCenterModelLimits
▸ getChart(id): AbstractChart
Returns chart by index or its name
| Name | Type | Description |
|---|---|---|
id | string | number | LegendItem | index of the chart (if number) or chart name (if string) or legend item (if LegendItem) |
▸ getChartsCount(): number
Returns total number of charts
number
▸ getChild(i): Node
Return node by index
| Name | Type | Description |
|---|---|---|
i | number | index of the node |
▸ getChildren<S>(predicate, modify?): Iterator<S>
Return iterator by child nodes
| Name | Type |
|---|---|
S | extends Node<S> |
| Name | Type | Description |
|---|---|---|
predicate | (value: Node) => value is S | a filter function |
Optional modify | boolean | An option to specify if the iterator supports adding/removing items from the collection. false by default. |
Iterator<S>
▸ getChildren(filter?, modify?): Iterator<Node>
Returns an iterator for child nodes. The iterator does not support adding or deleting items from children by default. If it is necessary to modify a collection of children, pass true as the last parameter.
Example
// Gets a writable iterator
const it = node.getChildren(null, true);| Name | Type | Description |
|---|---|---|
Optional filter | (node: Node) => boolean | A filter function. Returns all nodes if null. |
Optional modify | boolean | An option to specify if the iterator supports adding/removing items from the collection. false by default. |
An iterator for child nodes.
▸ getChildrenCount(): number
Return number of child nodes
number
AnnotatedWidget.getChildrenCount
▸ getClassName(): string
string
▸ getClipStyle(): ClipStyle
Gets the current clipping style
clipping style
▸ getColorBar(id): ColorBar
Returns color bar shape for the colorbar-typed axis, null if axis not found
| Name | Type | Description |
|---|---|---|
id | string | number | color bar identifier |
▸ getColorbars(): Record<string | number, ColorBar>
Returns id => colorbar map object for current colorbar axes
Record<string | number, ColorBar>
▸ getContentOrientation(): Orientation
Return content orientation
content orientation
AnnotatedWidget.getContentOrientation
▸ getContentsArea(transformation?): Rect
Return area without paddings. Model limits are mapped to content area, where children are layout.
| Name | Type | Description |
|---|---|---|
Optional transformation | Transformation | scene transformation |
AnnotatedWidget.getContentsArea
▸ getContentsTransform(): Transformation
getContentsTransform() retrieves the world transformation of the node.
transformation from model coordinates to bounds of the group
AnnotatedWidget.getContentsTransform
▸ getCss(): CssStyle
Return CSS style
▸ getCssClass(): string
Returns css class name to be used to apply CSS style
string
the css class name
▸ getCssClasses(): string[]
Gets list of css class names which applied to this node
string[]
▸ getCssTransform(): string
Returns CSS transformation
string
AnnotatedWidget.getCssTransform
▸ getData(data?): object
get options
| Name | Type | Description |
|---|---|---|
Optional data | unknown | how to extract data, null by default |
object
▸ getDataSource(): DataSource
Returns current data source
▸ getDesiredHeight(): string | number
Returns desired height of the group as a layoutable object This method is a helper method to get access to getLayoutStyle()
string | number
desired height ("undefined" by default)
AnnotatedWidget.getDesiredHeight
▸ getDesiredWidth(): string | number
Returns desired width of the group as a layoutable object. This method is a helper method to get access to getLayoutStyle()
string | number
desired width ("undefined" by default)
AnnotatedWidget.getDesiredWidth
▸ getDeviceLimits(): Rect
Return device limits
AnnotatedWidget.getDeviceLimits
▸ getExportElement(options?): CompositeDocumentElement
Returns exportable element
| Name | Type | Description |
|---|---|---|
Optional options | ExportElementOptions | options |
return exportable element
AnnotatedWidget.getExportElement
▸ getExportLimits(): Rect
Return export limits
AnnotatedWidget.getExportLimits
▸ getExportScale(): Object
Gets export scale. By default scale is not set and equal to screen scale
Object
scale
| Name | Type | Description |
|---|---|---|
x | number | scale by x form model to device |
y | number | scale by y form model to device |
AnnotatedWidget.getExportScale
▸ Protected getExportState(): Record<string, any>
Returns export state
Record<string, any>
export state
AnnotatedWidget.getExportState
▸ getFillStyle(): FillStyle
Return fill style
fillStyle current fill style
▸ getId(): string | number
Returns the associated identifier of the node
string | number
The node's id
▸ getInfiniteMode(): boolean
Return infinity mode flag
boolean
flag
AnnotatedWidget.getInfiniteMode
▸ Protected getInvalidateMethod(): AttributeCallback<EventDispatcher>
Gets invalidate method
AttributeCallback<EventDispatcher>
method to invalidate this object
AnnotatedWidget.getInvalidateMethod
▸ getLayout(): Layout
Returns layout associated with the group
layout
▸ getLayoutStyle(): LayoutStyle<string | number>
return desired layout style
LayoutStyle<string | number>
AnnotatedWidget.getLayoutStyle
▸ getLegend(type?): Legend
Returns current legend shape
| Name | Type |
|---|---|
Optional type | string |
▸ getLegendLayer(): Group<Node>
Returns layer to keep legend on top of widget
AnnotatedWidget.getLegendLayer
▸ getLegendPanel(type?): ScrollablePanel
Returns scrollable panel containing current legend shape
| Name | Type |
|---|---|
Optional type | string |
▸ getLegendPanels(): Record<string, ScrollablePanel>
Returns existing legend panels with its type string as key
Record<string, ScrollablePanel>
▸ getLegendVisible(type?): boolean
Returns true if legend is enabled and visible
| Name | Type | Description |
|---|---|---|
Optional type | string | legend type to check |
boolean
▸ getLegends(): Record<string, Legend>
Returns existing legends with its type string as key
Record<string, Legend>
▸ getLineStyle(): LineStyle
Return border style
▸ getLocalTransform(): Transformation
Retrieves the transformation of bounds to parent
transform the local transform.
AnnotatedWidget.getLocalTransform
▸ getManipulatorLayer(): CompositeNode<Node>
return manipulator layer
AnnotatedWidget.getManipulatorLayer
▸ getMarginsStyle(): SpaceStyle<string | number>
Return margins style
SpaceStyle<string | number>
AnnotatedWidget.getMarginsStyle
get model node
▸ getModelLimits(): Rect
Gets model limits, the limits of this groups inside space
the current model limits
AnnotatedWidget.getModelLimits
▸ getName(): string
Returns the node name
string
The node name
▸ getOpacity(): number
Returns current node opacity
number
opacity
▸ getOpacityBlendMode(): BlendMode
Returns current node opacity
opacity blend mode
AnnotatedWidget.getOpacityBlendMode
▸ getOverlay(index): Node
Return overlay at specified index
| Name | Type | Description |
|---|---|---|
index | number | index at which to get the overlay for |
track
▸ getOverlayAt(index): Node
Return overlay at specified index
Deprecated
since 4.2 use getOverlay instead
| Name | Type | Description |
|---|---|---|
index | number | index at which to get the overlay for |
track
▸ getOverlayLayer(): Layer<Node>
Returns manipulator overlay to draw shapes that should move with the model
AnnotatedWidget.getOverlayLayer
▸ getOverlays<S>(predicate, modify?): Iterator<Node>
Return iterator by overlays nodes
| Name | Type |
|---|---|
S | extends Node<S> |
| Name | Type | Description |
|---|---|---|
predicate | (value: Node) => value is S | a filter function |
Optional modify | boolean | An option to specify if the iterator supports adding/removing items from the collection. false by default. |
▸ getOverlays(filter?, modify?): Iterator<Node>
Returns an iterator for child overlays. The iterator does not support adding or deleting items from overlays by default. If it is necessary to modify a collection of overlays, pass true as the last parameter.
Example
// Gets a writable iterator
const it = node.getOverlays(null, true);| Name | Type | Description |
|---|---|---|
Optional filter | (node: Node) => boolean | A filter function. Returns all overlays if null. |
Optional modify | boolean | An option to specify if the iterator supports adding/removing items from the collection. false by default. |
An iterator for child overlays.
▸ getOverlaysCount(): number
Returns amount of overlays
number
AnnotatedWidget.getOverlaysCount
▸ getPaddingStyle(): SpaceStyle<string | number>
Return padding style
SpaceStyle<string | number>
padding
AnnotatedWidget.getPaddingStyle
▸ getParent(): Node
Return parent node
parent node
▸ getPreferredSize(): Rect
Return preferred size to layout children
AnnotatedWidget.getPreferredSize
▸ getProperties(context?): OptionsOut
Returns properties
| Name | Type | Description |
|---|---|---|
Optional context | ISerializationContext | serialization context |
properties
▸ getProperty(name): any
Gets dynamic property by name. These properties can be used as a property bags
| Name | Type | Description |
|---|---|---|
name | string | property name |
any
▸ getPropertyKeys(): string[]
Returns known properties keys
string[]
AnnotatedWidget.getPropertyKeys
▸ getRenderingFilter(): IFilter
Return filter to be used for rendering and picking
current filter
AnnotatedWidget.getRenderingFilter
▸ getResponsiveStyle(): ResponsiveStyle
Return responsive style
AnnotatedWidget.getResponsiveStyle
▸ getRoot(): Node
Returns root node.
If node doesn't have parent then it returns itself.
the root node
▸ getScaleScrollStrategy(): Delegate
Gets ScaleScrollStrategy ("undefined" by default)
ScaleScrollStrategy (see "setScaleScrollStrategy" description for more info)
AnnotatedWidget.getScaleScrollStrategy
▸ getSceneTransform(): Transformation
Returns transformation from node to root scene
a transformation from node to root scene
AnnotatedWidget.getSceneTransform
▸ getSelectionMode(): SelectionMode
Returns selection mode for tooltip, selection and crosshair tools
▸ getSelectionRadius(): number
Returns selection tool radius
number
▸ getTag(): any
Returns the object associated with the node by user.
any
The node's user-object
▸ getTitle(): Object
Gets title properties of the widget
Object
| Name | Type | Description |
|---|---|---|
location? | AnnotationLocation | Location of title |
text? | string | Title text |
textstyle? | TextStyle | Text style |
visible? | boolean | Visibility of title |
▸ getTool(): CompositeTool
Returns root tool associated to this widget
▸ getToolByName<T>(toolName): Tools[T]
Returns the tool matching the given name.
This function also accepts tool 'path' instead of absolute name.
For example:
getToolByName("compositeTool.panningTools.trackPanning.TrackPanning")
Would return the same tool as
getToolByName("TrackPanning")
As long as there is only one tool named "TrackPanning" in this composite
See listToolsNames()
| Name | Type |
|---|---|
T | extends string |
| Name | Type | Description |
|---|---|---|
toolName | T | The tool name or path |
Tools[T]
▸ getToolByType(toolType): AbstractTool
Returns the tool matching the given type. or null if nothing is matching the tool type
For example:
getToolByType(geotoolkit.controls.tools.Selection)
Would return the same tool as
getToolByName("pick")
| Name | Type | Description |
|---|---|---|
toolType | ClassType<any> | toolType of the tool |
▸ getToolsOptions(): ToolsOptionsOut
Gets Tools Options
JSON which defines tools options
AnnotatedWidget.getToolsOptions
▸ getVisible(): boolean
Return visibility of the node
boolean
true if node is visible
▸ getVisibleCenterModelLimits(ignoreModelLimits?): Rect
Returns visible model limits of the center model
| Name | Type | Description |
|---|---|---|
Optional ignoreModelLimits | boolean | flag defines whether to ignore model limits or not. By default this option is false and visible limits will be intersected with center model limits |
AnnotatedWidget.getVisibleCenterModelLimits
▸ getVisibleDeviceLimits(ignoreModelLimits?): Rect
Return visible device limits
| Name | Type | Description |
|---|---|---|
Optional ignoreModelLimits | boolean | flag defines whether to ignore ModelLimits or not |
AnnotatedWidget.getVisibleDeviceLimits
▸ getVisibleModelLimits(ignoreModelLimits?): Rect
Return visible model limits
| Name | Type | Description |
|---|---|---|
Optional ignoreModelLimits | boolean | flag defines whether to ignore ModelLimits or not |
AnnotatedWidget.getVisibleModelLimits
▸ getWorldTransform(): Transformation
Retrieves the local transformation of the node which represents multiplication of parent to bounds and contents transformations.
AnnotatedWidget.getWorldTransform
▸ getZIndex(): number
Returns node z-index (null if not set)
number
▸ hasCssClass(cssClass): boolean
Check if node has specified css class
| Name | Type | Description |
|---|---|---|
cssClass | string | css class name |
boolean
▸ hasEventListener(type, callback?): boolean
Check if a list of event listeners for this type contains this listener
| Name | Type | Description |
|---|---|---|
type | string | type of event or property |
Optional callback | Function | to be called, if null, check if any callback is registered |
boolean
AnnotatedWidget.hasEventListener
▸ hitTest(area, radius?): AbstractChart[]
Returns array of charts in provided area (in device)
▸ indexOfBaseLayer(baseLayer): number
Return index of overlay ( index of the specified child or -1 if baseLayer is not found)
| Name | Type | Description |
|---|---|---|
baseLayer | Node | baseLayer to check index |
number
AnnotatedWidget.indexOfBaseLayer
▸ indexOfChart(chart): number
Returns index of a chart (index of the specified chart or -1 if chart is not found)
| Name | Type | Description |
|---|---|---|
chart | AbstractChart | chart to check index |
number
▸ indexOfChild(node): number
Return index of child ( index of the specified child or -1 if node is not found)
| Name | Type | Description |
|---|---|---|
node | Node | node to check index |
number
▸ indexOfOverlay(overlay): number
Return index of overlay ( index of the specified child or -1 if overlay is not found)
| Name | Type | Description |
|---|---|---|
overlay | Node | overlay to check index |
number
AnnotatedWidget.indexOfOverlay
▸ Protected initializeFloatingAnnotationTool(): FloatingAnnotationTool
AnnotatedWidget.initializeFloatingAnnotationTool
▸ initializeLayout(settings): Group<Node>
| Name | Type |
|---|---|
settings | Options |
AnnotatedWidget.initializeLayout
▸ Protected initializeTools(options?): ChartWidget
function call in the constructor to initialize tools in the widget
This widget contains by default :
- All default tools in AnnotatedWidget
- ToolTipTool
- LegendTool
- All default tools in ScrollablePanel, namely:
-> Panning
-> HorizontalScroll
-> VerticalScroll
| Name | Type | Description |
|---|---|---|
Optional options | Options | tools options |
this
AnnotatedWidget.initializeTools
▸ insertAxis(axisIndex, axis, location, connectedObject?): Object
Insert new axis and connect with object
| Name | Type | Description |
|---|---|---|
axisIndex | number | desired axis index |
axis | Axis | Options | new axis instance or options |
location | AnnotationLocation | location of annotation for adding new axis |
Optional connectedObject | Group<Node> | connected object of axis |
Object
▸ insertAxis(axisIndex, options, location, connectedObject?): Object
Insert new axis and connect with object
| Name | Type | Description |
|---|---|---|
axisIndex | number | desired axis index |
options | PolarAxisOptions | polar axis options |
location | PolarAnnotationLocation | location of annotation for adding new axis |
Optional connectedObject | Group<Node> | connected object of axis |
Object
AnnotatedWidget.insertAxis
▸ insertBaseLayer(index, baseLayer): ChartWidget
Insert child baseLayer at specified index
| Name | Type | Description |
|---|---|---|
index | number | specified index |
baseLayer | Node | a baseLayer to add |
this
AnnotatedWidget.insertBaseLayer
▸ insertChart(index, options): ChartWidget
Inserts chart at specified index
| Name | Type | Description |
|---|---|---|
index | number | specified index |
options | ChartOptions | chart options |
this
▸ insertChild(index, node): ChartWidget
Insert child node at specified index
| Name | Type | Description |
|---|---|---|
index | number | specified index |
node | Node | a child node to add |
this
▸ insertOverlay(index, overlay): ChartWidget
Insert child overlay at specified index
| Name | Type | Description |
|---|---|---|
index | number | specified index |
overlay | Node | a overlay to add |
this
▸ invalidate(bounds?, force?): ChartWidget
Invalidate node
| Name | Type | Description |
|---|---|---|
Optional bounds | Rect | optional rectangular area to be invalidated, or force flag if rectangle is empty |
Optional force | boolean | optional boolean parameter that can force invalidation |
this
▸ invalidateLayout(propagate?): ChartWidget
Notify that layout is invalidated. Send event Events.LayoutInvalidated
| Name | Type | Description |
|---|---|---|
Optional propagate | boolean | propagate invalidate layout to parent |
this
AnnotatedWidget.invalidateLayout
▸ invalidateParent(bounds?, force?): ChartWidget
Invalidate parent area
| Name | Type | Description |
|---|---|---|
Optional bounds | Rect | area to invalidate |
Optional force | boolean | force |
this
AnnotatedWidget.invalidateParent
▸ inverseTransform(src, chart, dst?): Point
Transforms point from device to chart model coordinates
| Name | Type | Description |
|---|---|---|
src | Point | point to transform |
chart | number | AbstractChart | chart (or chart index) for model to transform |
Optional dst | Point | destination point |
▸ isClippingEnabled(): boolean
Returns if clipping is enabled or not for this node.
boolean
AnnotatedWidget.isClippingEnabled
▸ isDisposed(): boolean
Returns whether this object has been disposed
boolean
▸ isEventPropagationEnabled(): boolean
Return true if event propagation is enabled from child to parent
boolean
AnnotatedWidget.isEventPropagationEnabled
▸ isHorizontalFlip(): boolean
Return true if the representation is flipped horizontally
boolean
flip
AnnotatedWidget.isHorizontalFlip
▸ isLayoutInvalidated(): boolean
Return true if layout is invalid
boolean
AnnotatedWidget.isLayoutInvalidated
▸ isNotificationEnabled(): boolean
return state of notification
boolean
current notification state
AnnotatedWidget.isNotificationEnabled
▸ isPickingChildrenEnabled(): boolean
Returns if picking children is enabled or not for this node.
boolean
pickingChildren
AnnotatedWidget.isPickingChildrenEnabled
▸ isSelectable(): boolean
Returns true if node can be picked/selected.
boolean
The selectable flag
▸ isSilent(): boolean
Return true if the event dispatcher doesn't notify any events
boolean
▸ isVerticalFlip(): boolean
Return true if the representation is flipped vertically
boolean
flip
AnnotatedWidget.isVerticalFlip
▸ listToolsNames(): string[]
List all the tools contained in this composite. Prepend their parent tools parent using a '.'.
string[]
AnnotatedWidget.listToolsNames
▸ loadTemplate(template, registry?): ChartWidget
Load template
| Name | Type | Description |
|---|---|---|
template | string | template to be applied to the widget |
Optional registry | Registry | registry |
this
▸ moveTo(area, vAlign?, hAlign?): ChartWidget
MoveTo position of node to specified area
| Name | Type | Description |
|---|---|---|
area | Rect | specified area |
Optional vAlign | string | vertical alignment. It can be "top", "bottom", "center". |
Optional hAlign | string | horizontal alignment It can be "left", "right", "center". |
this
▸ notify<E>(type, source, args?): ChartWidget
Notify listeners of the Node
| Name | Type |
|---|---|
E | extends string |
| Name | Type | Description |
|---|---|---|
type | E | type of event |
source | AnnotatedWidget | source who called the event |
Optional args | EventMap[E] | event arguments |
this
▸ Protected notifyRoot(event, source, args?): Node
Notify an even to root node
| Name | Type | Description |
|---|---|---|
event | string | type of event |
source | Node | source who called the event |
Optional args | any | event arguments |
this
▸ off<E>(type?, callback?): ChartWidget
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.
| Name | Type |
|---|---|
E | extends string |
| Name | Type | Description |
|---|---|---|
Optional type | E | type of the event |
Optional callback | (eventType: E, sender: ChartWidget, args: EventMap[E]) => void | function to be called |
this
▸ on<E>(type, callback): ChartWidget
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.
| Name | Type |
|---|---|
E | extends string |
| Name | Type | Description |
|---|---|---|
type | E | type of event or property |
callback | (eventType: E, sender: ChartWidget, args: EventMap[E]) => void | to be called |
this
▸ Protected onBoundsChanged(bounds): ChartWidget
Occurs when bounds has been changed
| Name | Type | Description |
|---|---|---|
bounds | Rect | bound of the node in the parent coordinates |
this
AnnotatedWidget.onBoundsChanged
▸ Protected onChildAdded(child): void
This method is called it child or children are added
void
▸ Protected onChildRemoved(child): void
This method is called it child or children are removed
| Name | Type | Description |
|---|---|---|
child | Node | removed child |
void
AnnotatedWidget.onChildRemoved
▸ Protected onParentChanged(node): ChartWidget
This method is called when parent changes. Do not call it directly.
| Name | Type | Description |
|---|---|---|
node | Node | node to change parent |
this
AnnotatedWidget.onParentChanged
▸ Protected onVisibilityChanged(): void
This method is called if visibility is changed. Send event Events.VisibilityChanged
void
AnnotatedWidget.onVisibilityChanged
▸ pan(dx, dy): ChartWidget
attempts to translate the model using the specific x, y translation
Fires
Events.ModelVisibleLimitsChanged
| Name | Type | Description |
|---|---|---|
dx | number | relative horizontal change |
dy | number | relative vertical change |
this
▸ panModelTo(target, animationOptions?): ChartWidget
Pans the content to the point.
| Name | Type | Description |
|---|---|---|
target | Point | Point where to pan in model space |
Optional animationOptions | PanAnimationOptions | Animation options |
▸ Protected postRendering(context, callback?): void
To be called after rendering, used for PDF output
| Name | Type | Description |
|---|---|---|
context | RenderingContext | Rendering Context |
Optional callback | () => void | callback to be called after rendering |
void
▸ Protected preRendering(context, callback?): void
Occurs before child rendering
| Name | Type | Description |
|---|---|---|
context | RenderingContext | Rendering Context |
Optional callback | () => void | callback to be called after rendering of geometry |
void
▸ rebuild(force?, changes?): ChartWidget
Rebuild node. This method resets state, cache, and invalidate node.
| Name | Type | Description |
|---|---|---|
Optional force | boolean | optional boolean parameter that can force invalidation |
Optional changes | StateChanges | optional parameter to specify a reason of changes |
this
▸ refreshLayout(): ChartWidget
Refresh layout of inner components of the widget
▸ registerAnimationStyle(root): void
Register animation style.
| Name | Type | Description |
|---|---|---|
root | Node | root node for node |
void
AnnotatedWidget.registerAnimationStyle
▸ removeAxis(axis): void
remove axis
| Name | Type | Description |
|---|---|---|
axis | Axis | axis to be removed |
void
▸ removeBaseLayer(baseLayer): ChartWidget
Remove child baseLayer
this
AnnotatedWidget.removeBaseLayer
▸ removeChart(index): ChartWidget
Removes chart at specified index
| Name | Type | Description |
|---|---|---|
index | number | AbstractChart | specified index |
this
▸ removeChild(node, disposeChildren?): ChartWidget
Remove child node
| Name | Type | Description |
|---|---|---|
node | Node | Node[] | node or array of nodes to be removed |
Optional disposeChildren | boolean | automatically dispose children. If it is true then method dispose is called for each child. |
this
▸ removeCssClass(cssclass): ChartWidget
Removes css class from node
| Name | Type | Description |
|---|---|---|
cssclass | string | string[] | css class name('s) |
this
AnnotatedWidget.removeCssClass
▸ removeInvalidateHandler(handler): ChartWidget
Remove invalidate handler
Deprecated
since 4.0, use Node.off instead
| Name | Type | Description |
|---|---|---|
handler | Function | handler to be notified about invalidation |
this
AnnotatedWidget.removeInvalidateHandler
▸ removeLegend(legendPanel): ChartWidget
remove legend
| Name | Type |
|---|---|
legendPanel | LegendPanel |
▸ removeOverlay(overlay): ChartWidget
Remove child overlay
this
▸ removeTitle(location): void
remove title in the location
| Name | Type | Description |
|---|---|---|
location | AnnotationLocation | of the title |
void
▸ render(context): void
Render group
| Name | Type | Description |
|---|---|---|
context | RenderingContext | context to render group |
void
▸ renderAsync(context, callback): void
Render node in asynchronous mode. This implementation doesn't support cache for now.
| Name | Type | Description |
|---|---|---|
context | RenderingContext | The rendering context to be used to draw the node |
callback | () => void | callback function |
void
▸ Protected renderBackground(context, bounds): ChartWidget
Render background
| Name | Type | Description |
|---|---|---|
context | RenderingContext | context to render background |
bounds | Rect | group bounds |
this
AnnotatedWidget.renderBackground
▸ Protected renderBaseLayers(context): ChartWidget
Render baseLayers on bottom of cache. This method does nothing, but can be implemented to render graphics on bottom of cache and between borders
| Name | Type | Description |
|---|---|---|
context | RenderingContext | context to render baseLayers |
this
AnnotatedWidget.renderBaseLayers
▸ Protected renderBaseLayersAsync(context, callback): void
Render baseLayers on bottom of cache in asynchronous mode. This method calls renderBaseLayers
| Name | Type | Description |
|---|---|---|
context | RenderingContext | context to render overlays |
callback | () => void | callback function |
void
AnnotatedWidget.renderBaseLayersAsync
▸ Protected renderChildren(context): void
Render children
| Name | Type | Description |
|---|---|---|
context | RenderingContext | Rendering Context |
void
AnnotatedWidget.renderChildren
▸ Protected renderChildrenAsync(context, callback): void
Render children async
| Name | Type | Description |
|---|---|---|
context | RenderingContext | Rendering Context |
callback | () => void | callback function to be called then all children are rendered |
void
AnnotatedWidget.renderChildrenAsync
▸ Protected renderContent(context): void
render to specified context. This method calls preRendering, renderChildren, postRendering
| Name | Type | Description |
|---|---|---|
context | RenderingContext | Rendering Context |
void
▸ Protected renderContentAsync(context, callback): void
Render children in asynchronous mode
| Name | Type | Description |
|---|---|---|
context | RenderingContext | The rendering context to be used to draw the node |
callback | () => void | callback function to be called then all children are rendered |
void
AnnotatedWidget.renderContentAsync
▸ Protected renderOverlays(context): ChartWidget
Render overlays on top of cache. This method does nothing, but can be implemented to render graphics on top of cache and between borders
| Name | Type | Description |
|---|---|---|
context | RenderingContext | context to render overlays |
this
AnnotatedWidget.renderOverlays
▸ Protected renderOverlaysAsync(context, callback): void
Render overlays on top of cache in asynchronous mode. This method calls renderOverlays
| Name | Type | Description |
|---|---|---|
context | RenderingContext | context to render overlays |
callback | () => void | callback function |
void
AnnotatedWidget.renderOverlaysAsync
▸ restoreToolState(): ChartWidget
Restore tools state
this
AnnotatedWidget.restoreToolState
▸ resumeUpdate(rebuild?, changes?): ChartWidget
Resume auto update
| Name | Type | Description |
|---|---|---|
Optional rebuild | boolean | force rebuild |
Optional changes | StateChanges | optional parameter to specify a reason of changes |
this
▸ rotate(theta, x, y): ChartWidget
Rotate bounds around a given coordinate
| Name | Type | Description |
|---|---|---|
theta | number | angle to rotate node, in radians |
x | number | x coordinate to rotate around |
y | number | y coordinate to rotate around |
this
▸ saveTemplate(registry?, options?): string
Save template
string
return template as a string
▸ saveToolsState(): ChartWidget
Saves tools state
this
AnnotatedWidget.saveToolsState
▸ scale(xx, yy): ChartWidget
Scale node
| Name | Type | Description |
|---|---|---|
xx | number | x scale factor |
yy | number | y scale factor |
this
▸ scaleModel(xx, yy, posX?, posY?): ChartWidget
Scale node's contents.
Fires
Events.ModelVisibleLimitsChanged
| Name | Type | Description |
|---|---|---|
xx | number | x scale factor |
yy | number | y scale factor |
Optional posX | number | x position to scale from (in pxl) |
Optional posY | number | y position to scale from (in pxl) |
▸ setAnimationStyle(animationStyle): ChartWidget
Sets animation style
| Name | Type | Description |
|---|---|---|
animationStyle | Type | animation style |
AnnotatedWidget.setAnimationStyle
▸ setAnnotationSize(annotationSize?): ChartWidget
apply size (width or height) to annotation (convenience method)
Example
{
* west : 50,
* east : '10%',
* south: 'auto'
* }| Name | Type | Description |
|---|---|---|
Optional annotationSize | AnnotationSize | JSON to hold (width or height) of the annotation |
this
AnnotatedWidget.setAnnotationSize
▸ setAnnotationsOptions(options): ChartWidget
Sets annotations' options. currently setAnnotationOptions can only modify existing annotation, while the constructor for the widget can create new ones.
| Name | Type | Description |
|---|---|---|
options | AnnotationOptions | JSON to hold annotations' options |
this
AnnotatedWidget.setAnnotationsOptions
▸ setAutoModelLimitsMode(mode): ChartWidget
Set Model Limits Logics to use when no Model Limits have been set set to true: will use parents width and height, starting at 0 set to false: will use parents bounds. This is convenient method. It creates AutoModelLimitsStrategy
| Name | Type | Description |
|---|---|---|
mode | boolean | Model Limits Logics to be used |
this
AnnotatedWidget.setAutoModelLimitsMode
▸ setAutoModelLimitsStrategy(strategy): ChartWidget
Set Model Limits Logics Strategy
| Name | Type | Description |
|---|---|---|
strategy | ModelLimitsStrategy | Model Limits logic strategy to use |
this
AnnotatedWidget.setAutoModelLimitsStrategy
▸ setBounds(bounds): ChartWidget
Sets bounds of the node in the parent coordinates
this
▸ setCache(cache, rebuild?): ChartWidget
Sets cache to be used to cache
| Name | Type | Description |
|---|---|---|
cache | Cache | cache to be used |
Optional rebuild | boolean | rebuild cache |
this
▸ setCenterModelLimits(modellimits): ChartWidget
Set the model limits of center model
Fires
Events.ModelVisibleLimitsChanged
Example
//artificially expand the widget model limits
import {Rect} from '@int/geotoolkit/util/Rect';
const newLimits = new Rect(0,0,10,10);
widget.setCenterModelLimits(newLimits);| Name | Type | Description |
|---|---|---|
modellimits | Rect | model limits |
AnnotatedWidget.setCenterModelLimits
▸ setChild(index, node): ChartWidget
Replace child node by index
| Name | Type | Description |
|---|---|---|
index | number | index of the node |
node | Node | node |
this
▸ setClipStyle(style): ChartWidget
Sets a new clipping style
| Name | Type | Description |
|---|---|---|
style | GraphicsPath | ClipStyle | Options | a new clipping style |
this
▸ setContentOrientation(orientation): ChartWidget
Set content orientation
| Name | Type | Description |
|---|---|---|
orientation | Orientation | content orientation |
this
AnnotatedWidget.setContentOrientation
▸ setCss(style, merge?): ChartWidget
Sets CSS style. This style will be applied for all inserted elements
| Name | Type | Description |
|---|---|---|
style | Type | CSS style to be applied to inserted elements |
Optional merge | boolean | merge flag |
this
▸ setCssClass(name): ChartWidget
Sets css class name of the node to be used to apply CSS style
| Name | Type | Description |
|---|---|---|
name | string | css class name of the node |
this
▸ setCssTransform(transform): ChartWidget
Set CSS transformation
| Name | Type | Description |
|---|---|---|
transform | string | Transformation | transformation css transformation instruction or Transformation instance |
this
AnnotatedWidget.setCssTransform
▸ setDataSource(data): ChartWidget
Sets data source used for the chart in the widget
| Name | Type | Description |
|---|---|---|
data | DataSource | AbstractDataTable | data series |
this
▸ setDesiredHeight(value, silent?): ChartWidget
Sets desired height of the group as a layoutable object
| Name | Type | Description |
|---|---|---|
value | string | number | desired height to set, use 'auto' for automatic desired height |
Optional silent | boolean | silent setting |
this
AnnotatedWidget.setDesiredHeight
▸ setDesiredWidth(value, silent?): ChartWidget
Sets desired width of the group as a layoutable object
| Name | Type | Description |
|---|---|---|
value | string | number | desired width to set |
Optional silent | boolean | silent setting |
this
AnnotatedWidget.setDesiredWidth
▸ setExportLimits(limits): ChartWidget
Sets export limits
| Name | Type | Description |
|---|---|---|
limits | Rect | export limits |
AnnotatedWidget.setExportLimits
▸ setExportScale(scale): ChartWidget
Sets export scale.
| Name | Type | Description |
|---|---|---|
scale | Object | scale |
scale.x | number | scale by x form model to device |
scale.y | number | scale by y form model to device |
AnnotatedWidget.setExportScale
▸ setFillStyle(fillStyle, merge?): ChartWidget
Sets fill style
| Name | Type | Description |
|---|---|---|
fillStyle | Type | a new fill style |
Optional merge | boolean | true if you want to merge fillStyle with existing attribute, false by default |
this
▸ setHorizontalFlip(enable): ChartWidget
Set horizontal flip of the representation
| Name | Type | Description |
|---|---|---|
enable | boolean | enable flip |
this
AnnotatedWidget.setHorizontalFlip
▸ setId(id): ChartWidget
Allows the user to associate any identifier
| Name | Type | Description |
|---|---|---|
id | string | number | object id |
this
▸ setInfiniteMode(infinityMode): ChartWidget
Set infinity mode flag to draw composite without collision check
| Name | Type | Description |
|---|---|---|
infinityMode | boolean | infinity mode flag |
this
AnnotatedWidget.setInfiniteMode
▸ setLayout(layout): ChartWidget
Associate layout with a group.
| Name | Type | Description |
|---|---|---|
layout | Record<string, any> | Layout | layout instance to be set or layout properties to apply |
this
▸ Protected setLayoutInvalidated(invalidated): void
Set invalidation status
| Name | Type | Description |
|---|---|---|
invalidated | boolean | invalidated layout |
void
AnnotatedWidget.setLayoutInvalidated
▸ setLayoutStyle(layoutStyle, silent?, merge?): ChartWidget
specify desired layout style
| Name | Type | Description |
|---|---|---|
layoutStyle | LayoutStyle<string | number> | Options<string | number> | desired layout style |
Optional silent | boolean | silent setting |
Optional merge | boolean | true if you want to merge layoutStyle with existing attribute, false by default |
this
AnnotatedWidget.setLayoutStyle
▸ setLineStyle(lineStyle, merge?): ChartWidget
Sets border color Returns this
| Name | Type | Description |
|---|---|---|
lineStyle | Type | line style or options |
Optional merge | boolean | true if you want to merge lineStyle with existing attribute, false by default |
this
▸ setLocalTransform(localTransform, force?): ChartWidget
Sets local transformation to be used to transform from local to parent coordinate
| Name | Type | Description |
|---|---|---|
localTransform | Transformation | local transformation for this node |
Optional force | boolean | boolean flag to force update event if transformations are equal, false by default |
this
AnnotatedWidget.setLocalTransform
▸ setMarginsStyle(margins, merge?): ChartWidget
Sets margins style
| Name | Type | Description |
|---|---|---|
margins | Type<string | number> | margins style |
Optional merge | boolean | true if you want to merge marginsStyle with existing attribute, false by default |
this
AnnotatedWidget.setMarginsStyle
▸ setModelLimits(limits): ChartWidget
Sets inner model limits
| Name | Type | Description |
|---|---|---|
limits | Type | inner limits |
this
AnnotatedWidget.setModelLimits
▸ setModelTransformation(transformation): ChartWidget
Attempts to set local transformation for the model. NOTE: the local transformation set may not be equal to transformation passed - it depends on current ScaleScrollStrategy set on the node.
| Name | Type | Description |
|---|---|---|
transformation | Transformation | transformation to set |
AnnotatedWidget.setModelTransformation
▸ setName(name): ChartWidget
Sets name of the node
| Name | Type | Description |
|---|---|---|
name | string | The node name |
this
▸ setNotification(notify, force?): ChartWidget
set notification state
| Name | Type | Description |
|---|---|---|
notify | boolean | flag set to invalidate parent or not |
Optional force | boolean | true if parent should be invalidated immediately |
this
AnnotatedWidget.setNotification
▸ setOpacity(opacity, blendMode?): ChartWidget
Sets node opacity
| Name | Type | Description |
|---|---|---|
opacity | number | node opacity from 0 to 1 |
Optional blendMode | BlendMode | opacity blend mode. If it is normal, opacity will be replaced. |
this
▸ setPaddingStyle(paddingStyle, merge?): ChartWidget
Sets padding style
| Name | Type | Description |
|---|---|---|
paddingStyle | Type<string | number> | padding style |
Optional merge | boolean | true if you want to merge paddingStyle with existing attribute, false by default |
this
AnnotatedWidget.setPaddingStyle
▸ setProperties(options?): ChartWidget
Sets properties
| Name | Type | Description |
|---|---|---|
Optional options | Options | properties |
this
▸ setProperty(name, value): ChartWidget
Sets dynamic property by name
| Name | Type | Description |
|---|---|---|
name | string | property name |
value | any | property value |
this
▸ setRenderingFilter(filter): ChartWidget
Sets filter to be applied before rendering and picking
| Name | Type | Description |
|---|---|---|
filter | IFilter | filter to set |
this
AnnotatedWidget.setRenderingFilter
▸ setResponsiveStyle(style): ChartWidget
Sets responsive style.
| Name | Type | Description |
|---|---|---|
style | Options | ResponsiveStyle | responsive style |
this
AnnotatedWidget.setResponsiveStyle
▸ setScaleScrollStrategy(delegate): ChartWidget
set the scale scroll strategy to apply to the widget
| Name | Type | Description |
|---|---|---|
delegate | Delegate | scaleScrollStrategy to set |
this
AnnotatedWidget.setScaleScrollStrategy
▸ setSelectable(selectable): ChartWidget
Allows to select node. If node is not selectable then child node is not selectable.
| Name | Type | Description |
|---|---|---|
selectable | boolean | flag to allow node selection |
this
▸ setSelectionMode(mode): ChartWidget
Sets selection mode for tooltip, selection and crosshair tools
| Name | Type |
|---|---|
mode | SelectionMode |
▸ setSilent(bool): ChartWidget
Set silent mode
| Name | Type | Description |
|---|---|---|
bool | boolean | flag to enable silent mode |
this
▸ setTag(tag): ChartWidget
Allows the user to associate any arbitrary object with the node.
| Name | Type | Description |
|---|---|---|
tag | any | The object to be associated with the node. |
this
▸ setTitle(titleOptions): ChartWidget
Sets title of the widget
| Name | Type | Description |
|---|---|---|
titleOptions | Object | options of the title |
Optional titleOptions.location | AnnotationLocation | Location of title |
Optional titleOptions.paddingstyle | Type<string | number> | inner padding style in device coordinates |
Optional titleOptions.text | string | Text to display |
Optional titleOptions.textstyle | Type | Text style to apply to title |
Optional titleOptions.visible | boolean | Visibility of title |
▸ setTitleOptions(location, options): ChartWidget
set options for title
| Name | Type | Description |
|---|---|---|
location | AnnotationLocation | of the title |
options | Omit<TitleOptions, "location"> | title options |
AnnotatedWidget.setTitleOptions
▸ Protected setTool(tool): ChartWidget
Set root tool associated to this widget
| Name | Type | Description |
|---|---|---|
tool | CompositeTool | tool to be set |
▸ setToolCustomModeEnabled(tool, enabled): ChartWidget
Enables/disables custom system tool mode for widget based on current system (custom Rubberband selection, crosshair etc.)
| Name | Type | Description |
|---|---|---|
tool | AbstractTool | tool to be changed into default/system mode |
enabled | boolean | true to enable system-based mode, false otherwise |
▸ setToolsOptions(options?): ChartWidget
Set Tools Options
Example
//To prevent the selection tool from deselecting the previously selected points, for example user can do the following:
annotatedWidget.setToolsOptions({
'selection': {
'resetselection': false
}
});| Name | Type | Description |
|---|---|---|
Optional options | ToolsOptions | JSON which defines tools options |
this
AnnotatedWidget.setToolsOptions
▸ setVerticalFlip(flip): ChartWidget
Set vertical flip of the representation
| Name | Type | Description |
|---|---|---|
flip | boolean | flag to set the vertical flip of the representation |
this
AnnotatedWidget.setVerticalFlip
▸ setVisible(value): ChartWidget
Sets visibility of the node. Send event Events.VisibilityChanged
| Name | Type | Description |
|---|---|---|
value | boolean | flag specifying visibility of the node |
this
▸ setVisibleCenterModelLimits(newVisibleModelLimits): ChartWidget
Attempts to set model's visible limits to specified limits. NOTE: the limits set may not be equal to the limit passed - it depends on current ScaleScrollStrategy set on the node.
Fires
Events.ModelVisibleLimitsChanged
| Name | Type | Description |
|---|---|---|
newVisibleModelLimits | Rect | limits to set |
AnnotatedWidget.setVisibleCenterModelLimits
▸ setVisibleModelLimits(newVisibleModelLimits): ChartWidget
Attempts to set model's visible limits to specified limits. NOTE: the limits set may not be equal to the limit passed - it depends on current ScaleScrollStrategy set on the node.
| Name | Type | Description |
|---|---|---|
newVisibleModelLimits | Rect | limits to set |
AnnotatedWidget.setVisibleModelLimits
▸ setZIndex(value): ChartWidget
Sets z-index for node (set null for default)
| Name | Type | Description |
|---|---|---|
value | number | index determining node z-position |
this
▸ shear(shx, shy): ChartWidget
Shear this node's bounds
| Name | Type | Description |
|---|---|---|
shx | number | x-axis shear |
shy | number | y-axis shear |
this
▸ suspendUpdate(): ChartWidget
Suspend auto update
this
▸ swapAxes(axis1, axis2): ChartWidget
Swap axes ("canSwapAxes" must be called first).
see ChartWidget.canSwapAxes description for invalid swap cases
Throws
Error if swapping axes is not doable
this
▸ Protected synchronizeViewLimits(): ChartWidget
AnnotatedWidget.synchronizeViewLimits
▸ toString(): string
Returns a string representation of this object (generally the classname)
string
A string representation
▸ tooltipTitleFormat(): string
Formats selection info for tooltip purposes, all info is shared between charts
string
▸ transform(src, chart, dst?): Point
Transforms point from chart model coordinates to device
| Name | Type | Description |
|---|---|---|
src | Point | point to transform |
chart | number | AbstractChart | chart (or chart index) for model to transform |
Optional dst | Point | destination point |
▸ translate(tx, ty): ChartWidget
Translate bounds
| Name | Type | Description |
|---|---|---|
tx | number | x translation |
ty | number | y translation |
this
▸ translateModel(tx, ty): ChartWidget
Translates widget's contents.
Fires
Events.ModelVisibleLimitsChanged
| Name | Type | Description |
|---|---|---|
tx | number | x translation |
ty | number | y translation |
AnnotatedWidget.translateModel
▸ unregisterAnimationStyle(root): void
Unregister animation style.
| Name | Type | Description |
|---|---|---|
root | AnimatedNode | root node for node |
void
AnnotatedWidget.unregisterAnimationStyle
▸ updateLayout(targets?): ChartWidget
Updates layout(s)
Fires
| Name | Type | Description |
|---|---|---|
Optional targets | ILayoutable[] | optional parameter about which element to layout |
this
▸ updateSceneTransformation(): ChartWidget
Update scene transformation
this
AnnotatedWidget.updateSceneTransformation
▸ updateState(regions?, changes?): ChartWidget
Update state. These methods reset node state and update state for children. this method is useful to refresh a scene graph
| Name | Type | Description |
|---|---|---|
Optional regions | Rect[] | optional array to return invalid rectangles in the parent coordinates |
Optional changes | StateChanges | optional parameter to specify a reason of changes |
this
▸ updateSuspended(): boolean
Return state of suspend state
boolean
state of update
AnnotatedWidget.updateSuspended
▸ Protected updateTimeStamp(): ChartWidget
Update time stamp to indicate that Node or Children has been changed.
this
AnnotatedWidget.updateTimeStamp
▸ zoomIn(): ChartWidget
zoom in, with default factor = 5/4
this
▸ zoomOut(): ChartWidget
zoom out, with default factor = 5/4
this
▸ zoomToRect(limits?): void
Sets visible model limits
Fires
Events.ModelVisibleLimitsChanged
| Name | Type | Description |
|---|---|---|
Optional limits | Rect | the visible model limits |
void
▸ Static enableSceneGraphNotification(enabled): void
Enable / disable all notifications
| Name | Type | Description |
|---|---|---|
enabled | boolean | sets if this object sends notifications |
void
AnnotatedWidget.enableSceneGraphNotification
▸ Static findParent<T>(node, classType, filter?): InstanceType<T>
Find root of the node with specified type
| Name | Type |
|---|---|
T | extends Constructor<any> |
| Name | Type | Description |
|---|---|---|
node | Node | node to start search |
classType | T | type of the class to search for |
Optional filter | (node: Node) => boolean | additional filter to apply |
InstanceType<T>
▸ Static findParent(node, classType, filter?): Node
Find root of the node with specified type
| Name | Type | Description |
|---|---|---|
node | Node | node to start search |
classType | string | interface name to search for |
Optional filter | (node: Node) => boolean | additional filter to apply |
▸ Static getClassName(): string
string
▸ Static isSceneGraphNotificationEnabled(): boolean
Return status of the global notification for all nodes.
boolean