.. include:: headings.inc



.. _PageSetupDialog:

==========================================================================================================================================
|phoenix_title|  **PageSetupDialog**
==========================================================================================================================================

This class represents the page setup common dialog.          

The page setup dialog contains controls for paper size (letter, ``A4``, ``A5`` etc.), orientation (landscape or portrait), and, only under Windows currently, controls for setting left, top, right and bottom margin sizes in millimetres. 

The exact appearance of this dialog varies among the platforms as a native dialog is used when available (currently the case for all major platforms). 

When the dialog has been closed, you need to query the :ref:`PageSetupDialogData`  object associated with the dialog. 

Note that the ``OK`` and Cancel buttons do not destroy the dialog; this must be done by the application. 







         



.. seealso:: :ref:`Printing Framework Overview <printing framework overview>`, :ref:`PrintDialog`, :ref:`PageSetupDialogData`    







|

|class_hierarchy| Inheritance Diagram
=====================================

Inheritance diagram for class **PageSetupDialog**

.. raw:: html

   <p class="graphviz">
   <img src="_static/images/inheritance/PageSetupDialog_inheritance.png" alt="Inheritance diagram of PageSetupDialog" usemap="#dummy" class="inheritance"/>
   <map id="dummy" name="dummy"> <area shape="rect" id="node1" href="Object.html" title="This is the root class of many of the wxWidgets classes." alt="" coords="5,5,77,35"/> <area shape="rect" id="node2" href="PageSetupDialog.html" title="This class represents the page setup common dialog." alt="" coords="127,5,273,35"/> </map> 
   </p>

|


|method_summary| Methods Summary
================================

================================================================================ ================================================================================
:meth:`~PageSetupDialog.__init__`                                                Constructor.
:meth:`~PageSetupDialog.GetPageSetupData`                                        Returns the :ref:`PageSetupDialogData`  object associated with the dialog.
:meth:`~PageSetupDialog.ShowModal`                                               Shows the dialog, returning  ``ID_OK``   if the user pressed ``OK``, and   ``ID_CANCEL``   otherwise.
================================================================================ ================================================================================


|


|property_summary| Properties Summary
=====================================

================================================================================ ================================================================================
:attr:`~PageSetupDialog.PageSetupData`                                           See :meth:`~PageSetupDialog.GetPageSetupData`
================================================================================ ================================================================================


|


|api| Class API
===============
   

.. class:: PageSetupDialog(Object)

   This class represents the page setup common dialog.
   
   **Possible constructors**::

       PageSetupDialog(parent, data=None)
       



   .. method:: __init__(self, parent, data=None)

      Constructor.                  

      Pass a parent window, and optionally a pointer to a block of page setup data, which will be copied to the print dialog's internal data.                  


      :param `parent`: 
      :type `parent`: Window
      :param `data`: 
      :type `data`: PageSetupDialogData







   .. method:: GetPageSetupData(self)

      Returns the :ref:`PageSetupDialogData`  object associated with the dialog.                  

      :rtype: :ref:`PageSetupDialogData`








   .. method:: ShowModal(self)

      Shows the dialog, returning  ``ID_OK``   if the user pressed ``OK``, and   ``ID_CANCEL``   otherwise.                   

      :rtype: `int`








   .. attribute:: PageSetupData

      See :meth:`~PageSetupDialog.GetPageSetupData`