Version 5.2.6.1, tag libreoffice-5.2.6.1
[LibreOffice.git] / offapi / com / sun / star / awt / FontDescriptor.idl
blob3e83889e0346e11ad83de2ec8b974aba2e9f6e52
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_awt_FontDescriptor_idl__
20 #define __com_sun_star_awt_FontDescriptor_idl__
22 #include <com/sun/star/awt/FontSlant.idl>
26 module com { module sun { module star { module awt {
29 /** describes the characteristics of a font.
31 <p>For example, this can be used to select a font.</p>
33 published struct FontDescriptor
36 /** specifies the exact name of the font.
38 string Name;
41 /** specifies the height of the font in the measure of the
42 destination.
44 short Height;
47 /** specifies the width of the font in the measure of the
48 destination.
50 short Width;
53 /** specifies the style name of the font.
55 string StyleName;
58 /** specifies the general style of the font.
60 <p>Use one value out of the constant group
61 com::sun::star::awt::FontFamily.</p>
63 short Family;
66 /** specifies the character set which is supported by the font.
68 <p>Use one value out of the constant group
69 com::sun::star::awt::CharSet.</p>
71 short CharSet;
74 /** specifies the pitch of the font.
76 <p>Use one value out of the constant group
77 com::sun::star::awt::FontPitch.</p>
79 short Pitch;
82 /** specifies the character width.
84 <p>Depending on the specified width, a font that supports this
85 width may be selected.</p>
87 <p>The value is expressed as a percentage.</p>
89 float CharacterWidth;
92 /** specifies the thickness of the line.
94 <p>Depending on the specified weight, a font that supports this
95 thickness may be selected.</p>
97 <p>The value is expressed as a percentage.</p>
99 float Weight;
102 /** specifies the slant of the font.
104 com::sun::star::awt::FontSlant Slant;
107 /** specifies the kind of underlining.
109 <p>Use one value out of the constant group
110 com::sun::star::awt::FontUnderline.</p>
112 short Underline;
115 /** specifies the kind of strikeout.
117 <p>Use one value out of the constant group
118 com::sun::star::awt::FontStrikeout.</p>
120 short Strikeout;
123 /** specifies the rotation of the font.
125 <p>The unit of measure is degrees; 0 is the baseline.</p>
127 float Orientation;
130 /** For requesting, it specifies if there is a kerning table available.
131 For selecting, it specifies if the kerning table is to be used.
133 boolean Kerning;
136 /** specifies if only words get underlined.
138 <p>`TRUE` means that only non-space characters get underlined,
139 `FALSE` means that the spacing also gets underlined.</p>
141 <p>This property is only valid if the property
142 com::sun::star::awt::FontDescriptor::Underline
143 is not FontUnderline::NONE.</p>
145 boolean WordLineMode;
148 /** specifies the technology of the font representation.
150 <p>One or more values out of the constant group
151 com::sun::star::awt::FontType can be combined by
152 an arithmetical or-operation.</p>
154 short Type;
159 }; }; }; };
161 #endif
163 /* vim:set shiftwidth=4 softtabstop=4 expandtab: */