]> git.saurik.com Git - wxWidgets.git/commitdiff
ifacecheck manual fixes
authorFrancesco Montorsi <f18m_cpp217828@yahoo.it>
Sun, 9 Nov 2008 16:46:52 +0000 (16:46 +0000)
committerFrancesco Montorsi <f18m_cpp217828@yahoo.it>
Sun, 9 Nov 2008 16:46:52 +0000 (16:46 +0000)
git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@56720 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775

24 files changed:
interface/wx/dirctrl.h
interface/wx/event.h
interface/wx/filectrl.h
interface/wx/filedlg.h
interface/wx/filename.h
interface/wx/filepicker.h
interface/wx/font.h
interface/wx/fontpicker.h
interface/wx/frame.h
interface/wx/gauge.h
interface/wx/glcanvas.h
interface/wx/graphics.h
interface/wx/grid.h
interface/wx/hash.h
interface/wx/html/helpctrl.h
interface/wx/html/helpfrm.h
interface/wx/html/htmlpars.h
interface/wx/html/htmltag.h
interface/wx/html/htmlwin.h
interface/wx/html/htmprint.h
interface/wx/icon.h
interface/wx/iconbndl.h
interface/wx/log.h
interface/wx/window.h

index 60910dbbbc02ab5ac62d15872b030249924d19d5..09067ef001a00abbd0599f871bd7b16a3b01c1fd 100644 (file)
@@ -38,6 +38,7 @@ public:
         Default constructor.
     */
     wxGenericDirCtrl();
+
     /**
         Main constructor.
 
@@ -63,7 +64,7 @@ public:
         @param name
             The window name.
     */
-    wxGenericDirCtrl(wxWindow* parent, const wxWindowID id = -1,
+    wxGenericDirCtrl(wxWindow* parent, const wxWindowID id = wxID_ANY,
                      const wxString& dir = wxDirDialogDefaultFolderStr,
                      const wxPoint& pos = wxDefaultPosition,
                      const wxSize& size = wxDefaultSize,
index 9b35297a125b3c3ca9250e643a99b4a3d14efb07..22e06d8fe6199050b6c85b22a43b017ee681d951 100644 (file)
@@ -417,8 +417,8 @@ public:
         @param eventSink
             Object whose member function should be called.
     */
-    bool Disconnect(wxEventType eventType = wxEVT_NULL,
-                    wxObjectEventFunction function = NULL,
+    bool Disconnect(wxEventType eventType,
+                    wxObjectEventFunction function,
                     wxObject* userData = NULL,
                     wxEvtHandler* eventSink = NULL);
 
@@ -440,8 +440,8 @@ public:
 
         This overload takes an additional range of source IDs.
     */
-    bool Disconnect(int id, int lastId = wxID_ANY,
-                    wxEventType eventType = wxEVT_NULL,
+    bool Disconnect(int id, int lastId,
+                    wxEventType eventType,
                     wxObjectEventFunction function = NULL,
                     wxObject* userData = NULL,
                     wxEvtHandler* eventSink = NULL);
@@ -2333,13 +2333,10 @@ public:
 
 
 
-/**
-    Indicates how a wxHelpEvent was generated.
-*/
 enum wxHelpEventOrigin
 {
-    wxHE_ORIGIN_UNKNOWN = -1,    /**< unrecognized event source. */
-    wxHE_ORIGIN_KEYBOARD,        /**< event generated from F1 key press. */
+    wxHE_ORIGIN_UNKNOWN = -1,
+    wxHE_ORIGIN_KEYBOARD,
 
     /** event generated by wxContextHelp or from the [?] button on
         the title bar (Windows). */
@@ -2382,13 +2379,26 @@ enum wxHelpEventOrigin
 class wxHelpEvent : public wxCommandEvent
 {
 public:
+    /**
+        Indicates how a wxHelpEvent was generated.
+    */
+    enum Origin
+    {
+        Origin_Unknown,    /**< unrecognized event source. */
+        Origin_Keyboard,   /**< event generated from F1 key press. */
+
+        /** event generated by wxContextHelp or from the [?] button on
+            the title bar (Windows). */
+        Origin_HelpButton
+    };
+
     /**
         Constructor.
     */
     wxHelpEvent(wxEventType type = wxEVT_NULL,
                 wxWindowID winid = 0,
                 const wxPoint& pt = wxDefaultPosition,
-                wxHelpEventOrigin origin = wxHE_ORIGIN_UNKNOWN);
+                wxHelpEvent::Origin origin = Origin_Unknown);
 
     /**
         Returns the origin of the help event which is one of the ::wxHelpEventOrigin
index 72149989d554a93133fc3a9cdbb94b630a55ba21..a802d5b771407d1d458ed63b6f43f298c32c7a7b 100644 (file)
@@ -88,7 +88,7 @@ public:
                long style = wxFC_DEFAULT_STYLE,
                const wxPoint& pos = wxDefaultPosition,
                const wxSize& size = wxDefaultSize,
-               const wxString& name = "filectrl");
+               const wxString& name = wxFileCtrlNameStr);
 
     /**
         Create function for two-step construction. See wxFileCtrl() for details.
@@ -206,7 +206,7 @@ public:
     /**
         Constructor.
     */
-    wxFileCtrlEvent(wxEventType type, wxObject evtObject, int id);
+    wxFileCtrlEvent(wxEventType type, wxObject *evtObject, int id);
 
     /**
         Returns the current directory.
index a3851926db335cd5cbf1fb3bf98d910f73571535..1ff73a0603e6d68f1839274c418e89bbd83ee8af 100644 (file)
@@ -90,14 +90,14 @@ public:
             Dialog name. Not implemented.
     */
     wxFileDialog(wxWindow* parent,
-                 const wxString& message = "Choose a file",
-                 const wxString& defaultDir = "",
-                 const wxString& defaultFile = "",
-                 const wxString& wildcard = ".",
+                 const wxString& message = wxFileSelectorPromptStr,
+                 const wxString& defaultDir = wxEmptyString,
+                 const wxString& defaultFile = wxEmptyString,
+                 const wxString& wildcard = wxFileSelectorDefaultWildcardStr,
                  long style = wxFD_DEFAULT_STYLE,
                  const wxPoint& pos = wxDefaultPosition,
                  const wxSize& size = wxDefaultSize,
-                 const wxString& name = "filedlg");
+                 const wxString& name = wxFileDialogNameStr);
 
     /**
         Destructor.
index 2310985da874c76900224cfacccac8e50822b756..4917fecce97ad7924390a669b28d8126669ef913 100644 (file)
@@ -334,14 +334,17 @@ public:
     */
     void AssignHomeDir();
 
+    //@{
     /**
         The function calls CreateTempFileName() to create a temporary file
         and sets this object to the name of the file.
+
         If a temporary file couldn't be created, the object is put into
         an invalid state (see IsOk())
     */
-    void AssignTempFileName(const wxString& prefix,
-                            wxFile* fileTemp = NULL);
+    void AssignTempFileName(const wxString& prefix, wxFile* fileTemp);
+    void AssignTempFileName(const wxString& prefix, wxFFile* fileTemp);
+    //@}
 
     /**
         Reset all components to default, uninitialized state.
index f3a46de190164e659e5cd9c992156ba347fcf4b8..aed89f0067efe661bffe06f194c80d51d604fd14 100644 (file)
@@ -63,13 +63,13 @@ public:
     */
     wxFilePickerCtrl(wxWindow* parent, wxWindowID id,
                      const wxString& path = wxEmptyString,
-                     const wxString& message = "Select a file",
-                     const wxString& wildcard = ".",
+                     const wxString& message = wxFileSelectorPromptStr,
+                     const wxString& wildcard = wxFileSelectorDefaultWildcardStr,
                      const wxPoint& pos = wxDefaultPosition,
                      const wxSize& size = wxDefaultSize,
                      long style = wxFLP_DEFAULT_STYLE,
                      const wxValidator& validator = wxDefaultValidator,
-                     const wxString& name = "filepickerctrl");
+                     const wxString& name = wxFilePickerCtrlNameStr);
 
     /**
         Creates this widget with the given parameters.
@@ -282,7 +282,7 @@ public:
     */
     wxFileDirPickerEvent(wxEventType type, wxObject* generator,
                          int id,
-                         const wxString path);
+                         const wxString& path);
 
     /**
         Retrieve the absolute path of the file/directory the user has just selected.
index 3ffd7e94c308b49050bb50290377101d06d6c975..a008843ba706a51fb5f88f1ff0e4eed458172e4f 100644 (file)
@@ -529,7 +529,7 @@ public:
 
         @see GetFamily(), SetFaceName()
     */
-    void SetFamily(wxFontFamily family);
+    virtual void SetFamily(wxFontFamily family);
 
     /**
         Creates the font corresponding to the given native font description string
@@ -586,7 +586,7 @@ public:
 
         @see GetStyle()
     */
-    void SetStyle(wxFontStyle style);
+    virtual void SetStyle(wxFontStyle style);
 
     /**
         Sets underlining.
@@ -606,7 +606,7 @@ public:
 
         @see GetWeight()
     */
-    void SetWeight(wxFontWeight weight);
+    virtual void SetWeight(wxFontWeight weight);
 
     /**
         Inequality operator.
@@ -692,10 +692,9 @@ public:
         Finds a font of the given specification, or creates one and adds it to the
         list. See the @ref wxFont "wxFont constructor" for details of the arguments.
     */
-    wxFont* FindOrCreateFont(int point_size, int family, int style,
-                             int weight,
-                             bool underline = false,
-                             const wxString& facename = NULL,
+    wxFont* FindOrCreateFont(int point_size, wxFontFamily family, wxFontStyle style,
+                             wxFontWeight weight, bool underline = false,
+                             const wxString& facename = wxEmptyString,
                              wxFontEncoding encoding = wxFONTENCODING_DEFAULT);
 };
 
index 6c37b1703cff6bcd58d791e9fc4373157ee60701..33497c5bf153efde04778e15c7369bcf1759d8fd 100644 (file)
@@ -59,7 +59,7 @@ public:
                      const wxSize& size = wxDefaultSize,
                      long style = wxFNTP_DEFAULT_STYLE,
                      const wxValidator& validator = wxDefaultValidator,
-                     const wxString& name = "fontpickerctrl");
+                     const wxString& name = wxFontPickerCtrlNameStr);
 
     /**
         Creates this widget with given parameters.
index 78ea432f42e1272367f5205708b0e81305ea076a..84a81d2ebba886200ba51fef60987a2dd0f47800 100644 (file)
@@ -332,7 +332,7 @@ public:
         @param id
             The identifier for a menu item.
     */
-    void ProcessCommand(int id);
+    bool ProcessCommand(int id);
 
     /**
         Tells the frame to show the given menu bar.
index a36e7a444ab2cc4f87355778e82dc91e421bd1dd..52ed8be8a536007f18052999396186c2483f4508 100644 (file)
@@ -74,7 +74,7 @@ public:
             const wxSize& size = wxDefaultSize,
             long style = wxGA_HORIZONTAL,
             const wxValidator& validator = wxDefaultValidator,
-            const wxString& name = "gauge");
+            const wxString& name = wxGaugeNameStr);
 
     /**
         Destructor, destroying the gauge.
index 887e55d76db10c59fb88baa1a71d4675c2b1063f..9f0ab531f07d8de08ac58492aebf7e1b5c75d016 100644 (file)
@@ -261,7 +261,7 @@ public:
 
         @return @false if an error occurred.
     */
-    bool SetCurrent(const wxGLContext context);
+    bool SetCurrent(const wxGLContext& context) const;
 
     /**
         Swaps the double-buffer of this window, making the back-buffer the
index 190aed1da32d33559b236ed28bc866bdef79b5f4..f9427a950f3edf380ebab3cd1923440b81270991 100644 (file)
@@ -53,9 +53,9 @@ public:
         Adds a cubic bezier curve from the current point, using two control
         points and an end point.
     */
-    void AddCurveToPoint(wxDouble cx1, wxDouble cy1,
-                         wxDouble cx2, wxDouble cy2,
-                         wxDouble x, wxDouble y);
+    virtual void AddCurveToPoint(wxDouble cx1, wxDouble cy1,
+                                 wxDouble cx2, wxDouble cy2,
+                                 wxDouble x, wxDouble y);
     /**
         Adds a cubic bezier curve from the current point, using two control
         points and an end point.
@@ -319,12 +319,12 @@ public:
         Creates a native brush, having a linear gradient, starting at (x1,y1) with
         color c1 to (x2,y2) with color c2
     */
-    wxGraphicsBrush CreateLinearGradientBrush(wxDouble x1,
-            wxDouble y1,
-            wxDouble x2,
-            wxDouble y2,
-            const wxColouramp;c1,
-            const wxColouramp;c2) const;
+    virtual wxGraphicsBrush CreateLinearGradientBrush(wxDouble x1,
+                                                      wxDouble y1,
+                                                      wxDouble x2,
+                                                      wxDouble y2,
+                                                      const wxColour& c1,
+                                                      const wxColour& c2) const;
 
     /**
         Creates a native affine transformation matrix from the passed in values. The
@@ -332,8 +332,8 @@ public:
     */
     virtual wxGraphicsMatrix CreateMatrix(wxDouble a = 1.0, wxDouble b = 0.0,
                                           wxDouble c = 0.0, wxDouble d = 1.0,
-                                  wxDouble tx = 0.0,
-                                  wxDouble ty = 0.0) const;
+                                          wxDouble tx = 0.0,
+                                          wxDouble ty = 0.0) const;
 
     /**
         Creates a native graphics path which is initially empty.
@@ -585,11 +585,11 @@ public:
         color c1 to (x2,y2) with color c2
     */
     wxGraphicsBrush CreateLinearGradientBrush(wxDouble x1,
-            wxDouble y1,
-            wxDouble x2,
-            wxDouble y2,
-            const wxColouramp;c1,
-            const wxColouramp;c2);
+                                              wxDouble y1,
+                                              wxDouble x2,
+                                              wxDouble y2,
+                                              const wxColour& c1,
+                                              const wxColour& c2) = 0;
 
     /**
         Creates a native affine transformation matrix from the passed in values. The
@@ -597,7 +597,7 @@ public:
     */
     virtual wxGraphicsMatrix CreateMatrix(wxDouble a = 1.0, wxDouble b = 0.0,
                                           wxDouble c = 0.0, wxDouble d = 1.0,
-                                  wxDouble tx = 0.0,
+                                          wxDouble tx = 0.0,
                                           wxDouble ty = 0.0) = 0;
 
     /**
index 2d400ab0f24b3db73d9eb2f3afc4b94545bd98d9..3777a22a1e5be7c21d000c1cb6066c98c007dc27 100644 (file)
@@ -1680,7 +1680,7 @@ public:
     /**
         Overridden wxWindow method.
     */
-    void Fit();
+    virtual void Fit();
 
     /**
         Causes immediate repainting of the grid.
index b14e32f539f9a9979c54ccb7d93fe816ccd4e5c2..200314dd925cdf7776ee69e4ec15d540c33fc7dd 100644 (file)
@@ -54,7 +54,7 @@ public:
         Constructor. @a key_type is one of wxKEY_INTEGER, or wxKEY_STRING,
         and indicates what sort of keying is required. @a size is optional.
     */
-    wxHashTable(unsigned int key_type, int size = 1000);
+    wxHashTable(wxKeyType key_type = wxKEY_INTEGER, size_t size = 1000);
 
     /**
         Destroys the hash table.
index 83dc2b5127729ebbbd4df4bb148a920ac6a4cba6..3b0803bf0d74fc06a5e99a65240e846aed093b23 100644 (file)
@@ -101,7 +101,7 @@ public:
         @param showWaitMsg
             If @true then a decoration-less window with progress message is displayed.
     */
-    bool AddBook(const wxFileName& bookFile, bool showWaitMsg);
+    bool AddBook(const wxFileName& bookFile, bool showWaitMsg = false);
 
     /**
         Adds a book (i.e. a @ref overview_html_helpformats ".hhp file"; an HTML Help
@@ -115,7 +115,7 @@ public:
         @param showWaitMsg
             If @true then a decoration-less window with progress message is displayed.
     */
-    bool AddBook(const wxString& bookUrl, bool showWaitMsg);
+    bool AddBook(const wxString& bookUrl, bool showWaitMsg = false);
 
     /**
         Displays page @a x.
@@ -133,14 +133,14 @@ public:
         -# try to find x in index (if x is for example "How To ...")
         -# switch to Search panel and start searching
     */
-    void Display(const wxString& x);
+    bool Display(const wxString& x);
 
     /**
         @overload
 
         This alternative form is used to search help contents by numeric IDs.
     */
-    void Display(const int id);
+    bool Display(int id);
 
     /**
         Displays help window and focuses contents panel.
index a53c0ef7f6540de8c47429724bde3c46c7d8364d..68153b12b29bc3bca9ef8cdd8414b064350a168a 100644 (file)
@@ -29,7 +29,9 @@ public:
     wxHtmlHelpFrame(wxWindow* parent, int wxWindowID,
                     const wxString& title = wxEmptyString,
                     int style = wxHF_DEFAULT_STYLE,
-                    wxHtmlHelpData* data = NULL);
+                    wxHtmlHelpData* data = NULL,
+                    wxConfigBase* config = NULL,
+                    const wxString& rootpath = wxEmptyString);
 
     /**
         You may override this virtual method to add more buttons to the help window's
index 20ff8e07d498015ac788b28e3fa96678d4912f7c..82dfb28c4933c51dfb698201ded474b8d7fedc61 100644 (file)
@@ -139,7 +139,7 @@ public:
     /**
         Parses the m_Source from @a begin_pos to @a end_pos - 1.
     */
-    void DoParsing(int begin_pos, int end_pos);
+    void DoParsing(const const_iterator& begin_pos, const const_iterator& end_pos);
 
     /**
         Parses the whole m_Source.
index 903d23ff3a4321a63333bc7d35f92cbd32c7accf..10136ab2023a3b9f67b631472282e1ad38677ab5 100644 (file)
@@ -148,6 +148,7 @@ public:
     */
     bool HasParam(const wxString& par) const;
 
+    //@{
     /**
         This method scans the given parameter. Usage is exactly the same as sscanf's
         usage except that you don't pass a string but a parameter name as the first
@@ -161,6 +162,8 @@ public:
         @param value
             pointer to a variable to store the value in
     */
-    wxString ScanParam(const wxString& par, const wxChar* format, void* value) const;
+    int ScanParam(const wxString& par, const wchar_t* format, void* value) const;
+    int ScanParam(const wxString& par, const char* format, void* value) const;
+    //@}
 };
 
index 2aa8bb3c9ef6692d399bb3c24fe12d6efa72d63a..ecadb27cfce17cecdf4ed8818b2fc122e01ecac6 100644 (file)
@@ -61,12 +61,11 @@ public:
         Constructor.
         The parameters are the same as wxScrolled::wxScrolled() constructor.
     */
-    wxHtmlWindow(wxWindow parent, wxWindowID id = -1,
+    wxHtmlWindow(wxWindow *parent, wxWindowID id = wxID_ANY,
                  const wxPoint& pos = wxDefaultPosition,
                  const wxSize& size = wxDefaultSize,
                  long style = wxHW_DEFAULT_STYLE,
                  const wxString& name = "htmlWindow");
-    //@}
 
     /**
         Adds @ref overview_html_filters "input filter" to the static list of available
@@ -464,7 +463,8 @@ public:
     */
     wxHtmlCellEvent(wxEventType commandType, int id,
                     wxHtmlCell* cell,
-                    const wxPoint& point);
+                    const wxPoint& point,
+                    const wxMouseEvent& ev);
 
     /**
         Returns the wxHtmlCellEvent associated with the event.
index 3cf0281c07e933c2f511b4cb7057f571df0607f2..268189df7ed3716cadb0fc23d8283cd0e31d0edc 100644 (file)
@@ -59,7 +59,7 @@ public:
         <b>Render() changes the DC's user scale and does NOT restore it.</b>
     */
     int Render(int x, int y, wxArrayInt& known_pagebreaks, int from = 0,
-               int dont_render = 0, int to = INT_MAX);
+               int dont_render = false, int to = INT_MAX);
 
     /**
         Assign DC instance to the renderer.
index 3f5e9dcf25542847c0da075306fb0b83ac195611..bab04d6e6df69ff4f1f7c2094ae68ea32cd2a1c2 100644 (file)
@@ -90,24 +90,13 @@ public:
         @param bits
             Specifies an array of pixel values.
         @param width
-            Specifies the width of the bitmap.
+            The width of the image.
         @param height
-            Specifies the height of the bitmap.
-        @param depth
-            Specifies the depth of the bitmap.
-            If this is omitted, then a value of 1 (monochrome bitmap) is used.
-    */
-    wxIcon(const char bits[], int width, int height, int depth = 1);
-
-
-    /**
-        Creates a new icon. A depth of ::wxICON_SCREEN_DEPTH indicates the
-        depth of the current screen or visual.
+            The height of the image.
 
-        Some platforms only support 1 for monochrome and ::wxICON_SCREEN_DEPTH for
-        the current colour setting.
+        @onlyfor{wxmsw,wxmac}
     */
-    wxIcon(int width, int height, int depth = wxICON_SCREEN_DEPTH);
+    wxIcon(const char bits[], int width, int height);
 
     /**
         Creates a bitmap from XPM data.
index 0b4335242a76d503afb57a313f2f918b9d78ad0c..9e35cc0dde6c1a45a6fb31b59f1716615f236fe1 100644 (file)
@@ -73,7 +73,7 @@ public:
     /**
         Same as @code GetIcon( wxSize( size, size ) ) @endcode.
     */
-    const wxIcon  GetIcon(wxCoord size = -1) const;
+    wxIcon GetIcon(wxCoord size = wxDefaultCoord) const;
 
     /**
         Returns the icon with exactly the given size or ::wxNullIcon if this
index 0f874d9da4043c29af0716ce110d69d2165bd8b4..ef8b2a9d8303606676d1ca36a3b861cb727f8619 100644 (file)
@@ -405,8 +405,10 @@ public:
     @class wxLogStderr
 
     This class can be used to redirect the log messages to a C file stream (not to
-    be confused with C++ streams). It is the default log target for the non-GUI
-    wxWidgets applications which send all the output to @c stderr.
+    be confused with C++ streams).
+
+    It is the default log target for the non-GUI wxWidgets applications which
+    send all the output to @c stderr.
 
     @library{wxbase}
     @category{logging}
@@ -527,6 +529,9 @@ public:
     Otherwise, it is completely hidden behind the @e wxLogXXX() functions and
     you may not even know about its existence.
 
+    @note For console-mode applications, the default target is wxLogStderr, so
+          that all @e wxLogXXX() functions print on @c stderr when @c wxUSE_GUI = 0.
+
 
     @section log_derivingyours Deriving your own log target
 
@@ -627,7 +632,8 @@ public:
     @li SetRepetitionCounting()
     @li GetRepetitionCounting()
 
-    @note Timestamping is disabled for Visual C++ users in debug builds by
+    @note
+    Timestamping is disabled for Visual C++ users in debug builds by
     default because otherwise it would be impossible to directly go to the line
     from which the log message was generated by simply clicking in the debugger
     window on the corresponding error message. If you wish to enable it, please
index ade519c6fb2d07c1ae3f409206949c559bf2288d..bc0f7c33f5208c544f795138836f6d4776ddaf03 100644 (file)
@@ -1435,9 +1435,9 @@ public:
         only redrawing those areas, which have been exposed.
     */
     bool IsExposed(int x, int y) const;
-    const bool IsExposed(wxPoint amp;pt) const;
-    const bool IsExposed(int x, int y, int w, int h) const;
-    const bool IsExposed(wxRect amp;rect) const;
+    bool IsExposed(wxPoint& pt) const;
+    bool IsExposed(int x, int y, int w, int h) const;
+    bool IsExposed(wxRect& rect) const;
     //@}
 
     /**