/* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */ /* * This file is part of the LibreOffice project. * * This Source Code Form is subject to the terms of the Mozilla Public * License, v. 2.0. If a copy of the MPL was not distributed with this * file, You can obtain one at http://mozilla.org/MPL/2.0/. * * This file incorporates work covered by the following license notice: * * Licensed to the Apache Software Foundation (ASF) under one or more * contributor license agreements. See the NOTICE file distributed * with this work for additional information regarding copyright * ownership. The ASF licenses this file to you under the Apache * License, Version 2.0 (the "License"); you may not use this file * except in compliance with the License. You may obtain a copy of * the License at http://www.apache.org/licenses/LICENSE-2.0 .
*/ #pragma once
/** * A list of series that have the same CoordinateSystem. They are used to be * plotted maybe in a stacked manner by a plotter.
*/ class VDataSeriesGroup final
{ public:
VDataSeriesGroup() = delete;
VDataSeriesGroup( std::unique_ptr<VDataSeries> pSeries );
VDataSeriesGroup(VDataSeriesGroup&&) noexcept;
~VDataSeriesGroup();
class VSeriesPlotter : public PlotterBase, public MinimumAndMaximumSupplier, public LegendEntryProvider
{ public:
VSeriesPlotter() = delete;
virtual ~VSeriesPlotter() override;
/** * A new series can be positioned relative to other series in a chart. * This positioning has two dimensions. First a series can be placed * next to each other on the category axis. This position is indicated by xSlot. * Second a series can be stacked on top of another. This position is indicated by ySlot. * The positions are counted from 0 on. * xSlot < 0 : append the series to already existing x series * xSlot > occupied : append the series to already existing x series * * If the xSlot is already occupied the given ySlot decides what should happen: * ySlot < -1 : move all existing series in the xSlot to next slot * ySlot == -1 : stack on top at given x position * ySlot == already occupied : insert at given y and x position * ySlot > occupied : stack on top at given x position
*/ virtualvoid addSeries( std::unique_ptr<VDataSeries> pSeries, sal_Int32 zSlot, sal_Int32 xSlot, sal_Int32 ySlot );
/** a value <= 0 for a directions means that this direction can be stretched arbitrary
*/ virtual css::drawing::Direction3D getPreferredDiagramAspectRatio() const;
/** this enables you to handle series on the same x axis with different y axis the property AttachedAxisIndex at a dataseries indicates which value scale is to use (0==AttachedAxisIndex or a not set AttachedAxisIndex property indicates that this series should be scaled at the main y-axis; 1==AttachedAxisIndex indicates that the series should be scaled at the first secondary axis if there is any otherwise at the main y axis and so on. The parameter nAxisIndex matches this DataSeries property 'AttachedAxisIndex'. nAxisIndex must be greater than 0. nAxisIndex==1 refers to the first secondary axis. )
// This method creates a series plotter of the requested type; e.g. : return new PieChart... static VSeriesPlotter* createSeriesPlotter( const rtl::Reference< ::chart::ChartType >& xChartTypeModel
, sal_Int32 nDimensionCount
, bool bExcludingPositioning /*for pie and donut charts labels and exploded segments are excluded from the given size*/);
/// This method returns a text string representation of the passed numeric /// value by exploiting a NumberFormatterWrapper object.
OUString getLabelTextForValue(VDataSeries const & rDataSeries, sal_Int32 nPointIndex, double fValue, bool bAsPercentage);
//the following group shapes will be created as children of SeriesGroupShape on demand //they can be used to assure that some parts of a series shape are always in front of others (e.g. symbols in front of lines) //parameter xTarget will be used as parent for the series group shape
rtl::Reference<SvxShapeGroupAnyD>
getSeriesGroupShapeFrontChild( VDataSeries* pDataSeries
, const rtl::Reference<SvxShapeGroupAnyD>& xTarget );
rtl::Reference<SvxShapeGroupAnyD>
getSeriesGroupShapeBackChild( VDataSeries* pDataSeries
, const rtl::Reference<SvxShapeGroupAnyD>& xTarget );
/// This method creates a 2D group shape for containing all text shapes /// needed for this series; the group is added to the text target; static rtl::Reference<SvxShapeGroup>
getLabelsGroupShape( VDataSeries& rDataSeries
, const rtl::Reference<SvxShapeGroupAnyD>& xTarget );
/** This method creates a text shape for a label related to a data point * and append it to the root text shape group (xTarget). * * @param xTarget * the main root text shape group. * @param rDataSeries * the data series, the data point belongs to. * @param nPointIndex * the index of the data point the label is related to. * @param fValue * the value of the data point. * @param fSumValue * the sum of all data point values in the data series. * @param rScreenPosition2D * the anchor point position for the label. * @param eAlignment * the required alignment of the label. * @param offset * an optional offset depending on the label alignment. * @param nTextWidth * the maximum width of a text label (used for text wrapping). * * @return * a reference to the created text shape.
*/
rtl::Reference<SvxShapeText>
createDataLabel( const rtl::Reference<SvxShapeGroupAnyD>& xTarget
, VDataSeries& rDataSeries
, sal_Int32 nPointIndex
, double fValue
, double fSumValue
, const css::awt::Point& rScreenPosition2D
, LabelAlignment eAlignment
, sal_Int32 nOffset=0
, sal_Int32 nTextWidth = 0 );
/** creates two T-shaped error bars in both directions (up/down or left/right depending on the bVertical parameter)
@param rPos logic coordinates
@param xErrorBarProperties the XPropertySet returned by the DataPoint-property "ErrorBarX" or "ErrorBarY".
@param nIndex the index of the data point in rData for which the calculation is done.
@param bVertical for y-error bars this is true, for x-error-bars it is false.
*/ void createErrorBar( const rtl::Reference<SvxShapeGroupAnyD>& xTarget
, const css::drawing::Position3D & rPos
, const css::uno::Reference< css::beans::XPropertySet > & xErrorBarProperties
, const VDataSeries& rVDataSeries
, sal_Int32 nIndex
, bool bVertical
, constdouble* pfScaledLogicX
);
virtual PlottingPositionHelper& getPlottingPositionHelper( sal_Int32 nAxisIndex ) const;//nAxisIndex indicates whether the position belongs to the main axis ( nAxisIndex==0 ) or secondary axis ( nAxisIndex==1 )
bool m_bCategoryXAxis;//true->xvalues are indices (this would not be necessary if series for category chart wouldn't have x-values)
tools::Long m_nTimeResolution;
Date m_aNullDate;
Die Informationen auf dieser Webseite wurden
nach bestem Wissen sorgfältig zusammengestellt. Es wird jedoch weder Vollständigkeit, noch Richtigkeit,
noch Qualität der bereit gestellten Informationen zugesichert.
Bemerkung:
Die farbliche Syntaxdarstellung und die Messung sind noch experimentell.
