Classes
struct	ErrorDialogOptions
	Options for variations of error dialogs; the default is for modal dialogs. More...

class	GenericProgressDialog
	Abstraction of a progress dialog with undefined time-to-completion estimate. More...

struct	MessageBoxOptions

struct	Point
	A pair of screen coordinates, x increasing rightward, y downward. More...

class	ProgressDialog
	Abstraction of a progress dialog with well defined time-to-completion estimate. More...

class	Services
	Abstract class defines a few user interface services, not mentioning particular toolkits. More...

class	WindowPlacement
	Subclasses may hold information such as a parent window pointer for a dialog. More...

Functions
Services *	Get ()
	Fetch the global instance, or nullptr if none is yet installed. More...

Services *	Install (Services *pInstance)
	Install an implementation; return the previously installed instance. More...

Functions that invoke global Services
These dispatch to the global Services, if supplied. If none was supplied, they are mostly no-ops, with exceptions as noted. All should be called on the main thread only, except as noted.
void	CallAfter (Action action)
	Schedule an action to be done later, and in the main thread. More...

void	Yield ()
	Dispatch waiting events, including actions enqueued by CallAfter. More...

bool	OpenInDefaultBrowser (const wxString &url)
	Open an URL in default browser. More...

void	ShowErrorDialog (const WindowPlacement &placement, const TranslatableString &dlogTitle, const TranslatableString &message, const ManualPageID &helpPage, const ErrorDialogOptions &options={})
	Show an error dialog with a link to the manual for further help. More...

MessageBoxResult	ShowMessageBox (const TranslatableString &message, MessageBoxOptions options={})
	Show a modal message box with either Ok or Yes and No, and optionally Cancel. More...

std::unique_ptr< ProgressDialog >	MakeProgress (const TranslatableString &title, const TranslatableString &message, unsigned flags=(ProgressShowStop\|ProgressShowCancel), const TranslatableString &remainingLabelText={})
	Create and display a progress dialog. More...

std::unique_ptr< GenericProgressDialog >	MakeGenericProgress (const WindowPlacement &placement, const TranslatableString &title, const TranslatableString &message, int style=(ProgressAppModal\|ProgressShowElapsedTime\|ProgressSmooth))
	Create and display a progress dialog (return nullptr if Services not installed) More...

template<typename ItType , typename FnType >
void	SplitProgress (ItType first, ItType last, FnType action, ProgressReporter parent)
	Helper for the update of a task's progress bar when this task is made of a range's subtasks. More...

int	ShowMultiDialog (const TranslatableString &message, const TranslatableString &title, const TranslatableStrings &buttons, const ManualPageID &helpPage, const TranslatableString &boxMsg, bool log)
	Display a dialog with radio buttons. More...

std::unique_ptr< WindowPlacement >	FindFocus ()
	Find the window that is accepting keyboard input, if any. More...

void	SetFocus (const WindowPlacement &focus)
	Set the window that accepts keyboard input. More...

bool	IsUsingRtlLayout ()
	Whether using a right-to-left language layout. More...

bool	IsUiThread ()
	Whether the current thread is the UI thread. More...

Variables
static Services *	theInstance = nullptr

static std::recursive_mutex	sActionsMutex

static std::vector< Action >	sActions

Types used in the Services interface
enum class	ErrorDialogType { ModelessError , ModalError , ModalErrorReport }

enum class	Icon { None , Warning , Error , Question , Information }

enum class	Button { Default , Ok , YesNo }

enum class	MessageBoxResult : int { None , Yes , No , Ok , Cancel }

enum	ProgressDialogOptions : unsigned { ProgressShowStop = (1 << 0) , ProgressShowCancel = (1 << 1) , ProgressHideTime = (1 << 2) , ProgressConfirmStopOrCancel = (1 << 3) }

enum	GenericProgressDialogStyle : int { ProgressCanAbort = (1 << 0) , ProgressAppModal = (1 << 1) , ProgressShowElapsedTime = (1 << 2) , ProgressSmooth = (1 << 3) }

enum class	ProgressResult : unsigned { Cancelled = 0 , Success , Failed , Stopped }

using	Action = std::function< void()>

using	ProgressReporter = std::function< void(double)>

TranslatableString	DefaultCaption ()
	"Message", suitably translated More...

Typedef Documentation

◆ Action

using BasicUI::Action = typedef std::function<void()>

Definition at line 24 of file BasicUI.h.

◆ ProgressReporter

using BasicUI::ProgressReporter = typedef std::function<void(double)>

Definition at line 25 of file BasicUI.h.

Enumeration Type Documentation

◆ Button

enum class BasicUI::Button

strong

Enumerator
Default	Like Ok, except maybe minor difference of dialog position.
Ok	One button.
YesNo	Two buttons.

Definition at line 88 of file BasicUI.h.

                  {
   Default, 
   Ok,      
   YesNo    
};

◆ ErrorDialogType

enum class BasicUI::ErrorDialogType

strong

Enumerator
ModelessError
ModalError
ModalErrorReport	If error reporting is enabled, may give option to send; if not, then like ModalError

Definition at line 43 of file BasicUI.h.

                           {
   ModelessError,
   ModalError,
   ModalErrorReport, 
};

◆ GenericProgressDialogStyle

enum BasicUI::GenericProgressDialogStyle : int

Enumerator
ProgressCanAbort
ProgressAppModal
ProgressShowElapsedTime
ProgressSmooth

Definition at line 147 of file BasicUI.h.

                                : int {
   ProgressCanAbort            = (1 << 0),
   ProgressAppModal            = (1 << 1),
   ProgressShowElapsedTime     = (1 << 2),
   ProgressSmooth              = (1 << 3),
};

◆ Icon

enum class BasicUI::Icon

strong

Enumerator
None
Warning
Error
Question
Information

Definition at line 80 of file BasicUI.h.

                {
   None,
   Warning,
   Error,
   Question,
   Information,
};

◆ MessageBoxResult

enum class BasicUI::MessageBoxResult : int

strong

Enumerator
None	May be returned if no Services are installed.
Yes
No
Ok
Cancel

Definition at line 132 of file BasicUI.h.

                            : int {
   None, 
   Yes,
   No,
   Ok,
   Cancel,
};

◆ ProgressDialogOptions

enum BasicUI::ProgressDialogOptions : unsigned

Enumerator
ProgressShowStop
ProgressShowCancel
ProgressHideTime
ProgressConfirmStopOrCancel

Definition at line 140 of file BasicUI.h.

                           : unsigned {
   ProgressShowStop            = (1 << 0),
   ProgressShowCancel          = (1 << 1),
   ProgressHideTime            = (1 << 2),
   ProgressConfirmStopOrCancel = (1 << 3),
};

◆ ProgressResult

enum class BasicUI::ProgressResult : unsigned

strong

Enumerator
Cancelled
Success
Failed
Stopped

Definition at line 154 of file BasicUI.h.

{
   Cancelled = 0, //<! User says that whatever is happening is undesirable and shouldn't have happened at all
   Success,       //<! User says nothing, everything works fine, continue doing whatever we're doing
   Failed,        //<! Something has gone wrong, we should stop and cancel everything we did
   Stopped        //<! Nothing is wrong, but user says we should stop now and leave things as they are now
};

Function Documentation

◆ CallAfter()

BASIC_UI_API void BasicUI::CallAfter ( Action action )

Schedule an action to be done later, and in the main thread.

This function may be called in other threads than the main. If no Services are yet installed, the action is not lost, but may be dispatched by Yield(). The action may itself invoke CallAfter to enqueue other actions.

Definition at line 214 of file BasicUI.cpp.

{
   if (auto p = Get())
      p->DoCallAfter(action);
   else {
      // No services yet -- but don't lose the action.  Put it in a queue
      auto guard = std::lock_guard{ sActionsMutex };
      sActions.emplace_back(std::move(action));
   }
}

References Get(), sActions, and sActionsMutex.

Here is the call graph for this function:

◆ DefaultCaption()

BASIC_UI_API TranslatableString BasicUI::DefaultCaption ( )

"Message", suitably translated

Definition at line 259 of file BasicUI.cpp.

{
   return XO("Message");
}

References XO().

Referenced by MessageBoxException::DelayedHandlerAction().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ FindFocus()

std::unique_ptr< WindowPlacement > BasicUI::FindFocus ( )

inline

Find the window that is accepting keyboard input, if any.

Postcondition: result: result != nullptr (but may point to an empty WindowPlacement)

Definition at line 383 of file BasicUI.h.

{
   if (auto p = Get())
      if (auto result = p->DoFindFocus())
         return result;
   return std::make_unique<WindowPlacement>();
}

References Get().

Referenced by TagsEditorDialog::DoCancel(), wxWidgetsBasicUI::DoFindFocus(), anonymous_namespace{TrackPanel.cpp}::LabeledChannelGroup::Draw(), EffectPreview(), DeviceToolBar::EnableDisableButtons(), TrackPanelAx::EndChangeFocus(), EventMonitor::FilterEvent(), MenuCreator::FilterKeyEvent(), EventMonitor::HandleCapture(), ProgressDialog::Init(), ProjectWindow::MacShowUndockedToolbars(), TrackPanelAx::MessageForScreenReader(), anonymous_namespace{NavigationMenus.cpp}::NextOrPrevFrame(), NyqBench::OnAutoWrap(), DeviceToolBar::OnCaptureKey(), SelectionBar::OnCaptureKey(), TranscriptionToolBar::OnCaptureKey(), RealtimeEffectPanel::OnCharHook(), NyqBench::OnClear(), NyqBench::OnClearUpdate(), NyqBench::OnCopy(), NyqBench::OnCopyUpdate(), NyqBench::OnCut(), NyqBench::OnCutUpdate(), KeyView::OnDrawBackground(), KeyView::OnDrawItem(), RealtimeEffectListWindow::OnEffectListItemChange(), ToolBarResizer::OnEnter(), NyqBench::OnFind(), NyqBench::OnFont(), EffectUIHost::OnInitDialog(), NavigationActions::Handler::OnNextWindow(), NyqBench::OnOutputUpdate(), NumericTextCtrl::OnPaint(), NyqBench::OnPaste(), NyqBench::OnPasteUpdate(), NavigationActions::Handler::OnPrevWindow(), NyqBench::OnRedo(), NyqBench::OnRedoUpdate(), LabelDialog::OnRemove(), NyqBench::OnScriptUpdate(), NyqBench::OnSelectAll(), NyqBench::OnUndo(), NyqBench::OnUndoUpdate(), SelectionBar::OnUpdate(), SpectralSelectionBar::OnUpdate(), MenuCreator::RebuildMenuBar(), FrequencyPlotDialog::Recalc(), LabelTrackView::ShowContextMenu(), TrackPanelHasFocus(), HistoryDialog::UpdateLevels(), and wxTabTraversalWrapperCharHook().

Here is the call graph for this function:

◆ Get()

BASIC_UI_API Services * BasicUI::Get ( )

Fetch the global instance, or nullptr if none is yet installed.

Definition at line 202 of file BasicUI.cpp.

202{ return theInstance; }

BasicUI::theInstance

static Services * theInstance

Definition: BasicUI.cpp:200

References theInstance.

◆ Install()

BASIC_UI_API Services * BasicUI::Install ( Services * pInstance )

Install an implementation; return the previously installed instance.

Definition at line 204 of file BasicUI.cpp.

{
   auto result = theInstance;
   theInstance = pInstance;
   return result;
}

References theInstance.

Referenced by AudacityApp::OnInit0().

Here is the caller graph for this function:

◆ IsUiThread()

bool BasicUI::IsUiThread ( )

inline

Whether the current thread is the UI thread.

Definition at line 407 of file BasicUI.h.

{
   if (auto p = Get())
      return p->IsUiThread();
   return true;
}

References Get().

Referenced by audacity::cloud::audiocom::sync::ProjectCloudExtension::Publish(), and audacity::cloud::audiocom::sync::MixdownUploader::ReportProgress().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ IsUsingRtlLayout()

bool BasicUI::IsUsingRtlLayout ( )

inline

Whether using a right-to-left language layout.

Definition at line 399 of file BasicUI.h.

{
   if (auto p = Get())
      return p->IsUsingRtlLayout();
   return false;
}

References Get().

Referenced by CommandManager::DescribeCommandsAndShortcuts().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ MakeGenericProgress()

std::unique_ptr< GenericProgressDialog > BasicUI::MakeGenericProgress	(	const WindowPlacement &	placement,
		const TranslatableString &	title,
		const TranslatableString &	message,
		int	style = `(ProgressAppModal \| ProgressShowElapsedTime \| ProgressSmooth)`
	)

inline

Create and display a progress dialog (return nullptr if Services not installed)

This function makes a "generic" progress dialog, for the case when time to completion cannot be estimated, but some indication of progress is still given

Definition at line 320 of file BasicUI.h.

{
   if (auto p = Get())
      return p->DoMakeGenericProgress(placement, title, message, style);
   else
      return nullptr;
}

References Get(), anonymous_namespace{AudacityDontAskAgainMessageDialog.cpp}::style, and title.

Referenced by DBConnection::Close(), Importer::Import(), audacity::cloud::audiocom::sync::ProjectsListDialog::ProjectsTableData::Refresh(), ProjectFileIO::RenameOrWarn(), and ProjectFileIO::SaveProject().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ MakeProgress()

std::unique_ptr< ProgressDialog > BasicUI::MakeProgress	(	const TranslatableString &	title,
		const TranslatableString &	message,
		unsigned	flags = `(ProgressShowStop \| ProgressShowCancel)`,
		const TranslatableString &	remainingLabelText = `{}`
	)

inline

Create and display a progress dialog.

Parameters

flags	bitwise OR of values in ProgressDialogOptions
remainingLabelText	if not empty substitutes for "Remaining Time:"

Returns: nullptr if Services not installed

Definition at line 302 of file BasicUI.h.

                                                   {})
{
   if (auto p = Get())
      return p->DoMakeProgress(title, message, flags, remainingLabelText);
   else
      return nullptr;
}

Referenced by audacity::cloud::audiocom::sync::ProjectCloudUIExtension::AllowClosing(), ProjectFileIO::CopyTo(), EffectBase::DoEffect(), EffectPreview(), UpdateManager::GetUpdates(), audacity::cloud::audiocom::sync::anonymous_namespace{CloudProjectOpenUtils.cpp}::MakeProgress(), MixAndRender(), anonymous_namespace{EditMenus.cpp}::NotificationScope(), SqliteSampleBlockFactory::OnBeginPurge(), anonymous_namespace{ProjectFileManager.cpp}::ImportProgress::OnImportProgress(), anonymous_namespace{TrackMenus.cpp}::OnResample(), anonymous_namespace{ProjectFileManager.cpp}::RunTempoDetection(), anonymous_namespace{ExportProgressUI.cpp}::DialogExportProgressDelegate::UpdateUI(), audacity::cloud::audiocom::sync::UploadMixdown(), and UserException::WithCancellableProgress().

Here is the caller graph for this function:

◆ OpenInDefaultBrowser()

BASIC_UI_API bool BasicUI::OpenInDefaultBrowser ( const wxString & url )

Open an URL in default browser.

This function may be called in other threads than the main.

Definition at line 246 of file BasicUI.cpp.

{
#if defined(HAS_XDG_OPEN_HELPER)
   if (RunXDGOpen(url.ToStdString()))
      return true;
#endif
 
   if(auto p = Get())
      return p->DoOpenInDefaultBrowser(url);
 
   return false;
}

References Get().

Referenced by LoginDialog::ContinueAuthorize(), anonymous_namespace{PluginMenus.cpp}::EffectMenu(), audacity::cloud::audiocom::ShareAudioDialog::HandleUploadSucceeded(), RealtimeEffectPanel::MakeTrackEffectPane(), audacity::cloud::audiocom::sync::ProjectCloudUIExtension::OnCloudStatusChanged(), PluginRegistrationDialog::OnGetMoreEffects(), audacity::cloud::audiocom::UserPanel::OnLinkButtonPressed(), audacity::cloud::audiocom::sync::ProjectsListDialog::OnOpen(), audacity::cloud::audiocom::sync::ProjectsListDialog::OnOpenAudioCom(), anonymous_namespace{CloudProjectFileIOExtensions.cpp}::IOExtension::OnUpdateSaved(), OpenInDefaultBrowser(), anonymous_namespace{RealtimeEffectPanel.cpp}::EffectsMenuHelper::PickEffect(), and AudacityFileConfig::Warn().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ SetFocus()

void BasicUI::SetFocus ( const WindowPlacement & focus )

inline

Set the window that accepts keyboard input.

Definition at line 392 of file BasicUI.h.

{
   if (auto p = Get())
      p->DoSetFocus(focus);
}

References Get().

Referenced by EffectPreview(), NumericTextCtrl::OnContext(), KeyView::OnLeftDown(), NumericTextCtrl::OnMouse(), TrackPanel::OnTrackFocusChange(), wxSliderWrapper::SetFocus(), ListNavigationEnabled< WindowBase >::SetFocus(), PitchAndSpeedDialog::SetFocus(), AdornedRulerPanel::SetFocusFromKbd(), AButton::SetFocusFromKbd(), ASlider::SetFocusFromKbd(), MeterPanel::SetFocusFromKbd(), and UpdateNoticeDialog::UpdateNoticeDialog().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ ShowErrorDialog()

void BasicUI::ShowErrorDialog	(	const WindowPlacement &	placement,
		const TranslatableString &	dlogTitle,
		const TranslatableString &	message,
		const ManualPageID &	helpPage,
		const ErrorDialogOptions &	options = `{}`
	)

inline

Show an error dialog with a link to the manual for further help.

Parameters

placement	how to parent the dialog
dlogTitle	Text for title bar
message	The main message text
helpPage	Identifies manual page (and maybe an anchor)

Definition at line 272 of file BasicUI.h.

                                       {})
{
   if (auto p = Get())
      p->DoShowErrorDialog(placement, dlogTitle, message, helpPage, options);
}

Referenced by MessageBoxException::DelayedHandlerAction(), ProjectFileManager::DoImport(), ProjectAudioManager::DoRecord(), ClipPitchAndSpeedButtonHandle::DoRelease(), ProjectFileManager::DoSave(), EffectPreview(), TempDirectory::FATFilesystemDenied(), UpdateManager::GetUpdates(), audacity::cloud::audiocom::ShareAudioDialog::HandleExportFailure(), audacity::cloud::audiocom::ShareAudioDialog::HandleUploadFailed(), anonymous_namespace{TransportMenus.cpp}::OnPunchAndRoll(), ProjectAudioManager::PlayPlayRegion(), ProjectFileIO::ProjectFileIO(), audacity::cloud::audiocom::sync::ProjectsListDialog::ProjectsTableData::Refresh(), ProjectFileManager::SaveCopy(), ExportProgressUI::Show(), ShowDiskFullExportErrorDialog(), ProjectFileIO::ShowError(), ShowExportErrorDialog(), AudioIO::StartMonitoring(), CommandManager::TellUserWhyDisallowed(), and TempDirectory::TempDir().

Here is the caller graph for this function:

◆ ShowMessageBox()

MessageBoxResult BasicUI::ShowMessageBox	(	const TranslatableString &	message,
		MessageBoxOptions	options = `{}`
	)

inline

Show a modal message box with either Ok or Yes and No, and optionally Cancel.

Returns: indicates which button was pressed

Definition at line 287 of file BasicUI.h.

                               {})
{
   if (auto p = Get())
      return p->DoMessageBox(message, std::move(options));
   else
      return MessageBoxResult::None;
}

Referenced by AudioIO::AllocateBuffers(), AudioIO::AudioIO(), anonymous_namespace{Registry.cpp}::BadPath(), ExportMP3::CheckFileName(), CreateDirectory(), ThemeBase::CreateImageCache(), ThemeBase::CreateOneImageCache(), anonymous_namespace{LoginDialog.cpp}::DefaultErrorHandler(), MessageBoxException::DelayedHandlerAction(), AudacityApplicationLogic::DoEffect(), DoMessageBox(), PluginManager::DropFile(), ExportProgressUI::ExceptionWrappedCall(), Journal::Events::FailedEventSerialization(), EffectAndCommandPluginManager::GetAudacityCommand(), PlotSpectrumBase::GetAudio(), ContrastBase::GetDB(), gtk_filedialog_ok_callback(), audacity::cloud::audiocom::sync::MixdownUploader::DataExporter::HandleUnkonwnException(), VSTWrapper::HandleXMLTag(), LabelTrack::Import(), AutoDuckBase::Init(), EqualizationBase::Init(), ScienFilterBase::Init(), NyquistBase::Init(), ExportOptionsCLEditor::IsValidCommand(), EQCurveReader::LoadCurves(), VSTWrapper::LoadFXB(), VSTWrapper::LoadFXP(), MP3Exporter::LoadLibrary(), ThemeBase::LoadOneThemeComponents(), Effect::LoadSettingsFromString(), VSTWrapper::LoadXML(), anonymous_namespace{MIDIPlay.h}::MIDIPlay::MIDIPlay(), RealtimeEffectListWindow::OnAddEffectClicked(), WaveTrackMenuTable::OnMergeStereo(), SelectActions::Handler::OnZeroCrossing(), SFFileCloser::operator()(), NyquistBase::ParseProgram(), ClickRemovalBase::Process(), Generator::Process(), NoiseReductionBase::Process(), Repair::Process(), NyquistBase::Process(), NoiseReductionBase::Worker::Process(), TruncSilenceBase::ProcessIndependently(), DtmfBase::Instance::ProcessInitialize(), EchoBase::Instance::ProcessInitialize(), PaulstretchBase::ProcessOne(), ClickRemovalBase::ProcessOne(), FindClippingBase::ProcessOne(), NyquistBase::ProcessOne(), ThemeBase::ReadImageCache(), ProjectFileManager::ReadProjectFile(), VSTWrapper::SaveFXB(), VSTWrapper::SaveFXP(), EqualizationCurvesList::setCurve(), ImportUtils::ShowMessageBox(), AudioIO::StartStream(), MessageBoxTarget::Update(), SpectrogramSettings::Validate(), NoiseReductionBase::Settings::Validate(), and Sequence::WriteXML().

◆ ShowMultiDialog()

int BasicUI::ShowMultiDialog	(	const TranslatableString &	message,
		const TranslatableString &	title,
		const TranslatableStrings &	buttons,
		const ManualPageID &	helpPage,
		const TranslatableString &	boxMsg,
		bool	log
	)

inline

Display a dialog with radio buttons.

Returns: zero-based index of the chosen button, or -1 if Services not installed.

Parameters

message	main message in the dialog
title	dialog title
buttons	labels for individual radio buttons
boxMsg	label for the group of buttons
helpPage	identifies a manual page
log	whether to add a "Show Log for Details" push button

Definition at line 367 of file BasicUI.h.

{
   if (auto p = Get())
      return p->DoMultiDialog(message, title, buttons, helpPage, boxMsg, log);
   else
      return -1;
}

References Get(), and title.

Referenced by wxWidgetsBasicUI::DoMultiDialog(), ProjectFSCK(), and ModuleManager::TryLoadModules().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ SplitProgress()

template<typename ItType , typename FnType >

void BasicUI::SplitProgress	(	ItType	first,
		ItType	last,
		FnType	action,
		ProgressReporter	parent
	)

Helper for the update of a task's progress bar when this task is made of a range's subtasks.

For each item from first till last, forwards the item as argument to action, as well as a progress reporter that will contribute by a fraction to the parent progress reporter. This fraction is the inverse of the number of elements in the range.

Definition at line 339 of file BasicUI.h.

{
   auto count = 0;
   const auto numIters = std::distance(first, last);
   if (numIters == 0)
      return;
   const ProgressReporter child =
      parent ? [&](double progress) { parent((count + progress) / numIters); } :
               ProgressReporter {};
 
   for (; first != last; ++first)
   {
      action(*first, child);
      ++count;
   }
}

Referenced by anonymous_namespace{LabelMenus.cpp}::EditByLabel(), EffectOutputTracks::EffectOutputTracks(), anonymous_namespace{EditMenus.cpp}::OnJoin(), and anonymous_namespace{EditMenus.cpp}::OnSilence().

Here is the caller graph for this function:

◆ Yield()

BASIC_UI_API void BasicUI::Yield ( )

Dispatch waiting events, including actions enqueued by CallAfter.

This function must be called by the main thread. Actions enqueued by CallAfter before Services were installed will be dispatched in the sequence they were enqueued, unless an exception thrown by one of them stops the dispatching.

Definition at line 225 of file BasicUI.cpp.

{
   do {
      // Dispatch anything in the queue, added while there were no Services
      {
         auto guard = std::lock_guard{ sActionsMutex };
         std::vector<Action> actions;
         actions.swap(sActions);
         for (auto &action : actions)
            action();
      }
 
      // Dispatch according to Services, if present
      if (auto p = Get())
         p->DoYield();
   }
   // Re-test for more actions that might have been enqueued by actions just
   // dispatched
   while ( !sActions.empty() );
}

References Get(), sActions, and sActionsMutex.

Referenced by audacity::cloud::audiocom::sync::ProjectCloudUIExtension::AllowClosing(), EVT_COMMAND_RANGE(), audacity::cloud::audiocom::sync::anonymous_namespace{CloudProjectOpenUtils.cpp}::GetResult(), Importer::Import(), Viewport::OnScroll(), CLExportProcessor::Process(), audacity::cloud::audiocom::sync::ProjectsListDialog::ProjectsTableData::Refresh(), audacity::cloud::audiocom::ShareAudioDialog::ResetProgress(), and audacity::cloud::audiocom::sync::UploadMixdown().

Here is the call graph for this function:

Here is the caller graph for this function:

Variable Documentation

◆ sActions

std::vector<Action> BasicUI::sActions

static

Definition at line 212 of file BasicUI.cpp.

Referenced by CallAfter(), and Yield().

◆ sActionsMutex

std::recursive_mutex BasicUI::sActionsMutex

static

Definition at line 211 of file BasicUI.cpp.

Referenced by CallAfter(), and Yield().

◆ theInstance

Services* BasicUI::theInstance = nullptr

static

Definition at line 200 of file BasicUI.cpp.

Referenced by Get(), and Install().

Classes

Functions

Variables

Types used in the Services interface

Typedef Documentation

◆ Action

◆ ProgressReporter

Enumeration Type Documentation

◆ Button

◆ ErrorDialogType

◆ GenericProgressDialogStyle

◆ Icon

◆ MessageBoxResult

◆ ProgressDialogOptions

◆ ProgressResult

Function Documentation

◆ CallAfter()

◆ DefaultCaption()

◆ FindFocus()

◆ Get()

◆ Install()

◆ IsUiThread()

◆ IsUsingRtlLayout()

◆ MakeGenericProgress()

◆ MakeProgress()

◆ OpenInDefaultBrowser()

◆ SetFocus()

◆ ShowErrorDialog()

◆ ShowMessageBox()

◆ ShowMultiDialog()

◆ SplitProgress()

◆ Yield()

Variable Documentation

◆ sActions

◆ sActionsMutex

◆ theInstance