Sophie

Sophie

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

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

<html>
<head>
<title>Interface XDataSequence</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="XDataSequence-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"><a href="#MethodsSummary" class="navisub">Methods' Summary</a></td>
<td class="navisub"><a href="#MethodsDetails" class="navisub">Methods' Details</a></td>
<td class="navisub">Attributes' Summary</td>
<td class="navisub">Attributes' Details</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">interface XDataSequence</td>
<td width="*"/></tr>
</table>
</td>
</tr>
<tr>
<td/></tr>
<tr>
<td><dl>
<dt><b>Description</b></dt>
<dd>allows acces to a one-dimensional sequence of data.

 </dd>
<dd><p>The data that is stored in this container may contain different
 types.</p>
 </dd>
</dl>
</td>
</tr>
</table>
<hr>
<a name="MethodsSummary"/><table border="1" width="100%" cellpadding="5" cellspacing="0" class="subtitle">
<tr>
<td class="subtitle" colspan="2">Methods' Summary</td>
</tr>
<tr>
<td class="imsum_left"><a href="#getData">getData</a></td>
<td class="imsum_right">retrieves the data stored in this component.

 &nbsp;</td>
</tr>
<tr>
<td class="imsum_left"><a href="#getSourceRangeRepresentation">getSourceRangeRepresentation</a></td>
<td class="imsum_right">returns the (UI) range representation string used by this
 <a href="XDataSequence.html">XDataSequence</a>.
 &nbsp;</td>
</tr>
<tr>
<td class="imsum_left"><a href="#generateLabel">generateLabel</a></td>
<td class="imsum_right">creates a label that describes the origin of this data
 sequence.

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

 &nbsp;</td>
</tr>
</table>
<a name="MethodsDetails"/><table border="1" width="100%" cellpadding="5" cellspacing="0" class="subtitle">
<tr>
<td class="subtitle">Methods' Details</td>
</tr>
<tr>
<td class="imdetail"><a name="getData" class="membertitle">getData</a><table border="0" width="96%" cellpadding="5" cellspacing="0" class="table-in-method" bgcolor="#ffffff" align="center">
<tr>
<td><table class="table-in-method" border="0">
<tr>
<td valign="top" colspan="3">sequence&lt; any &gt;</td>
</tr>
<tr>
<td valign="top"><b>getData</b>();</td>
</tr>
</table>
<hr>
<dl>
<dt><b>Description</b></dt>
<dd>retrieves the data stored in this component.

 </dd>
<dt><b>Returns</b></dt>
<dd>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.
 </dd>
</dl>
</td>
</tr>
</table>
</td>
</tr>
<tr>
<td class="imdetail"><a name="getSourceRangeRepresentation" class="membertitle">getSourceRangeRepresentation</a><table border="0" width="96%" cellpadding="5" cellspacing="0" class="table-in-method" bgcolor="#ffffff" align="center">
<tr>
<td><table class="table-in-method" border="0">
<tr>
<td valign="top" colspan="3">string</td>
</tr>
<tr>
<td valign="top"><b>getSourceRangeRepresentation</b>();</td>
</tr>
</table>
<hr>
<dl>
<dt><b>Description</b></dt>
<dd>returns the (UI) range representation string used by this
 <a href="XDataSequence.html">XDataSequence</a>.
 </dd>
</dl>
</td>
</tr>
</table>
</td>
</tr>
<tr>
<td class="imdetail"><a name="generateLabel" class="membertitle">generateLabel</a><table border="0" width="96%" cellpadding="5" cellspacing="0" class="table-in-method" bgcolor="#ffffff" align="center">
<tr>
<td><table class="table-in-method" border="0">
<tr>
<td valign="top" colspan="3">sequence&lt; string &gt;</td>
</tr>
<tr>
<td valign="top"><b>generateLabel</b>(</td>
<td valign="top">[in] <a href="LabelOrigin.html">LabelOrigin</a></td>
<td valign="bottom">&nbsp;eLabelOrigin );</td>
</tr>
</table>
<hr>
<dl>
<dt><b>Description</b></dt>
<dd>creates a label that describes the origin of this data
 sequence.

 </dd>
<dd><p>This is useful, if a <a href="XLabeledDataSequence.html">XLabeledDataSequence</a> 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>

 </dd>
<dt><b>Parameter eLabelOrigin</b></dt>
<dd>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 reveive
 no label.

 </dd>
<dt><b>Returns</b></dt>
<dd>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 Rangerepresentation 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.
 </dd>
</dl>
</td>
</tr>
</table>
</td>
</tr>
<tr>
<td class="imdetail"><a name="getNumberFormatKeyByIndex" class="membertitle">getNumberFormatKeyByIndex</a><table border="0" width="96%" cellpadding="5" cellspacing="0" class="table-in-method" bgcolor="#ffffff" align="center">
<tr>
<td><table class="table-in-method" border="0">
<tr>
<td valign="top" colspan="3">long</td>
</tr>
<tr>
<td valign="top"><b>getNumberFormatKeyByIndex</b>(</td>
<td valign="top">[in] long</td>
<td valign="bottom">&nbsp;nIndex )</td>
</tr>
<tr>
<td valign="top" align="right">raises( </td>
<td valign="top" colspan="2">::com::sun::star::<a href="../../lang/module-ix.html">lang</a>::<a href="../../lang/IndexOutOfBoundsException.html">IndexOutOfBoundsException</a> );</td>
</tr>
</table>
<hr>
<dl>
<dt><b>Description</b></dt>
<dd>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.

 </dd>
<dd><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::<a href="../../util/module-ix.html">util</a>::<a href="../../util/XNumberFormatsSupplier.html">XNumberFormatsSupplier</a>
 given by the <a href="XDataProvider.html">XDataProvider</a>, or 0 which is assumed
 to be always valid.</p>
 </dd>
</dl>
</td>
</tr>
</table>
</td>
</tr>
</table>
<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>