summaryrefslogtreecommitdiffstats
path: root/widget/cocoa/nsMenuX.h
blob: 494f00d080837a3a2c57816f3c5571cff0d7b1d0 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
/* -*- Mode: C++; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
/* This Source Code Form is subject to the terms of the Mozilla Public
 * License, v. 2.0. If a copy of the MPL was not distributed with this
 * file, You can obtain one at http://mozilla.org/MPL/2.0/. */

#ifndef nsMenuX_h_
#define nsMenuX_h_

#import <Cocoa/Cocoa.h>

#include "mozilla/EventForwards.h"
#include "mozilla/RefPtr.h"
#include "mozilla/UniquePtr.h"
#include "nsMenuBaseX.h"
#include "nsMenuBarX.h"
#include "nsMenuGroupOwnerX.h"
#include "nsCOMPtr.h"
#include "nsChangeObserver.h"

class nsMenuX;
class nsMenuItemIconX;
class nsMenuItemX;
class nsIWidget;

// MenuDelegate is used to receive Cocoa notifications for setting
// up carbon events. Protocol is defined as of 10.6 SDK.
@interface MenuDelegate : NSObject <NSMenuDelegate> {
  nsMenuX* mGeckoMenu;  // weak ref
}
- (id)initWithGeckoMenu:(nsMenuX*)geckoMenu;
@end

// Once instantiated, this object lives until its DOM node or its parent window is destroyed.
// Do not hold references to this, they can become invalid any time the DOM node can be destroyed.
class nsMenuX : public nsMenuObjectX, public nsChangeObserver {
 public:
  nsMenuX();
  virtual ~nsMenuX();

  // If > 0, the OS is indexing all the app's menus (triggered by opening
  // Help menu on Leopard and higher).  There are some things that are
  // unsafe to do while this is happening.
  static int32_t sIndexingMenuLevel;

  NS_DECL_CHANGEOBSERVER

  // nsMenuObjectX
  void* NativeData() override { return (void*)mNativeMenu; }
  nsMenuObjectTypeX MenuObjectType() override { return eSubmenuObjectType; }
  void IconUpdated() override { mParent->IconUpdated(); }

  // nsMenuX
  nsresult Create(nsMenuObjectX* aParent, nsMenuGroupOwnerX* aMenuGroupOwner, nsIContent* aNode);
  uint32_t GetItemCount();
  nsMenuObjectX* GetItemAt(uint32_t aPos);
  nsresult GetVisibleItemCount(uint32_t& aCount);
  nsMenuObjectX* GetVisibleItemAt(uint32_t aPos);
  nsEventStatus MenuOpened();
  void MenuClosed();
  void SetRebuild(bool aMenuEvent);
  NSMenuItem* NativeMenuItem();
  nsresult SetupIcon();

  static bool IsXULHelpMenu(nsIContent* aMenuContent);

 protected:
  void MenuConstruct();
  nsresult RemoveAll();
  nsresult SetEnabled(bool aIsEnabled);
  nsresult GetEnabled(bool* aIsEnabled);
  void GetMenuPopupContent(nsIContent** aResult);
  bool OnOpen();
  bool OnClose();
  nsresult AddMenuItem(nsMenuItemX* aMenuItem);
  nsMenuX* AddMenu(mozilla::UniquePtr<nsMenuX> aMenu);
  void LoadMenuItem(nsIContent* inMenuItemContent);
  void LoadSubMenu(nsIContent* inMenuContent);
  GeckoNSMenu* CreateMenuWithGeckoString(nsString& menuTitle);

  nsTArray<mozilla::UniquePtr<nsMenuObjectX>> mMenuObjectsArray;
  nsString mLabel;
  uint32_t mVisibleItemsCount;         // cache
  nsMenuObjectX* mParent;              // [weak]
  nsMenuGroupOwnerX* mMenuGroupOwner;  // [weak]
  // The icon object should never outlive its creating nsMenuX object.
  RefPtr<nsMenuItemIconX> mIcon;  // [strong]
  GeckoNSMenu* mNativeMenu;       // [strong]
  MenuDelegate* mMenuDelegate;    // [strong]
  // nsMenuX objects should always have a valid native menu item.
  NSMenuItem* mNativeMenuItem;  // [strong]
  bool mIsEnabled;
  bool mDestroyHandlerCalled;
  bool mNeedsRebuild;
  bool mConstructed;
  bool mVisible;
};

#endif  // nsMenuX_h_