update dev300-m58
[ooovba.git] / offapi / com / sun / star / awt / UnoControlEditModel.idl
blob6d92a8f6b7a4cd430a00b8084608002df206bdb1
1 /*************************************************************************
3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
4 *
5 * Copyright 2008 by Sun Microsystems, Inc.
7 * OpenOffice.org - a multi-platform office productivity suite
9 * $RCSfile: UnoControlEditModel.idl,v $
10 * $Revision: 1.16 $
12 * This file is part of OpenOffice.org.
14 * OpenOffice.org is free software: you can redistribute it and/or modify
15 * it under the terms of the GNU Lesser General Public License version 3
16 * only, as published by the Free Software Foundation.
18 * OpenOffice.org is distributed in the hope that it will be useful,
19 * but WITHOUT ANY WARRANTY; without even the implied warranty of
20 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
21 * GNU Lesser General Public License version 3 for more details
22 * (a copy is included in the LICENSE file that accompanied this code).
24 * You should have received a copy of the GNU Lesser General Public License
25 * version 3 along with OpenOffice.org. If not, see
26 * <http://www.openoffice.org/license.html>
27 * for a copy of the LGPLv3 License.
29 ************************************************************************/
30 #ifndef __com_sun_star_awt_UnoControlEditModel_idl__
31 #define __com_sun_star_awt_UnoControlEditModel_idl__
33 #ifndef __com_sun_star_awt_FontDescriptor_idl__
34 #include <com/sun/star/awt/FontDescriptor.idl>
35 #endif
37 #ifndef __com_sun_star_awt_UnoControlModel_idl__
38 #include <com/sun/star/awt/UnoControlModel.idl>
39 #endif
41 #ifndef __com_sun_star_util_Color_idl__
42 #include <com/sun/star/util/Color.idl>
43 #endif
46 //=============================================================================
48 module com { module sun { module star { module awt {
50 //=============================================================================
52 /** specifies the standard model of an <type>UnoControlEdit</type>.
54 published service UnoControlEditModel
56 service com::sun::star::awt::UnoControlModel;
58 //-------------------------------------------------------------------------
60 /** specifies the horizontal alignment of the text in the control.
62 <pre>
63 0: left
64 1: center
65 2: right
66 </pre>
68 [property] short Align;
70 //-------------------------------------------------------------------------
72 /** If set to true an horizontal scrollbar will be added automaticly
73 when needed.
75 @since OOo 2.3.0
77 [optional, property] boolean AutoHScroll;
79 //-------------------------------------------------------------------------
81 /** If set to true an vertical scrollbar will be added automaticly
82 when needed.
84 @since OOo 2.3.0
86 [optional, property] boolean AutoVScroll;
88 //-------------------------------------------------------------------------
90 /** specifies the background color (RGB) of the control.
92 [property] com::sun::star::util::Color BackgroundColor;
94 //-------------------------------------------------------------------------
96 /** specifies the border style of the control.
98 <pre>
99 0: No border
100 1: 3D border
101 2: simple border
102 </pre>
104 [property] short Border;
106 //-------------------------------------------------------------------------
108 /** specifies the color of the border, if present
110 <p>Not every border style (see <member>Border</member>) may support coloring.
111 For instance, usually a border with 3D effect will ignore the BorderColor setting.</p>
113 @since OOo 2.0.0
115 [optional, property] long BorderColor;
117 //-------------------------------------------------------------------------
119 /** specifies the echo character for a password edit field.
121 [optional, property] short EchoChar;
123 //-------------------------------------------------------------------------
125 /** determines whether the control is enabled or disabled.
127 [property] boolean Enabled;
129 //-------------------------------------------------------------------------
131 /** specifies the font attributes of the text in the control.
133 [property] com::sun::star::awt::FontDescriptor FontDescriptor;
135 //-------------------------------------------------------------------------
137 /** specifies the <type scope="com::sun::star::text">FontEmphasis</type>
138 value of the text in the control.
140 [property] short FontEmphasisMark;
142 //-------------------------------------------------------------------------
144 /** specifies the <type scope="com::sun::star::text">FontRelief</type>
145 value of the text in the control.
147 [property] short FontRelief;
149 //-------------------------------------------------------------------------
151 /** specifies if hard line breaks will be returned in the
152 <member>XTextComponent::getText</member> method.
154 [property] boolean HardLineBreaks;
156 //-------------------------------------------------------------------------
158 /** specifies the help text of the control.
160 [property] string HelpText;
162 //-------------------------------------------------------------------------
164 /** specifies the help URL of the control.
166 [property] string HelpURL;
168 //-------------------------------------------------------------------------
170 /** specifies whether the selection in the control should be hidden when
171 the control is not active (focused).
173 @since OOo 2.0.0
175 [optional, property] boolean HideInactiveSelection;
177 //-------------------------------------------------------------------------
179 /** specifies if the content of the control can be scrolled in
180 the horizontal direction.
182 [property] boolean HScroll;
184 //-------------------------------------------------------------------------
186 /** specifies which line end type should be used for multi line text
188 <p>Controls working with this model care for this setting when the user enters
189 text. Every line break entered into the control will be treated according to this
190 setting, so that the <member>Text</member> property always contains only
191 line ends in the format specified.</p>
193 <p>Possible values are all constants from the <type>LineEndFormat</type> group.</p>
195 <p>Note that this setting is usually not relevant when you set new text via the API.
196 No matter which line end format is used in this new text then, usual control implementations
197 should recognize all line end formats and display them properly.</p>
199 @since OOo 2.0.0
201 [optional, property] short LineEndFormat;
203 //-------------------------------------------------------------------------
205 /** specifies the maximum character count.
207 <p>There's no limitation, if set to 0.</p>
209 [property] short MaxTextLen;
211 //-------------------------------------------------------------------------
213 /** specifies that the control may have more than one line.
215 [property] boolean MultiLine;
217 //-------------------------------------------------------------------------
219 /** specifies whether the control paints it background or not.
221 @since OOo 2.3.0
223 [optional, property] boolean PaintTransparent;
225 //-------------------------------------------------------------------------
227 /** specifies that the control will be printed with the document.
229 [property] boolean Printable;
231 //-------------------------------------------------------------------------
233 /** specifies that the content of the control cannot be modified by the user.
235 [property] boolean ReadOnly;
237 //-------------------------------------------------------------------------
239 /** specifies that the control can be reached with the TAB key.
241 [property] boolean Tabstop;
243 //-------------------------------------------------------------------------
245 /** specifies the text displayed in the control.
247 [property] string Text;
249 //-------------------------------------------------------------------------
251 /** specifies the text color (RGB) of the control.
253 [property] com::sun::star::util::Color TextColor;
255 //-------------------------------------------------------------------------
257 /** specifies the text line color (RGB) of the control.
259 [property] com::sun::star::util::Color TextLineColor;
261 //-------------------------------------------------------------------------
263 /** specifies if the content of the control can be scrolled in
264 the vertical direction.
266 [property] boolean VScroll;
268 /** denotes the writing mode used in the control, as specified in the
269 <type scope="com::sun::star::text">WritingMode2</type> constants group.
271 <p>Only <member scope="com::sun::star::text">WritingMode2::LR_TB</member> and
272 <member scope="com::sun::star::text">WritingMode2::RL_TB</member> are supported at the moment.</p>
274 @since OOo 3.1
276 [optional, property] short WritingMode;
279 //=============================================================================
281 }; }; }; };
283 #endif