Version 5.2.6.1, tag libreoffice-5.2.6.1
[LibreOffice.git] / offapi / com / sun / star / awt / UnoControlEditModel.idl
blob7eb54093cc5f8ff3cb85ae18cd63539dc8ae3250
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_UnoControlEditModel_idl__
20 #define __com_sun_star_awt_UnoControlEditModel_idl__
22 #include <com/sun/star/awt/FontDescriptor.idl>
23 #include <com/sun/star/awt/UnoControlModel.idl>
25 #include <com/sun/star/util/Color.idl>
27 #include <com/sun/star/style/VerticalAlignment.idl>
30 module com { module sun { module star { module awt {
33 /** specifies the standard model of an UnoControlEdit.
35 published service UnoControlEditModel
37 service com::sun::star::awt::UnoControlModel;
40 /** specifies the horizontal alignment of the text in the control.
42 <pre>
43 0: left
44 1: center
45 2: right
46 </pre>
48 [property] short Align;
51 /** If set to true an horizontal scrollbar will be added automatically
52 when needed.
54 @since OOo 2.3
56 [optional, property] boolean AutoHScroll;
59 /** If set to true an vertical scrollbar will be added automatically
60 when needed.
62 @since OOo 2.3
64 [optional, property] boolean AutoVScroll;
67 /** specifies the background color (RGB) of the control.
69 [property] com::sun::star::util::Color BackgroundColor;
72 /** specifies the border style of the control.
74 <pre>
75 0: No border
76 1: 3D border
77 2: simple border
78 </pre>
80 [property] short Border;
83 /** specifies the color of the border, if present
85 <p>Not every border style (see #Border) may support coloring.
86 For instance, usually a border with 3D effect will ignore the BorderColor setting.</p>
88 @since OOo 2.0
90 [optional, property] long BorderColor;
93 /** specifies the echo character for a password edit field.
95 [optional, property] short EchoChar;
98 /** determines whether the control is enabled or disabled.
100 [property] boolean Enabled;
103 /** specifies the font attributes of the text in the control.
105 [property] com::sun::star::awt::FontDescriptor FontDescriptor;
108 /** specifies the com::sun::star::text::FontEmphasis
109 value of the text in the control.
111 [property] short FontEmphasisMark;
114 /** specifies the com::sun::star::text::FontRelief
115 value of the text in the control.
117 [property] short FontRelief;
120 /** specifies if hard line breaks will be returned in the
121 XTextComponent::getText() method.
123 [property] boolean HardLineBreaks;
126 /** specifies the help text of the control.
128 [property] string HelpText;
131 /** specifies the help URL of the control.
133 [property] string HelpURL;
136 /** specifies whether the selection in the control should be hidden when
137 the control is not active (focused).
139 @since OOo 2.0
141 [optional, property] boolean HideInactiveSelection;
144 /** specifies if the content of the control can be scrolled in
145 the horizontal direction.
147 [property] boolean HScroll;
150 /** specifies which line end type should be used for multi line text
152 <p>Controls working with this model care for this setting when the user enters
153 text. Every line break entered into the control will be treated according to this
154 setting, so that the #Text property always contains only
155 line ends in the format specified.</p>
157 <p>Possible values are all constants from the LineEndFormat group.</p>
159 <p>Note that this setting is usually not relevant when you set new text via the API.
160 No matter which line end format is used in this new text then, usual control implementations
161 should recognize all line end formats and display them properly.</p>
163 @since OOo 2.0
165 [optional, property] short LineEndFormat;
168 /** specifies the maximum character count.
170 <p>There's no limitation, if set to 0.</p>
172 [property] short MaxTextLen;
175 /** specifies that the control may have more than one line.
177 [property] boolean MultiLine;
180 /** specifies whether the control paints it background or not.
182 @since OOo 2.3
184 [optional, property] boolean PaintTransparent;
187 /** specifies that the control will be printed with the document.
189 [property] boolean Printable;
192 /** specifies that the content of the control cannot be modified by the user.
194 [property] boolean ReadOnly;
197 /** specifies that the control can be reached with the TAB key.
199 [property] boolean Tabstop;
202 /** specifies the text displayed in the control.
204 [property] string Text;
207 /** specifies the text color (RGB) of the control.
209 [property] com::sun::star::util::Color TextColor;
212 /** specifies the text line color (RGB) of the control.
214 [property] com::sun::star::util::Color TextLineColor;
217 /** specifies if the content of the control can be scrolled in
218 the vertical direction.
220 [property] boolean VScroll;
222 /** denotes the writing mode used in the control, as specified in the
223 com::sun::star::text::WritingMode2 constants group.
225 <p>Only com::sun::star::text::WritingMode2::LR_TB and
226 com::sun::star::text::WritingMode2::RL_TB are supported at the moment.</p>
228 @since OOo 3.1
230 [optional, property] short WritingMode;
233 /** specifies the vertical alignment of the text in the control.
235 @since OOo 3.3
237 [optional, property] com::sun::star::style::VerticalAlignment VerticalAlign;
241 }; }; }; };
243 #endif
245 /* vim:set shiftwidth=4 softtabstop=4 expandtab: */