summaryrefslogtreecommitdiffstats
path: root/offapi/com/sun/star/style/ParagraphProperties.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/style/ParagraphProperties.idl
parentInitial commit. (diff)
downloadlibreoffice-ed5640d8b587fbcfed7dd7967f3de04b37a76f26.tar.xz
libreoffice-ed5640d8b587fbcfed7dd7967f3de04b37a76f26.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/style/ParagraphProperties.idl')
-rw-r--r--offapi/com/sun/star/style/ParagraphProperties.idl445
1 files changed, 445 insertions, 0 deletions
diff --git a/offapi/com/sun/star/style/ParagraphProperties.idl b/offapi/com/sun/star/style/ParagraphProperties.idl
new file mode 100644
index 000000000..32a63282d
--- /dev/null
+++ b/offapi/com/sun/star/style/ParagraphProperties.idl
@@ -0,0 +1,445 @@
+/* -*- 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_style_ParagraphProperties_idl__
+#define __com_sun_star_style_ParagraphProperties_idl__
+
+#include <com/sun/star/style/ParagraphAdjust.idl>
+#include <com/sun/star/util/Color.idl>
+#include <com/sun/star/style/LineSpacing.idl>
+#include <com/sun/star/style/GraphicLocation.idl>
+#include <com/sun/star/style/TabStop.idl>
+#include <com/sun/star/style/DropCapFormat.idl>
+#include <com/sun/star/container/XIndexReplace.idl>
+#include <com/sun/star/table/ShadowFormat.idl>
+#include <com/sun/star/table/BorderLine.idl>
+#include <com/sun/star/style/BreakType.idl>
+#include <com/sun/star/container/XNameContainer.idl>
+#include <com/sun/star/beans/PropertyValue.idl>
+#include <com/sun/star/graphic/XGraphic.idl>
+
+module com { module sun { module star { module style {
+
+/** describes the style of paragraphs.
+ */
+published service ParagraphProperties
+{
+
+ /** determines the adjustment of a paragraph.
+ */
+ [property] com::sun::star::style::ParagraphAdjust ParaAdjust;
+
+
+ /** contains the type of the line spacing of a paragraph.
+ */
+ [optional, property] com::sun::star::style::LineSpacing ParaLineSpacing;
+
+
+ /** contains the paragraph background color.
+ */
+ [optional, property] com::sun::star::util::Color ParaBackColor;
+
+
+ /** This value is `TRUE` if the paragraph background color
+ is set to transparent.
+ */
+ [optional, property] boolean ParaBackTransparent;
+
+
+ /** contains the value of a link for the background graphic of a paragraph.
+
+ @deprecated as of LibreOffice 6.1 - use ParaBackGraphic 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 ParaBackGraphic
+ property.
+ */
+ [optional, property] string ParaBackGraphicURL;
+
+ /** contains the name of the graphic filter for the background graphic of a paragraph.
+ */
+ [optional, property] string ParaBackGraphicFilter;
+
+
+ /** contains the value for the position of a background graphic.
+
+ @see com::sun::star::style::GraphicLocation
+ */
+ [optional, property] com::sun::star::style::GraphicLocation ParaBackGraphicLocation;
+
+
+ /** determines the adjustment of the last line.
+ <p>It is only valid if ParagraphProperties::ParaAdjust
+ is set to ParagraphAdjust::BLOCK.</p>
+ */
+ [property] short ParaLastLineAdjust;
+
+
+ /** determines if single words are stretched.
+
+ <p>It is only valid if ParagraphProperties::ParaAdjust and
+ ParagraphProperties::ParaLastLineAdjust are also valid.</p>
+ */
+ [optional, property] boolean ParaExpandSingleWord;
+
+
+ /** determines the left margin of the paragraph in 100th mm.
+ */
+ [property] long ParaLeftMargin;
+
+
+ /** determines the right margin of the paragraph in 100th mm.
+ */
+ [property] long ParaRightMargin;
+
+
+ /** determines the top margin of the paragraph in 100th mm.
+
+ <p>The distance between two paragraphs is specified by:</p>
+ <ul>
+ <li>either the bottom margin of the previous paragraph.</li>
+ <li>or the top margin of the following paragraph.</li>
+ </ul>
+ The greater one is chosen.
+ */
+ [property] long ParaTopMargin;
+
+
+ /** determines the bottom margin of the paragraph in 100th mm.
+
+ <p>The distance between two paragraphs is specified by:</p>
+ <ul>
+ <li>either the bottom margin of the previous paragraph
+ </li>
+ <li>or the top margin of the following paragraph.
+ </li>
+ </ul>
+ The greater one is chosen.
+ */
+ [property] long ParaBottomMargin;
+
+ /** determines if contextual spacing is used.
+
+ @since LibreOffice 3.6
+
+ <p>If true, the top and bottom margins of the paragraph should not be
+ applied when the previous and next paragraphs have the same style.</p>
+ */
+ [optional, property] boolean ParaContextMargin;
+
+ /** Grab bag of paragraph properties, used as a string-any map for interim interop purposes.
+
+ @since LibreOffice 4.2
+
+ <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> ParaInteropGrabBag;
+
+ /** determines if the paragraph is included in the
+ line numbering.
+ */
+ [optional, property] boolean ParaLineNumberCount;
+
+
+ /** contains the start value for the line numbering.
+ */
+ [optional, property] long ParaLineNumberStartValue;
+
+
+ /** If this property is set, it creates a page break before the
+ paragraph it belongs to and assigns the value as the name
+ of the new page style sheet to use.
+ */
+ [optional, property] string PageDescName;
+
+
+ /** If a page break property is set at a paragraph, this property contains the new value for the page number.
+ */
+ [optional, property] short PageNumberOffset;
+
+
+ /** determines if the register mode is applied to a
+ paragraph.
+
+
+
+ <p>Remark: Register mode is only used if the register
+ mode property of the page style is switched on.</p>
+ */
+ [optional, property] boolean ParaRegisterModeActive;
+
+
+ /** specifies the positions and kinds of the tab stops within this
+ paragraph.
+ */
+ [optional, property] sequence<com::sun::star::style::TabStop> ParaTabStops;
+
+
+ /** contains the name of the current paragraph style.
+ */
+ [optional, property] string ParaStyleName;
+
+
+ /** contains the name of the current page style.
+ */
+ [optional, property, maybevoid, readonly] string PageStyleName;
+
+
+ /** specifies whether the first characters of the
+ paragraph are displayed in capital letters and how they are
+ formatted.
+ */
+ [optional, property] com::sun::star::style::DropCapFormat DropCapFormat;
+
+
+ /** specifies if the property <var>DropCapFormat</var>
+ is applied to the whole first word.
+ */
+ [optional, property] boolean DropCapWholeWord;
+
+
+ /** Setting this property to `TRUE` prevents page or column
+ breaks between this and the following paragraph.
+
+
+ <p>This feature is useful for preventing title paragraphs to be
+ the last line on a page or column.</p>
+ */
+ [optional, property] boolean ParaKeepTogether;
+
+
+ /** Setting this property to `FALSE` prevents the paragraph from
+ getting split into two pages or columns.
+ */
+ [optional, property] boolean ParaSplit;
+
+
+ /** specifies the numbering level of the paragraph.
+ */
+ [optional, property] short NumberingLevel;
+
+ /** contains the numbering rules applied to this paragraph.
+ */
+ [optional, property] com::sun::star::container::XIndexReplace NumberingRules;
+
+
+ /** specifies the start value for numbering if a new numbering starts at this paragraph.
+ */
+ [optional, property] short NumberingStartValue;
+
+ /** determines if the numbering rules restart, counting at the current paragraph.
+ */
+ [optional, property] boolean ParaIsNumberingRestart;
+
+ /** specifies the name of the style for the numbering.
+
+
+ <p>The name must be one of the names which are available via
+ XStyleFamiliesSupplier.</p>
+ */
+ [optional, property] string NumberingStyleName;
+
+ /** specifies the minimum number of lines of the paragraph that have
+ to be at bottom of a page if the paragraph is spread over more than
+ one page.
+ */
+ [optional, property] byte ParaOrphans;
+
+ /** specifies the minimum number of lines of the paragraph that have
+ to be at top of a page if the paragraph is spread over more than
+ one page.
+ */
+ [optional, property] byte ParaWidows;
+ /** determines the type, color, and size of the shadow.
+ @see com::sun::star::table::ShadowFormat
+ */
+ [optional, property] com::sun::star::table::ShadowFormat ParaShadowFormat;
+ /** contains the left border of the object.
+ */
+ [property, optional] com::sun::star::table::BorderLine LeftBorder;
+
+ /** contains the right border of the object.
+ */
+ [property, optional] com::sun::star::table::BorderLine RightBorder;
+
+ /** contains the top border of the object.
+ */
+ [property, optional] com::sun::star::table::BorderLine TopBorder;
+
+ /** contains the bottom border of the object.
+ */
+ [property, optional] com::sun::star::table::BorderLine BottomBorder;
+
+ /** contains the distance from the border to the object.
+ */
+ [property, optional] long BorderDistance;
+
+ /** contains the distance from the left border to the object.
+ */
+ [property, optional] long LeftBorderDistance;
+
+ /** contains the distance from the right border to the object.
+ */
+ [property, optional] long RightBorderDistance;
+
+ /** contains the distance from the top border to the object.
+ */
+ [property, optional] long TopBorderDistance;
+
+ /** contains the distance from the bottom border to the object.
+ */
+ [property, optional] long BottomBorderDistance;
+
+ /** determines the type of break that is applied at the beginning of the table.
+ @see com::sun::star::style::BreakType
+ */
+ [optional, property] com::sun::star::style::BreakType BreakType;
+
+ /** specifies the character style name for drop caps.
+ */
+ [optional, property] string DropCapCharStyleName;
+
+ /** specifies the indent for the first line.
+ */
+ [optional, property] long ParaFirstLineIndent;
+
+ /** determines if the first line should be indented automatically.
+ */
+ [optional, property] boolean ParaIsAutoFirstLineIndent;
+
+ /** specifies if automatic hyphenation is applied.
+ */
+ [property] boolean ParaIsHyphenation;
+
+ /** specifies the maximum number of consecutive hyphens.
+ */
+ [optional, property] short ParaHyphenationMaxHyphens;
+
+ /** specifies the minimum number of characters to remain before the
+ hyphen character (when hyphenation is applied).
+ @note Confusingly it is named Max but specifies a minimum.
+ */
+ [optional, property] short ParaHyphenationMaxLeadingChars;
+
+ /** specifies the minimum number of characters to remain after the
+ hyphen character (when hyphenation is applied).
+ @note Confusingly it is named Max but specifies a minimum.
+ */
+ [optional, property] short ParaHyphenationMaxTrailingChars;
+
+ /** specifies the vertical alignment of a paragraph.
+
+ @see com::sun::star::text::ParagraphVertAlign
+ */
+ [optional, property] short ParaVertAlignment;
+
+ /** this property stores xml attributes.
+ They will be saved to and restored from automatic styles inside xml files.
+
+ @see com::sun::star::xml::AttributeContainer
+ */
+ [optional, property] com::sun::star::container::XNameContainer ParaUserDefinedAttributes;
+
+ /** returns `FALSE` if the paragraph is part of a numbering, but has no
+ numbering label.
+
+ <p>A paragraph is part of a numbering, if a style for a numbering is
+ set - see NumberingStyleName.</p>
+ <p>If the paragraph is not part of a numbering the property is void.</p>
+ */
+ [optional, property, maybevoid] boolean NumberingIsNumber;
+
+ /** the property determines if borders set at a paragraph are merged with the
+ next paragraph.
+ <p>Borders are only merged if they are identical.</p>
+ */
+ [optional, property, maybevoid] boolean ParaIsConnectBorder;
+
+ /** specifies the id of the list to which the paragraph belongs
+
+ */
+ [optional, property] string ListId;
+
+ /** specifies the outline level to which the paragraph belongs
+
+ @since OOo 3.1
+
+ <p>Value 0 indicates that the paragraph belongs to the body text.</p>
+ <p>Values [1..10] indicates that the paragraph belongs to the corresponding outline level.</p>
+ */
+ [optional, property] short OutlineLevel;
+
+ /** contains the graphic for the background of a paragraph.
+
+ @since LibreOffice 6.1
+ */
+ [optional, property] com::sun::star::graphic::XGraphic ParaBackGraphic;
+
+ /** specifies that a child node of a parent node that is not counted
+ is continuing the numbering of parent's previous node's sub tree.
+
+ @since OOo 3.0.1
+
+ @note misspelling retained for compatibility
+ */
+ [optional, property, readonly] boolean ContinueingPreviousSubTree;
+
+ /** allows reading the generated numbering list label.
+
+ @since OOo 3.0.1
+ */
+ [optional, property, readonly] string ListLabelString;
+
+ /** Specifies whether words written in CAPS will be hyphenated.
+ Setting to `true` will disable hyphenation of words written in CAPS for this paragraph.
+
+ @since LibreOffice 6.4
+ */
+ [optional, property] boolean ParaHyphenationNoCaps;
+
+ /** Specifies whether last word of paragraph will be hyphenated.
+ Setting to `true` will disable hyphenation of last word for this paragraph.
+
+ @since LibreOffice 7.4
+ */
+ [optional, property] boolean ParaHyphenationNoLastWord;
+
+ /** specifies the minimum word length in characters, when hyphenation is applied.
+
+ @since LibreOffice 7.4
+ */
+ [optional, property] short ParaHyphenationMinWordLength;
+
+ /** specifies the hyphenation zone, i.e. allowed extra white space
+ in the line before applying hyphenation.
+
+ @since LibreOffice 7.4
+ */
+ [optional, property] long ParaHyphenationZone;
+};
+
+
+}; }; }; };
+
+#endif
+
+/* vim:set shiftwidth=4 softtabstop=4 expandtab: */