src/common/menucmn.cpp

   1 ///////////////////////////////////////////////////////////////////////////////
   2 // Name:        common/menucmn.cpp
   3 // Purpose:     wxMenu and wxMenuBar methods common to all ports
   4 // Author:      Vadim Zeitlin
   5 // Modified by:
   6 // Created:     26.10.99
   7 // RCS-ID:      $Id$
   8 // Copyright:   (c) wxWindows team
   9 // Licence:     wxWindows licence
  10 ///////////////////////////////////////////////////////////////////////////////
  11
  12 // ============================================================================
  13 // declarations
  14 // ============================================================================
  15
  16 // ----------------------------------------------------------------------------
  17 // headers
  18 // ----------------------------------------------------------------------------
  19
  20 #ifdef __GNUG__
  21     #pragma implementation "menubase.h"
  22 #endif
  23
  24 // For compilers that support precompilation, includes "wx.h".
  25 #include "wx/wxprec.h"
  26
  27 #ifdef __BORLANDC__
  28     #pragma hdrstop
  29 #endif
  30
  31 #if wxUSE_MENUS
  32
  33 #include <ctype.h>
  34
  35 #ifndef WX_PRECOMP
  36     #include "wx/intl.h"
  37     #include "wx/log.h"
  38     #include "wx/menu.h"
  39 #endif
  40
  41 // ----------------------------------------------------------------------------
  42 // template lists
  43 // ----------------------------------------------------------------------------
  44
  45 #include "wx/listimpl.cpp"
  46
  47 WX_DEFINE_LIST(wxMenuList);
  48 WX_DEFINE_LIST(wxMenuItemList);
  49
  50 // ============================================================================
  51 // implementation
  52 // ============================================================================
  53
  54 // ----------------------------------------------------------------------------
  55 // wxMenuItem
  56 // ----------------------------------------------------------------------------
  57
  58 wxMenuItemBase::wxMenuItemBase(wxMenu *parentMenu,
  59                                int id,
  60                                const wxString& text,
  61                                const wxString& help,
  62                                wxItemKind kind,
  63                                wxMenu *subMenu)
  64               : m_text(text),
  65                 m_help(help)
  66 {
  67     wxASSERT_MSG( parentMenu != NULL, wxT("menuitem should have a menu") );
  68
  69     m_parentMenu  = parentMenu;
  70     m_subMenu     = subMenu;
  71     m_isEnabled   = TRUE;
  72     m_isChecked   = FALSE;
  73     m_id          = id;
  74     m_kind        = kind;
  75 }
  76
  77 wxMenuItemBase::~wxMenuItemBase()
  78 {
  79     delete m_subMenu;
  80 }
  81
  82 #if wxUSE_ACCEL
  83
  84 static inline bool CompareAccelString(const wxString& str, const wxChar *accel)
  85 {
  86 #if wxUSE_INTL
  87     return str == accel || str == wxGetTranslation(accel);
  88 #else
  89     return str == accel;
  90 #endif
  91 }
  92
  93 // return wxAcceleratorEntry for the given menu string or NULL if none
  94 // specified
  95 wxAcceleratorEntry *wxGetAccelFromString(const wxString& label)
  96 {
  97     // check for accelerators: they are given after '\t'
  98     int posTab = label.Find(wxT('\t'));
  99     if ( posTab != wxNOT_FOUND ) {
 100         // parse the accelerator string
 101         int keyCode = 0;
 102         int accelFlags = wxACCEL_NORMAL;
 103         wxString current;
 104         for ( size_t n = (size_t)posTab + 1; n < label.Len(); n++ ) {
 105             if ( (label[n] == '+') || (label[n] == '-') ) {
 106                 if ( CompareAccelString(current, wxTRANSLATE("ctrl")) )
 107                     accelFlags |= wxACCEL_CTRL;
 108                 else if ( CompareAccelString(current, wxTRANSLATE("alt")) )
 109                     accelFlags |= wxACCEL_ALT;
 110                 else if ( CompareAccelString(current, wxTRANSLATE("shift")) )
 111                     accelFlags |= wxACCEL_SHIFT;
 112                 else {
 113                     // we may have "Ctrl-+", for example, but we still want to
 114                     // catch typos like "Crtl-A" so only give the warning if we
 115                     // have something before the current '+' or '-', else take
 116                     // it as a literal symbol
 117                     if ( current.empty() )
 118                     {
 119                         current += label[n];
 120
 121                         // skip clearing it below
 122                         continue;
 123                     }
 124                     else
 125                     {
 126                         wxLogDebug(wxT("Unknown accel modifier: '%s'"),
 127                                    current.c_str());
 128                     }
 129                 }
 130
 131                 current.clear();
 132             }
 133             else {
 134                 current += wxTolower(label[n]);
 135             }
 136         }
 137
 138         if ( current.IsEmpty() ) {
 139             wxLogDebug(wxT("No accel key found, accel string ignored."));
 140         }
 141         else {
 142             if ( current.Len() == 1 ) {
 143                 // it's a letter
 144                 keyCode = current[0U];
 145
 146                 // Only call wxToupper if control, alt, or shift is held down,
 147                 // otherwise lower case accelerators won't work.
 148                 if (accelFlags != wxACCEL_NORMAL) {
 149                     keyCode = wxToupper(keyCode);
 150                 }
 151             }
 152             else {
 153                 // is it a function key?
 154                 if ( current[0U] == 'f' && isdigit(current[1U]) &&
 155                      (current.Len() == 2 ||
 156                      (current.Len() == 3 && isdigit(current[2U]))) ) {
 157                     int n;
 158                     wxSscanf(current.c_str() + 1, wxT("%d"), &n);
 159
 160                     keyCode = WXK_F1 + n - 1;
 161                 }
 162                 else {
 163                     // several special cases
 164                     current.MakeUpper();
 165                     if ( current == wxT("DEL") )
 166                         keyCode = WXK_DELETE;
 167                     else if ( current == wxT("DELETE") )
 168                         keyCode = WXK_DELETE;
 169                     else if ( current == wxT("INS") )
 170                         keyCode = WXK_INSERT;
 171                     else if ( current == wxT("INSERT") )
 172                         keyCode = WXK_INSERT;
 173                     else if ( current == wxT("ENTER") || current == wxT("RETURN") )
 174                         keyCode = WXK_RETURN;
 175                     else if ( current == wxT("PGUP") )
 176                         keyCode = WXK_PRIOR;
 177                     else if ( current == wxT("PGDN") )
 178                         keyCode = WXK_NEXT;
 179                     else if ( current == wxT("LEFT") )
 180                         keyCode = WXK_LEFT;
 181                     else if ( current == wxT("RIGHT") )
 182                         keyCode = WXK_RIGHT;
 183                     else if ( current == wxT("UP") )
 184                         keyCode = WXK_UP;
 185                     else if ( current == wxT("DOWN") )
 186                         keyCode = WXK_DOWN;
 187                     else if ( current == wxT("HOME") )
 188                         keyCode = WXK_HOME;
 189                     else if ( current == wxT("END") )
 190                         keyCode = WXK_END;
 191                     else if ( current == wxT("SPACE") )
 192                         keyCode = WXK_SPACE;
 193                     else if ( current == wxT("TAB") )
 194                         keyCode = WXK_TAB;
 195                     else if ( current == wxT("ESC") || current == wxT("ESCAPE") )
 196                         keyCode = WXK_ESCAPE;
 197                     else
 198                     {
 199                         wxLogDebug(wxT("Unrecognized accel key '%s', accel string ignored."),
 200                                    current.c_str());
 201                     }
 202                 }
 203             }
 204         }
 205
 206         if ( keyCode ) {
 207             // we do have something
 208             return new wxAcceleratorEntry(accelFlags, keyCode);
 209         }
 210     }
 211
 212     return (wxAcceleratorEntry *)NULL;
 213 }
 214
 215 wxAcceleratorEntry *wxMenuItemBase::GetAccel() const
 216 {
 217     return wxGetAccelFromString(GetText());
 218 }
 219
 220 void wxMenuItemBase::SetAccel(wxAcceleratorEntry *accel)
 221 {
 222     wxString text = m_text.BeforeFirst(wxT('\t'));
 223     if ( accel )
 224     {
 225         text += wxT('\t');
 226
 227         int flags = accel->GetFlags();
 228         if ( flags & wxACCEL_ALT )
 229             text += wxT("Alt-");
 230         if ( flags & wxACCEL_CTRL )
 231             text += wxT("Ctrl-");
 232         if ( flags & wxACCEL_SHIFT )
 233             text += wxT("Shift-");
 234
 235         int code = accel->GetKeyCode();
 236         switch ( code )
 237         {
 238             case WXK_F1:
 239             case WXK_F2:
 240             case WXK_F3:
 241             case WXK_F4:
 242             case WXK_F5:
 243             case WXK_F6:
 244             case WXK_F7:
 245             case WXK_F8:
 246             case WXK_F9:
 247             case WXK_F10:
 248             case WXK_F11:
 249             case WXK_F12:
 250                 text << wxT('F') << code - WXK_F1 + 1;
 251                 break;
 252
 253             // if there are any other keys wxGetAccelFromString() may return,
 254             // we should process them here
 255
 256             default:
 257                 if ( wxIsalnum(code) )
 258                 {
 259                     text << (wxChar)code;
 260
 261                     break;
 262                 }
 263
 264                 wxFAIL_MSG( wxT("unknown keyboard accel") );
 265         }
 266     }
 267
 268     SetText(text);
 269 }
 270
 271 #endif // wxUSE_ACCEL
 272
 273 // ----------------------------------------------------------------------------
 274 // wxMenu ctor and dtor
 275 // ----------------------------------------------------------------------------
 276
 277 void wxMenuBase::Init(long style)
 278 {
 279     m_items.DeleteContents(TRUE);
 280
 281     m_menuBar = (wxMenuBar *)NULL;
 282     m_menuParent = (wxMenu *)NULL;
 283
 284     m_invokingWindow = (wxWindow *)NULL;
 285     m_style = style;
 286     m_clientData = (void *)NULL;
 287     m_eventHandler = this;
 288
 289 #if wxUSE_MENU_CALLBACK
 290     m_callback = (wxFunction) NULL;
 291 #endif // wxUSE_MENU_CALLBACK
 292 }
 293
 294 wxMenuBase::~wxMenuBase()
 295 {
 296     // nothing to do, wxMenuItemList dtor will delete the menu items.
 297
 298     // Actually, in GTK, the submenus have to get deleted first.
 299 }
 300
 301 // ----------------------------------------------------------------------------
 302 // wxMenu item adding/removing
 303 // ----------------------------------------------------------------------------
 304
 305 void wxMenuBase::AddSubMenu(wxMenu *submenu)
 306 {
 307     wxCHECK_RET( submenu, _T("can't add a NULL submenu") );
 308
 309     if ( m_menuBar )
 310     {
 311         submenu->Attach(m_menuBar);
 312     }
 313
 314     submenu->SetParent((wxMenu *)this);
 315 }
 316
 317 bool wxMenuBase::DoAppend(wxMenuItem *item)
 318 {
 319     wxCHECK_MSG( item, FALSE, wxT("invalid item in wxMenu::Append()") );
 320
 321     m_items.Append(item);
 322     if ( item->IsSubMenu() )
 323     {
 324         AddSubMenu(item->GetSubMenu());
 325     }
 326
 327     return TRUE;
 328 }
 329
 330 bool wxMenuBase::Insert(size_t pos, wxMenuItem *item)
 331 {
 332     wxCHECK_MSG( item, FALSE, wxT("invalid item in wxMenu::Insert") );
 333
 334     if ( pos == GetMenuItemCount() )
 335     {
 336         return DoAppend(item);
 337     }
 338     else
 339     {
 340         wxCHECK_MSG( pos < GetMenuItemCount(), FALSE,
 341                      wxT("invalid index in wxMenu::Insert") );
 342
 343         return DoInsert(pos, item);
 344     }
 345 }
 346
 347 bool wxMenuBase::DoInsert(size_t pos, wxMenuItem *item)
 348 {
 349     wxCHECK_MSG( item, FALSE, wxT("invalid item in wxMenu::Insert()") );
 350
 351     wxMenuItemList::Node *node = m_items.Item(pos);
 352     wxCHECK_MSG( node, FALSE, wxT("invalid index in wxMenu::Insert()") );
 353
 354     m_items.Insert(node, item);
 355     if ( item->IsSubMenu() )
 356     {
 357         AddSubMenu(item->GetSubMenu());
 358     }
 359
 360     return TRUE;
 361 }
 362
 363 wxMenuItem *wxMenuBase::Remove(wxMenuItem *item)
 364 {
 365     wxCHECK_MSG( item, NULL, wxT("invalid item in wxMenu::Remove") );
 366
 367     return DoRemove(item);
 368 }
 369
 370 wxMenuItem *wxMenuBase::DoRemove(wxMenuItem *item)
 371 {
 372     wxMenuItemList::Node *node = m_items.Find(item);
 373
 374     // if we get here, the item is valid or one of Remove() functions is broken
 375     wxCHECK_MSG( node, NULL, wxT("bug in wxMenu::Remove logic") );
 376
 377     // we detach the item, but we do delete the list node (i.e. don't call
 378     // DetachNode() here!)
 379     node->SetData((wxMenuItem *)NULL);  // to prevent it from deleting the item
 380     m_items.DeleteNode(node);
 381
 382     // item isn't attached to anything any more
 383     wxMenu *submenu = item->GetSubMenu();
 384     if ( submenu )
 385     {
 386         submenu->SetParent((wxMenu *)NULL);
 387     }
 388
 389     return item;
 390 }
 391
 392 bool wxMenuBase::Delete(wxMenuItem *item)
 393 {
 394     wxCHECK_MSG( item, FALSE, wxT("invalid item in wxMenu::Delete") );
 395
 396     return DoDelete(item);
 397 }
 398
 399 bool wxMenuBase::DoDelete(wxMenuItem *item)
 400 {
 401     wxMenuItem *item2 = DoRemove(item);
 402     wxCHECK_MSG( item2, FALSE, wxT("failed to delete menu item") );
 403
 404     // don't delete the submenu
 405     item2->SetSubMenu((wxMenu *)NULL);
 406
 407     delete item2;
 408
 409     return TRUE;
 410 }
 411
 412 bool wxMenuBase::Destroy(wxMenuItem *item)
 413 {
 414     wxCHECK_MSG( item, FALSE, wxT("invalid item in wxMenu::Destroy") );
 415
 416     return DoDestroy(item);
 417 }
 418
 419 bool wxMenuBase::DoDestroy(wxMenuItem *item)
 420 {
 421     wxMenuItem *item2 = DoRemove(item);
 422     wxCHECK_MSG( item2, FALSE, wxT("failed to delete menu item") );
 423
 424     delete item2;
 425
 426     return TRUE;
 427 }
 428
 429 // ----------------------------------------------------------------------------
 430 // wxMenu searching for items
 431 // ----------------------------------------------------------------------------
 432
 433 // Finds the item id matching the given string, -1 if not found.
 434 int wxMenuBase::FindItem(const wxString& text) const
 435 {
 436     wxString label = wxMenuItem::GetLabelFromText(text);
 437     for ( wxMenuItemList::Node *node = m_items.GetFirst();
 438           node;
 439           node = node->GetNext() )
 440     {
 441         wxMenuItem *item = node->GetData();
 442         if ( item->IsSubMenu() )
 443         {
 444             int rc = item->GetSubMenu()->FindItem(label);
 445             if ( rc != wxNOT_FOUND )
 446                 return rc;
 447         }
 448
 449         // we execute this code for submenus as well to alllow finding them by
 450         // name just like the ordinary items
 451         if ( !item->IsSeparator() )
 452         {
 453             if ( item->GetLabel() == label )
 454                 return item->GetId();
 455         }
 456     }
 457
 458     return wxNOT_FOUND;
 459 }
 460
 461 // recursive search for item by id
 462 wxMenuItem *wxMenuBase::FindItem(int itemId, wxMenu **itemMenu) const
 463 {
 464     if ( itemMenu )
 465         *itemMenu = NULL;
 466
 467     wxMenuItem *item = NULL;
 468     for ( wxMenuItemList::Node *node = m_items.GetFirst();
 469           node && !item;
 470           node = node->GetNext() )
 471     {
 472         item = node->GetData();
 473
 474         if ( item->GetId() == itemId )
 475         {
 476             if ( itemMenu )
 477                 *itemMenu = (wxMenu *)this;
 478         }
 479         else if ( item->IsSubMenu() )
 480         {
 481             item = item->GetSubMenu()->FindItem(itemId, itemMenu);
 482         }
 483         else
 484         {
 485             // don't exit the loop
 486             item = NULL;
 487         }
 488     }
 489
 490     return item;
 491 }
 492
 493 // non recursive search
 494 wxMenuItem *wxMenuBase::FindChildItem(int id, size_t *ppos) const
 495 {
 496     wxMenuItem *item = (wxMenuItem *)NULL;
 497     wxMenuItemList::Node *node = GetMenuItems().GetFirst();
 498
 499     size_t pos;
 500     for ( pos = 0; node; pos++ )
 501     {
 502         if ( node->GetData()->GetId() == id )
 503         {
 504             item = node->GetData();
 505
 506             break;
 507         }
 508
 509         node = node->GetNext();
 510     }
 511
 512     if ( ppos )
 513     {
 514         *ppos = item ? pos : (size_t)wxNOT_FOUND;
 515     }
 516
 517     return item;
 518 }
 519
 520 // ----------------------------------------------------------------------------
 521 // wxMenu helpers used by derived classes
 522 // ----------------------------------------------------------------------------
 523
 524 // Update a menu and all submenus recursively. source is the object that has
 525 // the update event handlers defined for it. If NULL, the menu or associated
 526 // window will be used.
 527 void wxMenuBase::UpdateUI(wxEvtHandler* source)
 528 {
 529     if ( !source && GetInvokingWindow() )
 530         source = GetInvokingWindow()->GetEventHandler();
 531     if ( !source )
 532         source = GetEventHandler();
 533     if ( !source )
 534         source = this;
 535
 536     wxMenuItemList::Node* node = GetMenuItems().GetFirst();
 537     while ( node )
 538     {
 539         wxMenuItem* item = node->GetData();
 540         if ( !item->IsSeparator() )
 541         {
 542             wxWindowID id = item->GetId();
 543             wxUpdateUIEvent event(id);
 544             event.SetEventObject( source );
 545
 546             if ( source->ProcessEvent(event) )
 547             {
 548                 // if anything changed, update the chanegd attribute
 549                 if (event.GetSetText())
 550                     SetLabel(id, event.GetText());
 551                 if (event.GetSetChecked())
 552                     Check(id, event.GetChecked());
 553                 if (event.GetSetEnabled())
 554                     Enable(id, event.GetEnabled());
 555             }
 556
 557             // recurse to the submenus
 558             if ( item->GetSubMenu() )
 559                 item->GetSubMenu()->UpdateUI(source);
 560         }
 561         //else: item is a separator (which don't process update UI events)
 562
 563         node = node->GetNext();
 564     }
 565 }
 566
 567 bool wxMenuBase::SendEvent(int id, int checked)
 568 {
 569     wxCommandEvent event(wxEVT_COMMAND_MENU_SELECTED, id);
 570     event.SetEventObject(this);
 571     event.SetInt(checked);
 572
 573     bool processed = FALSE;
 574
 575 #if wxUSE_MENU_CALLBACK
 576     // Try a callback
 577     if (m_callback)
 578     {
 579         (void)(*(m_callback))(*this, event);
 580         processed = TRUE;
 581     }
 582 #endif // wxUSE_MENU_CALLBACK
 583
 584     // Try the menu's event handler
 585     if ( !processed )
 586     {
 587         wxEvtHandler *handler = GetEventHandler();
 588         if ( handler )
 589             processed = handler->ProcessEvent(event);
 590     }
 591
 592     // Try the window the menu was popped up from (and up through the
 593     // hierarchy)
 594     if ( !processed )
 595     {
 596         const wxMenuBase *menu = this;
 597         while ( menu )
 598         {
 599             wxWindow *win = menu->GetInvokingWindow();
 600             if ( win )
 601             {
 602                 processed = win->GetEventHandler()->ProcessEvent(event);
 603                 break;
 604             }
 605
 606             menu = menu->GetParent();
 607         }
 608     }
 609
 610     return processed;
 611 }
 612
 613 // ----------------------------------------------------------------------------
 614 // wxMenu attaching/detaching to/from menu bar
 615 // ----------------------------------------------------------------------------
 616
 617 void wxMenuBase::Attach(wxMenuBarBase *menubar)
 618 {
 619     // use Detach() instead!
 620     wxASSERT_MSG( menubar, _T("menu can't be attached to NULL menubar") );
 621
 622     // use IsAttached() to prevent this from happening
 623     wxASSERT_MSG( !m_menuBar, _T("attaching menu twice?") );
 624
 625     m_menuBar = (wxMenuBar *)menubar;
 626 }
 627
 628 void wxMenuBase::Detach()
 629 {
 630     // use IsAttached() to prevent this from happening
 631     wxASSERT_MSG( m_menuBar, _T("detaching unattached menu?") );
 632
 633     m_menuBar = NULL;
 634 }
 635
 636 // ----------------------------------------------------------------------------
 637 // wxMenu functions forwarded to wxMenuItem
 638 // ----------------------------------------------------------------------------
 639
 640 void wxMenuBase::Enable( int id, bool enable )
 641 {
 642     wxMenuItem *item = FindItem(id);
 643
 644     wxCHECK_RET( item, wxT("wxMenu::Enable: no such item") );
 645
 646     item->Enable(enable);
 647 }
 648
 649 bool wxMenuBase::IsEnabled( int id ) const
 650 {
 651     wxMenuItem *item = FindItem(id);
 652
 653     wxCHECK_MSG( item, FALSE, wxT("wxMenu::IsEnabled: no such item") );
 654
 655     return item->IsEnabled();
 656 }
 657
 658 void wxMenuBase::Check( int id, bool enable )
 659 {
 660     wxMenuItem *item = FindItem(id);
 661
 662     wxCHECK_RET( item, wxT("wxMenu::Check: no such item") );
 663
 664     item->Check(enable);
 665 }
 666
 667 bool wxMenuBase::IsChecked( int id ) const
 668 {
 669     wxMenuItem *item = FindItem(id);
 670
 671     wxCHECK_MSG( item, FALSE, wxT("wxMenu::IsChecked: no such item") );
 672
 673     return item->IsChecked();
 674 }
 675
 676 void wxMenuBase::SetLabel( int id, const wxString &label )
 677 {
 678     wxMenuItem *item = FindItem(id);
 679
 680     wxCHECK_RET( item, wxT("wxMenu::SetLabel: no such item") );
 681
 682     item->SetText(label);
 683 }
 684
 685 wxString wxMenuBase::GetLabel( int id ) const
 686 {
 687     wxMenuItem *item = FindItem(id);
 688
 689     wxCHECK_MSG( item, wxT(""), wxT("wxMenu::GetLabel: no such item") );
 690
 691     return item->GetText();
 692 }
 693
 694 void wxMenuBase::SetHelpString( int id, const wxString& helpString )
 695 {
 696     wxMenuItem *item = FindItem(id);
 697
 698     wxCHECK_RET( item, wxT("wxMenu::SetHelpString: no such item") );
 699
 700     item->SetHelp( helpString );
 701 }
 702
 703 wxString wxMenuBase::GetHelpString( int id ) const
 704 {
 705     wxMenuItem *item = FindItem(id);
 706
 707     wxCHECK_MSG( item, wxT(""), wxT("wxMenu::GetHelpString: no such item") );
 708
 709     return item->GetHelp();
 710 }
 711
 712 // ----------------------------------------------------------------------------
 713 // wxMenuBarBase ctor and dtor
 714 // ----------------------------------------------------------------------------
 715
 716 wxMenuBarBase::wxMenuBarBase()
 717 {
 718     // we own the menus when we get them
 719     m_menus.DeleteContents(TRUE);
 720
 721     // not attached yet
 722     m_menuBarFrame = NULL;
 723 }
 724
 725 wxMenuBarBase::~wxMenuBarBase()
 726 {
 727     // nothing to do, the list will delete the menus because of the call to
 728     // DeleteContents() above
 729 }
 730
 731 // ----------------------------------------------------------------------------
 732 // wxMenuBar item access: the base class versions manage m_menus list, the
 733 // derived class should reflect the changes in the real menubar
 734 // ----------------------------------------------------------------------------
 735
 736 wxMenu *wxMenuBarBase::GetMenu(size_t pos) const
 737 {
 738     wxMenuList::Node *node = m_menus.Item(pos);
 739     wxCHECK_MSG( node, NULL, wxT("bad index in wxMenuBar::GetMenu()") );
 740
 741     return node->GetData();
 742 }
 743
 744 bool wxMenuBarBase::Append(wxMenu *menu, const wxString& WXUNUSED(title))
 745 {
 746     wxCHECK_MSG( menu, FALSE, wxT("can't append NULL menu") );
 747
 748     m_menus.Append(menu);
 749     menu->Attach(this);
 750
 751     return TRUE;
 752 }
 753
 754 bool wxMenuBarBase::Insert(size_t pos, wxMenu *menu,
 755                            const wxString& title)
 756 {
 757     if ( pos == m_menus.GetCount() )
 758     {
 759         return wxMenuBarBase::Append(menu, title);
 760     }
 761     else // not at the end
 762     {
 763         wxCHECK_MSG( menu, FALSE, wxT("can't insert NULL menu") );
 764
 765         wxMenuList::Node *node = m_menus.Item(pos);
 766         wxCHECK_MSG( node, FALSE, wxT("bad index in wxMenuBar::Insert()") );
 767
 768         m_menus.Insert(node, menu);
 769         menu->Attach(this);
 770
 771         return TRUE;
 772     }
 773 }
 774
 775 wxMenu *wxMenuBarBase::Replace(size_t pos, wxMenu *menu,
 776                                const wxString& WXUNUSED(title))
 777 {
 778     wxCHECK_MSG( menu, NULL, wxT("can't insert NULL menu") );
 779
 780     wxMenuList::Node *node = m_menus.Item(pos);
 781     wxCHECK_MSG( node, NULL, wxT("bad index in wxMenuBar::Replace()") );
 782
 783     wxMenu *menuOld = node->GetData();
 784     node->SetData(menu);
 785
 786     menu->Attach(this);
 787     menuOld->Detach();
 788
 789     return menuOld;
 790 }
 791
 792 wxMenu *wxMenuBarBase::Remove(size_t pos)
 793 {
 794     wxMenuList::Node *node = m_menus.Item(pos);
 795     wxCHECK_MSG( node, NULL, wxT("bad index in wxMenuBar::Remove()") );
 796
 797     node = m_menus.DetachNode(node);
 798     wxCHECK( node, NULL );  // unexpected
 799     wxMenu *menu = node->GetData();
 800     menu->Detach();
 801
 802     delete node;
 803
 804     return menu;
 805 }
 806
 807 int wxMenuBarBase::FindMenu(const wxString& title) const
 808 {
 809     wxString label = wxMenuItem::GetLabelFromText(title);
 810
 811     size_t count = GetMenuCount();
 812     for ( size_t i = 0; i < count; i++ )
 813     {
 814         wxString title2 = GetLabelTop(i);
 815         if ( (title2 == title) ||
 816              (wxMenuItem::GetLabelFromText(title2) == label) )
 817         {
 818             // found
 819             return (int)i;
 820         }
 821     }
 822
 823     return wxNOT_FOUND;
 824
 825 }
 826
 827 // ----------------------------------------------------------------------------
 828 // wxMenuBar attaching/detaching to/from the frame
 829 // ----------------------------------------------------------------------------
 830
 831 void wxMenuBarBase::Attach(wxFrame *frame)
 832 {
 833     wxASSERT_MSG( !IsAttached(), wxT("menubar already attached!") );
 834
 835     m_menuBarFrame = frame;
 836 }
 837
 838 void wxMenuBarBase::Detach()
 839 {
 840     wxASSERT_MSG( IsAttached(), wxT("detaching unattached menubar") );
 841
 842     m_menuBarFrame = NULL;
 843 }
 844
 845 // ----------------------------------------------------------------------------
 846 // wxMenuBar searching for items
 847 // ----------------------------------------------------------------------------
 848
 849 wxMenuItem *wxMenuBarBase::FindItem(int id, wxMenu **menu) const
 850 {
 851     if ( menu )
 852         *menu = NULL;
 853
 854     wxMenuItem *item = NULL;
 855     size_t count = GetMenuCount();
 856     for ( size_t i = 0; !item && (i < count); i++ )
 857     {
 858         item = m_menus[i]->FindItem(id, menu);
 859     }
 860
 861     return item;
 862 }
 863
 864 int wxMenuBarBase::FindMenuItem(const wxString& menu, const wxString& item) const
 865 {
 866     wxString label = wxMenuItem::GetLabelFromText(menu);
 867
 868     int i = 0;
 869     wxMenuList::Node *node;
 870     for ( node = m_menus.GetFirst(); node; node = node->GetNext(), i++ )
 871     {
 872         if ( label == wxMenuItem::GetLabelFromText(GetLabelTop(i)) )
 873             return node->GetData()->FindItem(item);
 874     }
 875
 876     return wxNOT_FOUND;
 877 }
 878
 879 // ---------------------------------------------------------------------------
 880 // wxMenuBar functions forwarded to wxMenuItem
 881 // ---------------------------------------------------------------------------
 882
 883 void wxMenuBarBase::Enable(int id, bool enable)
 884 {
 885     wxMenuItem *item = FindItem(id);
 886
 887     wxCHECK_RET( item, wxT("attempt to enable an item which doesn't exist") );
 888
 889     item->Enable(enable);
 890 }
 891
 892 void wxMenuBarBase::Check(int id, bool check)
 893 {
 894     wxMenuItem *item = FindItem(id);
 895
 896     wxCHECK_RET( item, wxT("attempt to check an item which doesn't exist") );
 897     wxCHECK_RET( item->IsCheckable(), wxT("attempt to check an uncheckable item") );
 898
 899     item->Check(check);
 900 }
 901
 902 bool wxMenuBarBase::IsChecked(int id) const
 903 {
 904     wxMenuItem *item = FindItem(id);
 905
 906     wxCHECK_MSG( item, FALSE, wxT("wxMenuBar::IsChecked(): no such item") );
 907
 908     return item->IsChecked();
 909 }
 910
 911 bool wxMenuBarBase::IsEnabled(int id) const
 912 {
 913     wxMenuItem *item = FindItem(id);
 914
 915     wxCHECK_MSG( item, FALSE, wxT("wxMenuBar::IsEnabled(): no such item") );
 916
 917     return item->IsEnabled();
 918 }
 919
 920 void wxMenuBarBase::SetLabel(int id, const wxString& label)
 921 {
 922     wxMenuItem *item = FindItem(id);
 923
 924     wxCHECK_RET( item, wxT("wxMenuBar::SetLabel(): no such item") );
 925
 926     item->SetText(label);
 927 }
 928
 929 wxString wxMenuBarBase::GetLabel(int id) const
 930 {
 931     wxMenuItem *item = FindItem(id);
 932
 933     wxCHECK_MSG( item, wxEmptyString,
 934                  wxT("wxMenuBar::GetLabel(): no such item") );
 935
 936     return item->GetText();
 937 }
 938
 939 void wxMenuBarBase::SetHelpString(int id, const wxString& helpString)
 940 {
 941     wxMenuItem *item = FindItem(id);
 942
 943     wxCHECK_RET( item, wxT("wxMenuBar::SetHelpString(): no such item") );
 944
 945     item->SetHelp(helpString);
 946 }
 947
 948 wxString wxMenuBarBase::GetHelpString(int id) const
 949 {
 950     wxMenuItem *item = FindItem(id);
 951
 952     wxCHECK_MSG( item, wxEmptyString,
 953                  wxT("wxMenuBar::GetHelpString(): no such item") );
 954
 955     return item->GetHelp();
 956 }
 957
 958 #endif // wxUSE_MENUS