Sophie

Sophie

distrib > Mandriva > 2008.1 > x86_64 > media > main-testing > by-pkgid > 2c50825dd66d0497b96a67f7fab2ee84 > files > 1875

openoffice.org64-devel-doc-2.4.1.10-1mdv2008.1.x86_64.rpm

<html>
<head>
<title>Service TabularDataProviderArguments</title>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<link rel="stylesheet" type="text/css" href="../../../../../idl.css">
</head>
<body>
<div id="adc-idlref">

<a name="_top_"> </a><table class="navimain" border="0" cellpadding="3">
<tr>
<td class="navimain"><a href="../../module-ix.html" class="navimain">Overview</a></td>
<td class="navimain"><a href="module-ix.html" class="navimain">Module</a></td>
<td class="navimain"><a href="TabularDataProviderArguments-xref.html" class="navimain">Use</a></td>
<td class="navimainnone">Devguide</td>
<td class="navimain"><a href="../../../../../index-files/index-1.html" class="navimain">Index</a></td>
</tr>
</table>
<table class="navisub" border="0" cellpadding="0">
<tr>
<td class="navisub">Included Services</td>
<td class="navisub">Exported Interfaces</td>
<td class="navisub"><a href="#PropertiesSummary" class="navisub">Properties' Summary</a></td>
<td class="navisub"><a href="#PropertiesDetails" class="navisub">Properties' Details</a></td>
</tr>
</table>
<hr>
<table border="0" width="100%" cellpadding="5" cellspacing="3" class="title-table" style="margin-bottom:6pt;">
<tr>
<td><p class="namechain"><a href="../../../../../module-ix.html" class="namechain">::</a> <a href="../../../../module-ix.html" class="namechain">com</a> :: <a href="../../../module-ix.html" class="namechain">sun</a> :: <a href="../../module-ix.html" class="namechain">star</a> :: <a href="../module-ix.html" class="namechain">chart2</a> :: <a href="module-ix.html" class="namechain">data</a> :: </p>
</td>
</tr>
<tr>
<td class="title"><table class="title-table" width="99%">
<tr>
<td width="25%" class="title2">unpublished </td>
<td width="50%" class="title">service TabularDataProviderArguments</td>
<td width="*"/></tr>
</table>
</td>
</tr>
<tr>
<td><dl></dl>
</td>
</tr>
</table>
<hr>
<a name="PropertiesSummary"/><table border="1" width="100%" cellpadding="5" cellspacing="0" class="subtitle">
<tr>
<td class="subtitle" colspan="2">Properties' Summary</td>
</tr>
<tr>
<td class="imsum_left">string<br>
<a href="#CellRangeRepresentation">CellRangeRepresentation</a></td>
<td class="imsum_right">the range address string spanning all data.

 &nbsp;</td>
</tr>
<tr>
<td class="imsum_left">::com::sun::star::<a href="../../chart/module-ix.html">chart</a>::<a href="../../chart/ChartDataRowSource.html">ChartDataRowSource</a><br>
<a href="#DataRowSource">DataRowSource</a></td>
<td class="imsum_right">determines, whether data sequences are created out of columns
 or rows in a table.

 &nbsp;</td>
</tr>
<tr>
<td class="imsum_left">boolean<br>
<a href="#FirstCellAsLabel">FirstCellAsLabel</a></td>
<td class="imsum_right">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.

 &nbsp;</td>
</tr>
<tr>
<td class="imsum_left">sequence&lt; long &gt;<br>
<a href="#SequenceMapping">SequenceMapping</a></td>
<td class="imsum_right">determines the order of the created labeled sequences

 &nbsp;</td>
</tr>
<tr>
<td class="imsum_left">boolean<br>
<a href="#HasCategories">HasCategories</a></td>
<td class="imsum_right"><b>[ OPTIONAL ]<br>
</b>If <b>false</b> 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.

 &nbsp;</td>
</tr>
<tr>
<td class="imsum_left">string<br>
<a href="#TableNumberList">TableNumberList</a></td>
<td class="imsum_right"><b>[ DEPRECATED ]<br>
</b><b>[ OPTIONAL ]<br>
</b>This property is for providing proprietary table indexes for
 each table appearing in a range given in
 CellRangeRepresentation.

 &nbsp;</td>
</tr>
</table>
<a name="PropertiesDetails"/><table border="1" width="100%" cellpadding="5" cellspacing="0" class="subtitle">
<tr>
<td class="subtitle">Properties' Details</td>
</tr>
<tr>
<td class="imdetail"><a name="CellRangeRepresentation" class="membertitle">CellRangeRepresentation</a><table border="0" width="96%" cellpadding="5" cellspacing="0" class="table-in-data" bgcolor="#ffffff" align="center">
<tr>
<td>string <b>CellRangeRepresentation</b>;<hr>
<dl>
<dt><b>Description</b></dt>
<dd>the range address string spanning all data.

 </dd>
<dd><p>The range adress string must be interpretable by the
 component that implements <a href="XDataProvider.html">XDataProvider</a> and gets
 this property as argument to
 <a href="XDataProvider.html">XDataProvider</a>::<a href="XDataProvider.html#detectArguments">detectArguments</a>.</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: "&lt;Table1.A1:D7&gt;".</p>

 <p>When used as input, this range will be split in columns or
 rows depending on the property
 <a href="#DataRowSource">DataRowSource</a>.</p>

 <p>When used as output of
 <a href="XDataProvider.html">XDataProvider</a>::<a href="XDataProvider.html#detectArguments">detectArguments</a> this is the
 range that spans the ranges of all given
 <a href="XDataSequence.html">XDataSequence</a>s. 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>
 </dd>
</dl>
</td>
</tr>
</table>
</td>
</tr>
<tr>
<td class="imdetail"><a name="DataRowSource" class="membertitle">DataRowSource</a><table border="0" width="96%" cellpadding="5" cellspacing="0" class="table-in-data" bgcolor="#ffffff" align="center">
<tr>
<td>::com::sun::star::<a href="../../chart/module-ix.html">chart</a>::<a href="../../chart/ChartDataRowSource.html">ChartDataRowSource</a> <b>DataRowSource</b>;<hr>
<dl>
<dt><b>Description</b></dt>
<dd>determines, whether data sequences are created out of columns
 or rows in a table.

 </dd>
<dd><p>If this property is not given as argument it is assumed to
 ::com::sun::star::<a href="../../chart/module-ix.html">chart</a>::<a href="../../chart/ChartDataRowSource.html">ChartDataRowSource</a>::<a href="../../chart/ChartDataRowSource.html#COLUMNS">COLUMNS</a>,
 i.e., the default is "take data from columns".</p>
 </dd>
</dl>
</td>
</tr>
</table>
</td>
</tr>
<tr>
<td class="imdetail"><a name="FirstCellAsLabel" class="membertitle">FirstCellAsLabel</a><table border="0" width="96%" cellpadding="5" cellspacing="0" class="table-in-data" bgcolor="#ffffff" align="center">
<tr>
<td>boolean <b>FirstCellAsLabel</b>;<hr>
<dl>
<dt><b>Description</b></dt>
<dd>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.

 </dd>
<dd><p>Even if this property is false, the
 <a href="XLabeledDataSequence.html">XLabeledDataSequence</a> 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 <b>false</b>, i.e., the default is "no labels".</p>
 </dd>
</dl>
</td>
</tr>
</table>
</td>
</tr>
<tr>
<td class="imdetail"><a name="SequenceMapping" class="membertitle">SequenceMapping</a><table border="0" width="96%" cellpadding="5" cellspacing="0" class="table-in-data" bgcolor="#ffffff" align="center">
<tr>
<td>sequence&lt; long &gt; <b>SequenceMapping</b>;<hr>
<dl>
<dt><b>Description</b></dt>
<dd>determines the order of the created labeled sequences

 </dd>
<dd><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 exsisting
 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 a as if [3,1,0,2]
 was given.</p>
 </dd>
</dl>
</td>
</tr>
</table>
</td>
</tr>
<tr>
<td class="imdetail"><a name="HasCategories" class="membertitle">HasCategories</a><table border="0" width="96%" cellpadding="5" cellspacing="0" class="table-in-data" bgcolor="#ffffff" align="center">
<tr>
<td>boolean <b>HasCategories</b>;<hr>
<dl>
<dt><b>Usage Restrictions</b></dt>
<dd><i>optional</i></dd>
<dt><b>Description</b></dt>
<dd>If <b>false</b> 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.

 </dd>
<dd><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 <a href="XDataSource.html">XDataSource</a>. It
 needs no label. The values should have their role set to
 "categories". The generic strings returned should also be
 localized.</p>
 </dd>
</dl>
</td>
</tr>
</table>
</td>
</tr>
<tr>
<td class="imdetail"><a name="TableNumberList" class="membertitle">TableNumberList</a><table border="0" width="96%" cellpadding="5" cellspacing="0" class="table-in-data" bgcolor="#ffffff" align="center">
<tr>
<td>string <b>TableNumberList</b>;<hr>
<dl>
<dt><b>Usage Restrictions</b></dt>
<dd><i>deprecated</i></dd>
<dd><i>optional</i></dd>
<dt><b>Deprecation Info</b></dt>
<dd><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>.
 </dd>
<dt><b>Description</b></dt>
<dd>This property is for providing proprietary table indexes for
 each table appearing in a range given in
 CellRangeRepresentation.

 </dd>
</dl>
</td>
</tr>
</table>
</td>
</tr>
</table>
<br>&nbsp;<a href="#_top_">Top of Page</a><hr size="3"><p class="copyright" align="center">Copyright &copy; 2008 Sun Microsystems, Inc.</p>

</div> <!-- id="adc-idlref" -->
</body>

</html>