src/common/menucmn.cpp

   1 ///////////////////////////////////////////////////////////////////////////////
   2 // Name:        src/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) wxWidgets team
   9 // Licence:     wxWindows licence
  10 ///////////////////////////////////////////////////////////////////////////////
  11
  12 // ============================================================================
  13 // declarations
  14 // ============================================================================
  15
  16 // ----------------------------------------------------------------------------
  17 // headers
  18 // ----------------------------------------------------------------------------
  19
  20 // For compilers that support precompilation, includes "wx.h".
  21 #include "wx/wxprec.h"
  22
  23 #ifdef __BORLANDC__
  24     #pragma hdrstop
  25 #endif
  26
  27 #if wxUSE_MENUS
  28
  29 #ifndef WX_PRECOMP
  30     #include "wx/intl.h"
  31     #include "wx/log.h"
  32     #include "wx/menu.h"
  33     #include "wx/frame.h"
  34 #endif
  35
  36 #include "wx/stockitem.h"
  37
  38 // ----------------------------------------------------------------------------
  39 // template lists
  40 // ----------------------------------------------------------------------------
  41
  42 #include "wx/listimpl.cpp"
  43
  44 WX_DEFINE_LIST(wxMenuList)
  45 WX_DEFINE_LIST(wxMenuItemList)
  46
  47 // ============================================================================
  48 // implementation
  49 // ============================================================================
  50
  51 // ----------------------------------------------------------------------------
  52 // XTI for wxMenu(Bar)
  53 // ----------------------------------------------------------------------------
  54
  55 wxDEFINE_FLAGS( wxMenuStyle )
  56 wxBEGIN_FLAGS( wxMenuStyle )
  57 wxFLAGS_MEMBER(wxMENU_TEAROFF)
  58 wxEND_FLAGS( wxMenuStyle )
  59
  60 wxIMPLEMENT_DYNAMIC_CLASS_XTI(wxMenu, wxEvtHandler, "wx/menu.h")
  61 wxCOLLECTION_TYPE_INFO( wxMenuItem *, wxMenuItemList ) ;
  62
  63 #if wxUSE_EXTENDED_RTTI
  64 template<> void wxCollectionToVariantArray( wxMenuItemList const &theList,
  65                                            wxAnyList &value)
  66 {
  67     wxListCollectionToAnyList<wxMenuItemList::compatibility_iterator>( theList, value ) ;
  68 }
  69 #endif
  70
  71 wxBEGIN_PROPERTIES_TABLE(wxMenu)
  72 wxEVENT_PROPERTY( Select, wxEVT_COMMAND_MENU_SELECTED, wxCommandEvent)
  73
  74 wxPROPERTY( Title, wxString, SetTitle, GetTitle, wxString(), \
  75            0 /*flags*/, wxT("Helpstring"), wxT("group") )
  76
  77 wxREADONLY_PROPERTY_FLAGS( MenuStyle, wxMenuStyle, long, GetStyle, \
  78                           wxEMPTY_PARAMETER_VALUE, 0 /*flags*/, wxT("Helpstring"), \
  79                           wxT("group")) // style
  80
  81 wxPROPERTY_COLLECTION( MenuItems, wxMenuItemList, wxMenuItem*, Append, \
  82                       GetMenuItems, 0 /*flags*/, wxT("Helpstring"), wxT("group"))
  83 wxEND_PROPERTIES_TABLE()
  84
  85 wxEMPTY_HANDLERS_TABLE(wxMenu)
  86
  87 wxDIRECT_CONSTRUCTOR_2( wxMenu, wxString, Title, long, MenuStyle  )
  88
  89 wxDEFINE_FLAGS( wxMenuBarStyle )
  90
  91 wxBEGIN_FLAGS( wxMenuBarStyle )
  92 wxFLAGS_MEMBER(wxMB_DOCKABLE)
  93 wxEND_FLAGS( wxMenuBarStyle )
  94
  95 #if wxUSE_EXTENDED_RTTI
  96 // the negative id would lead the window (its superclass !) to
  97 // vetoe streaming out otherwise
  98 bool wxMenuBarStreamingCallback( const wxObject *WXUNUSED(object), wxObjectWriter *,
  99                                 wxObjectWriterCallback *, const wxStringToAnyHashMap & )
 100 {
 101     return true;
 102 }
 103 #endif
 104
 105 wxIMPLEMENT_DYNAMIC_CLASS_XTI_CALLBACK(wxMenuBar, wxWindow, "wx/menu.h", \
 106                                        wxMenuBarStreamingCallback)
 107
 108
 109 #if wxUSE_EXTENDED_RTTI
 110 WX_DEFINE_LIST( wxMenuInfoHelperList )
 111
 112 wxIMPLEMENT_DYNAMIC_CLASS_XTI(wxMenuInfoHelper, wxObject, "wx/menu.h")
 113
 114 wxBEGIN_PROPERTIES_TABLE(wxMenuInfoHelper)
 115 wxREADONLY_PROPERTY( Menu, wxMenu*, GetMenu, wxEMPTY_PARAMETER_VALUE, \
 116                     0 /*flags*/, wxT("Helpstring"), wxT("group"))
 117
 118 wxREADONLY_PROPERTY( Title, wxString, GetTitle, wxString(), \
 119                     0 /*flags*/, wxT("Helpstring"), wxT("group"))
 120 wxEND_PROPERTIES_TABLE()
 121
 122 wxEMPTY_HANDLERS_TABLE(wxMenuInfoHelper)
 123
 124 wxCONSTRUCTOR_2( wxMenuInfoHelper, wxMenu*, Menu, wxString, Title )
 125
 126 wxCOLLECTION_TYPE_INFO( wxMenuInfoHelper *, wxMenuInfoHelperList ) ;
 127
 128 template<> void wxCollectionToVariantArray( wxMenuInfoHelperList const &theList,
 129                                            wxAnyList &value)
 130 {
 131     wxListCollectionToAnyList<wxMenuInfoHelperList::compatibility_iterator>( theList, value ) ;
 132 }
 133
 134 #endif
 135
 136 wxBEGIN_PROPERTIES_TABLE(wxMenuBar)
 137 wxPROPERTY_COLLECTION( MenuInfos, wxMenuInfoHelperList, wxMenuInfoHelper*, AppendMenuInfo, \
 138                       GetMenuInfos, 0 /*flags*/, wxT("Helpstring"), wxT("group"))
 139 wxEND_PROPERTIES_TABLE()
 140
 141 wxEMPTY_HANDLERS_TABLE(wxMenuBar)
 142
 143 wxCONSTRUCTOR_DUMMY( wxMenuBar )
 144
 145 #if wxUSE_EXTENDED_RTTI
 146
 147 const wxMenuInfoHelperList& wxMenuBarBase::GetMenuInfos() const
 148 {
 149     wxMenuInfoHelperList* list = const_cast< wxMenuInfoHelperList* > (& m_menuInfos);
 150     WX_CLEAR_LIST( wxMenuInfoHelperList, *list);
 151     for (size_t i = 0 ; i < GetMenuCount(); ++i)
 152     {
 153         wxMenuInfoHelper* info = new wxMenuInfoHelper();
 154         info->Create( GetMenu(i), GetMenuLabel(i));
 155         list->Append(info);
 156     }
 157     return m_menuInfos;
 158 }
 159
 160 #endif
 161
 162 // ----------------------------------------------------------------------------
 163 // XTI for wxMenuItem
 164 // ----------------------------------------------------------------------------
 165
 166 #if wxUSE_EXTENDED_RTTI
 167
 168 bool wxMenuItemStreamingCallback( const wxObject *object, wxObjectWriter *,
 169                                  wxObjectWriterCallback *, const wxStringToAnyHashMap & )
 170 {
 171     const wxMenuItem * mitem = wx_dynamic_cast(const wxMenuItem*, object);
 172     if ( mitem->GetMenu() && !mitem->GetMenu()->GetTitle().empty() )
 173     {
 174         // we don't stream out the first two items for menus with a title,
 175         // they will be reconstructed
 176         if ( mitem->GetMenu()->FindItemByPosition(0) == mitem ||
 177             mitem->GetMenu()->FindItemByPosition(1) == mitem )
 178             return false;
 179     }
 180     return true;
 181 }
 182
 183 #endif
 184
 185 wxBEGIN_ENUM( wxItemKind )
 186 wxENUM_MEMBER( wxITEM_SEPARATOR )
 187 wxENUM_MEMBER( wxITEM_NORMAL )
 188 wxENUM_MEMBER( wxITEM_CHECK )
 189 wxENUM_MEMBER( wxITEM_RADIO )
 190 wxEND_ENUM( wxItemKind )
 191
 192 wxIMPLEMENT_DYNAMIC_CLASS_XTI_CALLBACK(wxMenuItem, wxObject, "wx/menuitem.h", \
 193                                        wxMenuItemStreamingCallback)
 194
 195 wxBEGIN_PROPERTIES_TABLE(wxMenuItem)
 196 wxPROPERTY( Parent, wxMenu*, SetMenu, GetMenu, wxEMPTY_PARAMETER_VALUE, \
 197            0 /*flags*/, wxT("Helpstring"), wxT("group") )
 198 wxPROPERTY( Id, int, SetId, GetId, wxEMPTY_PARAMETER_VALUE, \
 199            0 /*flags*/, wxT("Helpstring"), wxT("group") )
 200 wxPROPERTY( ItemLabel, wxString, SetItemLabel, GetItemLabel, wxString(), \
 201            0 /*flags*/, wxT("Helpstring"), wxT("group") )
 202 wxPROPERTY( Help, wxString, SetHelp, GetHelp, wxString(), \
 203            0 /*flags*/, wxT("Helpstring"), wxT("group") )
 204 wxREADONLY_PROPERTY( Kind, wxItemKind, GetKind, wxEMPTY_PARAMETER_VALUE, \
 205                     0 /*flags*/, wxT("Helpstring"), wxT("group") )
 206 wxPROPERTY( SubMenu, wxMenu*, SetSubMenu, GetSubMenu, wxEMPTY_PARAMETER_VALUE, \
 207            0 /*flags*/, wxT("Helpstring"), wxT("group") )
 208 wxPROPERTY( Enabled, bool, Enable, IsEnabled, wxAny((bool)true), \
 209            0 /*flags*/, wxT("Helpstring"), wxT("group") )
 210 wxPROPERTY( Checked, bool, Check, IsChecked, wxAny((bool)false), \
 211            0 /*flags*/, wxT("Helpstring"), wxT("group") )
 212 wxPROPERTY( Checkable, bool, SetCheckable, IsCheckable, wxAny((bool)false), \
 213            0 /*flags*/, wxT("Helpstring"), wxT("group") )
 214 wxEND_PROPERTIES_TABLE()
 215
 216 wxEMPTY_HANDLERS_TABLE(wxMenuItem)
 217
 218 wxDIRECT_CONSTRUCTOR_6( wxMenuItem, wxMenu*, Parent, int, Id, wxString, \
 219                        Text, wxString, Help, wxItemKind, Kind, wxMenu*, SubMenu )
 220
 221 // ----------------------------------------------------------------------------
 222 // wxMenuItemBase
 223 // ----------------------------------------------------------------------------
 224
 225 wxMenuItemBase::wxMenuItemBase(wxMenu *parentMenu,
 226                                int itemid,
 227                                const wxString& text,
 228                                const wxString& help,
 229                                wxItemKind kind,
 230                                wxMenu *subMenu)
 231 {
 232     switch ( itemid )
 233     {
 234         case wxID_ANY:
 235             m_id = wxWindow::NewControlId();
 236             break;
 237
 238         case wxID_SEPARATOR:
 239             m_id = wxID_SEPARATOR;
 240
 241             // there is a lot of existing code just doing Append(wxID_SEPARATOR)
 242             // and it makes sense to omit the following optional parameters,
 243             // including the kind one which doesn't default to wxITEM_SEPARATOR,
 244             // of course, so override it here
 245             kind = wxITEM_SEPARATOR;
 246             break;
 247
 248         case wxID_NONE:
 249             // (popup) menu titles in wxMSW use this ID to indicate that
 250             // it's not a real menu item, so we don't want the check below to
 251             // apply to it
 252             m_id = itemid;
 253             break;
 254
 255         default:
 256             // ids are limited to 16 bits under MSW so portable code shouldn't
 257             // use ids outside of this range (negative ids generated by wx are
 258             // fine though)
 259             wxASSERT_MSG( (itemid >= 0 && itemid < SHRT_MAX) ||
 260                             (itemid >= wxID_AUTO_LOWEST && itemid <= wxID_AUTO_HIGHEST),
 261                           wxS("invalid itemid value") );
 262             m_id = itemid;
 263     }
 264
 265     // notice that parentMenu can be NULL: the item can be attached to the menu
 266     // later with SetMenu()
 267
 268     m_parentMenu  = parentMenu;
 269     m_subMenu     = subMenu;
 270     m_isEnabled   = true;
 271     m_isChecked   = false;
 272     m_kind        = kind;
 273
 274     SetItemLabel(text);
 275     SetHelp(help);
 276 }
 277
 278 wxMenuItemBase::~wxMenuItemBase()
 279 {
 280     delete m_subMenu;
 281 }
 282
 283 #if wxUSE_ACCEL
 284
 285 wxAcceleratorEntry *wxMenuItemBase::GetAccel() const
 286 {
 287     return wxAcceleratorEntry::Create(GetItemLabel());
 288 }
 289
 290 void wxMenuItemBase::SetAccel(wxAcceleratorEntry *accel)
 291 {
 292     wxString text = m_text.BeforeFirst(wxT('\t'));
 293     if ( accel )
 294     {
 295         text += wxT('\t');
 296         text += accel->ToString();
 297     }
 298
 299     SetItemLabel(text);
 300 }
 301
 302 #endif // wxUSE_ACCEL
 303
 304 void wxMenuItemBase::SetItemLabel(const wxString& str)
 305 {
 306     m_text = str;
 307
 308     if ( m_text.empty() && !IsSeparator() )
 309     {
 310         wxASSERT_MSG( wxIsStockID(GetId()),
 311                       wxT("A non-stock menu item with an empty label?") );
 312         m_text = wxGetStockLabel(GetId(), wxSTOCK_WITH_ACCELERATOR |
 313                                           wxSTOCK_WITH_MNEMONIC);
 314     }
 315 }
 316
 317 void wxMenuItemBase::SetHelp(const wxString& str)
 318 {
 319     m_help = str;
 320
 321     if ( m_help.empty() && !IsSeparator() && wxIsStockID(GetId()) )
 322     {
 323         // get a stock help string
 324         m_help = wxGetStockHelpString(GetId());
 325     }
 326 }
 327
 328 #ifndef __WXPM__
 329 wxString wxMenuItemBase::GetLabelText(const wxString& text)
 330 {
 331     return wxStripMenuCodes(text);
 332 }
 333 #endif
 334
 335 #if WXWIN_COMPATIBILITY_2_8
 336 wxString wxMenuItemBase::GetLabelFromText(const wxString& text)
 337 {
 338     return GetLabelText(text);
 339 }
 340 #endif
 341
 342 bool wxMenuBase::ms_locked = true;
 343
 344 // ----------------------------------------------------------------------------
 345 // wxMenu ctor and dtor
 346 // ----------------------------------------------------------------------------
 347
 348 void wxMenuBase::Init(long style)
 349 {
 350     m_menuBar = NULL;
 351     m_menuParent = NULL;
 352
 353     m_invokingWindow = NULL;
 354     m_style = style;
 355     m_clientData = NULL;
 356     m_eventHandler = this;
 357 }
 358
 359 wxMenuBase::~wxMenuBase()
 360 {
 361     WX_CLEAR_LIST(wxMenuItemList, m_items);
 362 }
 363
 364 // ----------------------------------------------------------------------------
 365 // wxMenu item adding/removing
 366 // ----------------------------------------------------------------------------
 367
 368 void wxMenuBase::AddSubMenu(wxMenu *submenu)
 369 {
 370     wxCHECK_RET( submenu, wxT("can't add a NULL submenu") );
 371
 372     submenu->SetParent((wxMenu *)this);
 373 }
 374
 375 wxMenuItem* wxMenuBase::DoAppend(wxMenuItem *item)
 376 {
 377     wxCHECK_MSG( item, NULL, wxT("invalid item in wxMenu::Append()") );
 378
 379     m_items.Append(item);
 380     item->SetMenu((wxMenu*)this);
 381     if ( item->IsSubMenu() )
 382     {
 383         AddSubMenu(item->GetSubMenu());
 384     }
 385
 386     return item;
 387 }
 388
 389 wxMenuItem* wxMenuBase::Insert(size_t pos, wxMenuItem *item)
 390 {
 391     wxCHECK_MSG( item, NULL, wxT("invalid item in wxMenu::Insert") );
 392
 393     if ( pos == GetMenuItemCount() )
 394     {
 395         return DoAppend(item);
 396     }
 397     else
 398     {
 399         wxCHECK_MSG( pos < GetMenuItemCount(), NULL,
 400                      wxT("invalid index in wxMenu::Insert") );
 401
 402         return DoInsert(pos, item);
 403     }
 404 }
 405
 406 wxMenuItem* wxMenuBase::DoInsert(size_t pos, wxMenuItem *item)
 407 {
 408     wxCHECK_MSG( item, NULL, wxT("invalid item in wxMenu::Insert()") );
 409
 410     wxMenuItemList::compatibility_iterator node = m_items.Item(pos);
 411     wxCHECK_MSG( node, NULL, wxT("invalid index in wxMenu::Insert()") );
 412
 413     m_items.Insert(node, item);
 414     item->SetMenu((wxMenu*)this);
 415     if ( item->IsSubMenu() )
 416     {
 417         AddSubMenu(item->GetSubMenu());
 418     }
 419
 420     return item;
 421 }
 422
 423 wxMenuItem *wxMenuBase::Remove(wxMenuItem *item)
 424 {
 425     wxCHECK_MSG( item, NULL, wxT("invalid item in wxMenu::Remove") );
 426
 427     return DoRemove(item);
 428 }
 429
 430 wxMenuItem *wxMenuBase::DoRemove(wxMenuItem *item)
 431 {
 432     wxMenuItemList::compatibility_iterator node = m_items.Find(item);
 433
 434     // if we get here, the item is valid or one of Remove() functions is broken
 435     wxCHECK_MSG( node, NULL, wxT("bug in wxMenu::Remove logic") );
 436
 437     // we detach the item, but we do delete the list node (i.e. don't call
 438     // DetachNode() here!)
 439     m_items.Erase(node);
 440
 441     // item isn't attached to anything any more
 442     item->SetMenu(NULL);
 443     wxMenu *submenu = item->GetSubMenu();
 444     if ( submenu )
 445     {
 446         submenu->SetParent(NULL);
 447         if ( submenu->IsAttached() )
 448             submenu->Detach();
 449     }
 450
 451     return item;
 452 }
 453
 454 bool wxMenuBase::Delete(wxMenuItem *item)
 455 {
 456     wxCHECK_MSG( item, false, wxT("invalid item in wxMenu::Delete") );
 457
 458     return DoDelete(item);
 459 }
 460
 461 bool wxMenuBase::DoDelete(wxMenuItem *item)
 462 {
 463     wxMenuItem *item2 = DoRemove(item);
 464     wxCHECK_MSG( item2, false, wxT("failed to delete menu item") );
 465
 466     // don't delete the submenu
 467     item2->SetSubMenu(NULL);
 468
 469     delete item2;
 470
 471     return true;
 472 }
 473
 474 bool wxMenuBase::Destroy(wxMenuItem *item)
 475 {
 476     wxCHECK_MSG( item, false, wxT("invalid item in wxMenu::Destroy") );
 477
 478     return DoDestroy(item);
 479 }
 480
 481 bool wxMenuBase::DoDestroy(wxMenuItem *item)
 482 {
 483     wxMenuItem *item2 = DoRemove(item);
 484     wxCHECK_MSG( item2, false, wxT("failed to delete menu item") );
 485
 486     delete item2;
 487
 488     return true;
 489 }
 490
 491 // ----------------------------------------------------------------------------
 492 // wxMenu searching for items
 493 // ----------------------------------------------------------------------------
 494
 495 // Finds the item id matching the given string, wxNOT_FOUND if not found.
 496 int wxMenuBase::FindItem(const wxString& text) const
 497 {
 498     wxString label = wxMenuItem::GetLabelText(text);
 499     for ( wxMenuItemList::compatibility_iterator node = m_items.GetFirst();
 500           node;
 501           node = node->GetNext() )
 502     {
 503         wxMenuItem *item = node->GetData();
 504         if ( item->IsSubMenu() )
 505         {
 506             int rc = item->GetSubMenu()->FindItem(label);
 507             if ( rc != wxNOT_FOUND )
 508                 return rc;
 509         }
 510
 511         // we execute this code for submenus as well to alllow finding them by
 512         // name just like the ordinary items
 513         if ( !item->IsSeparator() )
 514         {
 515             if ( item->GetItemLabelText() == label )
 516                 return item->GetId();
 517         }
 518     }
 519
 520     return wxNOT_FOUND;
 521 }
 522
 523 // recursive search for item by id
 524 wxMenuItem *wxMenuBase::FindItem(int itemId, wxMenu **itemMenu) const
 525 {
 526     if ( itemMenu )
 527         *itemMenu = NULL;
 528
 529     wxMenuItem *item = NULL;
 530     for ( wxMenuItemList::compatibility_iterator node = m_items.GetFirst();
 531           node && !item;
 532           node = node->GetNext() )
 533     {
 534         item = node->GetData();
 535
 536         if ( item->GetId() == itemId )
 537         {
 538             if ( itemMenu )
 539                 *itemMenu = (wxMenu *)this;
 540         }
 541         else if ( item->IsSubMenu() )
 542         {
 543             item = item->GetSubMenu()->FindItem(itemId, itemMenu);
 544         }
 545         else
 546         {
 547             // don't exit the loop
 548             item = NULL;
 549         }
 550     }
 551
 552     return item;
 553 }
 554
 555 // non recursive search
 556 wxMenuItem *wxMenuBase::FindChildItem(int itemid, size_t *ppos) const
 557 {
 558     wxMenuItem *item = NULL;
 559     wxMenuItemList::compatibility_iterator node = GetMenuItems().GetFirst();
 560
 561     size_t pos;
 562     for ( pos = 0; node; pos++ )
 563     {
 564         if ( node->GetData()->GetId() == itemid )
 565         {
 566             item = node->GetData();
 567
 568             break;
 569         }
 570
 571         node = node->GetNext();
 572     }
 573
 574     if ( ppos )
 575     {
 576         *ppos = item ? pos : (size_t)wxNOT_FOUND;
 577     }
 578
 579     return item;
 580 }
 581
 582 // find by position
 583 wxMenuItem* wxMenuBase::FindItemByPosition(size_t position) const
 584 {
 585     wxCHECK_MSG( position < m_items.GetCount(), NULL,
 586                  wxT("wxMenu::FindItemByPosition(): invalid menu index") );
 587
 588     return m_items.Item( position )->GetData();
 589 }
 590
 591 // ----------------------------------------------------------------------------
 592 // wxMenu helpers used by derived classes
 593 // ----------------------------------------------------------------------------
 594
 595 // Update a menu and all submenus recursively. source is the object that has
 596 // the update event handlers defined for it. If NULL, the menu or associated
 597 // window will be used.
 598 void wxMenuBase::UpdateUI(wxEvtHandler* source)
 599 {
 600     wxWindow * const win = GetWindow();
 601
 602     if ( !source && win )
 603         source = win->GetEventHandler();
 604     if ( !source )
 605         source = GetEventHandler();
 606     if ( !source )
 607         source = this;
 608
 609     wxMenuItemList::compatibility_iterator  node = GetMenuItems().GetFirst();
 610     while ( node )
 611     {
 612         wxMenuItem* item = node->GetData();
 613         if ( !item->IsSeparator() )
 614         {
 615             wxWindowID itemid = item->GetId();
 616             wxUpdateUIEvent event(itemid);
 617             event.SetEventObject( source );
 618
 619             if ( source->ProcessEvent(event) )
 620             {
 621                 // if anything changed, update the changed attribute
 622                 if (event.GetSetText())
 623                     SetLabel(itemid, event.GetText());
 624                 if (event.GetSetChecked())
 625                     Check(itemid, event.GetChecked());
 626                 if (event.GetSetEnabled())
 627                     Enable(itemid, event.GetEnabled());
 628             }
 629
 630             // recurse to the submenus
 631             if ( item->GetSubMenu() )
 632                 item->GetSubMenu()->UpdateUI(source);
 633         }
 634         //else: item is a separator (which doesn't process update UI events)
 635
 636         node = node->GetNext();
 637     }
 638 }
 639
 640 bool wxMenuBase::SendEvent(int itemid, int checked)
 641 {
 642     wxCommandEvent event(wxEVT_COMMAND_MENU_SELECTED, itemid);
 643     event.SetEventObject(this);
 644     event.SetInt(checked);
 645
 646     bool processed = false;
 647
 648     // Try the menu's event handler first
 649     wxEvtHandler *handler = GetEventHandler();
 650     if ( handler )
 651         processed = handler->SafelyProcessEvent(event);
 652
 653     // Try the window the menu was popped up from or its menu bar belongs to
 654     if ( !processed )
 655     {
 656         wxWindow * const win = GetWindow();
 657         if ( win )
 658             processed = win->HandleWindowEvent(event);
 659     }
 660
 661     return processed;
 662 }
 663
 664 // ----------------------------------------------------------------------------
 665 // wxMenu attaching/detaching to/from menu bar
 666 // ----------------------------------------------------------------------------
 667
 668 wxMenuBar* wxMenuBase::GetMenuBar() const
 669 {
 670     if(GetParent())
 671         return GetParent()->GetMenuBar();
 672     return m_menuBar;
 673 }
 674
 675 void wxMenuBase::Attach(wxMenuBarBase *menubar)
 676 {
 677     // use Detach() instead!
 678     wxASSERT_MSG( menubar, wxT("menu can't be attached to NULL menubar") );
 679
 680     // use IsAttached() to prevent this from happening
 681     wxASSERT_MSG( !m_menuBar, wxT("attaching menu twice?") );
 682
 683     m_menuBar = (wxMenuBar *)menubar;
 684 }
 685
 686 void wxMenuBase::Detach()
 687 {
 688     // use IsAttached() to prevent this from happening
 689     wxASSERT_MSG( m_menuBar, wxT("detaching unattached menu?") );
 690
 691     m_menuBar = NULL;
 692 }
 693
 694 // ----------------------------------------------------------------------------
 695 // wxMenu invoking window handling
 696 // ----------------------------------------------------------------------------
 697
 698 void wxMenuBase::SetInvokingWindow(wxWindow *win)
 699 {
 700     wxASSERT_MSG( !GetParent(),
 701                     "should only be called for top level popup menus" );
 702     wxASSERT_MSG( !IsAttached(),
 703                     "menus attached to menu bar can't have invoking window" );
 704
 705     m_invokingWindow = win;
 706 }
 707
 708 wxWindow *wxMenuBase::GetWindow() const
 709 {
 710     // only the top level menus have non-NULL invoking window or a pointer to
 711     // the menu bar so recurse upwards until we find it
 712     const wxMenuBase *menu = this;
 713     while ( menu->GetParent() )
 714     {
 715         menu = menu->GetParent();
 716     }
 717
 718     return menu->GetMenuBar() ? menu->GetMenuBar()->GetFrame()
 719                               : menu->GetInvokingWindow();
 720 }
 721
 722 // ----------------------------------------------------------------------------
 723 // wxMenu functions forwarded to wxMenuItem
 724 // ----------------------------------------------------------------------------
 725
 726 void wxMenuBase::Enable( int itemid, bool enable )
 727 {
 728     wxMenuItem *item = FindItem(itemid);
 729
 730     wxCHECK_RET( item, wxT("wxMenu::Enable: no such item") );
 731
 732     item->Enable(enable);
 733 }
 734
 735 bool wxMenuBase::IsEnabled( int itemid ) const
 736 {
 737     wxMenuItem *item = FindItem(itemid);
 738
 739     wxCHECK_MSG( item, false, wxT("wxMenu::IsEnabled: no such item") );
 740
 741     return item->IsEnabled();
 742 }
 743
 744 void wxMenuBase::Check( int itemid, bool enable )
 745 {
 746     wxMenuItem *item = FindItem(itemid);
 747
 748     wxCHECK_RET( item, wxT("wxMenu::Check: no such item") );
 749
 750     item->Check(enable);
 751 }
 752
 753 bool wxMenuBase::IsChecked( int itemid ) const
 754 {
 755     wxMenuItem *item = FindItem(itemid);
 756
 757     wxCHECK_MSG( item, false, wxT("wxMenu::IsChecked: no such item") );
 758
 759     return item->IsChecked();
 760 }
 761
 762 void wxMenuBase::SetLabel( int itemid, const wxString &label )
 763 {
 764     wxMenuItem *item = FindItem(itemid);
 765
 766     wxCHECK_RET( item, wxT("wxMenu::SetLabel: no such item") );
 767
 768     item->SetItemLabel(label);
 769 }
 770
 771 wxString wxMenuBase::GetLabel( int itemid ) const
 772 {
 773     wxMenuItem *item = FindItem(itemid);
 774
 775     wxCHECK_MSG( item, wxEmptyString, wxT("wxMenu::GetLabel: no such item") );
 776
 777     return item->GetItemLabel();
 778 }
 779
 780 void wxMenuBase::SetHelpString( int itemid, const wxString& helpString )
 781 {
 782     wxMenuItem *item = FindItem(itemid);
 783
 784     wxCHECK_RET( item, wxT("wxMenu::SetHelpString: no such item") );
 785
 786     item->SetHelp( helpString );
 787 }
 788
 789 wxString wxMenuBase::GetHelpString( int itemid ) const
 790 {
 791     wxMenuItem *item = FindItem(itemid);
 792
 793     wxCHECK_MSG( item, wxEmptyString, wxT("wxMenu::GetHelpString: no such item") );
 794
 795     return item->GetHelp();
 796 }
 797
 798 // ----------------------------------------------------------------------------
 799 // wxMenuBarBase ctor and dtor
 800 // ----------------------------------------------------------------------------
 801
 802 wxMenuBarBase::wxMenuBarBase()
 803 {
 804     // not attached yet
 805     m_menuBarFrame = NULL;
 806 }
 807
 808 wxMenuBarBase::~wxMenuBarBase()
 809 {
 810     WX_CLEAR_LIST(wxMenuList, m_menus);
 811 }
 812
 813 // ----------------------------------------------------------------------------
 814 // wxMenuBar item access: the base class versions manage m_menus list, the
 815 // derived class should reflect the changes in the real menubar
 816 // ----------------------------------------------------------------------------
 817
 818 wxMenu *wxMenuBarBase::GetMenu(size_t pos) const
 819 {
 820     wxMenuList::compatibility_iterator node = m_menus.Item(pos);
 821     wxCHECK_MSG( node, NULL, wxT("bad index in wxMenuBar::GetMenu()") );
 822
 823     return node->GetData();
 824 }
 825
 826 bool wxMenuBarBase::Append(wxMenu *menu, const wxString& title)
 827 {
 828     wxCHECK_MSG( menu, false, wxT("can't append NULL menu") );
 829     wxCHECK_MSG( !title.empty(), false, wxT("can't append menu with empty title") );
 830
 831     m_menus.Append(menu);
 832     menu->Attach(this);
 833
 834     return true;
 835 }
 836
 837 bool wxMenuBarBase::Insert(size_t pos, wxMenu *menu,
 838                            const wxString& title)
 839 {
 840     if ( pos == m_menus.GetCount() )
 841     {
 842         return wxMenuBarBase::Append(menu, title);
 843     }
 844     else // not at the end
 845     {
 846         wxCHECK_MSG( menu, false, wxT("can't insert NULL menu") );
 847
 848         wxMenuList::compatibility_iterator node = m_menus.Item(pos);
 849         wxCHECK_MSG( node, false, wxT("bad index in wxMenuBar::Insert()") );
 850
 851         m_menus.Insert(node, menu);
 852         menu->Attach(this);
 853
 854         return true;
 855     }
 856 }
 857
 858 wxMenu *wxMenuBarBase::Replace(size_t pos, wxMenu *menu,
 859                                const wxString& WXUNUSED(title))
 860 {
 861     wxCHECK_MSG( menu, NULL, wxT("can't insert NULL menu") );
 862
 863     wxMenuList::compatibility_iterator node = m_menus.Item(pos);
 864     wxCHECK_MSG( node, NULL, wxT("bad index in wxMenuBar::Replace()") );
 865
 866     wxMenu *menuOld = node->GetData();
 867     node->SetData(menu);
 868
 869     menu->Attach(this);
 870     menuOld->Detach();
 871
 872     return menuOld;
 873 }
 874
 875 wxMenu *wxMenuBarBase::Remove(size_t pos)
 876 {
 877     wxMenuList::compatibility_iterator node = m_menus.Item(pos);
 878     wxCHECK_MSG( node, NULL, wxT("bad index in wxMenuBar::Remove()") );
 879
 880     wxMenu *menu = node->GetData();
 881     m_menus.Erase(node);
 882     menu->Detach();
 883
 884     return menu;
 885 }
 886
 887 int wxMenuBarBase::FindMenu(const wxString& title) const
 888 {
 889     wxString label = wxMenuItem::GetLabelText(title);
 890
 891     size_t count = GetMenuCount();
 892     for ( size_t i = 0; i < count; i++ )
 893     {
 894         wxString title2 = GetMenuLabel(i);
 895         if ( (title2 == title) ||
 896              (wxMenuItem::GetLabelText(title2) == label) )
 897         {
 898             // found
 899             return (int)i;
 900         }
 901     }
 902
 903     return wxNOT_FOUND;
 904
 905 }
 906
 907 // ----------------------------------------------------------------------------
 908 // wxMenuBar attaching/detaching to/from the frame
 909 // ----------------------------------------------------------------------------
 910
 911 void wxMenuBarBase::Attach(wxFrame *frame)
 912 {
 913     wxASSERT_MSG( !IsAttached(), wxT("menubar already attached!") );
 914
 915     m_menuBarFrame = frame;
 916 }
 917
 918 void wxMenuBarBase::Detach()
 919 {
 920     wxASSERT_MSG( IsAttached(), wxT("detaching unattached menubar") );
 921
 922     m_menuBarFrame = NULL;
 923 }
 924
 925 // ----------------------------------------------------------------------------
 926 // wxMenuBar searching for items
 927 // ----------------------------------------------------------------------------
 928
 929 wxMenuItem *wxMenuBarBase::FindItem(int itemid, wxMenu **menu) const
 930 {
 931     if ( menu )
 932         *menu = NULL;
 933
 934     wxMenuItem *item = NULL;
 935     size_t count = GetMenuCount(), i;
 936     wxMenuList::const_iterator it;
 937     for ( i = 0, it = m_menus.begin(); !item && (i < count); i++, it++ )
 938     {
 939         item = (*it)->FindItem(itemid, menu);
 940     }
 941
 942     return item;
 943 }
 944
 945 int wxMenuBarBase::FindMenuItem(const wxString& menu, const wxString& item) const
 946 {
 947     wxString label = wxMenuItem::GetLabelText(menu);
 948
 949     int i = 0;
 950     wxMenuList::compatibility_iterator node;
 951     for ( node = m_menus.GetFirst(); node; node = node->GetNext(), i++ )
 952     {
 953         if ( label == wxMenuItem::GetLabelText(GetMenuLabel(i)) )
 954             return node->GetData()->FindItem(item);
 955     }
 956
 957     return wxNOT_FOUND;
 958 }
 959
 960 // ---------------------------------------------------------------------------
 961 // wxMenuBar functions forwarded to wxMenuItem
 962 // ---------------------------------------------------------------------------
 963
 964 void wxMenuBarBase::Enable(int itemid, bool enable)
 965 {
 966     wxMenuItem *item = FindItem(itemid);
 967
 968     wxCHECK_RET( item, wxT("attempt to enable an item which doesn't exist") );
 969
 970     item->Enable(enable);
 971 }
 972
 973 void wxMenuBarBase::Check(int itemid, bool check)
 974 {
 975     wxMenuItem *item = FindItem(itemid);
 976
 977     wxCHECK_RET( item, wxT("attempt to check an item which doesn't exist") );
 978     wxCHECK_RET( item->IsCheckable(), wxT("attempt to check an uncheckable item") );
 979
 980     item->Check(check);
 981 }
 982
 983 bool wxMenuBarBase::IsChecked(int itemid) const
 984 {
 985     wxMenuItem *item = FindItem(itemid);
 986
 987     wxCHECK_MSG( item, false, wxT("wxMenuBar::IsChecked(): no such item") );
 988
 989     return item->IsChecked();
 990 }
 991
 992 bool wxMenuBarBase::IsEnabled(int itemid) const
 993 {
 994     wxMenuItem *item = FindItem(itemid);
 995
 996     wxCHECK_MSG( item, false, wxT("wxMenuBar::IsEnabled(): no such item") );
 997
 998     return item->IsEnabled();
 999 }
1000
1001 void wxMenuBarBase::SetLabel(int itemid, const wxString& label)
1002 {
1003     wxMenuItem *item = FindItem(itemid);
1004
1005     wxCHECK_RET( item, wxT("wxMenuBar::SetLabel(): no such item") );
1006
1007     item->SetItemLabel(label);
1008 }
1009
1010 wxString wxMenuBarBase::GetLabel(int itemid) const
1011 {
1012     wxMenuItem *item = FindItem(itemid);
1013
1014     wxCHECK_MSG( item, wxEmptyString,
1015                  wxT("wxMenuBar::GetLabel(): no such item") );
1016
1017     return item->GetItemLabel();
1018 }
1019
1020 void wxMenuBarBase::SetHelpString(int itemid, const wxString& helpString)
1021 {
1022     wxMenuItem *item = FindItem(itemid);
1023
1024     wxCHECK_RET( item, wxT("wxMenuBar::SetHelpString(): no such item") );
1025
1026     item->SetHelp(helpString);
1027 }
1028
1029 wxString wxMenuBarBase::GetHelpString(int itemid) const
1030 {
1031     wxMenuItem *item = FindItem(itemid);
1032
1033     wxCHECK_MSG( item, wxEmptyString,
1034                  wxT("wxMenuBar::GetHelpString(): no such item") );
1035
1036     return item->GetHelp();
1037 }
1038
1039 void wxMenuBarBase::UpdateMenus()
1040 {
1041     wxMenu* menu;
1042     int nCount = GetMenuCount();
1043     for (int n = 0; n < nCount; n++)
1044     {
1045         menu = GetMenu( n );
1046         if (menu != NULL)
1047             menu->UpdateUI( NULL );
1048     }
1049 }
1050
1051 #if WXWIN_COMPATIBILITY_2_8
1052 // get or change the label of the menu at given position
1053 void wxMenuBarBase::SetLabelTop(size_t pos, const wxString& label)
1054 {
1055     SetMenuLabel(pos, label);
1056 }
1057
1058 wxString wxMenuBarBase::GetLabelTop(size_t pos) const
1059 {
1060     return GetMenuLabelText(pos);
1061 }
1062 #endif
1063
1064 #endif // wxUSE_MENUS