name wxStaticBoxSizer; some other minor wording clarifications

git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@60245 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
This commit is contained in:
Francesco Montorsi
2009-04-19 19:46:36 +00:00
parent ea0022d356
commit f3289ffb1f
2 changed files with 22 additions and 15 deletions

View File

@@ -9,24 +9,27 @@
/**
@class wxStaticBox
A static box is a rectangle drawn around other panel items to denote
A static box is a rectangle drawn around other windows to denote
a logical grouping of items.
Please note that a static box should @b not be used as the parent for the
controls it contains, instead they should be siblings of each other. Although
using a static box as a parent might work in some versions of wxWidgets, it
results in a crash under, for example, wxGTK.
controls it contains, instead they should be @b siblings of each other.
Although using a static box as a parent might work in some ports of wxWidgets,
it would result in a crash under, for example, wxGTK, and thus it's explicitely
disallowed (an assertion will fail if you try to add children to a wxStaticBox).
Also, please note that because of this, the order in which you create new
controls is important. Create your wxStaticBox control @b before any
siblings that are to appear inside the wxStaticBox in order to preserve the
correct Z-Order of controls.
correct Z-order of controls.
You may want to use wxStaticBoxSizer instead of wxStaticBox to avoid this problem.
@library{wxcore}
@category{ctrl}
@appearance{staticbox.png}
@see wxStaticText
@see wxStaticText, wxStaticBoxSizer
*/
class wxStaticBox : public wxControl
{
@@ -47,10 +50,10 @@ public:
Text to be displayed in the static box, the empty string for no label.
@param pos
Window position.
If wxDefaultPosition is specified then a default position is chosen.
If ::wxDefaultPosition is specified then a default position is chosen.
@param size
Checkbox size.
If wxDefaultSize is specified then a default size is chosen.
If ::wxDefaultSize is specified then a default size is chosen.
@param style
Window style. See wxStaticBox.
@param name