1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
|
/* -*- 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
#include <cppuhelper/implbase.hxx>
#include <com/sun/star/lang/XServiceInfo.hpp>
#include <com/sun/star/beans/PropertyValue.hpp>
#include <com/sun/star/chart2/InterpretedData.hpp>
#include <com/sun/star/chart2/data/XDataSource.hpp>
#include <com/sun/star/chart2/XDataSeries.hpp>
namespace chart
{
/** offers tooling to interpret different data sources in a structural
and chart-type-dependent way.
*/
class DataInterpreter : public ::cppu::WeakImplHelper<
css::lang::XServiceInfo >
{
public:
explicit DataInterpreter();
virtual ~DataInterpreter() override;
/// XServiceInfo declarations
virtual OUString SAL_CALL getImplementationName() override;
virtual sal_Bool SAL_CALL supportsService( const OUString& ServiceName ) override;
virtual css::uno::Sequence< OUString > SAL_CALL getSupportedServiceNames() override;
// convenience methods
static OUString GetRole( const css::uno::Reference< css::chart2::data::XDataSequence > & xSeq );
static void SetRole(
const css::uno::Reference< css::chart2::data::XDataSequence > & xSeq,
const OUString & rRole );
static css::uno::Any GetProperty(
const css::uno::Sequence<css::beans::PropertyValue > & aArguments,
std::u16string_view rName );
static bool HasCategories(
const css::uno::Sequence< css::beans::PropertyValue > & rArguments,
const css::uno::Sequence< css::uno::Reference< css::chart2::data::XLabeledDataSequence > > & rData );
static bool UseCategoriesAsX(
const css::uno::Sequence< css::beans::PropertyValue > & rArguments );
// ____ DataInterpreter ____
/** Interprets the given data.
@param xSource
the data source.
@param aArguments
Arguments that tell the template how to slice the given
range. The properties should be defined in a separate
service.
<p>For standard parameters that may be used, see the
service StandardDiagramCreationParameters.
</p>
@param aSeriesToReUse
use all the data series given here for the result before
creating new ones.
*/
virtual css::chart2::InterpretedData interpretDataSource(
const css::uno::Reference< css::chart2::data::XDataSource >& xSource,
const css::uno::Sequence< css::beans::PropertyValue >& aArguments,
const css::uno::Sequence< css::uno::Reference< css::chart2::XDataSeries > >& aSeriesToReUse );
/** Re-interprets the data given in <code>aInterpretedData</code>
while keeping the number of data series and the categories.
*/
virtual css::chart2::InterpretedData reinterpretDataSeries(
const css::chart2::InterpretedData& aInterpretedData );
/** parses the given data and states, if a
reinterpretDataSeries() call can be done
without data loss.
@return
`TRUE`, if the data given in
<code>aInterpretedData</code> has a similar structure than
the one required is used as output of the data interpreter.
*/
virtual bool isDataCompatible(
const css::chart2::InterpretedData& aInterpretedData );
/** Try to reverse the operation done in
interpretDataSource().
<p>In case <code>aInterpretedData</code> is the result of
interpretDataSource()( <code>xSource</code> ),
the result of this method should be <code>xSource</code>.</p>
*/
virtual css::uno::Reference< css::chart2::data::XDataSource > mergeInterpretedData(
const css::chart2::InterpretedData& aInterpretedData );
/** Get chart information that is specific to a particular chart
type, by key.
@param sKey
name of the piece of data to retrieve.
<p>Supported key strings:</p>
<ul>
<li><tt>"stock variant"</tt>: stock chart variant,
with 0 = neither Open Values nor volume, 1 = Open Values,
2 = volume, 3 = both. Valid for candlestick charts.</li>
</ul>
@return
The value requested, or nothing if not present.
*/
virtual css::uno::Any getChartTypeSpecificData(
const OUString& sKey );
};
} // namespace chart
/* vim:set shiftwidth=4 softtabstop=4 expandtab: */
|
