From c55488dffffe600f789e0ab53c531675f11b411b Mon Sep 17 00:00:00 2001
From: Vadim Zeitlin <vadim@wxwidgets.org>
Date: Sat, 30 Jun 2012 23:41:23 +0000
Subject: [PATCH] Add skeleton documentation for wxAuiNotebook-related classes.

Closes #14386.

git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@71907 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
---
 .../images/generic/auidefaulttabart.png       | Bin 0 -> 3518 bytes
 .../images/generic/auisimpletabart.png        | Bin 0 -> 2235 bytes
 docs/doxygen/overviews/aui.h                  |   3 +
 interface/wx/aui/auibook.h                    | 331 +++++++++++++++++-
 interface/wx/aui/dockart.h                    | 121 ++++++-
 interface/wx/aui/toolbar.h                    | 244 ++++++++++++-
 6 files changed, 675 insertions(+), 24 deletions(-)
 create mode 100644 docs/doxygen/images/generic/auidefaulttabart.png
 create mode 100644 docs/doxygen/images/generic/auisimpletabart.png

diff --git a/docs/doxygen/images/generic/auidefaulttabart.png b/docs/doxygen/images/generic/auidefaulttabart.png
new file mode 100644
index 0000000000000000000000000000000000000000..91eb9b5073ea493ebcdaff26e88d0430954e93dc
GIT binary patch
literal 3518
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

literal 0
HcmV?d00001

diff --git a/docs/doxygen/images/generic/auisimpletabart.png b/docs/doxygen/images/generic/auisimpletabart.png
new file mode 100644
index 0000000000000000000000000000000000000000..cec1426863103036daadd154247311c800718520
GIT binary patch
literal 2235
zcmV;s2t@aZP)<h;3K|Lk000e1NJLTq00ATb001fo1^@s68iXb&00001b5ch_0Itp)
z=>Px#1ZP1_K>z@;j|==^1poj532;bRa{vGmbN~PnbOGLGA9w%&2vA8xK~#8N?VU?*
z>pBdEwW<uVnvAlJ&N9s=I?6ng7Ck6h6nzFQijLYvWCuFd(-civvLnZKzyiWW{g7pf
z{PdG@&lMjZACeo}fPH{{U<y7U-rn9MH?{%$0Q<lcd_cUuzDjOv1NH&-fhqWaczJn|
z+}H-}1MCA+@B#7s{4BY#4cG_R2d3Zy;`;hpa$_5?53mnR!3UB+`uqEnuuWmmJO&OP
z_JPav0daG4BV$cXIt8TT@hG{m4cG_R2TJ>ZxV^oVvBp4Rhb!%H+#mZ?n-7S)yE_?c
z3?z0Q1_=AWIekF<`}a@A+T4M3b#*1Vu?>dwfxf{y<d~+|cdng8^&?fgzrSy^IRXhz
zhU6c%z`zzz{+1hT&^L4Mxs>a2?WBS9@bEykIRVK{_Q3wf-LnN67Dxq~^UX_vOW*g%
zv6Fawe3Y>^7a*w@<sY`dSQcmtv{VrG4emMKmt!aK^z<ZSZ4N+U7>yN%{9I>&SfDYC
z!VQ5OJGK7l$kc(vFk&c7!2(pEF^rnKlR0+MHKf=d)%69^IVK|yM!#~qG(~%{+{$0z
zz5BI2E|zi&PWa>NecIQ5w{odB1;RekH}Vx(7V!3s*|?rxJYB!rWiaplce{zRgp-~%
znD|B5-_POyDrMWPoDaMIF68ELzRwiY^B0>#r=mVgH7Ps!T{i09Lg@pfa}@CMU}PMq
zcEq);5wn+T>zE2wwKLZap5?G}29g^)0`-ZpS@iZaM5YI%bHT^~2?F7;SyT`{ACyi3
zQp`@`{rz3WT2~;QV_UNejC6GD*Jh=JDkfNYg{<M@K$WR@W(*{(Ac~TtNM~SiScYn+
z?miz##ucoR$Wgx?-oXXeIblQr>3BTI&7zxXIi)z>7f5Y(5{JV<##$F3K^P4+F`Z##
zh~(9f^FtSmOYG<#Fi=eaN4BcU`*Q?HZ7X}7DpJ7_j<u0i1|SW`7z7+1Ckn2{7^>@`
zB5WUH*qOVw33bq?TNEn8QK_;&2GtszizxWZ0?B=oN3p2wT$ijsr&+5VNON{_RoQ>F
zt5YqlbgFBN;#tX^|JzXm9Cv>c2na}rja-0CKrA-$fcjePY@hnNrn)j?pi{y=KuWPe
ze13k)Sjz<xhEeLFeW=_IMmlM$>qwR)CIBiGw0AWi8{8mpoKsT4>(e|UP~yQ3#sQrq
zsBhIk^00K*R`4|SD$u}6-#X50AmxlP?5v@*ydtf}X~*Xm0A05M>9RVXg1YV_mP(fe
zl6o@=JZ&&i_jL02-AV>vP`|4=1&~sKZU7YmM#BL>B?cr1x5H)yYDyu@T;C8v8kV4c
z{Jf(cYYoUgKuX2F`1<;iv6c%Y^^hSIQhykk;0c4q1%!f7=+KSTz7053FaZSv6~k5q
zA~@GnSgwwRf)$P(sF;SLNR5+N^2wAfYmBHfq$&e-s1=X1F-U_wwAONM)2Og!7gx1H
zKxJ4SNEk{f7<C4cRxPy>(eT++$2<s>VggD<U#}p5j@zO(tRa~qH&j%pz#YJlNbmf!
z)P2q8IfyynbpcW?w8i)Lw~VzeK*CT;kudlCsW38Go2w&L&g=pxP)jPk*jpu42M$iX
z8tMdrpsg-LpTjGEGZ0Ay;oirlILUEl0x55dxHDLHv+uL4K%;jzl`ZZ0pm>gy7%r?Q
z>VDKFL~55UNNF=_NN}#H6b>HC4L0NR1_UOkRnQ~YU<Czt(}Glw*kub+G6SP9<$?+b
zj>Ccr!qO=>tja-pnG2*Y_7OinKQh+30trGX7dUO#6@if<lC2{xs}<Q4Nd1cJ)3hpx
zwDIc|nBJiSt~fa$HS0>TV4~pD4@h;5ZM`>kR<?D0t+zHU4j_P2!}gk8un?#@swJjR
z$MLQx^)6kC+QR|KLPEhs0l-4UrD+Nvcq`pO1s`t*f~ie4(nAle93Zu*EkdDDvD^hl
z>VDBi|2{x+P&ySz<zS?fwz`g#*m0|!9V)A^==)m*nf`<Tr%IrHQpaDVyj03Yool2>
z{S*@H8wREyXPZKTDNxoJiO%eOuI{DZojT@j1qx_szZ0X1;tde_)jF|gkg0S2E*nhK
zil=N!C0P*dAbgY}S#5xNf~utg14{MiT{e)S1?d-1OSwQIo`+*PrI5P9XfPm63r47p
zgj5iQRk+f|io7-;8nqkxdedi4!MG=oqJ6h0CRlv-iZN%5B;7#49oq(f)Cdaq0jO=N
zOr>k?kyMQf7Rejw1qCj%DG>Y4Z1AGCPTQ<{!L_1ArH+VQHK&ZyMQscuT#M?EviVdI
z?ebO7bUSrzK<WddNdl>?G6KOv?EcgXHvQGMMHy08AZ3W`5aAs!n5}f#_Ses+o`Gse
z$#F(xFdR$YZU4rzeLaZ!N*)5w!2(|AYEPAo$qzQ0JErFO;fJo&m-*?BEa@FKXS&q3
zf7eAA?`Zj5FSOehZq*x*IY6ZpN>D#i%7`dx!_N)0azk7H_-k-nM5n&g?hB*I0ckK8
zwdJLJjxBJa1x^XTt{|KG^{3imkQ!1SqcMz5j0(PeGz**>gni;=iuaVT!z6&jFd8kE
z_`wA%P$Ceg2$(KoDrJMwfy6K>5E0zPs1_&{j9maQrE5#R|ENG>7>yc7{P02+C>fAb
z0!_|XO27MPKw=mbiU#gxbPJRY${Y|(;hG`dyBCn~->vcQ{J$DvA7CFS;RC&ZH2RXn
z17HiV1uoJ845W*kR(>hAz&tI$K$_>g@u=AX7ij?o(nU@yzZ6?wo)%yr&2!#()NFx^
zv;YI?BBzyKiY+it3owx8Id42_w!lSNfPr+8)5<T!7MQ06{sU5OEbzzG)6oC`002ov
JPDHLkV1hS$25$fW

literal 0
HcmV?d00001

diff --git a/docs/doxygen/overviews/aui.h b/docs/doxygen/overviews/aui.h
index 031c7385c4..ed857ec3f2 100644
--- a/docs/doxygen/overviews/aui.h
+++ b/docs/doxygen/overviews/aui.h
@@ -16,8 +16,11 @@ Classes:
 @li wxAuiNotebook
 @li wxAuiDockArt
 @li wxAuiTabArt
+@li wxAuiDefaultTabArt
 @li wxAuiToolBar
 @li wxAuiToolBarArt
+@li wxAuiTabContainer
+@li wxAuiTabContainerButton
 
 wxAUI stands for Advanced User Interface. It aims to give the user a cutting
 edge interface with floatable windows, and a user-customizable layout. The
diff --git a/interface/wx/aui/auibook.h b/interface/wx/aui/auibook.h
index b95461b9ae..5253ea3a4a 100644
--- a/interface/wx/aui/auibook.h
+++ b/interface/wx/aui/auibook.h
@@ -9,7 +9,9 @@
 /**
     @class wxAuiNotebook
 
-    wxAuiNotebook is part of the wxAUI class framework.
+    wxAuiNotebook is part of the wxAUI class framework, which represents a
+    notebook control, managing multiple windows with associated tabs.
+
     See also @ref overview_aui.
 
     wxAuiNotebook is a notebook control which implements many features common in
@@ -368,14 +370,138 @@ public:
     bool ShowWindowMenu();
 };
 
+/**
+    @class wxAuiTabContainerButton
+
+    A simple class which holds information about wxAuiNotebook tab buttons and their state.
+
+    @library{wxaui}
+    @category{aui}
+*/
+class wxAuiTabContainerButton
+{
+public:
+    /// button's id
+    int id;
+    /// current state (normal, hover, pressed, etc.)
+    int curState;
+    /// buttons location (wxLEFT, wxRIGHT, or wxCENTER)
+    int location;
+    /// button's hover bitmap
+    wxBitmap bitmap;
+    /// button's disabled bitmap
+    wxBitmap disBitmap;
+    /// button's hit rectangle
+    wxRect rect;
+};
+
+
+/**
+    @class wxAuiTabContainer
+
+    wxAuiTabContainer is a class which contains information about each tab.
+    It also can render an entire tab control to a specified DC.
+    It's not a window class itself, because this code will be used by
+    the wxAuiNotebook, where it is disadvantageous to have separate
+    windows for each tab control in the case of "docked tabs".
+
+    A derived class, wxAuiTabCtrl, is an actual wxWindow - derived window
+    which can be used as a tab control in the normal sense.
+
+    @library{wxaui}
+    @category{aui}
+*/
+class wxAuiTabContainer
+{
+public:
+
+    /**
+        Default ctor.
+    */
+    wxAuiTabContainer();
+
+    /**
+        Default dtor.
+    */
+    virtual ~wxAuiTabContainer();
+
+    void SetArtProvider(wxAuiTabArt* art);
+    wxAuiTabArt* GetArtProvider() const;
+
+    void SetFlags(unsigned int flags);
+    unsigned int GetFlags() const;
+
+    bool AddPage(wxWindow* page, const wxAuiNotebookPage& info);
+    bool InsertPage(wxWindow* page, const wxAuiNotebookPage& info, size_t idx);
+    bool MovePage(wxWindow* page, size_t newIdx);
+    bool RemovePage(wxWindow* page);
+    bool SetActivePage(wxWindow* page);
+    bool SetActivePage(size_t page);
+    void SetNoneActive();
+    int GetActivePage() const;
+    bool TabHitTest(int x, int y, wxWindow** hit) const;
+    bool ButtonHitTest(int x, int y, wxAuiTabContainerButton** hit) const;
+    wxWindow* GetWindowFromIdx(size_t idx) const;
+    int GetIdxFromWindow(wxWindow* page) const;
+    size_t GetPageCount() const;
+    wxAuiNotebookPage& GetPage(size_t idx);
+    const wxAuiNotebookPage& GetPage(size_t idx) const;
+    wxAuiNotebookPageArray& GetPages();
+    void SetNormalFont(const wxFont& normalFont);
+    void SetSelectedFont(const wxFont& selectedFont);
+    void SetMeasuringFont(const wxFont& measuringFont);
+    void SetColour(const wxColour& colour);
+    void SetActiveColour(const wxColour& colour);
+    void DoShowHide();
+    void SetRect(const wxRect& rect);
+
+    void RemoveButton(int id);
+    void AddButton(int id,
+                   int location,
+                   const wxBitmap& normalBitmap = wxNullBitmap,
+                   const wxBitmap& disabledBitmap = wxNullBitmap);
+
+    size_t GetTabOffset() const;
+    void SetTabOffset(size_t offset);
+
+    // Is the tab visible?
+    bool IsTabVisible(int tabPage, int tabOffset, wxDC* dc, wxWindow* wnd);
+
+    // Make the tab visible if it wasn't already
+    void MakeTabVisible(int tabPage, wxWindow* win);
+
+protected:
+
+    virtual void Render(wxDC* dc, wxWindow* wnd);
+
+protected:
+
+    wxAuiTabArt* m_art;
+    wxAuiNotebookPageArray m_pages;
+    wxAuiTabContainerButtonArray m_buttons;
+    wxAuiTabContainerButtonArray m_tabCloseButtons;
+    wxRect m_rect;
+    size_t m_tabOffset;
+    unsigned int m_flags;
+};
+
 
 
 /**
     @class wxAuiTabArt
 
-    Tab art class.
+    Tab art provider defines all the drawing functions used by wxAuiNotebook.
 
-    @todo BETTER DESCRIPTION NEEDED
+    This allows the wxAuiNotebook to have a pluggable look-and-feel.
+
+    By default, a wxAuiNotebook uses an instance of this class called
+    wxAuiDefaultTabArt which provides bitmap art and a colour scheme that is
+    adapted to the major platforms' look. You can either derive from that class
+    to alter its behaviour or write a completely new tab art class.
+
+    Another example of creating a new wxAuiNotebook tab bar is wxAuiSimpleTabArt.
+
+    Call wxAuiNotebook::SetArtProvider() to make use of this new tab art.
 
     @library{wxaui}
     @category{aui}
@@ -523,3 +649,202 @@ public:
     wxEvent *Clone();
 };
 
+/**
+    Default art provider for wxAuiNotebook.
+
+    @see wxAuiTabArt
+
+    @genericAppearance{auidefaulttabart.png}
+
+    @library{wxaui}
+    @category{aui}
+*/
+
+class wxAuiDefaultTabArt : public wxAuiTabArt
+{
+public:
+
+    wxAuiDefaultTabArt();
+    virtual ~wxAuiDefaultTabArt();
+
+    wxAuiTabArt* Clone();
+    void SetFlags(unsigned int flags);
+    void SetSizingInfo(const wxSize& tabCtrlSize,
+                       size_t tabCount);
+
+    void SetNormalFont(const wxFont& font);
+    void SetSelectedFont(const wxFont& font);
+    void SetMeasuringFont(const wxFont& font);
+    void SetColour(const wxColour& colour);
+    void SetActiveColour(const wxColour& colour);
+
+    void DrawBackground(
+                 wxDC& dc,
+                 wxWindow* wnd,
+                 const wxRect& rect);
+
+    void DrawTab(wxDC& dc,
+                 wxWindow* wnd,
+                 const wxAuiNotebookPage& pane,
+                 const wxRect& inRect,
+                 int closeButtonState,
+                 wxRect* outTabRect,
+                 wxRect* outButtonRect,
+                 int* xExtent);
+
+    void DrawButton(
+                 wxDC& dc,
+                 wxWindow* wnd,
+                 const wxRect& inRect,
+                 int bitmapId,
+                 int buttonState,
+                 int orientation,
+                 wxRect* outRect);
+
+    int GetIndentSize();
+
+    wxSize GetTabSize(
+                 wxDC& dc,
+                 wxWindow* wnd,
+                 const wxString& caption,
+                 const wxBitmap& bitmap,
+                 bool active,
+                 int closeButtonState,
+                 int* xExtent);
+
+    int ShowDropDown(
+                 wxWindow* wnd,
+                 const wxAuiNotebookPageArray& items,
+                 int activeIdx);
+
+    int GetBestTabCtrlSize(wxWindow* wnd,
+                 const wxAuiNotebookPageArray& pages,
+                 const wxSize& requiredBmpSize);
+
+protected:
+    /**
+        The font used for all tabs
+     */
+    wxFont m_normalFont;
+    wxFont m_selectedFont; /// The font used on the selected tab
+    wxFont m_measuringFont;
+    wxColour m_baseColour;
+    wxPen m_baseColourPen;
+    wxPen m_borderPen;
+    wxBrush m_baseColourBrush;
+    wxColour m_activeColour;
+    wxBitmap m_activeCloseBmp;
+    wxBitmap m_disabledCloseBmp;
+    wxBitmap m_activeLeftBmp;
+    wxBitmap m_disabledLeftBmp;
+    wxBitmap m_activeRightBmp;
+    wxBitmap m_disabledRightBmp;
+    wxBitmap m_activeWindowListBmp;
+    wxBitmap m_disabledWindowListBmp;
+
+    int m_fixedTabWidth;
+    int m_tabCtrlHeight;
+    unsigned int m_flags;
+};
+
+
+/**
+    @class wxAuiSimpleTabArt
+
+    Another standard tab art provider for wxAuiNotebook.
+
+    wxAuiSimpleTabArt is derived from wxAuiTabArt demonstrating how to write a
+    completely new tab art class. It can also be used as alternative to
+    wxAuiDefaultTabArt.
+
+    @genericAppearance{auisimpletabart.png}
+
+    @library{wxaui}
+    @category{aui}
+*/
+
+class wxAuiSimpleTabArt : public wxAuiTabArt
+{
+
+public:
+
+    wxAuiSimpleTabArt();
+    virtual ~wxAuiSimpleTabArt();
+
+    wxAuiTabArt* Clone();
+    void SetFlags(unsigned int flags);
+
+    void SetSizingInfo(const wxSize& tabCtrlSize,
+                       size_t tabCount);
+
+    void SetNormalFont(const wxFont& font);
+    void SetSelectedFont(const wxFont& font);
+    void SetMeasuringFont(const wxFont& font);
+    void SetColour(const wxColour& colour);
+    void SetActiveColour(const wxColour& colour);
+
+    void DrawBackground(
+                 wxDC& dc,
+                 wxWindow* wnd,
+                 const wxRect& rect);
+
+    void DrawTab(wxDC& dc,
+                 wxWindow* wnd,
+                 const wxAuiNotebookPage& pane,
+                 const wxRect& inRect,
+                 int closeButtonState,
+                 wxRect* outTabRect,
+                 wxRect* outButtonRect,
+                 int* xExtent);
+
+    void DrawButton(
+                 wxDC& dc,
+                 wxWindow* wnd,
+                 const wxRect& inRect,
+                 int bitmapId,
+                 int buttonState,
+                 int orientation,
+                 wxRect* outRect);
+
+    int GetIndentSize();
+
+    wxSize GetTabSize(
+                 wxDC& dc,
+                 wxWindow* wnd,
+                 const wxString& caption,
+                 const wxBitmap& bitmap,
+                 bool active,
+                 int closeButtonState,
+                 int* xExtent);
+
+    int ShowDropDown(
+                 wxWindow* wnd,
+                 const wxAuiNotebookPageArray& items,
+                 int activeIdx);
+
+    int GetBestTabCtrlSize(wxWindow* wnd,
+                 const wxAuiNotebookPageArray& pages,
+                 const wxSize& requiredBmpSize);
+
+protected:
+
+    wxFont m_normalFont;
+    wxFont m_selectedFont;
+    wxFont m_measuringFont;
+    wxPen m_normalBkPen;
+    wxPen m_selectedBkPen;
+    wxBrush m_normalBkBrush;
+    wxBrush m_selectedBkBrush;
+    wxBrush m_bkBrush;
+    wxBitmap m_activeCloseBmp;
+    wxBitmap m_disabledCloseBmp;
+    wxBitmap m_activeLeftBmp;
+    wxBitmap m_disabledLeftBmp;
+    wxBitmap m_activeRightBmp;
+    wxBitmap m_disabledRightBmp;
+    wxBitmap m_activeWindowListBmp;
+    wxBitmap m_disabledWindowListBmp;
+
+    int m_fixedTabWidth;
+    unsigned int m_flags;
+};
diff --git a/interface/wx/aui/dockart.h b/interface/wx/aui/dockart.h
index ef40a5ef7c..a6942f18f1 100644
--- a/interface/wx/aui/dockart.h
+++ b/interface/wx/aui/dockart.h
@@ -8,66 +8,171 @@
 
 
 /**
-    @todo TOWRITE
+    These are the possible pane dock art settings for wxAuiDefaultDockArt.
+
+    @library{wxaui}
+    @category{aui}
+
 */
 enum wxAuiPaneDockArtSetting
 {
+
+    /// Customizes the sash size
     wxAUI_DOCKART_SASH_SIZE = 0,
+
+    /// Customizes the caption size
     wxAUI_DOCKART_CAPTION_SIZE = 1,
+
+    /// Customizes the gripper size
     wxAUI_DOCKART_GRIPPER_SIZE = 2,
+
+    /// Customizes the pane border size
     wxAUI_DOCKART_PANE_BORDER_SIZE = 3,
+
+    /// Customizes the pane button size
     wxAUI_DOCKART_PANE_BUTTON_SIZE = 4,
+
+    /// Customizes the background colour, which corresponds to the client area.
     wxAUI_DOCKART_BACKGROUND_COLOUR = 5,
+
+    /// Customizes the sash colour
     wxAUI_DOCKART_SASH_COLOUR = 6,
+
+    /// Customizes the active caption colour
     wxAUI_DOCKART_ACTIVE_CAPTION_COLOUR = 7,
+
+    /// Customizes the active caption gradient colour
     wxAUI_DOCKART_ACTIVE_CAPTION_GRADIENT_COLOUR = 8,
+
+    /// Customizes the inactive caption colour
     wxAUI_DOCKART_INACTIVE_CAPTION_COLOUR = 9,
+
+    /// Customizes the inactive gradient caption colour
     wxAUI_DOCKART_INACTIVE_CAPTION_GRADIENT_COLOUR = 10,
+
+    /// Customizes the active caption text colour
     wxAUI_DOCKART_ACTIVE_CAPTION_TEXT_COLOUR = 11,
+
+    /// Customizes the inactive caption text colour
     wxAUI_DOCKART_INACTIVE_CAPTION_TEXT_COLOUR = 12,
+
+    /// Customizes the border colour
     wxAUI_DOCKART_BORDER_COLOUR = 13,
+
+    /// Customizes the gripper colour
     wxAUI_DOCKART_GRIPPER_COLOUR = 14,
+
+    /// Customizes the caption font
     wxAUI_DOCKART_CAPTION_FONT = 15,
+
+    /// Customizes the gradient type (no gradient, vertical or horizontal)
     wxAUI_DOCKART_GRADIENT_TYPE = 16
+
 };
 
 /**
-    @todo TOWRITE
+    These are the possible gradient dock art settings for wxAuiDefaultDockArt
+
 */
 enum wxAuiPaneDockArtGradients
 {
+    /// No gradient on the captions, in other words a solid colour
     wxAUI_GRADIENT_NONE = 0,
+
+    /// Vertical gradient on the captions, in other words a gradal change in colours from top to bottom
     wxAUI_GRADIENT_VERTICAL = 1,
+
+    /// Horizontal gradient on the captions, in other words a gradual change in colours from left to right
     wxAUI_GRADIENT_HORIZONTAL = 2
 };
 
 /**
-    @todo TOWRITE
+    These are the possible pane button / wxAuiNotebook button / wxAuiToolBar button states.
 */
 enum wxAuiPaneButtonState
 {
+    /// Normal button state
     wxAUI_BUTTON_STATE_NORMAL = 0,
-    wxAUI_BUTTON_STATE_HOVER = 1,
-    wxAUI_BUTTON_STATE_PRESSED = 2
+
+    /// Hovered button state
+    wxAUI_BUTTON_STATE_HOVER = 1 << 1,
+
+    /// Pressed button state
+    wxAUI_BUTTON_STATE_PRESSED = 1 << 2,
+
+    /// Disabled button state
+    wxAUI_BUTTON_STATE_DISABLED = 1 << 3,
+
+    /// Hidden button state
+    wxAUI_BUTTON_STATE_HIDDEN   = 1 << 4,
+
+    /// Checked button state
+    wxAUI_BUTTON_STATE_CHECKED  = 1 << 5
 };
 
 /**
-    @todo TOWRITE
+    These are the possible pane button / wxAuiNotebook button / wxAuiToolBar button identifiers.
+
 */
 enum wxAuiButtonId
 {
+    /// Shows a close button on the pane
     wxAUI_BUTTON_CLOSE = 101,
+
+    /// Shows a maximize/restore button on the pane
     wxAUI_BUTTON_MAXIMIZE_RESTORE = 102,
+
+    /// Shows a minimize button on the pane
     wxAUI_BUTTON_MINIMIZE = 103,
+
+    /**
+        Shows a pin button on the pane
+     */
     wxAUI_BUTTON_PIN = 104,
+
+    /**
+        Shows an option button on the pane (not implemented)
+     */
     wxAUI_BUTTON_OPTIONS = 105,
+
+    /**
+        Shows a window list button on the pane (for wxAuiNotebook)
+     */
     wxAUI_BUTTON_WINDOWLIST = 106,
-    wxAUI_BUTTON_LEFT = 107,
-    wxAUI_BUTTON_RIGHT = 108,
+
+    /**
+        Shows a left button on the pane (for wxAuiNotebook)
+     */
+     wxAUI_BUTTON_LEFT = 107,
+
+    /**
+        Shows a right button on the pane (for wxAuiNotebook)
+     */
+     wxAUI_BUTTON_RIGHT = 108,
+
+    /**
+        Shows an up button on the pane (not implemented)
+     */
     wxAUI_BUTTON_UP = 109,
+
+    /**
+        Shows a down button on the pane (not implemented)
+     */
     wxAUI_BUTTON_DOWN = 110,
+
+    /**
+        Shows one of three possible custom buttons on the pane (not implemented)
+     */
     wxAUI_BUTTON_CUSTOM1 = 201,
+
+    /**
+        Shows one of three possible custom buttons on the pane (not implemented)
+     */
     wxAUI_BUTTON_CUSTOM2 = 202,
+
+    /**
+        Shows one of three possible custom buttons on the pane (not implemented)
+     */
     wxAUI_BUTTON_CUSTOM3 = 203
 };
 
diff --git a/interface/wx/aui/toolbar.h b/interface/wx/aui/toolbar.h
index bebe8aa682..303a14ba0f 100644
--- a/interface/wx/aui/toolbar.h
+++ b/interface/wx/aui/toolbar.h
@@ -8,54 +8,125 @@
 ///////////////////////////////////////////////////////////////////////////////
 
 /**
+    wxAuiToolBarStyle is part of the wxAUI class framework, used to define the appearance of a wxAuiToolBar.
+
+    See also @ref overview_aui.
+
     @library{wxaui}
     @category{aui}
   */
 enum wxAuiToolBarStyle
 {
+    /**
+      Shows the text in the toolbar buttons; by default only icons are shown.
+    */
     wxAUI_TB_TEXT          = 1 << 0,
+
+    /**
+      Don't show tooltips on wxAuiToolBar items.
+    */
     wxAUI_TB_NO_TOOLTIPS   = 1 << 1,
+
+    /**
+      Do not auto-resize the wxAuiToolBar.
+    */
     wxAUI_TB_NO_AUTORESIZE = 1 << 2,
+
+    /**
+      Shows a gripper on the wxAuiToolBar.
+    */
     wxAUI_TB_GRIPPER       = 1 << 3,
+
+    /**
+      The wxAuiToolBar can contain overflow items.
+    */
     wxAUI_TB_OVERFLOW      = 1 << 4,
+
     /**
-      Using this style forces the toolbar to be vertical and be only dockable
-      to the left or right sides of the window whereas by default it can be
-      horizontal or vertical and be docked anywhere.
-      */
+      Using this style forces the toolbar to be vertical and be only dockable to the left or right sides of the window whereas by default it can be horizontal or vertical and be docked anywhere.
+    */
     wxAUI_TB_VERTICAL      = 1 << 5,
+
+    /**
+      Shows the text and the icons alongside, not vertically stacked. This style must be used with wxAUI_TB_TEXT
+    */
     wxAUI_TB_HORZ_LAYOUT   = 1 << 6,
+
     /**
-      Analogous to wxAUI_TB_VERTICAL, but forces the toolbar
-      to be horizontal
-      */
+      Analogous to wxAUI_TB_VERTICAL, but forces the toolbar to be horizontal, docking to the top or bottom of the window.
+    */
     wxAUI_TB_HORIZONTAL    = 1 << 7,
+
+    /**
+       Shows the text alongside the icons, not vertically stacked.
+    */
     wxAUI_TB_HORZ_TEXT     = (wxAUI_TB_HORZ_LAYOUT | wxAUI_TB_TEXT),
+
+    /**
+      Shows the text in the toolbar buttons; by default only icons are shown.
+    */
     wxAUI_ORIENTATION_MASK = (wxAUI_TB_VERTICAL | wxAUI_TB_HORIZONTAL),
+
+    /**
+      By default only icons are shown.
+    */
     wxAUI_TB_DEFAULT_STYLE = 0
+
 };
 
 /**
-  @library{wxaui}
-  @category{aui}
-  */
+    wxAuiToolBarArtSetting
+
+    @library{wxaui}
+    @category{aui}
+*/
 enum wxAuiToolBarArtSetting
 {
+    /**
+      wxAuiToolBar seperator size.
+    */
     wxAUI_TBART_SEPARATOR_SIZE = 0,
+
+    /**
+      wxAuiToolBar gripper size.
+    */
     wxAUI_TBART_GRIPPER_SIZE = 1,
+
+    /**
+      Overflow button size in wxAuiToolBar.
+    */
     wxAUI_TBART_OVERFLOW_SIZE = 2
+
 };
 
 /**
+  wxAuiToolBarToolTextOrientation
+
   @library{wxaui}
   @category{aui}
   */
 enum wxAuiToolBarToolTextOrientation
 {
-    wxAUI_TBTOOL_TEXT_LEFT = 0,     //!< unused/unimplemented
+    /**
+      Text in wxAuiToolBar items is left aligned, currently unused/unimplemented.
+    */
+    wxAUI_TBTOOL_TEXT_LEFT = 0,
+
+    /**
+      Text in wxAuiToolBar items is right aligned.
+    */
     wxAUI_TBTOOL_TEXT_RIGHT = 1,
-    wxAUI_TBTOOL_TEXT_TOP = 2,      //!< unused/unimplemented
+
+    /**
+      Text in wxAuiToolBar items is top aligned, currently unused/unimplemented.
+    */
+    wxAUI_TBTOOL_TEXT_TOP = 2,
+
+    /**
+      Text in wxAuiToolBar items is bottom aligned.
+    */
     wxAUI_TBTOOL_TEXT_BOTTOM = 3
+
 };
 
 
@@ -70,12 +141,24 @@ enum wxAuiToolBarToolTextOrientation
 class wxAuiToolBarEvent : public wxNotifyEvent
 {
 public:
+    /**
+      Returns whether the drop down menu has been clicked.
+    */
     bool IsDropDownClicked() const;
 
+    /**
+      Returns the point where the user clicked with the mouse.
+    */
     wxPoint GetClickPoint() const;
 
+    /**
+      Returns the wxAuiToolBarItem rectangle bounding the mouse click point.
+    */
     wxRect GetItemRect() const;
 
+    /**
+      Returns the wxAuiToolBarItem identifier.
+    */
     int GetToolId() const;
 };
 
@@ -83,9 +166,17 @@ public:
 /**
     @class wxAuiToolBarItem
 
-    wxAuiToolBarItem is part of the wxAUI class framework.
+    wxAuiToolBarItem is part of the wxAUI class framework, representing a toolbar element.
+
     See also @ref wxAuiToolBar and @ref overview_aui.
 
+    It has a unique id (except for the separators which always have id = -1), the
+    style (telling whether it is a normal button, separator or a control), the
+    state (toggled or not, enabled or not) and short and long help strings. The
+    default implementations use the short help string for the tooltip text which
+    is popped up when the mouse pointer enters the tool and the long help string
+    for the applications status bar (currently not implemented).
+
     @library{wxaui}
     @category{aui}
 */
@@ -93,69 +184,196 @@ class wxAuiToolBarItem
 {
 public:
 
+    /**
+       Default Constructor
+    */
     wxAuiToolBarItem();
 
+    /**
+      Assigns the properties of the wxAuiToolBarItem "c" to this.
+    */
     wxAuiToolBarItem(const wxAuiToolBarItem& c);
 
+    /**
+       Assigns the properties of the wxAuiToolBarItem "c" to this, returning a pointer to this.
+    */
     wxAuiToolBarItem& operator=(const wxAuiToolBarItem& c);
 
+    /**
+      Assigns the properties of the wxAuiToolBarItem "c" to this.
+    */
     void Assign(const wxAuiToolBarItem& c);
 
+    /**
+      Assigns a window to the toolbar item.
+    */
     void SetWindow(wxWindow* w);
+    /**
+      Returns the wxWindow* associated to the toolbar item.
+    */
     wxWindow* GetWindow();
 
+    /**
+      Sets the toolbar item identifier.
+    */
     void SetId(int new_id);
+    /**
+      Returns the toolbar item identifier.
+    */
     int GetId() const;
 
+    /**
+      Sets the wxAuiToolBarItem kind.
+    */
     void SetKind(int new_kind);
+
+    /**
+      Returns the toolbar item kind.
+    */
     int GetKind() const;
 
+    /**
+
+    */
     void SetState(int new_state);
+    /**
+
+    */
     int GetState() const;
 
+    /**
+
+    */
     void SetSizerItem(wxSizerItem* s);
+    /**
+
+    */
     wxSizerItem* GetSizerItem() const;
 
+    /**
+
+    */
     void SetLabel(const wxString& s);
+    /**
+
+    */
     const wxString& GetLabel() const;
 
+    /**
+
+    */
     void SetBitmap(const wxBitmap& bmp);
+    /**
+
+    */
     const wxBitmap& GetBitmap() const;
 
+    /**
+
+    */
     void SetDisabledBitmap(const wxBitmap& bmp);
+    /**
+
+    */
     const wxBitmap& GetDisabledBitmap() const;
 
+    /**
+
+    */
     void SetHoverBitmap(const wxBitmap& bmp);
+    /**
+
+    */
     const wxBitmap& GetHoverBitmap() const;
 
+    /**
+
+    */
     void SetShortHelp(const wxString& s);
+    /**
+
+    */
     const wxString& GetShortHelp() const;
 
+    /**
+
+    */
     void SetLongHelp(const wxString& s);
+    /**
+
+    */
     const wxString& GetLongHelp() const;
 
+    /**
+
+    */
     void SetMinSize(const wxSize& s);
+    /**
+
+    */
     const wxSize& GetMinSize() const;
 
+    /**
+
+    */
     void SetSpacerPixels(int s);
+    /**
+
+    */
     int GetSpacerPixels() const;
 
+    /**
+
+    */
     void SetProportion(int p);
+    /**
+
+    */
     int GetProportion() const;
 
+    /**
+
+    */
     void SetActive(bool b);
+    /**
+
+    */
     bool IsActive() const;
 
+    /**
+
+    */
     void SetHasDropDown(bool b);
+    /**
+
+    */
     bool HasDropDown() const;
 
+    /**
+
+    */
     void SetSticky(bool b);
+    /**
+
+    */
     bool IsSticky() const;
 
+    /**
+
+    */
     void SetUserData(long l);
+    /**
+
+    */
     long GetUserData() const;
 
+    /**
+
+    */
     void SetAlignment(int l);
+    /**
+
+    */
     int GetAlignment() const;
 };
 
-- 
2.45.2