summaryrefslogtreecommitdiffstats
path: root/offapi/com/sun/star/text/TextFrame.idl
diff options
context:
space:
mode:
Diffstat (limited to '')
-rw-r--r--offapi/com/sun/star/text/TextFrame.idl160
1 files changed, 160 insertions, 0 deletions
diff --git a/offapi/com/sun/star/text/TextFrame.idl b/offapi/com/sun/star/text/TextFrame.idl
new file mode 100644
index 000000000..44f4139d9
--- /dev/null
+++ b/offapi/com/sun/star/text/TextFrame.idl
@@ -0,0 +1,160 @@
+/* -*- 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_TextFrame_idl__
+#define __com_sun_star_text_TextFrame_idl__
+
+#include <com/sun/star/text/XTextFrame.idl>
+#include <com/sun/star/text/BaseFrame.idl>
+
+
+ module com { module sun { module star { module text {
+
+
+/** specifies a rectangular shape which contains a Text object
+ and is attached to a piece of surrounding Text.
+
+ @see Text
+
+ <p>This example shows how to create a TextFrame and insert
+ it at the very beginning of Text component. The macro
+ is ready to run, if it is a script within a text document. </p>
+
+ @code{.bas}
+ Sub Main
+ oFrame = ThisComponent.createInstance( "com.sun.star.text.TextFrame" )
+ oFrame.Width = 6000
+ ThisComponent.Text.insertTextContent( ThisComponent.Text.Start, oFrame, false )
+ oFrame.Text.String = "Hello, this text is within the frame."
+ End Sub
+ @endcode
+ */
+published service TextFrame
+{
+ /** contains the definition of interfaces and properties that are supported by text frames,
+ graphic objects and embedded objects.
+ */
+ service BaseFrame;
+
+ /** This interface makes it possible to access the text within this
+ text frame.
+ */
+ interface com::sun::star::text::XTextFrame;
+ /** contains the metric height value of the frame.
+ */
+ [property] long FrameHeightAbsolute;
+
+ /** contains the metric width value of the frame.
+ */
+ [property] long FrameWidthAbsolute;
+
+
+ /** specifies a width relative to the width of the
+ surrounding text.
+ <p>If the value for "WidthPercent" is 0, the absolute value from
+ is used.</p>
+ */
+ [property] byte FrameWidthPercent;
+
+ /** specifies a width relative to the width of the
+ surrounding text.
+
+ <p>If the value for "HeightPercent" is 0, the absolute value from
+ is used.</p>
+ */
+ [property] byte FrameHeightPercent;
+ /** If "AutomaticHeight" is set, then the object grows if it is required
+ by the frame content.
+ */
+ [property] boolean FrameIsAutomaticHeight;
+ /** determines the interpretation of the height and relative
+ height properties.
+
+ @see SizeType
+ */
+ [property] short SizeType;
+ /** determines if the text frame should be editable in a read-only document.
+ (This is usually used in forms.)
+
+ */
+ [optional, property] boolean EditInReadonly;
+
+ /** determines the interpretation of the width and relative
+ width properties.
+
+ @see SizeType
+ @since OOo 2.4
+ */
+ [optional, property] short WidthType;
+
+ /** contains the writing direction, as represented by the
+ com::sun::star::text::WritingMode2 constants
+ */
+ [optional, property] short WritingMode;
+
+ /** controls, if the frame follows the text flow or can leave its layout environment
+
+ <p>If set, the frame follows the text flow and doesn't leaves the layout
+ environment, which is given by its anchor, above and below.
+ E.g.: Anchor resides in the document body then the frame doesn't leave
+ the document body above and below and follows the text flow through
+ the document bodies of the different pages.
+
+ If not set, the frame doesn't follow the text flow and stays on the page,
+ on which its anchor is found, but it may leave the layout environment,
+ which is given by its anchor.
+ E.g.: Anchor resides in the document body then the frame stays on page,
+ where this document body is, but it could leave the document body above
+ and below, e.g. overlapping with the page header.
+
+ Note: The areas for the vertical orientation relation at page areas are
+ interpreted in dependence to this property (@see BaseFrameProperties.VertOrientRelation).
+ If property is set, the page area is interpreted as the layout environment,
+ given by its anchor. E.g.: Anchor resides in the page header then the
+ page header determines the page area. If property isn't set, the page area is
+ determined by the document page, the anchor is on. E.g.: Anchor resides
+ in the page header then the document page, the page header is on, determines
+ the page area.
+ An exception of this interpretation rule is applied, if the anchor resides
+ in a table cell. In this situation the page area is always determined by
+ the table cell.</p>
+ */
+ [optional, property] boolean IsFollowingTextFlow;
+
+ /** adjusts the vertical position of the text inside of the frame.
+
+ @see com::sun::star::drawing::TextVerticalAdjust
+ @since LibreOffice 4.3
+ */
+ [optional, property] com::sun::star::drawing::TextVerticalAdjust TextVerticalAdjust;
+
+ /** Parent text of this text frame.
+
+ This might be a header text, body text, etc.
+
+ @since LibreOffice 6.3
+ */
+ [optional, readonly, property] com::sun::star::text::XText ParentText;
+};
+
+
+}; }; }; };
+
+#endif
+
+/* vim:set shiftwidth=4 softtabstop=4 expandtab: */