PopupMenuTable Class Reference

#include <PopupMenuTable.h>

Inheritance diagram for PopupMenuTable:

Collaboration diagram for PopupMenuTable:

Classes
struct	AttachedItem

Public Types
using	Entry = PopupMenuTableEntry

Public Member Functions
	PopupMenuTable (const Identifier &id, const TranslatableString &caption={})
const Identifier &	Id () const
const TranslatableString &	Caption () const
const auto *	GetRegistry () const
const auto &	Get (void *pUserData)
void	Clear ()
Public Member Functions inherited from PopupMenuHandler
	PopupMenuHandler ()=default
	PopupMenuHandler (const PopupMenuHandler &)=delete
PopupMenuHandler &	operator= (const PopupMenuHandler &)=delete
virtual void	InitUserData (void *pUserData)=0
	Called before the menu items are appended. More...

Static Public Member Functions
static std::unique_ptr< PopupMenu >	BuildMenu (PopupMenuTable *pTable, void *pUserData=NULL)
static void	ExtendMenu (PopupMenu &menu, PopupMenuTable &otherTable)
template<typename Table , typename Factory >
static auto	Adapt (const Factory &factory)

Protected Member Functions
virtual void	Populate ()=0
template<typename Ptr >
void	Append (Ptr pItem)
void	Append (const Identifier &stringId, PopupMenuTableEntry::Type type, int id, const TranslatableString &string, wxCommandEventFunction memFn, const PopupMenuTableEntry::InitFunction &init)
void	AppendItem (const Identifier &stringId, int id, const TranslatableString &string, wxCommandEventFunction memFn, const PopupMenuTableEntry::InitFunction &init={})
void	AppendRadioItem (const Identifier &stringId, int id, const TranslatableString &string, wxCommandEventFunction memFn, const PopupMenuTableEntry::InitFunction &init={})
void	AppendCheckItem (const Identifier &stringId, int id, const TranslatableString &string, wxCommandEventFunction memFn, const PopupMenuTableEntry::InitFunction &init={})
void	BeginSection (const Identifier &name)
void	EndSection ()

Static Protected Member Functions
static TranslatableString	MakeLabel (const TranslatableString &label, bool useExtra, const TranslatableString &extra)

Protected Attributes
std::shared_ptr< PopupSubMenu >	mTop
std::vector< PopupMenuGroupItem * >	mStack
Identifier	mId
TranslatableString	mCaption
std::unique_ptr< PopupMenuGroupItem >	mRegistry

Private Member Functions
template<typename Ptr >
void	RegisterItem (const Registry::Placement &placement, Ptr pItem)

Detailed Description

Definition at line 121 of file PopupMenuTable.h.

Member Typedef Documentation

Entry

using PopupMenuTable::Entry = PopupMenuTableEntry

Definition at line 124 of file PopupMenuTable.h.

Constructor & Destructor Documentation

PopupMenuTable()

PopupMenuTable::PopupMenuTable ( const Identifier &  id, const TranslatableString &  caption = {}  )

inline

Definition at line 127 of file PopupMenuTable.h.

                                                                            {})
      : mId{ id }
      , mCaption{ caption }
      , mRegistry{
         std::make_unique<PopupMenuGroupItem>(mId) }
   {}

Member Function Documentation

Adapt()

template<typename Table , typename Factory >

static auto PopupMenuTable::Adapt ( const Factory &  factory )

inlinestatic

Definition at line 170 of file PopupMenuTable.h.

   {
      return [factory](PopupMenuTable &table){
         return std::shared_ptr{ factory(static_cast<Table&>(table)) };
      };
   }

References factory.

Append() [1/2]

void PopupMenuTable::Append ( const Identifier &  stringId, PopupMenuTableEntry::Type  type, int  id, const TranslatableString &  string, wxCommandEventFunction  memFn, const PopupMenuTableEntry::InitFunction &  init  )

protected

Definition at line 146 of file PopupMenuTable.cpp.

{
   Append( std::make_unique<Entry>(
      stringId, type, id, string, memFn, *this, init ) );
}

References Append().

Here is the call graph for this function:

Append() [2/2]

template<typename Ptr >

void PopupMenuTable::Append ( Ptr  pItem )

inlineprotected

Definition at line 199 of file PopupMenuTable.h.

{ mStack.back()->push_back(std::move(pItem)); }

Referenced by Append().

Here is the caller graph for this function:

AppendCheckItem()

void PopupMenuTable::AppendCheckItem ( const Identifier &  stringId, int  id, const TranslatableString &  string, wxCommandEventFunction  memFn, const PopupMenuTableEntry::InitFunction &  init = {}  )

inlineprotected

Definition at line 219 of file PopupMenuTable.h.

                                                    {} )
   { Append( stringId, PopupMenuTableEntry::CheckItem, id, string, memFn, init ); }

AppendItem()

void PopupMenuTable::AppendItem ( const Identifier &  stringId, int  id, const TranslatableString &  string, wxCommandEventFunction  memFn, const PopupMenuTableEntry::InitFunction &  init = {}  )

inlineprotected

Definition at line 207 of file PopupMenuTable.h.

                                                    {} )
   { Append( stringId, PopupMenuTableEntry::Item, id, string, memFn, init ); }

AppendRadioItem()

void PopupMenuTable::AppendRadioItem ( const Identifier &  stringId, int  id, const TranslatableString &  string, wxCommandEventFunction  memFn, const PopupMenuTableEntry::InitFunction &  init = {}  )

inlineprotected

Definition at line 213 of file PopupMenuTable.h.

                                                    {} )
   { Append( stringId, PopupMenuTableEntry::RadioItem, id, string, memFn, init ); }

BeginSection()

void PopupMenuTable::BeginSection ( const Identifier &  name )

protected

Definition at line 155 of file PopupMenuTable.cpp.

{
   auto uSection = std::make_unique< PopupMenuSection >( name );
   auto section = uSection.get();
   mStack.back()->push_back( std::move( uSection ) );
   mStack.push_back( section );
}

References mStack, and name.

BuildMenu()

std::unique_ptr< PopupMenu > PopupMenuTable::BuildMenu ( PopupMenuTable *  pTable, void *  pUserData = NULL  )

static

Definition at line 169 of file PopupMenuTable.cpp.

{
   // Rebuild as needed each time.  That makes it safe in case of language change.
   auto theMenu = std::make_unique<PopupMenuImpl>( pUserData );
   ExtendMenu( *theMenu, *pTable );
   return theMenu;
}

References ExtendMenu().

Referenced by CommonTrackControls::DoContextMenu(), WaveChannelVZoomHandle::DoRelease(), NoteTrackVZoomHandle::Release(), and TimeTrackVZoomHandle::Release().

Here is the call graph for this function:

Here is the caller graph for this function:

Caption()

const TranslatableString & PopupMenuTable::Caption ( ) const

inline

Definition at line 140 of file PopupMenuTable.h.

{ return mCaption; }

Referenced by WaveTrackMenuTable::OnMergeStereo().

Here is the caller graph for this function:

Clear()

void PopupMenuTable::Clear ( )

inline

Definition at line 163 of file PopupMenuTable.h.

   {
      mTop.reset();
   }

Referenced by NoteTrackVRulerMenuTable::UpdatePrefs(), WaveChannelVRulerMenuTable::UpdatePrefs(), and TrackMenuTable::UpdatePrefs().

Here is the caller graph for this function:

EndSection()

void PopupMenuTable::EndSection ( )

protected

Definition at line 163 of file PopupMenuTable.cpp.

{
   mStack.pop_back();
}

References mStack.

ExtendMenu()

void PopupMenuTable::ExtendMenu ( PopupMenu &  menu, PopupMenuTable &  otherTable  )

static

Definition at line 137 of file PopupMenuTable.cpp.

{
   auto &theMenu = dynamic_cast<PopupMenuImpl&>(menu);
 
   PopupMenuBuilder visitor{ table, theMenu, theMenu.pUserData };
   Registry::VisitWithFunctions(visitor, table.Get(theMenu.pUserData).get(),
      table.GetRegistry(), table);
}

References Get(), GetRegistry(), and Registry::VisitWithFunctions().

Referenced by BuildMenu(), and CommonTrackControls::DoContextMenu().

Here is the call graph for this function:

Here is the caller graph for this function:

Get()

const auto & PopupMenuTable::Get ( void *  pUserData )

inline

Definition at line 154 of file PopupMenuTable.h.

   {
      if ( pUserData )
         this->InitUserData( pUserData );
      if (!mTop)
         Populate();
      return mTop;
   }

Referenced by ExtendMenu().

Here is the caller graph for this function:

GetRegistry()

const auto * PopupMenuTable::GetRegistry ( ) const

inline

Definition at line 141 of file PopupMenuTable.h.

{ return mRegistry.get(); }

Referenced by ExtendMenu().

Here is the caller graph for this function:

Id()

const Identifier & PopupMenuTable::Id ( ) const

inline

Definition at line 139 of file PopupMenuTable.h.

{ return mId; }

MakeLabel()

static TranslatableString PopupMenuTable::MakeLabel ( const TranslatableString &  label, bool  useExtra, const TranslatableString &  extra  )

inlinestaticprotected

Definition at line 187 of file PopupMenuTable.h.

   {
      return useExtra
         ? XXO("%s (%s)").Format( label, extra )
         : label;
   }

References label, and XXO().

Here is the call graph for this function:

Populate()

virtual void PopupMenuTable::Populate ( )

protectedpure virtual

RegisterItem()

template<typename Ptr >

void PopupMenuTable::RegisterItem ( const Registry::Placement &  placement, Ptr  pItem  )

inlineprivate

Definition at line 178 of file PopupMenuTable.h.

   {
      Registry::RegisterItem(*mRegistry, placement, move(pItem));
   }

References Registry::RegisterItem().

Referenced by PopupMenuTable::AttachedItem< Ptr >::AttachedItem().

Here is the call graph for this function:

Here is the caller graph for this function:

Member Data Documentation

mCaption

TranslatableString PopupMenuTable::mCaption

protected

Definition at line 230 of file PopupMenuTable.h.

mId

Identifier PopupMenuTable::mId

protected

Definition at line 229 of file PopupMenuTable.h.

mRegistry

std::unique_ptr<PopupMenuGroupItem> PopupMenuTable::mRegistry

protected

Definition at line 231 of file PopupMenuTable.h.

mStack

std::vector<PopupMenuGroupItem*> PopupMenuTable::mStack

protected

Definition at line 228 of file PopupMenuTable.h.

Referenced by BeginSection(), and EndSection().

mTop

std::shared_ptr<PopupSubMenu> PopupMenuTable::mTop

protected

Definition at line 227 of file PopupMenuTable.h.

---

The documentation for this class was generated from the following files:

• PopupMenuTable.h
• PopupMenuTable.cpp