+//+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
+//
+// wxDockTaskBarIcon
+//
+// OS X DOCK implementation of wxTaskBarIcon using carbon
+//+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
+
+//%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+// wxDockEventHandler
+//
+// This is the global mac/carbon event handler for the dock.
+// We need this for two reasons:
+// 1) To handle wxTaskBarIcon menu events (see below for why)
+// 2) To handle events from the dock when it requests a menu
+//%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+pascal OSStatus wxDockEventHandler( EventHandlerCallRef inHandlerCallRef,
+ EventRef inEvent, void* pData)
+{
+ // Get the parameters we want from the event
+ wxDockTaskBarIcon* pTB = (wxDockTaskBarIcon*) pData;
+ const UInt32 eventClass = GetEventClass(inEvent);
+ const UInt32 eventKind = GetEventKind(inEvent);
+
+ // Handle wxTaskBar menu events (note that this is a global event handler
+ // so it will actually get called by all commands/menus)
+ //
+ if ((eventClass == kEventClassCommand) && (eventKind == kEventCommandProcess))
+ {
+ // if we have no taskbar menu quickly pass it back to wxApp
+ if (pTB->m_pMenu == NULL)
+ return eventNotHandledErr;
+
+ //
+ // This is the real reason why we need this. Normally menus
+ // get handled in wxMacAppEventHandler
+ //
+ // pascal OSStatus wxMacAppEventHandler(EventHandlerCallRef handler,
+ // EventRef event, void *data)
+ //
+ // However, in the case of a taskbar menu call
+ // command.menu.menuRef IS NULL!
+ // Which causes the wxApp handler just to skip it.
+ //
+ MenuRef taskbarMenuRef = MAC_WXHMENU(pTB->m_pMenu->GetHMenu());
+ OSErr err;
+
+ // get the HICommand from the event
+ HICommand command;
+ err = GetEventParameter(inEvent, kEventParamDirectObject,
+ typeHICommand, NULL,
+ sizeof(HICommand), NULL, &command);
+ if (err == noErr)
+ {
+ // Obtain the REAL menuRef and the menuItemIndex in the real menuRef
+ //
+ // NOTE: menuRef is generally used here for submenus, as
+ // GetMenuItemRefCon could give an incorrect wxMenuItem if we pass
+ // just the top level wxTaskBar menu
+ //
+ MenuItemIndex menuItemIndex;
+ MenuRef menuRef;
+
+ err = GetIndMenuItemWithCommandID(taskbarMenuRef,
+ command.commandID,
+ 1, &menuRef, &menuItemIndex);
+ if (err == noErr)
+ {
+ MenuCommand id = command.commandID;
+ wxMenuItem* item = NULL;
+
+ if (id != 0) // get the wxMenuItem reference from the MenuRef
+ GetMenuItemRefCon(menuRef, menuItemIndex, (UInt32*) &item);
+
+ if (item)
+ {
+ // Handle items that are checkable
+ // FIXME: Doesn't work (at least on 10.2)!
+ if (item->IsCheckable())
+ item->Check( !item->IsChecked() ) ;
+
+ // send the wxEvent to the wxMenu
+ item->GetMenu()->SendEvent(id,
+ item->IsCheckable() ?
+ item->IsChecked() : -1
+ );
+ err = noErr; // successfully handled the event
+ }
+ }
+ } //end if noErr on getting HICommand from event
+
+ // return whether we handled the event or not
+ return err;
+ }
+
+ // We better have a kEventClassApplication/kEventAppGetDockTileMenu combo here,
+ // otherwise something is truly funky
+ wxASSERT(eventClass == kEventClassApplication &&
+ eventKind == kEventAppGetDockTileMenu);
+
+ // process the right click events
+ // NB: This may result in double or even triple-creation of the menus
+ // We need to do this for 2.4 compat, however
+ wxTaskBarIconEvent downevt(wxEVT_TASKBAR_RIGHT_DOWN,NULL);
+ pTB->m_parent->ProcessEvent(downevt);
+
+ wxTaskBarIconEvent upevt(wxEVT_TASKBAR_RIGHT_UP,NULL);
+ pTB->m_parent->ProcessEvent(upevt);
+
+ // create popup menu
+ wxMenu* menu = pTB->DoCreatePopupMenu();
+
+ OSStatus err = eventNotHandledErr;
+
+ if (menu != NULL)
+ {
+ // note to self - a MenuRef *is* a MenuHandle
+ MenuRef hMenu = MAC_WXHMENU(menu->GetHMenu());
+
+ // When SetEventParameter is called it will decrement
+ // the reference count of the menu - we need to make
+ // sure it stays around in the wxMenu class here
+ RetainMenu(hMenu);
+
+ // set the actual dock menu
+ err = SetEventParameter(inEvent, kEventParamMenuRef,
+ typeMenuRef, sizeof(MenuRef), &hMenu);
+ wxASSERT(err == noErr);
+ }
+
+ return err;
+}
+
+//%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+// wxDeepCopyMenu
+//
+// Performs a top-to-bottom copy of the input menu and all of its
+// submenus.
+//
+// This is mostly needed for 2.4 compatability. However wxPython and others
+// still use this way of setting the taskbarmenu.
+//%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+wxMenu* wxDeepCopyMenu(wxMenu* menu)