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
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
|
/* -*- 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 .
*/
#ifndef com_sun_star_chart2_data_TabularDataProviderArguments_idl
#define com_sun_star_chart2_data_TabularDataProviderArguments_idl
#include <com/sun/star/chart/ChartDataRowSource.idl>
module com
{
module sun
{
module star
{
module chart2
{
module data
{
service TabularDataProviderArguments
{
/** the range address string spanning all data.
<p>The range address string must be interpretable by the
component that implements XDataProvider and gets
this property as argument to
XDataProvider::detectArguments().</p>
<p>The representation string is of a form that may be used in the
user interface. Example for OOo Calc: "$Sheet1.$A$1:$D$7",
example for OOo Writer: "<Table1.A1:D7>".</p>
<p>When used as input, this range will be split in columns or
rows depending on the property
#DataRowSource.</p>
<p>When used as output of
XDataProvider::detectArguments() this is the
range that spans the ranges of all given
XDataSequences. If the result is ambiguous,
i.e., a splitting of this range would not yield the same
result, this property should be empty. The latter is the
case, when ranges are overlapping, the lengths of sequences
are not equal or even if the order of two sequences is swapped
(e.g. data comes from column A, C, B).</p>
*/
[property] string CellRangeRepresentation;
/** determines, whether data sequences are created out of columns
or rows in a table.
<p>If this property is not given as argument it is assumed to
com::sun::star::chart::ChartDataRowSource::COLUMNS,
i.e., the default is "take data from columns".</p>
*/
[property] ::com::sun::star::chart::ChartDataRowSource DataRowSource;
/** If data comes from columns, the first row will provide the
labels for all sequences, if data comes from rows, the first
column will provide the labels for all sequences.
<p>Even if this property is false, the
XLabeledDataSequence may contain a label, but
this will not be the first cell of the selection. It may be a
generic string like "Column C".</p>
<p>If this property is not given as argument it is assumed to
be `FALSE`, i.e., the default is "no labels".</p>
*/
[property] boolean FirstCellAsLabel;
/** determines the order of the created labeled sequences
<p>For example a SequenceMapping of [3,0,2,1] indicates that
the sequence from old position "3" should now be the first one.
Then comes the sequence from old position "0". Then that one
from old position "2" and then the sequence from old position "1".</p>
<p>If the SequenceMapping contains invalid indexes just
ignore those single indexes. For example if you only have three
labeled sequences and a SequenceMapping [2,5,1,0], you should
ignore the "5" and continue to place the sequence from
old index "1" to the next new position and so on.</p>
<p>If the given SequenceMapping does not cover all existing
labeled sequences just put the remaining sequences in old order
behind the others. For example you have 4 sequences and a
SequenceMapping [3,1]. The result should be as if [3,1,0,2]
was given.</p>
*/
[property] sequence< long > SequenceMapping;
/** If `FALSE` the data provider may create a data sequence
containing generated categories that fit the rest of the data,
like e.g. "Row 12", "Row 13", etc.
<p>This property is not relevant for the splitting up of the
data. It just indicates, if the chart wants to use part of
the data as categories, so that generic categories can be
returned if it doesn't.</p>
<p>The generic category labeled sequence returned should be
the first one in the returned XDataSource. It
needs no label. The values should have their role set to
"categories". The generic strings returned should also be
localized.</p>
*/
[optional, property] boolean HasCategories;
/** This property is for providing proprietary table indexes for
each table appearing in a range given in
CellRangeRepresentation.
@deprecated
<p>This argument is supported by Spreadsheets in order to be
able to export a document into the StarOffice 5.0 binary
format.</p>
<p>Example: If you have the sheets (Sheet1, Sheet2, Sheet3) in
your document and a chart uses the range
"Sheet2.A1:.A5 Sheet3.A1:.A5 Sheet2.B1:.B5 Sheet1:B1:.B5", your
TableNumberList would be "1 2 1 0". A simple range like
"Sheet1.A1:.E4" would have the TableNumberList in "0"</p>.
*/
[optional, property] string TableNumberList;
};
} ; // data
} ; // chart2
} ; // com
} ; // sun
} ; // star
#endif
/* vim:set shiftwidth=4 softtabstop=4 expandtab: */
|
