== API מקובל משותף ==

===עמודעימוד===

The רכיב <tt>PaperStyle</tt> holds information on the size of the paper מכיל מידע על גודל הדף ([http://www.gramps-project.org/docs/gen/gen_plug.html#gen.plug.docgen.paperstyle.PaperStyle מחלקה 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 paper כדי לקבל את תשקיל האזור בו ניתן להשתמש בדף (page without the marginsדף ללא שוליים) one can also use the אפשר גם להשתמש ב־[http://www.gramps-project.org/docs/gen/gen_plug.html#gen.plug.docgen.paperstyleשיטות נוחות .PaperStyle.get_usable_width PaperStyle.get_usable_width] and ו־[http://www.gramps-project.org/docs/gen/gen_plug.html#gen.plug.docgen.paperstyle.PaperStyle.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כלומר הם לא אמורים לגלוש לשוליים.<!--[[Image:gramps-devel.png|left|22px]] ''document generator should hide paper properies for graphical reports too'מחולל מסמכים צריך להסתיר גם מאפייני דף עבור דוחות חזותיים'--> The origin of the coordinate system is the top left corner of the usable area.