LibreOffice
LibreOffice 24.2 SDK API Reference
Classes | Typedefs | Enumerations
com::sun::star::chart2::data Module Reference

Chart data provider interfaces. More...

Classes

service  DatabaseDataProvider
 
service  DataFilter
 A filter gets some data and provides some data. More...
 
service  DataProvider
 
service  DataSequence
 describes a container for a sequence of values. More...
 
service  DataSink
 describes a service that allows reading two-dimensional data in the form of a sequence of DataSequences. More...
 
service  DataSource
 describes a service that allows reading two-dimensional data in the form of a sequence of DataSequences. More...
 
struct  HighlightedRange
 
service  LabeledDataSequence
 describes a container for a sequence pair of value-sequences, one for a label and one for the associated data. More...
 
struct  PivotTableFieldEntry
 Pivot table field entry data. More...
 
service  RangeHighlighter
 
service  RangeHighlightListener
 A selection change listener that is attached to a XRangeHighlighter in order to get notified about selection changes that affect range highlighting. More...
 
service  TabularDataProviderArguments
 
interface  XDatabaseDataProvider
 identifies a XDataProvider for result sets. More...
 
interface  XDataProvider
 An application that provides data for a chart must implement this interface. More...
 
interface  XDataReceiver
 
interface  XDataSequence
 allows access to a one-dimensional sequence of data. More...
 
interface  XDataSink
 is a container for sequences of data. More...
 
interface  XDataSource
 provides access to sequences of data. More...
 
interface  XLabeledDataSequence
 allows access to a one-dimensional sequence of data. More...
 
interface  XLabeledDataSequence2
 
interface  XNumericalDataSequence
 allows access to a one-dimensional sequence of double precision floating-point numbers. More...
 
interface  XPivotTableDataProvider
 Data provider specific for pivot chart data. More...
 
interface  XRangeHighlighter
 
interface  XRangeXMLConversion
 An application that provides data for a chart must implement this interface. More...
 
interface  XSheetDataProvider
 Interface specific to spreadsheet data provider backend. More...
 
interface  XTextualDataSequence
 allows access to a one-dimensional sequence of strings. More...
 

Typedefs

typedef string DataSequenceRole
 a string that states in what way a DataSequence should be used. More...
 

Enumerations

enum  LabelOrigin { SHORT_SIDE, LONG_SIDE, COLUMN, ROW }
 is used to specify how the labels have to be created. More...
 

Detailed Description

Chart data provider interfaces.

Typedef Documentation

◆ DataSequenceRole

typedef string DataSequenceRole

a string that states in what way a DataSequence should be used.

If this property is an empty string, no proposition about usage is made.

The strings can have any value. However some values are predefined and should always be interpreted in the same way.

label
values are used as a label for a series. Usually, you will have just one cell containing a string.
values-x
values are used as x-values in an XY- or bubble diagram
values-y
values are used as y-values in an XY-Diagram or as values in a bar, line, etc. chart
values-z
values may be used as z-values in a three-dimensional XYZ-Diagram or a surface-chart
sizes
values are used as radius of the bubbles in a Bubble-Diagram
error-bars-x-positive
values are used as error-information in positive x-direction for displaying error-bars
error-bars-x-negative
values are used as error-information in negative x-direction for displaying error-bars
error-bars-y-positive
values are used as error-information in positive y-direction for displaying error-bars
error-bars-y-negative
values are used as error-information in negative y-direction for displaying error-bars
categories
values are used for categories in the diagram

In a candle-stick chart you have the following roles:

values-first
the first value of a series of values. In a stock-chart this would be the opening course.
values-last
the last value of a series of values. In a stock-chart this would be the closing course.
values-min
the minimum value of a series of values. In a stock-chart this would be the lowest course that occurred during trading.
values-max
the maximum value of a series of values. In a stock-chart this would be the highest course that occurred during trading.

Enumeration Type Documentation

◆ LabelOrigin

is used to specify how the labels have to be created.

See also
XDataSequence::generateLabel().
Enumerator
SHORT_SIDE 

If a range spans a single row over more than one column, this parameter has the same effect as ROW.

If the range spans a single column over more than one row, this is the same as COLUMN.

In case of a range spanning more than one column and row, the shorter range of both should be used (e.g. a spreadsheet range A1:B10 should treat columns as short side).

In case of a rectangular range, or a range that is composed of more than one contiguous sub-regions, the short side cannot be determined, thus XDataSequence::generateLabel() will return an empty sequence.

LONG_SIDE 

This is exactly the opposite of SHORT_SIDE.

I.e., if SHORT_SIDE has the same effect as ROW, LONG_SIDE will have the same effect as COLUMN and the other way round.

See also
LabelOrigin::SHORT_SIDE
COLUMN 

Uses the column name for label generation.

A spreadsheet range A1:A6 could, e.g., result in "Column A".

If a range consists of more than one column the result of label generation may be empty. Of course, it could also succeed with a string like "Columns A to B".

ROW 

Uses the column name for label generation.

A spreadsheet range A2:D2 could, e.g., result in "Row 2".

If a range consists of more than one row the result of label generation may be empty. Of course, it could also succeed with a string like "Rows 1-3".