Line data Source code
1 : /* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
2 : /*
3 : * This file is part of the LibreOffice project.
4 : *
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/.
8 : *
9 : * This file incorporates work covered by the following license notice:
10 : *
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 .
18 : */
19 :
20 : #ifndef EXTENSIONS_SOURCE_PROPCTRLR_PROPERTYHANDLER_HXX
21 : #define EXTENSIONS_SOURCE_PROPCTRLR_PROPERTYHANDLER_HXX
22 :
23 : #include "pcrcommon.hxx"
24 : #include "modulepcr.hxx"
25 :
26 : #include <com/sun/star/uno/XComponentContext.hpp>
27 : #include <com/sun/star/beans/PropertyState.hpp>
28 : #include <com/sun/star/beans/XPropertySet.hpp>
29 : #include <com/sun/star/beans/Property.hpp>
30 : #include <com/sun/star/script/XTypeConverter.hpp>
31 : #include <com/sun/star/frame/XModel.hpp>
32 : #include <com/sun/star/uno/Sequence.hxx>
33 : #include <com/sun/star/uno/Any.hxx>
34 : #include <com/sun/star/util/Date.hpp>
35 : #include <com/sun/star/util/Time.hpp>
36 : #include <com/sun/star/util/DateTime.hpp>
37 : #include <com/sun/star/lang/XMultiServiceFactory.hpp>
38 : #include <com/sun/star/inspection/XPropertyHandler.hpp>
39 : #include <com/sun/star/lang/XServiceInfo.hpp>
40 : #include <osl/interlck.h>
41 : #include <cppuhelper/compbase1.hxx>
42 : #include <cppuhelper/implbase1.hxx>
43 : #include <comphelper/uno3.hxx>
44 :
45 : #include <memory>
46 : #include <vector>
47 :
48 : namespace com { namespace sun { namespace star {
49 : namespace inspection {
50 : struct LineDescriptor;
51 : class XPropertyControlFactory;
52 : }
53 : } } }
54 :
55 : class Window;
56 :
57 : namespace pcr
58 : {
59 :
60 :
61 : typedef sal_Int32 PropertyId;
62 :
63 :
64 : //= PropertyHandler
65 :
66 : class OPropertyInfoService;
67 : typedef ::cppu::WeakComponentImplHelper1 < ::com::sun::star::inspection::XPropertyHandler
68 : > PropertyHandler_Base;
69 : /** the base class for property handlers
70 : */
71 : class PropertyHandler : public PropertyHandler_Base
72 : {
73 : private:
74 : /// cache for getSupportedProperties
75 : mutable StlSyntaxSequence< ::com::sun::star::beans::Property >
76 : m_aSupportedProperties;
77 : mutable bool m_bSupportedPropertiesAreKnown;
78 :
79 : /// helper which ensures that we can access resources as long as the instance lives
80 : PcrClient m_aEnsureResAccess;
81 :
82 : private:
83 : /// the property listener which has been registered
84 : PropertyChangeListeners m_aPropertyListeners;
85 :
86 : protected:
87 : mutable ::osl::Mutex m_aMutex;
88 : /// the context in which the instance was created
89 : ::com::sun::star::uno::Reference< ::com::sun::star::uno::XComponentContext > m_xContext;
90 : /// the component we're inspecting
91 : ::com::sun::star::uno::Reference< ::com::sun::star::beans::XPropertySet > m_xComponent;
92 : /// info about our component's properties
93 : ::com::sun::star::uno::Reference< ::com::sun::star::beans::XPropertySetInfo > m_xComponentPropertyInfo;
94 : /// type converter, needed on various occasions
95 : ::com::sun::star::uno::Reference< ::com::sun::star::script::XTypeConverter > m_xTypeConverter;
96 : /// access to property meta data
97 : ::std::auto_ptr< OPropertyInfoService > m_pInfoService;
98 :
99 : protected:
100 : PropertyHandler(
101 : const ::com::sun::star::uno::Reference< ::com::sun::star::uno::XComponentContext >& _rxContext
102 : );
103 : virtual ~PropertyHandler();
104 :
105 : // default implementations for XPropertyHandler
106 : virtual void SAL_CALL inspect( const ::com::sun::star::uno::Reference< ::com::sun::star::uno::XInterface >& _rxIntrospectee ) throw (::com::sun::star::uno::RuntimeException, ::com::sun::star::lang::NullPointerException, std::exception) SAL_OVERRIDE;
107 : virtual ::com::sun::star::uno::Sequence< ::com::sun::star::beans::Property > SAL_CALL getSupportedProperties() throw (::com::sun::star::uno::RuntimeException, std::exception) SAL_OVERRIDE;
108 : virtual ::com::sun::star::uno::Sequence< OUString > SAL_CALL getSupersededProperties( ) throw (::com::sun::star::uno::RuntimeException, std::exception) SAL_OVERRIDE;
109 : virtual ::com::sun::star::uno::Sequence< OUString > SAL_CALL getActuatingProperties( ) throw (::com::sun::star::uno::RuntimeException, std::exception) SAL_OVERRIDE;
110 : virtual ::com::sun::star::uno::Any SAL_CALL convertToPropertyValue( const OUString& _rPropertyName, const ::com::sun::star::uno::Any& _rControlValue ) throw (::com::sun::star::beans::UnknownPropertyException, ::com::sun::star::uno::RuntimeException, std::exception) SAL_OVERRIDE;
111 : virtual ::com::sun::star::uno::Any SAL_CALL convertToControlValue( const OUString& _rPropertyName, const ::com::sun::star::uno::Any& _rPropertyValue, const ::com::sun::star::uno::Type& _rControlValueType ) throw (::com::sun::star::beans::UnknownPropertyException, ::com::sun::star::uno::RuntimeException, std::exception) SAL_OVERRIDE;
112 : virtual ::com::sun::star::beans::PropertyState SAL_CALL getPropertyState( const OUString& _rPropertyName ) throw (::com::sun::star::beans::UnknownPropertyException, ::com::sun::star::uno::RuntimeException, std::exception) SAL_OVERRIDE;
113 : virtual ::com::sun::star::inspection::LineDescriptor SAL_CALL describePropertyLine( const OUString& _rPropertyName, const ::com::sun::star::uno::Reference< ::com::sun::star::inspection::XPropertyControlFactory >& _rxControlFactory ) throw (::com::sun::star::beans::UnknownPropertyException, ::com::sun::star::lang::NullPointerException, ::com::sun::star::uno::RuntimeException, std::exception) SAL_OVERRIDE;
114 : virtual sal_Bool SAL_CALL isComposable( const OUString& _rPropertyName ) throw (::com::sun::star::beans::UnknownPropertyException, ::com::sun::star::uno::RuntimeException, std::exception) SAL_OVERRIDE;
115 : virtual ::com::sun::star::inspection::InteractiveSelectionResult SAL_CALL onInteractivePropertySelection( const OUString& _rPropertyName, sal_Bool _bPrimary, ::com::sun::star::uno::Any& _rData, const ::com::sun::star::uno::Reference< ::com::sun::star::inspection::XObjectInspectorUI >& _rxInspectorUI ) throw (::com::sun::star::beans::UnknownPropertyException, ::com::sun::star::lang::NullPointerException, ::com::sun::star::uno::RuntimeException, std::exception) SAL_OVERRIDE;
116 : virtual void SAL_CALL actuatingPropertyChanged( const OUString& _rActuatingPropertyName, const ::com::sun::star::uno::Any& _rNewValue, const ::com::sun::star::uno::Any& _rOldValue, const ::com::sun::star::uno::Reference< ::com::sun::star::inspection::XObjectInspectorUI >& _rxInspectorUI, sal_Bool _bFirstTimeInit ) throw (::com::sun::star::lang::NullPointerException, ::com::sun::star::uno::RuntimeException, std::exception) SAL_OVERRIDE;
117 : virtual void SAL_CALL addPropertyChangeListener( const ::com::sun::star::uno::Reference< ::com::sun::star::beans::XPropertyChangeListener >& _rxListener ) throw (::com::sun::star::lang::NullPointerException, ::com::sun::star::uno::RuntimeException, std::exception) SAL_OVERRIDE;
118 : virtual void SAL_CALL removePropertyChangeListener( const ::com::sun::star::uno::Reference< ::com::sun::star::beans::XPropertyChangeListener >& _rxListener ) throw (::com::sun::star::uno::RuntimeException, std::exception) SAL_OVERRIDE;
119 : virtual sal_Bool SAL_CALL suspend( sal_Bool _bSuspend ) throw (::com::sun::star::uno::RuntimeException, std::exception) SAL_OVERRIDE;
120 :
121 : // XComponent
122 : DECLARE_XCOMPONENT()
123 : virtual void SAL_CALL disposing() SAL_OVERRIDE;
124 :
125 : // own overridables
126 : virtual ::com::sun::star::uno::Sequence< ::com::sun::star::beans::Property >
127 : SAL_CALL doDescribeSupportedProperties() const = 0;
128 :
129 : /// called when XPropertyHandler::inspect has been called, and we thus have a new component to inspect
130 : virtual void onNewComponent();
131 :
132 : protected:
133 : /** fires the change in a property value to our listener (if any)
134 : @see addPropertyChangeListener
135 : */
136 : void firePropertyChange( const OUString& _rPropName, PropertyId _nPropId,
137 : const ::com::sun::star::uno::Any& _rOldValue, const ::com::sun::star::uno::Any& _rNewValue ) SAL_THROW(());
138 :
139 : /** retrieves a window which can be used as parent for dialogs
140 : */
141 : Window* impl_getDefaultDialogParent_nothrow() const;
142 :
143 : /** retrieves the property id for a given property name
144 : @throw com::sun::star::beans::UnknownPropertyException
145 : if the property name is not known to our ->m_pInfoService
146 : */
147 : PropertyId impl_getPropertyId_throw( const OUString& _rPropertyName ) const;
148 :
149 : /** retrieves the property id for a given property name
150 : @returns -1
151 : if the property name is not known to our ->m_pInfoService
152 : */
153 : PropertyId impl_getPropertyId_nothrow( const OUString& _rPropertyName ) const;
154 :
155 : // helper for implementing doDescribeSupportedProperties
156 : /** adds a description for the given string property to the given property vector
157 : Most probably to be called from within getSupportedProperties
158 : */
159 : inline void addStringPropertyDescription(
160 : ::std::vector< ::com::sun::star::beans::Property >& _rProperties,
161 : const OUString& _rPropertyName,
162 : sal_Int16 _nAttribs = 0
163 : ) const;
164 :
165 : /** adds a description for the given int32 property to the given property vector
166 : */
167 : inline void addInt32PropertyDescription(
168 : ::std::vector< ::com::sun::star::beans::Property >& _rProperties,
169 : const OUString& _rPropertyName,
170 : sal_Int16 _nAttribs = 0
171 : ) const;
172 :
173 : /** adds a description for the given int16 property to the given property vector
174 : */
175 : inline void addInt16PropertyDescription(
176 : ::std::vector< ::com::sun::star::beans::Property >& _rProperties,
177 : const OUString& _rPropertyName,
178 : sal_Int16 _nAttribs = 0
179 : ) const;
180 :
181 : /** adds a description for the given double property to the given property vector
182 : */
183 : inline void addDoublePropertyDescription(
184 : ::std::vector< ::com::sun::star::beans::Property >& _rProperties,
185 : const OUString& _rPropertyName,
186 : sal_Int16 _nAttribs = 0
187 : ) const;
188 :
189 : /** adds a description for the given date property to the given property vector
190 : */
191 : inline void addDatePropertyDescription(
192 : ::std::vector< ::com::sun::star::beans::Property >& _rProperties,
193 : const OUString& _rPropertyName,
194 : sal_Int16 _nAttribs = 0
195 : ) const;
196 :
197 : /** adds a description for the given time property to the given property vector
198 : */
199 : inline void addTimePropertyDescription(
200 : ::std::vector< ::com::sun::star::beans::Property >& _rProperties,
201 : const OUString& _rPropertyName,
202 : sal_Int16 _nAttribs = 0
203 : ) const;
204 :
205 : /** adds a description for the given DateTime property to the given property vector
206 : */
207 : inline void addDateTimePropertyDescription(
208 : ::std::vector< ::com::sun::star::beans::Property >& _rProperties,
209 : const OUString& _rPropertyName,
210 : sal_Int16 _nAttribs = 0
211 : ) const;
212 :
213 : /// adds a Property, given by name only, to a given vector of Properties
214 : void implAddPropertyDescription(
215 : ::std::vector< ::com::sun::star::beans::Property >& _rProperties,
216 : const OUString& _rPropertyName,
217 : const ::com::sun::star::uno::Type& _rType,
218 : sal_Int16 _nAttribs = 0
219 : ) const;
220 :
221 :
222 : // helper for accessing and maintaining meta data about our supported properties
223 :
224 : /** retrieves a property given by handle
225 :
226 : @return
227 : a pointer to the descriptor for the given properties, if it is one of our
228 : supported properties, <NULL/> else.
229 :
230 : @see doDescribeSupportedProperties
231 : @see impl_getPropertyFromId_throw
232 : */
233 : const ::com::sun::star::beans::Property*
234 : impl_getPropertyFromId_nothrow( PropertyId _nPropId ) const;
235 :
236 : /** retrieves a property given by handle
237 :
238 : @throws UnknownPropertyException
239 : if the handler does not support a property with the given handle
240 :
241 : @seealso doDescribeSupportedProperties
242 : @see impl_getPropertyFromId_nothrow
243 : */
244 : const ::com::sun::star::beans::Property&
245 : impl_getPropertyFromId_throw( PropertyId _nPropId ) const;
246 :
247 : /** determines whether a given property id is part of our supported properties
248 : @see getSupportedProperties
249 : @see doDescribeSupportedProperties
250 : */
251 0 : inline bool impl_isSupportedProperty_nothrow( PropertyId _nPropId ) const
252 : {
253 0 : return impl_getPropertyFromId_nothrow( _nPropId ) != NULL;
254 : }
255 :
256 : /** retrieves a property given by name
257 :
258 : @throws UnknownPropertyException
259 : if the handler does not support a property with the given name
260 :
261 : @seealso doDescribeSupportedProperties
262 : */
263 : const ::com::sun::star::beans::Property&
264 : impl_getPropertyFromName_throw( const OUString& _rPropertyName ) const;
265 :
266 : /** get the name of a property given by handle
267 : */
268 : inline OUString
269 : impl_getPropertyNameFromId_nothrow( PropertyId _nPropId ) const;
270 :
271 : /** returns the value of the ContextDocument property in the ComponentContext which was used to create
272 : this handler.
273 : */
274 : inline ::com::sun::star::uno::Reference< ::com::sun::star::frame::XModel >
275 0 : impl_getContextDocument_nothrow() const
276 : {
277 : return ::com::sun::star::uno::Reference< ::com::sun::star::frame::XModel >(
278 0 : m_xContext->getValueByName( "ContextDocument" ), ::com::sun::star::uno::UNO_QUERY );
279 : }
280 :
281 : /** marks the context document as modified
282 :
283 : @see impl_getContextDocument_nothrow
284 : */
285 : void impl_setContextDocumentModified_nothrow() const;
286 :
287 : /// determines whether our component has a given property
288 : bool impl_componentHasProperty_throw( const OUString& _rPropName ) const;
289 :
290 : /** determines the default measure unit for the document in which our component lives
291 : */
292 : sal_Int16 impl_getDocumentMeasurementUnit_throw() const;
293 :
294 : private:
295 : PropertyHandler(); // never implemented
296 : PropertyHandler( const PropertyHandler& ); // never implemented
297 : PropertyHandler& operator=( const PropertyHandler& ); // never implemented
298 : };
299 :
300 :
301 0 : inline void PropertyHandler::addStringPropertyDescription( ::std::vector< ::com::sun::star::beans::Property >& _rProperties, const OUString& _rPropertyName, sal_Int16 _nAttribs ) const
302 : {
303 0 : implAddPropertyDescription( _rProperties, _rPropertyName, ::getCppuType( static_cast< OUString* >( NULL ) ), _nAttribs );
304 0 : }
305 :
306 0 : inline void PropertyHandler::addInt32PropertyDescription( ::std::vector< ::com::sun::star::beans::Property >& _rProperties, const OUString& _rPropertyName, sal_Int16 _nAttribs ) const
307 : {
308 0 : implAddPropertyDescription( _rProperties, _rPropertyName, ::getCppuType( static_cast< sal_Int32* >( NULL ) ), _nAttribs );
309 0 : }
310 :
311 0 : inline void PropertyHandler::addInt16PropertyDescription( ::std::vector< ::com::sun::star::beans::Property >& _rProperties, const OUString& _rPropertyName, sal_Int16 _nAttribs ) const
312 : {
313 0 : implAddPropertyDescription( _rProperties, _rPropertyName, ::getCppuType( static_cast< sal_Int16* >( NULL ) ), _nAttribs );
314 0 : }
315 :
316 0 : inline void PropertyHandler::addDoublePropertyDescription( ::std::vector< ::com::sun::star::beans::Property >& _rProperties, const OUString& _rPropertyName, sal_Int16 _nAttribs ) const
317 : {
318 0 : implAddPropertyDescription( _rProperties, _rPropertyName, ::getCppuType( static_cast< double* >( NULL ) ), _nAttribs );
319 0 : }
320 :
321 0 : inline void PropertyHandler::addDatePropertyDescription( ::std::vector< ::com::sun::star::beans::Property >& _rProperties, const OUString& _rPropertyName, sal_Int16 _nAttribs ) const
322 : {
323 0 : implAddPropertyDescription( _rProperties, _rPropertyName, ::getCppuType( static_cast< com::sun::star::util::Date* >( NULL ) ), _nAttribs );
324 0 : }
325 :
326 0 : inline void PropertyHandler::addTimePropertyDescription( ::std::vector< ::com::sun::star::beans::Property >& _rProperties, const OUString& _rPropertyName, sal_Int16 _nAttribs ) const
327 : {
328 0 : implAddPropertyDescription( _rProperties, _rPropertyName, ::getCppuType( static_cast< com::sun::star::util::Time* >( NULL ) ), _nAttribs );
329 0 : }
330 :
331 0 : inline void PropertyHandler::addDateTimePropertyDescription( ::std::vector< ::com::sun::star::beans::Property >& _rProperties, const OUString& _rPropertyName, sal_Int16 _nAttribs ) const
332 : {
333 0 : implAddPropertyDescription( _rProperties, _rPropertyName, ::getCppuType( static_cast< com::sun::star::util::DateTime* >( NULL ) ), _nAttribs );
334 0 : }
335 :
336 0 : inline OUString PropertyHandler::impl_getPropertyNameFromId_nothrow( PropertyId _nPropId ) const
337 : {
338 0 : const ::com::sun::star::beans::Property* pProp = impl_getPropertyFromId_nothrow( _nPropId );
339 0 : return pProp ? pProp->Name : OUString();
340 : }
341 :
342 :
343 : //= PropertyHandlerComponent
344 :
345 : typedef ::cppu::ImplHelper1 < ::com::sun::star::lang::XServiceInfo
346 : > PropertyHandlerComponent_Base;
347 : /** PropertyHandler implementation which additionally supports XServiceInfo
348 : */
349 0 : class PropertyHandlerComponent :public PropertyHandler
350 : ,public PropertyHandlerComponent_Base
351 : {
352 : protected:
353 : PropertyHandlerComponent(
354 : const ::com::sun::star::uno::Reference< ::com::sun::star::uno::XComponentContext >& _rxContext
355 : );
356 :
357 : DECLARE_XINTERFACE()
358 : DECLARE_XTYPEPROVIDER()
359 :
360 : // XServiceInfo
361 : virtual OUString SAL_CALL getImplementationName( ) throw (::com::sun::star::uno::RuntimeException, std::exception) SAL_OVERRIDE = 0;
362 : virtual sal_Bool SAL_CALL supportsService( const OUString& ServiceName ) throw (::com::sun::star::uno::RuntimeException, std::exception) SAL_OVERRIDE;
363 : virtual ::com::sun::star::uno::Sequence< OUString > SAL_CALL getSupportedServiceNames( ) throw (::com::sun::star::uno::RuntimeException, std::exception) SAL_OVERRIDE = 0;
364 : };
365 :
366 :
367 : //= HandlerComponentBase
368 :
369 : /** a PropertyHandlerComponent implementation which routes XServiceInfo::getImplementationName and
370 : XServiceInfo::getSupportedServiceNames to static versions of those methods, which are part of
371 : the derived class.
372 :
373 : Additionally, a method <member>Create</member> is provided which takes a component context, and returns a new
374 : instance of the derived class. This <member>Create</member> is used to register the implementation
375 : of the derived class at the <type>PcrModule</type>.
376 :
377 : Well, every time we're talking about derived class, we in fact mean the template argument of
378 : <type>HandlerComponentBase</type>. But usually this equals your derived class:
379 : <pre>
380 : class MyHandler;
381 : typedef HandlerComponentBase< MyHandler > MyHandler_Base;
382 : class MyHandler : MyHandler_Base
383 : {
384 : ...
385 : public:
386 : static OUString SAL_CALL getImplementationName_static( ) throw (::com::sun::star::uno::RuntimeException);
387 : static ::com::sun::star::uno::Sequence< OUString > SAL_CALL getSupportedServiceNames_static( ) throw (::com::sun::star::uno::RuntimeException);
388 : };
389 : </pre>
390 : */
391 : template < class HANDLER >
392 0 : class HandlerComponentBase : public PropertyHandlerComponent
393 : {
394 : protected:
395 0 : HandlerComponentBase( const ::com::sun::star::uno::Reference< ::com::sun::star::uno::XComponentContext >& _rxContext )
396 0 : :PropertyHandlerComponent( _rxContext )
397 : {
398 0 : }
399 :
400 : protected:
401 : // XServiceInfo
402 : virtual OUString SAL_CALL getImplementationName( ) throw (::com::sun::star::uno::RuntimeException, std::exception) SAL_OVERRIDE;
403 : virtual ::com::sun::star::uno::Sequence< OUString > SAL_CALL getSupportedServiceNames( ) throw (::com::sun::star::uno::RuntimeException, std::exception) SAL_OVERRIDE;
404 : static ::com::sun::star::uno::Reference< ::com::sun::star::uno::XInterface > SAL_CALL Create( const ::com::sun::star::uno::Reference< ::com::sun::star::uno::XComponentContext >& _rxContext );
405 :
406 : public:
407 : /** registers the implementation of HANDLER at the <type>PcrModule</type>
408 : */
409 : static void registerImplementation();
410 : };
411 :
412 :
413 : template < class HANDLER >
414 0 : OUString SAL_CALL HandlerComponentBase< HANDLER >::getImplementationName( ) throw (::com::sun::star::uno::RuntimeException, std::exception)
415 : {
416 0 : return HANDLER::getImplementationName_static();
417 : }
418 :
419 :
420 : template < class HANDLER >
421 0 : ::com::sun::star::uno::Sequence< OUString > SAL_CALL HandlerComponentBase< HANDLER >::getSupportedServiceNames( ) throw (::com::sun::star::uno::RuntimeException, std::exception)
422 : {
423 0 : return HANDLER::getSupportedServiceNames_static();
424 : }
425 :
426 :
427 : template < class HANDLER >
428 0 : void HandlerComponentBase< HANDLER >::registerImplementation()
429 : {
430 0 : PcrModule::getInstance().registerImplementation(
431 : HANDLER::getImplementationName_static(),
432 : HANDLER::getSupportedServiceNames_static(),
433 : HANDLER::Create
434 : );
435 0 : }
436 :
437 :
438 : template < class HANDLER >
439 0 : ::com::sun::star::uno::Reference< ::com::sun::star::uno::XInterface > SAL_CALL HandlerComponentBase< HANDLER >::Create( const ::com::sun::star::uno::Reference< ::com::sun::star::uno::XComponentContext >& _rxContext )
440 : {
441 0 : return *( new HANDLER( _rxContext ) );
442 : }
443 :
444 :
445 : } // namespace pcr
446 :
447 :
448 : #endif // EXTENSIONS_SOURCE_PROPCTRLR_PROPERTYHANDLER_HXX
449 :
450 : /* vim:set shiftwidth=4 softtabstop=4 expandtab: */
|