Methods
This section describes members used to manipulate a widget.
addMarker(markerOptions)
Adds a marker to the map.
A Promise of the jQuery Deferred object which is resolved with an original marker instance when the marker is added.
The marker object should include the following fields.
- location (required) - the marker location. You can specify the location in one of the following formats:
- { lat: 40.749825, lng: -73.987963};
- "40.749825, -73.987963";
- [40.749825, -73.987963];
- 'Brooklyn Bridge,New York,NY';
- tooltip (optional) - the marker tooltip;
- onClick (optional) - a callback function performed when the marker is clicked;
- text (optional) - the marker caption.
- iconSrc (optional) - a URL pointing to the custom icon to be used for the marker.
addRoute(routeOptions)
Adds a route to the map.
A Promise of the jQuery Deferred object which is resolved with an original route instance when the route is added.
The route object should include the locations field, containing an array of route locations. Each location can be specified in any of the following formats.
- { lat: 40.749825, lng: -73.987963}
- "40.749825, -73.987963"
- [40.749825, -73.987963]
- 'Brooklyn Bridge,New York,NY'
beginUpdate()
Prevents the component from refreshing until the endUpdate() method is called.
The beginUpdate() and endUpdate() methods allow you to apply several modifications to the component. After the beginUpdate() method is called, the component does not update the UI until the endUpdate() method is called. The usage of these methods prevents excessive component updating when you are changing multiple component settings at once.
defaultOptions(rule)
Specifies the device-dependent default configuration options for this component.
An object specifying default options for the component and the device for which the options must be applied.
An object representing device parameters, or an array of objects representing device parameters, or a function that provides information on the current device as an input parameter and returning a Boolean value.
A configuration object with specified options.
The defaultOptions method is a static method supported by the widget class. The following code demonstrates how to specify default options for all buttons in the application executed on the iOS platform.
DevExpress.ui.dxButton.defaultOptions({ device: { platform: "ios" }, options: { text: "Click me" } });
element()
Returns the root HTML element of the widget.
The root element of the widget.
endUpdate()
Enables the component to refresh after the beginUpdate() method call.
The beginUpdate() and endUpdate() methods allow you to apply several modifications to the component. After the beginUpdate() method is called, the component does not update the UI until the endUpdate() method is called. The usage of these methods prevents excessive component updating when you change multiple component setting at once.
instance()
Returns an instance of this component class.
An instance of this component class
Use this method to access other methods of the component.
off(eventName)
Detaches all event handlers from the specified event.
The name of the event to unsubscribe from.
The object for which this method is called.
off(eventName, eventHandler)
Detaches a particular event handler from the specified event.
The object for which this method is called.
on(eventName, eventHandler)
Subscribes to a specified event.
The object for which this method is called.
Use this method to subscribe to one of the events listed in the Events section.
See Also
on(events)
Subscribes to the specified events.
An object of the following structure: { "eventName1": handler1, "eventName2": handler2, ...}
The object for which this method is called.
Use this method to subscribe to several events at one method call. Available events are listed in the Events section.
See Also
option()
Returns the configuration options of this component.
An object representing the configuration options of this component.
option(optionName)
Gets the value of the specified configuration option of this component.
The name of the option to get.
The value of the specified option.
If you need to get the value of a configuration option field, specify the path to the required field.
option(optionName, optionValue)
Sets a value to the specified configuration option of this component.
The name of the required option.
The value you wish to assign to the required option.
To set a value to the configuration option field, specify the path to the required field.
option(options)
Sets one or more options of this component.
An object containing the required configuration options.
registerKeyHandler(key, handler)
Registers a handler when a specified key is pressed.
The handler function is called when the specified key is pressed if the widget is focused.
The key argument accepts the following values.
- "backspace"
- "tab"
- "enter"
- "escape"
- "pageUp"
- "pageDown"
- "end"
- "home"
- "leftArrow"
- "upArrow"
- "rightArrow"
- "downArrow"
- "del"
- "space"
- "F"
- "A"
- "asterisk"
- "minus"
removeMarker(marker)
Removes a marker from the map.
A Promise of the jQuery Deferred object which is resolved when the marker is removed.
removeRoute(route)
Removes a route from the map.
A Promise of the jQuery Deferred object which is resolved when the route is removed.
repaint()
Redraws the widget.
After performing some external modifications that lead to a change of the widget container's size or visibility, the widget's state may become invalid. In this instance, use the repaint() method to redraw the widget.