getEventHandlerInfo: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
No edit summary
m (Some wiki formatting)
Line 7: Line 7:
|gr1= Event Handlers
|gr1= Event Handlers


|descr= Queries given event handler and returns [[Array]] in format [exists, isLast, total] or empty array [], where:
|descr= Queries given event handler's information.
* exists: [[Boolean]] - event handler exists
* isLast: [[Boolean]] - will be executed last (relevant if last event handler modifies default engine behaviour)
* total: [[Number]] - total number of event handlers added to the same event
 


|s1= entity [[getEventHandlerInfo]] [type, id]
|s1= entity [[getEventHandlerInfo]] [type, id]


|p1= entity: [[Object]], [[Group]], [[Control]], [[Display]] - entity to which event handler is assigned
|p1= entity: [[Object]], [[Group]], [[Control]] or [[Display]] - entity to which event handler is assigned


|p2= type: [[String]] - event handler name
|p2= type: [[String]] - event handler name


|p3= id: [[Number]] - event handler id returned by [[addEventHandler]], [[ctrlAddEventHandler]], [[displayAddEventHandler]], or [[addMPEventHandler]]
|p3= id: [[Number]] - event handler id returned by [[addEventHandler]], [[ctrlAddEventHandler]], [[displayAddEventHandler]], or [[addMPEventHandler]]
 
|r1= [[Array]] - see description


|r1= [[Array]] in format [exists, isLast, total] or empty array [], where:
* exists: [[Boolean]] - event handler exists
* isLast: [[Boolean]] - will be executed last (relevant if last event handler modifies default engine behaviour)
* total: [[Number]] - total number of event handlers added to the same event


|s2= [[getEventHandlerInfo]] [type, id]
|s2= [[getEventHandlerInfo]] [type, id]
Line 28: Line 26:
|p21= type: [[String]] - event handler name
|p21= type: [[String]] - event handler name


|p22= id: [[Number]] - event handler id returned by [[addMissionEventHandler]] or [[addMusicEventHandler]]
|p22= id: [[Number]] - event handler id returned by [[addMissionEventHandler]] or [[addMusicEventHandler]]
 
|r2= [[Array]] in format [exists, isLast, total] or empty array [], where:
* exists: [[Boolean]] - event handler exists
* isLast: [[Boolean]] - will be executed last (relevant if last event handler modifies default engine behaviour)
* total: [[Number]] - total number of event handlers added to the same event


|r2= [[Array]] - see description
|x1= <sqf>private _info = player getEventHandlerInfo ["MPKilled", 1];</sqf>


|x1= <sqf>_info = player getEventHandlerInfo ["MPKilled", 1];</sqf>
|x2= <sqf>private _info = getEventHandlerInfo ["EachFrame", 0];</sqf>
|x2= <sqf>_info = getEventHandlerInfo ["EachFrame", 0];</sqf>


|seealso= [[addEventHandler]] [[ctrlAddEventHandler]] [[displayAddEventHandler]] [[addMPEventHandler]]
|seealso= [[addEventHandler]] [[ctrlAddEventHandler]] [[displayAddEventHandler]] [[addMPEventHandler]] [[addMissionEventHandler]] [[addMusicEventHandler]]
[[addMissionEventHandler]] [[addMusicEventHandler]]
}}
}}

Revision as of 19:17, 18 July 2022

Hover & click on the images for description
Only available in Development branch(es) until its release with Arma 3 patch v2.10.

Description

Description:
Queries given event handler's information.
Groups:
Event Handlers

Syntax

Syntax:
entity getEventHandlerInfo [type, id]
Parameters:
entity: Object, Group, Control or Display - entity to which event handler is assigned
type: String - event handler name
id: Number - event handler id returned by addEventHandler, ctrlAddEventHandler, displayAddEventHandler, or addMPEventHandler
Return Value:
Array in format [exists, isLast, total] or empty array [], where:
  • exists: Boolean - event handler exists
  • isLast: Boolean - will be executed last (relevant if last event handler modifies default engine behaviour)
  • total: Number - total number of event handlers added to the same event

Alternative Syntax

Syntax:
getEventHandlerInfo [type, id]
Parameters:
type: String - event handler name
id: Number - event handler id returned by addMissionEventHandler or addMusicEventHandler
Return Value:
Array in format [exists, isLast, total] or empty array [], where:
  • exists: Boolean - event handler exists
  • isLast: Boolean - will be executed last (relevant if last event handler modifies default engine behaviour)
  • total: Number - total number of event handlers added to the same event

Examples

Example 1:
private _info = player getEventHandlerInfo ["MPKilled", 1];
Example 2:
private _info = getEventHandlerInfo ["EachFrame", 0];

Additional Information

See also:
addEventHandler ctrlAddEventHandler displayAddEventHandler addMPEventHandler addMissionEventHandler addMusicEventHandler

Notes

Report bugs on the Feedback Tracker and/or discuss them on the Arma Discord or on the Forums.
Only post proven facts here! Add Note