office-gobmx/offapi/com/sun/star/chart2/data/XDataSequence.idl
Stephan Bergmann 5687eba49f Drop obsolete preprocessor directives from UNOIDL files
...which were used by ildc, which is gone since
a8485d558f "[API CHANGE] Remove deprecated idlc
and regmerge from the SDK", and have always been ignored as legacy by its
unoidl-write replacement.

This change has been carried out (making use of GNU sed extensions) with

> for i in $(git ls-files \*.idl); do sed -i -z -E -e 's/\n\n((#[^\n]*\n)+\n)*(#[^\n]*\n)+\n?/\n\n/g' -e 's/\n(#[^\n]*\n)+/\n/g' "$i"; done && git checkout extensions/source/activex/so_activex.idl odk/examples/OLE/activex/so_activex.idl

which apparently happened to do the work.  (The final two files are not UNOIDL
source files.)

Change-Id: Ic9369e05d46e8f7e8a304ab01740b171b92335cd
Reviewed-on: https://gerrit.libreoffice.org/c/core/+/135683
Tested-by: Jenkins
Reviewed-by: Stephan Bergmann <sbergman@redhat.com>
2022-06-13 16:27:45 +02:00

123 lines
4.5 KiB
Text

/* -*- 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 .
*/
module com
{
module sun
{
module star
{
module chart2
{
module data
{
/** allows access to a one-dimensional sequence of data.
<p>The data that is stored in this container may contain different
types.</p>
*/
interface XDataSequence : ::com::sun::star::uno::XInterface
{
/** retrieves the data stored in this component.
@return a sequence containing the actual data. This sequence
is a copy of the internal data. Therefore changing
this object does not affect the content of the
XDataSequence object.
*/
sequence< any > getData();
/** returns the (UI) range representation string used by this
XDataSequence.
*/
string getSourceRangeRepresentation();
/** creates a label that describes the origin of this data
sequence.
<p>This is useful, if a XLabeledDataSequence has
no label sequence. In this case you can call this method at
the value sequence to obtain a fitting replacement label.</p>
<p>The sequence returned here may be empty if no suitable
label can be generated.</p>
<p>The strings returned should be localized.</p>
@param eLabelOrigin
denotes what part of the range should be used for label
generation. If you have, e.g., one cell only, the
parameter COLUMN enables you to get the name of the cell's
column, the parameter ROW will give you its row name.
If you have a non quadratic range you can ask for labels for
the longer side with parameter LONG_SIDE or you can obtain labels
for the shorter side with parameter SHORT_SIDE.
If the range is not structured in a tabular way you may receive
no label.
@return
Suitable labels for the given sequence depending on the range
of the sequence and the parameter <code>eLabelOrigin</code> passed.
In a spreadsheet this would typically be a label like "Column x"
for the short side used as DataSeries name and maybe a
sequence "Row 1" "Row 2" "Row 3" for the long side to be used
as categories for example.
Example: Assuming this sequence has a Range representation spanning
row 5 and 6 in column 8. Following sequences of strings or similar strings
are expected as return values:
generateLabel( SHORT_SIDE ) -> "Column 8"
generateLabel( LONG_SIDE ) -> "Row 5" "Row 6"
generateLabel( COLUMN ) -> "Column 8"
generateLabel( ROW ) -> "Row 5" "Row 6"
Which strings exactly you return depends on the naming scheme of the application
which provides its tabular data.
*/
sequence< string > generateLabel( [in] com::sun::star::chart2::data::LabelOrigin eLabelOrigin );
/** returns a number format key for the value at the given index
in the data sequence. If nIndex is -1, a key for the entire
sequence should be returned, e.g. the most commonly used one.
<p>If number formats are not supported, or there is no
heuristic to return a key for the entire series, return 0
here.</p>
<p>The number format key must be valid for the
com::sun::star::util::XNumberFormatsSupplier
given by the XDataProvider, or 0 which is assumed
to be always valid.</p>
*/
long getNumberFormatKeyByIndex( [in] long nIndex )
raises( ::com::sun::star::lang::IndexOutOfBoundsException );
};
} ; // data
} ; // chart2
} ; // com
} ; // sun
} ; // star
/* vim:set shiftwidth=4 softtabstop=4 expandtab: */