summaryrefslogtreecommitdiffstats
path: root/offapi/com/sun/star/text/TextTable.idl
diff options
context:
space:
mode:
authorDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-07 09:06:44 +0000
committerDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-07 09:06:44 +0000
commited5640d8b587fbcfed7dd7967f3de04b37a76f26 (patch)
tree7a5f7c6c9d02226d7471cb3cc8fbbf631b415303 /offapi/com/sun/star/text/TextTable.idl
parentInitial commit. (diff)
downloadlibreoffice-upstream/4%7.4.7.tar.xz
libreoffice-upstream/4%7.4.7.zip
Adding upstream version 4:7.4.7.upstream/4%7.4.7upstream
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'offapi/com/sun/star/text/TextTable.idl')
-rw-r--r--offapi/com/sun/star/text/TextTable.idl248
1 files changed, 248 insertions, 0 deletions
diff --git a/offapi/com/sun/star/text/TextTable.idl b/offapi/com/sun/star/text/TextTable.idl
new file mode 100644
index 000000000..bbcb4c1fa
--- /dev/null
+++ b/offapi/com/sun/star/text/TextTable.idl
@@ -0,0 +1,248 @@
+/* -*- 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 .
+ */
+
+#ifndef __com_sun_star_text_TextTable_idl__
+#define __com_sun_star_text_TextTable_idl__
+
+#include <com/sun/star/text/TextContent.idl>
+#include <com/sun/star/util/Color.idl>
+#include <com/sun/star/text/XTextTable.idl>
+#include <com/sun/star/text/TableColumnSeparator.idl>
+#include <com/sun/star/container/XNamed.idl>
+#include <com/sun/star/beans/XPropertySet.idl>
+#include <com/sun/star/style/GraphicLocation.idl>
+#include <com/sun/star/style/BreakType.idl>
+#include <com/sun/star/table/ShadowFormat.idl>
+#include <com/sun/star/table/TableBorder.idl>
+#include <com/sun/star/table/XCellRange.idl>
+#include <com/sun/star/table/XAutoFormattable.idl>
+#include <com/sun/star/chart/XChartDataArray.idl>
+#include <com/sun/star/util/XSortable.idl>
+#include <com/sun/star/sheet/XCellRangeData.idl>
+#include <com/sun/star/xml/UserDefinedAttributesSupplier.idl>
+#include <com/sun/star/graphic/XGraphic.idl>
+
+module com { module sun { module star { module text {
+
+/** is a table of text cells which is anchored to a surrounding text.
+
+ <p>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.</p>
+
+ <p>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.</p>
+
+ <p>Example: Create and insert a TextTable:</p>
+
+ @code{.bas}
+ 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 )
+ @endcode
+
+ @see com::sun::star::text::Cell
+ @see com::sun::star::text::CellRange
+ @see com::sun::star::text::TableColumns
+ @see com::sun::star::text::TableRows
+ @see com::sun::star::text::TextTableCursor
+ */
+published service TextTable
+{
+ service com::sun::star::text::TextContent;
+
+ [optional] service com::sun::star::xml::UserDefinedAttributesSupplier;
+
+ interface com::sun::star::text::XTextTable;
+
+ interface com::sun::star::container::XNamed;
+
+ interface com::sun::star::table::XCellRange;
+
+ interface com::sun::star::chart::XChartDataArray;
+
+ interface com::sun::star::table::XAutoFormattable;
+
+ interface com::sun::star::util::XSortable;
+
+ [optional] interface com::sun::star::sheet::XCellRangeData;
+
+ /** determines the type of break that is applied at the beginning of the table.@see com::sun::star::style::BreakType
+ */
+ [property] com::sun::star::style::BreakType BreakType;
+
+ /** contains the left margin of the table.
+ */
+ [property] long LeftMargin;
+
+ /** contains the right margin of the table.
+ */
+ [property] long RightMargin;
+
+ /** contains the horizontal orientation. @see com::sun::star::text::HoriOrientation
+ */
+ [property] short HoriOrient;
+
+ /** Setting this property to TRUE prevents page or column
+ breaks between this table and the following paragraph or text table.
+ */
+ [property] boolean KeepTogether;
+
+ /** Setting this property to FALSE prevents the table from
+ getting spread on two pages.
+ */
+ [property] boolean Split;
+
+ /** If a page break property is set at the table,
+ this property contains the new value for the page number.
+ */
+ [property] short PageNumberOffset;
+
+ /** 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.
+ */
+ [property] string PageDescName;
+
+ /** determines the width of the table relative to its environment.
+ */
+ [property] short RelativeWidth;
+ /** determines if the value of the relative width is valid.
+ */
+ [property] boolean IsWidthRelative;
+
+ /** determines if the first row of the table is repeated on every new page.
+ */
+ [property] boolean RepeatHeadline;
+ /** determines the number of rows of the table repeated on every new page.
+ */
+ [optional, property] long HeaderRowCount;
+
+ /** determines the type, color and size of the shadow.@see com::sun::star::table::ShadowFormat
+ */
+ [property] com::sun::star::table::ShadowFormat ShadowFormat;
+
+ /** determines the top margin.
+ */
+ [property] long TopMargin;
+
+ /** determines the bottom margin.
+ */
+ [property] long BottomMargin;
+
+ /** determines if the background color is transparent.
+ */
+ [property] boolean BackTransparent;
+
+ /** contains the absolute table width.
+
+ <p>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. </p>
+ */
+ [property] long Width;
+
+ /** determines if the first row of the table should be treated as
+ axis labels when a chart is to be created.
+ */
+ [property] boolean ChartRowAsLabel;
+
+ /** determines if the first column of the table should be treated as
+ axis labels when a chart is to be created.
+ */
+ [property] boolean ChartColumnAsLabel;
+
+ /** contains the description of the table borders. @see com::sun::star::table::TableBorder
+ */
+ [property] com::sun::star::table::TableBorder TableBorder;
+
+ /** contains the column description of the table.
+ @see com::sun::star::text::TableColumnSeparator
+ */
+ [property] sequence<com::sun::star::text::TableColumnSeparator> TableColumnSeparators;
+
+ /** contains the sum of the column width values used in TableColumnSeparators.
+ */
+ [property] short TableColumnRelativeSum;
+
+ /** contains the color of the background.
+ */
+ [property] com::sun::star::util::Color BackColor;
+
+ /** contains the URL for the background graphic.
+
+ @deprecated as of LibreOffice 6.1 - use BackGraphic instead
+
+ Note the new behaviour since it this was deprecated:
+ This property can only be set and only external URLs are
+ supported (no more vnd.sun.star.GraphicObject scheme). When an
+ URL is set, then it will load the graphic and set the BackGraphic
+ property.
+ */
+ [property] string BackGraphicURL;
+
+ /** contains the name of the file filter for the background graphic.
+ */
+ [property] string BackGraphicFilter;
+
+
+ /** determines the position of the background graphic.@see GraphicLocation
+ */
+ [property] com::sun::star::style::GraphicLocation BackGraphicLocation;
+
+
+ /** determines whether borders of neighboring table cells are
+ * collapsed into one
+ */
+ [optional, property] boolean CollapsingBorders;
+
+ /** Grab bag of table properties, used as a string-any map for interim interop purposes.
+
+ @since LibreOffice 4.3
+
+ <p>This property is intentionally not handled by the ODF filter. Any
+ member that should be handled there should be first moved out from this grab
+ bag to a separate property.</p>
+ */
+ [optional, property] sequence<com::sun::star::beans::PropertyValue> TableInteropGrabBag;
+
+ /** contains the name of table style used by the table.
+
+ @since LibreOffice 5.3
+ */
+ [optional, property] string TableTemplateName;
+
+ /** contains the graphic for the background.
+
+ @since LibreOffice 6.1
+ */
+ [optional, property] com::sun::star::graphic::XGraphic BackGraphic;
+};
+
+
+}; }; }; };
+
+#endif
+
+/* vim:set shiftwidth=4 softtabstop=4 expandtab: */