CommandDispatch Namespace Reference

Functions
AUDACITY_DLL_API bool	HandleTextualCommand (const CommandID &Str, const CommandContext &context, CommandFlag flags, bool alwaysEnabled)
AUDACITY_DLL_API bool	DoAudacityCommand (const PluginID &ID, const CommandContext &context, unsigned flags)
AUDACITY_DLL_API void	OnAudacityCommand (const CommandContext &ctx)

Function Documentation

DoAudacityCommand()

bool CommandDispatch::DoAudacityCommand	(	const PluginID &	ID,
		const CommandContext &	context,
		unsigned	flags
	)

DoAudacityCommand() takes a PluginID and executes the associated command.

At the moment flags are used only to indicate whether to prompt for parameters

Definition at line 60 of file CommandDispatch.cpp.

{
   auto &project = context.project;
   const PluginDescriptor *plug = PluginManager::Get().GetPlugin(ID);
   if (!plug)
      return false;
 
   if (flags & EffectManager::kConfigured)
   {
      ProjectAudioManager::Get( project ).Stop();
//    SelectAllIfNone();
   }
 
   bool success = EffectAndCommandPluginManager::Get().DoAudacityCommand(ID,
      context,
      (flags & EffectManager::kConfigured) == 0);
 
   if (!success)
      return false;
 
/*
   if (em.GetSkipStateFlag())
      flags = flags | OnEffectFlags::kSkipState;
 
   if (!(flags & OnEffectFlags::kSkipState))
   {
      wxString shortDesc = em.GetCommandName(ID);
      wxString longDesc = em.GetCommandDescription(ID);
      PushState(longDesc, shortDesc);
   }
*/
   Viewport::Get(project).Redraw();
   return true;
}

References EffectAndCommandPluginManager::DoAudacityCommand(), PluginManager::Get(), EffectAndCommandPluginManager::Get(), Viewport::Get(), ProjectAudioManager::Get(), PluginManager::GetPlugin(), EffectManager::kConfigured, CommandContext::project, project, Viewport::Redraw(), and ProjectAudioManager::Stop().

Referenced by MacroCommands::ApplyEffectCommand(), and OnAudacityCommand().

Here is the call graph for this function:

Here is the caller graph for this function:

HandleTextualCommand()

bool CommandDispatch::HandleTextualCommand	(	const CommandID &	Str,
		const CommandContext &	context,
		CommandFlag	flags,
		bool	alwaysEnabled
	)

Definition at line 28 of file CommandDispatch.cpp.

{
   auto &commandManager = CommandManager::Get(context.project);
   switch ( commandManager.HandleTextualCommand(
      Str, context, flags, alwaysEnabled) ) {
   case CommandManager::CommandSuccess:
      return true;
   case CommandManager::CommandFailure:
      return false;
   case CommandManager::CommandNotFound:
   default:
      break;
   }
 
   // Not one of the singleton commands.
   // We could/should try all the list-style commands.
   // instead we only try the effects.
   auto& pm = PluginManager::Get();
   for (auto &plug : PluginManager::Get().PluginsOfType(PluginTypeEffect))
      if (pm.GetCommandIdentifier(plug.GetID()) == Str)
         return EffectUI::DoEffect(
            plug.GetID(), context.project, EffectManager::kConfigured);
 
   return false;
}

References CommandManager::CommandFailure, CommandManager::CommandNotFound, CommandManager::CommandSuccess, EffectUI::DoEffect(), PluginManager::Get(), CommandManager::Get(), EffectManager::kConfigured, PluginTypeEffect, and CommandContext::project.

Referenced by MacroCommands::ApplyCommand(), and ToolBarButtons::OnButton().

Here is the call graph for this function:

Here is the caller graph for this function:

OnAudacityCommand()

void CommandDispatch::OnAudacityCommand

(

const CommandContext &

ctx

)

Definition at line 96 of file CommandDispatch.cpp.

{
   // using GET in a log message for devs' eyes only
   wxLogDebug( "Command was: %s", ctx.parameter.GET());
   // Not configured, so prompt user.
   CommandDispatch::DoAudacityCommand(
      PluginManager::Get().GetByCommandIdentifier(ctx.parameter), ctx,
      EffectManager::kNone);
}

References DoAudacityCommand(), PluginManager::Get(), Identifier::GET(), EffectManager::kNone, and CommandContext::parameter.

Here is the call graph for this function: