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 control. This examples demonstrates how to do this using CursorModifier.
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 cursor tooltip itself.
The full source code for the Android Chart Custom Cursors 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
//
// CustomizationCursorModifierTooltipsFragment.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.util.TypedValue
import android.view.animation.DecelerateInterpolator
import com.scichart.charting.modifiers.CursorModifier
import com.scichart.charting.visuals.SciChartSurface
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.*
import kotlin.math.roundToInt
class CustomizationCursorModifierTooltipsFragment: 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() }
renderableSeries {
fastLineRenderableSeries {
xyDataSeries<Double, Double>("Series #1") {
append(data1.xValues, data1.yValues)
}
strokeStyle = SolidPenStyle(0xff6495ed, 2f)
seriesInfoProvider = CustomSeriesInfoProvider()
sweepAnimation { interpolator = DecelerateInterpolator() }
}
fastLineRenderableSeries {
xyDataSeries<Double, Double>("Series #2") {
append(data2.xValues, data2.yValues)
}
strokeStyle = SolidPenStyle(0xffe2460c, 2f)
seriesInfoProvider = CustomSeriesInfoProvider()
sweepAnimation { interpolator = DecelerateInterpolator() }
}
}
val cursorModifier = CursorModifier(R.layout.example_custom_cursor_modifier_tooltip_container).apply {
val thickness = TypedValue.applyDimension(TypedValue.COMPLEX_UNIT_DIP, 2f, resources.displayMetrics)
SolidPenStyle(0xAAFFA500, thickness).initPaint(crosshairPaint)
}
chartModifiers { modifier(cursorModifier) }
}
}
private class CustomSeriesInfoProvider : DefaultXySeriesInfoProvider() {
override fun getSeriesTooltipInternal(context: Context, seriesInfo: XySeriesInfo<*>?, modifierType: Class<*>): ISeriesTooltip {
return when (modifierType) {
CursorModifier::class.java -> { CustomXySeriesTooltip(context, seriesInfo) }
else -> { super.getSeriesTooltipInternal(context, seriesInfo, modifierType) }
}
}
private class CustomXySeriesTooltip(context: Context?, seriesInfo: XySeriesInfo<*>?) : XySeriesTooltip(context, seriesInfo) {
init {
val displayMetrics = resources.displayMetrics
val padding = TypedValue.applyDimension(TypedValue.COMPLEX_UNIT_DIP, 1f, displayMetrics).roundToInt()
setPadding(padding, padding, padding, padding)
}
override fun internalUpdate(seriesInfo: XySeriesInfo<*>) {
val sb = SpannableStringBuilder()
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(0xff6495ed.toInt())
setTooltipStroke(0xff4d81dd.toInt())
setTooltipTextColor(ColorUtil.White)
}
}
}
companion object {
private const val POINTS_COUNT = 200
}
}
//******************************************************************************
// SCICHART® Copyright SciChart Ltd. 2011-2021. All rights reserved.
//
// Web: http://www.scichart.com
// Support: support@scichart.com
// Sales: sales@scichart.com
//
// CustomizationCursorModifierTooltipsFragment.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.util.DisplayMetrics;
import android.util.TypedValue;
import android.view.animation.DecelerateInterpolator;
import androidx.annotation.NonNull;
import com.scichart.charting.model.dataSeries.XyDataSeries;
import com.scichart.charting.modifiers.CursorModifier;
import com.scichart.charting.visuals.SciChartSurface;
import com.scichart.charting.visuals.axes.IAxis;
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.drawing.common.SolidPenStyle;
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 CustomizationCursorModifierTooltipsFragment extends ExampleSingleChartBaseFragment {
private static final int POINTS_COUNT = 200;
@Override
protected void initExample(@NonNull SciChartSurface surface) {
final IAxis xAxis = sciChartBuilder.newNumericAxis().build();
final IAxis yAxis = sciChartBuilder.newNumericAxis().build();
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 CustomSeriesInfoProvider()).withStrokeStyle(0xff6495ed, 2, true).build();
final FastLineRenderableSeries lineRs2 = sciChartBuilder.newLineSeries().withDataSeries(ds2).withSeriesInfoProvider(new CustomSeriesInfoProvider()).withStrokeStyle(0xffe2460c, 2, true).build();
final CursorModifier cursorModifier = new CursorModifier(R.layout.example_custom_cursor_modifier_tooltip_container);
UpdateSuspender.using(surface, () -> {
Collections.addAll(surface.getXAxes(), xAxis);
Collections.addAll(surface.getYAxes(), yAxis);
Collections.addAll(surface.getRenderableSeries(), lineRs1, lineRs2);
Collections.addAll(surface.getChartModifiers(), cursorModifier);
final DisplayMetrics displayMetrics = getActivity().getResources().getDisplayMetrics();
final float thickness = TypedValue.applyDimension(TypedValue.COMPLEX_UNIT_DIP, 2f, displayMetrics);
new SolidPenStyle(0xAAFFA500, false, thickness, null).initPaint(cursorModifier.getCrosshairPaint());
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 CustomSeriesInfoProvider extends DefaultXySeriesInfoProvider {
@Override
protected ISeriesTooltip getSeriesTooltipInternal(Context context, XySeriesInfo<?> seriesInfo, Class<?> modifierType) {
if (modifierType == CursorModifier.class) {
return new CustomXySeriesTooltip(context, seriesInfo);
} else {
return super.getSeriesTooltipInternal(context, seriesInfo, modifierType);
}
}
private static class CustomXySeriesTooltip extends XySeriesTooltip {
public CustomXySeriesTooltip(Context context, XySeriesInfo<?> seriesInfo) {
super(context, seriesInfo);
final DisplayMetrics displayMetrics = context.getResources().getDisplayMetrics();
final int padding = Math.round(TypedValue.applyDimension(TypedValue.COMPLEX_UNIT_DIP, 1f, displayMetrics));
this.setPadding(padding, padding, padding, padding);
}
@Override
protected void internalUpdate(XySeriesInfo seriesInfo) {
final SpannableStringBuilder sb = new SpannableStringBuilder();
if (seriesInfo.seriesName != null) {
sb.append(seriesInfo.seriesName).append(" - ");
}
sb.append("X: ").append(seriesInfo.getFormattedXValue());
sb.append(" Y: ").append(seriesInfo.getFormattedYValue());
setText(sb);
setTooltipBackgroundColor(0xff6495ed);
setTooltipStroke(0xff4d81dd);
setTooltipTextColor(ColorUtil.White);
}
}
}
}