Libraries.Interface.Behaviors.CancelBehavior Documentation

This class represents a behavior. It wipes out all behaviors on the Item. If you need to cancel only some behaviors, while allowing others to persist, use an alternative.

Inherits from: Libraries.Language.Object, Libraries.Interface.Behaviors.Behavior

Actions Documentation

Compare(Libraries.Language.Object object)

This action compares two object hash codes and returns an integer. The result is larger if this hash code is larger than the object passed as a parameter, smaller, or equal. In this case, -1 means smaller, 0 means equal, and 1 means larger. This action was changed in Quorum 7 to return an integer, instead of a CompareResult object, because the previous implementation was causing efficiency issues.

Parameters

Return

integer: The Compare result, Smaller, Equal, or Larger.

Example

Object o
Object t
integer result = o:Compare(t) //1 (larger), 0 (equal), or -1 (smaller)

Dispose()

Dispose does nothing by default, but can be overridden to conduct cleanup actions when a behavior is finished. Note that, as discussed in the comment for the Update action, Dispose is only called if the behavior is added through AddBehavior, not if its set as a default Behavior on an interface element (e.g., a Button’s default clicking behavior).

Equals(Libraries.Language.Object object)

This action determines if two objects are equal based on their hash code values.

Parameters

Return

boolean: True if the hash codes are equal and false if they are not equal.

Example

use Libraries.Language.Object
use Libraries.Language.Types.Text
Object o
Text t
boolean result = o:Equals(t)

GetHashCode()

This action gets the hash code for an object.

Return

integer: The integer hash code of the object.

Example

Object o
integer hash = o:GetHashCode()

HasBeenRun()

This action returns true if the Behavior has been run by a current item that it has been added to. This is an internal flag used by the engine, and most users will never need this functionality.

Return

boolean:

IsFinished()

This action states if a behavior has completed its work.

Return

boolean:

IsRunningOnUpdate()

The IsRunningOnUpdate action returns true if this Behavior calls its Run action during the Game's update loop, and returns false if the Behavior calls its Run action immediately upon being added to an Item. The default value is false.

Return

boolean:

Run(Libraries.Interface.Events.BehaviorEvent event)

Parameters

SetHasRunFlag(boolean hasRun)

This action sets a flag indicating if the Behavior has been run by the current Item this Behavior has been added to. This is used internally by the engine, and most users should never need this functionality.

Parameters

  • boolean hasRun

SetRunOnUpdate(boolean run)

The SetRunOnUpdate action determines when a behavior should be first run when the behavior is added to an Item. If the value is false, then the Behavior's Run action will be called immediately when it is added to an Item. If it is true, it will be called during the next update loop.

Parameters

  • boolean run

Update(number seconds)

Behaviors can optionally be set to Update on every frame of a running program, depending on context. By default, however, not all behaviors do this. For example, in a button, Update is never called on its default behavior, just Run. In contrast, if you call AddBehavior on an item, Update would be called on every frame.

Parameters

  • number seconds