]> git.saurik.com Git - wxWidgets.git/blob - interface/statbox.h
don't allow editing listbox entries; better handling of scrollbar styles (#9084)
[wxWidgets.git] / interface / statbox.h
1 /////////////////////////////////////////////////////////////////////////////
2 // Name: statbox.h
3 // Purpose: interface of wxStaticBox
4 // Author: wxWidgets team
5 // RCS-ID: $Id$
6 // Licence: wxWindows license
7 /////////////////////////////////////////////////////////////////////////////
8
9 /**
10 @class wxStaticBox
11 @wxheader{statbox.h}
12
13 A static box is a rectangle drawn around other panel items to denote
14 a logical grouping of items.
15
16 Please note that a static box should @b not be used as the parent for the
17 controls it contains, instead they should be siblings of each other. Although
18 using a static box as a parent might work in some versions of wxWidgets, it
19 results in a crash under, for example, wxGTK.
20
21 Also, please note that because of this, the order in which you create new
22 controls is important. Create your wxStaticBox control @b before any
23 siblings that are to appear inside the wxStaticBox in order to preserve the
24 correct Z-Order of controls.
25
26 @library{wxcore}
27 @category{ctrl}
28 <!-- @appearance{staticbox.png} -->
29
30 @see wxStaticText
31 */
32 class wxStaticBox : public wxControl
33 {
34 public:
35 /**
36 Default constructor
37 */
38 wxStaticBox();
39
40 /**
41 Constructor, creating and showing a static box.
42
43 @param parent
44 Parent window. Must not be @NULL.
45 @param id
46 Window identifier. The value wxID_ANY indicates a default value.
47 @param label
48 Text to be displayed in the static box, the empty string for no label.
49 @param pos
50 Window position. If wxDefaultPosition is specified then a default
51 position is chosen.
52 @param size
53 Checkbox size. If the size (-1, -1) is specified then a default size is
54 chosen.
55 @param style
56 Window style. See wxStaticBox.
57 @param name
58 Window name.
59
60 @see Create()
61 */
62 wxStaticBox(wxWindow* parent, wxWindowID id,
63 const wxString& label,
64 const wxPoint& pos = wxDefaultPosition,
65 const wxSize& size = wxDefaultSize,
66 long style = 0,
67 const wxString& name = "staticBox");
68
69 /**
70 Destructor, destroying the group box.
71 */
72 ~wxStaticBox();
73
74 /**
75 Creates the static box for two-step construction. See wxStaticBox()
76 for further details.
77 */
78 bool Create(wxWindow* parent, wxWindowID id,
79 const wxString& label,
80 const wxPoint& pos = wxDefaultPosition,
81 const wxSize& size = wxDefaultSize,
82 long style = 0,
83 const wxString& name = "staticBox");
84 };
85