]> git.saurik.com Git - wxWidgets.git/blobdiff - interface/cmndata.h
use wxEmptyString as default value to return from GetAttribute()
[wxWidgets.git] / interface / cmndata.h
index e50d18864adc77504a72fc665c6d7c06e894c15b..2ab3aeb250052d650a44a3c883eaff7cebd8d5e5 100644 (file)
@@ -1,6 +1,6 @@
 /////////////////////////////////////////////////////////////////////////////
 // Name:        cmndata.h
-// Purpose:     documentation for wxFontData class
+// Purpose:     interface of wxFontData
 // Author:      wxWidgets team
 // RCS-ID:      $Id$
 // Licence:     wxWindows license
@@ -17,8 +17,7 @@
     @library{wxcore}
     @category{FIXME}
 
-    @seealso
-    Overview, wxFont, wxFontDialog
+    @see Overview(), wxFont, wxFontDialog
 */
 class wxFontData : public wxObject
 {
@@ -120,6 +119,7 @@ public:
 };
 
 
+
 /**
     @class wxPageSetupDialogData
     @wxheader{cmndata.h}
@@ -133,8 +133,8 @@ public:
     @library{wxcore}
     @category{printing}
 
-    @seealso
-    @ref overview_printingoverview "Printing framework overview", wxPageSetupDialog
+    @see @ref overview_printingoverview "Printing framework overview",
+    wxPageSetupDialog
 */
 class wxPageSetupDialogData : public wxObject
 {
@@ -183,74 +183,74 @@ public:
         as orientation)
         instead of showing a dialog. Windows only.
     */
-    bool GetDefaultInfo();
+    bool GetDefaultInfo() const;
 
     /**
         Returns @true if the page setup dialog will take its minimum margin values from
         the currently
         selected printer properties. Windows only.
     */
-    bool GetDefaultMinMargins();
+    bool GetDefaultMinMargins() const;
 
     /**
         Returns @true if the printer setup button is enabled.
     */
-    bool GetEnableHelp();
+    bool GetEnableHelp() const;
 
     /**
         Returns @true if the margin controls are enabled (Windows only).
     */
-    bool GetEnableMargins();
+    bool GetEnableMargins() const;
 
     /**
         Returns @true if the orientation control is enabled (Windows only).
     */
-    bool GetEnableOrientation();
+    bool GetEnableOrientation() const;
 
     /**
         Returns @true if the paper size control is enabled (Windows only).
     */
-    bool GetEnablePaper();
+    bool GetEnablePaper() const;
 
     /**
         Returns @true if the printer setup button is enabled.
     */
-    bool GetEnablePrinter();
+    bool GetEnablePrinter() const;
 
     /**
         Returns the right (x) and bottom (y) margins in millimetres.
     */
-    wxPoint GetMarginBottomRight();
+    wxPoint GetMarginBottomRight() const;
 
     /**
         Returns the left (x) and top (y) margins in millimetres.
     */
-    wxPoint GetMarginTopLeft();
+    wxPoint GetMarginTopLeft() const;
 
     /**
         Returns the right (x) and bottom (y) minimum margins the user can enter
         (Windows only). Units
         are in millimetres
     */
-    wxPoint GetMinMarginBottomRight();
+    wxPoint GetMinMarginBottomRight() const;
 
     /**
         Returns the left (x) and top (y) minimum margins the user can enter (Windows
         only). Units
         are in millimetres
     */
-    wxPoint GetMinMarginTopLeft();
+    wxPoint GetMinMarginTopLeft() const;
 
     /**
         Returns the paper id (stored in the internal wxPrintData object).
         For further information, see wxPrintData::SetPaperId.
     */
-    wxPaperSize GetPaperId();
+    wxPaperSize GetPaperId() const;
 
     /**
         Returns the paper size in millimetres.
     */
-    wxSize GetPaperSize();
+    wxSize GetPaperSize() const;
 
     /**
         Returns a reference to the @ref overview_wxprintdata "print data" associated
@@ -263,7 +263,7 @@ public:
         This can return @false on Windows if the current printer is not set, for example.
         On all other platforms, it returns @true.
     */
-    bool IsOk();
+    bool IsOk() const;
 
     /**
         Pass @true if the dialog will simply return default printer information (such as
@@ -332,6 +332,7 @@ public:
 };
 
 
+
 /**
     @class wxColourData
     @wxheader{cmndata.h}
@@ -341,9 +342,8 @@ public:
     @library{wxcore}
     @category{FIXME}
 
-    @seealso
-    wxColour, wxColourDialog, @ref overview_wxcolourdialogoverview "wxColourDialog
-    overview"
+    @see wxColour, wxColourDialog, @ref overview_wxcolourdialogoverview
+    "wxColourDialog overview"
 */
 class wxColourData : public wxObject
 {
@@ -369,20 +369,20 @@ public:
         Has no meaning under other platforms.
         The default value is @true.
     */
-    bool GetChooseFull();
+    bool GetChooseFull() const;
 
     /**
         Gets the current colour associated with the colour dialog.
         The default colour is black.
     */
-    wxColour GetColour();
+    wxColour GetColour() const;
 
     /**
         Gets the @e ith custom colour associated with the colour dialog. @a i should
         be an integer between 0 and 15.
         The default custom colours are invalid colours.
     */
-    wxColour GetCustomColour(int i);
+    wxColour GetCustomColour(int i) const;
 
     /**
         Under Windows, tells the Windows colour dialog to display the full dialog
@@ -411,6 +411,7 @@ public:
 };
 
 
+
 /**
     @class wxPrintData
     @wxheader{cmndata.h}
@@ -424,9 +425,8 @@ public:
     @library{wxcore}
     @category{printing}
 
-    @seealso
-    @ref overview_printingoverview "Printing framework overview", wxPrintDialog,
-    wxPageSetupDialog, wxPrintDialogData, wxPageSetupDialogData, @ref overview_wxprintdialogoverview "wxPrintDialog Overview", wxPrinterDC, wxPostScriptDC
+    @see @ref overview_printingoverview "Printing framework overview",
+    wxPrintDialog, wxPageSetupDialog, wxPrintDialogData, wxPageSetupDialogData, @ref overview_wxprintdialogoverview "wxPrintDialog Overview", wxPrinterDC, wxPostScriptDC
 */
 class wxPrintData : public wxObject
 {
@@ -449,63 +449,63 @@ public:
         the bin (@c wxPRINTBIN_DEFAULT is returned).
         See SetBin() for the full list of bin values.
     */
-    wxPrintBin GetBin();
+    wxPrintBin GetBin() const;
 
     /**
         Returns @true if collation is on.
     */
-    bool GetCollate();
+    bool GetCollate() const;
 
     /**
         Returns @true if colour printing is on.
     */
-    bool GetColour();
+    bool GetColour() const;
 
     /**
         Returns the duplex mode. One of wxDUPLEX_SIMPLEX, wxDUPLEX_HORIZONTAL,
         wxDUPLEX_VERTICAL.
     */
-    wxDuplexMode GetDuplex();
+    wxDuplexMode GetDuplex() const;
 
     /**
         Returns the number of copies requested by the user.
     */
-    int GetNoCopies();
+    int GetNoCopies() const;
 
     /**
         Gets the orientation. This can be wxLANDSCAPE or wxPORTRAIT.
     */
-    int GetOrientation();
+    int GetOrientation() const;
 
     /**
         Returns the paper size id. For more information, see SetPaperId().
     */
-    wxPaperSize GetPaperId();
+    wxPaperSize GetPaperId() const;
 
     /**
         Returns the printer name. If the printer name is the empty string, it indicates
         that the default
         printer should be used.
     */
-    const wxString GetPrinterName();
+    const wxString GetPrinterName() const;
 
     /**
         Returns the current print quality. This can be a positive integer, denoting the
         number of dots per inch, or
         one of the following identifiers:
-        
+
         On input you should pass one of these identifiers, but on return you may get
         back a positive integer
         indicating the current resolution setting.
     */
-    wxPrintQuality GetQuality();
+    wxPrintQuality GetQuality() const;
 
     /**
         Returns @true if the print data is valid for using in print dialogs.
         This can return @false on Windows if the current printer is not set, for example.
         On all other platforms, it returns @true.
     */
-    bool IsOk();
+    bool IsOk() const;
 
     /**
         Sets the current bin. Possible values are:
@@ -557,7 +557,7 @@ public:
         Sets the desired print quality. This can be a positive integer, denoting the
         number of dots per inch, or
         one of the following identifiers:
-        
+
         On input you should pass one of these identifiers, but on return you may get
         back a positive integer
         indicating the current resolution setting.
@@ -575,6 +575,7 @@ public:
 };
 
 
+
 /**
     @class wxPrintDialogData
     @wxheader{cmndata.h}
@@ -586,9 +587,8 @@ public:
     @library{wxcore}
     @category{printing}
 
-    @seealso
-    @ref overview_printingoverview "Printing framework overview", wxPrintDialog,
-    @ref overview_wxprintdialogoverview "wxPrintDialog Overview"
+    @see @ref overview_printingoverview "Printing framework overview",
+    wxPrintDialog, @ref overview_wxprintdialogoverview "wxPrintDialog Overview"
 */
 class wxPrintDialogData : public wxObject
 {
@@ -630,32 +630,32 @@ public:
     /**
         Returns @true if the user requested that all pages be printed.
     */
-    bool GetAllPages();
+    bool GetAllPages() const;
 
     /**
         Returns @true if the user requested that the document(s) be collated.
     */
-    bool GetCollate();
+    bool GetCollate() const;
 
     /**
         Returns the @e from page number, as entered by the user.
     */
-    int GetFromPage();
+    int GetFromPage() const;
 
     /**
         Returns the @e maximum page number.
     */
-    int GetMaxPage();
+    int GetMaxPage() const;
 
     /**
         Returns the @e minimum page number.
     */
-    int GetMinPage();
+    int GetMinPage() const;
 
     /**
         Returns the number of copies requested by the user.
     */
-    int GetNoCopies();
+    int GetNoCopies() const;
 
     /**
         Returns a reference to the internal wxPrintData object.
@@ -665,26 +665,26 @@ public:
     /**
         Returns @true if the user has selected printing to a file.
     */
-    bool GetPrintToFile();
+    bool GetPrintToFile() const;
 
     /**
         Returns @true if the user requested that the selection be printed (where
         'selection' is
         a concept specific to the application).
     */
-    bool GetSelection();
+    bool GetSelection() const;
 
     /**
         Returns the @e to page number, as entered by the user.
     */
-    int GetToPage();
+    int GetToPage() const;
 
     /**
         Returns @true if the print data is valid for using in print dialogs.
         This can return @false on Windows if the current printer is not set, for example.
         On all other platforms, it returns @true.
     */
-    bool IsOk();
+    bool IsOk() const;
 
     /**
         Sets the 'Collate' checkbox to @true or @false.
@@ -748,3 +748,4 @@ public:
     void operator =(const wxPrintDialogData& data);
     //@}
 };
+