summaryrefslogtreecommitdiffstats
path: root/offapi/com/sun/star/style/PageProperties.idl
diff options
context:
space:
mode:
Diffstat (limited to 'offapi/com/sun/star/style/PageProperties.idl')
-rw-r--r--offapi/com/sun/star/style/PageProperties.idl516
1 files changed, 516 insertions, 0 deletions
diff --git a/offapi/com/sun/star/style/PageProperties.idl b/offapi/com/sun/star/style/PageProperties.idl
new file mode 100644
index 000000000..3189f569d
--- /dev/null
+++ b/offapi/com/sun/star/style/PageProperties.idl
@@ -0,0 +1,516 @@
+/* -*- 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_PageProperties_idl__
+#define __com_sun_star_style_PageProperties_idl__
+
+#include <com/sun/star/table/ShadowFormat.idl>
+#include <com/sun/star/util/Color.idl>
+#include <com/sun/star/table/BorderLine.idl>
+#include <com/sun/star/style/PageStyleLayout.idl>
+#include <com/sun/star/style/GraphicLocation.idl>
+#include <com/sun/star/awt/Size.idl>
+#include <com/sun/star/text/XText.idl>
+#include <com/sun/star/text/XTextColumns.idl>
+#include <com/sun/star/container/XNameContainer.idl>
+#include <com/sun/star/text/WritingMode2.idl>
+#include <com/sun/star/graphic/XGraphic.idl>
+
+module com { module sun { module star { module style {
+
+/** describes the style of pages.
+ */
+published service PageProperties
+{
+ /** contains the background color of the page.
+ */
+ [property] com::sun::star::util::Color BackColor;
+
+ /** contains the URL of 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 filter name of the background graphic.
+ */
+ [property] string BackGraphicFilter;
+
+ /** determines the location of the background graphic.
+ */
+ [property] com::sun::star::style::GraphicLocation BackGraphicLocation;
+
+ /** determines if the background color is transparent.
+
+ <p>If this property is set to `TRUE`,
+ PageStyle::BackColor will not be used.</p>
+ */
+ [property] boolean BackTransparent;
+
+ /** determines the left margin of the page.
+ */
+ [property] long LeftMargin;
+
+ /** determines the right margin of the page.
+ */
+ [property] long RightMargin;
+
+ /** determines the top margin of the page.
+ */
+ [property] long TopMargin;
+
+ /** determines the bottom margin of the page.
+ */
+ [property] long BottomMargin;
+
+ /** determines the style of the left border line of the page.
+ */
+ [property] com::sun::star::table::BorderLine LeftBorder;
+
+ /** determines the style of the right border line of the page.
+ */
+ [property] com::sun::star::table::BorderLine RightBorder;
+
+ /** determines the style of the top border line of the page.
+ */
+ [property] com::sun::star::table::BorderLine TopBorder;
+
+ /** determines the style of the bottom border line of the page.
+ */
+ [property] com::sun::star::table::BorderLine BottomBorder;
+
+ /** determines the left border distance of the page.
+ */
+ [property] long LeftBorderDistance;
+
+ /** determines the right border distance of the page.
+ */
+ [property] long RightBorderDistance;
+
+ /** determines the top border distance of the page.
+ */
+ [property] long TopBorderDistance;
+
+ /** determines the bottom border distance of the page.
+ */
+ [property] long BottomBorderDistance;
+
+ /** determines the shadow of the page.
+ */
+ [property] com::sun::star::table::ShadowFormat ShadowFormat;
+
+ /** determines if the page format is landscape.
+ */
+ [property] boolean IsLandscape;
+
+ /** determines the default numbering type for this page.
+ */
+ [property] short NumberingType;
+
+ /** determines the layout of the page.
+ */
+ [property] com::sun::star::style::PageStyleLayout PageStyleLayout;
+
+ /** contains the name of a paper tray of the selected printer.
+ */
+ [property] string PrinterPaperTray;
+
+ /** determines if the register mode is active on that page.
+ */
+ [optional, property] boolean RegisterModeActive;
+
+ /** contains the name of the paragraph style that is used as reference of the register mode.
+ */
+ [optional, property] string RegisterParagraphStyle;
+
+ /** contains the paper size of the page.
+ */
+ [property] com::sun::star::awt::Size Size;
+
+ /** contains the width of the page.
+ */
+ [property] long Width;
+
+ /** contains the height of the page.
+ */
+ [property] long Height;
+
+ /** contains the column settings of the page.
+ */
+ [optional , property] com::sun::star::text::XTextColumns TextColumns;
+
+ /** contains user defined attributes.
+
+ <p>This com::sun::star::container::XNameContainer
+ supports the service
+ com::sun::star::xml::AttributeContainer.</p>
+ */
+ [property] com::sun::star::container::XNameContainer UserDefinedAttributes;
+
+ /** contains the color of the background of the header.
+ */
+ [property, maybevoid] com::sun::star::util::Color HeaderBackColor;
+
+ /** contains the URL of the background graphic of the header.
+
+ @deprecated as of LibreOffice 6.1 - use HeaderBackGraphic 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 HeaderBackGraphic
+ property.
+ */
+ [property, maybevoid] string HeaderBackGraphicURL;
+
+ /** contains the filter name of the background graphic of the header.
+ */
+ [property, maybevoid] string HeaderBackGraphicFilter;
+
+ /** determines the location of the background graphic of the header.
+ */
+ [property, maybevoid] com::sun::star::style::GraphicLocation HeaderBackGraphicLocation;
+
+ /** contains the left margin of the header.
+ */
+ [property, maybevoid] long HeaderLeftMargin;
+
+ /** contains the right margin of the header.
+ */
+ [property, maybevoid] long HeaderRightMargin;
+
+ /** determines if the background color of the header is transparent.
+
+ <p>If this property is set to `TRUE`,
+ PageStyle::HeaderBackColor will not be used.</p>
+ */
+ [property, maybevoid] boolean HeaderBackTransparent;
+
+ /** determines the style of the left border line of the header.
+ */
+ [property, maybevoid] com::sun::star::table::BorderLine HeaderLeftBorder;
+
+ /** determines the style of the right border line of the header.
+ */
+ [property, maybevoid] com::sun::star::table::BorderLine HeaderRightBorder;
+
+ /** determines the style of the top border line of the header.
+ */
+ [property, maybevoid] com::sun::star::table::BorderLine HeaderTopBorder;
+
+ /** determines the style of the bottom border line of the header.
+ */
+ [property, maybevoid] com::sun::star::table::BorderLine HeaderBottomBorder;
+
+ /** determines the left border distance of the header.
+ */
+ [property, maybevoid] long HeaderLeftBorderDistance;
+
+ /** determines the right border distance of the header.
+ */
+ [property, maybevoid] long HeaderRightBorderDistance;
+
+ /** determines the top border distance of the header.
+ */
+ [property, maybevoid] long HeaderTopBorderDistance;
+
+ /** determines the bottom border distance of the header.
+ */
+ [property, maybevoid] long HeaderBottomBorderDistance;
+
+ /** determines the shadow of the header.
+ */
+ [property, maybevoid] com::sun::star::table::ShadowFormat HeaderShadowFormat;
+
+ /** determines the distance between the header and the body text area.
+ */
+ [property, maybevoid] long HeaderBodyDistance;
+
+ /** determines if the header content on left and right pages is the same.
+ */
+ [property, maybevoid] boolean HeaderIsShared;
+
+ /** determines if the header/footer content on the first page and remaining pages is the same.
+
+ @since LibreOffice 4.0
+ */
+ [optional, property, maybevoid] boolean FirstIsShared;
+
+ /** contains the height of the header.
+ */
+ [property, maybevoid] long HeaderHeight;
+
+ /** determines if the height of the header depends on the content.
+ */
+ [property, maybevoid] boolean HeaderIsDynamicHeight;
+
+ /** determines if a header is used on the page.
+ */
+ [property] boolean HeaderIsOn;
+
+ /** contains the interface to the text of the header.
+ */
+ [optional, property, maybevoid] com::sun::star::text::XText HeaderText;
+
+ /** contains the interface to the text of the header of left pages.
+ */
+ [optional, property, maybevoid] com::sun::star::text::XText HeaderTextLeft;
+
+ /** contains the interface to the text of the header of right pages.
+ */
+ [optional, property, maybevoid] com::sun::star::text::XText HeaderTextRight;
+
+ /** contains the color of the background of the footer.
+ */
+ [property, maybevoid] com::sun::star::util::Color FooterBackColor;
+
+ /** contains the URL of the background graphic in the footer.
+
+ @deprecated as of LibreOffice 6.1 - use FooterBackGraphic
+
+ 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 FooterBackGraphic
+ property.
+ */
+ [property, maybevoid] string FooterBackGraphicURL;
+
+ /** contains the filter name of the background graphic in the footer.
+ */
+ [property, maybevoid] string FooterBackGraphicFilter;
+
+ /** determines the location of the background graphic in the footer.
+ */
+ [property, maybevoid] com::sun::star::style::GraphicLocation FooterBackGraphicLocation;
+
+ /** determines the left margin of the footer.
+ */
+ [property, maybevoid] long FooterLeftMargin;
+
+ /** determines the right margin of the footer.
+ */
+ [property, maybevoid] long FooterRightMargin;
+
+ /** determines if the background of the footer is transparent.
+ */
+ [property, maybevoid] boolean FooterBackTransparent;
+
+ /** contains the style of the left border line of the footer.
+ */
+ [property, maybevoid] com::sun::star::table::BorderLine FooterLeftBorder;
+
+ /** contains the style of the right border line of the footer.
+ */
+ [property, maybevoid] com::sun::star::table::BorderLine FooterRightBorder;
+
+ /** contains the style of the top border line of the footer.
+ */
+ [property, maybevoid] com::sun::star::table::BorderLine FooterTopBorder;
+
+ /** contains the style of the bottom border line of the footer.
+ */
+ [property, maybevoid] com::sun::star::table::BorderLine FooterBottomBorder;
+
+ /** contains the left border distance of the footer.
+ */
+ [property, maybevoid] long FooterLeftBorderDistance;
+
+ /** contains the right border distance of the footer.
+ */
+ [property, maybevoid] long FooterRightBorderDistance;
+
+ /** contains the top border distance of the footer.
+ */
+ [property, maybevoid] long FooterTopBorderDistance;
+
+ /** contains the bottom border distance of the footer.
+ */
+ [property, maybevoid] long FooterBottomBorderDistance;
+
+ /** determines the shadow of the footer.
+ */
+ [property, maybevoid] com::sun::star::table::ShadowFormat FooterShadowFormat;
+
+ /** determines the distance between the footer and the body text area.
+ */
+ [property, maybevoid] long FooterBodyDistance;
+
+ /** determines if the height of the footer depends on the content.
+ */
+ [property, maybevoid] boolean FooterIsDynamicHeight;
+
+ /** determines if the footer content on left and right pages is the same.
+ */
+ [property, maybevoid] boolean FooterIsShared;
+
+ /** determines the height of the footer.
+ */
+ [property, maybevoid] long FooterHeight;
+
+ /** determines if a footer is used on the page.
+ */
+ [property] boolean FooterIsOn;
+
+ /** contains the interface to the text of the footer.
+ */
+ [optional, property, maybevoid] com::sun::star::text::XText FooterText;
+
+ /** contains the interface to the text of the footer of a left page.
+ */
+ [optional, property, maybevoid] com::sun::star::text::XText FooterTextLeft;
+
+ /** contains the interface to the text of the footer of a right page.
+ */
+ [optional, property, maybevoid] com::sun::star::text::XText FooterTextRight;
+
+ /** contains the maximum height of the footnote area. If set to zero then the height
+ of the current page is used as limit.
+ */
+ [optional,property] long FootnoteHeight;
+
+ /** contains the weight of the separator line between the text and the footnote area.
+ */
+ [optional,property] short FootnoteLineWeight;
+
+ /** contains the style of the separator line between the text and the footnote area.
+
+ @see com::sun::star::style::FootnoteLineStyle
+ for the possible values.
+ */
+ [optional,property] short FootnoteLineStyle;
+
+ /** contains the color of the separator line between the text and the footnote area.
+ */
+ [optional,property] com::sun::star::util::Color FootnoteLineColor;
+
+ /** contains the relative width of the separator line between the text and the footnote area.
+ */
+ [optional,property] byte FootnoteLineRelativeWidth;
+
+ /** contains the adjustment of the separator line between the text and the footnote area.
+ <p>com::sun::star::text::HorizontalAdjusts.</p>
+ */
+ [optional,property] short FootnoteLineAdjust;
+
+ /** contains the distance between the text and the separator line between the
+ text and the footnote area.
+ */
+ [optional,property] long FootnoteLineTextDistance;
+
+ /** contains the distance between the footnote area and the separator line between
+ the text and the footnote area.
+ */
+ [optional,property] long FootnoteLineDistance;
+
+ /** contains the writing direction, as represented by the
+ com::sun::star::text::WritingMode2 constants */
+ [optional,property] short WritingMode;
+
+ /** contains the mode of the text grid (none, lines, ...), as
+ represented by com::sun::star::text::TextGridMode
+ constants */
+ [optional, property] short GridMode;
+
+ /** contains the display color of the text grid */
+ [optional, property] com::sun::star::util::Color GridColor;
+
+ /** contains the number of lines in the text grid */
+ [optional, property] short GridLines;
+
+ /** contains the height of the base text line inside the text grid */
+ [optional, property] long GridBaseHeight;
+
+ /** contains the height of the ruby text line inside the text grid */
+ [optional, property] long GridRubyHeight;
+
+ /** determines whether the text grid's ruby line is located below or
+ above the base line */
+ [optional, property] boolean GridRubyBelow;
+
+ /** determines whether the text grid lines are printed */
+ [optional, property] boolean GridPrint;
+
+ /** determines whether the text grid lines are visible or not */
+ [optional, property] boolean GridDisplay;
+
+ /** determines whether to use dynamic spacing in header or not. */
+ [optional, property, maybevoid] boolean HeaderDynamicSpacing;
+
+ /** determines whether to use dynamic spacing in footer or not. */
+ [optional, property, maybevoid] boolean FooterDynamicSpacing;
+
+ /** determines the distance of all borders of the page. */
+ [property] long BorderDistance;
+
+ /** contains the distance of all borders of the footer. */
+ [property, maybevoid] long FooterBorderDistance;
+
+ /** determines the distance of all borders of the header. */
+ [property, maybevoid] long HeaderBorderDistance;
+
+ /** contains the graphic of the background.
+
+ @since LibreOffice 6.1
+ */
+ [optional, property] com::sun::star::graphic::XGraphic BackGraphic;
+
+ /** contains the graphic of the background of the header.
+
+ @since LibreOffice 6.1
+ */
+ [optional, property, maybevoid] com::sun::star::graphic::XGraphic HeaderBackGraphic;
+
+ /** contains the graphic of the background of the footer.
+
+ @since LibreOffice 6.1
+ */
+ [optional, property, maybevoid] com::sun::star::graphic::XGraphic FooterBackGraphic;
+
+ /** determines the gutter margin of the page.
+
+ @since LibreOffice 7.2
+ */
+ [optional, property] long GutterMargin;
+
+ /** does the background cover the full page or only inside the
+ margins?
+
+ @since LibreOffice 7.2
+ */
+ [optional, property] boolean BackgroundFullSize;
+
+ /** specifies that the page gutter shall be placed on the right side of the page.
+
+ @since LibreOffice 7.2
+ */
+ [optional, property] boolean RtlGutter;
+
+};
+
+}; }; }; };
+
+#endif
+
+/* vim:set shiftwidth=4 softtabstop=4 expandtab: */