New loplugin:dynexcspec: Add @throws documentation, svtools

Change-Id: I274142728ea25be094343e3489758314e371a857

10 files changed, 40 insertions, 3 deletions

diff --git a/include/svtools/accessibleruler.hxx b/include/svtools/accessibleruler.hxx
index 7c003e2652b4..174d02b13dbd 100644
--- a/include/svtools/accessibleruler.hxx
+++ b/include/svtools/accessibleruler.hxx
@@ -68,7 +68,7 @@ public:
 protected:
     virtual ~SvtRulerAccessible() override;
 public:
-
+    /// @throws css::uno::RuntimeException
     bool SAL_CALL
         isVisible() throw( css::uno::RuntimeException );
 
@@ -166,9 +166,13 @@ public:
 protected:
 
     /// @Return the object's current bounding box relative to the desktop.
+    ///
+    /// @throws css::uno::RuntimeException
     Rectangle GetBoundingBoxOnScreen() throw( css::uno::RuntimeException );
 
     /// @Return the object's current bounding box relative to the parent object.
+    ///
+    /// @throws css::uno::RuntimeException
     Rectangle GetBoundingBox() throw( css::uno::RuntimeException );
 
 
@@ -177,7 +181,7 @@ protected:
     /// @returns true if it's disposed or in disposing
     inline bool IsAlive() const;
 
-    /// throws the exception DisposedException if it's not alive
+    /// @throws DisposedException if it's not alive
     void ThrowExceptionIfNotAlive() throw( css::lang::DisposedException );
 
 private:
diff --git a/include/svtools/popupmenucontrollerbase.hxx b/include/svtools/popupmenucontrollerbase.hxx
index 1358f5e0c957..d78aa34cd567 100644
--- a/include/svtools/popupmenucontrollerbase.hxx
+++ b/include/svtools/popupmenucontrollerbase.hxx
@@ -98,6 +98,7 @@ namespace svt
             void dispatchCommand( const OUString& sCommandURL, const css::uno::Sequence< css::beans::PropertyValue >& rArgs, const OUString& sTarget = OUString() );
 
     protected:
+            /// @throws css::uno::RuntimeException
             void throwIfDisposed() throw ( css::uno::RuntimeException );
 
             /** helper method to cause statusChanged is called once for the given command url */
diff --git a/include/svtools/toolbarmenu.hxx b/include/svtools/toolbarmenu.hxx
index 58e0b9d9f301..3fb12accb744 100644
--- a/include/svtools/toolbarmenu.hxx
+++ b/include/svtools/toolbarmenu.hxx
@@ -60,6 +60,7 @@ protected:
     void EndPopupMode();
 
     // Forwarded from XStatusListener (subclasses must override this one to get the status updates):
+    /// @throws css::uno::RuntimeException
     virtual void statusChanged(const css::frame::FeatureStateEvent& Event ) throw (css::uno::RuntimeException, std::exception);
 
 private:
diff --git a/include/svtools/unoevent.hxx b/include/svtools/unoevent.hxx
index 39c934d25206..2dff69664efe 100644
--- a/include/svtools/unoevent.hxx
+++ b/include/svtools/unoevent.hxx
@@ -127,6 +127,11 @@ public:
 protected:
 
     /// Must be implemented in subclass.
+    ///
+    /// @throws css::lang::IllegalArgumentException
+    /// @throws css::container::NoSuchElementException
+    /// @throws css::lang::WrappedTargetException
+    /// @throws css::uno::RuntimeException
     virtual void replaceByName(
         const sal_uInt16 nEvent,        /// item ID of event
         const SvxMacro& rMacro)     /// event (will be copied)
@@ -137,6 +142,10 @@ protected:
                 css::uno::RuntimeException) = 0;
 
     /// Must be implemented in subclass.
+    ///
+    /// @throws css::container::NoSuchElementException
+    /// @throws css::lang::WrappedTargetException
+    /// @throws css::uno::RuntimeException
     virtual void getByName(
         SvxMacro& rMacro,
         const sal_uInt16 nEvent )
@@ -262,7 +271,7 @@ protected:
     /// do we have an event?
     /// return true: we have a macro for the event
     /// return false: no macro; getByName() will return an empty macro
-    /// IllegalArgumentException: the event is not supported
+    /// @throws css::lang::IllegalArgumentException if the event is not supported
     bool hasById(
         const sal_uInt16 nEvent ) const     /// item ID of event
              throw(
diff --git a/svtools/source/control/toolbarmenuimp.hxx b/svtools/source/control/toolbarmenuimp.hxx
index 7ad29acf1b1e..5a43ba8b1cf9 100644
--- a/svtools/source/control/toolbarmenuimp.hxx
+++ b/svtools/source/control/toolbarmenuimp.hxx
@@ -86,7 +86,10 @@ public:
 
     const css::uno::Reference< css::accessibility::XAccessibleContext >& GetAccessible();
 
+    /// @throws css::uno::RuntimeException
     sal_Int32 getAccessibleChildCount() throw (css::uno::RuntimeException);
+    /// @throws css::lang::IndexOutOfBoundsException
+    /// @throws css::uno::RuntimeException
     css::uno::Reference< css::accessibility::XAccessible > getAccessibleChild( sal_Int32 index ) throw (css::lang::IndexOutOfBoundsException, css::uno::RuntimeException);
 
     bool HasCheck() const
@@ -174,6 +177,8 @@ private:
         state of being disposed).  If that is the case then
         DisposedException is thrown to inform the (indirect) caller of the
         foul deed.
+
+        @throws css::lang::DisposedException
     */
     void ThrowIfDisposed() throw (css::lang::DisposedException);
 };
@@ -261,11 +266,20 @@ struct ToolbarMenu_Impl
 
     void fireAccessibleEvent( short nEventId, const css::uno::Any& rOldValue, const css::uno::Any& rNewValue );
 
+    /// @throws css::uno::RuntimeException
     sal_Int32 getAccessibleChildCount() throw (css::uno::RuntimeException);
+    /// @throws css::lang::IndexOutOfBoundsException
+    /// @throws css::uno::RuntimeException
     css::uno::Reference< css::accessibility::XAccessible > getAccessibleChild( sal_Int32 index ) throw (css::lang::IndexOutOfBoundsException, css::uno::RuntimeException);
+    /// @throws css::lang::IndexOutOfBoundsException
+    /// @throws css::uno::RuntimeException
     css::uno::Reference< css::accessibility::XAccessible > getAccessibleChild( Control* pControl, sal_Int32 childIndex ) throw (css::lang::IndexOutOfBoundsException, css::uno::RuntimeException);
 
+    /// @throws css::lang::IndexOutOfBoundsException
+    /// @throws css::uno::RuntimeException
     void selectAccessibleChild( sal_Int32 nChildIndex ) throw (css::lang::IndexOutOfBoundsException, css::uno::RuntimeException);
+    /// @throws css::lang::IndexOutOfBoundsException
+    /// @throws css::uno::RuntimeException
     bool isAccessibleChildSelected( sal_Int32 nChildIndex ) throw (css::lang::IndexOutOfBoundsException, css::uno::RuntimeException);
     void clearAccessibleSelection();
 
diff --git a/svtools/source/control/valueimp.hxx b/svtools/source/control/valueimp.hxx
index 04857d91d6a7..3a05b9a5656c 100644
--- a/svtools/source/control/valueimp.hxx
+++ b/svtools/source/control/valueimp.hxx
@@ -178,6 +178,7 @@ private:
         state of being disposed).  If that is the case then
         DisposedException is thrown to inform the (indirect) caller of the
         foul deed.
+        @throws css::lang::DisposedException
     */
     void ThrowIfDisposed()
         throw (css::lang::DisposedException);
diff --git a/svtools/source/graphic/graphicunofactory.cxx b/svtools/source/graphic/graphicunofactory.cxx
index eb8b75305a4d..fa2c98043c70 100644
--- a/svtools/source/graphic/graphicunofactory.cxx
+++ b/svtools/source/graphic/graphicunofactory.cxx
@@ -39,6 +39,7 @@ class GObjectImpl : public GObjectAccess_BASE
      ::osl::Mutex m_aMutex;
      std::unique_ptr< GraphicObject > mpGObject;
 public:
+    /// @throws uno::RuntimeException
     explicit GObjectImpl(uno::Sequence< uno::Any > const & args) throw (uno::RuntimeException, std::exception);
 
      // XGraphicObject
diff --git a/svtools/source/uno/treecontrolpeer.hxx b/svtools/source/uno/treecontrolpeer.hxx
index 367317319caf..2106cb18eece 100644
--- a/svtools/source/uno/treecontrolpeer.hxx
+++ b/svtools/source/uno/treecontrolpeer.hxx
@@ -113,6 +113,7 @@ public:
     css::uno::Any SAL_CALL getProperty( const OUString& PropertyName ) throw(css::uno::RuntimeException, std::exception) override;
 
 private:
+    /// @throws css::lang::IllegalArgumentException
     UnoTreeListEntry* getEntry( const css::uno::Reference< css::awt::tree::XTreeNode >& xNode, bool bThrow = true ) throw (css::lang::IllegalArgumentException );
 
     void disposeControl();
@@ -132,7 +133,10 @@ private:
 
     static OUString getEntryString( const css::uno::Any& rValue );
 
+    /// @throws css::uno::RuntimeException
     UnoTreeListBoxImpl& getTreeListBoxOrThrow() const throw (css::uno::RuntimeException );
+    /// @throws css::uno::RuntimeException
+    /// @throws css::lang::IllegalArgumentException
     void ChangeNodesSelection( const css::uno::Any& rSelection, bool bSelect, bool bSetSelection ) throw( css::uno::RuntimeException, css::lang::IllegalArgumentException );
 
     void onChangeDataModel( UnoTreeListBoxImpl& rTree, const css::uno::Reference< css::awt::tree::XTreeDataModel >& xDataModel );
diff --git a/svtools/source/uno/unoevent.cxx b/svtools/source/uno/unoevent.cxx
index c8a6a061b59b..e8f6cbd5cdcf 100644
--- a/svtools/source/uno/unoevent.cxx
+++ b/svtools/source/uno/unoevent.cxx
@@ -134,6 +134,7 @@ void getAnyFromMacro(Any& rAny, const SvxMacro& rMacro)
     }
 }
 
+/// @throws IllegalArgumentException
 void getMacroFromAny(
     SvxMacro& rMacro,
     const Any& rAny)
diff --git a/svtools/source/uno/unoimap.cxx b/svtools/source/uno/unoimap.cxx
index 7fd31632e864..691df2d42565 100644
--- a/svtools/source/uno/unoimap.cxx
+++ b/svtools/source/uno/unoimap.cxx
@@ -516,6 +516,7 @@ public:
     virtual ~SvUnoImageMap() override;
 
     bool fillImageMap( ImageMap& rMap ) const;
+    /// @throws IllegalArgumentException
     static SvUnoImageMapObject* getObject( const Any& aElement ) throw( IllegalArgumentException );
 
     UNO3_GETIMPLEMENTATION_DECL( SvUnoImageMap )