A command target publishes a list of command IDs that it can perform. More...
|Contains contextual details about the invocation of a command. More...|
|Creates a command target. More...|
|virtual ApplicationCommandTarget *||getNextCommandTarget ()=0|
|This must return the next target to try after this one. More...|
|virtual void||getAllCommands (Array< CommandID > &commands)=0|
|This must return a complete list of commands that this target can handle. More...|
|virtual void||getCommandInfo (CommandID commandID, ApplicationCommandInfo &result)=0|
|This must provide details about one of the commands that this target can perform. More...|
|virtual bool||perform (const InvocationInfo &info)=0|
|This must actually perform the specified command. More...|
|bool||invoke (const InvocationInfo &invocationInfo, const bool asynchronously)|
|Makes this target invoke a command. More...|
|bool||invokeDirectly (const CommandID commandID, const bool asynchronously)|
|Invokes a given command directly on this target. More...|
|ApplicationCommandTarget *||getTargetForCommand (const CommandID commandID)|
|Searches this target and all subsequent ones for the first one that can handle the specified command. More...|
|bool||isCommandActive (const CommandID commandID)|
|Checks whether this command can currently be performed by this target. More...|
|ApplicationCommandTarget *||findFirstTargetParentComponent ()|
|If this object is a Component, this method will search upwards in its current UI hierarchy for the next parent component that implements the ApplicationCommandTarget class. More...|
A command target publishes a list of command IDs that it can perform.
An ApplicationCommandManager despatches commands to targets, which must be able to provide information about what commands they can handle.
To create a target, you'll need to inherit from this class, implementing all of its pure virtual methods.
For info about how a target is chosen to receive a command, see ApplicationCommandManager::getFirstCommandTarget().
Constructor & Destructor Documentation
Creates a command target.
Member Function Documentation
This must return the next target to try after this one.
When a command is being sent, and the first target can't handle that command, this method is used to determine the next target that should be tried.
It may return nullptr if it doesn't know of another target.
- See also
This must provide details about one of the commands that this target can perform.
This will be called with one of the command IDs that the target provided in its getAllCommands() methods.
It should fill-in all appropriate fields of the ApplicationCommandInfo structure with suitable information about the command. (The commandID field will already have been filled-in by the caller).
The easiest way to set the info is using the ApplicationCommandInfo::setInfo() method to set all the fields at once.
If the command is currently inactive for some reason, this method must use ApplicationCommandInfo::setActive() to make that clear, (or it should set the isDisabled bit of the ApplicationCommandInfo::flags field).
Any default key-presses for the command should be appended to the ApplicationCommandInfo::defaultKeypresses field.
Note that if you change something that affects the status of the commands that would be returned by this method (e.g. something that makes some commands active or inactive), you should call ApplicationCommandManager::commandStatusChanged() to cause the manager to refresh its status.
This must actually perform the specified command.
If this target is able to perform the command specified by the commandID field of the InvocationInfo structure, then it should do so, and must return true.
If it can't handle this command, it should return false, which tells the caller to pass the command on to the next target in line.
|bool ApplicationCommandTarget::invoke||(||const InvocationInfo &||invocationInfo,|
Makes this target invoke a command.
If this target can perform the given command, it will call its perform() method to do so. If not, then getNextCommandTarget() will be used to determine the next target to try, and the command will be passed along to it.
invocationInfo this must be correctly filled-in, describing the context for the invocation. asynchronously if false, the command will be performed before this method returns. If true, a message will be posted so that the command will be performed later on the message thread, and this method will return immediately.
|bool ApplicationCommandTarget::invokeDirectly||(||const CommandID||commandID,|
|ApplicationCommandTarget* ApplicationCommandTarget::getTargetForCommand||(||const CommandID||commandID||)|
Searches this target and all subsequent ones for the first one that can handle the specified command.
This will use getNextCommandTarget() to determine the chain of targets to try after this one.
|bool ApplicationCommandTarget::isCommandActive||(||const CommandID||commandID||)|
Checks whether this command can currently be performed by this target.
This will return true only if a call to getCommandInfo() doesn't set the isDisabled flag to indicate that the command is inactive.
The documentation for this class was generated from the following file:
Generated on Fri Jan 12 2018 09:51:16 for JUCE by 1.8.13