summaryrefslogtreecommitdiffstats
path: root/offapi/com/sun/star/style/CharacterProperties.idl
diff options
context:
space:
mode:
Diffstat (limited to '')
-rw-r--r--offapi/com/sun/star/style/CharacterProperties.idl489
1 files changed, 489 insertions, 0 deletions
diff --git a/offapi/com/sun/star/style/CharacterProperties.idl b/offapi/com/sun/star/style/CharacterProperties.idl
new file mode 100644
index 000000000..edb40949d
--- /dev/null
+++ b/offapi/com/sun/star/style/CharacterProperties.idl
@@ -0,0 +1,489 @@
+/* -*- 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_CharacterProperties_idl__
+#define __com_sun_star_style_CharacterProperties_idl__
+
+#include <com/sun/star/lang/Locale.idl>
+#include <com/sun/star/util/Color.idl>
+#include <com/sun/star/awt/FontSlant.idl>
+#include <com/sun/star/container/XNameContainer.idl>
+#include <com/sun/star/table/BorderLine2.idl>
+#include <com/sun/star/table/ShadowFormat.idl>
+#include <com/sun/star/beans/PropertyValue.idl>
+
+
+ module com { module sun { module star { module style {
+
+
+/** This is a set of properties to describe the style of characters.@see ParagraphProperties
+ */
+published service CharacterProperties
+{
+
+ /** This property specifies the name of the font style.
+
+ <p>It may contain more than one name separated by comma.</p>
+ */
+ [property] string CharFontName;
+
+
+ /** This property contains the name of the font style.
+
+ <p>This property may be empty.</p>
+ */
+ [property] string CharFontStyleName;
+
+
+ /** This property contains font family.
+ @see com::sun::star::awt::FontFamily
+ */
+ [property] short CharFontFamily;
+
+
+ /** This property contains the text encoding of the font.
+ @see com::sun::star::awt::CharSet
+ */
+ [property] short CharFontCharSet;
+
+
+ /** This property contains the font pitch.
+ @see com::sun::star::awt::FontPitch
+ */
+ [property] short CharFontPitch;
+
+
+ /** This property contains the value of the text color.
+ */
+ [property] com::sun::star::util::Color CharColor;
+
+
+ /** specifies the percentage by which to raise/lower superscript/subscript
+ characters.
+
+ <p>Negative values denote subscripts and positive values superscripts.</p>
+
+ @see CharEscapementHeight
+ */
+ [optional, property] short CharEscapement;
+
+
+ /** This value contains the height of the characters in point.
+ */
+ [property] float CharHeight;
+
+
+ /** This property contains the value for the character underline.
+ @see com::sun::star::awt::FontUnderline
+ */
+ [property] short CharUnderline;
+
+
+ /** This property contains the value of the font weight.
+ @see com::sun::star::awt::FontWeight
+ */
+ [property] float CharWeight;
+
+
+ /** This property contains the value of the posture of the document.
+ @see com::sun::star::awt::FontSlant
+ */
+ [property] com::sun::star::awt::FontSlant CharPosture;
+
+
+ /** This optional property determines whether the kerning tables from the
+ current font are used.
+
+ <p>Automatic <em>kerning</em> applies a spacing in between certain
+ pairs of characters to make the text look better.</p>
+ */
+ [optional, property] boolean CharAutoKerning;
+
+
+ /** This optional property contains the text background color.
+ */
+ [optional, property] com::sun::star::util::Color CharBackColor;
+
+
+ /** This optional property contains the text shading value.
+ */
+ [optional, property] long CharShadingValue;
+
+
+ /** This property determines if the text background color is set to
+ transparent.
+ */
+ [optional, property] boolean CharBackTransparent;
+
+
+ /** This optional property contains the value of the case-mapping of the
+ text for formatting and displaying.
+
+ @see CaseMap
+ */
+ [optional, property] short CharCaseMap;
+
+
+ /** This property is `TRUE` if the characters are crossed out.
+ */
+ [optional, property] boolean CharCrossedOut;
+
+
+ /** If this optional property is `TRUE`, then the characters are flashing.
+ */
+ [optional, property] boolean CharFlash;
+
+
+ /** This property determines the type of the strike out of the character.
+ @see com::sun::star::awt::FontStrikeout
+ */
+ [optional, property] short CharStrikeout;
+
+
+ /** If this property is `TRUE`, the underline and strike-through
+ properties are not applied to white spaces.
+ */
+ [optional, property] boolean CharWordMode;
+
+
+ /** This optional property contains the value of the kerning of the
+ characters.
+ */
+ [optional, property] short CharKerning;
+
+
+ /** This property contains the value of the locale.
+ */
+ [property] com::sun::star::lang::Locale CharLocale;
+
+
+ /** This optional property marks a range of characters to prevent it from
+ being broken into two lines.
+
+ <p> A line break is applied before the range of characters if
+ the layout makes a break necessary within the range.</p>
+ */
+ [optional, property] boolean CharKeepTogether;
+
+
+ /** This optional property marks a range of characters to ignore a line
+ break in this area.
+
+ <p> A line break is applied behind the range of characters if
+ the layout makes a break necessary within the range. That means that
+ the text may go through the border.</p>
+ */
+ [optional, property] boolean CharNoLineBreak;
+
+
+ /** This optional property specifies if the characters are formatted and
+ displayed with a shadow effect.
+ */
+ [optional, property] boolean CharShadowed;
+
+
+ /** This optional property specifies the fundamental technology of the font.
+ @see com::sun::star::awt::FontType
+ */
+ [optional, property] short CharFontType;
+
+
+ /** This optional property specifies the name of the style of the font.
+ */
+ [optional, property] string CharStyleName;
+
+
+ /** This optional property specifies if the characters are formatted and
+ displayed with a contour effect.
+ */
+ [optional, property] boolean CharContoured;
+
+
+ /** This optional property determines whether text is formatted in two lines.
+
+ <p>It is linked to the properties CharCombinePrefix and CharCombineSuffix.</p>
+ */
+ [optional, property] boolean CharCombineIsOn;
+
+
+ /** This optional property contains the prefix (usually parenthesis) before
+ text that is formatted in two lines.
+
+ <p>It is linked to the properties CharCombineIsOn and CharCombineSuffix.</p>
+ */
+ [optional, property] string CharCombinePrefix;
+
+
+ /** This optional property contains the suffix (usually parenthesis) after
+ text that is formatted in two lines.
+
+ <p>It is linked to the properties CharCombineIsOn and CharCombinePrefix.</p>
+ */
+ [optional, property] string CharCombineSuffix;
+
+
+ /** This optional property contains the font emphasis value.
+ @see com::sun::star::text::FontEmphasis
+ */
+ [optional, property] short CharEmphasis;
+
+
+ /** This optional property contains the relief style of the characters.
+ @see com::sun::star::text::FontRelief
+ */
+ [optional, property] short CharRelief;
+
+
+ /** This optional property contains the text that is set as ruby.
+ */
+ [optional, property] string RubyText;
+
+
+ /** This optional property determines the adjustment of the ruby .
+ @see com::sun::star::text::RubyAdjust
+ */
+ [optional, property] short RubyAdjust;
+
+
+ /** This optional property contains the name of the character style that is
+ applied to RubyText.
+ */
+ [optional, property] string RubyCharStyleName;
+
+
+ /** This optional property determines whether the ruby text is printed
+ above/left or below/right of the text.
+ <p>This property is replaced by RubyPosition.</p>
+ @deprecated
+ */
+ [optional, property] boolean RubyIsAbove;
+
+
+ /** This optional property determines the rotation of a character in tenths
+ of a degree.
+
+ <p>Depending on the implementation only certain values may be allowed.</p>
+ */
+ [optional, property] short CharRotation;
+
+
+ /** This optional property determines whether the text formatting tries to
+ fit rotated text into the surrounded line height.
+ */
+ [optional, property] boolean CharRotationIsFitToLine;
+
+
+ /** This optional property determines the percentage value for scaling the
+ width of characters.
+
+ <p>The value refers to the original width which is denoted by 100,
+ and it has to be greater than 0.</p>
+ */
+ [optional, property] short CharScaleWidth;
+
+
+ /** This optional property contains the URL of a hyperlink.
+ */
+ [optional, property] string HyperLinkURL;
+
+
+ /** This optional property contains the name of the target for a hyperlink.
+ */
+ [optional, property] string HyperLinkTarget;
+
+
+ /** This optional property contains the name of the hyperlink.
+ */
+ [optional, property] string HyperLinkName;
+
+
+ /** This optional property contains the character style name for visited
+ hyperlinks.
+ */
+ [optional, property] string VisitedCharStyleName;
+
+
+ /** This optional property contains the character style name for unvisited
+ hyperlinks.
+ */
+ [optional, property] string UnvisitedCharStyleName;
+
+
+ /** This is the relative height used for subscript or superscript
+ characters in units of percent.
+
+ <p>The value 100 denotes the original height of the characters.</p>
+
+ @see CharEscapement
+ */
+ [optional, property] byte CharEscapementHeight;
+
+
+ /** This optional property determines if the word can be hyphenated at the
+ character.
+ */
+ [optional, property] boolean CharNoHyphenation;
+
+
+ /** This property contains the color of the underline for the characters.
+ @see CharUnderlineHasColor
+ */
+ [property] com::sun::star::util::Color CharUnderlineColor;
+
+
+ /** This property specifies if the property CharUnderlineColor is used for
+ an underline.
+ @see CharUnderlineColor
+ */
+ [property] boolean CharUnderlineHasColor;
+
+
+ /** This optional property specifies the names of the all styles applied to
+ the font.
+
+ <p> It is not guaranteed that the order in the sequence reflects
+ the order of the evaluation of the character style attributes.</p>
+
+ @since OOo 1.1.2
+ */
+ [optional, property] sequence<string> CharStyleNames;
+
+
+ /** If this optional property is `TRUE`, then the characters are invisible.
+
+ @since OOo 2.0
+ */
+ [optional, property] boolean CharHidden;
+
+
+ /** 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 TextUserDefinedAttributes;
+
+ /** This property contains the left border of the object.
+ *
+ * @since LibreOffice 4.2
+ **/
+ [property, optional] com::sun::star::table::BorderLine2 CharLeftBorder;
+
+ /** This property contains the right border of the object.
+ *
+ * @since LibreOffice 4.2
+ **/
+ [property, optional] com::sun::star::table::BorderLine2 CharRightBorder;
+
+ /** This property contains the top border of the object.
+ *
+ * @since LibreOffice 4.2
+ **/
+ [property, optional] com::sun::star::table::BorderLine2 CharTopBorder;
+
+ /** This property contains the bottom border of the object.
+ *
+ * @since LibreOffice 4.2
+ **/
+ [property, optional] com::sun::star::table::BorderLine2 CharBottomBorder;
+
+ /** This property contains the distance from the border to the object.
+ *
+ * @since LibreOffice 4.2
+ **/
+ [property, optional] long CharBorderDistance;
+
+ /** This property contains the distance from the left border to the object.
+ *
+ * @since LibreOffice 4.2
+ **/
+ [property, optional] long CharLeftBorderDistance;
+
+ /** This property contains the distance from the right border to the object.
+ *
+ * @since LibreOffice 4.2
+ **/
+ [property, optional] long CharRightBorderDistance;
+
+ /** This property contains the distance from the top border to the object.
+ *
+ * @since LibreOffice 4.2
+ **/
+ [property, optional] long CharTopBorderDistance;
+
+ /** This property contains the distance from the bottom border to the object.
+ *
+ * @since LibreOffice 4.2
+ **/
+ [property, optional] long CharBottomBorderDistance;
+
+ /** Determines the type, color, and width of the shadow.
+ *
+ * @since LibreOffice 4.2
+ **/
+ [optional, property] com::sun::star::table::ShadowFormat CharShadowFormat;
+
+ /** Determines the color of the highlight.
+ *
+ * @since LibreOffice 4.2
+ **/
+ [optional, property] com::sun::star::util::Color CharHighlight;
+
+ /** Grab bag of character 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> CharInteropGrabBag;
+
+ /** This optional property determines the position of the ruby .
+ @see com::sun::star::text::RubyPosition
+ @since LibreOffice 6.1
+ */
+ [optional, property] short RubyPosition;
+
+ /** This is the transparency of the character text.
+
+ @since LibreOffice 7.0
+
+ <p>The value 100 means entirely transparent, while 0 means not transparent at all.</p>
+ */
+ [optional, property] short CharTransparence;
+
+ /** If available, keeps the color theme index, so that the character can
+ * be re-colored easily based on a theme.
+ *
+ * @since LibreOffice 7.3
+ **/
+ [optional, property] short CharColorTheme;
+
+ /** Tint or shade of the character color.
+ *
+ * @since LibreOffice 7.3
+ **/
+ [optional, property] short CharColorTintOrShade;
+};
+
+}; }; }; };
+
+#endif
+
+/* vim:set shiftwidth=4 softtabstop=4 expandtab: */