JUCE
Public Types | Public Member Functions | Public Attributes | List of all members
ApplicationCommandTarget::InvocationInfo Struct Reference

Contains contextual details about the invocation of a command. More...

Public Types

enum  InvocationMethod { direct = 0, fromKeyPress, fromMenu, fromButton }
 The types of context in which the command might be called. More...
 

Public Member Functions

 InvocationInfo (const CommandID commandID)
 

Public Attributes

CommandID commandID
 The UID of the command that should be performed. More...
 
int commandFlags
 The command's flags. More...
 
InvocationMethod invocationMethod
 The type of event that triggered this command. More...
 
ComponentoriginatingComponent
 If triggered by a keypress or menu, this will be the component that had the keyboard focus at the time. More...
 
KeyPress keyPress
 The keypress that was used to invoke it. More...
 
bool isKeyDown
 True if the callback is being invoked when the key is pressed, false if the key is being released. More...
 
int millisecsSinceKeyPressed
 If the key is being released, this indicates how long it had been held down for. More...
 

Detailed Description

Contains contextual details about the invocation of a command.

Member Enumeration Documentation

◆ InvocationMethod

The types of context in which the command might be called.

Enumerator
direct 

The command is being invoked directly by a piece of code.

fromKeyPress 

The command is being invoked by a key-press.

fromMenu 

The command is being invoked by a menu selection.

fromButton 

The command is being invoked by a button click.

Constructor & Destructor Documentation

◆ InvocationInfo()

ApplicationCommandTarget::InvocationInfo::InvocationInfo ( const CommandID  commandID)

Member Data Documentation

◆ commandID

CommandID ApplicationCommandTarget::InvocationInfo::commandID

The UID of the command that should be performed.

◆ commandFlags

int ApplicationCommandTarget::InvocationInfo::commandFlags

The command's flags.

See ApplicationCommandInfo for a description of these flag values.

◆ invocationMethod

InvocationMethod ApplicationCommandTarget::InvocationInfo::invocationMethod

The type of event that triggered this command.

◆ originatingComponent

Component* ApplicationCommandTarget::InvocationInfo::originatingComponent

If triggered by a keypress or menu, this will be the component that had the keyboard focus at the time.

If triggered by a button, it may be set to that component, or it may be null.

◆ keyPress

KeyPress ApplicationCommandTarget::InvocationInfo::keyPress

The keypress that was used to invoke it.

Note that this will be an invalid keypress if the command was invoked by some other means than a keyboard shortcut.

◆ isKeyDown

bool ApplicationCommandTarget::InvocationInfo::isKeyDown

True if the callback is being invoked when the key is pressed, false if the key is being released.

See also
KeyPressMappingSet::addCommand()

◆ millisecsSinceKeyPressed

int ApplicationCommandTarget::InvocationInfo::millisecsSinceKeyPressed

If the key is being released, this indicates how long it had been held down for.

(Only relevant if isKeyDown is false.)


The documentation for this struct was generated from the following file: