SciChart® the market leader in Fast WPF Charts, WPF 3D Charts, iOS Chart, Android Chart and JavaScript Chart Components
SciChart Android ships with ~90Â Android Chart Examples which you can browse, play with, view the source-code and even export each SciChart Android Chart Example to a stand-alone Android Studio project. All of this is possible with the new and improved SciChart Android Examples Suite, which ships as part of our Android Charts SDK.
In SciChart Android, it is possible to customize the look and feel of Tooltips for our Android Charts. This examples demostrates how to do this using RolloverModifer.
What can be customized? The actual tooltips style (background, size, opacity) as well as text style (font family, font size, weight, text color). The marker which intersects the series, and also text formatting of the rollover tooltip itself.
The full source code for the Android Chart Custom RolloverModifier example is included below (Scroll down!).
Did you know you can also view the source code from one of the following sources as well?
//******************************************************************************
// SCICHART® Copyright SciChart Ltd. 2011-2021. All rights reserved.
//
// Web: http://www.scichart.com
// Support: support@scichart.com
// Sales: sales@scichart.com
//
// CustomizationRolloverModifierTooltipsFragment.kt is part of SCICHART®, High Performance Scientific Charts
// For full terms and conditions of the license, see http://www.scichart.com/scichart-eula/
//
// This source code is protected by international copyright law. Unauthorized
// reproduction, reverse-engineering, or distribution of all or any portion of
// this source code is strictly prohibited.
//
// This source code contains confidential and proprietary trade secrets of
// SciChart Ltd., and should at no time be copied, transferred, sold,
// distributed or made available without express written permission.
//******************************************************************************
package com.scichart.examples.fragments.examples2d.tooltipsAndHitTest.kt
import android.content.Context
import android.text.SpannableStringBuilder
import android.view.animation.DecelerateInterpolator
import com.scichart.charting.modifiers.RolloverModifier
import com.scichart.charting.visuals.SciChartSurface
import com.scichart.charting.visuals.axes.AxisInfo
import com.scichart.charting.visuals.axes.AxisTooltip
import com.scichart.charting.visuals.axes.DefaultAxisInfoProvider
import com.scichart.charting.visuals.axes.IAxisTooltip
import com.scichart.charting.visuals.renderableSeries.hitTest.DefaultXySeriesInfoProvider
import com.scichart.charting.visuals.renderableSeries.hitTest.XySeriesInfo
import com.scichart.charting.visuals.renderableSeries.tooltips.ISeriesTooltip
import com.scichart.charting.visuals.renderableSeries.tooltips.XySeriesTooltip
import com.scichart.core.utility.StringUtil
import com.scichart.drawing.utility.ColorUtil
import com.scichart.examples.R
import com.scichart.examples.data.RandomWalkGenerator
import com.scichart.examples.fragments.base.ExampleSingleChartBaseFragment
import com.scichart.examples.utils.scichartExtensions.*
class CustomizationRolloverModifierTooltipsFragment : ExampleSingleChartBaseFragment() {
override fun initExample(surface: SciChartSurface) {
val randomWalkGenerator = RandomWalkGenerator()
val data1 = randomWalkGenerator.getRandomWalkSeries(POINTS_COUNT)
randomWalkGenerator.reset()
val data2 = randomWalkGenerator.getRandomWalkSeries(POINTS_COUNT)
surface.suspendUpdates {
xAxes { numericAxis() }
yAxes { numericAxis { axisInfoProvider = CustomAxisInfoProvider() } }
renderableSeries {
fastLineRenderableSeries {
xyDataSeries<Double, Double>("Series #1") {
append(data1.xValues, data1.yValues)
}
strokeStyle = SolidPenStyle(0xff6495ed, 2f)
seriesInfoProvider = FirstCustomSeriesInfoProvider()
sweepAnimation { interpolator = DecelerateInterpolator() }
}
fastLineRenderableSeries {
xyDataSeries<Double, Double>("Series #2") {
append(data2.xValues, data2.yValues)
}
strokeStyle = SolidPenStyle(0xffe2460c, 2f)
seriesInfoProvider = SecondCustomSeriesInfoProvider()
sweepAnimation { interpolator = DecelerateInterpolator() }
}
}
chartModifiers { tooltipModifier() }
}
}
private class FirstCustomSeriesInfoProvider : DefaultXySeriesInfoProvider() {
override fun getSeriesTooltipInternal(context: Context, seriesInfo: XySeriesInfo<*>?, modifierType: Class<*>): ISeriesTooltip {
return when (modifierType) {
RolloverModifier::class.java -> { FirstCustomXySeriesTooltip(context, seriesInfo) }
else -> { super.getSeriesTooltipInternal(context, seriesInfo, modifierType) }
}
}
private class FirstCustomXySeriesTooltip(context: Context?, seriesInfo: XySeriesInfo<*>?) :
XySeriesTooltip(context, seriesInfo) {
override fun internalUpdate(seriesInfo: XySeriesInfo<*>) {
val sb = SpannableStringBuilder()
sb.append("X: ").append(seriesInfo.formattedXValue).append(StringUtil.NEW_LINE)
sb.append("Y: ").append(seriesInfo.formattedYValue).append(StringUtil.NEW_LINE)
seriesInfo.seriesName?.run {
sb.append(this).append(StringUtil.NEW_LINE)
}
sb.append(MODIFIER_NAME)
text = sb
setTooltipBackgroundColor(0xff6495ed.toInt())
setTooltipStroke(0xff4d81dd.toInt())
setTooltipTextColor(ColorUtil.White)
}
}
}
private class SecondCustomSeriesInfoProvider : DefaultXySeriesInfoProvider() {
override fun getSeriesTooltipInternal(context: Context, seriesInfo: XySeriesInfo<*>?, modifierType: Class<*>): ISeriesTooltip {
return when (modifierType) {
RolloverModifier::class.java -> { SecondCustomXySeriesTooltip(context, seriesInfo) }
else -> { super.getSeriesTooltipInternal(context, seriesInfo, modifierType) }
}
}
private class SecondCustomXySeriesTooltip(context: Context?, seriesInfo: XySeriesInfo<*>?) : XySeriesTooltip(context, seriesInfo) {
override fun internalUpdate(seriesInfo: XySeriesInfo<*>) {
val sb = SpannableStringBuilder()
sb.append(MODIFIER_NAME).append(StringUtil.NEW_LINE)
seriesInfo.seriesName?.run {
sb.append(this).append(StringUtil.NEW_LINE)
}
sb.append("X: ").append(seriesInfo.formattedXValue)
sb.append(" Y: ").append(seriesInfo.formattedYValue)
text = sb
setTooltipBackgroundColor(0xffe2460c.toInt())
setTooltipStroke(0xffff4500.toInt())
setTooltipTextColor(ColorUtil.White)
}
}
}
private class CustomAxisInfoProvider : DefaultAxisInfoProvider() {
override fun getAxisTooltipInternal(context: Context, axisInfo: AxisInfo, modifierType: Class<*>): IAxisTooltip {
return when (modifierType) {
RolloverModifier::class.java -> { CustomAxisTooltip(context, axisInfo) }
else -> { super.getAxisTooltipInternal(context, axisInfo, modifierType) }
}
}
private class CustomAxisTooltip(context: Context?, axisInfo: AxisInfo?) : AxisTooltip(context, axisInfo) {
override fun updateInternal(axisInfo: AxisInfo): Boolean {
val sb = SpannableStringBuilder()
sb.append("Axis ID: ").append(axisInfo.axisId).append(StringUtil.NEW_LINE)
sb.append("Value: ").append(axisInfo.axisFormattedDataValue)
text = sb
return true
}
init {
setTooltipBackground(R.drawable.example_custom_axis_tooltip_background)
}
}
}
companion object {
private const val POINTS_COUNT = 200
private const val MODIFIER_NAME = "RolloverModifier"
}
}
//******************************************************************************
// SCICHART® Copyright SciChart Ltd. 2011-2021. All rights reserved.
//
// Web: http://www.scichart.com
// Support: support@scichart.com
// Sales: sales@scichart.com
//
// CustomizationRolloverModifierTooltipsFragment.java is part of SCICHART®, High Performance Scientific Charts
// For full terms and conditions of the license, see http://www.scichart.com/scichart-eula/
//
// This source code is protected by international copyright law. Unauthorized
// reproduction, reverse-engineering, or distribution of all or any portion of
// this source code is strictly prohibited.
//
// This source code contains confidential and proprietary trade secrets of
// SciChart Ltd., and should at no time be copied, transferred, sold,
// distributed or made available without express written permission.
//******************************************************************************
package com.scichart.examples.fragments.examples2d.tooltipsAndHitTest;
import android.content.Context;
import android.text.SpannableStringBuilder;
import android.view.animation.DecelerateInterpolator;
import androidx.annotation.NonNull;
import com.scichart.charting.model.dataSeries.XyDataSeries;
import com.scichart.charting.modifiers.RolloverModifier;
import com.scichart.charting.visuals.SciChartSurface;
import com.scichart.charting.visuals.axes.AxisInfo;
import com.scichart.charting.visuals.axes.AxisTooltip;
import com.scichart.charting.visuals.axes.DefaultAxisInfoProvider;
import com.scichart.charting.visuals.axes.IAxis;
import com.scichart.charting.visuals.axes.IAxisTooltip;
import com.scichart.charting.visuals.renderableSeries.FastLineRenderableSeries;
import com.scichart.charting.visuals.renderableSeries.hitTest.DefaultXySeriesInfoProvider;
import com.scichart.charting.visuals.renderableSeries.hitTest.XySeriesInfo;
import com.scichart.charting.visuals.renderableSeries.tooltips.ISeriesTooltip;
import com.scichart.charting.visuals.renderableSeries.tooltips.XySeriesTooltip;
import com.scichart.core.framework.UpdateSuspender;
import com.scichart.core.utility.StringUtil;
import com.scichart.drawing.utility.ColorUtil;
import com.scichart.examples.R;
import com.scichart.examples.data.DoubleSeries;
import com.scichart.examples.data.RandomWalkGenerator;
import com.scichart.examples.fragments.base.ExampleSingleChartBaseFragment;
import java.util.Collections;
public class CustomizationRolloverModifierTooltipsFragment extends ExampleSingleChartBaseFragment {
private static final int POINTS_COUNT = 200;
private static final String MODIFIER_NAME = "RolloverModifier";
@Override
protected void initExample(@NonNull SciChartSurface surface) {
final RandomWalkGenerator randomWalkGenerator = new RandomWalkGenerator();
final DoubleSeries data1 = randomWalkGenerator.getRandomWalkSeries(POINTS_COUNT);
randomWalkGenerator.reset();
final DoubleSeries data2 = randomWalkGenerator.getRandomWalkSeries(POINTS_COUNT);
final XyDataSeries<Double, Double> ds1 = sciChartBuilder.newXyDataSeries(Double.class, Double.class).withSeriesName("Series #1").build();
final XyDataSeries<Double, Double> ds2 = sciChartBuilder.newXyDataSeries(Double.class, Double.class).withSeriesName("Series #2").build();
ds1.append(data1.xValues, data1.yValues);
ds2.append(data2.xValues, data2.yValues);
final FastLineRenderableSeries lineRs1 = sciChartBuilder.newLineSeries().withDataSeries(ds1).withSeriesInfoProvider(new FirstCustomSeriesInfoProvider()).withStrokeStyle(0xff6495ed, 2, true).build();
final FastLineRenderableSeries lineRs2 = sciChartBuilder.newLineSeries().withDataSeries(ds2).withSeriesInfoProvider(new SecondCustomSeriesInfoProvider()).withStrokeStyle(0xffe2460c, 2, true).build();
UpdateSuspender.using(surface, () -> {
Collections.addAll(surface.getXAxes(), sciChartBuilder.newNumericAxis().withAxisInfoProvider(new CustomAxisInfoProvider()).build());
Collections.addAll(surface.getYAxes(), sciChartBuilder.newNumericAxis().build());
Collections.addAll(surface.getRenderableSeries(), lineRs1, lineRs2);
Collections.addAll(surface.getChartModifiers(), sciChartBuilder.newModifierGroup().withRolloverModifier().build().build());
sciChartBuilder.newAnimator(lineRs1).withSweepTransformation().withInterpolator(new DecelerateInterpolator()).withDuration(3000).withStartDelay(350).start();
sciChartBuilder.newAnimator(lineRs2).withSweepTransformation().withInterpolator(new DecelerateInterpolator()).withDuration(3000).withStartDelay(350).start();
});
}
private static class FirstCustomSeriesInfoProvider extends DefaultXySeriesInfoProvider {
@Override
protected ISeriesTooltip getSeriesTooltipInternal(Context context, XySeriesInfo<?> seriesInfo, Class<?> modifierType) {
if (modifierType == RolloverModifier.class) {
return new FirstCustomXySeriesTooltip(context, seriesInfo);
} else {
return super.getSeriesTooltipInternal(context, seriesInfo, modifierType);
}
}
private static class FirstCustomXySeriesTooltip extends XySeriesTooltip {
public FirstCustomXySeriesTooltip(Context context, XySeriesInfo<?> seriesInfo) {
super(context, seriesInfo);
}
@Override
protected void internalUpdate(XySeriesInfo seriesInfo) {
final SpannableStringBuilder sb = new SpannableStringBuilder();
sb.append("X: ").append(seriesInfo.getFormattedXValue()).append(StringUtil.NEW_LINE);
sb.append("Y: ").append(seriesInfo.getFormattedYValue()).append(StringUtil.NEW_LINE);
if (seriesInfo.seriesName != null) {
sb.append(seriesInfo.seriesName).append(StringUtil.NEW_LINE);
}
sb.append(MODIFIER_NAME);
setText(sb);
setTooltipBackgroundColor(0xff6495ed);
setTooltipStroke(0xff4d81dd);
setTooltipTextColor(ColorUtil.White);
}
}
}
private static class SecondCustomSeriesInfoProvider extends DefaultXySeriesInfoProvider {
@Override
protected ISeriesTooltip getSeriesTooltipInternal(Context context, XySeriesInfo<?> seriesInfo, Class<?> modifierType) {
if (modifierType == RolloverModifier.class) {
return new SecondCustomXySeriesTooltip(context, seriesInfo);
} else {
return super.getSeriesTooltipInternal(context, seriesInfo, modifierType);
}
}
private static class SecondCustomXySeriesTooltip extends XySeriesTooltip {
public SecondCustomXySeriesTooltip(Context context, XySeriesInfo<?> seriesInfo) {
super(context, seriesInfo);
}
@Override
protected void internalUpdate(XySeriesInfo seriesInfo) {
final SpannableStringBuilder sb = new SpannableStringBuilder();
sb.append(MODIFIER_NAME).append(StringUtil.NEW_LINE);
if (seriesInfo.seriesName != null) {
sb.append(seriesInfo.seriesName).append(StringUtil.NEW_LINE);
}
sb.append("X: ").append(seriesInfo.getFormattedXValue());
sb.append(" Y: ").append(seriesInfo.getFormattedYValue());
setText(sb);
setTooltipBackgroundColor(0xffe2460c);
setTooltipStroke(0xffff4500);
setTooltipTextColor(ColorUtil.White);
}
}
}
private static class CustomAxisInfoProvider extends DefaultAxisInfoProvider {
@Override
protected IAxisTooltip getAxisTooltipInternal(Context context, AxisInfo axisInfo, Class<?> modifierType) {
if (modifierType == RolloverModifier.class) {
return new CustomAxisTooltip(context, axisInfo);
} else {
return super.getAxisTooltipInternal(context, axisInfo, modifierType);
}
}
private static class CustomAxisTooltip extends AxisTooltip {
public CustomAxisTooltip(Context context, AxisInfo axisInfo) {
super(context, axisInfo);
setTooltipBackground(R.drawable.example_custom_axis_tooltip_background);
}
@Override
protected boolean updateInternal(AxisInfo axisInfo) {
final SpannableStringBuilder sb = new SpannableStringBuilder();
sb.append("Axis ID: ").append(axisInfo.axisId).append(StringUtil.NEW_LINE);
sb.append("Value: ").append(axisInfo.axisFormattedDataValue);
setText(sb);
return true;
}
}
}
}