.. include:: headings.inc .. _PageSetupDialogData: ========================================================================================================================================== |phoenix_title| **PageSetupDialogData** ========================================================================================================================================== This class holds a variety of information related to :ref:`PageSetupDialog`. It contains a :ref:`PrintData` member which is used to hold basic printer configuration data (as opposed to the user-interface configuration settings stored by :ref:`PageSetupDialogData`). .. seealso:: :ref:`Printing Framework Overview `, :ref:`PageSetupDialog` | |class_hierarchy| Inheritance Diagram ===================================== Inheritance diagram for class **PageSetupDialogData** .. raw:: html

Inheritance diagram of PageSetupDialogData

| |method_summary| Methods Summary ================================ ================================================================================ ================================================================================ :meth:`~PageSetupDialogData.__init__` Default constructor. :meth:`~PageSetupDialogData.EnableHelp` Enables or disables the "Help" button (Windows only). :meth:`~PageSetupDialogData.EnableMargins` Enables or disables the margin controls (Windows only). :meth:`~PageSetupDialogData.EnableOrientation` Enables or disables the orientation control (Windows only). :meth:`~PageSetupDialogData.EnablePaper` Enables or disables the paper size control (Windows only). :meth:`~PageSetupDialogData.EnablePrinter` Enables or disables the "Printer" button, which invokes a printer setup dialog. :meth:`~PageSetupDialogData.GetDefaultInfo` Returns ``True`` if the dialog will simply return default printer information (such as orientation) instead of showing a dialog (Windows only). :meth:`~PageSetupDialogData.GetDefaultMinMargins` Returns ``True`` if the page setup dialog will take its minimum margin values from the currently selected printer properties (Windows only). :meth:`~PageSetupDialogData.GetEnableHelp` Returns ``True`` if the printer setup button is enabled. :meth:`~PageSetupDialogData.GetEnableMargins` Returns ``True`` if the margin controls are enabled (Windows only). :meth:`~PageSetupDialogData.GetEnableOrientation` Returns ``True`` if the orientation control is enabled (Windows only). :meth:`~PageSetupDialogData.GetEnablePaper` Returns ``True`` if the paper size control is enabled (Windows only). :meth:`~PageSetupDialogData.GetEnablePrinter` Returns ``True`` if the printer setup button is enabled. :meth:`~PageSetupDialogData.GetMarginBottomRight` Returns the right (x) and bottom (y) margins in millimetres. :meth:`~PageSetupDialogData.GetMarginTopLeft` Returns the left (x) and top (y) margins in millimetres. :meth:`~PageSetupDialogData.GetMinMarginBottomRight` Returns the right (x) and bottom (y) minimum margins the user can enter (Windows only). :meth:`~PageSetupDialogData.GetMinMarginTopLeft` Returns the left (x) and top (y) minimum margins the user can enter (Windows only). :meth:`~PageSetupDialogData.GetPaperId` Returns the paper id (stored in the internal :ref:`PrintData` object). :meth:`~PageSetupDialogData.GetPaperSize` Returns the paper size in millimetres. :meth:`~PageSetupDialogData.GetPrintData` Returns a reference to the print data associated with this object. :meth:`~PageSetupDialogData.IsOk` Returns ``True`` if the print data associated with the dialog data is valid. :meth:`~PageSetupDialogData.SetDefaultInfo` Pass ``True`` if the dialog will simply return default printer information (such as orientation) instead of showing a dialog (Windows only). :meth:`~PageSetupDialogData.SetDefaultMinMargins` Pass ``True`` if the page setup dialog will take its minimum margin values from the currently selected printer properties (Windows only). :meth:`~PageSetupDialogData.SetMarginBottomRight` Sets the right (x) and bottom (y) margins in millimetres. :meth:`~PageSetupDialogData.SetMarginTopLeft` Sets the left (x) and top (y) margins in millimetres. :meth:`~PageSetupDialogData.SetMinMarginBottomRight` Sets the right (x) and bottom (y) minimum margins the user can enter (Windows only). :meth:`~PageSetupDialogData.SetMinMarginTopLeft` Sets the left (x) and top (y) minimum margins the user can enter (Windows only). :meth:`~PageSetupDialogData.SetPaperId` Sets the paper size id. :meth:`~PageSetupDialogData.SetPaperSize` Sets the paper size in millimetres. :meth:`~PageSetupDialogData.SetPrintData` Sets the print data associated with this object. :meth:`~PageSetupDialogData.__nonzero__` ================================================================================ ================================================================================ | |property_summary| Properties Summary ===================================== ================================================================================ ================================================================================ :attr:`~PageSetupDialogData.MarginBottomRight` See :meth:`~PageSetupDialogData.GetMarginBottomRight` and :meth:`~PageSetupDialogData.SetMarginBottomRight` :attr:`~PageSetupDialogData.MarginTopLeft` See :meth:`~PageSetupDialogData.GetMarginTopLeft` and :meth:`~PageSetupDialogData.SetMarginTopLeft` :attr:`~PageSetupDialogData.MinMarginBottomRight` See :meth:`~PageSetupDialogData.GetMinMarginBottomRight` and :meth:`~PageSetupDialogData.SetMinMarginBottomRight` :attr:`~PageSetupDialogData.MinMarginTopLeft` See :meth:`~PageSetupDialogData.GetMinMarginTopLeft` and :meth:`~PageSetupDialogData.SetMinMarginTopLeft` :attr:`~PageSetupDialogData.PaperId` See :meth:`~PageSetupDialogData.GetPaperId` and :meth:`~PageSetupDialogData.SetPaperId` :attr:`~PageSetupDialogData.PaperSize` See :meth:`~PageSetupDialogData.GetPaperSize` and :meth:`~PageSetupDialogData.SetPaperSize` :attr:`~PageSetupDialogData.PrintData` See :meth:`~PageSetupDialogData.GetPrintData` and :meth:`~PageSetupDialogData.SetPrintData` ================================================================================ ================================================================================ | |api| Class API =============== .. class:: PageSetupDialogData(Object) This class holds a variety of information related to PageSetupDialog. **Possible constructors**:: PageSetupDialogData() PageSetupDialogData(data) PageSetupDialogData(printData) .. method:: __init__(self, *args, **kw) |overload| **Overloaded Implementations**: **~~~** **__init__** `(self)` Default constructor. **~~~** **__init__** `(self, data)` Copy constructor. :param `data`: :type `data`: PageSetupDialogData **~~~** **__init__** `(self, printData)` Construct an object from a print data object. :param `printData`: :type `printData`: PrintData **~~~** .. method:: EnableHelp(self, flag) Enables or disables the "Help" button (Windows only). :param `flag`: :type `flag`: bool .. method:: EnableMargins(self, flag) Enables or disables the margin controls (Windows only). :param `flag`: :type `flag`: bool .. method:: EnableOrientation(self, flag) Enables or disables the orientation control (Windows only). :param `flag`: :type `flag`: bool .. method:: EnablePaper(self, flag) Enables or disables the paper size control (Windows only). :param `flag`: :type `flag`: bool .. method:: EnablePrinter(self, flag) Enables or disables the "Printer" button, which invokes a printer setup dialog. :param `flag`: :type `flag`: bool .. method:: GetDefaultInfo(self) Returns ``True`` if the dialog will simply return default printer information (such as orientation) instead of showing a dialog (Windows only). :rtype: `bool` .. method:: GetDefaultMinMargins(self) Returns ``True`` if the page setup dialog will take its minimum margin values from the currently selected printer properties (Windows only). :rtype: `bool` .. method:: GetEnableHelp(self) Returns ``True`` if the printer setup button is enabled. :rtype: `bool` .. method:: GetEnableMargins(self) Returns ``True`` if the margin controls are enabled (Windows only). :rtype: `bool` .. method:: GetEnableOrientation(self) Returns ``True`` if the orientation control is enabled (Windows only). :rtype: `bool` .. method:: GetEnablePaper(self) Returns ``True`` if the paper size control is enabled (Windows only). :rtype: `bool` .. method:: GetEnablePrinter(self) Returns ``True`` if the printer setup button is enabled. :rtype: `bool` .. method:: GetMarginBottomRight(self) Returns the right (x) and bottom (y) margins in millimetres. :rtype: :ref:`Point` .. method:: GetMarginTopLeft(self) Returns the left (x) and top (y) margins in millimetres. :rtype: :ref:`Point` .. method:: GetMinMarginBottomRight(self) Returns the right (x) and bottom (y) minimum margins the user can enter (Windows only). Units are in millimetres. :rtype: :ref:`Point` .. method:: GetMinMarginTopLeft(self) Returns the left (x) and top (y) minimum margins the user can enter (Windows only). Units are in millimetres. :rtype: :ref:`Point` .. method:: GetPaperId(self) Returns the paper id (stored in the internal :ref:`PrintData` object). :rtype: :ref:`PaperSize` .. seealso:: :meth:`PrintData.SetPaperId` .. method:: GetPaperSize(self) Returns the paper size in millimetres. :rtype: :ref:`Size` .. method:: GetPrintData(self) Returns a reference to the print data associated with this object. :rtype: :ref:`PrintData` .. method:: IsOk(self) Returns ``True`` if the print data associated with the dialog data is valid. This can return ``False`` on Windows if the current printer is not set, for example. On all other platforms, it returns ``True``. :rtype: `bool` .. method:: SetDefaultInfo(self, flag) Pass ``True`` if the dialog will simply return default printer information (such as orientation) instead of showing a dialog (Windows only). :param `flag`: :type `flag`: bool .. method:: SetDefaultMinMargins(self, flag) Pass ``True`` if the page setup dialog will take its minimum margin values from the currently selected printer properties (Windows only). Units are in millimetres. :param `flag`: :type `flag`: bool .. method:: SetMarginBottomRight(self, pt) Sets the right (x) and bottom (y) margins in millimetres. :param `pt`: :type `pt`: Point .. method:: SetMarginTopLeft(self, pt) Sets the left (x) and top (y) margins in millimetres. :param `pt`: :type `pt`: Point .. method:: SetMinMarginBottomRight(self, pt) Sets the right (x) and bottom (y) minimum margins the user can enter (Windows only). Units are in millimetres. :param `pt`: :type `pt`: Point .. method:: SetMinMarginTopLeft(self, pt) Sets the left (x) and top (y) minimum margins the user can enter (Windows only). Units are in millimetres. :param `pt`: :type `pt`: Point .. method:: SetPaperId(self, id) Sets the paper size id. Calling this function overrides the explicit paper dimensions passed in :meth:`SetPaperSize` . :param `id`: :type `id`: PaperSize .. seealso:: :meth:`PrintData.SetPaperId` .. method:: SetPaperSize(self, size) Sets the paper size in millimetres. If a corresponding paper id is found, it will be set in the internal :ref:`PrintData` object, otherwise the paper size overrides the paper id. :param `size`: :type `size`: Size .. method:: SetPrintData(self, printData) Sets the print data associated with this object. :param `printData`: :type `printData`: PrintData .. method:: __nonzero__(self) :rtype: `int` .. attribute:: MarginBottomRight See :meth:`~PageSetupDialogData.GetMarginBottomRight` and :meth:`~PageSetupDialogData.SetMarginBottomRight` .. attribute:: MarginTopLeft See :meth:`~PageSetupDialogData.GetMarginTopLeft` and :meth:`~PageSetupDialogData.SetMarginTopLeft` .. attribute:: MinMarginBottomRight See :meth:`~PageSetupDialogData.GetMinMarginBottomRight` and :meth:`~PageSetupDialogData.SetMinMarginBottomRight` .. attribute:: MinMarginTopLeft See :meth:`~PageSetupDialogData.GetMinMarginTopLeft` and :meth:`~PageSetupDialogData.SetMinMarginTopLeft` .. attribute:: PaperId See :meth:`~PageSetupDialogData.GetPaperId` and :meth:`~PageSetupDialogData.SetPaperId` .. attribute:: PaperSize See :meth:`~PageSetupDialogData.GetPaperSize` and :meth:`~PageSetupDialogData.SetPaperSize` .. attribute:: PrintData See :meth:`~PageSetupDialogData.GetPrintData` and :meth:`~PageSetupDialogData.SetPrintData`