Changes

Jump to: navigation, search

Report API

15 bytes added, 19:31, 24 September 2007
m
no edit summary
{|style="width:70%; border:1px solid #ccc; padding:0c0a0a0" align="center"
|-
| style="width:10px; padding:0; background-color:#c00000" || style="width:60px; padding:0" align="center"| [[Image:Gnome-important.png|40px]]| style="widthpadding:90%0" align="left" | '''This is still a draft. Please don't link to it yet!'''
|}
[[Image:Doc_paper.png|thumbnail]] Description of the paper, which every report will be rendered on, is stored by an instance of the [http://www.gramps-project.org/api3/BaseDoc.PaperStyle-class.html PaperStyle class]. This instance is available via the <tt>BaseDoc.paper_style</tt> class attribute. The chosen PaperStyle is given to the document generator at initialization, and is handled by the reporting framework.
The <tt>PaperStyle</tt> holds information on the size of the paper ([http://www.gramps-project.org/api3/BaseDoc.PaperSize-class.html PaperSize class] instance), the size of the margins, and the orientation of the paper. Use the proper accessor methods to get the values. To get the metrics of the usable area of a page paper (page without the margins) one can also use the [http://www.gramps-project.org/api3/BaseDoc.PaperStyle-class.html#get_usable_width PaperStyle.get_usable_width] and [http://www.gramps-project.org/api3/BaseDoc.PaperStyle-class.html#get_usable_height PaperStyle.get_usable_height] convenience methods. Width and height are always given according to the orientation of the paper, thus width is always the horizontal, and height is always the vertical dimension.
Text reports do not need to care about paper properties, as the document generator (or the external viewer) paginates the report according to those properties. While, on the other hand, graphical reports do need to take paper properties into account when creating graphical elements, i.e. they should not draw on the margins.
35
edits

Navigation menu