diff options
author | Abdulmajeed Al-Abaulrazzaq <aalabdulrazzaq@kacst.edu.sa> | 2012-09-11 15:16:03 +0300 |
---|---|---|
committer | Michael Stahl <mstahl@redhat.com> | 2012-09-11 17:54:21 +0000 |
commit | 4ed62ddb01e4ecff9de01246ea4c040f007c1196 (patch) | |
tree | ea75c2b5e5ef8b01d6cc1aafdccc10f29a7e982c /sw | |
parent | a8a15bd95c4fda67c6785036bfbf50f94a749496 (diff) |
Modifying comments to meet doxygen standards
Change-Id: I363ce532c7d11e798c2a5cc67b1b7893dcd0a389
Reviewed-on: https://gerrit.libreoffice.org/596
Reviewed-by: Michael Stahl <mstahl@redhat.com>
Tested-by: Michael Stahl <mstahl@redhat.com>
Diffstat (limited to 'sw')
-rw-r--r-- | sw/inc/fmtrfmrk.hxx | 4 | ||||
-rw-r--r-- | sw/inc/fmtruby.hxx | 12 | ||||
-rw-r--r-- | sw/inc/fmturl.hxx | 16 | ||||
-rw-r--r-- | sw/inc/fmtwrapinfluenceonobjpos.hxx | 6 | ||||
-rw-r--r-- | sw/inc/format.hxx | 80 | ||||
-rw-r--r-- | sw/inc/frmfmt.hxx | 56 | ||||
-rw-r--r-- | sw/inc/hhcwrp.hxx | 34 | ||||
-rw-r--r-- | sw/inc/hints.hxx | 34 | ||||
-rw-r--r-- | sw/inc/htmltbl.hxx | 162 | ||||
-rw-r--r-- | sw/inc/iodetect.hxx | 36 | ||||
-rw-r--r-- | sw/inc/istyleaccess.hxx | 10 | ||||
-rw-r--r-- | sw/inc/lineinfo.hxx | 28 | ||||
-rw-r--r-- | sw/inc/ndarr.hxx | 122 | ||||
-rw-r--r-- | sw/inc/ndgrf.hxx | 46 | ||||
-rw-r--r-- | sw/inc/ndhints.hxx | 56 | ||||
-rw-r--r-- | sw/inc/ndole.hxx | 24 | ||||
-rw-r--r-- | sw/inc/ndtxt.hxx | 170 |
17 files changed, 448 insertions, 448 deletions
diff --git a/sw/inc/fmtrfmrk.hxx b/sw/inc/fmtrfmrk.hxx index 9c4ea3ca3104..0ed9344bd592 100644 --- a/sw/inc/fmtrfmrk.hxx +++ b/sw/inc/fmtrfmrk.hxx @@ -41,7 +41,7 @@ class SwFmtRefMark : public SfxPoolItem friend class SwTxtRefMark; SwTxtRefMark* pTxtAttr; - // Protected CopyCtor. + /// Protected CopyCtor. SwFmtRefMark& operator=(const SwFmtRefMark& rRefMark); rtl::OUString aRefName; @@ -50,7 +50,7 @@ public: SwFmtRefMark( const SwFmtRefMark& rRefMark ); ~SwFmtRefMark( ); - // "Pure virtual methods" of SfxPoolItem. + /// "Pure virtual methods" of SfxPoolItem. virtual int operator==( const SfxPoolItem& ) const; virtual SfxPoolItem* Clone( SfxItemPool* pPool = 0 ) const; diff --git a/sw/inc/fmtruby.hxx b/sw/inc/fmtruby.hxx index bee5b6a3137b..d8b7448810c8 100644 --- a/sw/inc/fmtruby.hxx +++ b/sw/inc/fmtruby.hxx @@ -38,12 +38,12 @@ class SW_DLLPUBLIC SwFmtRuby : public SfxPoolItem { friend class SwTxtRuby; - String sRubyTxt; // The ruby txt. - String sCharFmtName; // Name of the charformat. - SwTxtRuby* pTxtAttr; // The TextAttribute. - sal_uInt16 nCharFmtId; // PoolId of the charformat. - sal_uInt16 nPosition; // Position of the Ruby-character. - sal_uInt16 nAdjustment; // Specific adjustment of the Ruby-ch. + String sRubyTxt; ///< The ruby txt. + String sCharFmtName; ///< Name of the charformat. + SwTxtRuby* pTxtAttr; ///< The TextAttribute. + sal_uInt16 nCharFmtId; ///< PoolId of the charformat. + sal_uInt16 nPosition; ///< Position of the Ruby-character. + sal_uInt16 nAdjustment; ///< Specific adjustment of the Ruby-ch. public: SwFmtRuby( const String& rRubyTxt ); diff --git a/sw/inc/fmturl.hxx b/sw/inc/fmturl.hxx index 667f0f1d8cac..fe9ba12de902 100644 --- a/sw/inc/fmturl.hxx +++ b/sw/inc/fmturl.hxx @@ -40,24 +40,24 @@ class IntlWrapper; class SW_DLLPUBLIC SwFmtURL: public SfxPoolItem { - String sTargetFrameName; // Target frame for URL. - String sURL; // Simple URL. - String sName; // Name of the anchor. - ImageMap *pMap; // ClientSide images. + String sTargetFrameName; ///< Target frame for URL. + String sURL; ///< Simple URL. + String sName; ///< Name of the anchor. + ImageMap *pMap; ///< ClientSide images. - sal_Bool bIsServerMap; // A ServerSideImageMap with the URL. + sal_Bool bIsServerMap; ///< A ServerSideImageMap with the URL. SwFmtURL& operator=( const SwFmtURL& ); public: SwFmtURL(); - // @@@ copy construction allowed, but assigment is not? @@@ + /// @@@ copy construction allowed, but assigment is not? @@@ SwFmtURL( const SwFmtURL& ); virtual ~SwFmtURL(); - // "Pure virtual methods" of SfxPoolItem. + /// "Pure virtual methods" of SfxPoolItem. virtual int operator==( const SfxPoolItem& ) const; virtual SfxPoolItem* Clone( SfxItemPool* pPool = 0 ) const; virtual SfxItemPresentation GetPresentation( SfxItemPresentation ePres, @@ -70,7 +70,7 @@ public: void SetTargetFrameName( const String& rStr ) { sTargetFrameName = rStr; } void SetURL( const String &rURL, sal_Bool bServerMap ); - void SetMap( const ImageMap *pM ); // Pointer will be copied. + void SetMap( const ImageMap *pM ); ///< Pointer will be copied. const String &GetTargetFrameName()const { return sTargetFrameName; } const String &GetURL() const { return sURL; } diff --git a/sw/inc/fmtwrapinfluenceonobjpos.hxx b/sw/inc/fmtwrapinfluenceonobjpos.hxx index 91418b49e24d..dc9480496d93 100644 --- a/sw/inc/fmtwrapinfluenceonobjpos.hxx +++ b/sw/inc/fmtwrapinfluenceonobjpos.hxx @@ -52,17 +52,17 @@ public: SwFmtWrapInfluenceOnObjPos& operator=( const SwFmtWrapInfluenceOnObjPos& _rSource ); - // pure virtual methods of class <SfxPoolItem> + /// pure virtual methods of class <SfxPoolItem> virtual int operator==( const SfxPoolItem& _rAttr ) const; virtual SfxPoolItem* Clone( SfxItemPool* pPool = 0 ) const; virtual bool QueryValue( com::sun::star::uno::Any& rVal, sal_uInt8 nMemberId = 0 ) const; virtual bool PutValue( const com::sun::star::uno::Any& rVal, sal_uInt8 nMemberId = 0 ); - // direct accessors to data + /// direct accessors to data void SetWrapInfluenceOnObjPos( sal_Int16 _nWrapInfluenceOnPosition ); // #i35017# - add parameter <_bIterativeAsOnceConcurrent> - // to control, if value <ITERATIVE> has to be treated as <ONCE_CONCURRENT> + /// to control, if value <ITERATIVE> has to be treated as <ONCE_CONCURRENT> sal_Int16 GetWrapInfluenceOnObjPos( const bool _bIterativeAsOnceConcurrent = false ) const; }; diff --git a/sw/inc/format.hxx b/sw/inc/format.hxx index 415cb3055b60..883165f62cf3 100644 --- a/sw/inc/format.hxx +++ b/sw/inc/format.hxx @@ -30,8 +30,8 @@ #include <tools/solar.h> #include "swdllapi.h" -#include <swatrset.hxx> // For SfxItemPool/-Set, Attr forward decl. -#include <calbck.hxx> // For SwModify. +#include <swatrset.hxx> ///< For SfxItemPool/-Set, Attr forward decl. +#include <calbck.hxx> ///< For SwModify. #include <hintids.hxx> class IDocumentSettingAccess; @@ -49,18 +49,18 @@ class SW_DLLPUBLIC SwFmt : public SwModify SwAttrSet aSet; sal_uInt16 nWhichId; - sal_uInt16 nFmtId; // Format-ID for reading / writing. - sal_uInt16 nPoolFmtId; // Id for "automatically" created formats. - // (is not hard attribution!!!) - sal_uInt16 nPoolHelpId; // HelpId for this Pool-style. - sal_uInt8 nPoolHlpFileId; // FilePos to Doc to these style helps. - sal_Bool bWritten : 1; // TRUE: already written. - sal_Bool bAutoFmt : 1; // FALSE: it is a template. - // default is true! - sal_Bool bFmtInDTOR : 1; // TRUE: Format becomes deleted. In order to be able - // to recognize this in FmtChg-message!! - sal_Bool bAutoUpdateFmt : 1;// TRUE: Set attributes of a whole paragraph - // at format (UI-side!). + sal_uInt16 nFmtId; ///< Format-ID for reading / writing. + sal_uInt16 nPoolFmtId; /**< Id for "automatically" created formats. + (is not hard attribution!!!) */ + sal_uInt16 nPoolHelpId; ///< HelpId for this Pool-style. + sal_uInt8 nPoolHlpFileId; ///< FilePos to Doc to these style helps. + sal_Bool bWritten : 1; ///< TRUE: already written. + sal_Bool bAutoFmt : 1; /**< FALSE: it is a template. + default is true! */ + sal_Bool bFmtInDTOR : 1; /**< TRUE: Format becomes deleted. In order to be able + to recognize this in FmtChg-message!! */ + sal_Bool bAutoUpdateFmt : 1;/**< TRUE: Set attributes of a whole paragraph + at format (UI-side!). */ protected: SwFmt( SwAttrPool& rPool, const sal_Char* pFmtNm, @@ -71,29 +71,29 @@ protected: virtual void Modify( const SfxPoolItem* pOld, const SfxPoolItem* pNewValue ); public: - TYPEINFO(); // Already in base class Client. + TYPEINFO(); ///< Already in base class Client. virtual ~SwFmt(); SwFmt &operator=(const SwFmt&); - // for Querying of Writer-functions. + /// for Querying of Writer-functions. sal_uInt16 Which() const { return nWhichId; } - // Query format information. + /// Query format information. virtual sal_Bool GetInfo( SfxPoolItem& ) const; - // Copy attributes even among documents. + /// Copy attributes even among documents. void CopyAttrs( const SwFmt&, sal_Bool bReplace=sal_True ); - // Delete all attributes that are not in rFmt. + /// Delete all attributes that are not in rFmt. void DelDiffs( const SfxItemSet& rSet ); void DelDiffs( const SwFmt& rFmt ) { DelDiffs( rFmt.GetAttrSet() ); } - // 0 is Default. + /// 0 is Default. sal_Bool SetDerivedFrom(SwFmt *pDerivedFrom = 0); - // If bInParents is FALSE, search only in this format for attribute. + /// If bInParents is FALSE, search only in this format for attribute. inline const SfxPoolItem& GetFmtAttr( sal_uInt16 nWhich, sal_Bool bInParents = sal_True ) const; inline SfxItemState GetItemState( sal_uInt16 nWhich, sal_Bool bSrchInParent = sal_True, @@ -102,8 +102,8 @@ public: virtual sal_Bool SetFmtAttr( const SfxItemSet& rSet ); virtual sal_Bool ResetFmtAttr( sal_uInt16 nWhich1, sal_uInt16 nWhich2 = 0 ); - // Takes all hints from Delta-Array, - // returns count of deleted hints. + /** Takes all hints from Delta-Array, + @return count of deleted hints. */ virtual sal_uInt16 ResetAllFmtAttr(); inline SwFmt* DerivedFrom() const { return (SwFmt*)GetRegisteredIn(); } @@ -114,11 +114,11 @@ public: inline void SetName( const sal_Char* pNewName, sal_Bool bBroadcast=sal_False); - // For querying the attribute array. + /// For querying the attribute array. inline const SwAttrSet& GetAttrSet() const { return aSet; } - // Das Doc wird jetzt am SwAttrPool gesetzt. Dadurch hat man es immer - // im Zugriff. + /** Das Doc wird jetzt am SwAttrPool gesetzt. Dadurch hat man es immer + im Zugriff. */ const SwDoc *GetDoc() const { return aSet.GetDoc(); } SwDoc *GetDoc() { return aSet.GetDoc(); } @@ -142,39 +142,39 @@ public: /// Gives access to the chart data-provider. IDocumentChartDataProviderAccess* getIDocumentChartDataProviderAccess(); - // Get and set Pool style IDs. + /// Get and set Pool style IDs. sal_uInt16 GetPoolFmtId() const { return nPoolFmtId; } void SetPoolFmtId( sal_uInt16 nId ) { nPoolFmtId = nId; } - // Get and set Help-IDs for document templates. + /// Get and set Help-IDs for document templates. sal_uInt16 GetPoolHelpId() const { return nPoolHelpId; } void SetPoolHelpId( sal_uInt16 nId ) { nPoolHelpId = nId; } sal_uInt8 GetPoolHlpFileId() const { return nPoolHlpFileId; } void SetPoolHlpFileId( sal_uInt8 nId ) { nPoolHlpFileId = nId; } - // Get attribute-description. Returns passed string. + /// Get attribute-description. Returns passed string. void GetPresentation( SfxItemPresentation ePres, SfxMapUnit eCoreMetric, SfxMapUnit ePresMetric, String &rText ) const { aSet.GetPresentation( ePres, eCoreMetric, ePresMetric, rText ); } - // Format-ID for reading/writing: + /// Format-ID for reading/writing: void ResetWritten() { bWritten = sal_False; } - // Query / set AutoFmt-flag. + /// Query / set AutoFmt-flag. sal_Bool IsAuto() const { return bAutoFmt; } void SetAuto( sal_Bool bNew = sal_False ) { bAutoFmt = bNew; } - // Query / set bAutoUpdateFmt-flag. + /// Query / set bAutoUpdateFmt-flag. sal_Bool IsAutoUpdateFmt() const { return bAutoUpdateFmt; } void SetAutoUpdateFmt( sal_Bool bNew = sal_True ) { bAutoUpdateFmt = bNew; } sal_Bool IsFmtInDTOR() const { return bFmtInDTOR; } - // GetMethods: Bool indicates whether to search only in Set (FALSE) - // or also in Parents. - // If nothing is found the defaulted attribute is returned. + /** GetMethods: Bool indicates whether to search only in Set (FALSE) + or also in Parents. + If nothing is found the defaulted attribute is returned. */ - // Character-attributes - implemented in charatr.hxx + /// Character-attributes - implemented in charatr.hxx inline const SvxPostureItem &GetPosture( sal_Bool = sal_True ) const; inline const SvxWeightItem &GetWeight( sal_Bool = sal_True ) const; inline const SvxShadowedItem &GetShadowed( sal_Bool = sal_True ) const; @@ -215,7 +215,7 @@ public: inline const SvxCharReliefItem &GetCharRelief( sal_Bool = sal_True ) const; inline const SvxCharHiddenItem &GetCharHidden( sal_Bool = sal_True ) const; - // Frame-attributes - implemented in frmatr.hxx. + /// Frame-attributes - implemented in frmatr.hxx. inline const SwFmtFillOrder &GetFillOrder( sal_Bool = sal_True ) const; inline const SwFmtFrmSize &GetFrmSize( sal_Bool = sal_True ) const; inline const SwFmtHeader &GetHeader( sal_Bool = sal_True ) const; @@ -256,7 +256,7 @@ public: // #i28701# inline const SwFmtWrapInfluenceOnObjPos& GetWrapInfluenceOnObjPos(sal_Bool = sal_True) const; - // Graphics-attributes - implemented in grfatr.hxx + /// Graphics-attributes - implemented in grfatr.hxx inline const SwMirrorGrf &GetMirrorGrf( sal_Bool = sal_True ) const; inline const SwCropGrf &GetCropGrf( sal_Bool = sal_True ) const; inline const SwRotationGrf &GetRotationGrf(sal_Bool = sal_True ) const; @@ -270,7 +270,7 @@ public: inline const SwTransparencyGrf &GetTransparencyGrf(sal_Bool = sal_True ) const; inline const SwDrawModeGrf &GetDrawModeGrf(sal_Bool = sal_True ) const; - // Paragraph-attributes - implemented in paratr.hxx. + /// Paragraph-attributes - implemented in paratr.hxx. inline const SvxLineSpacingItem &GetLineSpacing( sal_Bool = sal_True ) const; inline const SvxAdjustItem &GetAdjust( sal_Bool = sal_True ) const; inline const SvxFmtSplitItem &GetSplit( sal_Bool = sal_True ) const; @@ -288,7 +288,7 @@ public: inline const SvxParaGridItem &GetParaGrid(sal_Bool = sal_True) const; inline const SwParaConnectBorderItem &GetParaConnectBorder(sal_Bool = sal_True ) const; - // TableBox attributes - implemented in cellatr.hxx. + /// TableBox attributes - implemented in cellatr.hxx. inline const SwTblBoxNumFormat &GetTblBoxNumFmt( sal_Bool = sal_True ) const; inline const SwTblBoxFormula &GetTblBoxFormula( sal_Bool = sal_True ) const; inline const SwTblBoxValue &GetTblBoxValue( sal_Bool = sal_True ) const; diff --git a/sw/inc/frmfmt.hxx b/sw/inc/frmfmt.hxx index d0be16da0cd7..0a139fc0f10a 100644 --- a/sw/inc/frmfmt.hxx +++ b/sw/inc/frmfmt.hxx @@ -48,7 +48,7 @@ class SdrObject; class SW_DLLPUBLIC SwFrmFmt: public SwFmt { friend class SwDoc; - friend class SwPageDesc; // Is allowed to call protected CTor. + friend class SwPageDesc; ///< Is allowed to call protected CTor. ::com::sun::star::uno::WeakReference< ::com::sun::star::uno::XInterface> m_wXObject; @@ -71,41 +71,41 @@ protected: virtual void Modify( const SfxPoolItem* pOld, const SfxPoolItem* pNewValue ); public: - TYPEINFO(); // Already in base class Client. + TYPEINFO(); ///< Already in base class Client. - // Destroys all Frms in aDepend (Frms are identified via PTR_CAST). + /// Destroys all Frms in aDepend (Frms are identified via PTR_CAST). virtual void DelFrms(); - // Creates the views. + /// Creates the views. virtual void MakeFrms(); virtual Graphic MakeGraphic( ImageMap* pMap = NULL ); - // Returns the IMapObject defined at format (Fly) - // in the ImageMap at position Point. - // rPoint - test on DocPosition. - // pFly - optional FlyFrame, in case it is already known. + /** @return the IMapObject defined at format (Fly) + in the ImageMap at position Point. + rPoint - test on DocPosition. + pFly - optional FlyFrame, in case it is already known. */ IMapObject* GetIMapObject( const Point& rPoint, const SwFlyFrm *pFly = 0 ) const; - // Returns the real size of the frame - or an empty rectangle - // if no layout exists. - // If pPoint is given, look for the frame closest to it. + /** @return the real size of the frame - or an empty rectangle + if no layout exists. + If pPoint is given, look for the frame closest to it. */ SwRect FindLayoutRect( const sal_Bool bPrtArea = sal_False, const Point* pPoint = 0, const sal_Bool bCalcFrm = sal_False ) const; - // Searches SdrObject. SdrObjUserCall is client of the format. - // The UserCall knows its SdrObject. + /** Searches SdrObject. SdrObjUserCall is client of the format. + The UserCall knows its SdrObject. */ SwContact *FindContactObj(); const SwContact *FindContactObj() const { return ((SwFrmFmt*)this)->FindContactObj(); } - // Returns the SdrObject, that ist connected to the ContactObject. - // Only DrawFrmFmts are connected to the "real SdrObject". FlyFrmFmts - // are connected to a Master and all FlyFrms has the "real SdrObject". - // "Real SdrObject" has position and a Z-order. + /** @return the SdrObject, that ist connected to the ContactObject. + Only DrawFrmFmts are connected to the "real SdrObject". FlyFrmFmts + are connected to a Master and all FlyFrms has the "real SdrObject". + "Real SdrObject" has position and a Z-order. */ SdrObject *FindSdrObject(); const SdrObject *FindSdrObject() const { return ((SwFrmFmt*)this)->FindSdrObject(); } @@ -121,7 +121,7 @@ public: HORI_L2R, HORI_R2L, VERT_R2L, - VERT_L2R // Not supported yet. + VERT_L2R ///< Not supported yet. }; virtual SwFrmFmt::tLayoutDir GetLayoutDir() const; @@ -149,10 +149,10 @@ class SW_DLLPUBLIC SwFlyFrmFmt: public SwFrmFmt { friend class SwDoc; - // Both not existent. - // it stores the previous position of Prt rectangle from RequestObjectResize - // so it can be used to move frames of non-resizable objects to align them correctly - // when they get borders (this is done in SwWrtShell::CalcAndGetScale) + /** Both not existent. + it stores the previous position of Prt rectangle from RequestObjectResize + so it can be used to move frames of non-resizable objects to align them correctly + when they get borders (this is done in SwWrtShell::CalcAndGetScale) */ Point m_aLastFlyFrmPrtRectPos; SwFlyFrmFmt( const SwFlyFrmFmt &rCpy ); @@ -172,7 +172,7 @@ public: TYPEINFO(); ~SwFlyFrmFmt(); - // Creates the views. + /// Creates the views. virtual void MakeFrms(); SwFlyFrm* GetFrm( const Point* pDocPos = 0, @@ -233,7 +233,7 @@ class SW_DLLPUBLIC SwDrawFrmFmt: public SwFrmFmt mutable const SdrObject * pSdrObjCached; mutable String sSdrObjCachedComment; - // Both not existent. + /// Both not existent. SwDrawFrmFmt( const SwDrawFrmFmt &rCpy ); SwDrawFrmFmt &operator=( const SwDrawFrmFmt &rCpy ); @@ -271,12 +271,12 @@ public: TYPEINFO(); ~SwDrawFrmFmt(); - // DrawObjects are removed from the arrays at the layout. - // The DrawObjects are marked as deleted. + /** DrawObjects are removed from the arrays at the layout. + The DrawObjects are marked as deleted. */ virtual void DelFrms(); - // Register DrawObjects in the arrays at layout. - // Reset delete marks. + /** Register DrawObjects in the arrays at layout. + Reset delete marks. */ virtual void MakeFrms(); virtual Graphic MakeGraphic( ImageMap* pMap = NULL ); diff --git a/sw/inc/hhcwrp.hxx b/sw/inc/hhcwrp.hxx index 2ce56e3d38ee..8f33df4e0217 100644 --- a/sw/inc/hhcwrp.hxx +++ b/sw/inc/hhcwrp.hxx @@ -35,36 +35,36 @@ class SwHHCWrapper : public editeng::HangulHanjaConversion Window* pWin; SwWrtShell &rWrtShell; - SwConversionArgs *pConvArgs; // object for arguments (and results) needed - // to find of next convertible text portion + SwConversionArgs *pConvArgs; /**< object for arguments (and results) needed + to find of next convertible text portion */ - xub_StrLen nLastPos; // starting position of the last found text part - // (needs to be sth that gets not moved like - // SwPaM or SwPosition by replace operations!) + xub_StrLen nLastPos; /**< starting position of the last found text part + (needs to be sth that gets not moved like + SwPaM or SwPosition by replace operations!) */ sal_Int32 nUnitOffset; - sal_uInt16 nPageCount; // page count for progress bar - sal_uInt16 nPageStart; // first checked page + sal_uInt16 nPageCount; ///< page count for progress bar + sal_uInt16 nPageStart; ///< first checked page sal_Bool bIsDrawObj; sal_Bool bIsStart; sal_Bool bIsOtherCntnt; sal_Bool bStartChk; - sal_Bool bIsSelection; // true if only the selected text should be converted - sal_Bool bInfoBox; // true if message should be displayed at the end - sal_Bool bIsConvSpecial; // true if special regions: header, footer, ... should be converted + sal_Bool bIsSelection; ///< true if only the selected text should be converted + sal_Bool bInfoBox; ///< true if message should be displayed at the end + sal_Bool bIsConvSpecial; ///< true if special regions: header, footer, ... should be converted sal_Bool bStartDone; sal_Bool bEndDone; - // from SvxSpellWrapper copied and modified - sal_Bool ConvNext_impl(); // former SpellNext - sal_Bool FindConvText_impl(); // former FindSpellError + /// from SvxSpellWrapper copied and modified + sal_Bool ConvNext_impl(); ///< former SpellNext + sal_Bool FindConvText_impl(); ///< former FindSpellError - // from SwSpellWrapper copied and modified + /// from SwSpellWrapper copied and modified sal_Bool HasOtherCnt_impl(); - void ConvStart_impl( SwConversionArgs *pConvArgs, SvxSpellArea eSpell ); // former SpellStart - void ConvEnd_impl( SwConversionArgs *pConvArgs ); // former SpellEnd - sal_Bool ConvContinue_impl( SwConversionArgs *pConvArgs ); // former SpellContinue + void ConvStart_impl( SwConversionArgs *pConvArgs, SvxSpellArea eSpell ); ///< former SpellStart + void ConvEnd_impl( SwConversionArgs *pConvArgs ); ///< former SpellEnd + sal_Bool ConvContinue_impl( SwConversionArgs *pConvArgs ); ///< former SpellContinue void SelectNewUnit_impl( const sal_Int32 nUnitStart, const sal_Int32 nUnitEnd ); diff --git a/sw/inc/hints.hxx b/sw/inc/hints.hxx index 4f1bb283d50b..90434141e5fd 100644 --- a/sw/inc/hints.hxx +++ b/sw/inc/hints.hxx @@ -118,18 +118,18 @@ public: }; -// SwRefMarkFldUpdate is sent when the referencemarks should be updated. -// To determine Page- / chapternumbers the current frame has to be asked. -// For this we need the current outputdevice +/** SwRefMarkFldUpdate is sent when the referencemarks should be updated. + To determine Page- / chapternumbers the current frame has to be asked. + For this we need the current outputdevice */ class SwRefMarkFldUpdate : public SwMsgPoolItem { public: - const OutputDevice* pOut; // pointer to the current output device + const OutputDevice* pOut; ///< pointer to the current output device SwRefMarkFldUpdate( const OutputDevice* ); }; -// SwDocPosUpdate is sent to signal that only the frames from or to a specified document-global position -// have to be updated. At the moment this is only needed when updating pagenumber fields. +/** SwDocPosUpdate is sent to signal that only the frames from or to a specified document-global position + have to be updated. At the moment this is only needed when updating pagenumber fields. */ class SwDocPosUpdate : public SwMsgPoolItem { public: @@ -137,7 +137,7 @@ public: SwDocPosUpdate( const long nDocPos ); }; -// SwTableFmlUpdate is sent when the table has to be newly calculated or when a table itself is merged or splitted +/// SwTableFmlUpdate is sent when the table has to be newly calculated or when a table itself is merged or splitted enum TableFmlUpdtFlags { TBL_CALC = 0, TBL_BOXNAME, TBL_BOXPTR, @@ -148,13 +148,13 @@ enum TableFmlUpdtFlags { TBL_CALC = 0, class SwTableFmlUpdate : public SwMsgPoolItem { public: - const SwTable* pTbl; // Pointer to the current table + const SwTable* pTbl; ///< Pointer to the current table union { - const SwTable* pDelTbl; // Merge: Pointer to the table to be removed - const String* pNewTblNm; // Split: the name of the new table + const SwTable* pDelTbl; ///< Merge: Pointer to the table to be removed + const String* pNewTblNm; ///< Split: the name of the new table } DATA; SwHistory* pHistory; - sal_uInt16 nSplitLine; // Split: from this BaseLine on will be splitted + sal_uInt16 nSplitLine; ///< Split: from this BaseLine on will be splitted TableFmlUpdtFlags eFlags; sal_Bool bModified : 1; sal_Bool bBehindSplitLine : 1; @@ -179,18 +179,18 @@ public: class SwAttrSetChg: public SwMsgPoolItem { sal_Bool bDelSet; - SwAttrSet* pChgSet; // what has changed - const SwAttrSet* pTheChgdSet; // is only used to compare + SwAttrSet* pChgSet; ///< what has changed + const SwAttrSet* pTheChgdSet; ///< is only used to compare public: SwAttrSetChg( const SwAttrSet& rTheSet, SwAttrSet& rSet ); SwAttrSetChg( const SwAttrSetChg& ); ~SwAttrSetChg(); - // What has changed + /// What has changed const SwAttrSet* GetChgSet() const { return pChgSet; } SwAttrSet* GetChgSet() { return pChgSet; } - // Where it has changed + /// Where it has changed const SwAttrSet* GetTheChgdSet() const { return pTheChgdSet; } sal_uInt16 Count() const { return pChgSet->Count(); } @@ -214,8 +214,8 @@ class SwVirtPageNumInfo: public SwMsgPoolItem const SwPageFrm *pPage; const SwPageFrm *pOrigPage; const SwFrm *pFrm; - // Multiple attributes can be attached to a single paragraph / table - // The frame, in the end, has to decide which attribute takes effect and which physical page it involves + /** Multiple attributes can be attached to a single paragraph / table + The frame, in the end, has to decide which attribute takes effect and which physical page it involves */ public: SwVirtPageNumInfo( const SwPageFrm *pPg ); diff --git a/sw/inc/htmltbl.hxx b/sw/inc/htmltbl.hxx index 4016dba7f833..a3c06d2780c8 100644 --- a/sw/inc/htmltbl.hxx +++ b/sw/inc/htmltbl.hxx @@ -34,7 +34,7 @@ #include <editeng/svxenum.hxx> #include "swtypes.hxx" -#include "node.hxx" // For SwStartNode +#include "node.hxx" ///< For SwStartNode class SwTableBox; @@ -47,24 +47,24 @@ class SwFrmFmt; class SwHTMLTableLayoutCnts { - SwHTMLTableLayoutCnts *pNext; // The next content. + SwHTMLTableLayoutCnts *pNext; ///< The next content. - // Only one of the following two pointers may be set! - SwTableBox *pBox; // A Box. - SwHTMLTableLayout *pTable; // A "table within a table". + /// Only one of the following two pointers may be set! + SwTableBox *pBox; ///< A Box. + SwHTMLTableLayout *pTable; ///< A "table within a table". - // During first run there are still no boxes. In this case - // pStartNode is used instead of pBox. + /** During first run there are still no boxes. In this case + pStartNode is used instead of pBox. */ const SwStartNode *pStartNode; - // The following counters indicate how often a pass has been - // done for this content. Therefore they are compared against - // a reference value. If 255 is reached the continue with 0. - // This avoids reinitialization on every resize. - sal_uInt8 nPass1Done; // How many times has Pass 1 been called? - sal_uInt8 nWidthSet; // How many times has the width been set? + /** The following counters indicate how often a pass has been + done for this content. Therefore they are compared against + a reference value. If 255 is reached the continue with 0. + This avoids reinitialization on every resize. */ + sal_uInt8 nPass1Done; ///< How many times has Pass 1 been called? + sal_uInt8 nWidthSet; ///< How many times has the width been set? - sal_Bool bNoBreakTag; // <NOBR>-Tag over complete content. + sal_Bool bNoBreakTag; ///< <NOBR>-Tag over complete content. public: @@ -80,7 +80,7 @@ public: const SwStartNode *GetStartNode() const; - // Calculation of next node. + /// Calculation of next node. SwHTMLTableLayoutCnts *GetNext() const { return pNext; } void SetWidthSet( sal_uInt8 nRef ) { nWidthSet = nRef; } @@ -94,14 +94,14 @@ public: class SwHTMLTableLayoutCell { - SwHTMLTableLayoutCnts *pContents; // Content of cell. + SwHTMLTableLayoutCnts *pContents; ///< Content of cell. - sal_uInt16 nRowSpan; // ROWSPAN of cell. - sal_uInt16 nColSpan; // COLSPAN of cell. - sal_uInt16 nWidthOption;// Given width of cell in Twip or %. + sal_uInt16 nRowSpan; ///< ROWSPAN of cell. + sal_uInt16 nColSpan; ///< COLSPAN of cell. + sal_uInt16 nWidthOption; ///< Given width of cell in Twip or %. - sal_Bool bPrcWidthOption : 1;// nWidth is %-value. - sal_Bool bNoWrapOption : 1; // NOWRAP-option. + sal_Bool bPrcWidthOption : 1; ///< nWidth is %-value. + sal_Bool bNoWrapOption : 1; ///< NOWRAP-option. public: @@ -112,13 +112,13 @@ public: ~SwHTMLTableLayoutCell(); - // Set or get content of a cell. + /// Set or get content of a cell. void SetContents( SwHTMLTableLayoutCnts *pCnts ) { pContents = pCnts; } SwHTMLTableLayoutCnts *GetContents() const { return pContents; } inline void SetProtected(); - // Set or get ROWSPAN/COLSPAN of cell. + /// Set or get ROWSPAN/COLSPAN of cell. void SetRowSpan( sal_uInt16 nRSpan ) { nRowSpan = nRSpan; } sal_uInt16 GetRowSpan() const { return nRowSpan; } sal_uInt16 GetColSpan() const { return nColSpan; } @@ -132,17 +132,17 @@ public: class SwHTMLTableLayoutColumn { - // Interim values of AutoLayoutPass1, + /// Interim values of AutoLayoutPass1, sal_uLong nMinNoAlign, nMaxNoAlign, nAbsMinNoAlign; - // Results of AutoLayoutPass1 + /// Results of AutoLayoutPass1 sal_uLong nMin, nMax; - // Results of Pass 2. - sal_uInt16 nAbsColWidth; // In Twips. - sal_uInt16 nRelColWidth; // In Twips or relative to USHRT_MAX. + /// Results of Pass 2. + sal_uInt16 nAbsColWidth; ///< In Twips. + sal_uInt16 nRelColWidth; ///< In Twips or relative to USHRT_MAX. - sal_uInt16 nWidthOption; // Options of <COL> or <TD>/<TH>. + sal_uInt16 nWidthOption; ///< Options of <COL> or <TD>/<TH>. sal_Bool bRelWidthOption : 1; sal_Bool bLeftBorder : 1; @@ -184,37 +184,37 @@ public: class SwHTMLTableLayout { - Timer aResizeTimer; // Timer for DelayedResize. + Timer aResizeTimer; ///< Timer for DelayedResize. SwHTMLTableLayoutColumn **aColumns; SwHTMLTableLayoutCell **aCells; - const SwTable *pSwTable; // SwTable (Top-Table only). - SwTableBox *pLeftFillerBox; // Left filler-box (table in table only). - SwTableBox *pRightFillerBox; // Right filler-box (table in Table only). + const SwTable *pSwTable; ///< SwTable (Top-Table only). + SwTableBox *pLeftFillerBox; ///< Left filler-box (table in table only). + SwTableBox *pRightFillerBox; ///< Right filler-box (table in Table only). - sal_uLong nMin; // Minimal width of table (Twips). - sal_uLong nMax; // Maximal width of table (Twips). + sal_uLong nMin; ///< Minimal width of table (Twips). + sal_uLong nMax; ///< Maximal width of table (Twips). - sal_uInt16 nRows; // Row count. - sal_uInt16 nCols; // Column count. + sal_uInt16 nRows; ///< Row count. + sal_uInt16 nCols; ///< Column count. - sal_uInt16 nLeftMargin; // Space to left margin (from paragraph). - sal_uInt16 nRightMargin; // Space to left margin (from paragraph). + sal_uInt16 nLeftMargin; ///< Space to left margin (from paragraph). + sal_uInt16 nRightMargin; ///< Space to left margin (from paragraph). - sal_uInt16 nInhAbsLeftSpace; // Space inherited from surrounding box - sal_uInt16 nInhAbsRightSpace; // that was added to boxes. + sal_uInt16 nInhAbsLeftSpace; ///< Space inherited from surrounding box + sal_uInt16 nInhAbsRightSpace; ///< that was added to boxes. - sal_uInt16 nRelLeftFill; // Width of boxes relative to alignment - sal_uInt16 nRelRightFill; // of tables in tables. + sal_uInt16 nRelLeftFill; ///< Width of boxes relative to alignment + sal_uInt16 nRelRightFill; ///< of tables in tables. - sal_uInt16 nRelTabWidth; // Relative width of table. + sal_uInt16 nRelTabWidth; ///< Relative width of table. - sal_uInt16 nWidthOption; // Width of table (in Twips oder %). - sal_uInt16 nCellPadding; // Space to contents (in Twips). - sal_uInt16 nCellSpacing; // Cell spacing (in Twips). - sal_uInt16 nBorder; // Line strength of outer border, or rather the - // space needed for it as calculated by Netscape. + sal_uInt16 nWidthOption; ///< Width of table (in Twips oder %). + sal_uInt16 nCellPadding; ///< Space to contents (in Twips). + sal_uInt16 nCellSpacing; ///< Cell spacing (in Twips). + sal_uInt16 nBorder; /** Line strength of outer border, or rather the + space needed for it as calculated by Netscape. */ sal_uInt16 nLeftBorderWidth; sal_uInt16 nRightBorderWidth; @@ -222,27 +222,27 @@ class SwHTMLTableLayout sal_uInt16 nInhRightBorderWidth; sal_uInt16 nBorderWidth; - sal_uInt16 nDelayedResizeAbsAvail; // Param for delayed Resize. + sal_uInt16 nDelayedResizeAbsAvail; ///< Param for delayed Resize. sal_uInt16 nLastResizeAbsAvail; - sal_uInt8 nPass1Done; // Reference-values for - sal_uInt8 nWidthSet; // the runs through loop. + sal_uInt8 nPass1Done; ///< Reference-values for + sal_uInt8 nWidthSet; ///< the runs through loop. - SvxAdjust eTableAdjust; // Alignment of table. + SvxAdjust eTableAdjust; ///< Alignment of table. - sal_Bool bColsOption : 1; // Table has a COLS-option. - sal_Bool bColTags : 1; // Tabelle has COL/COLGRP-tags. - sal_Bool bPrcWidthOption : 1; // Width is given in percent. - sal_Bool bUseRelWidth : 1; // SwTable gets relative width. + sal_Bool bColsOption : 1; ///< Table has a COLS-option. + sal_Bool bColTags : 1; ///< Tabelle has COL/COLGRP-tags. + sal_Bool bPrcWidthOption : 1; ///< Width is given in percent. + sal_Bool bUseRelWidth : 1; ///< SwTable gets relative width. - sal_Bool bMustResize : 1; // Table width must be defined. - sal_Bool bExportable : 1; // Layout may be used for export. - sal_Bool bBordersChanged : 1; // Borders have been changed. - sal_Bool bMayBeInFlyFrame : 1; // Table could be within frame. + sal_Bool bMustResize : 1; ///< Table width must be defined. + sal_Bool bExportable : 1; ///< Layout may be used for export. + sal_Bool bBordersChanged : 1; ///< Borders have been changed. + sal_Bool bMayBeInFlyFrame : 1; ///< Table could be within frame. - sal_Bool bDelayedResizeRecalc : 1; // Param for delayed Resize. - sal_Bool bMustNotResize : 1; // Table may not be resized. - sal_Bool bMustNotRecalc : 1; // Table may not be adapted to its contents. + sal_Bool bDelayedResizeRecalc : 1; ///< Param for delayed Resize. + sal_Bool bMustNotResize : 1; ///< Table may not be resized. + sal_Bool bMustNotRecalc : 1; ///< Table may not be adapted to its contents. void AddBorderWidth( sal_uLong &rMin, sal_uLong &rMax, sal_uLong& rAbsMin, sal_uInt16 nCol, sal_uInt16 nColSpan, @@ -318,34 +318,34 @@ public: void SetMustNotResize( sal_Bool bSet ) { bMustNotResize = bSet; } void SetMustNotRecalc( sal_Bool bSet ) { bMustNotRecalc = bSet; } - // Recalculation of table widths for available width that has been passed. - // - If bRecalc is set, contents of boxes are included into calculation. - // - If bForce is set, table will be recalculated even if this was - // disallowed by SetMustNotResize. - // - If nDelay > 0 the calculation is delayed accordingly. Resizing calls - // occuring during delay-time are ignored, but the delay may be counted - // under certain circumstances. - // - If nDelay == HTMLTABLE_RESIZE_NOW, resize immediately and do not - // consider any resize-calls that might possibly be in order. - // - The return value indicates whether the table has been changed. + /** Recalculation of table widths for available width that has been passed. + - If bRecalc is set, contents of boxes are included into calculation. + - If bForce is set, table will be recalculated even if this was + disallowed by SetMustNotResize. + - If nDelay > 0 the calculation is delayed accordingly. Resizing calls + occuring during delay-time are ignored, but the delay may be counted + under certain circumstances. + - If nDelay == HTMLTABLE_RESIZE_NOW, resize immediately and do not + consider any resize-calls that might possibly be in order. + - The return value indicates whether the table has been changed. */ sal_Bool Resize( sal_uInt16 nAbsAvail, sal_Bool bRecalc=sal_False, sal_Bool bForce=sal_False, sal_uLong nDelay=0 ); void BordersChanged( sal_uInt16 nAbsAvail, sal_Bool bRecalc=sal_False ); - // Calculate available width. This works only if a layout or a - // ViewShell exists. Otherwise returns 0. - // This is needed by HTML-filter because it doesn't have access to the layout.) + /** Calculate available width. This works only if a layout or a + ViewShell exists. Otherwise returns 0. + This is needed by HTML-filter because it doesn't have access to the layout.) */ static sal_uInt16 GetBrowseWidth( const SwDoc& rDoc ); - // Calculates available width by table-frame. + /// Calculates available width by table-frame. sal_uInt16 GetBrowseWidthByTabFrm( const SwTabFrm& rTabFrm ) const; - // Calculates available width by the table-frame or - // static GetBrowseWidth if no layout exists. + /** Calculates available width by the table-frame or + static GetBrowseWidth if no layout exists. */ sal_uInt16 GetBrowseWidthByTable( const SwDoc& rDoc ) const; - // For Export. + /// For Export. sal_uInt16 GetWidthOption() const { return nWidthOption; } sal_Bool HasPrcWidthOption() const { return bPrcWidthOption; } diff --git a/sw/inc/iodetect.hxx b/sw/inc/iodetect.hxx index cc58b29a24b3..73bde8c3bffc 100644 --- a/sw/inc/iodetect.hxx +++ b/sw/inc/iodetect.hxx @@ -36,15 +36,15 @@ #include <tools/string.hxx> #include <swddllapi.h> -#define FILTER_RTF "RTF" // RTF filter +#define FILTER_RTF "RTF" ///< RTF filter #define sRtfWH "WH_RTF" -#define FILTER_TEXT "TEXT" // text filter with default codeset -#define FILTER_BAS "BAS" // StarBasic (identical to ANSI) -#define FILTER_WW8 "CWW8" // WinWord 97 filter -#define FILTER_TEXT_DLG "TEXT_DLG" // text filter with encoding dialog -#define FILTER_XML "CXML" // XML filter -#define FILTER_XMLV "CXMLV" // XML filter -#define FILTER_XMLVW "CXMLVWEB" // XML filter +#define FILTER_TEXT "TEXT" ///< text filter with default codeset +#define FILTER_BAS "BAS" ///< StarBasic (identical to ANSI) +#define FILTER_WW8 "CWW8" ///< WinWord 97 filter +#define FILTER_TEXT_DLG "TEXT_DLG" ///< text filter with encoding dialog +#define FILTER_XML "CXML" ///< XML filter +#define FILTER_XMLV "CXMLV" ///< XML filter +#define FILTER_XMLVW "CXMLVWEB" ///< XML filter #define sHTML "HTML" #define sWW1 "WW1" #define sWW5 "WW6" @@ -88,29 +88,29 @@ enum ReaderWriterEnum { extern SWD_DLLPUBLIC SwIoDetect aFilterDetect[]; -// The following class is a wrapper for basic i/o functions of Writer 3.0. -// Everything is static. All filter names mentioned are Writer-internal -// names, i.e. the names in front of the equality sign in INSTALL.INI, like SWG -// or ASCII. +/** The following class is a wrapper for basic i/o functions of Writer 3.0. + Everything is static. All filter names mentioned are Writer-internal + names, i.e. the names in front of the equality sign in INSTALL.INI, like SWG + or ASCII.*/ class SwIoSystem { public: - // find for an internal format name the corresponding filter entry + /// find for an internal format name the corresponding filter entry SWD_DLLPUBLIC static const SfxFilter* GetFilterOfFormat( const String& rFormat, const SfxFilterContainer* pCnt = 0 ); - // Detect for the given file which filter should be used. The filter name - // is returned. If no filter could be found, the name of the ASCII filter - // is returned! + /** Detect for the given file which filter should be used. The filter name + is returned. If no filter could be found, the name of the ASCII filter + is returned! */ SWD_DLLPUBLIC static const SfxFilter* GetFileFilter( const String& rFileName, const String& rPrefFltName, SfxMedium* pMedium = 0 ); - // Detect whether the given file is in the given format. - // For now, only our own filters are supported! + /** Detect whether the given file is in the given format. + For now, only our own filters are supported! */ static sal_Bool IsFileFilter( SfxMedium& rMedium, const String& rFmtName, const SfxFilter** ppFlt = 0 ); diff --git a/sw/inc/istyleaccess.hxx b/sw/inc/istyleaccess.hxx index 0fd66bf85d36..cbd54511b127 100644 --- a/sw/inc/istyleaccess.hxx +++ b/sw/inc/istyleaccess.hxx @@ -44,15 +44,15 @@ public: SwAutoStyleFamily eFamily ) = 0; virtual void getAllStyles( std::vector<StylePool::SfxItemSet_Pointer_t> &rStyles, SwAutoStyleFamily eFamily ) = 0; - // It's slow to iterate through a stylepool looking for a special name, but if - // the style has been inserted via "cacheAutomaticStyle" instead of "getAutomaticStyle", - // it's faster + /** It's slow to iterate through a stylepool looking for a special name, but if + the style has been inserted via "cacheAutomaticStyle" instead of "getAutomaticStyle", + it's faster */ virtual StylePool::SfxItemSet_Pointer_t getByName( const rtl::OUString& rName, SwAutoStyleFamily eFamily ) = 0; - // insert the style to the pool and the cache (used during import) + /// insert the style to the pool and the cache (used during import) virtual StylePool::SfxItemSet_Pointer_t cacheAutomaticStyle( const SfxItemSet& rSet, SwAutoStyleFamily eFamily ) = 0; - // To release the cached styles (shared_pointer!) + /// To release the cached styles (shared_pointer!) virtual void clearCaches() = 0; }; diff --git a/sw/inc/lineinfo.hxx b/sw/inc/lineinfo.hxx index ec7b1c48985e..8dcb73255bc6 100644 --- a/sw/inc/lineinfo.hxx +++ b/sw/inc/lineinfo.hxx @@ -34,21 +34,21 @@ enum LineNumberPosition LINENUMBER_POS_OUTSIDE }; -class SW_DLLPUBLIC SwLineNumberInfo : public SwClient //purpose of derivation from SwClient: - //character style for displaying the numbers. +class SW_DLLPUBLIC SwLineNumberInfo : public SwClient /**< purpose of derivation from SwClient: + character style for displaying the numbers. */ { - SvxNumberType aType; //e.g. roman linenumbers - String aDivider; //String for aditional interval (vert. lines user defined) - sal_uInt16 nPosFromLeft; //Position for paint - sal_uInt16 nCountBy; //Paint only for every n line - sal_uInt16 nDividerCountBy; //Interval for display of an user defined - //string every n lines - LineNumberPosition ePos; //Where should the display occur (number and divicer) - sal_Bool bPaintLineNumbers; //Should anything be displayed? - sal_Bool bCountBlankLines; //Count empty lines? - sal_Bool bCountInFlys; //Count also within FlyFrames? - sal_Bool bRestartEachPage; //Restart counting at the first paragraph of each page - //(even on follows when paragraphs are splitted) + SvxNumberType aType; ///< e.g. roman linenumbers + String aDivider; ///< String for aditional interval (vert. lines user defined) + sal_uInt16 nPosFromLeft; ///< Position for paint + sal_uInt16 nCountBy; ///< Paint only for every n line + sal_uInt16 nDividerCountBy; /**< Interval for display of an user defined + string every n lines */ + LineNumberPosition ePos; ///< Where should the display occur (number and divicer) + sal_Bool bPaintLineNumbers; ///< Should anything be displayed? + sal_Bool bCountBlankLines; ///< Count empty lines? + sal_Bool bCountInFlys; ///< Count also within FlyFrames? + sal_Bool bRestartEachPage; /**< Restart counting at the first paragraph of each page + (even on follows when paragraphs are splitted) */ protected: virtual void Modify( const SfxPoolItem*, const SfxPoolItem* ); diff --git a/sw/inc/ndarr.hxx b/sw/inc/ndarr.hxx index 051476856231..2f393af73bd0 100644 --- a/sw/inc/ndarr.hxx +++ b/sw/inc/ndarr.hxx @@ -101,27 +101,27 @@ class SW_DLLPUBLIC SwNodes friend class SwNode; friend class SwNodeIndex; - SwNodeIndex* pRoot; // List of all indices on nodes. + SwNodeIndex* pRoot; ///< List of all indices on nodes. void InsertNode( const SwNodePtr pNode, const SwNodeIndex& rPos ); void InsertNode( const SwNodePtr pNode, sal_uLong nPos ); - SwDoc* pMyDoc; // This Doc contains the nodes-array. + SwDoc* pMyDoc; ///< This Doc contains the nodes-array. - SwNode *pEndOfPostIts, *pEndOfInserts, // These are the fixed ranges. + SwNode *pEndOfPostIts, *pEndOfInserts, ///< These are the fixed ranges. *pEndOfAutotext, *pEndOfRedlines, *pEndOfContent; - mutable SwOutlineNodes* pOutlineNds; // Array of all outline nodes. + mutable SwOutlineNodes* pOutlineNds; ///< Array of all outline nodes. - sal_Bool bInNodesDel : 1; // In Case of recursive calling. - // Do not update Num/Outline. - sal_Bool bInDelUpdOutl : 1; // Flag for updating of Outline. - sal_Bool bInDelUpdNum : 1; // Flag for updating of Outline. + sal_Bool bInNodesDel : 1; /**< In Case of recursive calling. + Do not update Num/Outline. */ + sal_Bool bInDelUpdOutl : 1; ///< Flag for updating of Outline. + sal_Bool bInDelUpdNum : 1; ///< Flag for updating of Outline. - // For administering indices. + /// For administering indices. void RegisterIndex( SwNodeIndex& rIdx ); void DeRegisterIndex( SwNodeIndex& rIdx ); void RemoveNode( sal_uLong nDelPos, sal_uLong nLen, sal_Bool bDel ); @@ -133,7 +133,7 @@ class SW_DLLPUBLIC SwNodes void ChgNode( SwNodeIndex& rDelPos, sal_uLong nSize, SwNodeIndex& rInsPos, sal_Bool bNewFrms ); - void UpdtOutlineIdx( const SwNode& ); // Update all OutlineNodes starting from Node. + void UpdtOutlineIdx( const SwNode& ); ///< Update all OutlineNodes starting from Node. void _CopyNodes( const SwNodeRange&, const SwNodeIndex&, sal_Bool bNewFrms = sal_True, sal_Bool bTblInsDummyNode = sal_False ) const; @@ -164,22 +164,22 @@ public: void ForEach( const SwNodeIndex& rStart, const SwNodeIndex& rEnd, FnForEach_SwNodes fnForEach, void* pArgs = 0 ); - // A still empty section. + /// A still empty section. SwNode& GetEndOfPostIts() const { return *pEndOfPostIts; } - // Section fpr all footnotes. + /// Section fpr all footnotes. SwNode& GetEndOfInserts() const { return *pEndOfInserts; } - // Section for all Flys/Header/Footers. + /// Section for all Flys/Header/Footers. SwNode& GetEndOfAutotext() const { return *pEndOfAutotext; } - // Section for all Redlines. + /// Section for all Redlines. SwNode& GetEndOfRedlines() const { return *pEndOfRedlines; } - // This is the last EndNode of a special section. After it - // there is only the regular ContentSection (i.e. the BodyText). + /** This is the last EndNode of a special section. After it + there is only the regular ContentSection (i.e. the BodyText). */ SwNode& GetEndOfExtras() const { return *pEndOfRedlines; } - // Regular ContentSection (i.e. the BodyText). + /// Regular ContentSection (i.e. the BodyText). SwNode& GetEndOfContent() const { return *pEndOfContent; } - // Is the NodesArray the regular one of Doc? (and not the UndoNds, ...) - // Implementation in doc.hxx (because one needs to know Doc for it) ! + /** Is the NodesArray the regular one of Doc? (and not the UndoNds, ...) + Implementation in doc.hxx (because one needs to know Doc for it) ! */ sal_Bool IsDocNodes() const; sal_uInt16 GetSectionLevel(const SwNodeIndex &rIndex) const; @@ -204,28 +204,28 @@ public: SwCntntNode* GoNext(SwNodeIndex *) const; SwCntntNode* GoPrevious(SwNodeIndex *) const; - // Go to next/previous Cntnt/Table-node for which LayoutFrames exist. - // While doing this do not leave Header/Footer/Frame etc. + /** Go to next/previous Cntnt/Table-node for which LayoutFrames exist. + While doing this do not leave Header/Footer/Frame etc. */ SwNode* GoNextWithFrm(SwNodeIndex *) const; SwNode* GoPreviousWithFrm(SwNodeIndex *) const; - // Go to next content-node that is not protected or hidden - // (Both set FALSE ==> GoNext/GoPrevious!!!). + /** Go to next content-node that is not protected or hidden + (Both set FALSE ==> GoNext/GoPrevious!!!). */ SwCntntNode* GoNextSection( SwNodeIndex *, int bSkipHidden = sal_True, int bSkipProtect = sal_True ) const; SwCntntNode* GoPrevSection( SwNodeIndex *, int bSkipHidden = sal_True, int bSkipProtect = sal_True ) const; - // Create an empty section of Start- and EndNote. It may be called - // only if a new section with content is to be created, - // e.g. at filters/Undo/... + /** Create an empty section of Start- and EndNote. It may be called + only if a new section with content is to be created, + e.g. at filters/Undo/... */ SwStartNode* MakeEmptySection( const SwNodeIndex& rIdx, SwStartNodeType = SwNormalStartNode ); - // Implementations of "Make...Node" are in the given .cxx-files. + /// Implementations of "Make...Node" are in the given .cxx-files. SwTxtNode *MakeTxtNode( const SwNodeIndex & rWhere, SwTxtFmtColl *pColl, - SwAttrSet* pAutoAttr = 0 ); // in ndtxt.cxx + SwAttrSet* pAutoAttr = 0 ); ///< in ndtxt.cxx SwStartNode* MakeTextSection( const SwNodeIndex & rWhere, SwStartNodeType eSttNdTyp, SwTxtFmtColl *pColl, @@ -237,38 +237,38 @@ public: const Graphic* pGraphic, SwGrfFmtColl *pColl, SwAttrSet* pAutoAttr = 0, - sal_Bool bDelayed = sal_False ); // in ndgrf.cxx + sal_Bool bDelayed = sal_False ); ///< in ndgrf.cxx SwGrfNode *MakeGrfNode( const SwNodeIndex & rWhere, const GraphicObject& rGrfObj, SwGrfFmtColl *pColl, - SwAttrSet* pAutoAttr = 0 ); // in ndgrf.cxx + SwAttrSet* pAutoAttr = 0 ); ///< in ndgrf.cxx SwOLENode *MakeOLENode( const SwNodeIndex & rWhere, const svt::EmbeddedObjectRef&, SwGrfFmtColl *pColl, - SwAttrSet* pAutoAttr = 0 ); // in ndole.cxx + SwAttrSet* pAutoAttr = 0 ); ///< in ndole.cxx SwOLENode *MakeOLENode( const SwNodeIndex & rWhere, const String &rName, sal_Int64 nAspect, SwGrfFmtColl *pColl, - SwAttrSet* pAutoAttr ); // in ndole.cxx + SwAttrSet* pAutoAttr ); ///< in ndole.cxx - // Array of all OutlineNodes. + /// Array of all OutlineNodes. const SwOutlineNodes& GetOutLineNds() const; //void UpdateOutlineNode( const SwNode&, sal_uInt8 nOldLevel, sal_uInt8 nNewLevel );//#outline level,removed by zhaojianwei - // Update all Nodes - Rule/Format-Change. + /// Update all Nodes - Rule/Format-Change. void UpdateOutlineNode(SwNode & rNd); - // Insert nodes for tables. If Lines is given, create the matrix - // from lines and boxes, else only the count of boxes. + /** Insert nodes for tables. If Lines is given, create the matrix + from lines and boxes, else only the count of boxes. - // New parameter pAttrSet: If pAttrSet is non-null and contains an - // adjust item it is propagated to the table cells. If there is an - // adjust in pCntntTxtColl or pHeadlineTxtColl this adjust item - // overrides the item in pAttrSet. + New parameter pAttrSet: If pAttrSet is non-null and contains an + adjust item it is propagated to the table cells. If there is an + adjust in pCntntTxtColl or pHeadlineTxtColl this adjust item + overrides the item in pAttrSet. */ SwTableNode* InsertTable( const SwNodeIndex& rNdIdx, sal_uInt16 nBoxes, SwTxtFmtColl* pCntntTxtColl, @@ -276,7 +276,7 @@ public: SwTxtFmtColl* pHeadlineTxtColl = 0, const SwAttrSet * pAttrSet = 0); - // Create balanced table from selected range. + /// Create balanced table from selected range. SwTableNode* TextToTable( const SwNodeRange& rRange, sal_Unicode cCh, SwTableFmt* pTblFmt, SwTableLineFmt* pLineFmt, @@ -286,7 +286,7 @@ public: SwNodeRange * ExpandRangeForTableBox(const SwNodeRange & rRange); - //create a table from a vector of NodeRanges - API support + /// create a table from a vector of NodeRanges - API support SwTableNode* TextToTable( const TableRanges_t& rTableNodes, SwTableFmt* pTblFmt, SwTableLineFmt* pLineFmt, @@ -295,33 +295,33 @@ public: /*, SwUndo... pUndo*/ ); - // Create regular text from what was table. + /// Create regular text from what was table. sal_Bool TableToText( const SwNodeRange& rRange, sal_Unicode cCh, SwUndoTblToTxt* = 0 ); - // Is in untbl.cxx and may called only by Undo-object. + /// Is in untbl.cxx and may called only by Undo-object. SwTableNode* UndoTableToText( sal_uLong nStt, sal_uLong nEnd, const SwTblToTxtSaves& rSavedData ); - // Insert a new box in the line before InsPos. Its format - // is taken from the following one (or from the previous one if we are - // at the end). In the line there must be a box already. + /** Insert a new box in the line before InsPos. Its format + is taken from the following one (or from the previous one if we are + at the end). In the line there must be a box already. */ sal_Bool InsBoxen( SwTableNode*, SwTableLine*, SwTableBoxFmt*, - // Formats for TextNode of box. + /// Formats for TextNode of box. SwTxtFmtColl*, const SfxItemSet* pAutoAttr, sal_uInt16 nInsPos, sal_uInt16 nCnt = 1 ); - // Splits a table at the base-line which contains the index. - // All base lines behind it are moved to a new table/ -node. - // Is the flag bCalcNewSize set to TRUE, the new SSize for both - // tables is calculated from the Maximum of the boxes, provided - // SSize is set "absolute" (LONG_MAX). - // (Momentarily this is needed only for the RTF-parser.) + /** Splits a table at the base-line which contains the index. + All base lines behind it are moved to a new table/ -node. + Is the flag bCalcNewSize set to TRUE, the new SSize for both + tables is calculated from the Maximum of the boxes, provided + SSize is set "absolute" (LONG_MAX). + (Momentarily this is needed only for the RTF-parser.) */ SwTableNode* SplitTable( const SwNodeIndex& rPos, sal_Bool bAfter = sal_True, sal_Bool bCalcNewSize = sal_False ); - // Two Tables that are following one another are merged. + /// Two Tables that are following one another are merged. sal_Bool MergeTable( const SwNodeIndex& rPos, sal_Bool bWithPrev = sal_True, sal_uInt16 nMode = 0, SwHistory* pHistory = 0 ); - // Insert a new SwSection. + /// Insert a new SwSection. SwSectionNode* InsertTextSection(SwNodeIndex const& rNdIdx, SwSectionFmt& rSectionFmt, SwSectionData const&, @@ -330,14 +330,14 @@ public: bool const bInsAtStart = true, bool const bCreateFrms = true); - // Which Doc contains the nodes-array? + /// Which Doc contains the nodes-array? SwDoc* GetDoc() { return pMyDoc; } const SwDoc* GetDoc() const { return pMyDoc; } - // Search previous / next content node or table node with frames. - // If no end is given begin with the FrameIndex, else start search - // with that before rFrmIdx and pEnd at the back. - // If no valid node is found, return 0. rFrmIdx points to the node with frames. + /** Search previous / next content node or table node with frames. + If no end is given begin with the FrameIndex, else start search + with that before rFrmIdx and pEnd at the back. + If no valid node is found, return 0. rFrmIdx points to the node with frames. **/ SwNode* FindPrvNxtFrmNode( SwNodeIndex& rFrmIdx, const SwNode* pEnd = 0 ) const; diff --git a/sw/inc/ndgrf.hxx b/sw/inc/ndgrf.hxx index 2dbcdea62697..ddb859bc69ba 100644 --- a/sw/inc/ndgrf.hxx +++ b/sw/inc/ndgrf.hxx @@ -46,11 +46,11 @@ class SW_DLLPUBLIC SwGrfNode: public SwNoTxtNode friend class SwNodes; GraphicObject aGrfObj; - ::sfx2::SvBaseLinkRef refLink; // If graphics only as link then pointer is set. + ::sfx2::SvBaseLinkRef refLink; ///< If graphics only as link then pointer is set. Size nGrfSize; - String aNewStrmName; // SW3/XML: new stream name (either SW3 stream - // name or package url) - String aLowResGrf; // HTML: LowRes graphics (substitute until regular HighRes graphics is loaded). + String aNewStrmName; /**< SW3/XML: new stream name (either SW3 stream + // name or package url) */ + String aLowResGrf; ///< HTML: LowRes graphics (substitute until regular HighRes graphics is loaded). sal_Bool bTransparentFlagValid :1; sal_Bool bInSwapIn :1; @@ -58,8 +58,8 @@ class SW_DLLPUBLIC SwGrfNode: public SwNoTxtNode sal_Bool bChgTwipSize :1; sal_Bool bChgTwipSizeFromPixel :1; sal_Bool bLoadLowResGrf :1; - sal_Bool bFrameInPaint :1; // To avoid Start-/EndActions in Paint via SwapIn. - sal_Bool bScaleImageMap :1; // Scale image map in SetTwipSize. + sal_Bool bFrameInPaint :1; ///< To avoid Start-/EndActions in Paint via SwapIn. + sal_Bool bScaleImageMap :1; ///< Scale image map in SetTwipSize. boost::shared_ptr< SwAsyncRetrieveInputStreamThreadConsumer > mpThreadConsumer; bool mbLinkedInputStreamReady; @@ -71,7 +71,7 @@ class SW_DLLPUBLIC SwGrfNode: public SwNoTxtNode const Graphic* pGraphic, SwGrfFmtColl* pGrfColl, SwAttrSet* pAutoAttr = 0 ); - // Ctor for reading (SW/G) without graphics. + ///< Ctor for reading (SW/G) without graphics. SwGrfNode( const SwNodeIndex& rWhere, const String& rGrfName, const String& rFltName, SwGrfFmtColl* pGrfColl, @@ -84,11 +84,11 @@ class SW_DLLPUBLIC SwGrfNode: public SwNoTxtNode void InsertLink( const String& rGrfName, const String& rFltName ); sal_Bool ImportGraphic( SvStream& rStrm ); sal_Bool HasStreamName() const { return aGrfObj.HasUserData(); } - // adjust return type and rename method to - // indicate that its an private one. + /** adjust return type and rename method to + indicate that its an private one. */ - // embedded graphic stream couldn't be inside a 3.1 - 5.2 storage any more. - // Thus, return value isn't needed any more. + /** embedded graphic stream couldn't be inside a 3.1 - 5.2 storage any more. + Thus, return value isn't needed any more. */ void _GetStreamStorageNames( String& rStrmName, String& rStgName ) const; void DelStreamName(); @@ -162,34 +162,34 @@ public: inline sal_Bool IsScaleImageMap() const { return bScaleImageMap; } inline void SetScaleImageMap( sal_Bool b ) { bScaleImageMap = b; } #endif - // in ndcopy.cxx + /// in ndcopy.cxx virtual SwCntntNode* MakeCopy( SwDoc*, const SwNodeIndex& ) const; #ifndef _FESHVIEW_ONLY_INLINE_NEEDED - // Re-read in case graphic was not OK. The current one - // gets replaced by the new one. + /** Re-read in case graphic was not OK. The current one + gets replaced by the new one. */ sal_Bool ReRead( const String& rGrfName, const String& rFltName, const Graphic* pGraphic = 0, const GraphicObject* pGrfObj = 0, sal_Bool bModify = sal_True ); - // Loading of graphic immediately before displaying. + /// Loading of graphic immediately before displaying. short SwapIn( sal_Bool bWaitForData = sal_False ); - // Remove graphic in order to free memory. + /// Remove graphic in order to free memory. short SwapOut(); - // Access to storage stream-name. + /// Access to storage stream-name. void SetStreamName( const String& r ) { aGrfObj.SetUserData( r ); } void SetNewStreamName( const String& r ) { aNewStrmName = r; } - // Is this node selected by any shell? + /// Is this node selected by any shell? sal_Bool IsSelected() const; #endif - // Communicate to graphic that node is in Undo-range. + /// Communicate to graphic that node is in Undo-range. virtual sal_Bool SavePersistentData(); virtual sal_Bool RestorePersistentData(); #ifndef _FESHVIEW_ONLY_INLINE_NEEDED - // Query link-data. + /// Query link-data. sal_Bool IsGrfLink() const { return refLink.Is(); } inline sal_Bool IsLinkedFile() const; inline sal_Bool IsLinkedDDE() const; @@ -197,11 +197,11 @@ public: sal_Bool GetFileFilterNms( String* pFileNm, String* pFilterNm ) const; void ReleaseLink(); - // Scale an image-map: the image-map becomes zoomed in / out by - // factor between graphic-size and border-size. + /** Scale an image-map: the image-map becomes zoomed in / out by + factor between graphic-size and border-size. */ void ScaleImageMap(); - // Returns the with our graphic attributes filled Graphic-Attr-Structure. + /// Returns the with our graphic attributes filled Graphic-Attr-Structure. GraphicAttr& GetGraphicAttr( GraphicAttr&, const SwFrm* pFrm ) const; #endif diff --git a/sw/inc/ndhints.hxx b/sw/inc/ndhints.hxx index 773bb1f4bfaa..e0d8bda4eb3d 100644 --- a/sw/inc/ndhints.hxx +++ b/sw/inc/ndhints.hxx @@ -48,7 +48,7 @@ typedef enum { NEW = false, } CopyOrNew_t; -// if COPY then pTxtNode must be given! +/// if COPY then pTxtNode must be given! SW_DLLPRIVATE SwTxtAttr * MakeTxtAttr( SwDoc & rDoc, SfxPoolItem & rNew, xub_StrLen const nStt, xub_StrLen const nEnd, @@ -57,19 +57,19 @@ SW_DLLPRIVATE SwTxtAttr * MakeTxtAttr( SwDoc & rDoc, const SfxItemSet & rSet, xub_StrLen nStt, xub_StrLen nEnd ); -// create redline dummy text hint that must not be inserted into hints array +/// create redline dummy text hint that must not be inserted into hints array SW_DLLPRIVATE SwTxtAttr* MakeRedlineTxtAttr( SwDoc & rDoc, SfxPoolItem& rAttr ); -// Class SwpHints is derived indirectly via SwpHts, because only the -// class SwTxtNode should be allowed to insert and remove attributes. -// Other classes like the Frames are given only reading access via -// the index-operator. -// Size when created is 1 because an array is created only if -// also a hint is inserted. +/** Class SwpHints is derived indirectly via SwpHts, because only the + class SwTxtNode should be allowed to insert and remove attributes. + Other classes like the Frames are given only reading access via + the index-operator. + Size when created is 1 because an array is created only if + also a hint is inserted. */ - // Class SwpHtStart/End + /// Class SwpHtStart/End struct CompareSwpHtStart { @@ -85,7 +85,7 @@ struct CompareSwpHtEnd class SwpHtEnd : public o3tl::sorted_vector<SwTxtAttr*, CompareSwpHtEnd, o3tl::find_partialorder_ptrequals> {}; -// Class SwpHintsArr +/// Class SwpHintsArr /// the Hints array @@ -133,32 +133,32 @@ public: // Class SwpHints -// public interface +/// public interface class SwpHints : public SwpHintsArray { private: - SwRegHistory* m_pHistory; // for Undo + SwRegHistory* m_pHistory; ///< for Undo - bool m_bFontChange : 1; // font change - // true: the Node is in Split and Frames are moved + bool m_bFontChange : 1; ///< font change + /// true: the Node is in Split and Frames are moved bool m_bInSplitNode : 1; - // m_bHasHiddenParaField is invalid, call CalcHiddenParaField() + /// m_bHasHiddenParaField is invalid, call CalcHiddenParaField() bool m_bCalcHiddenParaField : 1; - bool m_bHasHiddenParaField : 1; // HiddenParaFld - bool m_bFootnote : 1; // footnotes - bool m_bDDEFields : 1; // the TextNode has DDE fields + bool m_bHasHiddenParaField : 1; ///< HiddenParaFld + bool m_bFootnote : 1; ///< footnotes + bool m_bDDEFields : 1; ///< the TextNode has DDE fields - // records a new attibute in m_pHistory. + /// records a new attibute in m_pHistory. void NoteInHistory( SwTxtAttr *pAttr, const bool bNew = false ); void CalcFlags( ); - // Delete methods may only be called by the TextNode! - // Because the TextNode also guarantees removal of the Character for - // attributes without an end. + /** Delete methods may only be called by the TextNode! + Because the TextNode also guarantees removal of the Character for + attributes without an end. */ friend class SwTxtNode; void DeleteAtPos( const sal_uInt16 nPos ); - // Delete the given Hint. The Hint must actually be in the array! + /// Delete the given Hint. The Hint must actually be in the array! void Delete( SwTxtAttr* pTxtHt ); inline void SetInSplitNode(bool bInSplit) { m_bInSplitNode = bInSplit; } @@ -185,9 +185,9 @@ public: inline bool CanBeDeleted() const { return !Count(); } - // register a History, which receives all attribute changes (for Undo) + /// register a History, which receives all attribute changes (for Undo) void Register( SwRegHistory* pHist ) { m_pHistory = pHist; } - // deregister the currently registered History + /// deregister the currently registered History void DeRegister() { Register(0); } SwRegHistory* GetHistory() const { return m_pHistory; } @@ -199,17 +199,17 @@ public: inline bool HasFtn() const { return m_bFootnote; } inline bool IsInSplitNode() const { return m_bInSplitNode; } - // calc current value of m_bHasHiddenParaField, returns true iff changed + /// calc current value of m_bHasHiddenParaField, returns true iff changed bool CalcHiddenParaField(); DECL_FIXEDMEMPOOL_NEWDEL(SwpHints) }; -// Output operator for text hints. +/// Output operator for text hints. SvStream &operator<<(SvStream &aS, const SwpHints &rHints); //$ ostream -// Inline Implementations +/// Inline Implementations inline sal_uInt16 SwpHintsArray::GetStartOf( const SwTxtAttr *pHt ) const diff --git a/sw/inc/ndole.hxx b/sw/inc/ndole.hxx index f09f39ef1d89..bcad138592e9 100644 --- a/sw/inc/ndole.hxx +++ b/sw/inc/ndole.hxx @@ -45,12 +45,12 @@ class SW_DLLPUBLIC SwOLEObj const SwOLENode* pOLENd; SwOLEListener_Impl* pListener; - // Either ref or name are known. If only name is known, ref is obtained - // on demand by GetOleRef() from Sfx. + /** Either ref or name are known. If only name is known, ref is obtained + on demand by GetOleRef() from Sfx. */ svt::EmbeddedObjectRef xOLERef; String aName; - SwOLEObj( const SwOLEObj& rObj ); // Not allowed. + SwOLEObj( const SwOLEObj& rObj ); /// Not allowed. SwOLEObj(); void SetNode( SwOLENode* pNode ); @@ -71,7 +71,7 @@ public: const com::sun::star::uno::Reference < com::sun::star::embed::XEmbeddedObject > GetOleRef(); svt::EmbeddedObjectRef& GetObject(); const String& GetCurrentPersistName() const { return aName; } - sal_Bool IsOleRef() const; // To avoid unneccessary loading of object. + sal_Bool IsOleRef() const; ///< To avoid unneccessary loading of object. #endif }; @@ -84,9 +84,9 @@ class SW_DLLPUBLIC SwOLENode: public SwNoTxtNode friend class SwNodes; mutable SwOLEObj aOLEObj; Graphic* pGraphic; - String sChartTblName; // with chart objects: name of referenced table. - sal_Bool bOLESizeInvalid; // Should be considered at SwDoc::PrtOLENotify - // (e.g. copied). Is not persistent. + String sChartTblName; ///< with chart objects: name of referenced table. + sal_Bool bOLESizeInvalid; /**< Should be considered at SwDoc::PrtOLENotify + (e.g. copied). Is not persistent. */ SwEmbedObjectLink* mpObjectLink; String maLinkURL; @@ -102,7 +102,7 @@ class SW_DLLPUBLIC SwOLENode: public SwNoTxtNode SwGrfFmtColl *pGrfColl, SwAttrSet* pAutoAttr = 0 ); - // aOLEObj has a private Copy-Ctor. We need one too: + /// aOLEObj has a private Copy-Ctor. We need one too: SwOLENode( const SwOLENode & ); using SwNoTxtNode::GetGraphic; @@ -114,7 +114,7 @@ public: virtual SwCntntNode *SplitCntntNode( const SwPosition & ); - // Is in ndcopy.cxx. + /// Is in ndcopy.cxx. virtual SwCntntNode* MakeCopy( SwDoc*, const SwNodeIndex& ) const; virtual Size GetTwipSize() const; @@ -135,8 +135,8 @@ public: sal_Int64 GetAspect() const { return aOLEObj.GetObject().GetViewAspect(); } void SetAspect( sal_Int64 nAspect) { aOLEObj.GetObject().SetViewAspect( nAspect ); } - // Remove OLE-object from "memory". - // inline void Unload() { aOLEObj.Unload(); } + /** Remove OLE-object from "memory". + inline void Unload() { aOLEObj.Unload(); } */ String GetDescription() const { return aOLEObj.GetDescription(); } sal_Bool UpdateLinkURL_Impl(); @@ -156,7 +156,7 @@ public: }; -// Inline methods from Node.hxx +/// Inline methods from Node.hxx inline SwOLENode *SwNode::GetOLENode() { return ND_OLENODE == nNodeType ? (SwOLENode*)this : 0; diff --git a/sw/inc/ndtxt.hxx b/sw/inc/ndtxt.hxx index 39565cf4a6fd..603522cd0583 100644 --- a/sw/inc/ndtxt.hxx +++ b/sw/inc/ndtxt.hxx @@ -56,14 +56,14 @@ namespace utl { class SwTxtFmtColl; class SwCntntFrm; -class SwTxtFld; // For GetTxtFld(). +class SwTxtFld; ///< For GetTxtFld(). class SfxItemSet; class SwUndoTransliterate; -struct SwSpellArgs; // for Spell(), splargs.hxx -struct SwConversionArgs; // for Convert(), splargs.hxx -class SwInterHyphInfo; // for Hyphenate(), splargs.hxx -class SwWrongList; // For OnlineSpelling. +struct SwSpellArgs; ///< for Spell(), splargs.hxx +struct SwConversionArgs; ///< for Convert(), splargs.hxx +class SwInterHyphInfo; ///< for Hyphenate(), splargs.hxx +class SwWrongList; ///< For OnlineSpelling. class SwGrammarMarkUp; class OutputDevice; class SwScriptInfo; @@ -83,42 +83,42 @@ typedef std::set< xub_StrLen > SwSoftPageBreakList; class SW_DLLPUBLIC SwTxtNode: public SwCntntNode, public ::sfx2::Metadatable { - // For creating the first TextNode. - friend class SwDoc; // CTOR and AppendTxtNode() + /// For creating the first TextNode. + friend class SwDoc; ///< CTOR and AppendTxtNode() friend class SwNodes; friend class SwTxtFrm; friend class SwScriptInfo; - // May be 0. It is only then not 0 if it contains hard attributes. - // Therefore: never access directly! + /** May be 0. It is only then not 0 if it contains hard attributes. + Therefore: never access directly! */ SwpHints *m_pSwpHints; - mutable SwNodeNum* mpNodeNum; // Numbering for this paragraph. + mutable SwNodeNum* mpNodeNum; ///< Numbering for this paragraph. XubString m_Text; SwParaIdleData_Impl* m_pParaIdleData_Impl; - // Some of the chars this para are hidden. Paragraph has to be reformatted - // on changing the view to print preview. + /** Some of the chars this para are hidden. Paragraph has to be reformatted + on changing the view to print preview. */ mutable bool m_bContainsHiddenChars : 1; - // The whole paragraph is hidden because of the hidden text attribute + /// The whole paragraph is hidden because of the hidden text attribute mutable bool m_bHiddenCharsHidePara : 1; - // The last two flags have to be recalculated if this flag is set: + /// The last two flags have to be recalculated if this flag is set: mutable bool m_bRecalcHiddenCharFlags : 1; mutable bool m_bLastOutlineState : 1; bool m_bNotifiable; - // sal_uInt8 nOutlineLevel; //#outline level, removed by zhaojianwei. + /// sal_uInt8 nOutlineLevel; //#outline level, removed by zhaojianwei. bool mbEmptyListStyleSetDueToSetOutlineLevelAttr; - // boolean, indicating that a <SetAttr(..)> or <ResetAttr(..)> or - // <ResetAllAttr(..)> method is running. - // Needed to avoid duplicate handling of attribute change actions. + /** boolean, indicating that a <SetAttr(..)> or <ResetAttr(..)> or + <ResetAllAttr(..)> method is running. + Needed to avoid duplicate handling of attribute change actions. */ bool mbInSetOrResetAttr; - // pointer to the list, to whose the text node is added to + /// pointer to the list, to whose the text node is added to SwList* mpList; ::std::auto_ptr< ::rtl::OUString > m_pNumStringCache; @@ -129,7 +129,7 @@ class SW_DLLPUBLIC SwTxtNode: public SwCntntNode, public ::sfx2::Metadatable SW_DLLPRIVATE SwTxtNode( const SwNodeIndex &rWhere, SwTxtFmtColl *pTxtColl, const SfxItemSet* pAutoAttr = 0 ); - // Copies the attributes at nStart to pDest. + /// Copies the attributes at nStart to pDest. SW_DLLPRIVATE void CopyAttr( SwTxtNode *pDest, const xub_StrLen nStart, const xub_StrLen nOldPos); SW_DLLPRIVATE SwTxtNode* _MakeNewTxtNode( const SwNodeIndex&, sal_Bool bNext = sal_True, @@ -140,17 +140,17 @@ class SW_DLLPUBLIC SwTxtNode: public SwCntntNode, public ::sfx2::Metadatable const SwIndex & rStart, /*const*/ xub_StrLen nLen, const bool bUpdate = true ); - // Move all comprising hard attributes to the AttrSet of the paragraph. + /// Move all comprising hard attributes to the AttrSet of the paragraph. SW_DLLPRIVATE void MoveTxtAttr_To_AttrSet(); // Called by SplitNode. - // Create the specific AttrSet. + /// Create the specific AttrSet. SW_DLLPRIVATE virtual void NewAttrSet( SwAttrPool& ); SW_DLLPRIVATE void Replace0xFF( XubString& rTxt, xub_StrLen& rTxtStt, xub_StrLen nEndPos, sal_Bool bExpandFlds ) const; - // Optimization: Asking for information about hidden characters at SwScriptInfo - // updates these flags. + /// Optimization: Asking for information about hidden characters at SwScriptInfo + /// updates these flags. inline bool IsCalcHiddenCharFlags() const { return m_bRecalcHiddenCharFlags; } inline void SetHiddenCharAttribute( bool bNewHiddenCharsHidePara, bool bNewContainsHiddenChars ) const @@ -168,9 +168,9 @@ class SW_DLLPUBLIC SwTxtNode: public SwCntntNode, public ::sfx2::Metadatable LanguageType nLang, sal_uInt16 nLangWhichId, const Font *pFont, sal_uInt16 nFontWhichId ); - // - // Start: Data collected during idle time - // + + /// Start: Data collected during idle time + SW_DLLPRIVATE void SetParaNumberOfWords( sal_uLong nTmpWords ) const; SW_DLLPRIVATE sal_uLong GetParaNumberOfWords() const; SW_DLLPRIVATE void SetParaNumberOfAsianWords( sal_uLong nTmpAsianWords ) const; @@ -195,27 +195,27 @@ public: bool IsWordCountDirty() const; bool IsWrongDirty() const; bool IsGrammarCheckDirty() const; - bool IsSmartTagDirty() const; // SMARTTAGS + bool IsSmartTagDirty() const; ///< SMARTTAGS bool IsAutoCompleteWordDirty() const; void SetWordCountDirty( bool bNew ) const; void SetWrongDirty( bool bNew ) const; void SetGrammarCheckDirty( bool bNew ) const; - void SetSmartTagDirty( bool bNew ) const; // SMARTTAGS + void SetSmartTagDirty( bool bNew ) const; ///< SMARTTAGS void SetAutoCompleteWordDirty( bool bNew ) const; void SetWrong( SwWrongList* pNew, bool bDelete = true ); SwWrongList* GetWrong(); const SwWrongList* GetWrong() const; void SetGrammarCheck( SwGrammarMarkUp* pNew, bool bDelete = true ); SwGrammarMarkUp* GetGrammarCheck(); - // SMARTTAGS + /// SMARTTAGS void SetSmartTags( SwWrongList* pNew, bool bDelete = true ); SwWrongList* GetSmartTags(); - // - // End: Data collected during idle time - // + + /// End: Data collected during idle time + protected: - // fuers Umhaengen der TxtFmtCollections (Outline-Nummerierung!!) + /// fuers Umhaengen der TxtFmtCollections (Outline-Nummerierung!!) virtual void Modify( const SfxPoolItem*, const SfxPoolItem* ); virtual void SwClientNotify( const SwModify&, const SfxHint& ); @@ -224,7 +224,7 @@ public: const String& GetTxt() const { return m_Text; } - // getters for SwpHints + /// getters for SwpHints inline SwpHints &GetSwpHints(); inline const SwpHints &GetSwpHints() const; inline SwpHints *GetpSwpHints() { return m_pSwpHints; } @@ -236,11 +236,11 @@ public: virtual xub_StrLen Len() const; - // Is in itratr. + /// Is in itratr. void GetMinMaxSize( sal_uLong nIndex, sal_uLong& rMin, sal_uLong &rMax, sal_uLong &rAbs, OutputDevice* pOut = 0 ) const; - // overriding to handle change of certain paragraph attributes + /// overriding to handle change of certain paragraph attributes virtual sal_Bool SetAttr( const SfxPoolItem& ); virtual sal_Bool SetAttr( const SfxItemSet& rSet ); virtual sal_Bool ResetAttr( sal_uInt16 nWhich1, sal_uInt16 nWhich2 = 0 ); @@ -290,24 +290,24 @@ public: const xub_StrLen nStart, const xub_StrLen nEnd, const SetAttrMode nMode = nsSetAttrMode::SETATTR_DEFAULT ); - // Set these attributes at TextNode. If the whole range is comprised - // set them only in AutoAttrSet (SwCntntNode::SetAttr). + /** Set these attributes at TextNode. If the whole range is comprised + set them only in AutoAttrSet (SwCntntNode::SetAttr). */ sal_Bool SetAttr( const SfxItemSet& rSet, xub_StrLen nStt, xub_StrLen nEnd, const SetAttrMode nMode = nsSetAttrMode::SETATTR_DEFAULT ); - // Query the attributes of textnode over the range. - // Introduce 4th optional parameter <bMergeIndentValuesOfNumRule>. - // If <bMergeIndentValuesOfNumRule> == sal_True, the indent attributes of - // the corresponding list level of an applied list style is merged into - // the requested item set as a LR-SPACE item, if <bOnlyTxtAttr> == sal_False, - // corresponding node has not its own indent attributes and the - // position-and-space mode of the list level is SvxNumberFormat::LABEL_ALIGNMENT. + /** Query the attributes of textnode over the range. + Introduce 4th optional parameter <bMergeIndentValuesOfNumRule>. + If <bMergeIndentValuesOfNumRule> == sal_True, the indent attributes of + the corresponding list level of an applied list style is merged into + the requested item set as a LR-SPACE item, if <bOnlyTxtAttr> == sal_False, + corresponding node has not its own indent attributes and the + position-and-space mode of the list level is SvxNumberFormat::LABEL_ALIGNMENT. */ sal_Bool GetAttr( SfxItemSet& rSet, xub_StrLen nStt, xub_StrLen nEnd, sal_Bool bOnlyTxtAttr = sal_False, sal_Bool bGetFromChrFmt = sal_True, const bool bMergeIndentValuesOfNumRule = false ) const; - // Convey attributes of an AttrSet (AutoFmt) to SwpHintsArray. + /// Convey attributes of an AttrSet (AutoFmt) to SwpHintsArray. void FmtToTxtAttr( SwTxtNode* pNd ); /// delete all attributes of type nWhich at nStart (opt. end nEnd) @@ -316,8 +316,8 @@ public: /// delete the attribute pTxtAttr void DeleteAttribute ( SwTxtAttr * const pTxtAttr ); - // Actions on text and attributes. - // introduce optional parameter to control, if all attributes have to be copied. + /** Actions on text and attributes. + introduce optional parameter to control, if all attributes have to be copied. */ void CopyText( SwTxtNode * const pDest, const SwIndex &rStart, const xub_StrLen nLen, @@ -339,7 +339,7 @@ public: void ReplaceTextOnly( xub_StrLen nPos, xub_StrLen nLen, const XubString& rText, const ::com::sun::star::uno::Sequence<sal_Int32>& rOffsets ); - // Virtual methods from CntntNode. + /// Virtual methods from CntntNode. virtual SwCntntFrm *MakeFrm( SwFrm* ); virtual SwCntntNode *SplitCntntNode( const SwPosition & ); virtual SwCntntNode *JoinNext(); @@ -347,7 +347,7 @@ public: SwCntntNode *AppendNode( const SwPosition & ); - // When appropriate set DontExpand-flag at INet or character styles respectively. + /// When appropriate set DontExpand-flag at INet or character styles respectively. sal_Bool DontExpandFmt( const SwIndex& rIdx, bool bFlag = true, sal_Bool bFmtToTxtAttributes = sal_True ); @@ -395,9 +395,9 @@ public: void _ChgTxtCollUpdateNum( const SwTxtFmtColl* pOld, const SwTxtFmtColl* pNew ); - // Copy collection with all auto formats to dest-node. - // The latter might be in an other document! - // (Method in ndcopy.cxx!!). + /** Copy collection with all auto formats to dest-node. + The latter might be in an other document! + (Method in ndcopy.cxx!!). */ void CopyCollFmt( SwTxtNode& rDestNd ); //const SwNodeNum* _GetNodeNum() const { return pNdNum; } @@ -675,20 +675,20 @@ public: sal_uInt16 GetLang( const xub_StrLen nBegin, const xub_StrLen nLen = 0, sal_uInt16 nScript = 0 ) const; - // in ndcopy.cxx + /// in ndcopy.cxx sal_Bool IsSymbol( const xub_StrLen nBegin ) const; // In itratr.cxx. virtual SwCntntNode* MakeCopy( SwDoc*, const SwNodeIndex& ) const; - // Interactive hyphenation: we find TxtFrm and call its CalcHyph. + /// Interactive hyphenation: we find TxtFrm and call its CalcHyph. sal_Bool Hyphenate( SwInterHyphInfo &rHyphInf ); void DelSoftHyph( const xub_StrLen nStart, const xub_StrLen nEnd ); - // add 4th optional parameter <bAddSpaceAfterListLabelStr> indicating, - // when <bWithNum = true> that a space is inserted after the string for - // the list label. - // add 5th optional parameter <bWithSpacesForLevel> indicating, if additional - // spaces are inserted in front of the expanded text string depending on - // the list level. + /** add 4th optional parameter <bAddSpaceAfterListLabelStr> indicating, + when <bWithNum = true> that a space is inserted after the string for + the list label. + add 5th optional parameter <bWithSpacesForLevel> indicating, if additional + spaces are inserted in front of the expanded text string depending on + the list level. */ XubString GetExpandTxt( const xub_StrLen nIdx = 0, const xub_StrLen nLen = STRING_LEN, const bool bWithNum = false, @@ -704,27 +704,27 @@ public: sal_Bool bExpandFlds = sal_False, sal_Bool bWithNum = sal_False ) const; - // Returns actual count of initial chars for initial-function. - // If nWishLen == 0 that of first word. + /** @return actual count of initial chars for initial-function. + If nWishLen == 0 that of first word. */ sal_uInt16 GetDropLen( sal_uInt16 nWishLen) const; - // Passes back info needed on the dropcap dimensions + /// Passes back info needed on the dropcap dimensions bool GetDropSize(int& rFontHeight, int& rDropHeight, int& rDropDescent) const; - // Hidden Paragraph Field: + /// Hidden Paragraph Field: inline bool CalcHiddenParaField() { return m_pSwpHints ? m_pSwpHints->CalcHiddenParaField() : false; } - // set CalcVisible flags + /// set CalcVisible flags inline void SetCalcHiddenParaField() { if (m_pSwpHints) m_pSwpHints->SetCalcHiddenParaField(); } - // is the paragraph visible? + /// is the paragraph visible? inline bool HasHiddenParaField() const { return m_pSwpHints ? m_pSwpHints->HasHiddenParaField() : false; } - // - // Hidden Paragraph Field: - // + + /// Hidden Paragraph Field: + inline bool HasHiddenCharAttribute( bool bWholePara ) const { if ( m_bRecalcHiddenCharFlags ) @@ -735,33 +735,33 @@ public: inline void SetCalcHiddenCharFlags() const { m_bRecalcHiddenCharFlags = true; } - // - // Returns if the node is hidden due to - // 1. HiddenParaField - // 2. HiddenCharAttribute - // 3. HiddenSection - // + + /** @return if the node is hidden due to + 1. HiddenParaField + 2. HiddenCharAttribute + 3. HiddenSection */ + bool IsHidden() const; TYPEINFO(); // fuer rtti - // override SwIndexReg + /// override SwIndexReg virtual void Update( SwIndex const & rPos, const xub_StrLen nChangeLen, const bool bNegative = false, const bool bDelete = false ); - // change text to Upper/Lower/Hiragana/Katagana/... + /// change text to Upper/Lower/Hiragana/Katagana/... void TransliterateText( utl::TransliterationWrapper& rTrans, xub_StrLen nStart, xub_StrLen nEnd, SwUndoTransliterate* pUndo = 0 ); - // count words in given range + /// count words in given range void CountWords( SwDocStat& rStat, xub_StrLen nStart, xub_StrLen nEnd ) const; - // Checks some global conditions like loading or destruction of document - // to economize notifications + /** Checks some global conditions like loading or destruction of document + to economize notifications */ bool IsNotificationEnabled() const; - // Checks a temporary notification blocker and the global conditons of IsNotificationEnabled() + /// Checks a temporary notification blocker and the global conditons of IsNotificationEnabled() bool IsNotifiable() const; void SetListRestart( bool bRestart ); @@ -790,7 +790,7 @@ public: ::com::sun::star::text::XTextContent> const& xParagraph) { m_wXParagraph = xParagraph; } - // sfx2::Metadatable + /// sfx2::Metadatable virtual ::sfx2::IXmlIdRegistry& GetRegistry(); virtual bool IsInClipboard() const; virtual bool IsInUndo() const; @@ -847,7 +847,7 @@ inline SwTxtFmtColl* SwTxtNode::GetTxtColl() const return static_cast<SwTxtFmtColl*>(const_cast<SwModify*>(GetRegisteredIn())); } -// Inline methods from Node.hxx +/// Inline methods from Node.hxx inline SwTxtNode *SwNode::GetTxtNode() { return ND_TEXTNODE == nNodeType ? static_cast<SwTxtNode*>(this) : 0; |