ifacecheck manual fixes

git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@56720 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
This commit is contained in:
Francesco Montorsi 2008-11-09 16:46:52 +00:00
parent c9c1faa490
commit a44f3b5a89
24 changed files with 101 additions and 88 deletions

View 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,

View 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

View 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.

View 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.

View 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.

View 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.

View 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);
};

View 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.

View 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.

View 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.

View 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

View 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;
/**

View File

@ -1680,7 +1680,7 @@ public:
/**
Overridden wxWindow method.
*/
void Fit();
virtual void Fit();
/**
Causes immediate repainting of the grid.

View 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.

View 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.

View 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

View 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.

View 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;
//@}
};

View 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.

View 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.

View 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.
The height of the image.
@onlyfor{wxmsw,wxmac}
*/
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.
Some platforms only support 1 for monochrome and ::wxICON_SCREEN_DEPTH for
the current colour setting.
*/
wxIcon(int width, int height, int depth = wxICON_SCREEN_DEPTH);
wxIcon(const char bits[], int width, int height);
/**
Creates a bitmap from XPM data.

View 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

View 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

View 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;
//@}
/**