TrackVRulerControls Class Reference

#include <TrackVRulerControls.h>

Inheritance diagram for TrackVRulerControls:

Collaboration diagram for TrackVRulerControls:

Public Member Functions
	TrackVRulerControls (const std::shared_ptr< TrackView > &pTrackView)
virtual	~TrackVRulerControls ()=0
std::vector< UIHandlePtr >	HitTest (const TrackPanelMouseState &state, const AudacityProject *pProject) override
virtual void	UpdateRuler (const wxRect &rect)=0
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 &) PROHIBITED
TrackPanelCell &	operator= (const TrackPanelCell &) PROHIBITED
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)

Static Public Member Functions
static TrackVRulerControls &	Get (TrackView &)
static const TrackVRulerControls &	Get (const TrackView &)
static void	DrawZooming (TrackPanelDrawingContext &context, const wxRect &rect, int zoomStart, int zoomEnd)
static wxRect	ZoomingArea (const wxRect &rect, const wxRect &panelRect)
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)

Protected Member Functions
std::shared_ptr< Track >	DoFindTrack () override
void	Draw (TrackPanelDrawingContext &context, const wxRect &rect, unsigned iPass) override
wxRect	DrawingArea (TrackPanelDrawingContext &, const wxRect &rect, const wxRect &panelRect, unsigned iPass) override
Track *	GetTrack () const
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< TrackView >	mwTrackView

Detailed Description

Definition at line 22 of file TrackVRulerControls.h.

Constructor & Destructor Documentation

TrackVRulerControls()

TrackVRulerControls::TrackVRulerControls ( const std::shared_ptr< TrackView > &  pTrackView )

explicit

Definition at line 26 of file TrackVRulerControls.cpp.

  : mwTrackView{ pTrackView }
{
}

~TrackVRulerControls()

TrackVRulerControls::~TrackVRulerControls ( )

pure virtual

Definition at line 32 of file TrackVRulerControls.cpp.

{
}

Member Function Documentation

DoFindTrack()

std::shared_ptr< Track > TrackVRulerControls::DoFindTrack ( )

overrideprotectedvirtual

Implements CommonTrackPanelCell.

Definition at line 46 of file TrackVRulerControls.cpp.

{
   const auto pView = mwTrackView.lock();
   if ( pView )
      return pView->FindTrack();
   return {};
}

References mwTrackView.

Draw()

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

overrideprotectedvirtual

Reimplemented from TrackPanelDrawable.

Definition at line 97 of file TrackVRulerControls.cpp.

{
   // Common initial part of drawing for all subtypes
   if ( iPass == TrackArtist::PassMargins ) {
      auto rect = rect_;
      --rect.width;
      
      auto dc = &context.dc;
      
      
      // Paint the background
      auto pTrack = FindTrack();
      AColor::MediumTrackInfo(dc, pTrack && pTrack->GetSelected() );
      dc->DrawRectangle( rect );
      
      // Stroke the left border
      dc->SetPen(*wxBLACK_PEN);
      {
         const auto left = rect.GetLeft();
         AColor::Line( *dc, left, rect.GetTop(), left, rect.GetBottom() );
      }
   }
}

References TrackPanelDrawingContext::dc, CommonTrackPanelCell::FindTrack(), AColor::Line(), AColor::MediumTrackInfo(), and TrackArtist::PassMargins.

Referenced by LabelTrackVRulerControls::Draw(), NoteTrackVRulerControls::Draw(), SpectrumVRulerControls::Draw(), WaveformVRulerControls::Draw(), and TimeTrackVRulerControls::Draw().

Here is the call graph for this function:

Here is the caller graph for this function:

DrawingArea()

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

overrideprotectedvirtual

Reimplemented from TrackPanelDrawable.

Definition at line 123 of file TrackVRulerControls.cpp.

{
   // Common area change for all subclasses when drawing the controls
   // A bevel extends below one pixel outside of the hit-test area
   if ( iPass == TrackArtist::PassControls )
      return { rect.x, rect.y, rect.width, rect.height + 1 };
   else
      return rect;
}

References TrackArtist::PassControls.

DrawZooming()

void TrackVRulerControls::DrawZooming ( TrackPanelDrawingContext &  context, const wxRect &  rect, int  zoomStart, int  zoomEnd  )

static

Definition at line 60 of file TrackVRulerControls.cpp.

{
   // Draw a dashed rectangle, its right side disappearing in the black right
   // border of the track area, which is not part of this cell but right of it.
   auto &dc = context.dc;
 
   dc.SetBrush(*wxTRANSPARENT_BRUSH);
   dc.SetPen(*wxBLACK_DASHED_PEN);
 
   wxRect rect {
      rect_.x,
      std::min( zoomStart, zoomEnd),
      rect_.width,
      1 + abs( zoomEnd - zoomStart)
   };
 
   dc.DrawRectangle(rect);
}

References TrackPanelDrawingContext::dc, and min().

Referenced by WaveTrackVZoomHandle::DoDraw(), and NoteTrackVZoomHandle::Draw().

Here is the call graph for this function:

Here is the caller graph for this function:

Get() [1/2]

const TrackVRulerControls & TrackVRulerControls::Get ( const TrackView &  trackView )

static

Definition at line 41 of file TrackVRulerControls.cpp.

{
   return *trackView.GetVRulerControls();
}

References TrackView::GetVRulerControls().

Here is the call graph for this function:

Get() [2/2]

TrackVRulerControls & TrackVRulerControls::Get ( TrackView &  trackView )

static

Definition at line 36 of file TrackVRulerControls.cpp.

{
   return *trackView.GetVRulerControls();
}

References TrackView::GetVRulerControls().

Referenced by anonymous_namespace{TrackPanel.cpp}::VRulerAndChannel::Children(), and TrackPanel::UpdateTrackVRuler().

Here is the call graph for this function:

Here is the caller graph for this function:

GetTrack()

Track * TrackVRulerControls::GetTrack ( ) const

protected

HitTest()

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

overridevirtual

Implements TrackPanelCell.

Definition at line 54 of file TrackVRulerControls.cpp.

{
   return std::vector<UIHandlePtr>{};
}

Referenced by SpectrumVRulerControls::HitTest(), WaveformVRulerControls::HitTest(), TimeTrackVRulerControls::HitTest(), and NoteTrackVRulerControls::HitTest().

Here is the caller graph for this function:

UpdateRuler()

virtual void TrackVRulerControls::UpdateRuler ( const wxRect &  rect )

pure virtual

Implemented in LabelTrackVRulerControls, NoteTrackVRulerControls, SpectrumVRulerControls, WaveformVRulerControls, and TimeTrackVRulerControls.

Referenced by WaveTrackVRulerControls::DoDraw(), and TrackPanel::UpdateTrackVRuler().

Here is the caller graph for this function:

ZoomingArea()

wxRect TrackVRulerControls::ZoomingArea ( const wxRect &  rect, const wxRect &  panelRect  )

static

Definition at line 81 of file TrackVRulerControls.cpp.

{
   // TODO: Don't use the constant kRightMargin, but somehow discover the
   // neighboring track rectangle
   return {
      // Left edge of the rectangle disappears in the vertical line at
      // left edge of the ruler
      rect.x,
      rect.y,
      // Extend the dashed rectangle right up to the track border
      (panelRect.width - kRightMargin + kBorderThickness) - rect.x,
      rect.height
   };
}

References kBorderThickness, and kRightMargin.

Referenced by WaveTrackVZoomHandle::DoDrawingArea(), and NoteTrackVZoomHandle::DrawingArea().

Here is the caller graph for this function:

Member Data Documentation

mwTrackView

std::weak_ptr<TrackView> TrackVRulerControls::mwTrackView

protected

Definition at line 64 of file TrackVRulerControls.h.

Referenced by DoFindTrack().

---

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

• TrackVRulerControls.h
• TrackVRulerControls.cpp