com.telerik.widget.chart.visualization.behaviors

Class ChartTrackBallBehavior

java.lang.Object

com.telerik.android.common.PropertyManager

com.telerik.widget.chart.visualization.behaviors.ChartBehavior

com.telerik.widget.chart.visualization.behaviors.ChartPopupBehavior

com.telerik.widget.chart.visualization.behaviors.ChartTrackBallBehavior

All Implemented Interfaces:

TooltipAdapter

public class ChartTrackBallBehavior
extends ChartPopupBehavior

Represents a behavior that adds two lines in RadChartViewBase's render surface. The two lines intersect at the center of the closest data point found.

Field Summary

Fields

Modifier and Type	Field and Description
static int	BACKGROUND_PROPERTY_KEY
static int	CATEGORY_COLOR_PROPERTY_KEY
static int	CATEGORY_SIZE_PROPERTY_KEY
static int	PADDING_PROPERTY_KEY
static int	VALUE_COLOR_PROPERTY_KEY
static int	VALUE_SIZE_PROPERTY_KEY

Constructor Summary

Constructors

Constructor and Description
ChartTrackBallBehavior(Context context) Initializes a new instance of the ChartTrackBallBehavior class.

Method Summary

Modifier and Type	Method and Description
TooltipContentAdapter	contentAdapter() Provides a content adapter for the current tooltip instance.
int	getBackgroundColor()
int	getCategoryTextColor()
float	getCategoryTextSize()
ChartTrackballContentAdapter.ChartTrackBallContentProvider	getCustomContentProvider() Gets an implementation of the ChartTrackballContentAdapter.ChartTrackBallContentProvider interface used to retrieve a custom content for the trackball for a given DataPoint.
int	getPadding()
TrackBallHitTestMode	getPointHitTestMode() Gets a value determining whether visual information for all the closest data points will be displayed.
List<DataPoint>	getRelatedDataPoints() Gets a list of data points related to the currently tracked one.
boolean	getShowIntersectionPoints() Gets a value determining whether visual information for all the closest data points will be displayed.
boolean	getShowTrackInfo() Gets a value determining whether visual information for all the closest data points will be displayed.
TrackBallSnapMode	getSnapMode() Gets a value determining how the track ball behaviour will snap to the data points closest to a physical lastLocation.
Object[]	getTooltipData(Object context) Gets the data for the tooltip using the passed context.
int	getValueTextColor()
float	getValueTextSize()
boolean	onDrag(MotionEvent event, MotionEvent event2, RadSize distance, boolean isInHold) Invoked when a drag gesture occurs on the owner chart.
boolean	onHold(MotionEvent e) Invoked when a hold gesture occurs on the owner chart.
boolean	onUp(MotionEvent e) Invoked when the user lifts a finger from the chart.
void	setBackgroundColor(int color)
void	setCategoryTextColor(int value)
void	setCategoryTextSize(float value)
void	setContentAdapter(TooltipContentAdapter adapter)
void	setCustomContentProvider(ChartTrackballContentAdapter.ChartTrackBallContentProvider provider) Sets an implementation of the ChartTrackballContentAdapter.ChartTrackBallContentProvider interface used to retrieve a custom content for the trackball for a given DataPoint.
void	setPadding(int value)
void	setPointHitTestMode(TrackBallHitTestMode value) Sets a value determining whether visual information for all the closest data points will be displayed.
void	setShowIntersectionPoints(boolean value) Sets a value determining whether visual information for all the closest data points will be displayed.
void	setShowTrackInfo(boolean value) Sets a value determining whether visual information for all the closest data points will be displayed.
void	setSnapMode(TrackBallSnapMode mode) Sets a value determining how the track ball behaviour will snap to the data points closest to a physical lastLocation.
void	setValueTextColor(int color)
void	setValueTextSize(float value)

Methods inherited from class com.telerik.widget.chart.visualization.behaviors.ChartPopupBehavior

alignTooltipVertically, availableLayoutSlot, close, extractTooltipContext, extractTooltipContext, getApplyDefaultStyles, getContextNeededListener, getLastChartContext, getMaxTouchDistanceTolerance, getPlotAreaClip, getPopupPresenter, isTooltipDisplayed, open, open, rawOffset, setApplyDefaultStyles, setMaxTouchDistanceTolerance, setPopupPresenter, setTooltipContextNeededListener

Methods inherited from class com.telerik.widget.chart.visualization.behaviors.ChartBehavior

attach, chart, detach, onDoubleTap, onDown, onPinch, onPinchComplete, onTap, reset

Methods inherited from class com.telerik.android.common.PropertyManager

getValue, resetPropertyValue, setValue, setValue

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

BACKGROUND_PROPERTY_KEY

public static final int BACKGROUND_PROPERTY_KEY

PADDING_PROPERTY_KEY

public static final int PADDING_PROPERTY_KEY

CATEGORY_COLOR_PROPERTY_KEY

public static final int CATEGORY_COLOR_PROPERTY_KEY

VALUE_COLOR_PROPERTY_KEY

public static final int VALUE_COLOR_PROPERTY_KEY

CATEGORY_SIZE_PROPERTY_KEY

public static final int CATEGORY_SIZE_PROPERTY_KEY

VALUE_SIZE_PROPERTY_KEY

public static final int VALUE_SIZE_PROPERTY_KEY

Constructor Detail

ChartTrackBallBehavior

public ChartTrackBallBehavior(Context context)

Initializes a new instance of the ChartTrackBallBehavior class.

Method Detail

getBackgroundColor

public int getBackgroundColor()

setBackgroundColor

public void setBackgroundColor(int color)

getPadding

public int getPadding()

setPadding

public void setPadding(int value)

getCategoryTextColor

public int getCategoryTextColor()

setCategoryTextColor

public void setCategoryTextColor(int value)

getCategoryTextSize

public float getCategoryTextSize()

setCategoryTextSize

public void setCategoryTextSize(float value)

getValueTextSize

public float getValueTextSize()

setValueTextSize

public void setValueTextSize(float value)

getValueTextColor

public int getValueTextColor()

setValueTextColor

public void setValueTextColor(int color)

getCustomContentProvider

public ChartTrackballContentAdapter.ChartTrackBallContentProvider getCustomContentProvider()

Gets an implementation of the ChartTrackballContentAdapter.ChartTrackBallContentProvider interface used to retrieve a custom content for the trackball for a given DataPoint.

Returns:

the ChartTrackballContentAdapter.ChartTrackBallContentProvider implementation that is currently set.

setCustomContentProvider

public void setCustomContentProvider(ChartTrackballContentAdapter.ChartTrackBallContentProvider provider)

Sets an implementation of the ChartTrackballContentAdapter.ChartTrackBallContentProvider interface used to retrieve a custom content for the trackball for a given DataPoint.

Parameters:

provider - the ChartTrackballContentAdapter.ChartTrackBallContentProvider implementation to set.

getShowTrackInfo

public boolean getShowTrackInfo()

Gets a value determining whether visual information for all the closest data points will be displayed.

Returns:

true if visual information will be displayed, false otherwise.

setShowTrackInfo

public void setShowTrackInfo(boolean value)

Sets a value determining whether visual information for all the closest data points will be displayed.

Parameters:

value - the new value.

getShowIntersectionPoints

public boolean getShowIntersectionPoints()

Gets a value determining whether visual information for all the closest data points will be displayed.

Returns:

true if the information will be displayed, false otherwise.

setShowIntersectionPoints

public void setShowIntersectionPoints(boolean value)

Sets a value determining whether visual information for all the closest data points will be displayed.

Parameters:

value - the new value.

getPointHitTestMode

public TrackBallHitTestMode getPointHitTestMode()

Gets a value determining whether visual information for all the closest data points will be displayed.

Returns:

true if the information will be displayed, false otherwise.

setPointHitTestMode

public void setPointHitTestMode(TrackBallHitTestMode value)

Sets a value determining whether visual information for all the closest data points will be displayed.

Parameters:

value - the new value.

getRelatedDataPoints

public List<DataPoint> getRelatedDataPoints()

Gets a list of data points related to the currently tracked one.

Returns:

the list of related data points.

getSnapMode

public TrackBallSnapMode getSnapMode()

Gets a value determining how the track ball behaviour will snap to the data points closest to a physical lastLocation.

Returns:

the current snap mode.

setSnapMode

public void setSnapMode(TrackBallSnapMode mode)

Sets a value determining how the track ball behaviour will snap to the data points closest to a physical lastLocation.

Parameters:

mode - the new snap mode.

contentAdapter

public TooltipContentAdapter contentAdapter()

Description copied from interface: TooltipAdapter

Provides a content adapter for the current tooltip instance.

Returns:

content adapter.

See Also:

TooltipContentAdapter

setContentAdapter

public void setContentAdapter(TooltipContentAdapter adapter)

onHold

public boolean onHold(MotionEvent e)

Description copied from class: ChartBehavior

Invoked when a hold gesture occurs on the owner chart.

Overrides:

onHold in class ChartBehavior

Parameters:

e - An object that contains gesture information.

Returns:

Returns true if the gesture is handled.

onDrag

public boolean onDrag(MotionEvent event,
                      MotionEvent event2,
                      RadSize distance,
                      boolean isInHold)

Description copied from class: ChartBehavior

Invoked when a drag gesture occurs on the owner chart.

Overrides:

onDrag in class ChartBehavior

Parameters:

event - Information for the event that started the gesture.

event2 - Information for the event that caused the current drag gesture

distance - The distance travelled since the previous gesture. This is NOT the distance between initialEvent and currentEvent.

Returns:

Returns true if the gesture is handled.

onUp

public boolean onUp(MotionEvent e)

Description copied from class: ChartBehavior

Invoked when the user lifts a finger from the chart.

Overrides:

onUp in class ChartBehavior

Parameters:

e - An object that contains gesture information.

Returns:

Returns true if the gesture is handled.

getTooltipData

public Object[] getTooltipData(Object context)

Description copied from interface: TooltipAdapter

Gets the data for the tooltip using the passed context.

Specified by:

getTooltipData in interface TooltipAdapter

Overrides:

getTooltipData in class ChartPopupBehavior

Parameters:

context - context used to extract the data for the current tooltip.

Returns:

the extracted data.