include/wx/tbarbase.h

   1 /////////////////////////////////////////////////////////////////////////////
   2 // Name:        wx/tbarbase.h
   3 // Purpose:     Base class for toolbar classes
   4 // Author:      Julian Smart
   5 // Modified by:
   6 // Created:     01/02/97
   7 // RCS-ID:      $Id$
   8 // Copyright:   (c) Julian Smart
   9 // Licence:     wxWindows licence
  10 /////////////////////////////////////////////////////////////////////////////
  11
  12 #ifndef _WX_TBARBASE_H_
  13 #define _WX_TBARBASE_H_
  14
  15 // ----------------------------------------------------------------------------
  16 // headers
  17 // ----------------------------------------------------------------------------
  18
  19 #include "wx/defs.h"
  20
  21 #if wxUSE_TOOLBAR
  22
  23 #include "wx/bitmap.h"
  24 #include "wx/list.h"
  25 #include "wx/control.h"
  26
  27 class WXDLLIMPEXP_FWD_CORE wxToolBarBase;
  28 class WXDLLIMPEXP_FWD_CORE wxToolBarToolBase;
  29 class WXDLLIMPEXP_FWD_CORE wxImage;
  30
  31 // ----------------------------------------------------------------------------
  32 // constants
  33 // ----------------------------------------------------------------------------
  34
  35 extern WXDLLIMPEXP_DATA_CORE(const char) wxToolBarNameStr[];
  36 extern WXDLLIMPEXP_DATA_CORE(const wxSize) wxDefaultSize;
  37 extern WXDLLIMPEXP_DATA_CORE(const wxPoint) wxDefaultPosition;
  38
  39 enum wxToolBarToolStyle
  40 {
  41     wxTOOL_STYLE_BUTTON    = 1,
  42     wxTOOL_STYLE_SEPARATOR = 2,
  43     wxTOOL_STYLE_CONTROL
  44 };
  45
  46 // ----------------------------------------------------------------------------
  47 // wxToolBarTool is a toolbar element.
  48 //
  49 // It has a unique id (except for the separators which always have id wxID_ANY), the
  50 // style (telling whether it is a normal button, separator or a control), the
  51 // state (toggled or not, enabled or not) and short and long help strings. The
  52 // default implementations use the short help string for the tooltip text which
  53 // is popped up when the mouse pointer enters the tool and the long help string
  54 // for the applications status bar.
  55 // ----------------------------------------------------------------------------
  56
  57 class WXDLLIMPEXP_CORE wxToolBarToolBase : public wxObject
  58 {
  59 public:
  60     // ctors & dtor
  61     // ------------
  62
  63     // generic ctor for any kind of tool
  64     wxToolBarToolBase(wxToolBarBase *tbar = NULL,
  65                       int toolid = wxID_SEPARATOR,
  66                       const wxString& label = wxEmptyString,
  67                       const wxBitmap& bmpNormal = wxNullBitmap,
  68                       const wxBitmap& bmpDisabled = wxNullBitmap,
  69                       wxItemKind kind = wxITEM_NORMAL,
  70                       wxObject *clientData = NULL,
  71                       const wxString& shortHelpString = wxEmptyString,
  72                       const wxString& longHelpString = wxEmptyString)
  73         : m_label(label),
  74           m_shortHelpString(shortHelpString),
  75           m_longHelpString(longHelpString)
  76     {
  77         Init
  78         (
  79             tbar,
  80             toolid == wxID_SEPARATOR ? wxTOOL_STYLE_SEPARATOR
  81                                      : wxTOOL_STYLE_BUTTON,
  82             toolid == wxID_ANY ? wxWindow::NewControlId()
  83                                : toolid,
  84             kind
  85         );
  86
  87         m_clientData = clientData;
  88
  89         m_bmpNormal = bmpNormal;
  90         m_bmpDisabled = bmpDisabled;
  91     }
  92
  93     // ctor for controls only
  94     wxToolBarToolBase(wxToolBarBase *tbar,
  95                       wxControl *control,
  96                       const wxString& label)
  97         : m_label(label)
  98     {
  99         Init(tbar, wxTOOL_STYLE_CONTROL, control->GetId(), wxITEM_MAX);
 100
 101         m_control = control;
 102     }
 103
 104     virtual ~wxToolBarToolBase();
 105
 106     // accessors
 107     // ---------
 108
 109     // general
 110     int GetId() const { return m_id; }
 111
 112     wxControl *GetControl() const
 113     {
 114         wxASSERT_MSG( IsControl(), wxT("this toolbar tool is not a control") );
 115
 116         return m_control;
 117     }
 118
 119     wxToolBarBase *GetToolBar() const { return m_tbar; }
 120
 121     // style/kind
 122     bool IsStretchable() const { return m_stretchable; }
 123     bool IsButton() const { return m_toolStyle == wxTOOL_STYLE_BUTTON; }
 124     bool IsControl() const { return m_toolStyle == wxTOOL_STYLE_CONTROL; }
 125     bool IsSeparator() const { return m_toolStyle == wxTOOL_STYLE_SEPARATOR; }
 126     bool IsStretchableSpace() const { return IsSeparator() && IsStretchable(); }
 127     int GetStyle() const { return m_toolStyle; }
 128     wxItemKind GetKind() const
 129     {
 130         wxASSERT_MSG( IsButton(), wxT("only makes sense for buttons") );
 131
 132         return m_kind;
 133     }
 134
 135     void MakeStretchable()
 136     {
 137         wxASSERT_MSG( IsSeparator(), "only separators can be stretchable" );
 138
 139         m_stretchable = true;
 140     }
 141
 142     // state
 143     bool IsEnabled() const { return m_enabled; }
 144     bool IsToggled() const { return m_toggled; }
 145     bool CanBeToggled() const
 146         { return m_kind == wxITEM_CHECK || m_kind == wxITEM_RADIO; }
 147
 148     // attributes
 149     const wxBitmap& GetNormalBitmap() const { return m_bmpNormal; }
 150     const wxBitmap& GetDisabledBitmap() const { return m_bmpDisabled; }
 151
 152     const wxBitmap& GetBitmap() const
 153         { return IsEnabled() ? GetNormalBitmap() : GetDisabledBitmap(); }
 154
 155     const wxString& GetLabel() const { return m_label; }
 156
 157     const wxString& GetShortHelp() const { return m_shortHelpString; }
 158     const wxString& GetLongHelp() const { return m_longHelpString; }
 159
 160     wxObject *GetClientData() const
 161     {
 162         if ( m_toolStyle == wxTOOL_STYLE_CONTROL )
 163         {
 164             return (wxObject*)m_control->GetClientData();
 165         }
 166         else
 167         {
 168             return m_clientData;
 169         }
 170     }
 171
 172     // modifiers: return true if the state really changed
 173     virtual bool Enable(bool enable);
 174     virtual bool Toggle(bool toggle);
 175     virtual bool SetToggle(bool toggle);
 176     virtual bool SetShortHelp(const wxString& help);
 177     virtual bool SetLongHelp(const wxString& help);
 178
 179     void Toggle() { Toggle(!IsToggled()); }
 180
 181     virtual void SetNormalBitmap(const wxBitmap& bmp) { m_bmpNormal = bmp; }
 182     virtual void SetDisabledBitmap(const wxBitmap& bmp) { m_bmpDisabled = bmp; }
 183
 184     virtual void SetLabel(const wxString& label) { m_label = label; }
 185
 186     void SetClientData(wxObject *clientData)
 187     {
 188         if ( m_toolStyle == wxTOOL_STYLE_CONTROL )
 189         {
 190             m_control->SetClientData(clientData);
 191         }
 192         else
 193         {
 194             m_clientData = clientData;
 195         }
 196     }
 197
 198     // add tool to/remove it from a toolbar
 199     virtual void Detach() { m_tbar = NULL; }
 200     virtual void Attach(wxToolBarBase *tbar) { m_tbar = tbar; }
 201
 202     // these methods are only for tools of wxITEM_DROPDOWN kind (but even such
 203     // tools can have a NULL associated menu)
 204     virtual void SetDropdownMenu(wxMenu *menu);
 205     wxMenu *GetDropdownMenu() const { return m_dropdownMenu; }
 206
 207 protected:
 208     // common part of all ctors
 209     void Init(wxToolBarBase *tbar,
 210               wxToolBarToolStyle style,
 211               int toolid,
 212               wxItemKind kind)
 213     {
 214         m_tbar = tbar;
 215         m_toolStyle = style;
 216         m_id = toolid;
 217         m_kind = kind;
 218
 219         m_clientData = NULL;
 220
 221         m_stretchable = false;
 222         m_toggled = false;
 223         m_enabled = true;
 224
 225         m_dropdownMenu = NULL;
 226     }
 227
 228     wxToolBarBase *m_tbar;  // the toolbar to which we belong (may be NULL)
 229
 230     // tool parameters
 231     wxToolBarToolStyle m_toolStyle;
 232     wxWindowIDRef m_id; // the tool id, wxID_SEPARATOR for separator
 233     wxItemKind m_kind;  // for normal buttons may be wxITEM_NORMAL/CHECK/RADIO
 234
 235     // as controls have their own client data, no need to waste memory
 236     union
 237     {
 238         wxObject         *m_clientData;
 239         wxControl        *m_control;
 240     };
 241
 242     // true if this tool is stretchable: currently is only value for separators
 243     bool m_stretchable;
 244
 245     // tool state
 246     bool m_toggled;
 247     bool m_enabled;
 248
 249     // normal and disabled bitmaps for the tool, both can be invalid
 250     wxBitmap m_bmpNormal;
 251     wxBitmap m_bmpDisabled;
 252
 253     // the button label
 254     wxString m_label;
 255
 256     // short and long help strings
 257     wxString m_shortHelpString;
 258     wxString m_longHelpString;
 259
 260     wxMenu *m_dropdownMenu;
 261
 262     DECLARE_DYNAMIC_CLASS_NO_COPY(wxToolBarToolBase)
 263 };
 264
 265 // a list of toolbar tools
 266 WX_DECLARE_EXPORTED_LIST(wxToolBarToolBase, wxToolBarToolsList);
 267
 268 // ----------------------------------------------------------------------------
 269 // the base class for all toolbars
 270 // ----------------------------------------------------------------------------
 271
 272 class WXDLLIMPEXP_CORE wxToolBarBase : public wxControl
 273 {
 274 public:
 275     wxToolBarBase();
 276     virtual ~wxToolBarBase();
 277
 278     // toolbar construction
 279     // --------------------
 280
 281     // the full AddTool() function
 282     //
 283     // If bmpDisabled is wxNullBitmap, a shadowed version of the normal bitmap
 284     // is created and used as the disabled image.
 285     wxToolBarToolBase *AddTool(int toolid,
 286                                const wxString& label,
 287                                const wxBitmap& bitmap,
 288                                const wxBitmap& bmpDisabled,
 289                                wxItemKind kind = wxITEM_NORMAL,
 290                                const wxString& shortHelp = wxEmptyString,
 291                                const wxString& longHelp = wxEmptyString,
 292                                wxObject *data = NULL)
 293     {
 294         return DoAddTool(toolid, label, bitmap, bmpDisabled, kind,
 295                          shortHelp, longHelp, data);
 296     }
 297
 298     // the most common AddTool() version
 299     wxToolBarToolBase *AddTool(int toolid,
 300                                const wxString& label,
 301                                const wxBitmap& bitmap,
 302                                const wxString& shortHelp = wxEmptyString,
 303                                wxItemKind kind = wxITEM_NORMAL)
 304     {
 305         return AddTool(toolid, label, bitmap, wxNullBitmap, kind, shortHelp);
 306     }
 307
 308     // add a check tool, i.e. a tool which can be toggled
 309     wxToolBarToolBase *AddCheckTool(int toolid,
 310                                     const wxString& label,
 311                                     const wxBitmap& bitmap,
 312                                     const wxBitmap& bmpDisabled = wxNullBitmap,
 313                                     const wxString& shortHelp = wxEmptyString,
 314                                     const wxString& longHelp = wxEmptyString,
 315                                     wxObject *data = NULL)
 316     {
 317         return AddTool(toolid, label, bitmap, bmpDisabled, wxITEM_CHECK,
 318                        shortHelp, longHelp, data);
 319     }
 320
 321     // add a radio tool, i.e. a tool which can be toggled and releases any
 322     // other toggled radio tools in the same group when it happens
 323     wxToolBarToolBase *AddRadioTool(int toolid,
 324                                     const wxString& label,
 325                                     const wxBitmap& bitmap,
 326                                     const wxBitmap& bmpDisabled = wxNullBitmap,
 327                                     const wxString& shortHelp = wxEmptyString,
 328                                     const wxString& longHelp = wxEmptyString,
 329                                     wxObject *data = NULL)
 330     {
 331         return AddTool(toolid, label, bitmap, bmpDisabled, wxITEM_RADIO,
 332                        shortHelp, longHelp, data);
 333     }
 334
 335
 336     // insert the new tool at the given position, if pos == GetToolsCount(), it
 337     // is equivalent to AddTool()
 338     virtual wxToolBarToolBase *InsertTool
 339                                (
 340                                     size_t pos,
 341                                     int toolid,
 342                                     const wxString& label,
 343                                     const wxBitmap& bitmap,
 344                                     const wxBitmap& bmpDisabled = wxNullBitmap,
 345                                     wxItemKind kind = wxITEM_NORMAL,
 346                                     const wxString& shortHelp = wxEmptyString,
 347                                     const wxString& longHelp = wxEmptyString,
 348                                     wxObject *clientData = NULL
 349                                );
 350
 351     virtual wxToolBarToolBase *AddTool (wxToolBarToolBase *tool);
 352     virtual wxToolBarToolBase *InsertTool (size_t pos, wxToolBarToolBase *tool);
 353
 354     // add an arbitrary control to the toolbar (notice that the control will be
 355     // deleted by the toolbar and that it will also adjust its position/size)
 356     //
 357     // the label is optional and, if specified, will be shown near the control
 358     // NB: the control should have toolbar as its parent
 359     virtual wxToolBarToolBase *
 360     AddControl(wxControl *control, const wxString& label = wxEmptyString);
 361
 362     virtual wxToolBarToolBase *
 363     InsertControl(size_t pos, wxControl *control,
 364                   const wxString& label = wxEmptyString);
 365
 366     // get the control with the given id or return NULL
 367     virtual wxControl *FindControl( int toolid );
 368
 369     // add a separator to the toolbar
 370     virtual wxToolBarToolBase *AddSeparator();
 371     virtual wxToolBarToolBase *InsertSeparator(size_t pos);
 372
 373     // add a stretchable space to the toolbar: this is similar to a separator
 374     // except that it's always blank and that all the extra space the toolbar
 375     // has is [equally] distributed among the stretchable spaces in it
 376     virtual wxToolBarToolBase *AddStretchableSpace();
 377     virtual wxToolBarToolBase *InsertStretchableSpace(size_t pos);
 378
 379     // remove the tool from the toolbar: the caller is responsible for actually
 380     // deleting the pointer
 381     virtual wxToolBarToolBase *RemoveTool(int toolid);
 382
 383     // delete tool either by index or by position
 384     virtual bool DeleteToolByPos(size_t pos);
 385     virtual bool DeleteTool(int toolid);
 386
 387     // delete all tools
 388     virtual void ClearTools();
 389
 390     // must be called after all buttons have been created to finish toolbar
 391     // initialisation
 392     //
 393     // derived class versions should call the base one first, before doing
 394     // platform-specific stuff
 395     virtual bool Realize();
 396
 397     // tools state
 398     // -----------
 399
 400     virtual void EnableTool(int toolid, bool enable);
 401     virtual void ToggleTool(int toolid, bool toggle);
 402
 403     // Set this to be togglable (or not)
 404     virtual void SetToggle(int toolid, bool toggle);
 405
 406     // set/get tools client data (not for controls)
 407     virtual wxObject *GetToolClientData(int toolid) const;
 408     virtual void SetToolClientData(int toolid, wxObject *clientData);
 409
 410     // returns tool pos, or wxNOT_FOUND if tool isn't found
 411     virtual int GetToolPos(int id) const;
 412
 413     // return true if the tool is toggled
 414     virtual bool GetToolState(int toolid) const;
 415
 416     virtual bool GetToolEnabled(int toolid) const;
 417
 418     virtual void SetToolShortHelp(int toolid, const wxString& helpString);
 419     virtual wxString GetToolShortHelp(int toolid) const;
 420     virtual void SetToolLongHelp(int toolid, const wxString& helpString);
 421     virtual wxString GetToolLongHelp(int toolid) const;
 422
 423     virtual void SetToolNormalBitmap(int WXUNUSED(id),
 424                                      const wxBitmap& WXUNUSED(bitmap)) {}
 425     virtual void SetToolDisabledBitmap(int WXUNUSED(id),
 426                                        const wxBitmap& WXUNUSED(bitmap)) {}
 427
 428
 429     // margins/packing/separation
 430     // --------------------------
 431
 432     virtual void SetMargins(int x, int y);
 433     void SetMargins(const wxSize& size)
 434         { SetMargins((int) size.x, (int) size.y); }
 435     virtual void SetToolPacking(int packing)
 436         { m_toolPacking = packing; }
 437     virtual void SetToolSeparation(int separation)
 438         { m_toolSeparation = separation; }
 439
 440     virtual wxSize GetToolMargins() const { return wxSize(m_xMargin, m_yMargin); }
 441     virtual int GetToolPacking() const { return m_toolPacking; }
 442     virtual int GetToolSeparation() const { return m_toolSeparation; }
 443
 444     // toolbar geometry
 445     // ----------------
 446
 447     // set the number of toolbar rows
 448     virtual void SetRows(int nRows);
 449
 450     // the toolbar can wrap - limit the number of columns or rows it may take
 451     void SetMaxRowsCols(int rows, int cols)
 452         { m_maxRows = rows; m_maxCols = cols; }
 453     int GetMaxRows() const { return m_maxRows; }
 454     int GetMaxCols() const { return m_maxCols; }
 455
 456     // get/set the size of the bitmaps used by the toolbar: should be called
 457     // before adding any tools to the toolbar
 458     virtual void SetToolBitmapSize(const wxSize& size)
 459         { m_defaultWidth = size.x; m_defaultHeight = size.y; }
 460     virtual wxSize GetToolBitmapSize() const
 461         { return wxSize(m_defaultWidth, m_defaultHeight); }
 462
 463     // the button size in some implementations is bigger than the bitmap size:
 464     // get the total button size (by default the same as bitmap size)
 465     virtual wxSize GetToolSize() const
 466         { return GetToolBitmapSize(); }
 467
 468     // returns a (non separator) tool containing the point (x, y) or NULL if
 469     // there is no tool at this point (corrdinates are client)
 470     virtual wxToolBarToolBase *FindToolForPosition(wxCoord x,
 471                                                    wxCoord y) const = 0;
 472
 473     // find the tool by id
 474     wxToolBarToolBase *FindById(int toolid) const;
 475
 476     // return true if this is a vertical toolbar, otherwise false
 477     bool IsVertical() const;
 478
 479 #if WXWIN_COMPATIBILITY_2_8
 480     // the old versions of the various methods kept for compatibility
 481     // don't use in the new code!
 482     // --------------------------------------------------------------
 483     wxDEPRECATED_INLINE(
 484     wxToolBarToolBase *AddTool(int toolid,
 485                                const wxBitmap& bitmap,
 486                                const wxBitmap& bmpDisabled,
 487                                bool toggle = false,
 488                                wxObject *clientData = NULL,
 489                                const wxString& shortHelpString = wxEmptyString,
 490                                const wxString& longHelpString = wxEmptyString)
 491     ,
 492         return AddTool(toolid, wxEmptyString,
 493                        bitmap, bmpDisabled,
 494                        toggle ? wxITEM_CHECK : wxITEM_NORMAL,
 495                        shortHelpString, longHelpString, clientData);
 496     )
 497     wxDEPRECATED_INLINE(
 498     wxToolBarToolBase *AddTool(int toolid,
 499                                const wxBitmap& bitmap,
 500                                const wxString& shortHelpString = wxEmptyString,
 501                                const wxString& longHelpString = wxEmptyString)
 502     ,
 503         return AddTool(toolid, wxEmptyString,
 504                        bitmap, wxNullBitmap, wxITEM_NORMAL,
 505                        shortHelpString, longHelpString, NULL);
 506     )
 507     wxDEPRECATED_INLINE(
 508     wxToolBarToolBase *AddTool(int toolid,
 509                                const wxBitmap& bitmap,
 510                                const wxBitmap& bmpDisabled,
 511                                bool toggle,
 512                                wxCoord xPos,
 513                                wxCoord yPos = wxDefaultCoord,
 514                                wxObject *clientData = NULL,
 515                                const wxString& shortHelp = wxEmptyString,
 516                                const wxString& longHelp = wxEmptyString)
 517     ,
 518         return DoAddTool(toolid, wxEmptyString, bitmap, bmpDisabled,
 519                          toggle ? wxITEM_CHECK : wxITEM_NORMAL,
 520                          shortHelp, longHelp, clientData, xPos, yPos);
 521     )
 522     wxDEPRECATED_INLINE(
 523     wxToolBarToolBase *InsertTool(size_t pos,
 524                                   int toolid,
 525                                   const wxBitmap& bitmap,
 526                                   const wxBitmap& bmpDisabled = wxNullBitmap,
 527                                   bool toggle = false,
 528                                   wxObject *clientData = NULL,
 529                                   const wxString& shortHelp = wxEmptyString,
 530                                   const wxString& longHelp = wxEmptyString)
 531     ,
 532         return InsertTool(pos, toolid, wxEmptyString, bitmap, bmpDisabled,
 533                           toggle ? wxITEM_CHECK : wxITEM_NORMAL,
 534                           shortHelp, longHelp, clientData);
 535     )
 536 #endif // WXWIN_COMPATIBILITY_2_8
 537
 538     // event handlers
 539     // --------------
 540
 541     // NB: these functions are deprecated, use EVT_TOOL_XXX() instead!
 542
 543     // Only allow toggle if returns true. Call when left button up.
 544     virtual bool OnLeftClick(int toolid, bool toggleDown);
 545
 546     // Call when right button down.
 547     virtual void OnRightClick(int toolid, long x, long y);
 548
 549     // Called when the mouse cursor enters a tool bitmap.
 550     // Argument is wxID_ANY if mouse is exiting the toolbar.
 551     virtual void OnMouseEnter(int toolid);
 552
 553     // more deprecated functions
 554     // -------------------------
 555
 556     // use GetToolMargins() instead
 557     wxSize GetMargins() const { return GetToolMargins(); }
 558
 559     // implementation only from now on
 560     // -------------------------------
 561
 562     size_t GetToolsCount() const { return m_tools.GetCount(); }
 563
 564     // Do the toolbar button updates (check for EVT_UPDATE_UI handlers)
 565     virtual void UpdateWindowUI(long flags = wxUPDATE_UI_NONE) ;
 566
 567     // don't want toolbars to accept the focus
 568     virtual bool AcceptsFocus() const { return false; }
 569
 570     // Set dropdown menu
 571     bool SetDropdownMenu(int toolid, wxMenu *menu);
 572
 573 protected:
 574     // to implement in derived classes
 575     // -------------------------------
 576
 577     // create a new toolbar tool and add it to the toolbar, this is typically
 578     // implemented by just calling InsertTool()
 579     virtual wxToolBarToolBase *DoAddTool
 580                                (
 581                                    int toolid,
 582                                    const wxString& label,
 583                                    const wxBitmap& bitmap,
 584                                    const wxBitmap& bmpDisabled,
 585                                    wxItemKind kind,
 586                                    const wxString& shortHelp = wxEmptyString,
 587                                    const wxString& longHelp = wxEmptyString,
 588                                    wxObject *clientData = NULL,
 589                                    wxCoord xPos = wxDefaultCoord,
 590                                    wxCoord yPos = wxDefaultCoord
 591                                );
 592
 593     // the tool is not yet inserted into m_tools list when this function is
 594     // called and will only be added to it if this function succeeds
 595     virtual bool DoInsertTool(size_t pos, wxToolBarToolBase *tool) = 0;
 596
 597     // the tool is still in m_tools list when this function is called, it will
 598     // only be deleted from it if it succeeds
 599     virtual bool DoDeleteTool(size_t pos, wxToolBarToolBase *tool) = 0;
 600
 601     // called when the tools enabled flag changes
 602     virtual void DoEnableTool(wxToolBarToolBase *tool, bool enable) = 0;
 603
 604     // called when the tool is toggled
 605     virtual void DoToggleTool(wxToolBarToolBase *tool, bool toggle) = 0;
 606
 607     // called when the tools "can be toggled" flag changes
 608     virtual void DoSetToggle(wxToolBarToolBase *tool, bool toggle) = 0;
 609
 610     // the functions to create toolbar tools
 611     virtual wxToolBarToolBase *CreateTool(int toolid,
 612                                           const wxString& label,
 613                                           const wxBitmap& bmpNormal,
 614                                           const wxBitmap& bmpDisabled,
 615                                           wxItemKind kind,
 616                                           wxObject *clientData,
 617                                           const wxString& shortHelp,
 618                                           const wxString& longHelp) = 0;
 619
 620     virtual wxToolBarToolBase *CreateTool(wxControl *control,
 621                                           const wxString& label) = 0;
 622
 623     // this one is not virtual but just a simple helper/wrapper around
 624     // CreateTool() for separators
 625     wxToolBarToolBase *CreateSeparator()
 626     {
 627         return CreateTool(wxID_SEPARATOR,
 628                           wxEmptyString,
 629                           wxNullBitmap, wxNullBitmap,
 630                           wxITEM_SEPARATOR, NULL,
 631                           wxEmptyString, wxEmptyString);
 632     }
 633
 634     // helper functions
 635     // ----------------
 636
 637     // call this from derived class ctor/Create() to ensure that we have either
 638     // wxTB_HORIZONTAL or wxTB_VERTICAL style, there is a lot of existing code
 639     // which randomly checks either one or the other of them and gets confused
 640     // if neither is set (and making one of them 0 is not an option neither as
 641     // then the existing tests would break down)
 642     void FixupStyle();
 643
 644     // un-toggle all buttons in the same radio group
 645     void UnToggleRadioGroup(wxToolBarToolBase *tool);
 646
 647     // make the size of the buttons big enough to fit the largest bitmap size
 648     void AdjustToolBitmapSize();
 649
 650     // calls InsertTool() and deletes the tool if inserting it failed
 651     wxToolBarToolBase *DoInsertNewTool(size_t pos, wxToolBarToolBase *tool)
 652     {
 653         if ( !InsertTool(pos, tool) )
 654         {
 655             delete tool;
 656             return NULL;
 657         }
 658
 659         return tool;
 660     }
 661
 662     // the list of all our tools
 663     wxToolBarToolsList m_tools;
 664
 665     // the offset of the first tool
 666     int m_xMargin;
 667     int m_yMargin;
 668
 669     // the maximum number of toolbar rows/columns
 670     int m_maxRows;
 671     int m_maxCols;
 672
 673     // the tool packing and separation
 674     int m_toolPacking,
 675         m_toolSeparation;
 676
 677     // the size of the toolbar bitmaps
 678     wxCoord m_defaultWidth, m_defaultHeight;
 679
 680 private:
 681     DECLARE_EVENT_TABLE()
 682     wxDECLARE_NO_COPY_CLASS(wxToolBarBase);
 683 };
 684
 685 // deprecated function for creating the image for disabled buttons, use
 686 // wxImage::ConvertToGreyscale() instead
 687 #if WXWIN_COMPATIBILITY_2_8
 688
 689 wxDEPRECATED( bool wxCreateGreyedImage(const wxImage& in, wxImage& out) );
 690
 691 #endif // WXWIN_COMPATIBILITY_2_8
 692
 693
 694 #endif // wxUSE_TOOLBAR
 695
 696 #endif
 697     // _WX_TBARBASE_H_
 698