X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/a660d684eda27638bca0384b2058911a31c8e845..8e458bb53997706d4432d2dc0b9b516320709389:/docs/latex/wx/pagedlg.tex diff --git a/docs/latex/wx/pagedlg.tex b/docs/latex/wx/pagedlg.tex index 082970f2c0..ba223977e3 100644 --- a/docs/latex/wx/pagedlg.tex +++ b/docs/latex/wx/pagedlg.tex @@ -1,242 +1,307 @@ -\section{\class{wxPageSetupData}}\label{wxpagesetupdata} +\section{\class{wxPageSetupDialog}}\label{wxpagesetupdialog} + +This class represents the page setup common dialog. The page setup dialog is standard from +Windows 95 on, replacing the print setup dialog (which is retained in Windows and wxWidgets +for backward compatibility). On Windows 95 and NT 4.0 and above, the page setup dialog is +native to the windowing system, otherwise it is emulated. + +The page setup dialog contains controls for paper size (A4, A5 etc.), orientation (landscape +or portrait), and controls for setting left, top, right and bottom margin sizes in millimetres. + +When the dialog has been closed, you need to query the \helpref{wxPageSetupDialogData}{wxpagesetupdialogdata} object +associated with the dialog. + +Note that the OK and Cancel buttons do not destroy the dialog; this must be done by the +application. + +\wxheading{Derived from} + +\helpref{wxDialog}{wxdialog}\\ +\helpref{wxWindow}{wxwindow}\\ +\helpref{wxEvtHandler}{wxevthandler}\\ +\helpref{wxObject}{wxobject} + +\wxheading{Include files} + + + +\wxheading{See also} + +\helpref{wxPrintDialog}{wxprintdialog}, \helpref{wxPageSetupDialogData}{wxpagesetupdialogdata} + +\latexignore{\rtfignore{\wxheading{Members}}} + +\membersection{wxPageSetupDialog::wxPageSetupDialog}\label{wxpagesetupdialogctor} + +\func{}{wxPageSetupDialog}{\param{wxWindow* }{parent}, \param{wxPageSetupDialogData* }{data = NULL}} + +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. + +\membersection{wxPageSetupDialog::\destruct{wxPageSetupDialog}}\label{wxpagesetupdialogdtor} + +\func{}{\destruct{wxPageSetupDialog}}{\void} + +Destructor. + +\membersection{wxPageSetupDialog::GetPageSetupData}\label{wxpagesetupdialoggetpagesetupdata} + +\func{wxPageSetupDialogData\&}{GetPageSetupData}{\void} + +Returns the \helpref{page setup data}{wxpagesetupdialogdata} associated with the dialog. + +%\membersection{wxPageSetupDialog::IsOk}\label{wxpagesetupdialogisok} +% +%\constfunc{bool}{IsOk}{\void} +% +%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. + +\membersection{wxPageSetupDialog::ShowModal}\label{wxpagesetupdialogshowmodal} + +\func{int}{ShowModal}{\void} + +Shows the dialog, returning wxID\_OK if the user pressed OK, and wxID\_CANCEL +otherwise. + +\section{\class{wxPageSetupDialogData}}\label{wxpagesetupdialogdata} This class holds a variety of information related to \helpref{wxPageSetupDialog}{wxpagesetupdialog}. +It contains a \helpref{wxPrintData}{wxprintdata} member which is used to hold basic printer configuration data (as opposed to the +user-interface configuration settings stored by wxPageSetupDialogData). + \wxheading{Derived from} \helpref{wxObject}{wxobject} +\wxheading{Include files} + + + \wxheading{See also} \helpref{wxPageSetupDialog}{wxpagesetupdialog} \latexignore{\rtfignore{\wxheading{Members}}} -\membersection{wxPageSetupData::wxPageSetupData} +\membersection{wxPageSetupDialogData::wxPageSetupDialogData}\label{wxpagesetupdialogdatactor} + +\func{}{wxPageSetupDialogData}{\void} -\func{}{wxPageSetupData}{\void} +Default constructor. -Constructor. +\func{}{wxPageSetupDialogData}{\param{wxPageSetupDialogData\&}{ data}} -\membersection{wxPageSetupData::\destruct{wxPageSetupData}} +Copy constructor. -\func{}{\destruct{wxPageSetupData}}{\void} +\func{}{wxPageSetupDialogData}{\param{wxPrintData\&}{ printData}} + +Construct an object from a print data object. + +\membersection{wxPageSetupDialogData::\destruct{wxPageSetupDialogData}}\label{wxpagesetupdialogdatadtor} + +\func{}{\destruct{wxPageSetupDialogData}}{\void} Destructor. -\membersection{wxPageSetupData::EnableHelp}\label{wxpagesetupdataenablehelp} +\membersection{wxPageSetupDialogData::EnableHelp}\label{wxpagesetupdialogdataenablehelp} \func{void}{EnableHelp}{\param{bool }{flag}} Enables or disables the `Help' button (Windows only). -\membersection{wxPageSetupData::EnableMargins}\label{wxpagesetupdataenablemargins} +\membersection{wxPageSetupDialogData::EnableMargins}\label{wxpagesetupdialogdataenablemargins} \func{void}{EnableMargins}{\param{bool }{flag}} Enables or disables the margin controls (Windows only). -\membersection{wxPageSetupData::EnableOrientation}\label{wxpagesetupdataenableorientation} +\membersection{wxPageSetupDialogData::EnableOrientation}\label{wxpagesetupdialogdataenableorientation} \func{void}{EnableOrientation}{\param{bool }{flag}} Enables or disables the orientation control (Windows only). -\membersection{wxPageSetupData::EnablePaper}\label{wxpagesetupdataenablepaper} +\membersection{wxPageSetupDialogData::EnablePaper}\label{wxpagesetupdialogdataenablepaper} \func{void}{EnablePaper}{\param{bool }{flag}} Enables or disables the paper size control (Windows only). -\membersection{wxPageSetupData::EnablePrinter}\label{wxpagesetupdataenableprinter} +\membersection{wxPageSetupDialogData::EnablePrinter}\label{wxpagesetupdialogdataenableprinter} \func{void}{EnablePrinter}{\param{bool }{flag}} Enables or disables the {\bf Printer} button, which invokes a printer setup dialog. -\membersection{wxPageSetupData::GetPaperSize}\label{wxpagesetupdatagetpapersize} - -\func{wxPoint}{GetPaperSize}{\void} - -Returns the paper size in millimetres. - -\membersection{wxPageSetupData::GetMarginTopLeft}\label{wxpagesetupdatagetmargintopleft} +\membersection{wxPageSetupDialogData::GetDefaultMinMargins}\label{wxpagesetupdialogdatagetdefaultminmargins} -\func{wxPoint}{GetMarginTopLeft}{\void} +\constfunc{bool}{GetDefaultMinMargins}{\void} -Returns the left (x) and top (y) margins. +Returns true if the page setup dialog will take its minimum margin values from the currently +selected printer properties. Windows only. -\membersection{wxPageSetupData::GetMarginBottomRight}\label{wxpagesetupdatagetmarginbottomright} +\membersection{wxPageSetupDialogData::GetEnableMargins}\label{wxpagesetupdialogdatagetenablemargins} -\func{wxPoint}{GetMarginBottomRight}{\void} +\constfunc{bool}{GetEnableMargins}{\void} -Returns the right (x) and bottom (y) margins. +Returns true if the margin controls are enabled (Windows only). -\membersection{wxPageSetupData::GetMinMarginTopLeft}\label{wxpagesetupdatagetminmargintopleft} +\membersection{wxPageSetupDialogData::GetEnableOrientation}\label{wxpagesetupdialogdatagetenableorientation} -\func{wxPoint}{GetMinMarginTopLeft}{\void} +\constfunc{bool}{GetEnableOrientation}{\void} -Returns the left (x) and top (y) minimum margins the user can enter (Windows only). +Returns true if the orientation control is enabled (Windows only). -\membersection{wxPageSetupData::GetMinMarginBottomRight}\label{wxpagesetupdatagetminmarginbottomright} +\membersection{wxPageSetupDialogData::GetEnablePaper}\label{wxpagesetupdialogdatagetenablepaper} -\func{wxPoint}{GetMinMarginBottomRight}{\void} +\constfunc{bool}{GetEnablePaper}{\void} -Returns the right (x) and bottom (y) minimum margins the user can enter (Windows only). +Returns true if the paper size control is enabled (Windows only). -\membersection{wxPageSetupData::GetOrientation}\label{wxpagesetupdatagetorientation} +\membersection{wxPageSetupDialogData::GetEnablePrinter}\label{wxpagesetupdialogdatagetenableprinter} -\func{int}{GetOrientation}{\void} +\constfunc{bool}{GetEnablePrinter}{\void} -Returns the orientation, which can be wxPORTRAIT or wxLANDSCAPE. +Returns true if the printer setup button is enabled. -\membersection{wxPageSetupData::GetDefaultMinMargins}\label{wxpagesetupdatagetdefaultminmargins} +\membersection{wxPageSetupDialogData::GetEnableHelp}\label{wxpagesetupdialogdatagetenablehelp} -\func{bool}{GetDefaultMinMargins}{\void} +\constfunc{bool}{GetEnableHelp}{\void} -Returns TRUE if the page setup dialog will take its minimum margin values from the currently -selected printer properties. Windows only. +Returns true if the printer setup button is enabled. -\membersection{wxPageSetupData::GetEnableMargins}\label{wxpagesetupdatagetenablemargins} +\membersection{wxPageSetupDialogData::GetDefaultInfo}\label{wxpagesetupdialogdatagetdefaultinfo} -\func{bool}{GetEnableMargins}{\void} +\constfunc{bool}{GetDefaultInfo}{\void} -Returns TRUE if the margin controls are enabled (Windows only). +Returns true if the dialog will simply return default printer information (such as orientation) +instead of showing a dialog. Windows only. -\membersection{wxPageSetupData::GetEnableOrientation}\label{wxpagesetupdatagetenableorientation} +\membersection{wxPageSetupDialogData::GetMarginTopLeft}\label{wxpagesetupdialogdatagetmargintopleft} -\func{bool}{GetEnableOrientation}{\void} +\constfunc{wxPoint}{GetMarginTopLeft}{\void} -Returns TRUE if the orientation control is enabled (Windows only). +Returns the left (x) and top (y) margins in millimetres. -\membersection{wxPageSetupData::GetEnablePaper}\label{wxpagesetupdatagetenablepaper} +\membersection{wxPageSetupDialogData::GetMarginBottomRight}\label{wxpagesetupdialogdatagetmarginbottomright} -\func{bool}{GetEnablePaper}{\void} +\constfunc{wxPoint}{GetMarginBottomRight}{\void} -Returns TRUE if the paper size control is enabled (Windows only). +Returns the right (x) and bottom (y) margins in millimetres. -\membersection{wxPageSetupData::GetEnablePrinter}\label{wxpagesetupdatagetenableprinter} +\membersection{wxPageSetupDialogData::GetMinMarginTopLeft}\label{wxpagesetupdialogdatagetminmargintopleft} -\func{bool}{GetEnablePrinter}{\void} +\constfunc{wxPoint}{GetMinMarginTopLeft}{\void} -Returns TRUE if the printer setup button is enabled. +Returns the left (x) and top (y) minimum margins the user can enter (Windows only). Units +are in millimetres -\membersection{wxPageSetupData::GetEnableHelp}\label{wxpagesetupdatagetenablehelp} +\membersection{wxPageSetupDialogData::GetMinMarginBottomRight}\label{wxpagesetupdialogdatagetminmarginbottomright} -\func{bool}{GetEnableHelp}{\void} +\constfunc{wxPoint}{GetMinMarginBottomRight}{\void} -Returns TRUE if the printer setup button is enabled. +Returns the right (x) and bottom (y) minimum margins the user can enter (Windows only). Units +are in millimetres -\membersection{wxPageSetupData::GetDefaultInfo}\label{wxpagesetupdatagetdefaultinfo} +\membersection{wxPageSetupDialogData::GetPaperId}\label{wxpagesetupdialogdatagetpaperid} -\func{bool}{GetDefaultInfo}{\void} +\constfunc{wxPaperSize}{GetPaperId}{\void} -Returns TRUE if the dialog will simply return default printer information (such as orientation) -instead of showing a dialog. Windows only. +Returns the paper id (stored in the internal wxPrintData object). -\membersection{wxPageSetupData::SetPaperSize}\label{wxpagesetupdatasetpapersize} +For further information, see \helpref{wxPrintData::SetPaperId}{wxprintdatasetpaperid}. -\func{void}{SetPaperSize}{\param{const wxPoint\& }{size}} +\membersection{wxPageSetupDialogData::GetPaperSize}\label{wxpagesetupdialogdatagetpapersize} -Sets the paper size in millimetres. +\constfunc{wxSize}{GetPaperSize}{\void} -\membersection{wxPageSetupData::SetMarginTopLeft}\label{wxpagesetupdatasetmargintopleft} +Returns the paper size in millimetres. -\func{void}{GetMarginTopLeft}{\param{const wxPoint\& }{pt}} +\membersection{wxPageSetupDialogData::GetPrintData}\label{wxpagesetupdialogdatagetprintdata} -Sets the left (x) and top (y) margins. +\func{wxPrintData\&}{GetPrintData}{\void} -\membersection{wxPageSetupData::SetMarginBottomRight}\label{wxpagesetupdatasetmarginbottomright} +Returns a reference to the \helpref{print data}{wxprintdata} associated with this object. -\func{void}{SetMarginBottomRight}{\param{const wxPoint\& }{pt}} +\membersection{wxPageSetupDialogData::IsOk}\label{wxpagesetupdialogdataisok} -Sets the right (x) and bottom (y) margins. +\constfunc{bool}{IsOk}{\void} -\membersection{wxPageSetupData::SetMinMarginTopLeft}\label{wxpagesetupdatasetminmargintopleft} +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. -\func{void}{SetMinMarginTopLeft}{\param{const wxPoint\& }{pt}} +\membersection{wxPageSetupDialogData::SetDefaultInfo}\label{wxpagesetupdialogdatasetdefaultinfo} -Sets the left (x) and top (y) minimum margins the user can enter (Windows only). - -\membersection{wxPageSetupData::SetMinMarginBottomRight}\label{wxpagesetupdatasetminmarginbottomright} +\func{void}{SetDefaultInfo}{\param{bool}{ flag}} -\func{void}{SetMinMarginBottomRight}{\param{const wxPoint\& }{pt}} +Pass true if the dialog will simply return default printer information (such as orientation) +instead of showing a dialog. Windows only. -Sets the right (x) and bottom (y) minimum margins the user can enter (Windows only). +\membersection{wxPageSetupDialogData::SetDefaultMinMargins}\label{wxpagesetupdialogdatasetdefaultminmargins} -\membersection{wxPageSetupData::SetOrientation}\label{wxpagesetupdatasetorientation} +\func{void}{SetDefaultMinMargins}{\param{bool}{ flag}} -\func{void}{SetOrientation}{\param{int }{orientation}} +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 -Sets the orientation, which can be wxPORTRAIT or wxLANDSCAPE. +\membersection{wxPageSetupDialogData::SetMarginTopLeft}\label{wxpagesetupdialogdatasetmargintopleft} -\membersection{wxPageSetupData::SetDefaultMinMargins}\label{wxpagesetupdatasetdefaultminmargins} +\func{void}{SetMarginTopLeft}{\param{const wxPoint\& }{pt}} -\func{void}{SetDefaultMinMargins}{\param{bool}{ flag}} +Sets the left (x) and top (y) margins in millimetres. -Pass TRUE if the page setup dialog will take its minimum margin values from the currently -selected printer properties. Windows only. +\membersection{wxPageSetupDialogData::SetMarginBottomRight}\label{wxpagesetupdialogdatasetmarginbottomright} -\membersection{wxPageSetupData::SetDefaultInfo}\label{wxpagesetupdatasetdefaultinfo} - -\func{void}{SetDefaultInfo}{\param{bool}{ flag}} +\func{void}{SetMarginBottomRight}{\param{const wxPoint\& }{pt}} -Pass TRUE if the dialog will simply return default printer information (such as orientation) -instead of showing a dialog. Windows only. +Sets the right (x) and bottom (y) margins in millimetres. -\section{\class{wxPageSetupDialog}}\label{wxpagesetupdialog} +\membersection{wxPageSetupDialogData::SetMinMarginTopLeft}\label{wxpagesetupdialogdatasetminmargintopleft} -This class represents the page setup common dialog. The page setup dialog is standard from -Windows 95 on, replacing the print setup dialog (which is retained in Windows and wxWindows -for backward compatibility). On Windows 95 and NT 4.0 and above, the page setup dialog is -native to the windowing system, otherwise it is emulated. +\func{void}{SetMinMarginTopLeft}{\param{const wxPoint\& }{pt}} -The page setup dialog contains controls for paper size (A4, A5 etc.), orientation (landscape -or portrait), and controls for setting left, top, right and bottom margin sizes in millimetres. -The page setup dialog does not set any global information (the exception being orientation -for PostScript printing) so you need to query the \helpref{wxPageSetupData}{wxpagesetupdata} object -associated with the dialog. +Sets the left (x) and top (y) minimum margins the user can enter (Windows only). Units are +in millimetres. -Note that the OK and Cancel buttons do not destroy the dialog; this must be done by the -application. - -\wxheading{Derived from} +\membersection{wxPageSetupDialogData::SetMinMarginBottomRight}\label{wxpagesetupdialogdatasetminmarginbottomright} -\helpref{wxDialog}{wxdialog}\\ -\helpref{wxWindow}{wxwindow}\\ -\helpref{wxEvtHandler}{wxevthandler}\\ -\helpref{wxObject}{wxobject} +\func{void}{SetMinMarginBottomRight}{\param{const wxPoint\& }{pt}} -\wxheading{See also} +Sets the right (x) and bottom (y) minimum margins the user can enter (Windows only). Units are +in millimetres. -\helpref{wxPrintDialog}{wxprintdialog}, \helpref{wxPageSetupData}{wxpagesetupdata} +\membersection{wxPageSetupDialogData::SetPaperId}\label{wxpagesetupdialogdatasetpaperid} -\latexignore{\rtfignore{\wxheading{Members}}} +\func{void}{SetPaperId}{\param{wxPaperSize\& }{id}} -\membersection{wxPageSetupDialog::wxPageSetupDialog} +Sets the paper size id. For further information, see \helpref{wxPrintData::SetPaperId}{wxprintdatasetpaperid}. -\func{}{wxPageSetupDialog}{\param{wxWindow* }{parent}, \param{wxPageSetupData* }{data = NULL}} +Calling this function overrides the explicit paper dimensions passed in \helpref{wxPageSetupDialogData::SetPaperSize}{wxpagesetupdialogdatasetpapersize}. -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. +\membersection{wxPageSetupDialogData::SetPaperSize}\label{wxpagesetupdialogdatasetpapersize} -\membersection{wxPageSetupDialog::\destruct{wxPageSetupDialog}} +\func{void}{SetPaperSize}{\param{const wxSize\& }{size}} -\func{}{\destruct{wxPageSetupDialog}}{\void} +Sets the paper size in millimetres. If a corresponding paper id is found, it will be set in the +internal wxPrintData object, otherwise the paper size overrides the paper id. -Destructor. +\membersection{wxPageSetupDialogData::SetPrintData}\label{wxpagesetupdialogdatasetprintdata} -\membersection{wxPageSetupDialog::GetPageSetupData}\label{wxpagesetupdialoggetpagesetupdata} +\func{void}{SetPrintData}{\param{const wxPrintData\&}{ printData}} -\func{wxPageSetupData\&}{GetPageSetupData}{\void} +Sets the \helpref{print data}{wxprintdata} associated with this object. -Returns the \helpref{page setup data}{wxpagesetupdata} associated with the dialog. +\membersection{wxPageSetupDialogData::operator $=$}\label{wxpagesetupdialogdataassign} -\membersection{wxPageSetupDialog::ShowModal}\label{wxpagesetupdialogshowmodal} +\func{void}{operator $=$}{\param{const wxPrintData\&}{ data}} -\func{int}{ShowModal}{\void} +Assigns print data to this object. -Shows the dialog, returning wxID\_OK if the user pressed OK, and wxID\_CANCEL -otherwise. +\func{void}{operator $=$}{\param{const wxPageSetupDialogData\&}{ data}} +Assigns page setup data to this object.