Finished initial review of some [co*] interface headers.
git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@53098 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
This commit is contained in:
@@ -1,6 +1,6 @@
|
||||
/////////////////////////////////////////////////////////////////////////////
|
||||
// Name: collpane.h
|
||||
// Purpose: interface of wxCollapsiblePaneEvent
|
||||
// Purpose: interface of wxCollapsiblePane
|
||||
// Author: wxWidgets team
|
||||
// RCS-ID: $Id$
|
||||
// Licence: wxWindows license
|
||||
@@ -10,11 +10,15 @@
|
||||
@class wxCollapsiblePaneEvent
|
||||
@wxheader{collpane.h}
|
||||
|
||||
This event class is used for the events generated by
|
||||
wxCollapsiblePane.
|
||||
This event class is used for the events generated by wxCollapsiblePane.
|
||||
|
||||
@beginEventTable{wxCollapsiblePaneEvent}
|
||||
@event{EVT_COLLAPSIBLEPANE_CHANGED(id, func)}
|
||||
The user expanded or collapsed the collapsible pane.
|
||||
@endEventTable
|
||||
|
||||
@library{wxcore}
|
||||
@category{FIXME}
|
||||
@category{events}
|
||||
|
||||
@see wxCollapsiblePane
|
||||
*/
|
||||
@@ -24,8 +28,7 @@ public:
|
||||
/**
|
||||
The constructor is not normally used by the user code.
|
||||
*/
|
||||
wxCollapsiblePaneEvent(wxObject* generator, int id,
|
||||
bool collapsed);
|
||||
wxCollapsiblePaneEvent(wxObject* generator, int id, bool collapsed);
|
||||
|
||||
/**
|
||||
Returns @true if the pane has been collapsed.
|
||||
@@ -34,8 +37,7 @@ public:
|
||||
|
||||
/**
|
||||
Sets this as a collapsed pane event (if @a collapsed is @true) or as an
|
||||
expanded
|
||||
pane event (if @a collapsed is @false).
|
||||
expanded pane event (if @a collapsed is @false).
|
||||
*/
|
||||
void SetCollapsed(bool collapsed);
|
||||
};
|
||||
@@ -46,43 +48,36 @@ public:
|
||||
@class wxCollapsiblePane
|
||||
@wxheader{collpane.h}
|
||||
|
||||
A collapsible pane is a container with an embedded button-like control which
|
||||
can be
|
||||
used by the user to collapse or expand the pane's contents.
|
||||
A collapsible pane is a container with an embedded button-like control
|
||||
which can be used by the user to collapse or expand the pane's contents.
|
||||
|
||||
Once constructed you should use the wxCollapsiblePane::GetPane
|
||||
function to access the pane and add your controls inside it (i.e. use the
|
||||
wxCollapsiblePane::GetPane's returned pointer as parent for the
|
||||
controls which must go in the pane, NOT the wxCollapsiblePane itself!).
|
||||
Once constructed you should use the GetPane() function to access the pane
|
||||
and add your controls inside it (i.e. use the returned pointer from
|
||||
GetPane() as parent for the controls which must go in the pane, @b not the
|
||||
wxCollapsiblePane itself!).
|
||||
|
||||
Note that because of its nature of control which can dynamically (and
|
||||
drastically)
|
||||
change its size at run-time under user-input, when putting wxCollapsiblePane
|
||||
inside
|
||||
a wxSizer you should be careful to add it with a proportion value
|
||||
of zero; this is because otherwise all other windows with non-null proportion
|
||||
values
|
||||
would automatically get resized each time the user expands or collapse the pane
|
||||
window
|
||||
resulting usually in a weird, flickering effect.
|
||||
drastically) change its size at run-time under user-input, when putting
|
||||
wxCollapsiblePane inside a wxSizer you should be careful to add it with a
|
||||
proportion value of zero; this is because otherwise all other windows with
|
||||
non-null proportion values will automatically resize each time the user
|
||||
expands or collapse the pane window usually resulting in a weird,
|
||||
flickering effect.
|
||||
|
||||
Usage sample:
|
||||
|
||||
@code
|
||||
wxCollapsiblePane *collpane = new wxCollapsiblePane(this, wxID_ANY,
|
||||
wxT("Details:"));
|
||||
wxCollapsiblePane *collpane = new wxCollapsiblePane(this, wxID_ANY, wxT("Details:"));
|
||||
|
||||
// add the pane with a zero proportion value to the 'sz' sizer which
|
||||
contains it
|
||||
sz-Add(collpane, 0, wxGROW|wxALL, 5);
|
||||
// add the pane with a zero proportion value to the 'sz' sizer which contains it
|
||||
sz->Add(collpane, 0, wxGROW|wxALL, 5);
|
||||
|
||||
// now add a test label in the collapsible pane using a sizer to layout it:
|
||||
wxWindow *win = collpane-GetPane();
|
||||
wxSizer *paneSz = new wxBoxSizer(wxVERTICAL);
|
||||
paneSz-Add(new wxStaticText(win, wxID_ANY, wxT("test!")), 1, wxGROW|wxALL,
|
||||
2);
|
||||
win-SetSizer(paneSz);
|
||||
paneSz-SetSizeHints(win);
|
||||
// now add a test label in the collapsible pane using a sizer to layout it:
|
||||
wxWindow *win = collpane->GetPane();
|
||||
wxSizer *paneSz = new wxBoxSizer(wxVERTICAL);
|
||||
paneSz->Add(new wxStaticText(win, wxID_ANY, wxT("test!")), 1, wxGROW|wxALL, 2);
|
||||
win->SetSizer(paneSz);
|
||||
paneSz->SetSizeHints(win);
|
||||
@endcode
|
||||
|
||||
It is only available if @c wxUSE_COLLPANE is set to 1 (the default).
|
||||
@@ -92,9 +87,14 @@ public:
|
||||
The default style: 0.
|
||||
@endStyleTable
|
||||
|
||||
@beginEventTable{wxCollapsiblePaneEvent}
|
||||
@event{EVT_COLLAPSIBLEPANE_CHANGED(id, func)}
|
||||
The user expanded or collapsed the collapsible pane.
|
||||
@endEventTable
|
||||
|
||||
@library{wxcore}
|
||||
@category{ctrl}
|
||||
@appearance{collapsiblepane.png}
|
||||
<!-- @appearance{collapsiblepane.png} -->
|
||||
|
||||
@see wxPanel, wxCollapsiblePaneEvent
|
||||
*/
|
||||
@@ -102,8 +102,7 @@ class wxCollapsiblePane : public wxControl
|
||||
{
|
||||
public:
|
||||
/**
|
||||
Initializes the object and calls Create() with
|
||||
all the parameters.
|
||||
Initializes the object and calls Create() with all the parameters.
|
||||
*/
|
||||
wxCollapsiblePane(wxWindow* parent, wxWindowID id,
|
||||
const wxString& label,
|
||||
@@ -113,19 +112,14 @@ public:
|
||||
const wxValidator& validator = wxDefaultValidator,
|
||||
const wxString& name = "collapsiblePane");
|
||||
|
||||
/**
|
||||
Collapses or expands the pane window.
|
||||
*/
|
||||
void Collapse(bool collapse = true);
|
||||
|
||||
/**
|
||||
@param parent
|
||||
Parent window, must not be non-@NULL.
|
||||
@param id
|
||||
The identifier for the control.
|
||||
@param label
|
||||
The initial label shown in the button which allows the user to expand or
|
||||
collapse the pane window.
|
||||
The initial label shown in the button which allows the user to
|
||||
expand or collapse the pane window.
|
||||
@param pos
|
||||
Initial position.
|
||||
@param size
|
||||
@@ -149,13 +143,18 @@ public:
|
||||
const wxString& name = "collapsiblePane");
|
||||
|
||||
/**
|
||||
Same as @c wxCollapsiblePane::Collapse(@false).
|
||||
Collapses or expands the pane window.
|
||||
*/
|
||||
void Collapse(bool collapse = true);
|
||||
|
||||
/**
|
||||
Same as calling Collapse(@false).
|
||||
*/
|
||||
void Expand();
|
||||
|
||||
/**
|
||||
Returns a pointer to the pane window. Add controls to the returned wxWindow
|
||||
to make them collapsible.
|
||||
Returns a pointer to the pane window. Add controls to the returned
|
||||
wxWindow to make them collapsible.
|
||||
*/
|
||||
wxWindow* GetPane() const;
|
||||
|
||||
|
Reference in New Issue
Block a user