#include <CommonTrackControls.h>

Inheritance diagram for CommonTrackControls:

Collaboration diagram for CommonTrackControls:

Classes
struct	InitMenuData

Public Member Functions
const TCPLines &	GetTCPLines () const override

	TrackControls (std::shared_ptr< Track > pTrack)

Public Member Functions inherited from TrackControls
	TrackControls (std::shared_ptr< Track > pTrack)

virtual	~TrackControls ()=0

virtual const TrackInfo::TCPLines &	GetTCPLines () const =0

Public Member Functions inherited from CommonTrackCell
	CommonTrackCell (const std::shared_ptr< Track > &pTrack)
	Construct from a track. More...

	~CommonTrackCell ()

std::shared_ptr< Track >	DoFindTrack () override

void	Reparent (const std::shared_ptr< Track > &parent) override
	Object may be shared among tracks but hold a special back-pointer to one of them; reassign it. More...

Public Member Functions inherited from CommonTrackPanelCell
	CommonTrackPanelCell ()

virtual	~CommonTrackPanelCell ()=0

HitTestPreview	DefaultPreview (const TrackPanelMouseState &, const AudacityProject *) override

std::shared_ptr< Track >	FindTrack ()

std::shared_ptr< const Track >	FindTrack () const

virtual std::vector< MenuItem >	GetMenuItems (const wxRect &rect, const wxPoint pPosition, AudacityProject pProject)
	Return a list of items for DoContextMenu() (empties for separators) More...

Public Member Functions inherited from TrackPanelCell
	TrackPanelCell ()=default

	TrackPanelCell (const TrackPanelCell &)=delete

TrackPanelCell &	operator= (const TrackPanelCell &)=delete

virtual	~TrackPanelCell ()=0

virtual HitTestPreview	DefaultPreview (const TrackPanelMouseState &state, const AudacityProject *pProject)

virtual std::vector< UIHandlePtr >	HitTest (const TrackPanelMouseState &state, const AudacityProject *pProject)=0

virtual unsigned	HandleWheelRotation (const TrackPanelMouseEvent &event, AudacityProject *pProject)

virtual std::shared_ptr< TrackPanelCell >	ContextMenuDelegate ()

virtual unsigned	DoContextMenu (const wxRect &rect, wxWindow pParent, const wxPoint pPosition, AudacityProject *pProject)

virtual unsigned	CaptureKey (wxKeyEvent &event, ViewInfo &viewInfo, wxWindow pParent, AudacityProject project)

virtual unsigned	KeyDown (wxKeyEvent &event, ViewInfo &viewInfo, wxWindow pParent, AudacityProject project)

virtual unsigned	KeyUp (wxKeyEvent &event, ViewInfo &viewInfo, wxWindow pParent, AudacityProject project)

virtual unsigned	Char (wxKeyEvent &event, ViewInfo &viewInfo, wxWindow pParent, AudacityProject project)

virtual unsigned	LoseFocus (AudacityProject *project)

Public Member Functions inherited from TrackPanelNode
	TrackPanelNode ()

virtual	~TrackPanelNode ()=0

Public Member Functions inherited from TrackPanelDrawable
virtual	~TrackPanelDrawable ()=0

virtual void	Draw (TrackPanelDrawingContext &context, const wxRect &rect, unsigned iPass)

virtual wxRect	DrawingArea (TrackPanelDrawingContext &context, const wxRect &rect, const wxRect &panelRect, unsigned iPass)

Public Member Functions inherited from TrackAttachment
virtual	~TrackAttachment ()

virtual void	CopyTo (Track &track) const
	Copy state, for undo/redo purposes. More...

virtual void	Reparent (const std::shared_ptr< Track > &parent)
	Object may be shared among tracks but hold a special back-pointer to one of them; reassign it. More...

virtual void	WriteXMLAttributes (XMLWriter &) const
	Serialize persistent attributes. More...

virtual bool	HandleXMLAttribute (const std::string_view &attr, const XMLAttributeValueView &valueView)
	Deserialize an attribute, returning true if recognized. More...

Public Member Functions inherited from ClientData::Base
virtual	~Base ()

Protected Member Functions
virtual std::vector< UIHandlePtr >	HitTest (const TrackPanelMouseState &state, const AudacityProject *) override=0

unsigned	DoContextMenu (const wxRect &rect, wxWindow pParent, const wxPoint pPosition, AudacityProject *pProject) override

virtual PopupMenuTable *	GetMenuExtension (Track *pTrack)=0

void	Draw (TrackPanelDrawingContext &context, const wxRect &rect, unsigned iPass) override

wxRect	DrawingArea (TrackPanelDrawingContext &, const wxRect &rect, const wxRect &panelRect, unsigned iPass) override

Protected Member Functions inherited from CommonTrackPanelCell
virtual std::shared_ptr< Track >	DoFindTrack ()=0

unsigned	DoContextMenu (const wxRect &rect, wxWindow pParent, const wxPoint pPosition, AudacityProject *pProject) override

unsigned	HandleWheelRotation (const TrackPanelMouseEvent &event, AudacityProject *pProject) override

Protected Attributes
std::weak_ptr< CloseButtonHandle >	mCloseHandle

std::weak_ptr< MenuButtonHandle >	mMenuHandle

std::weak_ptr< MinimizeButtonHandle >	mMinimizeHandle

std::weak_ptr< TrackSelectHandle >	mSelectHandle

Additional Inherited Members
Static Public Member Functions inherited from TrackControls
static TrackControls &	Get (Track &track)

static const TrackControls &	Get (const Track &track)

Static Public Member Functions inherited from TrackPanelDrawable
static wxRect	MaximizeWidth (const wxRect &rect, const wxRect &panelRect)

static wxRect	MaximizeHeight (const wxRect &rect, const wxRect &panelRect)

Detailed Description

Definition at line 25 of file CommonTrackControls.h.

Member Function Documentation

◆ DoContextMenu()

unsigned CommonTrackControls::DoContextMenu	(	const wxRect &	rect,
		wxWindow *	pParent,
		const wxPoint *	pPosition,
		AudacityProject *	pProject
	)

overrideprotectedvirtual

Reimplemented from TrackPanelCell.

Definition at line 264 of file CommonTrackControls.cpp.

{
   using namespace RefreshCode;
   wxRect buttonRect;
   CommonTrackInfo::GetTrackMenuButtonRect(rect, buttonRect);
 
   auto track = FindTrack();
   if (!track)
      return RefreshNone;
 
   InitMenuData data{ *pProject, *track, pParent, RefreshNone };
 
   const auto pTable = &TrackMenuTable::Instance();
   auto pMenu = PopupMenuTable::BuildMenu(pTable, &data);
 
   PopupMenuTable *const pExtension = GetMenuExtension(track.get());
   if (pExtension)
      PopupMenuTable::ExtendMenu( *pMenu, *pExtension );
 
   pMenu->Popup( *pParent,
      { buttonRect.x + 1, buttonRect.y + buttonRect.height + 1 } );
 
   return data.result;
}

References PopupMenuTable::BuildMenu(), PopupMenuTable::ExtendMenu(), CommonTrackPanelCell::FindTrack(), GetMenuExtension(), CommonTrackInfo::GetTrackMenuButtonRect(), TrackMenuTable::Instance(), and RefreshCode::RefreshNone.

Here is the call graph for this function:

◆ Draw()

void CommonTrackControls::Draw	(	TrackPanelDrawingContext &	context,
		const wxRect &	rect,
		unsigned	iPass
	)

overrideprotectedvirtual

Reimplemented from TrackPanelDrawable.

Definition at line 345 of file CommonTrackControls.cpp.

{
   if ( iPass == TrackArtist::PassMargins ) {
      // fill in label
      auto dc = &context.dc;
      const auto pTrack = FindTrack();
      AColor::MediumTrackInfo( dc, pTrack && pTrack->GetSelected() );
      dc->DrawRectangle( rect_ );
   }
 
   if ( iPass == TrackArtist::PassControls ) {
      // Given rectangle excludes left and right margins, and encompasses a
      // channel group of tracks, plus the resizer area below
      auto pTrack = FindTrack();
 
      // Vaughan, 2010-08-24: No longer doing this.
      // Draw sync-lock tiles in ruler area.
      //if (SyncLock::IsSyncLockSelected(t)) {
      //   wxRect tileFill = rect;
      //   tileFill.x = mViewInfo->GetVRulerOffset();
      //   tileFill.width = mViewInfo->GetVRulerWidth();
      //   TrackArt::DrawSyncLockTiles(dc, tileFill);
      //}
 
      if (pTrack)
         // Draw things within the track control panel
         CommonTrackInfo::DrawItems( context, rect_, *pTrack );
   }
}

References TrackPanelDrawingContext::dc, CommonTrackInfo::DrawItems(), CommonTrackPanelCell::FindTrack(), AColor::MediumTrackInfo(), TrackArtist::PassControls, and TrackArtist::PassMargins.

Here is the call graph for this function:

◆ DrawingArea()

wxRect CommonTrackControls::DrawingArea	(	TrackPanelDrawingContext &	,
		const wxRect &	rect,
		const wxRect &	panelRect,
		unsigned	iPass
	)

overrideprotectedvirtual

Reimplemented from TrackPanelDrawable.

Definition at line 377 of file CommonTrackControls.cpp.

{
   return rect;
}

◆ GetMenuExtension()

virtual PopupMenuTable * CommonTrackControls::GetMenuExtension ( Track * pTrack )

protectedpure virtual

Implemented in LabelTrackControls, NoteTrackControls, WaveTrackControls, and TimeTrackControls.

Referenced by DoContextMenu().

Here is the caller graph for this function:

◆ GetTCPLines()

const TCPLines & CommonTrackControls::GetTCPLines ( ) const

overridevirtual

Implements TrackControls.

Definition at line 383 of file CommonTrackControls.cpp.

{
   return CommonTrackInfo::StaticTCPLines();
}

References CommonTrackInfo::StaticTCPLines().

Here is the call graph for this function:

◆ HitTest()

std::vector< UIHandlePtr > CommonTrackControls::HitTest	(	const TrackPanelMouseState &	state,
		const AudacityProject *
	)

overrideprotectedpure virtual

Implements TrackPanelCell.

Implemented in LabelTrackControls, NoteTrackControls, WaveTrackControls, and TimeTrackControls.

Definition at line 35 of file CommonTrackControls.cpp.

{
   // Hits are mutually exclusive, results single
 
   const wxMouseState &state = st.state;
   const wxRect &rect = st.rect;
   UIHandlePtr result;
   std::vector<UIHandlePtr> results;
 
   auto sThis = shared_from_this();
 
   if (NULL != (result = CloseButtonHandle::HitTest(
      mCloseHandle, state, rect, this)))
      results.push_back(result);
 
   if (NULL != (result = MenuButtonHandle::HitTest(
      mMenuHandle, state, rect, sThis)))
      results.push_back(result);
 
   if (NULL != (result = MinimizeButtonHandle::HitTest(
      mMinimizeHandle, state, rect, this)))
      results.push_back(result);
 
   if (results.empty()) {
      if (NULL != (result = TrackSelectHandle::HitAnywhere(
         mSelectHandle, FindTrack())))
         results.push_back(result);
   }
 
   return results;
}

References CommonTrackPanelCell::FindTrack(), TrackSelectHandle::HitAnywhere(), CloseButtonHandle::HitTest(), MenuButtonHandle::HitTest(), MinimizeButtonHandle::HitTest(), mCloseHandle, mMenuHandle, mMinimizeHandle, mSelectHandle, TrackPanelMouseState::rect, and TrackPanelMouseState::state.

Referenced by LabelTrackControls::HitTest(), NoteTrackControls::HitTest(), WaveTrackControls::HitTest(), and TimeTrackControls::HitTest().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ TrackControls()

TrackControls::TrackControls ( std::shared_ptr< Track > pTrack )

explicit

Definition at line 27 of file TrackControls.cpp.

   : CommonTrackCell{ pTrack }
{
}

Member Data Documentation

◆ mCloseHandle

std::weak_ptr<CloseButtonHandle> CommonTrackControls::mCloseHandle

protected

Definition at line 64 of file CommonTrackControls.h.

Referenced by HitTest().

◆ mMenuHandle

std::weak_ptr<MenuButtonHandle> CommonTrackControls::mMenuHandle

protected

Definition at line 65 of file CommonTrackControls.h.

Referenced by HitTest().

◆ mMinimizeHandle

std::weak_ptr<MinimizeButtonHandle> CommonTrackControls::mMinimizeHandle

protected

Definition at line 66 of file CommonTrackControls.h.

Referenced by HitTest().

◆ mSelectHandle

std::weak_ptr<TrackSelectHandle> CommonTrackControls::mSelectHandle

protected

Definition at line 67 of file CommonTrackControls.h.

Referenced by HitTest().

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

Classes

Public Member Functions

Protected Member Functions

Protected Attributes

Additional Inherited Members

Detailed Description

Member Function Documentation

◆ DoContextMenu()

◆ Draw()

◆ DrawingArea()

◆ GetMenuExtension()

◆ GetTCPLines()

◆ HitTest()

◆ TrackControls()

Member Data Documentation

◆ mCloseHandle

◆ mMenuHandle

◆ mMinimizeHandle

◆ mSelectHandle