New loplugin:dynexcspec: Add @throws documentation, svx

Change-Id: I0e827554a18622e19aec5f81c40da52664783f69

12 files changed, 88 insertions, 0 deletions

diff --git a/include/svx/AccessibleShape.hxx b/include/svx/AccessibleShape.hxx
index c5d04641208b..d6860526efa9 100644
--- a/include/svx/AccessibleShape.hxx
+++ b/include/svx/AccessibleShape.hxx
@@ -423,6 +423,8 @@ protected:
     virtual void SAL_CALL disposing() override;
 
     /** Create a base name string that contains the accessible name.
+
+        @throws css::uno::RuntimeException
     */
     virtual OUString
         CreateAccessibleBaseName()
@@ -439,6 +441,7 @@ protected:
     virtual OUString
         CreateAccessibleDescription()
         throw (css::uno::RuntimeException, std::exception) override;
+    /// @throws css::uno::RuntimeException
     OUString
        GetFullAccessibleName(AccessibleShape *shape)
        throw (css::uno::RuntimeException, std::exception);
diff --git a/include/svx/ChildrenManager.hxx b/include/svx/ChildrenManager.hxx
index c85bd1b3428e..0116909fda88 100644
--- a/include/svx/ChildrenManager.hxx
+++ b/include/svx/ChildrenManager.hxx
@@ -126,7 +126,10 @@ public:
         GetChild (long nIndex)
         throw (css::uno::RuntimeException,
                css::lang::IndexOutOfBoundsException);
+        /// @throws css::uno::RuntimeException
         css::uno::Reference< css::accessibility::XAccessible> GetChild (const css::uno::Reference< css::drawing::XShape>& xShape) throw (css::uno::RuntimeException);
+        /// @throws css::lang::IndexOutOfBoundsException
+        /// @throws css::uno::RuntimeException
         css::uno::Reference< css::drawing::XShape> GetChildShape (long nIndex)
             throw (css::lang::IndexOutOfBoundsException,
                    css::uno::RuntimeException);
diff --git a/include/svx/IAccessibleParent.hxx b/include/svx/IAccessibleParent.hxx
index 897820b2e37d..e54cb551a9c0 100644
--- a/include/svx/IAccessibleParent.hxx
+++ b/include/svx/IAccessibleParent.hxx
@@ -81,9 +81,11 @@ public:
         const AccessibleShapeTreeInfo& _rShapeTreeInfo
     )   throw (css::uno::RuntimeException, std::exception) = 0;
     //Add this method to support Form Controls
+    /// @throws css::uno::RuntimeException
     virtual AccessibleControlShape* GetAccControlShapeFromModel
         (css::beans::XPropertySet*)
         throw (css::uno::RuntimeException){return nullptr;};
+    /// @throws css::uno::RuntimeException
     virtual  css::uno::Reference<
             css::accessibility::XAccessible>
         GetAccessibleCaption (const css::uno::Reference<
diff --git a/include/svx/ShapeTypeHandler.hxx b/include/svx/ShapeTypeHandler.hxx
index b2c80e3cac0b..b5254453da00 100644
--- a/include/svx/ShapeTypeHandler.hxx
+++ b/include/svx/ShapeTypeHandler.hxx
@@ -136,6 +136,8 @@ public:
         ShapeTypeDescriptor aDescriptorList[]);
 
     /// get the accessible base name for an object
+    ///
+    /// @throws css::uno::RuntimeException
     static OUString CreateAccessibleBaseName (
         const css::uno::Reference< css::drawing::XShape >& rxShape)
             throw (css::uno::RuntimeException, std::exception);
diff --git a/include/svx/fmtools.hxx b/include/svx/fmtools.hxx
index e12c3512da5b..c1ff8387545f 100644
--- a/include/svx/fmtools.hxx
+++ b/include/svx/fmtools.hxx
@@ -125,9 +125,13 @@ public:
     const css::uno::Reference< css::beans::XPropertySet >&        getPropertySet() const      { return m_xPropertyAccess; }
 
     // css::uno::Reference< css::sdbcx::XRowLocate>
+    /// @throws css::sdbc::SQLException
+    /// @throws css::uno::RuntimeException
     css::uno::Any getBookmark()
         throw( css::sdbc::SQLException, css::uno::RuntimeException )
     { return m_xBookmarkOperations->getBookmark(); }
+    /// @throws css::sdbc::SQLException
+    /// @throws css::uno::RuntimeException
     bool moveToBookmark(const css::uno::Any& bookmark) throw( css::sdbc::SQLException, css::uno::RuntimeException ) { return m_xBookmarkOperations->moveToBookmark(bookmark); }
 
     // css::sdbc::XResultSet
@@ -146,6 +150,7 @@ public:
     void refreshRow()                       { m_xMoveOperations->refreshRow(); }
     bool rowDeleted()                       { return m_xMoveOperations->rowDeleted(); }
     // css::sdbcx::XColumnsSupplier
+    /// @throws css::uno::RuntimeException
     css::uno::Reference< css::container::XNameAccess> getColumns() const throw( css::uno::RuntimeException ) { return m_xColumnsSupplier->getColumns(); }
 private:
     void ImplConstruct(const css::uno::Reference< css::sdbc::XResultSet>& _rxCursor, bool bUseCloned);
@@ -163,6 +168,7 @@ class SAL_WARN_UNUSED FmXDisposeListener
 public:
     virtual ~FmXDisposeListener();
 
+    /// @throws css::uno::RuntimeException
     virtual void disposing(const css::lang::EventObject& _rEvent, sal_Int16 _nId) throw( css::uno::RuntimeException ) = 0;
 
 protected:
diff --git a/include/svx/gridctrl.hxx b/include/svx/gridctrl.hxx
index b3838645a103..3dcb3ffabdca 100644
--- a/include/svx/gridctrl.hxx
+++ b/include/svx/gridctrl.hxx
@@ -351,6 +351,7 @@ protected:
     */
     virtual void PostExecuteRowContextMenu(sal_uInt16 nRow, const PopupMenu& rMenu, sal_uInt16 nExecutionResult);
 
+    /// @throws css::uno::RuntimeException
     void DataSourcePropertyChanged(const css::beans::PropertyChangeEvent& evt) throw(css::uno::RuntimeException, std::exception);
 
     void FieldValueChanged(sal_uInt16 _nId, const css::beans::PropertyChangeEvent& _evt);
diff --git a/include/svx/unoapi.hxx b/include/svx/unoapi.hxx
index 35e7098ee051..d2bc9b62f820 100644
--- a/include/svx/unoapi.hxx
+++ b/include/svx/unoapi.hxx
@@ -38,6 +38,8 @@ enum class SdrInventor : sal_uInt32;
 /**
  * Creates a StarOffice API wrapper with the given type and inventor
  * Deprecated: This will be replaced with a function returning XShape.
+ *
+ * @throws css::uno::RuntimeException
  */
 SVX_DLLPUBLIC SvxShape* CreateSvxShapeByTypeAndInventor(sal_uInt16 nType, SdrInventor nInventor, OUString const & referer)
     throw (css::uno::RuntimeException, std::exception);
@@ -75,6 +77,8 @@ SVX_DLLPUBLIC bool SvxFieldUnitToMeasureUnit( const FieldUnit nVcl, short& eApi
 /**
  * If the given name is a predefined name for the current language it is replaced by
  * the corresponding API name.
+ *
+ * @throws std::exception
 */
 SVX_DLLPUBLIC SAL_WARN_UNUSED_RESULT OUString
     SvxUnogetApiNameForItem(const sal_Int16 nWhich, const OUString& rInternalName) throw(std::exception);
@@ -82,6 +86,8 @@ SVX_DLLPUBLIC SAL_WARN_UNUSED_RESULT OUString
 /**
  * If the given name is a predefined API name it is replaced by the predefined name
  * for the current language.
+ *
+ * @throws std::exception
 */
 SVX_DLLPUBLIC SAL_WARN_UNUSED_RESULT OUString
     SvxUnogetInternalNameForItem(const sal_Int16 nWhich, const OUString& rApiName) throw(std::exception);
diff --git a/include/svx/unomaster.hxx b/include/svx/unomaster.hxx
index 9e2db415f314..ee9ee03f59c4 100644
--- a/include/svx/unomaster.hxx
+++ b/include/svx/unomaster.hxx
@@ -35,7 +35,13 @@ class SvxShapeMaster
 public:
     virtual bool queryAggregation( const css::uno::Type & rType, css::uno::Any& aAny ) = 0;
 
+    /// @throws css::uno::RuntimeException
     virtual css::uno::Reference< css::beans::XPropertySetInfo > SAL_CALL getPropertySetInfo(  ) throw(css::uno::RuntimeException) = 0;
+    /// @throws css::beans::UnknownPropertyException
+    /// @throws css::beans::PropertyVetoException
+    /// @throws css::lang::IllegalArgumentException
+    /// @throws css::lang::WrappedTargetException
+    /// @throws css::uno::RuntimeException
     virtual void SAL_CALL setPropertyValue( const OUString& aPropertyName, const css::uno::Any& aValue )
         throw (css::beans::UnknownPropertyException,
                css::beans::PropertyVetoException,
@@ -43,18 +49,30 @@ public:
                css::lang::WrappedTargetException,
                css::uno::RuntimeException,
                std::exception) = 0;
+    /// @throws css::beans::UnknownPropertyException
+    /// @throws css::lang::WrappedTargetException
+    /// @throws css::uno::RuntimeException
     virtual css::uno::Any SAL_CALL getPropertyValue( const OUString& PropertyName )
         throw (css::beans::UnknownPropertyException,
                css::lang::WrappedTargetException,
                css::uno::RuntimeException,
                std::exception) = 0;
 
+    /// @throws css::beans::UnknownPropertyException
+    /// @throws css::uno::RuntimeException
     virtual css::beans::PropertyState SAL_CALL getPropertyState( const OUString& PropertyName ) throw(css::beans::UnknownPropertyException, css::uno::RuntimeException) = 0;
+    /// @throws css::beans::UnknownPropertyException
+    /// @throws css::uno::RuntimeException
     virtual void SAL_CALL setPropertyToDefault( const OUString& PropertyName ) throw(css::beans::UnknownPropertyException, css::uno::RuntimeException) = 0;
+    /// @throws css::beans::UnknownPropertyException
+    /// @throws css::lang::WrappedTargetException
+    /// @throws css::uno::RuntimeException
     virtual css::uno::Any SAL_CALL getPropertyDefault( const OUString& aPropertyName )  throw(css::beans::UnknownPropertyException, css::lang::WrappedTargetException, css::uno::RuntimeException, std::exception) = 0;
 
+    /// @throws css::uno::RuntimeException
     virtual css::uno::Sequence< css::uno::Type > SAL_CALL getTypes(  ) throw(css::uno::RuntimeException) = 0;
 
+    /// @throws css::uno::RuntimeException
     virtual css::uno::Sequence< OUString > SAL_CALL getSupportedServiceNames() throw(css::uno::RuntimeException) = 0;
 
     virtual void dispose() = 0;
diff --git a/include/svx/unomod.hxx b/include/svx/unomod.hxx
index 153ffbd27724..2b893b869718 100644
--- a/include/svx/unomod.hxx
+++ b/include/svx/unomod.hxx
@@ -40,6 +40,8 @@ public:
     virtual css::uno::Reference< css::uno::XInterface > SAL_CALL createInstanceWithArguments( const OUString& ServiceSpecifier, const css::uno::Sequence< css::uno::Any >& Arguments ) throw(css::uno::Exception, css::uno::RuntimeException, std::exception) override;
     virtual css::uno::Sequence< OUString > SAL_CALL getAvailableServiceNames(  ) throw(css::uno::RuntimeException, std::exception) override;
 
+    /// @throws css::uno::Exception
+    /// @throws css::uno::RuntimeException
     static css::uno::Reference< css::uno::XInterface > SAL_CALL createTextField( const OUString& aServiceSpecifier ) throw(css::uno::Exception, css::uno::RuntimeException);
     // internal
     static css::uno::Sequence< OUString >
diff --git a/include/svx/unopage.hxx b/include/svx/unopage.hxx
index 7bbdc1672523..5924620faa25 100644
--- a/include/svx/unopage.hxx
+++ b/include/svx/unopage.hxx
@@ -93,13 +93,16 @@ class SVX_DLLPUBLIC SvxDrawPage : public ::cppu::WeakAggImplHelper6< css::drawin
 
     // Creating a SdrObject using it's Description.
     // Can be used by derived classes to support their owen Shapes (e.g. Controls).
+    /// @throws css::uno::RuntimeException
     virtual SdrObject *CreateSdrObject_( const css::uno::Reference< css::drawing::XShape >& xShape )
         throw (css::uno::RuntimeException, std::exception);
 
+    /// @throws css::uno::RuntimeException
     static SvxShape* CreateShapeByTypeAndInventor( sal_uInt16 nType, SdrInventor nInventor, SdrObject *pObj, SvxDrawPage *pPage = nullptr, OUString const & referer = OUString() ) throw (css::uno::RuntimeException);
 
     // The following method is called if a SvxShape object is to be created.
     // Derived classes can create a derivation or an SvxShape aggregating object.
+    /// @throws css::uno::RuntimeException
     virtual css::uno::Reference< css::drawing::XShape > CreateShape( SdrObject *pObj ) const
         throw (css::uno::RuntimeException, std::exception);
 
diff --git a/include/svx/unopool.hxx b/include/svx/unopool.hxx
index 5cd057a4e16d..67c03fb5f10d 100644
--- a/include/svx/unopool.hxx
+++ b/include/svx/unopool.hxx
@@ -78,7 +78,11 @@ public:
 protected:
     void init();
 
+    /// @throws css::beans::UnknownPropertyException
     static void getAny( SfxItemPool* pPool, const comphelper::PropertyMapEntry* pEntry, css::uno::Any& rValue ) throw(css::beans::UnknownPropertyException);
+    /// @throws css::beans::UnknownPropertyException
+    /// @throws css::lang::IllegalArgumentException
+    /// @throws css::uno::RuntimeException
     virtual void putAny( SfxItemPool* pPool, const comphelper::PropertyMapEntry* pEntry, const css::uno::Any& rValue ) throw(css::beans::UnknownPropertyException, css::lang::IllegalArgumentException, css::uno::RuntimeException, std::exception);
 
 protected:
diff --git a/include/svx/unoshape.hxx b/include/svx/unoshape.hxx
index bc3d0aa57a1a..0f374953ddea 100644
--- a/include/svx/unoshape.hxx
+++ b/include/svx/unoshape.hxx
@@ -164,14 +164,29 @@ protected:
     void endSetPropertyValues();
 
     // override these for special property handling in subcasses. Return true if property is handled
+    /// @throws css::beans::UnknownPropertyException
+    /// @throws css::beans::PropertyVetoException
+    /// @throws css::lang::IllegalArgumentException
+    /// @throws css::lang::WrappedTargetException
+    /// @throws css::uno::RuntimeException
     virtual bool setPropertyValueImpl( const OUString& rName, const SfxItemPropertySimpleEntry* pProperty, const css::uno::Any& rValue ) throw(css::beans::UnknownPropertyException, css::beans::PropertyVetoException, css::lang::IllegalArgumentException, css::lang::WrappedTargetException, css::uno::RuntimeException, std::exception);
+    /// @throws css::beans::UnknownPropertyException
+    /// @throws css::lang::WrappedTargetException
+    /// @throws css::uno::RuntimeException
     virtual bool getPropertyValueImpl( const OUString& rName, const SfxItemPropertySimpleEntry* pProperty, css::uno::Any& rValue ) throw(css::beans::UnknownPropertyException, css::lang::WrappedTargetException, css::uno::RuntimeException, std::exception);
+    /// @throws css::beans::UnknownPropertyException
+    /// @throws css::uno::RuntimeException
     virtual bool getPropertyStateImpl( const SfxItemPropertySimpleEntry* pProperty, css::beans::PropertyState& rState ) throw(css::beans::UnknownPropertyException, css::uno::RuntimeException);
+    /// @throws css::beans::UnknownPropertyException
+    /// @throws css::uno::RuntimeException
     virtual bool setPropertyToDefaultImpl( const SfxItemPropertySimpleEntry* pProperty ) throw(css::beans::UnknownPropertyException, css::uno::RuntimeException);
 
 public:
+    /// @throws css::uno::RuntimeException
     SvxShape( SdrObject* pObj ) throw (css::uno::RuntimeException);
+    /// @throws css::uno::RuntimeException
     SvxShape( SdrObject* pObject, const SfxItemPropertyMapEntry* pEntries, const SvxItemPropertySet* pPropertySet ) throw (css::uno::RuntimeException);
+    /// @throws css::uno::RuntimeException
     SvxShape() throw (css::uno::RuntimeException);
     virtual ~SvxShape() throw () override;
 
@@ -191,6 +206,7 @@ public:
     void InvalidateSdrObject() { mpObj.reset( nullptr ); };
     SdrObject* GetSdrObject() const {return mpObj.get();}
     void SetShapeType( const OUString& ShapeType ) { maShapeType = ShapeType; }
+    /// @throws css::uno::RuntimeException
     css::uno::Any GetBitmap( bool bMetaFile = false ) const
         throw (css::uno::RuntimeException, std::exception);
 
@@ -211,16 +227,34 @@ public:
     UNO3_GETIMPLEMENTATION_DECL( SvxShape )
 
     // access methods for master objects
+    /// @throws css::uno::RuntimeException
     css::uno::Reference< css::beans::XPropertySetInfo > SAL_CALL _getPropertySetInfo(  ) throw(css::uno::RuntimeException);
+    /// @throws css::beans::UnknownPropertyException
+    /// @throws css::beans::PropertyVetoException
+    /// @throws css::lang::IllegalArgumentException
+    /// @throws css::lang::WrappedTargetException
+    /// @throws css::uno::RuntimeException
     void SAL_CALL _setPropertyValue( const OUString& aPropertyName, const css::uno::Any& aValue ) throw(css::beans::UnknownPropertyException, css::beans::PropertyVetoException, css::lang::IllegalArgumentException, css::lang::WrappedTargetException, css::uno::RuntimeException, std::exception);
+    /// @throws css::beans::UnknownPropertyException
+    /// @throws css::lang::WrappedTargetException
+    /// @throws css::uno::RuntimeException
     css::uno::Any SAL_CALL _getPropertyValue( const OUString& PropertyName ) throw(css::beans::UnknownPropertyException, css::lang::WrappedTargetException, css::uno::RuntimeException);
 
+    /// @throws css::beans::UnknownPropertyException
+    /// @throws css::uno::RuntimeException
     css::beans::PropertyState SAL_CALL _getPropertyState( const OUString& PropertyName ) throw(css::beans::UnknownPropertyException, css::uno::RuntimeException);
+    /// @throws css::beans::UnknownPropertyException
+    /// @throws css::uno::RuntimeException
     void SAL_CALL _setPropertyToDefault( const OUString& PropertyName ) throw(css::beans::UnknownPropertyException, css::uno::RuntimeException);
+    /// @throws css::beans::UnknownPropertyException
+    /// @throws css::lang::WrappedTargetException
+    /// @throws css::uno::RuntimeException
     css::uno::Any SAL_CALL _getPropertyDefault( const OUString& aPropertyName )     throw(css::beans::UnknownPropertyException, css::lang::WrappedTargetException, css::uno::RuntimeException);
 
+    /// @throws css::uno::RuntimeException
     css::uno::Sequence< OUString > SAL_CALL _getSupportedServiceNames() throw(css::uno::RuntimeException);
 
+    /// @throws css::uno::RuntimeException
     css::uno::Sequence< css::uno::Type > SAL_CALL _getTypes(  ) throw(css::uno::RuntimeException);
 
     void setMaster( SvxShapeMaster* pMaster );
@@ -585,10 +619,13 @@ protected:
     virtual bool getPropertyValueImpl( const OUString& rName, const SfxItemPropertySimpleEntry* pProperty, css::uno::Any& rValue ) throw(css::beans::UnknownPropertyException, css::lang::WrappedTargetException, css::uno::RuntimeException) override;
 
 public:
+    /// @throws css::lang::IllegalArgumentException
+    /// @throws css::beans::PropertyVetoException
     SvxShapePolyPolygon( SdrObject* pObj , css::drawing::PolygonKind eNew ) throw(css::lang::IllegalArgumentException, css::beans::PropertyVetoException);
     virtual ~SvxShapePolyPolygon() throw() override;
 
     // Local support functions
+    /// @throws css::uno::RuntimeException
     void SetPolygon(const basegfx::B2DPolyPolygon& rNew) throw(css::uno::RuntimeException);
     basegfx::B2DPolyPolygon GetPolygon() const throw();
 };
@@ -615,6 +652,7 @@ public:
     virtual ~SvxShapePolyPolygonBezier() throw() override;
 
     // Local support functions
+    /// @throws css::uno::RuntimeException
     void SetPolygon(const basegfx::B2DPolyPolygon & rNew) throw(css::uno::RuntimeException);
     basegfx::B2DPolyPolygon GetPolygon() const throw();
 };