removed @NULL,@true,@false tags from the function prototypes; fixed * and & displacing in the prototypes; changed @param as discussed on wx-dev; use @see instead of @sa; better indentation for @returns,@remarks,@see paragraphs; other misc fixes
git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@52407 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
This commit is contained in:
Francesco Montorsi
@@ -42,21 +42,19 @@ public:
|
||||
Constructor, creating the window.
|
||||
|
||||
@param parent
|
||||
The window parent, usually a frame.
|
||||
|
||||
The window parent, usually a frame.
|
||||
@param id
|
||||
The window identifier. It may take a value of -1 to indicate a default value.
|
||||
|
||||
The window identifier. It may take a value of -1 to indicate a default
|
||||
value.
|
||||
@param style
|
||||
The window style. See wxStatusBar.
|
||||
|
||||
The window style. See wxStatusBar.
|
||||
@param name
|
||||
The name of the window. This parameter is used to associate a name with the
|
||||
The name of the window. This parameter is used to associate a name with the
|
||||
item,
|
||||
allowing the application user to set Motif resource values for
|
||||
individual windows.
|
||||
allowing the application user to set Motif resource values for
|
||||
individual windows.
|
||||
|
||||
@sa Create()
|
||||
@see Create()
|
||||
*/
|
||||
wxStatusBar();
|
||||
wxStatusBar(wxWindow* parent, wxWindowID id = wxID_ANY,
|
||||
@@ -71,7 +69,6 @@ public:
|
||||
|
||||
/**
|
||||
Creates the window, for two-step construction.
|
||||
|
||||
See wxStatusBar() for details.
|
||||
*/
|
||||
bool Create(wxWindow* parent, wxWindowID id = wxID_ANY,
|
||||
@@ -82,14 +79,13 @@ public:
|
||||
Returns the size and position of a field's internal bounding rectangle.
|
||||
|
||||
@param i
|
||||
The field in question.
|
||||
|
||||
The field in question.
|
||||
@param rect
|
||||
The rectangle values are placed in this variable.
|
||||
The rectangle values are placed in this variable.
|
||||
|
||||
@returns @true if the field index is valid, @false otherwise.
|
||||
|
||||
@sa wxRect
|
||||
@see wxRect
|
||||
*/
|
||||
virtual bool GetFieldRect(int i, wxRect& rect);
|
||||
|
||||
@@ -102,12 +98,12 @@ public:
|
||||
Returns the string associated with a status bar field.
|
||||
|
||||
@param i
|
||||
The number of the status field to retrieve, starting from zero.
|
||||
The number of the status field to retrieve, starting from zero.
|
||||
|
||||
@returns The status field string if the field is valid, otherwise the
|
||||
empty string.
|
||||
empty string.
|
||||
|
||||
@sa SetStatusText()
|
||||
@see SetStatusText()
|
||||
*/
|
||||
virtual wxString GetStatusText(int i = 0);
|
||||
|
||||
@@ -115,7 +111,7 @@ public:
|
||||
Sets the field text to the top of the stack, and pops the stack of saved
|
||||
strings.
|
||||
|
||||
@sa PushStatusText()
|
||||
@see PushStatusText()
|
||||
*/
|
||||
void PopStatusText(int field = 0);
|
||||
|
||||
@@ -129,13 +125,12 @@ public:
|
||||
Sets the number of fields, and optionally the field widths.
|
||||
|
||||
@param number
|
||||
The number of fields.
|
||||
|
||||
The number of fields.
|
||||
@param widths
|
||||
An array of n integers interpreted in the same way as
|
||||
in SetStatusWidths
|
||||
An array of n integers interpreted in the same way as
|
||||
in SetStatusWidths
|
||||
*/
|
||||
virtual void SetFieldsCount(int number = 1, int* widths = @NULL);
|
||||
virtual void SetFieldsCount(int number = 1, int* widths = NULL);
|
||||
|
||||
/**
|
||||
Sets the minimal possible height for the status bar. The real height may be
|
||||
@@ -150,42 +145,59 @@ public:
|
||||
or raised instead of the standard sunken 3D border.
|
||||
|
||||
@param n
|
||||
The number of fields in the status bar. Must be equal to the
|
||||
number passed to SetFieldsCount the last
|
||||
time it was called.
|
||||
|
||||
The number of fields in the status bar. Must be equal to the
|
||||
number passed to SetFieldsCount the last
|
||||
time it was called.
|
||||
@param styles
|
||||
Contains an array of n integers with the styles for each field. There
|
||||
are three possible styles:
|
||||
Contains an array of n integers with the styles for each field. There
|
||||
are three possible styles:
|
||||
|
||||
|
||||
wxSB_NORMAL
|
||||
|
||||
|
||||
(default) The field appears sunken with a standard 3D border.
|
||||
|
||||
wxSB_FLAT
|
||||
|
||||
|
||||
No border is painted around the field so that it appears flat.
|
||||
|
||||
wxSB_RAISED
|
||||
wxSB_NORMAL
|
||||
|
||||
|
||||
A raised 3D border is painted around the field.
|
||||
|
||||
|
||||
(default) The field appears sunken with a standard 3D border.
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
wxSB_FLAT
|
||||
|
||||
|
||||
|
||||
|
||||
No border is painted around the field so that it appears flat.
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
wxSB_RAISED
|
||||
|
||||
|
||||
|
||||
|
||||
A raised 3D border is painted around the field.
|
||||
*/
|
||||
virtual void SetStatusStyles(int n, int * styles);
|
||||
virtual void SetStatusStyles(int n, int* styles);
|
||||
|
||||
/**
|
||||
Sets the text for one field.
|
||||
|
||||
@param text
|
||||
The text to be set. Use an empty string ("") to clear the field.
|
||||
|
||||
The text to be set. Use an empty string ("") to clear the field.
|
||||
@param i
|
||||
The field to set, starting from zero.
|
||||
The field to set, starting from zero.
|
||||
|
||||
@sa GetStatusText(), wxFrame::SetStatusText
|
||||
@see GetStatusText(), wxFrame::SetStatusText
|
||||
*/
|
||||
virtual void SetStatusText(const wxString& text, int i = 0);
|
||||
|
||||
@@ -197,27 +209,25 @@ public:
|
||||
the space left for all variable width fields is divided between them according
|
||||
to the absolute value of this number. A variable width field with width of -2
|
||||
gets twice as much of it as a field with width -1 and so on.
|
||||
|
||||
For example, to create one fixed width field of width 100 in the right part of
|
||||
the status bar and two more fields which get 66% and 33% of the remaining
|
||||
space correspondingly, you should use an array containing -2, -1 and 100.
|
||||
|
||||
@param n
|
||||
The number of fields in the status bar. Must be equal to the
|
||||
number passed to SetFieldsCount the last
|
||||
time it was called.
|
||||
|
||||
The number of fields in the status bar. Must be equal to the
|
||||
number passed to SetFieldsCount the last
|
||||
time it was called.
|
||||
@param widths
|
||||
Contains an array of n integers, each of which is
|
||||
either an absolute status field width in pixels if positive or indicates a
|
||||
variable width field if negative.
|
||||
Contains an array of n integers, each of which is
|
||||
either an absolute status field width in pixels if positive or indicates a
|
||||
variable width field if negative.
|
||||
|
||||
@remarks The widths of the variable fields are calculated from the total
|
||||
width of all fields, minus the sum of widths of the
|
||||
non-variable fields, divided by the number of
|
||||
variable fields.
|
||||
width of all fields, minus the sum of widths of the
|
||||
non-variable fields, divided by the number of variable
|
||||
fields.
|
||||
|
||||
@sa SetFieldsCount(), wxFrame::SetStatusWidths
|
||||
@see SetFieldsCount(), wxFrame::SetStatusWidths
|
||||
*/
|
||||
virtual void SetStatusWidths(int n, int * widths);
|
||||
virtual void SetStatusWidths(int n, int* widths);
|
||||
};
|
||||
|
||||
Reference in New Issue
Block a user