:: com :: sun :: star :: text ::

service TextTable
Description
is a table of text cells which is anchored to a surrounding text.

Note: The anchor of the actual implementation for text tables does not have a position in the text. Thus that anchor can not be used for some operation like XTextContent::attach or XText::insertTextContent or other function that require the object to have a position in the text.

The reason why a text table still needs an anchor is that for example tables should be insertable via XText::insertTextContent and that interface uses a parameter of that type.

Example

Create and insert a TextTable:

 xTable = xTextDoc.createInstance( "com.sun.star.text.TextTable" )
 xTable.initialize(5, 8)
 xTable.HoriOrient = 0 'com::sun::star::text::HoriOrientation::NONE
 xTable.LeftMargin = 2000
 xTable.RightMargin = 1500
 xTextDoc.getText.insertTextContent( xTextRange, xTable, false )
 
See also
Cell, CellRange, TableColumns, TableRows, TextTableCursor
Developers Guide
Text - Tables - Table Architecture

Included Services - Summary
TextContent
(referenced entity's summary:)
is an object which can be anchored in a text, like instances of TextFrame or TextField.
::com::sun::star::xml::UserDefinedAttributesSupplier
Exported Interfaces - Summary
XTextTable
(referenced entity's summary:)
manages a text table.
::com::sun::star::container::XNamed
(referenced entity's summary:)
specifies the name of the object.
::com::sun::star::table::XCellRange
(referenced entity's summary:)
provides access to the cells or to sub-ranges of a cell range.
::com::sun::star::chart::XChartDataArray
(referenced entity's summary:)
gives access to data represented as an array of rows.
::com::sun::star::table::XAutoFormattable
(referenced entity's summary:)
provides a method to apply TableAutoFormats to a cell range.
::com::sun::star::util::XSortable
(referenced entity's summary:)
makes it possible to sort the contents of this object.
::com::sun::star::sheet::XCellRangeData
Properties' Summary
::com::sun::star::style::BreakType
BreakType
determines the type of break that is applied at the beginning of the table. 
long
LeftMargin
contains the left margin of the table.  
long
RightMargin
contains the right margin of the table.  
short
HoriOrient
contains the horizontal orientation. 
boolean
KeepTogether
Setting this property to TRUE prevents page or column breaks between this table and the following paragraph or text table.  
boolean
Split
Setting this property to FALSE prevents the table from getting spread on two pages.  
short
PageNumberOffset
If a page break property is set at the table, this property contains the new value for the page number.  
string
PageDescName
If this property is set, it creates a page break before the table and assigns the value as the name of the new page style sheet to use.  
short
RelativeWidth
determines the width of the table relative to its environment.  
boolean
IsWidthRelative
determines if the value of the relative width is valid.  
boolean
RepeatHeadline
determines if the first row of the table is repeated on every new page.  
long
HeaderRowCount
[ OPTIONAL ]
determines the number of rows of the table repeated on every new page.  
::com::sun::star::table::ShadowFormat
ShadowFormat
determines the type, color and size of the shadow. 
long
TopMargin
determines the top margin.  
long
BottomMargin
determines the bottom margin.  
boolean
BackTransparent
determines if the background color is transparent.  
long
Width
contains the absolute table width.  
boolean
ChartRowAsLabel
determines if the first row of the table should be treated as axis labels when a chart is to be created.  
boolean
ChartColumnAsLabel
determines if the first column of the table should be treated as axis labels when a chart is to be created.  
::com::sun::star::table::TableBorder
TableBorder
contains the description of the table borders. 
sequence< TableColumnSeparator >
TableColumnSeparators
contains the column description of the table.  
short
TableColumnRelativeSum
contains the sum of the column width values used in TableColumnSeparators.  
::com::sun::star::util::Color
BackColor
contains the color of the background.  
string
BackGraphicURL
contains the URL for the background graphic.  
string
BackGraphicFilter
contains the name of the file filter for the background graphic.  
::com::sun::star::style::GraphicLocation
BackGraphicLocation
determines the position of the background graphic. 
boolean
CollapsingBorders
[ OPTIONAL ]
determines whether borders of neighboring table cells are * collapsed into one  
Included Services - Details
TextContent
(referenced entity's summary:)
is an object which can be anchored in a text, like instances of TextFrame or TextField.
::com::sun::star::xml::UserDefinedAttributesSupplier
Usage Restrictions
optional
Exported Interfaces - Details
XTextTable
(referenced entity's summary:)
manages a text table.
::com::sun::star::container::XNamed
(referenced entity's summary:)
specifies the name of the object.
::com::sun::star::table::XCellRange
(referenced entity's summary:)
provides access to the cells or to sub-ranges of a cell range.
::com::sun::star::chart::XChartDataArray
(referenced entity's summary:)
gives access to data represented as an array of rows.
::com::sun::star::table::XAutoFormattable
(referenced entity's summary:)
provides a method to apply TableAutoFormats to a cell range.
::com::sun::star::util::XSortable
(referenced entity's summary:)
makes it possible to sort the contents of this object.
::com::sun::star::sheet::XCellRangeData
Usage Restrictions
optional
Properties' Details
BreakType
::com::sun::star::style::BreakType BreakType;
Description
determines the type of break that is applied at the beginning of the table.
See also
com.sun.star.style.BreakType
LeftMargin
long LeftMargin;
Description
contains the left margin of the table.
RightMargin
long RightMargin;
Description
contains the right margin of the table.
HoriOrient
short HoriOrient;
Description
contains the horizontal orientation.
See also
com.sun.star.text.HoriOrientation
KeepTogether
boolean KeepTogether;
Description
Setting this property to TRUE prevents page or column breaks between this table and the following paragraph or text table.
Split
boolean Split;
Description
Setting this property to FALSE prevents the table from getting spread on two pages.
PageNumberOffset
short PageNumberOffset;
Description
If a page break property is set at the table, this property contains the new value for the page number.
PageDescName
string PageDescName;
Description
If this property is set, it creates a page break before the table and assigns the value as the name of the new page style sheet to use.
RelativeWidth
short RelativeWidth;
Description
determines the width of the table relative to its environment.
IsWidthRelative
boolean IsWidthRelative;
Description
determines if the value of the relative width is valid.
RepeatHeadline
boolean RepeatHeadline;
Description
determines if the first row of the table is repeated on every new page.
HeaderRowCount
long HeaderRowCount;
Usage Restrictions
optional
Description
determines the number of rows of the table repeated on every new page.
ShadowFormat
::com::sun::star::table::ShadowFormat ShadowFormat;
Description
determines the type, color and size of the shadow.
See also
com.sun.star.table.ShadowFormat
TopMargin
long TopMargin;
Description
determines the top margin.
BottomMargin
long BottomMargin;
Description
determines the bottom margin.
BackTransparent
boolean BackTransparent;
Description
determines if the background color is transparent.
Width
long Width;
Description
contains the absolute table width.

As this is only a describing property the value of the actual table may vary depending on the environment the table is located in and the settings of LeftMargin, RightMargin and HoriOrient.

ChartRowAsLabel
boolean ChartRowAsLabel;
Description
determines if the first row of the table should be treated as axis labels when a chart is to be created.
ChartColumnAsLabel
boolean ChartColumnAsLabel;
Description
determines if the first column of the table should be treated as axis labels when a chart is to be created.
TableBorder
::com::sun::star::table::TableBorder TableBorder;
Description
contains the description of the table borders.
See also
com.sun.star.table.TableBorder
TableColumnSeparators
sequence< TableColumnSeparator > TableColumnSeparators;
Description
contains the column description of the table.
See also
com.sun.star.text.TableColumnSeparator
TableColumnRelativeSum
short TableColumnRelativeSum;
Description
contains the sum of the column width values used in TableColumnSeparators.
BackColor
::com::sun::star::util::Color BackColor;
Description
contains the color of the background.
BackGraphicURL
string BackGraphicURL;
Description
contains the URL for the background graphic.
BackGraphicFilter
string BackGraphicFilter;
Description
contains the name of the file filter for the background graphic.
BackGraphicLocation
::com::sun::star::style::GraphicLocation BackGraphicLocation;
Description
determines the position of the background graphic.
See also
GraphicLocation
CollapsingBorders
boolean CollapsingBorders;
Usage Restrictions
optional
Description
determines whether borders of neighboring table cells are * collapsed into one

 
Top of Page