Libraries.Interface.Behaviors.Controls.SpreadsheetCopyBehavior Documentation

This class is a default behavior that adds copy support into the spreadsheet. Broadly, while it can be used as a template for such a behavior, there is generally no reason to interact with this class.

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

Summary

Actions Summary Table

ActionsDescription
Compare(Libraries.Language.Object object)This action compares two object hash codes and returns an integer.
Dispose()Dispose does nothing by default, but can be overridden to conduct cleanup actions when a behavior is finished.
Equals(Libraries.Language.Object object)This action determines if two objects are equal based on their hash code values.
GetHashCode()This action gets the hash code for an object.
HasBeenRun()This action returns true if the Behavior has been run by a current item that it has been added to.
IsFinished()This action states if a behavior has completed its work.
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.
Run(Libraries.Interface.Events.BehaviorEvent event)
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.
SetRunOnUpdate(boolean run)The SetRunOnUpdate action determines when a behavior should be first run when the behavior is added to an Item.
Update(number seconds)Behaviors can optionally be set to Update on every frame of a running program, depending on context.

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.

Example Code

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

Parameters

Return

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

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.

Example Code

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

Parameters

Return

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

GetHashCode()

This action gets the hash code for an object.

Example Code

Object o
        integer hash = o:GetHashCode()

Return

integer: The integer hash code of the object.

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

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

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