Version 5.2.6.1, tag libreoffice-5.2.6.1
[LibreOffice.git] / offapi / com / sun / star / report / XReportControlFormat.idl
blob42926ff53955df4fbd60163f95a74889ecddc583
1 /* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
2 /*
3 * This file is part of the LibreOffice project.
5 * This Source Code Form is subject to the terms of the Mozilla Public
6 * License, v. 2.0. If a copy of the MPL was not distributed with this
7 * file, You can obtain one at http://mozilla.org/MPL/2.0/.
9 * This file incorporates work covered by the following license notice:
11 * Licensed to the Apache Software Foundation (ASF) under one or more
12 * contributor license agreements. See the NOTICE file distributed
13 * with this work for additional information regarding copyright
14 * ownership. The ASF licenses this file to you under the Apache
15 * License, Version 2.0 (the "License"); you may not use this file
16 * except in compliance with the License. You may obtain a copy of
17 * the License at http://www.apache.org/licenses/LICENSE-2.0 .
19 #ifndef __com_sun_star_report_XReportControlFormat_idl__
20 #define __com_sun_star_report_XReportControlFormat_idl__
22 #include <com/sun/star/awt/FontDescriptor.idl>
23 #include <com/sun/star/awt/FontSlant.idl>
24 #include <com/sun/star/beans/XPropertySet.idl>
25 #include <com/sun/star/lang/IllegalArgumentException.idl>
26 #include <com/sun/star/lang/Locale.idl>
27 #include <com/sun/star/style/ParagraphAdjust.idl>
28 #include <com/sun/star/style/VerticalAlignment.idl>
29 #include <com/sun/star/util/Color.idl>
31 module com { module sun { module star { module report {
33 /** specifies a format condition for a control.
35 interface XReportControlFormat
37 /** specifies the background color (RGB) of the control.
39 [attribute,bound] com::sun::star::util::Color ControlBackground
41 set raises ( com::sun::star::beans::UnknownPropertyException );
42 get raises ( com::sun::star::beans::UnknownPropertyException );
45 /** determines if the back ground color is set to transparent.
47 [attribute,bound] boolean ControlBackgroundTransparent
49 set raises ( com::sun::star::beans::UnknownPropertyException );
50 get raises ( com::sun::star::beans::UnknownPropertyException );
53 /** specifies the horizontal alignment of the text.
54 @see ::com::sun::star::style::ParagraphAdjust
56 [attribute,bound] short ParaAdjust
58 set raises ( com::sun::star::beans::UnknownPropertyException );
59 get raises ( com::sun::star::beans::UnknownPropertyException );
63 /** specifies the font attributes of the text in the control.
65 [attribute,bound] com::sun::star::awt::FontDescriptor FontDescriptor
67 set raises ( com::sun::star::beans::UnknownPropertyException );
68 get raises ( com::sun::star::beans::UnknownPropertyException );
71 /** specifies the font attributes of the text in the control.
73 [attribute,bound] com::sun::star::awt::FontDescriptor FontDescriptorAsian
75 set raises ( com::sun::star::beans::UnknownPropertyException );
76 get raises ( com::sun::star::beans::UnknownPropertyException );
79 /** specifies the font attributes of the text in the control.
81 [attribute,bound] com::sun::star::awt::FontDescriptor FontDescriptorComplex
83 set raises ( com::sun::star::beans::UnknownPropertyException );
84 get raises ( com::sun::star::beans::UnknownPropertyException );
88 /** specifies the com::sun::star::text::FontEmphasis
89 value of the text in the control.
91 [attribute,bound] short ControlTextEmphasis
93 set raises ( com::sun::star::beans::UnknownPropertyException );
94 get raises ( com::sun::star::beans::UnknownPropertyException );
97 /** contains the font emphasis value as com::sun::star::text::FontEmphasis.
99 [attribute,bound] short CharEmphasis
101 set raises ( com::sun::star::beans::UnknownPropertyException );
102 get raises ( com::sun::star::beans::UnknownPropertyException );
105 /** determines whether text is formatted in two lines.
106 <p>It is linked to the properties CharCombinePrefix and CharCombineSuffix.</p>
108 [attribute,bound] boolean CharCombineIsOn
110 set raises ( com::sun::star::beans::UnknownPropertyException );
111 get raises ( com::sun::star::beans::UnknownPropertyException );
113 /** contains the prefix (usually parenthesis) before text that is formatted in two lines.
114 <p>It is linked to the properties CharCombineIsOn and CharCombineSuffix.</p>
116 [attribute,bound] string CharCombinePrefix
118 set raises ( com::sun::star::beans::UnknownPropertyException );
119 get raises ( com::sun::star::beans::UnknownPropertyException );
121 /** contains the suffix (usually parenthesis) after text that is formatted in two lines.
122 <p>It is linked to the properties CharCombineIsOn and CharCombinePrefix.</p>
124 [attribute,bound] string CharCombineSuffix
126 set raises ( com::sun::star::beans::UnknownPropertyException );
127 get raises ( com::sun::star::beans::UnknownPropertyException );
130 /** If this optional property is `TRUE`, then the characters are invisible.
132 @since OOo 2.0
134 [attribute,bound] boolean CharHidden
136 set raises ( com::sun::star::beans::UnknownPropertyException );
137 get raises ( com::sun::star::beans::UnknownPropertyException );
140 /** specifies if the characters are formatted and
141 displayed with a shadow effect.
143 [attribute,bound] boolean CharShadowed
145 set raises ( com::sun::star::beans::UnknownPropertyException );
146 get raises ( com::sun::star::beans::UnknownPropertyException );
149 /** specifies if the characters are formatted and
150 displayed with a contour effect.
152 [attribute,bound] boolean CharContoured
154 set raises ( com::sun::star::beans::UnknownPropertyException );
155 get raises ( com::sun::star::beans::UnknownPropertyException );
158 /** optional property which contains the value of the case-mapping of the
159 text for formatting and displaying.
161 @see CaseMap
163 [attribute,bound] short CharCaseMap
165 set raises ( com::sun::star::beans::UnknownPropertyException );
166 get raises ( com::sun::star::beans::UnknownPropertyException );
169 /** contains the value of the locale.
171 [attribute,bound] com::sun::star::lang::Locale CharLocale
173 set raises ( com::sun::star::beans::UnknownPropertyException );
174 get raises ( com::sun::star::beans::UnknownPropertyException );
177 /** specifies the percentage by which to raise/lower superscript/subscript
178 characters.
180 <p>Negative values denote subscripts and positive values superscripts.</p>
182 [attribute,bound] short CharEscapement
184 set raises ( com::sun::star::beans::UnknownPropertyException );
185 get raises ( com::sun::star::beans::UnknownPropertyException );
188 /** This is the additional height used for subscript or superscript
189 characters in units of percent.
190 For subscript characters the value is negative and for
191 superscript characters positive.
193 [attribute,bound] byte CharEscapementHeight
195 set raises ( com::sun::star::beans::UnknownPropertyException );
196 get raises ( com::sun::star::beans::UnknownPropertyException );
199 /** optional property to determine whether the kerning tables from the current font are used.
200 <p>Automatic <em>kerning</em> applies a spacing in between certain
201 pairs of characters to make the text look better.</p>
203 [attribute,bound] boolean CharAutoKerning
205 set raises ( com::sun::star::beans::UnknownPropertyException );
206 get raises ( com::sun::star::beans::UnknownPropertyException );
209 /** optional property which contains the value of the kerning of the characters.
211 [attribute,bound] short CharKerning
213 set raises ( com::sun::star::beans::UnknownPropertyException );
214 get raises ( com::sun::star::beans::UnknownPropertyException );
217 /** If this optional property is `TRUE`, then the characters are flashing.
219 [attribute,bound] boolean CharFlash
221 set raises ( com::sun::star::beans::UnknownPropertyException );
222 get raises ( com::sun::star::beans::UnknownPropertyException );
225 /** specifies the com::sun::star::text::FontRelief
226 value of the text in the control.
228 [attribute,bound] short CharRelief
230 set raises ( com::sun::star::beans::UnknownPropertyException );
231 get raises ( com::sun::star::beans::UnknownPropertyException );
234 /** This attribute specifies the name of the font style.
238 <p>It may contain more than one name separated by comma.</p>
240 [attribute,bound] string CharFontName
242 set raises ( com::sun::star::beans::UnknownPropertyException );
243 get raises ( com::sun::star::beans::UnknownPropertyException );
246 /** This attribute contains the name of the font style.
248 <p>This attribute may be empty.</p>
250 [attribute,bound] string CharFontStyleName
252 set raises ( com::sun::star::beans::UnknownPropertyException );
253 get raises ( com::sun::star::beans::UnknownPropertyException );
256 /** This attribute contains font family as specified in
257 com.sun.star.awt.FontFamily .
259 [attribute,bound] short CharFontFamily
261 set raises ( com::sun::star::beans::UnknownPropertyException );
262 get raises ( com::sun::star::beans::UnknownPropertyException );
265 /** This attribute contains the text encoding of the font as specified in
266 com.sun.star.awt.CharSet.
268 [attribute,bound] short CharFontCharSet
270 set raises ( com::sun::star::beans::UnknownPropertyException );
271 get raises ( com::sun::star::beans::UnknownPropertyException );
274 /** This attribute contains the font pitch as specified in com.sun.star.awt.FontPitch.
276 [attribute,bound] short CharFontPitch
278 set raises ( com::sun::star::beans::UnknownPropertyException );
279 get raises ( com::sun::star::beans::UnknownPropertyException );
282 /** specifies the text color (RGB) of the control.
284 [attribute,bound] com::sun::star::util::Color CharColor
286 set raises ( com::sun::star::beans::UnknownPropertyException );
287 get raises ( com::sun::star::beans::UnknownPropertyException );
291 /** specifies the text line color (RGB) of the control.
293 [attribute,bound] com::sun::star::util::Color CharUnderlineColor
295 set raises ( com::sun::star::beans::UnknownPropertyException );
296 get raises ( com::sun::star::beans::UnknownPropertyException );
299 /** This value contains the height of the characters in point.
301 [attribute,bound] float CharHeight
303 set raises ( com::sun::star::beans::UnknownPropertyException );
304 get raises ( com::sun::star::beans::UnknownPropertyException );
308 /** This attribute contains the value for the character underline.@see com::sun::star::awt::FontUnderline
310 [attribute,bound] short CharUnderline
312 set raises ( com::sun::star::beans::UnknownPropertyException );
313 get raises ( com::sun::star::beans::UnknownPropertyException );
317 /** This attribute contains the value of the font weight.@see com::sun::star::awt::FontWeight
319 [attribute,bound] float CharWeight
321 set raises ( com::sun::star::beans::UnknownPropertyException );
322 get raises ( com::sun::star::beans::UnknownPropertyException );
326 /** This attribute contains the value of the posture of the document.@see com::sun::star::awt::FontSlant
328 [attribute,bound] com::sun::star::awt::FontSlant CharPosture
330 set raises ( com::sun::star::beans::UnknownPropertyException );
331 get raises ( com::sun::star::beans::UnknownPropertyException );
334 /** determines the type of the strike out of the character.
335 @see com::sun::star::awt::FontStrikeout
337 [attribute,bound] short CharStrikeout
339 set raises ( com::sun::star::beans::UnknownPropertyException );
340 get raises ( com::sun::star::beans::UnknownPropertyException );
343 /** If this attribute is `TRUE`, the underline and strike-through
344 properties are not applied to white spaces.
346 [attribute,bound] boolean CharWordMode
348 set raises ( com::sun::star::beans::UnknownPropertyException );
349 get raises ( com::sun::star::beans::UnknownPropertyException );
352 /** determines the rotation of a character in degree.
353 <p>Depending on the implementation only certain values may be allowed.
354 </p>
356 [attribute,bound] short CharRotation
358 set raises ( com::sun::star::beans::UnknownPropertyException );
359 get raises ( com::sun::star::beans::UnknownPropertyException );
362 /** determines the percentage value for scaling the width of characters.
364 <p>The value refers to the original width which is denoted by 100,
365 and it has to be greater than 0.</p>
368 [attribute,bound] short CharScaleWidth
370 set raises ( com::sun::star::beans::UnknownPropertyException );
371 get raises ( com::sun::star::beans::UnknownPropertyException );
374 /** specifies the vertical alignment of the text in the control.
375 @see com::sun::star::style::VerticalAlignment
377 [attribute,bound] com::sun::star::style::VerticalAlignment VerticalAlign
379 set raises ( com::sun::star::lang::IllegalArgumentException,com::sun::star::beans::UnknownPropertyException );
380 get raises ( com::sun::star::beans::UnknownPropertyException );
383 /** contains the URL of a hyperlink (if set).
385 [attribute,bound] string HyperLinkURL
387 set raises ( com::sun::star::beans::UnknownPropertyException );
388 get raises ( com::sun::star::beans::UnknownPropertyException );
391 /** contains the name of the target for a hyperlink (if set).
393 [attribute,bound] string HyperLinkTarget
395 set raises ( com::sun::star::beans::UnknownPropertyException );
396 get raises ( com::sun::star::beans::UnknownPropertyException );
399 /** contains the name of the hyperlink (if set).
401 [attribute,bound] string HyperLinkName
403 set raises ( com::sun::star::beans::UnknownPropertyException );
404 get raises ( com::sun::star::beans::UnknownPropertyException );
407 /** contains the character style name for visited hyperlinks.
409 [attribute,bound] string VisitedCharStyleName
411 set raises ( com::sun::star::beans::UnknownPropertyException );
412 get raises ( com::sun::star::beans::UnknownPropertyException );
415 /** contains the character style name for unvisited hyperlinks.
417 [attribute,bound] string UnvisitedCharStyleName
419 set raises ( com::sun::star::beans::UnknownPropertyException );
420 get raises ( com::sun::star::beans::UnknownPropertyException );
422 /** This value contains the height of the characters in point.
424 [attribute,bound] float CharHeightAsian
426 set raises ( com::sun::star::beans::UnknownPropertyException );
427 get raises ( com::sun::star::beans::UnknownPropertyException );
429 /** This property contains the value of the font weight.@see com::sun::star::awt::FontWeight
431 [attribute,bound] float CharWeightAsian
433 set raises ( com::sun::star::beans::UnknownPropertyException );
434 get raises ( com::sun::star::beans::UnknownPropertyException );
436 /** This property specifies the name of the font style.
437 <p>It may contain more than one name separated by comma.</p>
439 [attribute,bound] string CharFontNameAsian
441 set raises ( com::sun::star::beans::UnknownPropertyException );
442 get raises ( com::sun::star::beans::UnknownPropertyException );
444 /** This property contains the name of the font style.
445 <p>This property may be empty.</p>
447 [attribute,bound] string CharFontStyleNameAsian
449 set raises ( com::sun::star::beans::UnknownPropertyException );
450 get raises ( com::sun::star::beans::UnknownPropertyException );
452 /** This property contains font family as specified in
453 com.sun.star.awt.FontFamily .
455 [attribute,bound] short CharFontFamilyAsian
457 set raises ( com::sun::star::beans::UnknownPropertyException );
458 get raises ( com::sun::star::beans::UnknownPropertyException );
460 /** This property contains the text encoding of the font as specified in
461 com.sun.star.awt.CharSet.
463 [attribute,bound] short CharFontCharSetAsian
465 set raises ( com::sun::star::beans::UnknownPropertyException );
466 get raises ( com::sun::star::beans::UnknownPropertyException );
468 /** This property contains the font pitch as specified in com.sun.star.awt.FontPitch.
470 [attribute,bound] short CharFontPitchAsian
472 set raises ( com::sun::star::beans::UnknownPropertyException );
473 get raises ( com::sun::star::beans::UnknownPropertyException );
475 /** This property contains the value of the posture of the document.@see com::sun::star::awt::FontSlant
477 [attribute,bound] com::sun::star::awt::FontSlant CharPostureAsian
479 set raises ( com::sun::star::beans::UnknownPropertyException );
480 get raises ( com::sun::star::beans::UnknownPropertyException );
483 /** contains the value of the locale.
485 [attribute,bound] com::sun::star::lang::Locale CharLocaleAsian
487 set raises ( com::sun::star::beans::UnknownPropertyException );
488 get raises ( com::sun::star::beans::UnknownPropertyException );
491 /** This value contains the height of the characters in point.
493 [attribute,bound] float CharHeightComplex
495 set raises ( com::sun::star::beans::UnknownPropertyException );
496 get raises ( com::sun::star::beans::UnknownPropertyException );
498 /** This property contains the value of the font weight.@see com::sun::star::awt::FontWeight
500 [attribute,bound] float CharWeightComplex
502 set raises ( com::sun::star::beans::UnknownPropertyException );
503 get raises ( com::sun::star::beans::UnknownPropertyException );
505 /** This property specifies the name of the font style.
506 <p>It may contain more than one name separated by comma.</p>
508 [attribute,bound] string CharFontNameComplex
510 set raises ( com::sun::star::beans::UnknownPropertyException );
511 get raises ( com::sun::star::beans::UnknownPropertyException );
513 /** This property contains the name of the font style.
514 <p>This property may be empty.</p>
516 [attribute,bound] string CharFontStyleNameComplex
519 set raises ( com::sun::star::beans::UnknownPropertyException );
520 get raises ( com::sun::star::beans::UnknownPropertyException );
522 /** This property contains font family as specified in
523 com.sun.star.awt.FontFamily .
525 [attribute,bound] short CharFontFamilyComplex
527 set raises ( com::sun::star::beans::UnknownPropertyException );
528 get raises ( com::sun::star::beans::UnknownPropertyException );
530 /** This property contains the text encoding of the font as specified in
531 com.sun.star.awt.CharSet.
533 [attribute,bound] short CharFontCharSetComplex
535 set raises ( com::sun::star::beans::UnknownPropertyException );
536 get raises ( com::sun::star::beans::UnknownPropertyException );
538 /** This property contains the font pitch as specified in com.sun.star.awt.FontPitch.
540 [attribute,bound] short CharFontPitchComplex
542 set raises ( com::sun::star::beans::UnknownPropertyException );
543 get raises ( com::sun::star::beans::UnknownPropertyException );
545 /** This property contains the value of the posture of the document.@see com::sun::star::awt::FontSlant
547 [attribute,bound] com::sun::star::awt::FontSlant CharPostureComplex
549 set raises ( com::sun::star::beans::UnknownPropertyException );
550 get raises ( com::sun::star::beans::UnknownPropertyException );
553 /** contains the value of the locale.
555 [attribute,bound] com::sun::star::lang::Locale CharLocaleComplex
557 set raises ( com::sun::star::beans::UnknownPropertyException );
558 get raises ( com::sun::star::beans::UnknownPropertyException );
563 }; }; }; };
564 #endif
566 /* vim:set shiftwidth=4 softtabstop=4 expandtab: */