Drawings
Drawings (shapes) are the tools that can help you analyze the charts and make clear annotations to them. The drawings toolbar is located on the left panel. Follow the Drawings List article for a complete list of tools included in the drawing toolbar.
Style Customization
Each drawing tool has its own default properties that users can change in the UI.
However, you can customize the drawing style, e.g., change its color, size, visibility, and more in two ways:
- Change the default values using the
overrides
property of Widget Constructor. - Change the properties on the fly using the
applyOverrides
method.
You can find the full list of default properties for drawing tools in the Drawing Overrides article.
APIs
The library allows you to create and manage drawings using the built-in API. You can also combine drawings into groups and manage them as a single object. Refer to Drawings API for more information.
Drawing Features
Events
You can subscribe to events related to drawings such as moving a drawing or changing its properties.
To do this, call the SubscribeEventsMap
method with the drawing_event
property.
Favorite Tools
You can specify a default list of favorite drawings using the favorites
property in Widget Constructor.
In the UI, users can mark drawings as favorites using the Add to favorites button. The selected drawings are added to Favorite Drawings Toolbar that appears on the chart.
If you do not want users to specify favorites, you should disable the items_favoriting
featureset. As a result, the Add to favorites button will be hidden in the UI.
Templates
These feature is only available in Trading Platform.
For several drawing tools of the same type, the template appliance option is available in the floating toolbar.
To disable this feature, include the drawing_templates
featureset in the disabled_features
array.
Custom Restrictions
You can hide some drawings from the toolbar or apply custom restrictions to the chart.
To do this, use the drawings_access
property of Widget Constructor.
For example, you can choose which tools will be shown to users or hidden/disabled from them.