src/generic/toolbkg.cpp

   1 ///////////////////////////////////////////////////////////////////////////////
   2 // Name:        src/generic/toolbkg.cpp
   3 // Purpose:     generic implementation of wxToolbook
   4 // Author:      Julian Smart
   5 // Modified by:
   6 // Created:     2006-01-29
   7 // RCS-ID:      $Id$
   8 // Copyright:   (c) 2006 Julian Smart
   9 // Licence:     wxWindows licence
  10 ///////////////////////////////////////////////////////////////////////////////
  11
  12 // For compilers that support precompilation, includes "wx.h".
  13 #include "wx/wxprec.h"
  14
  15 #ifdef __BORLANDC__
  16     #pragma hdrstop
  17 #endif
  18
  19 #if wxUSE_TOOLBOOK
  20
  21 #ifndef WX_PRECOMP
  22     #include "wx/icon.h"
  23     #include "wx/settings.h"
  24     #include "wx/toolbar.h"
  25 #endif
  26
  27 #include "wx/imaglist.h"
  28 #include "wx/sysopt.h"
  29 #include "wx/toolbook.h"
  30
  31 #if defined(__WXMAC__) && wxUSE_TOOLBAR && wxUSE_BMPBUTTON
  32 #include "wx/generic/buttonbar.h"
  33 #endif
  34
  35 // ----------------------------------------------------------------------------
  36 // various wxWidgets macros
  37 // ----------------------------------------------------------------------------
  38
  39 // check that the page index is valid
  40 #define IS_VALID_PAGE(nPage) ((nPage) < GetPageCount())
  41
  42 // ----------------------------------------------------------------------------
  43 // event table
  44 // ----------------------------------------------------------------------------
  45
  46 IMPLEMENT_DYNAMIC_CLASS(wxToolbook, wxBookCtrlBase)
  47
  48 wxDEFINE_EVENT( wxEVT_COMMAND_TOOLBOOK_PAGE_CHANGING, wxBookCtrlEvent );
  49 wxDEFINE_EVENT( wxEVT_COMMAND_TOOLBOOK_PAGE_CHANGED,  wxBookCtrlEvent );
  50
  51 BEGIN_EVENT_TABLE(wxToolbook, wxBookCtrlBase)
  52     EVT_SIZE(wxToolbook::OnSize)
  53     EVT_TOOL_RANGE(1, 50, wxToolbook::OnToolSelected)
  54     EVT_IDLE(wxToolbook::OnIdle)
  55 END_EVENT_TABLE()
  56
  57 // ============================================================================
  58 // wxToolbook implementation
  59 // ============================================================================
  60
  61 // ----------------------------------------------------------------------------
  62 // wxToolbook creation
  63 // ----------------------------------------------------------------------------
  64
  65 void wxToolbook::Init()
  66 {
  67     m_selection = wxNOT_FOUND;
  68     m_needsRealizing = false;
  69 }
  70
  71 bool wxToolbook::Create(wxWindow *parent,
  72                    wxWindowID id,
  73                    const wxPoint& pos,
  74                    const wxSize& size,
  75                    long style,
  76                    const wxString& name)
  77 {
  78     if ( (style & wxBK_ALIGN_MASK) == wxBK_DEFAULT )
  79         style |= wxBK_TOP;
  80
  81     // no border for this control
  82     style &= ~wxBORDER_MASK;
  83     style |= wxBORDER_NONE;
  84
  85     if ( !wxControl::Create(parent, id, pos, size, style,
  86                             wxDefaultValidator, name) )
  87         return false;
  88
  89     int tbFlags = wxTB_TEXT | wxTB_FLAT | wxBORDER_NONE;
  90     if ( (style & (wxBK_LEFT | wxBK_RIGHT)) != 0 )
  91         tbFlags |= wxTB_VERTICAL;
  92     else
  93         tbFlags |= wxTB_HORIZONTAL;
  94
  95     if ( style & wxTBK_HORZ_LAYOUT )
  96         tbFlags |= wxTB_HORZ_LAYOUT;
  97
  98     // TODO: make more configurable
  99
 100 #if defined(__WXMAC__) && wxUSE_TOOLBAR && wxUSE_BMPBUTTON
 101     if (style & wxTBK_BUTTONBAR)
 102     {
 103         m_bookctrl = new wxButtonToolBar
 104                  (
 105                     this,
 106                     wxID_ANY,
 107                     wxDefaultPosition,
 108                     wxDefaultSize,
 109                     tbFlags
 110                  );
 111     }
 112     else
 113 #endif
 114     {
 115         m_bookctrl = new wxToolBar
 116                  (
 117                     this,
 118                     wxID_ANY,
 119                     wxDefaultPosition,
 120                     wxDefaultSize,
 121                     tbFlags | wxTB_NODIVIDER
 122                  );
 123     }
 124
 125     return true;
 126 }
 127
 128 // ----------------------------------------------------------------------------
 129 // wxToolbook geometry management
 130 // ----------------------------------------------------------------------------
 131
 132 wxSize wxToolbook::GetControllerSize() const
 133 {
 134     const wxSize sizeClient = GetClientSize(),
 135                  sizeBorder = m_bookctrl->GetSize() - m_bookctrl->GetClientSize(),
 136                  sizeToolBar = GetToolBar()->GetSize() + sizeBorder;
 137
 138     wxSize size;
 139
 140     if ( IsVertical() )
 141     {
 142         size.x = sizeClient.x;
 143         size.y = sizeToolBar.y;
 144     }
 145     else // left/right aligned
 146     {
 147         size.x = sizeToolBar.x;
 148         size.y = sizeClient.y;
 149     }
 150
 151     return size;
 152 }
 153
 154 void wxToolbook::OnSize(wxSizeEvent& event)
 155 {
 156     if (m_needsRealizing)
 157         Realize();
 158
 159     wxBookCtrlBase::OnSize(event);
 160 }
 161
 162 wxSize wxToolbook::CalcSizeFromPage(const wxSize& sizePage) const
 163 {
 164     // we need to add the size of the list control and the border between
 165     const wxSize sizeToolBar = GetControllerSize();
 166
 167     wxSize size = sizePage;
 168     if ( IsVertical() )
 169     {
 170         size.y += sizeToolBar.y + GetInternalBorder();
 171     }
 172     else // left/right aligned
 173     {
 174         size.x += sizeToolBar.x + GetInternalBorder();
 175     }
 176
 177     return size;
 178 }
 179
 180 // ----------------------------------------------------------------------------
 181 // accessing the pages
 182 // ----------------------------------------------------------------------------
 183
 184 bool wxToolbook::SetPageText(size_t n, const wxString& strText)
 185 {
 186     // Assume tool ids start from 1
 187     wxToolBarToolBase* tool = GetToolBar()->FindById(n + 1);
 188     if (tool)
 189     {
 190         tool->SetLabel(strText);
 191         return true;
 192     }
 193     else
 194         return false;
 195 }
 196
 197 wxString wxToolbook::GetPageText(size_t n) const
 198 {
 199     wxToolBarToolBase* tool = GetToolBar()->FindById(n + 1);
 200     if (tool)
 201         return tool->GetLabel();
 202     else
 203         return wxEmptyString;
 204 }
 205
 206 int wxToolbook::GetPageImage(size_t WXUNUSED(n)) const
 207 {
 208     wxFAIL_MSG( _T("wxToolbook::GetPageImage() not implemented") );
 209
 210     return wxNOT_FOUND;
 211 }
 212
 213 bool wxToolbook::SetPageImage(size_t n, int imageId)
 214 {
 215     wxASSERT( GetImageList() != NULL );
 216     if (!GetImageList())
 217         return false;
 218
 219     wxToolBarToolBase* tool = GetToolBar()->FindById(n + 1);
 220     if (tool)
 221     {
 222         // Find the image list index for this tool
 223         wxBitmap bitmap = GetImageList()->GetBitmap(imageId);
 224         tool->SetNormalBitmap(bitmap);
 225         return true;
 226     }
 227     else
 228         return false;
 229 }
 230
 231 // ----------------------------------------------------------------------------
 232 // image list stuff
 233 // ----------------------------------------------------------------------------
 234
 235 void wxToolbook::SetImageList(wxImageList *imageList)
 236 {
 237     wxBookCtrlBase::SetImageList(imageList);
 238 }
 239
 240 // ----------------------------------------------------------------------------
 241 // selection
 242 // ----------------------------------------------------------------------------
 243
 244 int wxToolbook::GetSelection() const
 245 {
 246     return m_selection;
 247 }
 248
 249 wxBookCtrlEvent* wxToolbook::CreatePageChangingEvent() const
 250 {
 251     return new wxBookCtrlEvent(wxEVT_COMMAND_TOOLBOOK_PAGE_CHANGING, m_windowId);
 252 }
 253
 254 void wxToolbook::MakeChangedEvent(wxBookCtrlEvent &event)
 255 {
 256     event.SetEventType(wxEVT_COMMAND_TOOLBOOK_PAGE_CHANGED);
 257 }
 258
 259 void wxToolbook::UpdateSelectedPage(size_t newsel)
 260 {
 261     m_selection = newsel;
 262     GetToolBar()->ToggleTool(newsel + 1, true);
 263 }
 264
 265 // Not part of the wxBookctrl API, but must be called in OnIdle or
 266 // by application to realize the toolbar and select the initial page.
 267 void wxToolbook::Realize()
 268 {
 269     if (m_needsRealizing)
 270     {
 271         GetToolBar()->SetToolBitmapSize(m_maxBitmapSize);
 272
 273         int remap = wxSystemOptions::GetOptionInt(wxT("msw.remap"));
 274         wxSystemOptions::SetOption(wxT("msw.remap"), 0);
 275         GetToolBar()->Realize();
 276         wxSystemOptions::SetOption(wxT("msw.remap"), remap);
 277     }
 278
 279     m_needsRealizing = false;
 280
 281     if (m_selection == -1)
 282         m_selection = 0;
 283
 284     if (GetPageCount() > 0)
 285     {
 286         int sel = m_selection;
 287         m_selection = -1;
 288         SetSelection(sel);
 289     }
 290
 291     DoSize();
 292 }
 293
 294 int wxToolbook::HitTest(const wxPoint& pt, long *flags) const
 295 {
 296     int pagePos = wxNOT_FOUND;
 297
 298     if ( flags )
 299         *flags = wxBK_HITTEST_NOWHERE;
 300
 301     // convert from wxToolbook coordinates to wxToolBar ones
 302     const wxToolBarBase * const tbar = GetToolBar();
 303     const wxPoint tbarPt = tbar->ScreenToClient(ClientToScreen(pt));
 304
 305     // is the point over the toolbar?
 306     if ( wxRect(tbar->GetSize()).Contains(tbarPt) )
 307     {
 308         const wxToolBarToolBase * const
 309             tool = tbar->FindToolForPosition(tbarPt.x, tbarPt.y);
 310
 311         if ( tool )
 312         {
 313             pagePos = tbar->GetToolPos(tool->GetId());
 314             if ( flags )
 315                 *flags = wxBK_HITTEST_ONICON | wxBK_HITTEST_ONLABEL;
 316         }
 317     }
 318     else // not over the toolbar
 319     {
 320         if ( flags && GetPageRect().Contains(pt) )
 321             *flags |= wxBK_HITTEST_ONPAGE;
 322     }
 323
 324     return pagePos;
 325 }
 326
 327 void wxToolbook::OnIdle(wxIdleEvent& event)
 328 {
 329     if (m_needsRealizing)
 330         Realize();
 331     event.Skip();
 332 }
 333
 334 // ----------------------------------------------------------------------------
 335 // adding/removing the pages
 336 // ----------------------------------------------------------------------------
 337
 338 bool wxToolbook::InsertPage(size_t n,
 339                        wxWindow *page,
 340                        const wxString& text,
 341                        bool bSelect,
 342                        int imageId)
 343 {
 344     if ( !wxBookCtrlBase::InsertPage(n, page, text, bSelect, imageId) )
 345         return false;
 346
 347     m_needsRealizing = true;
 348
 349     wxASSERT(GetImageList() != NULL);
 350
 351     if (!GetImageList())
 352         return false;
 353
 354     // TODO: make sure all platforms can convert between icon and bitmap,
 355     // and/or test whether the image is a bitmap or an icon.
 356 #ifdef __WXMAC__
 357     wxBitmap bitmap = GetImageList()->GetBitmap(imageId);
 358 #else
 359     // On Windows, we can lose information by using GetBitmap, so extract icon instead
 360     wxIcon icon = GetImageList()->GetIcon(imageId);
 361     wxBitmap bitmap;
 362     bitmap.CopyFromIcon(icon);
 363 #endif
 364
 365     m_maxBitmapSize.x = wxMax(bitmap.GetWidth(), m_maxBitmapSize.x);
 366     m_maxBitmapSize.y = wxMax(bitmap.GetHeight(), m_maxBitmapSize.y);
 367
 368     GetToolBar()->SetToolBitmapSize(m_maxBitmapSize);
 369     GetToolBar()->AddRadioTool(n + 1, text, bitmap, wxNullBitmap, text);
 370
 371     if (bSelect)
 372     {
 373         GetToolBar()->ToggleTool(n, true);
 374         m_selection = n;
 375     }
 376     else
 377         page->Hide();
 378
 379     InvalidateBestSize();
 380     return true;
 381 }
 382
 383 wxWindow *wxToolbook::DoRemovePage(size_t page)
 384 {
 385     const size_t page_count = GetPageCount();
 386     wxWindow *win = wxBookCtrlBase::DoRemovePage(page);
 387
 388     if ( win )
 389     {
 390         GetToolBar()->DeleteTool(page + 1);
 391
 392         if (m_selection >= (int)page)
 393         {
 394             // force new sel valid if possible
 395             int sel = m_selection - 1;
 396             if (page_count == 1)
 397                 sel = wxNOT_FOUND;
 398             else if ((page_count == 2) || (sel == -1))
 399                 sel = 0;
 400
 401             // force sel invalid if deleting current page - don't try to hide it
 402             m_selection = (m_selection == (int)page) ? wxNOT_FOUND : m_selection - 1;
 403
 404             if ((sel != wxNOT_FOUND) && (sel != m_selection))
 405                 SetSelection(sel);
 406         }
 407     }
 408
 409     return win;
 410 }
 411
 412
 413 bool wxToolbook::DeleteAllPages()
 414 {
 415     GetToolBar()->ClearTools();
 416     return wxBookCtrlBase::DeleteAllPages();
 417 }
 418
 419 // ----------------------------------------------------------------------------
 420 // wxToolbook events
 421 // ----------------------------------------------------------------------------
 422
 423 void wxToolbook::OnToolSelected(wxCommandEvent& event)
 424 {
 425     const int selNew = event.GetId() - 1;
 426
 427     if ( selNew == m_selection )
 428     {
 429         // this event can only come from our own Select(m_selection) below
 430         // which we call when the page change is vetoed, so we should simply
 431         // ignore it
 432         return;
 433     }
 434
 435     SetSelection(selNew);
 436
 437     // change wasn't allowed, return to previous state
 438     if (m_selection != selNew)
 439     {
 440         GetToolBar()->ToggleTool(m_selection, false);
 441     }
 442 }
 443
 444 #endif // wxUSE_TOOLBOOK