/////////////////////////////////////////////////////////////////////////////
// Name: treebook.h
-// Purpose: documentation for wxTreebookEvent class
+// Purpose: interface of wxTreebookEvent
// Author: wxWidgets team
// RCS-ID: $Id$
// Licence: wxWindows license
@library{wxcore}
@category{events}
- @seealso
- wxNotebookEvent, wxTreebook
+ @see wxNotebookEvent, wxTreebook
*/
class wxTreebookEvent : public wxNotifyEvent
{
public:
/**
- @sa wxNotebookEvent
+ @see wxNotebookEvent
*/
- wxTreebookEvent(wxEventType commandType = wxEVT_@NULL, int id = 0,
+ wxTreebookEvent(wxEventType commandType = wxEVT_NULL, int id = 0,
int nSel = wxNOT_FOUND,
int nOldSel = wxNOT_FOUND);
Returns the page that was selected before the change, wxNOT_FOUND if none was
selected.
*/
- int GetOldSelection();
+ int GetOldSelection() const;
/**
Returns the currently selected page, or wxNOT_FOUND if none was selected.
*/
- int GetSelection();
+ int GetSelection() const;
};
+
/**
@class wxTreebook
@wxheader{treebook.h}
@library{wxcore}
@category{miscwnd}
- @seealso
- wxNotebook, wxTreebookEvent, wxImageList, @ref overview_samplenotebook
+ @see wxNotebook, wxTreebookEvent, wxImageList, @ref overview_samplenotebook
"notebook sample"
*/
class wxTreebook : public wxBookCtrl overview
Creates an empty TreeBook control.
@param parent
- The parent window. Must be non-@NULL.
-
+ The parent window. Must be non-@NULL.
@param id
- The window identifier.
-
+ The window identifier.
@param pos
- The window position.
-
+ The window position.
@param size
- The window size.
-
+ The window size.
@param style
- The window style. See wxNotebook.
-
+ The window style. See wxNotebook.
@param name
- The name of the control (used only under Motif).
+ The name of the control (used only under Motif).
*/
wxTreebook();
wxTreebook(wxWindow* parent, wxWindowID id,
/**
Destroys the wxTreebook object.
-
Also deletes all the pages owned by the control (inserted previously into it).
*/
~wxTreebook();
@NULL could be specified for page to create an empty page.
*/
bool AddPage(wxWindow* page, const wxString& text,
- bool bSelect = @false,
+ bool bSelect = false,
int imageId = wxNOT_FOUND);
/**
@NULL could be specified for page to create an empty page.
*/
bool AddSubPage(wxWindow* page, const wxString& text,
- bool bSelect = @false,
+ bool bSelect = false,
int imageId = wxNOT_FOUND);
/**
Sets the image list for the page control and takes ownership of the list.
- @sa wxImageList, SetImageList()
+ @see wxImageList, SetImageList()
*/
void AssignImageList(wxImageList* imageList);
/**
Changes the selection for the given page, returning the previous selection.
-
The call to this function does not generate the page changing events.
This is the only difference with SetSelection().
See @ref overview_progevent "this topic" for more info.
May generate page changing events (if selected page
is under the collapsed branch, then its parent is autoselected).
*/
- bool ExpandNode(size_t pageId, bool expand = @true);
+ bool ExpandNode(size_t pageId, bool expand = true);
/**
Returns the image index for the given page.
*/
- int GetPageImage(size_t n);
+ int GetPageImage(size_t n) const;
/**
Returns the parent page of the given one or @c wxNOT_FOUND if this is a
top-level page.
*/
- int GetPageParent(size_t page);
+ int GetPageParent(size_t page) const;
/**
Returns the string for the given page.
*/
- wxString GetPageText(size_t n);
+ wxString GetPageText(size_t n) const;
/**
Returns the currently selected page, or wxNOT_FOUND if none was selected.
-
Note that this method may return either the previously or newly selected page
when called from the EVT_TREEBOOK_PAGE_CHANGED handler
depending on the platform and so wxTreebookEvent::GetSelection should be used
instead in this case.
*/
- int GetSelection();
+ int GetSelection() const;
/**
Inserts a new page just before the page indicated by pagePos.
*/
bool InsertPage(size_t pagePos, wxWindow* page,
const wxString& text,
- bool bSelect = @false,
+ bool bSelect = false,
int imageId = wxNOT_FOUND);
/**
Inserts a sub page under the specified page.
-
@NULL could be specified for page to create an empty page.
*/
bool InsertSubPage(size_t pagePos, wxWindow* page,
const wxString& text,
- bool bSelect = @false,
+ bool bSelect = false,
int imageId = wxNOT_FOUND);
/**
Gets the pagePos page state -- whether it is expanded or collapsed
*/
- bool IsNodeExpanded(size_t pageId);
+ bool IsNodeExpanded(size_t pageId) const;
/**
Sets the image list for the page control. It does not take ownership of the
image list, you must delete it yourself.
- @sa wxImageList, AssignImageList()
+ @see wxImageList, AssignImageList()
*/
void SetImageList(wxImageList* imageList);
/**
Sets the selection for the given page, returning the previous selection.
-
The call to this function generates the page changing events.
-
This function is deprecated and should not be used in new code. Please use the
ChangeSelection() function instead.
- @sa GetSelection()
+ @see GetSelection()
*/
int SetSelection(size_t n);
};
+
projects / wxWidgets.git / blobdiff