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     if ( win )
 602     {
 603         // Don't update menus if the parent
 604         // frame is about to get deleted
 605         wxWindow *tlw = wxGetTopLevelParent(win);
 606         if (tlw && wxPendingDelete.Member(tlw))
 607             return;
 608     }
 609
 610     if ( !source && win )
 611         source = win->GetEventHandler();
 612     if ( !source )
 613         source = GetEventHandler();
 614     if ( !source )
 615         source = this;
 616
 617     wxMenuItemList::compatibility_iterator  node = GetMenuItems().GetFirst();
 618     while ( node )
 619     {
 620         wxMenuItem* item = node->GetData();
 621         if ( !item->IsSeparator() )
 622         {
 623             wxWindowID itemid = item->GetId();
 624             wxUpdateUIEvent event(itemid);
 625             event.SetEventObject( source );
 626
 627             if ( source->ProcessEvent(event) )
 628             {
 629                 // if anything changed, update the changed attribute
 630                 if (event.GetSetText())
 631                     SetLabel(itemid, event.GetText());
 632                 if (event.GetSetChecked())
 633                     Check(itemid, event.GetChecked());
 634                 if (event.GetSetEnabled())
 635                     Enable(itemid, event.GetEnabled());
 636             }
 637
 638             // recurse to the submenus
 639             if ( item->GetSubMenu() )
 640                 item->GetSubMenu()->UpdateUI(source);
 641         }
 642         //else: item is a separator (which doesn't process update UI events)
 643
 644         node = node->GetNext();
 645     }
 646 }
 647
 648 bool wxMenuBase::SendEvent(int itemid, int checked)
 649 {
 650     wxCommandEvent event(wxEVT_COMMAND_MENU_SELECTED, itemid);
 651     event.SetEventObject(this);
 652     event.SetInt(checked);
 653
 654     bool processed = false;
 655
 656     // Try the menu's event handler first
 657     wxEvtHandler *handler = GetEventHandler();
 658     if ( handler )
 659         processed = handler->SafelyProcessEvent(event);
 660
 661     // Try the window the menu was popped up from or its menu bar belongs to
 662     if ( !processed )
 663     {
 664         wxWindow * const win = GetWindow();
 665         if ( win )
 666             processed = win->HandleWindowEvent(event);
 667     }
 668
 669     return processed;
 670 }
 671
 672 // ----------------------------------------------------------------------------
 673 // wxMenu attaching/detaching to/from menu bar
 674 // ----------------------------------------------------------------------------
 675
 676 wxMenuBar* wxMenuBase::GetMenuBar() const
 677 {
 678     if(GetParent())
 679         return GetParent()->GetMenuBar();
 680     return m_menuBar;
 681 }
 682
 683 void wxMenuBase::Attach(wxMenuBarBase *menubar)
 684 {
 685     // use Detach() instead!
 686     wxASSERT_MSG( menubar, wxT("menu can't be attached to NULL menubar") );
 687
 688     // use IsAttached() to prevent this from happening
 689     wxASSERT_MSG( !m_menuBar, wxT("attaching menu twice?") );
 690
 691     m_menuBar = (wxMenuBar *)menubar;
 692 }
 693
 694 void wxMenuBase::Detach()
 695 {
 696     // use IsAttached() to prevent this from happening
 697     wxASSERT_MSG( m_menuBar, wxT("detaching unattached menu?") );
 698
 699     m_menuBar = NULL;
 700 }
 701
 702 // ----------------------------------------------------------------------------
 703 // wxMenu invoking window handling
 704 // ----------------------------------------------------------------------------
 705
 706 void wxMenuBase::SetInvokingWindow(wxWindow *win)
 707 {
 708     wxASSERT_MSG( !GetParent(),
 709                     "should only be called for top level popup menus" );
 710     wxASSERT_MSG( !IsAttached(),
 711                     "menus attached to menu bar can't have invoking window" );
 712
 713     m_invokingWindow = win;
 714 }
 715
 716 wxWindow *wxMenuBase::GetWindow() const
 717 {
 718     // only the top level menus have non-NULL invoking window or a pointer to
 719     // the menu bar so recurse upwards until we find it
 720     const wxMenuBase *menu = this;
 721     while ( menu->GetParent() )
 722     {
 723         menu = menu->GetParent();
 724     }
 725
 726     return menu->GetMenuBar() ? menu->GetMenuBar()->GetFrame()
 727                               : menu->GetInvokingWindow();
 728 }
 729
 730 // ----------------------------------------------------------------------------
 731 // wxMenu functions forwarded to wxMenuItem
 732 // ----------------------------------------------------------------------------
 733
 734 void wxMenuBase::Enable( int itemid, bool enable )
 735 {
 736     wxMenuItem *item = FindItem(itemid);
 737
 738     wxCHECK_RET( item, wxT("wxMenu::Enable: no such item") );
 739
 740     item->Enable(enable);
 741 }
 742
 743 bool wxMenuBase::IsEnabled( int itemid ) const
 744 {
 745     wxMenuItem *item = FindItem(itemid);
 746
 747     wxCHECK_MSG( item, false, wxT("wxMenu::IsEnabled: no such item") );
 748
 749     return item->IsEnabled();
 750 }
 751
 752 void wxMenuBase::Check( int itemid, bool enable )
 753 {
 754     wxMenuItem *item = FindItem(itemid);
 755
 756     wxCHECK_RET( item, wxT("wxMenu::Check: no such item") );
 757
 758     item->Check(enable);
 759 }
 760
 761 bool wxMenuBase::IsChecked( int itemid ) const
 762 {
 763     wxMenuItem *item = FindItem(itemid);
 764
 765     wxCHECK_MSG( item, false, wxT("wxMenu::IsChecked: no such item") );
 766
 767     return item->IsChecked();
 768 }
 769
 770 void wxMenuBase::SetLabel( int itemid, const wxString &label )
 771 {
 772     wxMenuItem *item = FindItem(itemid);
 773
 774     wxCHECK_RET( item, wxT("wxMenu::SetLabel: no such item") );
 775
 776     item->SetItemLabel(label);
 777 }
 778
 779 wxString wxMenuBase::GetLabel( int itemid ) const
 780 {
 781     wxMenuItem *item = FindItem(itemid);
 782
 783     wxCHECK_MSG( item, wxEmptyString, wxT("wxMenu::GetLabel: no such item") );
 784
 785     return item->GetItemLabel();
 786 }
 787
 788 void wxMenuBase::SetHelpString( int itemid, const wxString& helpString )
 789 {
 790     wxMenuItem *item = FindItem(itemid);
 791
 792     wxCHECK_RET( item, wxT("wxMenu::SetHelpString: no such item") );
 793
 794     item->SetHelp( helpString );
 795 }
 796
 797 wxString wxMenuBase::GetHelpString( int itemid ) const
 798 {
 799     wxMenuItem *item = FindItem(itemid);
 800
 801     wxCHECK_MSG( item, wxEmptyString, wxT("wxMenu::GetHelpString: no such item") );
 802
 803     return item->GetHelp();
 804 }
 805
 806 // ----------------------------------------------------------------------------
 807 // wxMenuBarBase ctor and dtor
 808 // ----------------------------------------------------------------------------
 809
 810 wxMenuBarBase::wxMenuBarBase()
 811 {
 812     // not attached yet
 813     m_menuBarFrame = NULL;
 814 }
 815
 816 wxMenuBarBase::~wxMenuBarBase()
 817 {
 818     WX_CLEAR_LIST(wxMenuList, m_menus);
 819 }
 820
 821 // ----------------------------------------------------------------------------
 822 // wxMenuBar item access: the base class versions manage m_menus list, the
 823 // derived class should reflect the changes in the real menubar
 824 // ----------------------------------------------------------------------------
 825
 826 wxMenu *wxMenuBarBase::GetMenu(size_t pos) const
 827 {
 828     wxMenuList::compatibility_iterator node = m_menus.Item(pos);
 829     wxCHECK_MSG( node, NULL, wxT("bad index in wxMenuBar::GetMenu()") );
 830
 831     return node->GetData();
 832 }
 833
 834 bool wxMenuBarBase::Append(wxMenu *menu, const wxString& title)
 835 {
 836     wxCHECK_MSG( menu, false, wxT("can't append NULL menu") );
 837     wxCHECK_MSG( !title.empty(), false, wxT("can't append menu with empty title") );
 838
 839     m_menus.Append(menu);
 840     menu->Attach(this);
 841
 842     return true;
 843 }
 844
 845 bool wxMenuBarBase::Insert(size_t pos, wxMenu *menu,
 846                            const wxString& title)
 847 {
 848     if ( pos == m_menus.GetCount() )
 849     {
 850         return wxMenuBarBase::Append(menu, title);
 851     }
 852     else // not at the end
 853     {
 854         wxCHECK_MSG( menu, false, wxT("can't insert NULL menu") );
 855
 856         wxMenuList::compatibility_iterator node = m_menus.Item(pos);
 857         wxCHECK_MSG( node, false, wxT("bad index in wxMenuBar::Insert()") );
 858
 859         m_menus.Insert(node, menu);
 860         menu->Attach(this);
 861
 862         return true;
 863     }
 864 }
 865
 866 wxMenu *wxMenuBarBase::Replace(size_t pos, wxMenu *menu,
 867                                const wxString& WXUNUSED(title))
 868 {
 869     wxCHECK_MSG( menu, NULL, wxT("can't insert NULL menu") );
 870
 871     wxMenuList::compatibility_iterator node = m_menus.Item(pos);
 872     wxCHECK_MSG( node, NULL, wxT("bad index in wxMenuBar::Replace()") );
 873
 874     wxMenu *menuOld = node->GetData();
 875     node->SetData(menu);
 876
 877     menu->Attach(this);
 878     menuOld->Detach();
 879
 880     return menuOld;
 881 }
 882
 883 wxMenu *wxMenuBarBase::Remove(size_t pos)
 884 {
 885     wxMenuList::compatibility_iterator node = m_menus.Item(pos);
 886     wxCHECK_MSG( node, NULL, wxT("bad index in wxMenuBar::Remove()") );
 887
 888     wxMenu *menu = node->GetData();
 889     m_menus.Erase(node);
 890     menu->Detach();
 891
 892     return menu;
 893 }
 894
 895 int wxMenuBarBase::FindMenu(const wxString& title) const
 896 {
 897     wxString label = wxMenuItem::GetLabelText(title);
 898
 899     size_t count = GetMenuCount();
 900     for ( size_t i = 0; i < count; i++ )
 901     {
 902         wxString title2 = GetMenuLabel(i);
 903         if ( (title2 == title) ||
 904              (wxMenuItem::GetLabelText(title2) == label) )
 905         {
 906             // found
 907             return (int)i;
 908         }
 909     }
 910
 911     return wxNOT_FOUND;
 912
 913 }
 914
 915 // ----------------------------------------------------------------------------
 916 // wxMenuBar attaching/detaching to/from the frame
 917 // ----------------------------------------------------------------------------
 918
 919 void wxMenuBarBase::Attach(wxFrame *frame)
 920 {
 921     wxASSERT_MSG( !IsAttached(), wxT("menubar already attached!") );
 922
 923     m_menuBarFrame = frame;
 924 }
 925
 926 void wxMenuBarBase::Detach()
 927 {
 928     wxASSERT_MSG( IsAttached(), wxT("detaching unattached menubar") );
 929
 930     m_menuBarFrame = NULL;
 931 }
 932
 933 // ----------------------------------------------------------------------------
 934 // wxMenuBar searching for items
 935 // ----------------------------------------------------------------------------
 936
 937 wxMenuItem *wxMenuBarBase::FindItem(int itemid, wxMenu **menu) const
 938 {
 939     if ( menu )
 940         *menu = NULL;
 941
 942     wxMenuItem *item = NULL;
 943     size_t count = GetMenuCount(), i;
 944     wxMenuList::const_iterator it;
 945     for ( i = 0, it = m_menus.begin(); !item && (i < count); i++, it++ )
 946     {
 947         item = (*it)->FindItem(itemid, menu);
 948     }
 949
 950     return item;
 951 }
 952
 953 int wxMenuBarBase::FindMenuItem(const wxString& menu, const wxString& item) const
 954 {
 955     wxString label = wxMenuItem::GetLabelText(menu);
 956
 957     int i = 0;
 958     wxMenuList::compatibility_iterator node;
 959     for ( node = m_menus.GetFirst(); node; node = node->GetNext(), i++ )
 960     {
 961         if ( label == wxMenuItem::GetLabelText(GetMenuLabel(i)) )
 962             return node->GetData()->FindItem(item);
 963     }
 964
 965     return wxNOT_FOUND;
 966 }
 967
 968 // ---------------------------------------------------------------------------
 969 // wxMenuBar functions forwarded to wxMenuItem
 970 // ---------------------------------------------------------------------------
 971
 972 void wxMenuBarBase::Enable(int itemid, bool enable)
 973 {
 974     wxMenuItem *item = FindItem(itemid);
 975
 976     wxCHECK_RET( item, wxT("attempt to enable an item which doesn't exist") );
 977
 978     item->Enable(enable);
 979 }
 980
 981 void wxMenuBarBase::Check(int itemid, bool check)
 982 {
 983     wxMenuItem *item = FindItem(itemid);
 984
 985     wxCHECK_RET( item, wxT("attempt to check an item which doesn't exist") );
 986     wxCHECK_RET( item->IsCheckable(), wxT("attempt to check an uncheckable item") );
 987
 988     item->Check(check);
 989 }
 990
 991 bool wxMenuBarBase::IsChecked(int itemid) const
 992 {
 993     wxMenuItem *item = FindItem(itemid);
 994
 995     wxCHECK_MSG( item, false, wxT("wxMenuBar::IsChecked(): no such item") );
 996
 997     return item->IsChecked();
 998 }
 999
1000 bool wxMenuBarBase::IsEnabled(int itemid) const
1001 {
1002     wxMenuItem *item = FindItem(itemid);
1003
1004     wxCHECK_MSG( item, false, wxT("wxMenuBar::IsEnabled(): no such item") );
1005
1006     return item->IsEnabled();
1007 }
1008
1009 void wxMenuBarBase::SetLabel(int itemid, const wxString& label)
1010 {
1011     wxMenuItem *item = FindItem(itemid);
1012
1013     wxCHECK_RET( item, wxT("wxMenuBar::SetLabel(): no such item") );
1014
1015     item->SetItemLabel(label);
1016 }
1017
1018 wxString wxMenuBarBase::GetLabel(int itemid) const
1019 {
1020     wxMenuItem *item = FindItem(itemid);
1021
1022     wxCHECK_MSG( item, wxEmptyString,
1023                  wxT("wxMenuBar::GetLabel(): no such item") );
1024
1025     return item->GetItemLabel();
1026 }
1027
1028 void wxMenuBarBase::SetHelpString(int itemid, const wxString& helpString)
1029 {
1030     wxMenuItem *item = FindItem(itemid);
1031
1032     wxCHECK_RET( item, wxT("wxMenuBar::SetHelpString(): no such item") );
1033
1034     item->SetHelp(helpString);
1035 }
1036
1037 wxString wxMenuBarBase::GetHelpString(int itemid) const
1038 {
1039     wxMenuItem *item = FindItem(itemid);
1040
1041     wxCHECK_MSG( item, wxEmptyString,
1042                  wxT("wxMenuBar::GetHelpString(): no such item") );
1043
1044     return item->GetHelp();
1045 }
1046
1047 void wxMenuBarBase::UpdateMenus()
1048 {
1049     wxEvtHandler* source;
1050     wxMenu* menu;
1051     int nCount = GetMenuCount();
1052     for (int n = 0; n < nCount; n++)
1053     {
1054         menu = GetMenu( n );
1055         if (menu != NULL)
1056         {
1057             source = menu->GetEventHandler();
1058             if (source != NULL)
1059                 menu->UpdateUI( source );
1060         }
1061     }
1062 }
1063
1064 #if WXWIN_COMPATIBILITY_2_8
1065 // get or change the label of the menu at given position
1066 void wxMenuBarBase::SetLabelTop(size_t pos, const wxString& label)
1067 {
1068     SetMenuLabel(pos, label);
1069 }
1070
1071 wxString wxMenuBarBase::GetLabelTop(size_t pos) const
1072 {
1073     return GetMenuLabelText(pos);
1074 }
1075 #endif
1076
1077 #endif // wxUSE_MENUS