finalcut/src/fmenu.h

// File: fmenubar.h
// Provides: class FMenu
//
//  Inheritance diagram
//  ═══════════════════
//
// ▕▔▔▔▔▔▔▔▔▔▏ ▕▔▔▔▔▔▔▔▔▔▏
// ▕ FObject ▏ ▕  FTerm  ▏
// ▕▁▁▁▁▁▁▁▁▁▏ ▕▁▁▁▁▁▁▁▁▁▏
//      ▲           ▲
//      │           │
//      └─────┬─────┘
//            │
//       ▕▔▔▔▔▔▔▔▔▏
//       ▕ FVTerm ▏
//       ▕▁▁▁▁▁▁▁▁▏                     *▕▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▏
//            ▲                     ┌ - -▕ FRadioMenuItem ▏
//            │                     :    ▕▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▏
//       ▕▔▔▔▔▔▔▔▔▔▏                :
//       ▕ FWidget ▏                :   *▕▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▏
//       ▕▁▁▁▁▁▁▁▁▁▏                ├ - -▕ FCheckMenuItem ▏
//            ▲                     :    ▕▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▏
//            │                   1 :
//       ▕▔▔▔▔▔▔▔▔▔▏ ▕▔▔▔▔▔▔▔▔▔▔▔▏- ┘    ▕▔▔▔▔▔▔▔▔▔▔▔▏
//       ▕ FWindow ▏ ▕ FMenuList ▏- - - -▕ FMenuItem ▏
//       ▕▁▁▁▁▁▁▁▁▁▏ ▕▁▁▁▁▁▁▁▁▁▁▁▏1     *▕▁▁▁▁▁▁▁▁▁▁▁▏
//            ▲           ▲   1:
//            │           │    :
//            └─────┬─────┘    :
//                  │    1     :
//              ▕▔▔▔▔▔▔▔▏- - - ┘        ▕▔▔▔▔▔▔▔▔▔▔▔▏
//              ▕ FMenu ▏- - - - - - - -▕ FMenuItem ▏
//              ▕▁▁▁▁▁▁▁▏1             1▕▁▁▁▁▁▁▁▁▁▁▁▏

#ifndef FMENU_H
#define FMENU_H

#include "fwindow.h"
#include "fmenubar.h"
#include "fmenulist.h"
#include "fmenuitem.h"


//----------------------------------------------------------------------
// class FMenu
//----------------------------------------------------------------------

#pragma pack(push)
#pragma pack(1)

class FMenu : public FWindow, public FMenuList
{
 public:
   // Constructor
   explicit FMenu (FWidget* = 0);
   FMenu (const FString&, FWidget* = 0);

   // Destructor
   virtual ~FMenu();

   // Accessors
   virtual const char* getClassName() const;
   FString             getText() const;
   FMenuItem*          getItem() const;

   // Mutators
   bool                setEnable(bool);
   bool                setEnable();
   bool                unsetEnable();
   bool                setDisable();
   void                setSelected();
   void                unsetSelected();
   bool                setMenuWidget (bool);
   bool                setMenuWidget();
   bool                unsetMenuWidget();
   void                setStatusbarMessage (const FString&);
   void                setMenu (FMenu*);
   void                setText (const FString&);

   // Inquiries
   bool                isEnabled() const;
   bool                isSelected() const;
   bool                hasHotkey() const;
   bool                hasMenu() const;

   // Methods
   void                show();
   void                hide();

   // Event handlers
   void                onKeyPress (FKeyEvent*);
   void                onMouseDown (FMouseEvent*);
   void                onMouseUp (FMouseEvent*);
   void                onMouseMove (FMouseEvent*);
   void                onAccel (FAccelEvent*);

   // Callback method
   void                cb_menuitem_toggled (FWidget*, data_ptr);

 private:
   // Disable copy constructor
   FMenu (const FMenu&);

   // Disable assignment operator (=)
   FMenu& operator = (const FMenu&);

   // Accessors
   FWidget*     getSuperMenu() const;

   // Mutators
   void         setSuperMenu (FWidget*);

   // Inquiries
   bool         isWindowsMenu (FWidget*) const;
   bool         isMenuBar (FWidget*) const;
   bool         isMenu (FWidget*) const;
   bool         isRadioMenuItem (FWidget*) const;
   bool         isSubMenu() const;

   // Methods
   void         init(FWidget*);
   void         calculateDimensions();
   void         adjustItems();
   int          adjustX(int);
   void         openSubMenu (FMenu*);
   void         hideSubMenus();
   void         hideSuperMenus();
   bool         containsMenuStructure (const FPoint&);
   bool         containsMenuStructure (int, int);
   FMenu*       superMenuAt (const FPoint&);
   FMenu*       superMenuAt (int, int);
   bool         selectNextItem();
   bool         selectPrevItem();
   void         keypressMenuBar (FKeyEvent*&);
   bool         hotkeyMenu (FKeyEvent*&);
   int          getHotkeyPos (wchar_t*&, wchar_t*&, uInt);
   void         draw();
   void         drawItems();
   void         drawSeparator(int);
   void         processActivate();

   // Friend classes
   friend class FApplication;
   friend class FCheckMenuItem;
   friend class FDialog;
   friend class FMenuBar;
   friend class FMenuItem;
   friend class FRadioMenuItem;

   // Data Members
   FMenuItem*   item;
   FWidget*     super_menu;
   FMenu*       open_sub_menu;
   uInt         max_item_width;
   bool         mouse_down;
   bool         has_checkable_items;
};
#pragma pack(pop)


// FMenu inline functions
//----------------------------------------------------------------------
inline const char* FMenu::getClassName() const
{ return "FMenu"; }

//----------------------------------------------------------------------
inline FString FMenu::getText() const
{ return item->getText(); }

//----------------------------------------------------------------------
inline FMenuItem* FMenu::getItem() const
{ return item; }

//----------------------------------------------------------------------
inline bool FMenu::setEnable(bool on)
{ return item->setEnable(on); }

//----------------------------------------------------------------------
inline bool FMenu::setEnable()
{ return item->setEnable(); }

//----------------------------------------------------------------------
inline bool FMenu::unsetEnable()
{ return item->unsetEnable(); }

//----------------------------------------------------------------------
inline bool FMenu::setDisable()
{ return item->setDisable(); }

//----------------------------------------------------------------------
inline void FMenu::setSelected()
{ item->setSelected(); }

//----------------------------------------------------------------------
inline void FMenu::unsetSelected()
{ item->unsetSelected(); }

//----------------------------------------------------------------------
inline bool FMenu::setMenuWidget()
{ return setMenuWidget(true); }

//----------------------------------------------------------------------
inline bool FMenu::unsetMenuWidget()
{ return setMenuWidget(false); }

//----------------------------------------------------------------------
inline void FMenu::setMenu (FMenu* m)
{ item->setMenu(m); }

//----------------------------------------------------------------------
inline void FMenu::setText (const FString& txt)
{ item->setText(txt); }

//----------------------------------------------------------------------
inline bool FMenu::isEnabled() const
{ return item->isEnabled(); }

//----------------------------------------------------------------------
inline bool FMenu::isSelected() const
{ return item->isSelected(); }

//----------------------------------------------------------------------
inline bool FMenu::hasHotkey() const
{ return item->hasHotkey(); }

//----------------------------------------------------------------------
inline bool FMenu::hasMenu() const
{ return item->hasMenu(); }

//----------------------------------------------------------------------
inline FWidget* FMenu::getSuperMenu() const
{ return super_menu; }

//----------------------------------------------------------------------
inline void FMenu::setSuperMenu (FWidget* smenu)
{ super_menu = smenu; }

//----------------------------------------------------------------------
inline bool FMenu::containsMenuStructure (const FPoint& p)
{ return containsMenuStructure (p.getX(), p.getY()); }

//----------------------------------------------------------------------
inline FMenu* FMenu::superMenuAt (const FPoint& p)
{ return superMenuAt (p.getX(), p.getY()); }

//----------------------------------------------------------------------
inline void FMenu::onAccel (FAccelEvent* ev)
{ item->onAccel(ev); }


#endif  // FMENU_H