Audacity 3.2.0
Public Member Functions | Static Public Member Functions | Protected Member Functions | Private Member Functions | List of all members
CloseButtonHandle Class Referencefinal

#include <TrackButtonHandles.h>

Inheritance diagram for CloseButtonHandle:
Collaboration diagram for CloseButtonHandle:

Public Member Functions

 CloseButtonHandle (const std::shared_ptr< Track > &pTrack, const wxRect &rect)
CloseButtonHandleoperator= (const CloseButtonHandle &)=default
virtual ~CloseButtonHandle ()
- Public Member Functions inherited from ButtonHandle
std::shared_ptr< TrackGetTrack () const
bool IsDragging () const override
- Public Member Functions inherited from UIHandle
virtual ~UIHandle ()=0
virtual void Enter (bool forward, AudacityProject *pProject)
virtual bool HasRotation () const
virtual bool Rotate (bool forward)
virtual bool HasEscape (AudacityProject *pProject) const
virtual bool Escape (AudacityProject *pProject)
virtual bool HandlesRightClick ()
 Whether the handle has any special right-button handling. More...
virtual Result Click (const TrackPanelMouseEvent &event, AudacityProject *pProject)=0
virtual Result Drag (const TrackPanelMouseEvent &event, AudacityProject *pProject)=0
virtual HitTestPreview Preview (const TrackPanelMouseState &state, AudacityProject *pProject)=0
virtual Result Release (const TrackPanelMouseEvent &event, AudacityProject *pProject, wxWindow *pParent)=0
virtual Result Cancel (AudacityProject *pProject)=0
virtual bool StopsOnKeystroke ()
virtual void OnProjectChange (AudacityProject *pProject)
virtual std::shared_ptr< const TrackFindTrack () const =0
virtual bool IsDragging () const
Result GetChangeHighlight () const
void SetChangeHighlight (Result val)
- 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 UIHandlePtr HitTest (std::weak_ptr< CloseButtonHandle > &holder, const wxMouseState &state, const wxRect &rect, TrackPanelCell *pCell)
- Static Public Member Functions inherited from UIHandle
static UIHandle::Result NeedChangeHighlight (const UIHandle &, const UIHandle &)
static std::shared_ptr< const TrackTrackFromChannel (const std::shared_ptr< const Channel > &pChannel)
 A frequent convenience in the definition of UIHandles. More...
- 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

Result CommitChanges (const wxMouseEvent &event, AudacityProject *pProject, wxWindow *pParent) override
TranslatableString Tip (const wxMouseState &state, AudacityProject &project) const override
bool StopsOnKeystroke () override
- Protected Member Functions inherited from ButtonHandle
 ButtonHandle (const std::shared_ptr< Track > &pTrack, const wxRect &rect)
ButtonHandleoperator= (const ButtonHandle &)=default
virtual ~ButtonHandle ()
std::shared_ptr< const TrackFindTrack () const override
virtual Result CommitChanges (const wxMouseEvent &event, AudacityProject *pProject, wxWindow *pParent)=0
virtual TranslatableString Tip (const wxMouseState &state, AudacityProject &project) const =0
void Enter (bool forward, AudacityProject *) final override
Result Click (const TrackPanelMouseEvent &event, AudacityProject *pProject) final override
Result Drag (const TrackPanelMouseEvent &event, AudacityProject *pProject) final override
HitTestPreview Preview (const TrackPanelMouseState &state, AudacityProject *pProject) final override
Result Release (const TrackPanelMouseEvent &event, AudacityProject *pProject, wxWindow *pParent) final override
Result Cancel (AudacityProject *pProject) final override

Private Member Functions

 CloseButtonHandle (const CloseButtonHandle &)=delete

Additional Inherited Members

- Public Types inherited from UIHandle
using Result = unsigned
using Cell = TrackPanelCell
- Protected Attributes inherited from ButtonHandle
std::weak_ptr< TrackmpTrack
wxRect mRect
bool mWasIn { true }
bool mIsDragging {}
- Protected Attributes inherited from UIHandle
Result mChangeHighlight { 0 }

Detailed Description

Definition at line 70 of file TrackButtonHandles.h.

Constructor & Destructor Documentation

◆ CloseButtonHandle() [1/2]

CloseButtonHandle::CloseButtonHandle ( const CloseButtonHandle )

◆ CloseButtonHandle() [2/2]

CloseButtonHandle::CloseButtonHandle ( const std::shared_ptr< Track > &  pTrack,
const wxRect &  rect 

Definition at line 141 of file TrackButtonHandles.cpp.

143 : ButtonHandle{ pTrack, rect }
A UIHandle for a TrackPanel button, such as the Mute and Solo buttons.
Definition: ButtonHandle.h:26

◆ ~CloseButtonHandle()

CloseButtonHandle::~CloseButtonHandle ( )

Definition at line 146 of file TrackButtonHandles.cpp.


Member Function Documentation

◆ CommitChanges()

UIHandle::Result CloseButtonHandle::CommitChanges ( const wxMouseEvent &  event,
AudacityProject pProject,
wxWindow *  pParent 

Implements ButtonHandle.

Definition at line 150 of file TrackButtonHandles.cpp.

153 using namespace RefreshCode;
154 Result result = RefreshNone;
156 auto pTrack = mpTrack.lock();
157 if (pTrack) {
158 auto &toRemove = PendingTracks::Get(*pProject)
161 if (!ProjectAudioIO::Get( *pProject ).IsAudioActive()) {
162 // This pushes an undo item:
163 TrackUtilities::DoRemoveTrack(*pProject, toRemove);
164 // Redraw all tracks when any one of them closes
165 // (Could we invent a return code that draws only those at or below
166 // the affected track?)
168 }
169 }
171 return result;
std::weak_ptr< Track > mpTrack
Definition: ButtonHandle.h:74
Track & SubstitutePendingChangedTrack(Track &track) const
static PendingTracks & Get(AudacityProject &project)
bool IsAudioActive() const
static ProjectAudioIO & Get(AudacityProject &project)
static ProjectAudioManager & Get(AudacityProject &project)
unsigned Result
Definition: UIHandle.h:40
Namespace containing an enum 'what to do on a refresh?'.
Definition: RefreshCode.h:16
AUDACITY_DLL_API void DoRemoveTrack(AudacityProject &project, Track &toRemove)

References RefreshCode::DestroyedCell, TrackUtilities::DoRemoveTrack(), RefreshCode::FixScrollbars, ProjectAudioIO::Get(), PendingTracks::Get(), ProjectAudioManager::Get(), ProjectAudioIO::IsAudioActive(), ButtonHandle::mpTrack, RefreshCode::RefreshAll, RefreshCode::RefreshNone, RefreshCode::Resize, ProjectAudioManager::StopIfPaused(), and PendingTracks::SubstitutePendingChangedTrack().

Here is the call graph for this function:

◆ HitTest()

UIHandlePtr CloseButtonHandle::HitTest ( std::weak_ptr< CloseButtonHandle > &  holder,
const wxMouseState &  state,
const wxRect &  rect,
TrackPanelCell pCell 

Definition at line 188 of file TrackButtonHandles.cpp.

192 wxRect buttonRect;
193 CommonTrackInfo::GetCloseBoxRect(rect, buttonRect);
195 if (buttonRect.Contains(state.m_x, state.m_y)) {
196 auto pTrack = static_cast<CommonTrackPanelCell*>(pCell)->FindTrack();
197 auto result = std::make_shared<CloseButtonHandle>( pTrack, buttonRect );
198 result = AssignUIHandlePtr(holder, result);
199 return result;
200 }
201 else
202 return {};
std::shared_ptr< Subclass > AssignUIHandlePtr(std::weak_ptr< Subclass > &holder, const std::shared_ptr< Subclass > &pNew)
Definition: UIHandle.h:164
std::shared_ptr< const Track > FindTrack() const override
AUDACITY_DLL_API void GetCloseBoxRect(const wxRect &rect, wxRect &dest)

References AssignUIHandlePtr(), ButtonHandle::FindTrack(), and CommonTrackInfo::GetCloseBoxRect().

Referenced by CommonTrackControls::HitTest().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ operator=()

CloseButtonHandle & CloseButtonHandle::operator= ( const CloseButtonHandle )

◆ StopsOnKeystroke()

bool CloseButtonHandle::StopsOnKeystroke ( )

Reimplemented from UIHandle.

Definition at line 82 of file TrackButtonHandles.h.

82{ return true; }

◆ Tip()

TranslatableString CloseButtonHandle::Tip ( const wxMouseState &  state,
AudacityProject project 
) const

Implements ButtonHandle.

Definition at line 174 of file TrackButtonHandles.cpp.

177 auto name = XO("Delete Track");
178 auto focused =
179 TrackFocus::Get( project ).Get() == GetTrack().get();
180 if (!focused)
181 return name;
183 auto &commandManager = CommandManager::Get( project );
184 ComponentInterfaceSymbol command{ wxT("TrackClose"), name };
185 return commandManager.DescribeCommandsAndShortcuts( &command, 1u );
const TranslatableString name
Definition: Distortion.cpp:76
const auto project
std::shared_ptr< Track > GetTrack() const
Definition: ButtonHandle.h:30
Subclass & Get(const RegisteredFactory &key)
Get reference to an attachment, creating on demand if not present, down-cast it to Subclass.
Definition: ClientData.h:318
static CommandManager & Get(AudacityProject &project)
ComponentInterfaceSymbol pairs a persistent string identifier used internally with an optional,...
Track * Get()
Definition: TrackFocus.cpp:156

References TrackFocus::Get(), CommandManager::Get(), ClientData::Site< Host, ClientData, ObjectCopyingPolicy, Pointer, ObjectLockingPolicy, RegistryLockingPolicy >::Get(), ButtonHandle::GetTrack(), name, project, wxT(), and XO().

Here is the call graph for this function:

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