diff options
author | Chris Sherlock <chris.sherlock79@gmail.com> | 2014-01-30 02:23:42 +1100 |
---|---|---|
committer | Caolán McNamara <caolanm@redhat.com> | 2014-02-04 14:39:21 +0000 |
commit | ff8036df5c5575503dc30d255dfbe99cc637c510 (patch) | |
tree | 56ab7e1e37855f32f92fa1538890005420c1a30f /include/vcl/pdfextoutdevdata.hxx | |
parent | f4d7259dbf0970d2af8747c681e6657853e36587 (diff) |
Doxygen warnings corrected
* Doxygen spits out a lot of warnings about not being able to find
match function signatures, etc. This is because in some headers we
have a using namespace statement, in others it gets confused between
::Window and Window (!).
* Wrong use of tags:
+ Lots of @seealso - should be @see
+ Wrong usage of @overload - corrected with the right function
signature
+ HTML tags that doxygen doesn't recognize removed
Conflicts:
include/vcl/toolbox.hxx
Change-Id: I687f45e426280d411ef3cb6d8d5993a829f2f324
Reviewed-on: https://gerrit.libreoffice.org/7725
Reviewed-by: Caolán McNamara <caolanm@redhat.com>
Tested-by: Caolán McNamara <caolanm@redhat.com>
Diffstat (limited to 'include/vcl/pdfextoutdevdata.hxx')
-rw-r--r-- | include/vcl/pdfextoutdevdata.hxx | 45 |
1 files changed, 24 insertions, 21 deletions
diff --git a/include/vcl/pdfextoutdevdata.hxx b/include/vcl/pdfextoutdevdata.hxx index 1f4e18b03202..b6314edc7495 100644 --- a/include/vcl/pdfextoutdevdata.hxx +++ b/include/vcl/pdfextoutdevdata.hxx @@ -185,7 +185,7 @@ public : /** Create a new named destination to be used in a link to this document from another PDF document (see PDF spec 1.4, 8.2.1) - @parm sDestName + @param sDestName the name this destination will be addressed with from others PDF document @param rRect @@ -295,7 +295,7 @@ public : @param rText sets the title text of the item - @param nDestId + @param nDestID declares which Dest (created with CreateDest) the outline item will point to @@ -332,17 +332,17 @@ public : must be called while drawing the next page. BeginStructureElement and EndStructureElement must be called only after - <member scope="vcl">PDFWriter::NewPage</member> has been called and before - <member scope="vcl">PDFWriter::Emit</member>gets called. The current page + PDFWriter::NewPage has been called and before + PDFWriter::Emit gets called. The current page number is an implicit context parameter for Begin/EndStructureElement. For pagination artifacts that are not part of the logical structure of the document (like header, footer or page number) the special - StructElement <code>NonStructElement</code> exists. To place content + StructElement NonStructElement exists. To place content outside of the struture tree simply call - <code>BeginStructureElement( NonStructElement )</code> then draw your - content and then call <code>EndStructureElement()</code>. Any children - of a <code>NonStructElement</code> will not be part of the structure as well. + BeginStructureElement( NonStructElement ) then draw your + content and then call EndStructureElement(). Any children + of a NonStructElement will not be part of the structure as well. @param eType denotes what kind of element to begin (e.g. a heading or paragraph) @@ -365,7 +365,7 @@ public : <p> For different purposes it may be useful to paint a structure element's content discontinously. In that case an already existing structure element - can be appended to by using <code>SetCurrentStructureElement</code>. The + can be appended to by using SetCurrentStructureElement. The refenrenced structure element becomes the current structure element with all consequences: all following structure elements are appended as children of the current element. @@ -375,8 +375,8 @@ public : the id of the new current structure element @returns - <true/> if the current structure element could be set successfully - <false/> if the current structure element could not be changed + True if the current structure element could be set successfully + False if the current structure element could not be changed (e.g. if the passed element id is invalid) */ bool SetCurrentStructureElement( sal_Int32 nElement ); @@ -391,7 +391,7 @@ public : SetStructureAttribute sets an attribute of the current structural element to a new value. A consistency check is performed before actually setting the value; - if the check fails, the function returns <FALSE/> and the attribute remains + if the check fails, the function returns False and the attribute remains unchanged. @param eAttr @@ -401,15 +401,15 @@ public : the value to set the attribute to @returns - <TRUE/> if the value was valid and the change has been performed, - <FALSE/> if the attribute or value was invalid; attribute remains unchanged + True if the value was valid and the change has been performed, + False if the attribute or value was invalid; attribute remains unchanged */ bool SetStructureAttribute( PDFWriter::StructAttribute eAttr, PDFWriter::StructAttributeValue eVal ); /** set a structure attribute on the current structural element SetStructureAttributeNumerical sets an attribute of the current structural element to a new numerical value. A consistency check is performed before actually setting - the value; if the check fails, the function returns <FALSE/> and the attribute + the value; if the check fails, the function returns False and the attribute remains unchanged. @param eAttr @@ -419,15 +419,15 @@ public : the value to set the attribute to @returns - <TRUE/> if the value was valid and the change has been performed, - <FALSE/> if the attribute or value was invalid; attribute remains unchanged + True if the value was valid and the change has been performed, + False if the attribute or value was invalid; attribute remains unchanged */ bool SetStructureAttributeNumerical( PDFWriter::StructAttribute eAttr, sal_Int32 nValue ); /** set the bounding box of a structural element SetStructureBoundingBox sets the BBox attribute to a new value. Since the BBox - attribute can only be applied to <code>Table</code>, <code>Figure</code>, - <code>Form</code> and <code>Formula</code> elements, a call of this function + attribute can only be applied to Table, Figure, + Form and Formula elements, a call of this function for other element types will be ignored and the BBox attribute not be set. @param rRect @@ -476,11 +476,14 @@ public : /** create a new form control This function creates a new form control in the PDF and sets its various - properties. Do not pass an actual AnyWidget as <code>rControlType</code> + properties. Do not pass an actual AnyWidget as rControlType will be cast to the type described by the type member. @param rControlType - a descendant of <code>AnyWidget</code> determing the control's properties + a descendant of AnyWidget determing the control's properties + + @param nPageNr + the page number to apply the effect to; -1 denotes the current page */ void CreateControl( const PDFWriter::AnyWidget& rControlType, sal_Int32 nPageNr = -1 ); }; |