File: | home/maarten/src/libreoffice/core/include/rtl/ref.hxx |
Warning: | line 192, column 9 Use of memory after it is freed |
Press '?' to see keyboard shortcuts
Keyboard shortcuts:
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 | #include <standard/vclxaccessiblescrollbar.hxx> | |||
21 | ||||
22 | #include <toolkit/awt/vclxwindows.hxx> | |||
23 | #include <helper/accresmgr.hxx> | |||
24 | #include <strings.hrc> | |||
25 | ||||
26 | #include <unotools/accessiblestatesethelper.hxx> | |||
27 | #include <com/sun/star/accessibility/AccessibleStateType.hpp> | |||
28 | #include <com/sun/star/accessibility/AccessibleEventId.hpp> | |||
29 | #include <com/sun/star/awt/ScrollBarOrientation.hpp> | |||
30 | #include <com/sun/star/lang/IndexOutOfBoundsException.hpp> | |||
31 | #include <vcl/scrbar.hxx> | |||
32 | #include <vcl/vclevent.hxx> | |||
33 | #include <strings.hxx> | |||
34 | ||||
35 | using namespace ::com::sun::star; | |||
36 | using namespace ::com::sun::star::uno; | |||
37 | using namespace ::com::sun::star::awt; | |||
38 | using namespace ::com::sun::star::lang; | |||
39 | using namespace ::com::sun::star::beans; | |||
40 | using namespace ::com::sun::star::accessibility; | |||
41 | using namespace ::comphelper; | |||
42 | ||||
43 | ||||
44 | // VCLXAccessibleScrollBar | |||
45 | ||||
46 | ||||
47 | void VCLXAccessibleScrollBar::ProcessWindowEvent( const VclWindowEvent& rVclWindowEvent ) | |||
48 | { | |||
49 | switch ( rVclWindowEvent.GetId() ) | |||
50 | { | |||
51 | case VclEventId::ScrollbarScroll: | |||
52 | { | |||
53 | NotifyAccessibleEvent( AccessibleEventId::VALUE_CHANGED, Any(), Any() ); | |||
54 | } | |||
55 | break; | |||
56 | default: | |||
57 | VCLXAccessibleComponent::ProcessWindowEvent( rVclWindowEvent ); | |||
58 | } | |||
59 | } | |||
60 | ||||
61 | ||||
62 | void VCLXAccessibleScrollBar::FillAccessibleStateSet( utl::AccessibleStateSetHelper& rStateSet ) | |||
63 | { | |||
64 | VCLXAccessibleComponent::FillAccessibleStateSet( rStateSet ); | |||
65 | ||||
66 | VCLXScrollBar* pVCLXScrollBar = static_cast< VCLXScrollBar* >( GetVCLXWindow() ); | |||
67 | if ( pVCLXScrollBar ) | |||
68 | { | |||
69 | // IA2 CWS: scroll bar should not have FOCUSABLE state. | |||
70 | // rStateSet.AddState( AccessibleStateType::FOCUSABLE ); | |||
71 | if ( pVCLXScrollBar->getOrientation() == ScrollBarOrientation::HORIZONTAL ) | |||
72 | rStateSet.AddState( AccessibleStateType::HORIZONTAL ); | |||
73 | else if ( pVCLXScrollBar->getOrientation() == ScrollBarOrientation::VERTICAL ) | |||
74 | rStateSet.AddState( AccessibleStateType::VERTICAL ); | |||
75 | } | |||
76 | } | |||
77 | ||||
78 | ||||
79 | // XInterface | |||
80 | ||||
81 | ||||
82 | IMPLEMENT_FORWARD_XINTERFACE2( VCLXAccessibleScrollBar, VCLXAccessibleComponent, VCLXAccessibleScrollBar_BASE )void VCLXAccessibleScrollBar::acquire() throw() { VCLXAccessibleComponent ::acquire(); } void VCLXAccessibleScrollBar::release() throw( ) { VCLXAccessibleComponent::release(); } css::uno::Any VCLXAccessibleScrollBar ::queryInterface( const css::uno::Type& _rType ) { css::uno ::Any aReturn = VCLXAccessibleComponent::queryInterface( _rType ); if ( !aReturn.hasValue() ) aReturn = VCLXAccessibleScrollBar_BASE ::queryInterface( _rType ); return aReturn; } | |||
83 | ||||
84 | ||||
85 | // XTypeProvider | |||
86 | ||||
87 | ||||
88 | IMPLEMENT_FORWARD_XTYPEPROVIDER2( VCLXAccessibleScrollBar, VCLXAccessibleComponent, VCLXAccessibleScrollBar_BASE )css::uno::Sequence< css::uno::Type > VCLXAccessibleScrollBar ::getTypes( ) { return ::comphelper::concatSequences( VCLXAccessibleComponent ::getTypes(), VCLXAccessibleScrollBar_BASE::getTypes() ); } css ::uno::Sequence< sal_Int8 > VCLXAccessibleScrollBar::getImplementationId ( ) { return css::uno::Sequence<sal_Int8>(); } | |||
89 | ||||
90 | ||||
91 | // XServiceInfo | |||
92 | ||||
93 | ||||
94 | OUString VCLXAccessibleScrollBar::getImplementationName() | |||
95 | { | |||
96 | return "com.sun.star.comp.toolkit.AccessibleScrollBar"; | |||
97 | } | |||
98 | ||||
99 | ||||
100 | Sequence< OUString > VCLXAccessibleScrollBar::getSupportedServiceNames() | |||
101 | { | |||
102 | return { "com.sun.star.awt.AccessibleScrollBar" }; | |||
103 | } | |||
104 | ||||
105 | ||||
106 | // XAccessibleAction | |||
107 | ||||
108 | constexpr sal_Int32 ACCESSIBLE_ACTION_COUNT=4; | |||
109 | ||||
110 | sal_Int32 VCLXAccessibleScrollBar::getAccessibleActionCount( ) | |||
111 | { | |||
112 | OExternalLockGuard aGuard( this ); | |||
113 | ||||
114 | return ACCESSIBLE_ACTION_COUNT; | |||
115 | } | |||
116 | ||||
117 | ||||
118 | sal_Bool VCLXAccessibleScrollBar::doAccessibleAction ( sal_Int32 nIndex ) | |||
119 | { | |||
120 | OExternalLockGuard aGuard( this ); | |||
121 | ||||
122 | if ( nIndex < 0 || nIndex >= ACCESSIBLE_ACTION_COUNT ) | |||
| ||||
123 | throw IndexOutOfBoundsException(); | |||
124 | ||||
125 | bool bReturn = false; | |||
126 | VclPtr< ScrollBar > pScrollBar = GetAs< ScrollBar >(); | |||
127 | if ( pScrollBar ) | |||
128 | { | |||
129 | ScrollType eScrollType; | |||
130 | switch ( nIndex ) | |||
131 | { | |||
132 | case 0: eScrollType = ScrollType::LineUp; break; | |||
133 | case 1: eScrollType = ScrollType::LineDown; break; | |||
134 | case 2: eScrollType = ScrollType::PageUp; break; | |||
135 | case 3: eScrollType = ScrollType::PageDown; break; | |||
136 | default: eScrollType = ScrollType::DontKnow; break; | |||
137 | } | |||
138 | if ( pScrollBar->DoScrollAction( eScrollType ) ) | |||
139 | bReturn = true; | |||
140 | } | |||
141 | ||||
142 | return bReturn; | |||
143 | } | |||
144 | ||||
145 | ||||
146 | OUString VCLXAccessibleScrollBar::getAccessibleActionDescription ( sal_Int32 nIndex ) | |||
147 | { | |||
148 | OExternalLockGuard aGuard( this ); | |||
149 | ||||
150 | if ( nIndex < 0 || nIndex >= ACCESSIBLE_ACTION_COUNT ) | |||
151 | throw IndexOutOfBoundsException(); | |||
152 | ||||
153 | OUString sDescription; | |||
154 | ||||
155 | switch ( nIndex ) | |||
156 | { | |||
157 | case 0: sDescription = OUString(RID_STR_ACC_ACTION_DECLINE"decrementLine"); break; | |||
158 | case 1: sDescription = OUString(RID_STR_ACC_ACTION_INCLINE"incrementLine"); break; | |||
159 | case 2: sDescription = OUString(RID_STR_ACC_ACTION_DECBLOCK"decrementBlock"); break; | |||
160 | case 3: sDescription = OUString(RID_STR_ACC_ACTION_INCBLOCK"incrementBlock"); break; | |||
161 | default: break; | |||
162 | } | |||
163 | ||||
164 | return sDescription; | |||
165 | } | |||
166 | ||||
167 | ||||
168 | Reference< XAccessibleKeyBinding > VCLXAccessibleScrollBar::getAccessibleActionKeyBinding( sal_Int32 nIndex ) | |||
169 | { | |||
170 | OExternalLockGuard aGuard( this ); | |||
171 | ||||
172 | if ( nIndex < 0 || nIndex >= ACCESSIBLE_ACTION_COUNT ) | |||
173 | throw IndexOutOfBoundsException(); | |||
174 | ||||
175 | return Reference< XAccessibleKeyBinding >(); | |||
176 | } | |||
177 | ||||
178 | ||||
179 | // XAccessibleValue | |||
180 | ||||
181 | ||||
182 | Any VCLXAccessibleScrollBar::getCurrentValue( ) | |||
183 | { | |||
184 | OExternalLockGuard aGuard( this ); | |||
185 | ||||
186 | Any aValue; | |||
187 | ||||
188 | VCLXScrollBar* pVCLXScrollBar = static_cast< VCLXScrollBar* >( GetVCLXWindow() ); | |||
189 | if ( pVCLXScrollBar ) | |||
190 | aValue <<= pVCLXScrollBar->getValue(); | |||
191 | ||||
192 | return aValue; | |||
193 | } | |||
194 | ||||
195 | ||||
196 | sal_Bool VCLXAccessibleScrollBar::setCurrentValue( const Any& aNumber ) | |||
197 | { | |||
198 | OExternalLockGuard aGuard( this ); | |||
199 | ||||
200 | bool bReturn = false; | |||
201 | ||||
202 | VCLXScrollBar* pVCLXScrollBar = static_cast< VCLXScrollBar* >( GetVCLXWindow() ); | |||
203 | if ( pVCLXScrollBar ) | |||
204 | { | |||
205 | sal_Int32 nValue = 0, nValueMin = 0, nValueMax = 0; | |||
206 | OSL_VERIFY( aNumber >>= nValue )do { if (!(aNumber >>= nValue)) do { if (true && (!(0))) { sal_detail_logFormat((SAL_DETAIL_LOG_LEVEL_WARN), ( "legacy.osl"), ("/home/maarten/src/libreoffice/core/accessibility/source/standard/vclxaccessiblescrollbar.cxx" ":" "206" ": "), "OSL_ASSERT: %s", "0"); } } while (false); } while (0); | |||
207 | OSL_VERIFY( getMinimumValue() >>= nValueMin )do { if (!(getMinimumValue() >>= nValueMin)) do { if (true && (!(0))) { sal_detail_logFormat((SAL_DETAIL_LOG_LEVEL_WARN ), ("legacy.osl"), ("/home/maarten/src/libreoffice/core/accessibility/source/standard/vclxaccessiblescrollbar.cxx" ":" "207" ": "), "OSL_ASSERT: %s", "0"); } } while (false); } while (0); | |||
208 | OSL_VERIFY( getMaximumValue() >>= nValueMax )do { if (!(getMaximumValue() >>= nValueMax)) do { if (true && (!(0))) { sal_detail_logFormat((SAL_DETAIL_LOG_LEVEL_WARN ), ("legacy.osl"), ("/home/maarten/src/libreoffice/core/accessibility/source/standard/vclxaccessiblescrollbar.cxx" ":" "208" ": "), "OSL_ASSERT: %s", "0"); } } while (false); } while (0); | |||
209 | ||||
210 | if ( nValue < nValueMin ) | |||
211 | nValue = nValueMin; | |||
212 | else if ( nValue > nValueMax ) | |||
213 | nValue = nValueMax; | |||
214 | ||||
215 | pVCLXScrollBar->setValue( nValue ); | |||
216 | bReturn = true; | |||
217 | } | |||
218 | ||||
219 | return bReturn; | |||
220 | } | |||
221 | ||||
222 | ||||
223 | Any VCLXAccessibleScrollBar::getMaximumValue( ) | |||
224 | { | |||
225 | OExternalLockGuard aGuard( this ); | |||
226 | ||||
227 | Any aValue; | |||
228 | ||||
229 | VCLXScrollBar* pVCLXScrollBar = static_cast< VCLXScrollBar* >( GetVCLXWindow() ); | |||
230 | if ( pVCLXScrollBar ) | |||
231 | aValue <<= pVCLXScrollBar->getMaximum(); | |||
232 | ||||
233 | return aValue; | |||
234 | } | |||
235 | ||||
236 | ||||
237 | Any VCLXAccessibleScrollBar::getMinimumValue( ) | |||
238 | { | |||
239 | OExternalLockGuard aGuard( this ); | |||
240 | ||||
241 | Any aValue; | |||
242 | aValue <<= sal_Int32(0); | |||
243 | ||||
244 | return aValue; | |||
245 | } | |||
246 | ||||
247 | ||||
248 | OUString VCLXAccessibleScrollBar::getAccessibleName( ) | |||
249 | { | |||
250 | OExternalLockGuard aGuard( this ); | |||
251 | ||||
252 | OUString aName; | |||
253 | VCLXScrollBar* pVCLXScrollBar = static_cast< VCLXScrollBar* >( GetVCLXWindow() ); | |||
254 | if ( pVCLXScrollBar ) | |||
255 | { | |||
256 | if ( pVCLXScrollBar->getOrientation() == ScrollBarOrientation::HORIZONTAL ) | |||
257 | aName = AccResId( RID_STR_ACC_SCROLLBAR_NAME_HORIZONTALreinterpret_cast<char const *>("RID_STR_ACC_SCROLLBAR_NAME_HORIZONTAL" "\004" u8"Horizontal scroll bar") ); | |||
258 | else if ( pVCLXScrollBar->getOrientation() == ScrollBarOrientation::VERTICAL ) | |||
259 | aName = AccResId( RID_STR_ACC_SCROLLBAR_NAME_VERTICALreinterpret_cast<char const *>("RID_STR_ACC_SCROLLBAR_NAME_VERTICAL" "\004" u8"Vertical scroll bar") ); | |||
260 | } | |||
261 | return aName; | |||
262 | } | |||
263 | ||||
264 | ||||
265 | /* vim:set shiftwidth=4 softtabstop=4 expandtab: */ |
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 INCLUDED_TOOLKIT_AWT_VCLXACCESSIBLECOMPONENT_HXX |
21 | #define INCLUDED_TOOLKIT_AWT_VCLXACCESSIBLECOMPONENT_HXX |
22 | |
23 | #include <toolkit/dllapi.h> |
24 | #include <com/sun/star/lang/XServiceInfo.hpp> |
25 | #include <cppuhelper/implbase1.hxx> |
26 | #include <comphelper/accimplaccess.hxx> |
27 | #include <comphelper/accessiblecomponenthelper.hxx> |
28 | |
29 | |
30 | #include <tools/link.hxx> |
31 | #include <vcl/vclptr.hxx> |
32 | |
33 | namespace com::sun::star::accessibility { class XAccessible; } |
34 | |
35 | namespace vcl { class Window; } |
36 | class VCLXWindow; |
37 | class VclWindowEvent; |
38 | |
39 | namespace utl { |
40 | class AccessibleRelationSetHelper; |
41 | class AccessibleStateSetHelper; |
42 | } |
43 | |
44 | |
45 | |
46 | typedef ::cppu::ImplHelper1< |
47 | css::lang::XServiceInfo > VCLXAccessibleComponent_BASE; |
48 | |
49 | class TOOLKIT_DLLPUBLIC__attribute__ ((visibility("default"))) VCLXAccessibleComponent |
50 | :public comphelper::OAccessibleExtendedComponentHelper |
51 | ,public ::comphelper::OAccessibleImplementationAccess |
52 | ,public VCLXAccessibleComponent_BASE |
53 | { |
54 | private: |
55 | rtl::Reference<VCLXWindow> m_xVCLXWindow; |
56 | VclPtr<vcl::Window> m_xEventSource; |
57 | |
58 | DECL_LINK( WindowEventListener, VclWindowEvent&, void )static void LinkStubWindowEventListener(void *, VclWindowEvent &); void WindowEventListener(VclWindowEvent&); |
59 | DECL_LINK( WindowChildEventListener, VclWindowEvent&, void )static void LinkStubWindowChildEventListener(void *, VclWindowEvent &); void WindowChildEventListener(VclWindowEvent&); |
60 | void DisconnectEvents(); |
61 | |
62 | protected: |
63 | virtual void ProcessWindowEvent( const VclWindowEvent& rVclWindowEvent ); |
64 | virtual void ProcessWindowChildEvent( const VclWindowEvent& rVclWindowEvent ); |
65 | virtual void FillAccessibleRelationSet( utl::AccessibleRelationSetHelper& rRelationSet ); |
66 | virtual void FillAccessibleStateSet( utl::AccessibleStateSetHelper& rStateSet ); |
67 | |
68 | virtual css::uno::Reference< css::accessibility::XAccessible > GetChildAccessible( const VclWindowEvent& rVclWindowEvent ); |
69 | |
70 | public: |
71 | VCLXAccessibleComponent( VCLXWindow* pVCLXWindow ); |
72 | virtual ~VCLXAccessibleComponent() override; |
73 | |
74 | VCLXWindow* GetVCLXWindow() const; |
75 | VclPtr<vcl::Window> GetWindow() const; |
76 | template< class derived_type > VclPtr< derived_type > GetAs() const { |
77 | return VclPtr< derived_type >( static_cast< derived_type * >( GetWindow().get() ) ); } |
78 | template< class derived_type > VclPtr< derived_type > GetAsDynamic() const { |
79 | return VclPtr< derived_type >( dynamic_cast< derived_type * >( GetWindow().get() ) ); } |
80 | |
81 | virtual void SAL_CALL disposing() override; |
82 | |
83 | // css::uno::XInterface |
84 | DECLARE_XINTERFACE()virtual css::uno::Any queryInterface( const css::uno::Type& aType ) override; virtual void acquire() throw() override; virtual void release() throw() override; |
85 | // css::lang::XTypeProvider |
86 | DECLARE_XTYPEPROVIDER()virtual css::uno::Sequence< css::uno::Type > getTypes( ) override; virtual css::uno::Sequence< sal_Int8 > getImplementationId ( ) override; |
87 | |
88 | // XServiceInfo |
89 | virtual OUString SAL_CALL getImplementationName() override; |
90 | virtual sal_Bool SAL_CALL supportsService( const OUString& rServiceName ) override; |
91 | virtual css::uno::Sequence< OUString > SAL_CALL getSupportedServiceNames() override; |
92 | |
93 | // css::accessibility::XAccessibleContext |
94 | sal_Int32 SAL_CALL getAccessibleChildCount( ) override; |
95 | css::uno::Reference< css::accessibility::XAccessible > SAL_CALL getAccessibleChild( sal_Int32 i ) override; |
96 | css::uno::Reference< css::accessibility::XAccessible > SAL_CALL getAccessibleParent( ) override; |
97 | sal_Int32 SAL_CALL getAccessibleIndexInParent( ) override; |
98 | sal_Int16 SAL_CALL getAccessibleRole( ) override; |
99 | OUString SAL_CALL getAccessibleDescription( ) override; |
100 | OUString SAL_CALL getAccessibleName( ) override; |
101 | OUString SAL_CALL getAccessibleId( ) override; |
102 | css::uno::Reference< css::accessibility::XAccessibleRelationSet > SAL_CALL getAccessibleRelationSet( ) override; |
103 | css::uno::Reference< css::accessibility::XAccessibleStateSet > SAL_CALL getAccessibleStateSet( ) override; |
104 | css::lang::Locale SAL_CALL getLocale( ) override; |
105 | |
106 | // css::accessibility::XAccessibleComponent |
107 | css::uno::Reference< css::accessibility::XAccessible > SAL_CALL getAccessibleAtPoint( const css::awt::Point& aPoint ) override; |
108 | css::awt::Point SAL_CALL getLocationOnScreen( ) override; |
109 | void SAL_CALL grabFocus( ) override; |
110 | virtual sal_Int32 SAL_CALL getForeground( ) override; |
111 | virtual sal_Int32 SAL_CALL getBackground( ) override; |
112 | |
113 | // css::accessibility::XAccessibleExtendedComponent |
114 | virtual css::uno::Reference< css::awt::XFont > SAL_CALL getFont( ) override; |
115 | virtual OUString SAL_CALL getTitledBorderText( ) override; |
116 | virtual OUString SAL_CALL getToolTipText( ) override; |
117 | |
118 | protected: |
119 | // base class overridables |
120 | css::awt::Rectangle implGetBounds( ) override; |
121 | |
122 | private: |
123 | /** we may be reparented (if external components use OAccessibleImplementationAccess base class), |
124 | so this method here returns the parent in the VCL world, in opposite to the parent |
125 | an external component gave us |
126 | @precond |
127 | the caller must ensure thread safety, i.e. our mutex must be locked |
128 | */ |
129 | css::uno::Reference< css::accessibility::XAccessible > |
130 | getVclParent() const; |
131 | }; |
132 | |
133 | /* ---------------------------------------------------------- |
134 | Accessibility only for the Window hierarchy! |
135 | Maybe derived classes must overwrite these Accessibility interfaces: |
136 | |
137 | // XAccessibleContext: |
138 | sal_Int16 getAccessibleRole() => VCL Window::GetAccessibleRole() |
139 | OUString getAccessibleDescription() => VCL Window::GetAccessibleDescription |
140 | OUString getAccessibleName() => VCL Window::GetAccessibleText() => Most windows return Window::GetText() |
141 | OUString getAccessibleId() => VCL Window::get_id() |
142 | Reference< XAccessibleRelationSet > getAccessibleRelationSet() |
143 | Reference< XAccessibleStateSet > getAccessibleStateSet() => override FillAccessibleStateSet( ... ) |
144 | |
145 | ---------------------------------------------------------- */ |
146 | |
147 | |
148 | #endif // INCLUDED_TOOLKIT_AWT_VCLXACCESSIBLECOMPONENT_HXX |
149 | |
150 | /* vim:set shiftwidth=4 softtabstop=4 expandtab: */ |
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 INCLUDED_VCL_PTR_HXX |
21 | #define INCLUDED_VCL_PTR_HXX |
22 | |
23 | #include <sal/config.h> |
24 | |
25 | #include <rtl/ref.hxx> |
26 | |
27 | #include <utility> |
28 | #include <type_traits> |
29 | |
30 | #ifdef DBG_UTIL |
31 | #ifndef _WIN32 |
32 | #include <vcl/vclmain.hxx> |
33 | #endif |
34 | #endif |
35 | |
36 | class VclReferenceBase; |
37 | |
38 | namespace vcl::detail { |
39 | |
40 | template<typename> |
41 | constexpr bool isIncompleteOrDerivedFromVclReferenceBase(...) { return true; } |
42 | |
43 | template<typename T> constexpr bool isIncompleteOrDerivedFromVclReferenceBase( |
44 | int (*)[sizeof(T)]) |
45 | { return std::is_base_of<VclReferenceBase, T>::value; } |
46 | |
47 | } // namespace vcl::detail |
48 | |
49 | /** |
50 | * A thin wrapper around rtl::Reference to implement the acquire and dispose semantics we want for references to vcl::Window subclasses. |
51 | * |
52 | * For more details on the design please see vcl/README.lifecycle |
53 | * |
54 | * @param reference_type must be a subclass of vcl::Window |
55 | */ |
56 | template <class reference_type> |
57 | class VclPtr |
58 | { |
59 | static_assert( |
60 | vcl::detail::isIncompleteOrDerivedFromVclReferenceBase<reference_type>( |
61 | nullptr), |
62 | "template argument type must be derived from VclReferenceBase"); |
63 | |
64 | ::rtl::Reference<reference_type> m_rInnerRef; |
65 | |
66 | public: |
67 | /** Constructor... |
68 | */ |
69 | VclPtr() |
70 | : m_rInnerRef() |
71 | {} |
72 | |
73 | /** Constructor... |
74 | */ |
75 | VclPtr (reference_type * pBody) |
76 | : m_rInnerRef(pBody) |
77 | {} |
78 | |
79 | /** Constructor... that doesn't take a ref. |
80 | */ |
81 | VclPtr (reference_type * pBody, __sal_NoAcquire) |
82 | : m_rInnerRef(pBody, SAL_NO_ACQUIRE) |
83 | {} |
84 | |
85 | /** Up-casting conversion constructor: Copies interface reference. |
86 | |
87 | Does not work for up-casts to ambiguous bases. For the special case of |
88 | up-casting to Reference< XInterface >, see the corresponding conversion |
89 | operator. |
90 | |
91 | @param rRef another reference |
92 | */ |
93 | template< class derived_type > |
94 | VclPtr( |
95 | const VclPtr< derived_type > & rRef, |
96 | typename std::enable_if< |
97 | std::is_base_of<reference_type, derived_type>::value, int>::type |
98 | = 0 ) |
99 | : m_rInnerRef( static_cast<reference_type*>(rRef) ) |
100 | { |
101 | } |
102 | |
103 | #if defined(DBG_UTIL) && !defined(_WIN32) |
104 | virtual ~VclPtr() |
105 | { |
106 | assert(m_rInnerRef.get() == nullptr || vclmain::isAlive())(static_cast <bool> (m_rInnerRef.get() == nullptr || vclmain ::isAlive()) ? void (0) : __assert_fail ("m_rInnerRef.get() == nullptr || vclmain::isAlive()" , "/home/maarten/src/libreoffice/core/include/vcl/vclptr.hxx" , 106, __extension__ __PRETTY_FUNCTION__)); |
107 | // We can be one of the intermediate counts, but if we are the last |
108 | // VclPtr keeping this object alive, then something forgot to call dispose(). |
109 | assert((!m_rInnerRef.get() || m_rInnerRef->isDisposed() || m_rInnerRef->getRefCount() > 1)(static_cast <bool> ((!m_rInnerRef.get() || m_rInnerRef ->isDisposed() || m_rInnerRef->getRefCount() > 1) && "someone forgot to call dispose()") ? void (0) : __assert_fail ("(!m_rInnerRef.get() || m_rInnerRef->isDisposed() || m_rInnerRef->getRefCount() > 1) && \"someone forgot to call dispose()\"" , "/home/maarten/src/libreoffice/core/include/vcl/vclptr.hxx" , 110, __extension__ __PRETTY_FUNCTION__)) |
110 | && "someone forgot to call dispose()")(static_cast <bool> ((!m_rInnerRef.get() || m_rInnerRef ->isDisposed() || m_rInnerRef->getRefCount() > 1) && "someone forgot to call dispose()") ? void (0) : __assert_fail ("(!m_rInnerRef.get() || m_rInnerRef->isDisposed() || m_rInnerRef->getRefCount() > 1) && \"someone forgot to call dispose()\"" , "/home/maarten/src/libreoffice/core/include/vcl/vclptr.hxx" , 110, __extension__ __PRETTY_FUNCTION__)); |
111 | } |
112 | VclPtr(VclPtr const &) = default; |
113 | VclPtr(VclPtr &&) = default; |
114 | VclPtr & operator =(VclPtr const &) = default; |
115 | VclPtr & operator =(VclPtr &&) = default; |
116 | #endif |
117 | |
118 | /** |
119 | * A construction helper for VclPtr. Since VclPtr types are created |
120 | * with a reference-count of one - to help fit into the existing |
121 | * code-flow; this helps us to construct them easily. |
122 | * |
123 | * For more details on the design please see vcl/README.lifecycle |
124 | * |
125 | * @tparam reference_type must be a subclass of vcl::Window |
126 | */ |
127 | template<typename... Arg> [[nodiscard]] static VclPtr< reference_type > Create(Arg &&... arg) |
128 | { |
129 | return VclPtr< reference_type >( new reference_type(std::forward<Arg>(arg)...), SAL_NO_ACQUIRE ); |
130 | } |
131 | |
132 | /** Probably most common used: handle->someBodyOp(). |
133 | */ |
134 | reference_type * operator->() const |
135 | { |
136 | return m_rInnerRef.get(); |
137 | } |
138 | |
139 | /** Get the body. Can be used instead of operator->(). |
140 | I.e. handle->someBodyOp() and handle.get()->someBodyOp() |
141 | are the same. |
142 | */ |
143 | reference_type * get() const |
144 | { |
145 | return m_rInnerRef.get(); |
146 | } |
147 | |
148 | void set(reference_type *pBody) |
149 | { |
150 | m_rInnerRef.set(pBody); |
151 | } |
152 | |
153 | void reset(reference_type *pBody) |
154 | { |
155 | m_rInnerRef.set(pBody); |
156 | } |
157 | |
158 | /** Up-casting copy assignment operator. |
159 | |
160 | Does not work for up-casts to ambiguous bases. |
161 | |
162 | @param rRef another reference |
163 | */ |
164 | template<typename derived_type> |
165 | typename std::enable_if< |
166 | std::is_base_of<reference_type, derived_type>::value, |
167 | VclPtr &>::type |
168 | operator =(VclPtr<derived_type> const & rRef) |
169 | { |
170 | m_rInnerRef.set(rRef.get()); |
171 | return *this; |
172 | } |
173 | |
174 | VclPtr & operator =(reference_type * pBody) |
175 | { |
176 | m_rInnerRef.set(pBody); |
177 | return *this; |
178 | } |
179 | |
180 | operator reference_type * () const |
181 | { |
182 | return m_rInnerRef.get(); |
183 | } |
184 | |
185 | explicit operator bool () const |
186 | { |
187 | return m_rInnerRef.get() != nullptr; |
188 | } |
189 | |
190 | void clear() |
191 | { |
192 | m_rInnerRef.clear(); |
193 | } |
194 | |
195 | void reset() |
196 | { |
197 | m_rInnerRef.clear(); |
198 | } |
199 | |
200 | void disposeAndClear() |
201 | { |
202 | // hold it alive for the lifetime of this method |
203 | ::rtl::Reference<reference_type> aTmp(m_rInnerRef); |
204 | m_rInnerRef.clear(); // we should use some 'swap' method ideally ;-) |
205 | if (aTmp.get()) { |
206 | aTmp->disposeOnce(); |
207 | } |
208 | } |
209 | |
210 | /** Needed to place VclPtr's into STL collection. |
211 | */ |
212 | bool operator< (const VclPtr<reference_type> & handle) const |
213 | { |
214 | return (m_rInnerRef < handle.m_rInnerRef); |
215 | } |
216 | }; // class VclPtr |
217 | |
218 | template<typename T1, typename T2> |
219 | inline bool operator ==(VclPtr<T1> const & p1, VclPtr<T2> const & p2) { |
220 | return p1.get() == p2.get(); |
221 | } |
222 | |
223 | template<typename T> inline bool operator ==(VclPtr<T> const & p1, T const * p2) |
224 | { |
225 | return p1.get() == p2; |
226 | } |
227 | |
228 | template<typename T> inline bool operator ==(VclPtr<T> const & p1, T * p2) { |
229 | return p1.get() == p2; |
230 | } |
231 | |
232 | template<typename T> inline bool operator ==(T const * p1, VclPtr<T> const & p2) |
233 | { |
234 | return p1 == p2.get(); |
235 | } |
236 | |
237 | template<typename T> inline bool operator ==(T * p1, VclPtr<T> const & p2) { |
238 | return p1 == p2.get(); |
239 | } |
240 | |
241 | template<typename T1, typename T2> |
242 | inline bool operator !=(VclPtr<T1> const & p1, VclPtr<T2> const & p2) { |
243 | return !(p1 == p2); |
244 | } |
245 | |
246 | template<typename T> inline bool operator !=(VclPtr<T> const & p1, T const * p2) |
247 | { |
248 | return !(p1 == p2); |
249 | } |
250 | |
251 | template<typename T> inline bool operator !=(VclPtr<T> const & p1, T * p2) { |
252 | return !(p1 == p2); |
253 | } |
254 | |
255 | template<typename T> inline bool operator !=(T const * p1, VclPtr<T> const & p2) |
256 | { |
257 | return !(p1 == p2); |
258 | } |
259 | |
260 | template<typename T> inline bool operator !=(T * p1, VclPtr<T> const & p2) { |
261 | return !(p1 == p2); |
262 | } |
263 | |
264 | /** |
265 | * A construction helper for a temporary VclPtr. Since VclPtr types |
266 | * are created with a reference-count of one - to help fit into |
267 | * the existing code-flow; this helps us to construct them easily. |
268 | * see also VclPtr::Create and ScopedVclPtr |
269 | * |
270 | * For more details on the design please see vcl/README.lifecycle |
271 | * |
272 | * @param reference_type must be a subclass of vcl::Window |
273 | */ |
274 | template <class reference_type> |
275 | class SAL_WARN_UNUSED__attribute__((warn_unused)) VclPtrInstance final : public VclPtr<reference_type> |
276 | { |
277 | public: |
278 | template<typename... Arg> VclPtrInstance(Arg &&... arg) |
279 | : VclPtr<reference_type>( new reference_type(std::forward<Arg>(arg)...), SAL_NO_ACQUIRE ) |
280 | { |
281 | } |
282 | |
283 | /** |
284 | * Override and disallow this, to prevent people accidentally calling it and actually |
285 | * getting VclPtr::Create and getting a naked VclPtr<> instance |
286 | */ |
287 | template<typename... Arg> static VclPtrInstance< reference_type > Create(Arg &&... ) = delete; |
288 | }; |
289 | |
290 | template <class reference_type> |
291 | class ScopedVclPtr : public VclPtr<reference_type> |
292 | { |
293 | public: |
294 | /** Constructor... |
295 | */ |
296 | ScopedVclPtr() |
297 | : VclPtr<reference_type>() |
298 | {} |
299 | |
300 | /** Constructor |
301 | */ |
302 | ScopedVclPtr (reference_type * pBody) |
303 | : VclPtr<reference_type>(pBody) |
304 | {} |
305 | |
306 | /** Copy constructor... |
307 | */ |
308 | ScopedVclPtr (const VclPtr<reference_type> & handle) |
309 | : VclPtr<reference_type>(handle) |
310 | {} |
311 | |
312 | /** |
313 | Assignment that releases the last reference. |
314 | */ |
315 | void disposeAndReset(reference_type *pBody) |
316 | { |
317 | if (pBody != this->get()) { |
318 | VclPtr<reference_type>::disposeAndClear(); |
319 | VclPtr<reference_type>::set(pBody); |
320 | } |
321 | } |
322 | |
323 | /** |
324 | Assignment that releases the last reference. |
325 | */ |
326 | ScopedVclPtr<reference_type>& operator = (reference_type * pBody) |
327 | { |
328 | disposeAndReset(pBody); |
329 | return *this; |
330 | } |
331 | |
332 | /** Up-casting conversion constructor: Copies interface reference. |
333 | |
334 | Does not work for up-casts to ambiguous bases. For the special case of |
335 | up-casting to Reference< XInterface >, see the corresponding conversion |
336 | operator. |
337 | |
338 | @param rRef another reference |
339 | */ |
340 | template< class derived_type > |
341 | ScopedVclPtr( |
342 | const VclPtr< derived_type > & rRef, |
343 | typename std::enable_if< |
344 | std::is_base_of<reference_type, derived_type>::value, int>::type |
345 | = 0 ) |
346 | : VclPtr<reference_type>( rRef ) |
347 | { |
348 | } |
349 | |
350 | /** Up-casting assignment operator. |
351 | |
352 | Does not work for up-casts to ambiguous bases. |
353 | |
354 | @param rRef another VclPtr |
355 | */ |
356 | template<typename derived_type> |
357 | typename std::enable_if< |
358 | std::is_base_of<reference_type, derived_type>::value, |
359 | ScopedVclPtr &>::type |
360 | operator =(VclPtr<derived_type> const & rRef) |
361 | { |
362 | disposeAndReset(rRef.get()); |
363 | return *this; |
364 | } |
365 | |
366 | /** |
367 | * Override and disallow this, to prevent people accidentally calling it and actually |
368 | * getting VclPtr::Create and getting a naked VclPtr<> instance |
369 | */ |
370 | template<typename... Arg> static ScopedVclPtr< reference_type > Create(Arg &&... ) = delete; |
371 | |
372 | ~ScopedVclPtr() |
373 | { |
374 | VclPtr<reference_type>::disposeAndClear(); |
375 | assert(VclPtr<reference_type>::get() == nullptr)(static_cast <bool> (VclPtr<reference_type>::get( ) == nullptr) ? void (0) : __assert_fail ("VclPtr<reference_type>::get() == nullptr" , "/home/maarten/src/libreoffice/core/include/vcl/vclptr.hxx" , 375, __extension__ __PRETTY_FUNCTION__)); // make sure there are no lingering references |
376 | } |
377 | |
378 | private: |
379 | // Most likely we don't want this default copy-constructor. |
380 | ScopedVclPtr (const ScopedVclPtr<reference_type> &) = delete; |
381 | // And certainly we don't want a default assignment operator. |
382 | ScopedVclPtr<reference_type>& operator = (const ScopedVclPtr<reference_type> &) = delete; |
383 | // And disallow reset as that doesn't call disposeAndClear on the original reference |
384 | void reset() = delete; |
385 | void reset(reference_type *pBody) = delete; |
386 | |
387 | protected: |
388 | ScopedVclPtr (reference_type * pBody, __sal_NoAcquire) |
389 | : VclPtr<reference_type>(pBody, SAL_NO_ACQUIRE) |
390 | {} |
391 | }; |
392 | |
393 | /** |
394 | * A construction helper for ScopedVclPtr. Since VclPtr types are created |
395 | * with a reference-count of one - to help fit into the existing |
396 | * code-flow; this helps us to construct them easily. |
397 | * |
398 | * For more details on the design please see vcl/README.lifecycle |
399 | * |
400 | * @param reference_type must be a subclass of vcl::Window |
401 | */ |
402 | #if defined _MSC_VER |
403 | #pragma warning(push) |
404 | #pragma warning(disable: 4521) // " multiple copy constructors specified" |
405 | #endif |
406 | template <class reference_type> |
407 | class SAL_WARN_UNUSED__attribute__((warn_unused)) ScopedVclPtrInstance final : public ScopedVclPtr<reference_type> |
408 | { |
409 | public: |
410 | template<typename... Arg> ScopedVclPtrInstance(Arg &&... arg) |
411 | : ScopedVclPtr<reference_type>( new reference_type(std::forward<Arg>(arg)...), SAL_NO_ACQUIRE ) |
412 | { |
413 | } |
414 | |
415 | /** |
416 | * Override and disallow this, to prevent people accidentally calling it and actually |
417 | * getting VclPtr::Create and getting a naked VclPtr<> instance |
418 | */ |
419 | template<typename... Arg> static ScopedVclPtrInstance< reference_type > Create(Arg &&...) = delete; |
420 | |
421 | private: |
422 | // Prevent the above perfect forwarding ctor from hijacking (accidental) |
423 | // attempts at ScopedVclPtrInstance copy construction (where the hijacking |
424 | // would typically lead to somewhat obscure error messages); both non-const |
425 | // and const variants are needed here, as the ScopedVclPtr base class has a |
426 | // const--variant copy ctor, so the implicitly declared copy ctor for |
427 | // ScopedVclPtrInstance would also be the const variant, so non-const copy |
428 | // construction attempts would be hijacked by the perfect forwarding ctor; |
429 | // but if we only declared a non-const variant here, the const variant would |
430 | // no longer be implicitly declared (as there would already be an explicitly |
431 | // declared copy ctor), so const copy construction attempts would then be |
432 | // hijacked by the perfect forwarding ctor: |
433 | ScopedVclPtrInstance(ScopedVclPtrInstance &) = delete; |
434 | ScopedVclPtrInstance(ScopedVclPtrInstance const &) = delete; |
435 | }; |
436 | #if defined _MSC_VER |
437 | #pragma warning(pop) |
438 | #endif |
439 | |
440 | #endif // INCLUDED_VCL_PTR_HXX |
441 | |
442 | /* vim:set shiftwidth=4 softtabstop=4 expandtab: */ |
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 INCLUDED_RTL_REF_HXX | ||||||||||
21 | #define INCLUDED_RTL_REF_HXX | ||||||||||
22 | |||||||||||
23 | #include "sal/config.h" | ||||||||||
24 | |||||||||||
25 | #include <cassert> | ||||||||||
26 | #include <cstddef> | ||||||||||
27 | #include <functional> | ||||||||||
28 | #ifdef LIBO_INTERNAL_ONLY1 | ||||||||||
29 | #include <type_traits> | ||||||||||
30 | #endif | ||||||||||
31 | |||||||||||
32 | #include "sal/types.h" | ||||||||||
33 | |||||||||||
34 | namespace rtl | ||||||||||
35 | { | ||||||||||
36 | |||||||||||
37 | /** Template reference class for reference type. | ||||||||||
38 | */ | ||||||||||
39 | template <class reference_type> | ||||||||||
40 | class Reference | ||||||||||
41 | { | ||||||||||
42 | /** The <b>reference_type</b> body pointer. | ||||||||||
43 | */ | ||||||||||
44 | reference_type * m_pBody; | ||||||||||
45 | |||||||||||
46 | |||||||||||
47 | public: | ||||||||||
48 | /** Constructor... | ||||||||||
49 | */ | ||||||||||
50 | Reference() | ||||||||||
51 | : m_pBody (NULL__null) | ||||||||||
52 | {} | ||||||||||
53 | |||||||||||
54 | |||||||||||
55 | /** Constructor... | ||||||||||
56 | */ | ||||||||||
57 | Reference (reference_type * pBody, __sal_NoAcquire) | ||||||||||
58 | : m_pBody (pBody) | ||||||||||
59 | { | ||||||||||
60 | } | ||||||||||
61 | |||||||||||
62 | /** Constructor... | ||||||||||
63 | */ | ||||||||||
64 | Reference (reference_type * pBody) | ||||||||||
65 | : m_pBody (pBody) | ||||||||||
66 | { | ||||||||||
67 | if (m_pBody) | ||||||||||
68 | m_pBody->acquire(); | ||||||||||
69 | } | ||||||||||
70 | |||||||||||
71 | /** Copy constructor... | ||||||||||
72 | */ | ||||||||||
73 | Reference (const Reference<reference_type> & handle) | ||||||||||
74 | : m_pBody (handle.m_pBody) | ||||||||||
75 | { | ||||||||||
76 | if (m_pBody) | ||||||||||
77 | m_pBody->acquire(); | ||||||||||
78 | } | ||||||||||
79 | |||||||||||
80 | #ifdef LIBO_INTERNAL_ONLY1 | ||||||||||
81 | /** Move constructor... | ||||||||||
82 | */ | ||||||||||
83 | Reference (Reference<reference_type> && handle) noexcept | ||||||||||
84 | : m_pBody (handle.m_pBody) | ||||||||||
85 | { | ||||||||||
86 | handle.m_pBody = nullptr; | ||||||||||
87 | } | ||||||||||
88 | #endif | ||||||||||
89 | |||||||||||
90 | #if defined LIBO_INTERNAL_ONLY1 | ||||||||||
91 | /** Up-casting conversion constructor: Copies interface reference. | ||||||||||
92 | |||||||||||
93 | Does not work for up-casts to ambiguous bases. | ||||||||||
94 | |||||||||||
95 | @param rRef another reference | ||||||||||
96 | */ | ||||||||||
97 | template< class derived_type > | ||||||||||
98 | inline Reference( | ||||||||||
99 | const Reference< derived_type > & rRef, | ||||||||||
100 | std::enable_if_t<std::is_base_of_v<reference_type, derived_type>, int> = 0 ) | ||||||||||
101 | : m_pBody (rRef.get()) | ||||||||||
102 | { | ||||||||||
103 | if (m_pBody) | ||||||||||
104 | m_pBody->acquire(); | ||||||||||
105 | } | ||||||||||
106 | #endif | ||||||||||
107 | |||||||||||
108 | /** Destructor... | ||||||||||
109 | */ | ||||||||||
110 | ~Reference() COVERITY_NOEXCEPT_FALSE | ||||||||||
111 | { | ||||||||||
112 | if (m_pBody
| ||||||||||
113 | m_pBody->release(); | ||||||||||
114 | } | ||||||||||
115 | |||||||||||
116 | /** Set... | ||||||||||
117 | Similar to assignment. | ||||||||||
118 | */ | ||||||||||
119 | Reference<reference_type> & | ||||||||||
120 | SAL_CALL set (reference_type * pBody) | ||||||||||
121 | { | ||||||||||
122 | if (pBody) | ||||||||||
123 | pBody->acquire(); | ||||||||||
124 | reference_type * const pOld = m_pBody; | ||||||||||
125 | m_pBody = pBody; | ||||||||||
126 | if (pOld) | ||||||||||
127 | pOld->release(); | ||||||||||
128 | return *this; | ||||||||||
129 | } | ||||||||||
130 | |||||||||||
131 | /** Assignment. | ||||||||||
132 | Unbinds this instance from its body (if bound) and | ||||||||||
133 | bind it to the body represented by the handle. | ||||||||||
134 | */ | ||||||||||
135 | Reference<reference_type> & | ||||||||||
136 | SAL_CALL operator= (const Reference<reference_type> & handle) | ||||||||||
137 | { | ||||||||||
138 | return set( handle.m_pBody ); | ||||||||||
139 | } | ||||||||||
140 | |||||||||||
141 | #ifdef LIBO_INTERNAL_ONLY1 | ||||||||||
142 | /** Assignment. | ||||||||||
143 | * Unbinds this instance from its body (if bound), | ||||||||||
144 | * bind it to the body represented by the handle, and | ||||||||||
145 | * set the body represented by the handle to nullptr. | ||||||||||
146 | */ | ||||||||||
147 | Reference<reference_type> & | ||||||||||
148 | operator= (Reference<reference_type> && handle) | ||||||||||
149 | { | ||||||||||
150 | // self-movement guts ourself | ||||||||||
151 | if (m_pBody) | ||||||||||
152 | m_pBody->release(); | ||||||||||
153 | m_pBody = handle.m_pBody; | ||||||||||
154 | handle.m_pBody = nullptr; | ||||||||||
155 | return *this; | ||||||||||
156 | } | ||||||||||
157 | #endif | ||||||||||
158 | |||||||||||
159 | /** Assignment... | ||||||||||
160 | */ | ||||||||||
161 | Reference<reference_type> & | ||||||||||
162 | SAL_CALL operator= (reference_type * pBody) | ||||||||||
163 | { | ||||||||||
164 | return set( pBody ); | ||||||||||
165 | } | ||||||||||
166 | |||||||||||
167 | /** Unbind the body from this handle. | ||||||||||
168 | Note that for a handle representing a large body, | ||||||||||
169 | "handle.clear().set(new body());" _might_ | ||||||||||
170 | perform a little bit better than "handle.set(new body());", | ||||||||||
171 | since in the second case two large objects exist in memory | ||||||||||
172 | (the old body and the new body). | ||||||||||
173 | */ | ||||||||||
174 | Reference<reference_type> & SAL_CALL clear() | ||||||||||
175 | { | ||||||||||
176 | if (m_pBody) | ||||||||||
177 | { | ||||||||||
178 | reference_type * const pOld = m_pBody; | ||||||||||
179 | m_pBody = NULL__null; | ||||||||||
180 | pOld->release(); | ||||||||||
181 | } | ||||||||||
182 | return *this; | ||||||||||
183 | } | ||||||||||
184 | |||||||||||
185 | |||||||||||
186 | /** Get the body. Can be used instead of operator->(). | ||||||||||
187 | I.e. handle->someBodyOp() and handle.get()->someBodyOp() | ||||||||||
188 | are the same. | ||||||||||
189 | */ | ||||||||||
190 | reference_type * SAL_CALL get() const | ||||||||||
191 | { | ||||||||||
192 | return m_pBody; | ||||||||||
| |||||||||||
193 | } | ||||||||||
194 | |||||||||||
195 | |||||||||||
196 | /** Probably most common used: handle->someBodyOp(). | ||||||||||
197 | */ | ||||||||||
198 | reference_type * SAL_CALL operator->() const | ||||||||||
199 | { | ||||||||||
200 | assert(m_pBody != NULL)(static_cast <bool> (m_pBody != __null) ? void (0) : __assert_fail ("m_pBody != NULL", "/home/maarten/src/libreoffice/core/include/rtl/ref.hxx" , 200, __extension__ __PRETTY_FUNCTION__)); | ||||||||||
201 | return m_pBody; | ||||||||||
202 | } | ||||||||||
203 | |||||||||||
204 | |||||||||||
205 | /** Allows (*handle).someBodyOp(). | ||||||||||
206 | */ | ||||||||||
207 | reference_type & SAL_CALL operator*() const | ||||||||||
208 | { | ||||||||||
209 | assert(m_pBody != NULL)(static_cast <bool> (m_pBody != __null) ? void (0) : __assert_fail ("m_pBody != NULL", "/home/maarten/src/libreoffice/core/include/rtl/ref.hxx" , 209, __extension__ __PRETTY_FUNCTION__)); | ||||||||||
210 | return *m_pBody; | ||||||||||
211 | } | ||||||||||
212 | |||||||||||
213 | |||||||||||
214 | /** Returns True if the handle does point to a valid body. | ||||||||||
215 | */ | ||||||||||
216 | bool SAL_CALL is() const | ||||||||||
217 | { | ||||||||||
218 | return (m_pBody != NULL__null); | ||||||||||
219 | } | ||||||||||
220 | |||||||||||
221 | #if defined LIBO_INTERNAL_ONLY1 | ||||||||||
222 | /** Returns True if the handle does point to a valid body. | ||||||||||
223 | */ | ||||||||||
224 | explicit operator bool() const | ||||||||||
225 | { | ||||||||||
226 | return is(); | ||||||||||
227 | } | ||||||||||
228 | #endif | ||||||||||
229 | |||||||||||
230 | /** Returns True if this points to pBody. | ||||||||||
231 | */ | ||||||||||
232 | bool SAL_CALL operator== (const reference_type * pBody) const | ||||||||||
233 | { | ||||||||||
234 | return (m_pBody == pBody); | ||||||||||
235 | } | ||||||||||
236 | |||||||||||
237 | |||||||||||
238 | /** Returns True if handle points to the same body. | ||||||||||
239 | */ | ||||||||||
240 | bool | ||||||||||
241 | SAL_CALL operator== (const Reference<reference_type> & handle) const | ||||||||||
242 | { | ||||||||||
243 | return (m_pBody == handle.m_pBody); | ||||||||||
244 | } | ||||||||||
245 | |||||||||||
246 | |||||||||||
247 | /** Needed to place References into STL collection. | ||||||||||
248 | */ | ||||||||||
249 | bool | ||||||||||
250 | SAL_CALL operator!= (const Reference<reference_type> & handle) const | ||||||||||
251 | { | ||||||||||
252 | return (m_pBody != handle.m_pBody); | ||||||||||
253 | } | ||||||||||
254 | |||||||||||
255 | |||||||||||
256 | /** Needed to place References into STL collection. | ||||||||||
257 | */ | ||||||||||
258 | bool | ||||||||||
259 | SAL_CALL operator< (const Reference<reference_type> & handle) const | ||||||||||
260 | { | ||||||||||
261 | return (m_pBody < handle.m_pBody); | ||||||||||
262 | } | ||||||||||
263 | |||||||||||
264 | |||||||||||
265 | /** Needed to place References into STL collection. | ||||||||||
266 | */ | ||||||||||
267 | bool | ||||||||||
268 | SAL_CALL operator> (const Reference<reference_type> & handle) const | ||||||||||
269 | { | ||||||||||
270 | return (m_pBody > handle.m_pBody); | ||||||||||
271 | } | ||||||||||
272 | }; | ||||||||||
273 | |||||||||||
274 | } // namespace rtl | ||||||||||
275 | |||||||||||
276 | #if defined LIBO_INTERNAL_ONLY1 | ||||||||||
277 | namespace std | ||||||||||
278 | { | ||||||||||
279 | |||||||||||
280 | /// @cond INTERNAL | ||||||||||
281 | /** | ||||||||||
282 | Make rtl::Reference hashable by default for use in STL containers. | ||||||||||
283 | |||||||||||
284 | @since LibreOffice 6.3 | ||||||||||
285 | */ | ||||||||||
286 | template<typename T> | ||||||||||
287 | struct hash<::rtl::Reference<T>> | ||||||||||
288 | { | ||||||||||
289 | std::size_t operator()(::rtl::Reference<T> const & s) const | ||||||||||
290 | { return std::size_t(s.get()); } | ||||||||||
291 | }; | ||||||||||
292 | /// @endcond | ||||||||||
293 | |||||||||||
294 | } | ||||||||||
295 | |||||||||||
296 | #endif | ||||||||||
297 | |||||||||||
298 | #endif /* ! INCLUDED_RTL_REF_HXX */ | ||||||||||
299 | |||||||||||
300 | /* vim:set shiftwidth=4 softtabstop=4 expandtab: */ |
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 | #ifndef INCLUDED_VCL_Reference_HXX |
20 | #define INCLUDED_VCL_Reference_HXX |
21 | |
22 | #include <vcl/dllapi.h> |
23 | #include <osl/interlck.h> |
24 | |
25 | class VCL_DLLPUBLIC__attribute__ ((visibility("default"))) VclReferenceBase |
26 | { |
27 | mutable oslInterlockedCount mnRefCnt; |
28 | |
29 | template<typename T> friend class VclPtr; |
30 | |
31 | public: |
32 | void acquire() const |
33 | { |
34 | osl_atomic_increment(&mnRefCnt)__sync_add_and_fetch((&mnRefCnt), 1); |
35 | } |
36 | |
37 | void release() const |
38 | { |
39 | if (osl_atomic_decrement(&mnRefCnt)__sync_sub_and_fetch((&mnRefCnt), 1) == 0) |
40 | delete this; |
41 | } |
42 | #ifdef DBG_UTIL |
43 | #ifndef _WIN32 |
44 | sal_Int32 getRefCount() const { return mnRefCnt; } |
45 | #endif |
46 | #endif |
47 | |
48 | |
49 | private: |
50 | VclReferenceBase(const VclReferenceBase&) = delete; |
51 | VclReferenceBase& operator=(const VclReferenceBase&) = delete; |
52 | |
53 | bool mbDisposed : 1; |
54 | |
55 | protected: |
56 | VclReferenceBase(); |
57 | protected: |
58 | virtual ~VclReferenceBase(); |
59 | |
60 | protected: |
61 | virtual void dispose(); |
62 | |
63 | public: |
64 | void disposeOnce(); |
65 | bool isDisposed() const { return mbDisposed; } |
66 | |
67 | }; |
68 | #endif |