Libraries.Interface.Controls.TextBox

Returns true if rendering the focus event.

Parameters

• Libraries.Interface.Events.BehaviorEvent

This action returns a default behavior for this paricular control. Some controls do nothing by default, like a TextBox that responds to different kinds of input. Others, however, have default behaviors, like a Button or a MenuItem. If there is no default behavior, this action returns undefined.

Parameters

• Libraries.Interface.Controls.Gutter

This action adds a different Item2D into this one, storing the added Item2D at a specific index in the internal array.

Parameters

• integer index
• Libraries.Interface.Item2D

This action adds a different Item2D into this one. This makes a few things happen. 1. The added item will get this item as its parent. 2. The added item's x and y coordinates will become relative to this Item. 3. Most actions on this Item will also affect the added Item.

Parameters

• Libraries.Interface.Item2D

This action adds a new Behavior to this Item.

Parameters

• Libraries.Interface.Behaviors.Behavior

This action removes an Item2D at a specifed index from the internal array.

Parameters

• Libraries.Interface.Events.ControlActivationListener

This action adds a FocusListener to the Item. When the Item receives a FocusEvent due to either gaining or losing the focus, the listener will be notified.

Parameters

• Libraries.Interface.Events.FocusListener

This action adds a GestureListener to the Item. If the Item ever receives a GestureEvent, the listener will be notified.

Parameters

• Libraries.Interface.Events.GestureListener

This flag tells the textbox to move the focus on a tab, as opposed to doing indentation. This thus directly turns off the indentation manager.

Parameters

• integer index

This flag tells the textbox to move the focus on a tab, as opposed to doing indentation. This thus directly turns off the indentation manager.

Returns true if rendering the mouse down event.

Parameters

• Libraries.Interface.Layouts.LayoutProperties

This action adds a MouseListener to the Item. If the Item ever receives a MouseEvent due to a mouse click, the mouse listener will be notified.

Parameters

• Libraries.Interface.Events.MouseListener

This action adds a MouseMovementListener to the Item. If the Item ever receives a MouseEvent due to mouse movement, the listener will be notified.

Parameters

• Libraries.Interface.Events.MouseMovementListener

This action adds a MouseWheelListener to the Item. If the Item ever receives a MouseEvent due to the mouse wheel being scrolled, the listener will be notified.

Parameters

• Libraries.Interface.Events.MouseWheelListener

This action adds the given SelectionListeners to the Control.

Parameters

• Libraries.Interface.Events.SelectionListener: the selectionListener to add to the control.

The MoveCaretUp action moves the caret one position upwards, as if the user had just pressed the up arrow key. If the provided boolean is true, the action will adjust the selection as the caret moves.

Parameters

• Libraries.Interface.Events.TextChangeListener

The GetDefaultLineSeparator action returns the default character(s) used by the TextBox to signify the end of a line of text. This is the same line separating characters that are used by the running operating system.

Parameters

• text name
• Libraries.Interface.Controls.TextStyles.TextStyle

This action adds a TouchListener to the Item. If the Item ever receives a TouchEvent, the listener will be notified.

Parameters

• Libraries.Interface.Events.TouchListener

This action is used to advance the item forward in time in physics space to synchronize it for time of impact solving. This action is used internally and users should not need to use this action. Attribute Parameter time The amount of seconds to advance the item forward in time

Parameters

• number time

The SetCaretPosition action places the caret at the requested global index within the text of the TextBox. Note that if the index requested would be in the middle of a line separator, the caret will be placed at the end of the line separator on the next line, which can cause the actual index of the caret to be slightly higher. If the selection is locked to a region, attempting to set the caret to a position outside of the lock will instead go to the appropriate end of the locked region instead.

Parameters

• text value

This action applies an angular impulse to this item. The units are in kilogram units squared per second. This modifies the angular velocity of this item. Physics must be enabled on this item before using this action.

Parameters

• number impulse: The angular impulse in kilogram units squared per second

This action applies a force to this item at the passed point. The force is in kilogram units per second per second. The point is the screen coordinates where the point will be applied. If the point is not on the center of the item, then a torque will be introduced causing the item to rotate. Physics must be enabled on this item before using this action.

Parameters

• Libraries.Compute.Vector2: The force to apply to the item in kilogram units per second per second
• Libraries.Compute.Vector2: The point at which to apply the force

This action applies a force to this item at the center of the item. The force is in kilogram units per second per second. No torque is introduced to the item when using this action. Physics must be enabled on this item before using this action.

Parameters

• Libraries.Compute.Vector2: The force to apply to the item in kilogram units per second per second

This action applies a linear impulse to this item at the passed point. The impulse is in kilogram units per second. This immeadietly modifies the linear velocity of this item. The point is the screen coordinates where the impulse will be applied. If the point is not the center of the item, then the angular velocity of this item will also be modified. Physics must be enabled on this item before using this action.

Parameters

• Libraries.Compute.Vector2: The impulse to apply in kilogram units per second
• Libraries.Compute.Vector2: The point at which to apply the impulse

This action applies a torque to this item. The units are kilogram units squared per second per second. Physics must be enabled on this item before using this action.

Parameters

• number torque: The torque to apply to this item in kilogram units squared per second per second

This action returns whether or not this Item is allowing its children to receive mouse events if the Item is custom drawing. If the Item isn't using custom drawing, this value is irrelevant -- children objects always receive mouse events before the parent if the parent isn't performing custom drawing.

Return

boolean:

This action is used to indicate that two items have just begun colliding. When two Items collide, the BeginCollision action should be called on both of them, with the other item passed as a parameter to the action. Note that this action does nothing by default, but classes that inherit from Item may override it.

Parameters

• Libraries.Interface.Item: The other Item involved in the collision.

This action is used when a control is moused over by the mouse.

This action gets the position of the center of this item in global (world) coordinates.

Parameters

• boolean flag

This action stops all behaviors this Item is following without finishing them.

This action is used when a control is clicked by the mouse.

know where to position the caret.

Parameters

• Libraries.Interface.Events.MouseEvent

This action sets the mass, mass moment of inertia, and how the 2D item should move (via linear velocity) to be at the desired location.

Return

boolean:

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

• Libraries.Language.Object: The object to compare to.

Return

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

This action computes the distance of the passed point from the collision shape attached to this item. This action is used internally and users should not need to use this action.

Parameters

• Libraries.Compute.Vector2: The vector representing the point to compute the distance from
• integer childIndex: The index of the collision shape attached to this item we want the bounding box of
• Libraries.Compute.Vector2: The direction of the point from the shape

Return

number: The distance of the point from the collision shape of this item

This action tests if a point in global x,y coordinates is contained inside this Item2D. The global coordinates are considered to be the x and y coordinates of this Item plus its offsetX and offsetY values.

Parameters

• number containsX
• number containsY

Return

boolean: Whether or not the point is contained in this Item.

This action obtains the Input Table from this control, copies it, assigns it a group name, sets the control to use the new input table, and then adds it to the global input table hash table.

Parameters

• text name: the name of the group for the new input table.

Return

Libraries.Game.InputTable: the input table copy

This action creates the nodes for this item for the broadphase collision. This action is needed in order to add the item to the collision detection system. This action is used internally and users should not need to use this action.

Parameters

• Libraries.Game.Collision.BroadphaseCollision2D: The broadphase to add this item to
• Libraries.Game.Collision.PhysicsPosition2D: The current position of the item in physics space

This action will delete the text between the given start and end text indices. The start index is inclusive, and the end index is exclusive. In other words, the character at the start index is deleted, but the character at the end index is not.

Parameters

• integer startIndex: The index of the first character to delete.
• integer endIndex: The end index of the stretch of text to be deleted. The character at this index is not deleted.

The DeleteBackward action deletes a portion of the text, as if the user had just pressed the backspace key. If a portion of text is selected, the selection will be deleted -- otherwise, the character immediately preceding the caret will be deleted.

The DeleteForward action deletes a portion of the text, as if the user had just pressed the delete key. If a portion of text is selected, the selection will be deleted -- otherwise, the character immediately following the caret will be deleted.

The DeleteSelection action will delete the selected text in the TextBox. If the TextBox's selection is empty, this action does nothing.

This action destroys the nodes for this item for the broadphase collision, essentially removing it from the collision detection system. This action is used internally and users should not need to use this action.

Parameters

• Libraries.Game.Collision.BroadphaseCollision2D: The broadphase to remove this item's nodes from

This action is used to free up any additional memory that is being used by this Item for purposes such as graphics. Note that the Item class doesn't have any extra memory that needs to be released with this action, but some classes which inherit from Item, such as Libraries.Game.Graphics.Drawable, do.

This action is used to call Dispose on this Item and on the entire children hierarchy of this Item.

This action is used to call Dispose on the entire children hierarchy of this Item. This will not call Dispose on this Item.

this checks all of the linefeeds and calculates how many there are.

Parameters

• Libraries.Interface.Events.MouseEvent

The Draw action is used to perform custom drawing on this Item and its children. This is only called during the Game engine's draw phase if this Item has enabled custom drawing via the SetCustomDrawing action. This is an advanced feature, and shouldn't be used by most users. If custom drawing is enabled, this action should be overriden -- if it isn't, the Item will attempt to provide default rendering for itself, its view, and its children, without regard to depth buffering. This action is responsible for instructing the provided Painter on how to draw this item, the view, and its children, and in what order to do so.

Parameters

• Libraries.Game.Graphics.Painter2D

The GetCaretLine action returns the index of the line that the caret is currently located on.

This action will call Empty on the entire children hierarchy of this item, and then empty this item as well.

This action is used to call Empty on all children contained in this item's children hierarchy. This will not empty the children of this item.

This action empties or removes all SelectionListeners which have been added to the Control of the given SelectionEvent.

Because the TextStyles are sorted from lowest to highest start index, once we've found a style with an excessive start index, we know all of the remaining ones will be too.

This action enables physics for this item. Passing true turns on physics for this item while passing false turns off physics for this item.

Parameters

• boolean flag: Whether or not to enable physics for this item

This action is used when a control is moused over and it ends.

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

Parameters

• Libraries.Language.Object: The to be compared.

Return

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

This action gets the linear velocity of this item in units per second. Physics must be enabled on this item before using this action.

Parameters

• boolean flag

This action is used to indicate that two items that were previously colliding no longer are. The FinishCollision action should be called on both Items involved, with the other item passed as a parameter to the action. Note that this action does nothing by default, but classes that inherit from Item may override it.

Parameters

• Libraries.Interface.Item: The other Item involved in the collision.

This action will flip the Item2D across the X-axis. This flip is represented by the internal vertices of the Item2D. For classes that inherit from Item and can draw on the screen, this will flip the drawn image on the screen.

This action will flip the Item2D across the Y-axis. This flip is represented by the internal vertices of the Item2D. For classes that inherit from Item and can draw on the screen, this will flip the drawn image on the screen.

This action sets focus on this Item. If the Item is not focusable, it will instead look through the parent hierarchy and set focus on the first focusable ancestor. If no focusable Item can be found, this action will have no effect.

This action inserts the provided text at the requested global text index. This action moves the caret to the requested index before the insertion, so in practice the new caret position will be immediately after the inserted text.

Parameters

• Libraries.Interface.Events.FocusEvent

This action is used when a control gains the selection.

This action gets the accent color from the control.

Return

Libraries.Game.Graphics.ColorGroup: the accent control.

This action returns the current accessiblity code for this Item

Return

integer:

This action returns the custom accessibility role description for this item, if any.

Return

text:

This action returns the name of the accessiblity code for this Item as Text

Return

text:

This action returns the parent of this Item2D. An Item2D gets a parent when it is added to another Item using the Add action.

Return

Libraries.Interface.Item:

This action returns a default behavior for this paricular control. Some controls do nothing by default, like a TextBox that responds to different kinds of input. Others, however, have default behaviors, like a Button or a MenuItem. If there is no default behavior, this action returns undefined.

Return

Libraries.Interface.Behaviors.Behavior:

This action gets the inverse inertia of this item (i.e., one divided by the inertia of this item). Physics must be enabled on this item before using this action.

Return

number: The inverse inertia of this item

This action gets this item's angular velocity in radians per second. Physics must be enabled in this item before using this action.

Return

number: The angular velocity of this item in radians per second

This action gets the color of the Control background color.

Return

Libraries.Game.Graphics.ColorGroup: the background the color.

This action returns a percentage (represented between 0 and 1) indicating how much of the content's width can be viewed in the scrollable region. For example, if the content is 400 pixels wide and the scrollable region is 100 pixels wide, the percent of viewable width returned will be 0.25. This value cannot be set directly. It is calculated from the dimensions of the content and the Control.

Return

integer:

This action gets the border color of the control.

Return

Libraries.Game.Graphics.ColorGroup: the controls border color.

This action gets the border style either, LayoutProperties.TOP, LayoutProperties.BOTTOM, LayoutProperties.LEFT, LayoutProperties.RIGHT, and LayoutProperties.ALL.

Return

integer:

This action gets the border thickness on the control.

Return

number: the border thickness.

This action returns the bottom left pixel rounding value.

Return

number: the bottom left pixel rounding value.

This action returns the bottom left rounding value.

Return

number: the bottom left rounding value.

This action gets the bottom margin size. The bottom margin is the space outside of the bottom border.

Return

number: the number amount of bottom margin.

This action gets the bottom padding size. The bottom padding is the space inside of the bottom border.

Return

number: the number amount of bottom padding.

This action returns the bottom right pixel rounding value.

Return

number: the bottom right pixel rounding value.

This action returns the bottom right rounding value.

Return

number: the bottom right rounding value.

This action is used to get the bounding box of the item. A bounding box is an axis-alligned rectangle containing the shape used for broadphase collision. This action is used internally and users should not need to use this action.

Parameters

• integer childIndex: The index of the collision shape attached to this item we want the bounding box of

Return

Libraries.Game.Collision.BoundingBox2D: The bounding box of the collision shape attached to this item

This action returns a rectangle that fully encloses the four corners of the Item as it is represented by its internal vertices array. Note that the rectangle produced by this action will be larger than the actual box formed by this Item's vertices if the Item is rotated.

Return

Libraries.Game.Shapes.Rectangle:

For monospaced fonts, this choice is arbitrary. For non-monospaced fonts, W is typically one of the broadest characters, but this is imprecise at best. This approach is only meant as a short-term solution to quickly calculate the width of lines. MultipleLineText will handle this more elegantly in the future.

Return

number:

If we haven't loaded graphics yet, don't try to create the drawables yet.

Return

number:

This action sets the number of seconds it should take for the caret to move a single character when the caret is automatically moving due to the user pressing and holding a movement key.

Return

number:

The GetCaretLine action returns the index of the line that the caret is currently located on.

Return

integer:

The GetCaretLinePosition action returns the index of the caret within the line it is currently located. To get the global index, use GetCaretPosition instead, or to get the line that the caret is on, use GetCaretLine.

Return

integer:

This action sets the number of seconds the caret should wait before automatically moving when the user presses and holds a movement key.

Return

number:

This action sets how long it takes for the caret to cycle between visible and hidden when the caret is idle. The time provided describes the number of seconds it takes to transition from one stage to another -- e.g., if the provided time is one second, the caret will remain visible for one second, then hide for one second, and so on.

Return

number:

The GetCaretPosition action returns the global index of the caret within the TextBox.

Return

integer:

If selection begins on this line.

Return

number:

While iterating over the text, many drawables are created, which are custom rendered by the background. The render order of these drawables is, from back-to-front: Pre-Selection Highlights Selection Drawables Post-Selection Highlights Text Drawables

Return

number:

This action returns the x coordinate of the center of this Item2D.

Return

number:

This action returns the y coordinate of the center of this Item2D.

Return

number:

This returns the widths of characters from the left hand side of the screen for a particular line.

Parameters

• integer line

Return

Libraries.Containers.Number32BitArray:

This action determines if the TextBox should place characters so that they're touching the base line. In practice, if this is true, the TextBox will position characters slightly lower, providing more whitespace above the first line. If this value is false, the characters will be positioned higher, which may look better for TextBoxes that are approximately one line in height. The default value is true.

Parameters

• integer index

Return

number:

This returns the x positions of characters from the left hand side of the screen.

Parameters

• integer line

Return

Libraries.Containers.Number32BitArray:

This action determines if the TextBox should place characters so that they're touching the base line. In practice, if this is true, the TextBox will position characters slightly lower, providing more whitespace above the first line. If this value is false, the characters will be positioned higher, which may look better for TextBoxes that are approximately one line in height. The default value is true.

Parameters

• integer index

Return

number:

This action gets the children of this item in an array.

Return

Libraries.Containers.Array: The children of this item in an array

This action gets the clipping coordinates of this Item2D. The coordinates are returned via the two provided Vector2 parameters, the first vector storing the x values of the left and right sides of the clipping coordinates and the second vector storing the y values of the bottom and top sides. The returned boolean value indicates if this Item uses these clipping coordinates (i.e. if this Item or one of its parent Items has clipping enabled). If the clipping is valid, the action returns true. Otherwise, it returns false.

Parameters

• Libraries.Compute.Vector2
• Libraries.Compute.Vector2

Return

boolean:

This action gets the total force on this item. The units are kilogram units per second per second. Physics must be enabled on this item before using this action.

Return

boolean: The total force in kilogram units per second per second

This action gets this item's angular velocity in radians per second. Physics must be enabled in this item before using this action.

Return

integer: The angular velocity of this item in radians per second

This is an action used internally to retrieve the head of the linked list of collisions with this item. This action is used internally and users should not need to use this action.

Return

Libraries.Game.Collision.CollisionEdge2D: The head of the doubly linked list of collisions

This action gets the color of a given property in the Control.

Parameters

• text property

Return

Libraries.Game.Graphics.ColorGroup:

This action returns how many rows this Control should be divided into when using a GridLayout. This will have no effect if this Control is not a container or if it is using a different layout.

Return

integer:

This action returns how many columns this Control should be divided into when using a GridLayout. This will have no effect if this Control is not a container or if it is using a different layout.

Return

integer:

This action returns a TextEditState object which describes the current text, caret position, and selection within the TextBox.

Return

Libraries.Interface.Undo.TextBoxEditState:

This action returns the LayoutProperties that were last used to define the Control, and thus describe its current state. Note that if the Control hasn't been laid out yet, this will return undefined.

Return

Libraries.Interface.Layouts.LayoutProperties: The last LayoutProperties used to layout this Control, or undefined if it hasn't been laid out yet.

This action will return the global index of the beginning of the given line.

Return

text:

This action obtains the default font for this control. This allows individual controls to customize their default font properties on a per control basis. By default, the system asks for the default system font name on a per control basis, then loads that font and returns it. Font loading is shared, so loading many fonts of the same type and size is not particularly expensive and can be done without much concern for memory requirements.

Return

Libraries.Game.Graphics.Font:

This action defines what the default font is for this control. This allows individual controls to customize their default font properties on a per control basis.

Return

text:

This action defines what the default font size for this control. This allows individual controls to customize their default font properties on a per control basis.

Return

integer:

This action returns the default LayoutProperties used for this Control.

Return

Libraries.Interface.Layouts.LayoutProperties: The default LayoutProperties of this Control.

The GetDefaultLineSeparator action returns the default character(s) used by the TextBox to signify the end of a line of text. This is the same line separating characters that are used by the running operating system.

Return

text: The default characters used to indicate the end of a line of text.

This action applies a linear impulse to this item at the passed point. The impulse is in kilogram units per second. This immeadietly modifies the linear velocity of this item. The point is the screen coordinates where the impulse will be applied. If the point is not the center of the item, then the angular velocity of this item will also be modified. Physics must be enabled on this item before using this action.

Return

number:

This action returns the current internal description of the Item.

Return

text:

This action returns the DrawableShape attached to this Item, if it has one. For a default Item2D, this action will return undefined, but Drawables will have an associated shape if they've been loaded. Attributes: Returns The DrawableShape attached to this Item, or undefined if there isn't one.

Return

Libraries.Game.Graphics.DrawableShape:

Setting the scroll region width to -1 forces recalculation.

Return

Libraries.Interface.Undo.EditManager:

This action gets the first visible line in the text box.

Return

integer:

This action gets the focus border color.

Return

Libraries.Game.Graphics.ColorGroup: the focus border color.

This action sets the focus color.

Return

Libraries.Game.Graphics.ColorGroup: the focus color.

This action gets focus font color.

Return

Libraries.Game.Graphics.ColorGroup: the focus font color.

This action returns an Iterator containing all of the FocusListeners that have been added to this Item using the AddFocusListener action.

Return

Libraries.Containers.Iterator: An iterator containing all of the registered FocusListeners.

This action returns the Font being used by this Control. How this Font is used varies between Controls, and in some cases the Control will ignore it entirely (for example, ScrollPanes), but typically this sets the font that's used for the default label on many Controls, such as Buttons. If the Font is undefined, many Controls will omit their default label.

Return

Libraries.Game.Graphics.Font: The Font being used for this Control.

This action gets the current the font color of the font contained in the Control.

Return

Libraries.Game.Graphics.ColorGroup:

This action gets the font outline color value.

Return

Libraries.Game.Graphics.ColorGroup: the font outline color value.

This action returns the font outline thickness value.

Return

number: the font outline thickness value.

This action returns the base Font size to be used by this Control, if the Control uses a Font.

Return

integer:

This action gets the total force on this item. The units are kilogram units per second per second. Physics must be enabled on this item before using this action.

Return

Libraries.Compute.Vector2: The total force in kilogram units per second per second

This action gets the color of the Control foreground color.

Return

Libraries.Game.Graphics.ColorGroup: the foreground color.

This action gets the color of the Control foreground selection color.

Return

Libraries.Game.Graphics.ColorGroup: the foreground selection color.

This action applies a force to this item at the center of the item. The force is in kilogram units per second per second. No torque is introduced to the item when using this action. Physics must be enabled on this item before using this action.

Return

number:

This action returns an Iterator containing all of the GestureListeners that have been added to this Item using the AddGestureListener action.

Return

Libraries.Containers.Iterator: An iterator containing all of the registered GestureListeners.

This action returns the Item's global x coordinate. This is the actual world coordinate that the item exists at after it has been offset by its parent's position. If this Item doesn't have a parent, and the offset hasn't been set manually, this is the same as GetX().

Return

number:

This action returns the Item's global y coordinate. This is the actual world coordinate that the item exists at after it has been offset by its parent's position. If this Item doesn't have a parent, and the offset hasn't been set manually, this is the same as GetY().

Return

number:

This action returns the Item's global z value. For an Item2D, this simply returns the Item2D's current z value.

Return

number:

This action gets the glow color from the control.

Return

Libraries.Game.Graphics.ColorGroup: the glow color.

draw:SetPosition(x + glyph:lengthToGlyph, yPosition + glyph:heightFromBaseLine - draw:GetHeight())

Return

number:

The GetGridHeight action returns how many cells in a column this Control occupies. By default, this value is 1. This value is only used for GridLayouts, and is ignored by other layouts.

Return

integer:

The GetGridWidth action returns how many cells in a row this Control occupies. By default, this value is 1. This value is only used for GridLayouts, and is ignored by other layouts.

Return

integer:

This action returns this Control's cell x-coordinate within a GridLayout. This indicates which column this Control is located within. If the Control's parent container isn't using a GridLayout, this value is ignored.

Return

integer:

This action returns this Control's cell y-coordinate within a GridLayout. This indicates which row this Control is located within. If the Control's parent container isn't using a GridLayout, this value is ignored.

Return

integer:

Return

Libraries.Containers.Array

This action gets the hash code for an object.

Return

integer: The integer hash code of the object.

This action will return the currently set height of the Item2D.

Return

number:

The GetHorizontalLayoutMode is used to determine how the width of a Control is calculated. It should be one of the following constants: STANDARD, which will calculate the width as a set number of pixels plus a percentage of the container's width. FILL, which will make the width fill the remaining width of the container. FIT_CONTENTS, which will calculate the width to fit the children contents.

Return

integer: the integer that maps to the layout mode constant, one of STANDARD, FILL, or FILL_CONTENTS.

This action translate a pixel value to a percentage scroll X value. The pixel value is relative to the Spreadsheet.

Parameters

• number x

Return

number:

This action gets the Icon (typically an image or texture) used by this Control. Different Controls use this Icon differently, depending on their purpose.

Return

Libraries.Game.Graphics.TextureRegion:

This action gets the Icon color from the control.

Return

Libraries.Game.Graphics.ColorGroup: the icon color.

Return

Libraries.Interface.Controls.IndentationStrategy

This action will return the global index of the beginning of the given line.

Parameters

• integer line

Return

integer:

This action gets the rotational inertia of this item. The inertia is in kilogram units squared.

Return

number: The inertia of this item in kilogram units squared

This action returns the input group for this Item. When used with the Game libraries, this tag describes what InputTable (if any) can interact with this Item due to input.

Return

text: The input group tag being used by this Item.

Return

Libraries.Game.InputTable:

This action sets the base Font size to be used by this Control, if the Control uses a Font.

Return

text:

This action sets the interface scale for the control.

Return

number: the scale, a number between 0 and 1 that scales the control.

This action gets the inverse inertia of this item (i.e., one divided by the inertia of this item). Physics must be enabled on this item before using this action.

Return

number: The inverse inertia of this item

This action gets the inverse mass of the item (i.e., one divided by the mass of this item). Physics must be enabled on this item before using this action.

Return

number: The inverse mass of this item

This action returns an Item2D that was previously added to this Item2D by finding it at the given index in the internal array of children Items.

Parameters

• integer index

Return

Libraries.Interface.Item2D:

This action searches through all Items stored in this Item2D and finds the deepest Item which contains the given point in global coordinates.

Parameters

• number x
• number y

Return

Libraries.Interface.Item2D: The deepest item in the children hierarchy at the given point.

This action returns the number of items contained in this Item2D.

Return

integer:

This action returns an iterator containing all the items contained in this Item2D.

Return

Libraries.Containers.Iterator:

This is an action used internally to retrieve the head of the liked list of joints connected to this item. This action is used internally and users should not need to use this action.

Return

Libraries.Game.Physics.Joints.JointEdge2D: The head of the linked list of connected joints

This action returns the text used for this Control's label, if it has one.

Return

text: The text of this Control's label.

This action returns the current Layer2Dthat this Item2D is a part of in the Game libraries.

Return

Libraries.Game.Layer2D:

Returns true if rendering the selection event.

Return

Libraries.Interface.Layouts.Layout:

This action returns the best suited LayoutProperties stored by the Control for use with the given container width and height. The Control will attempt to find the most restricted LayoutProperties that is still valid, prioritizing width over height in case of equal values.

Parameters

• number containerWidth: The width of the container the LayoutProperties must be legal for.
• number containerHeight: The height of the container the LayoutProperties must be legal for.

Return

Libraries.Interface.Layouts.LayoutProperties: The LayoutProperties contained in the Control that is best suited to the requested container dimensions.

This action is fired if the item lost the focus.

Return

Libraries.Containers.Iterator:

This action returns how many rows this element should occupy, if the layout supports it. This effectively makes the control taller. This is most commonly used in conjunction with FormRowLayout (or StackedRowPage which uses that layout).

Return

number:

The GetLeftCharacterPadding action returns how much padding has been added to the TextBox in between the gutters (or the left side of the TextBox, if there are no gutters) and the beginning of the text.

Return

integer: The amount of padding between the left side of the TextBox and the beginning of the text.

This action gets the left margin size. The left margin is the space outside of the left border.

Return

number: the number amount of left margin.

This action gets the left padding size. The left padding is the space inside of the left border.

Return

number: the number amount of left padding.

The GetCaretLinePosition action returns the index of the caret within the line it is currently located. To get the global index, use GetCaretPosition instead, or to get the line that the caret is on, use GetCaretLine.

Parameters

• integer line

Return

text:

This action will return the number of lines in the text.

Return

integer:

Parameters

• integer line

Return

number

Return

number

This action will return the line index containing the provided global index.

Parameters

• integer characterIndex

Return

integer:

The GetLineSeparator action returns the text which is used to designate the end of a line in the TextBox. By default, this is the same as the value used by the operating system.

Return

text: The character(s) used to designate the end of a line.

Parameters

• integer line

Return

number

Given the local coordinates of a vector, this action computes the screen coordinates of the corresponding vector.

Return

number: The coordinates of the corresponding global vector Attribute Example use Libraries.Interface.Item2D use Libraries.Compute.Vector2 Item2D item Vector2 localVector item:SetWidth(100) item:SetHeight(100) item:SetPosition(400, 250) localVector:Set(0, 0) // Get the coordinates of the center of the item Vector2 worldVector = item:GetWorldVector(localVector)

This action gets the linear velocity of this item in units per second. Physics must be enabled on this item before using this action.

Return

Libraries.Compute.Vector2: The vector representing the linear velocity of this item in units per second

Given a global point (i.e., the screen coordinates of the point), this action computes the corresponding point relative to the center of this item.

Parameters

• Libraries.Compute.Vector2

Return

Libraries.Compute.Vector2: The coordinates of the point relative to the center of this item

Given the screen coordinates of a vector, this action computes the local coordinates of the vector (i.e., the coordinates of the vector relative to the center of this item)

Parameters

• Libraries.Compute.Vector2

Return

Libraries.Compute.Vector2: The local coordinates of the corresponding vector

This action gets the position of the center of this item in local coordinates (i.e., with respect to itself).

Return

Libraries.Compute.Vector2: The vector representing the center of this item in local coordinates

Given a global point (i.e., the screen coordinates of the point), this action computes the corresponding point relative to the center of this item.

Parameters

• Libraries.Compute.Vector2: The screen coordinates of the point to compute

Return

Libraries.Compute.Vector2: The coordinates of the point relative to the center of this item

Given the screen coordinates of a vector, this action computes the local coordinates of the vector (i.e., the coordinates of the vector relative to the center of this item)

Parameters

• Libraries.Compute.Vector2: The screen coordinates of the vector

Return

Libraries.Compute.Vector2: The local coordinates of the corresponding vector

This action is used to advance the item forward in time in physics space to synchronize it for time of impact solving. This action is used internally and users should not need to use this action. Attribute Parameter time The amount of seconds to advance the item forward in time

Parameters

• Libraries.Game.Physics.Mass2D

This action returns the mass of the item in kilograms. Physics must be enabled on this item before using this action. If the item is non-responsive or unmovable, the mass is zero.

Return

number: The mass in kilograms

This action gets the mouse down font color.

Return

Libraries.Game.Graphics.ColorGroup: the mouse over font color value.

This action gets the mouse down font color.

Return

Libraries.Game.Graphics.ColorGroup: the mouse down font color.

This action gets the mouse down glow color.

Return

Libraries.Game.Graphics.ColorGroup: the mouse down glow color.

This action returns an Iterator containing all of the MouseListeners that have been added to this Item using the AddMouseListener action.

Return

Libraries.Containers.Iterator: An iterator containing all of the registered MouseListeners.

This action returns an Iterator containing all of the MouseMovementListeners that have been added to this Item using the AddMouseMovementListener action.

Return

Libraries.Containers.Iterator: An iterator containing all of the registered MouseMovementListeners.

This action gets the mouse over color.

Return

Libraries.Game.Graphics.ColorGroup: the mouse over color.

This action gets the mouse over font color.

Return

Libraries.Game.Graphics.ColorGroup: the mouse over font color value.

This action gets the mouse over glow color.

Return

Libraries.Game.Graphics.ColorGroup: the mouse over glow color.

This action returns an Iterator containing all of the MouseWheelListeners that have been added to this Item using the AddMouseWheelListener action.

Return

Libraries.Containers.Iterator: An iterator containing all of the registered MouseWheelListeners.

This action returns the total number of characters of text in the TextBox.

Return

Libraries.Containers.MultipleLineText:

This action returns the current internal name of the Item.

Return

text:

This action returns the next focus item. When this Item has the focus and the user requests the focus to advance (e.g. by pressing the tab key), the returned value is the next item to receive that focus, if it is defined. If it isn't defined, the focus can not advance from this Item.

Return

Libraries.Interface.Item: The next Item to receive focus after this one.

This action finds the start index of the next token after the given search index. If the search index is located at the start of a token, the index returned will be for the start of the next token.

Parameters

• integer searchIndex: The global index within the text to begin the search from.

Return

integer: A global index pointing to the start of the next token after the search index.

This action finds the start index of the first token before the given search index. If the search index is located in the middle of a token, the index returned will be for that token. If the search index is exactly at the beginning of a token, the start index of the previous token will be returned instead.

Return

integer: A global index pointing to the beginning of the first token before the search index.

This action gets the number of broadphase nodes this item has. This action is used internally and users should not need to use this action.

Return

integer: The number of broadphase nodes attached to this item

This action returns all of the broadphase nodes attached to this item in an array. This action is used internally and users should not need to use this action.

Return

Libraries.Containers.Array: The broadphase nodes attached to this item in an array

This action gets a generic property with a specified name from the control.

Parameters

• text property: the property name.

Return

number: the number value of the property.

This action returns the X offset of the Item. The offset tells the Item where to relate its X position to. In other words, the X offset is where an X coordinate of 0 is for this Item. This is automatically set when using an action to add an Item to another Item.

Return

number:

This action returns the Y offset of the item. The offset tells the Item where to relate its Y position to. In other words, the Y offset is where a Y coordinate of 0 is for this item. This is automatically set when using an action to add an Item to another Item.

Return

number:

This action returns the Z offset of the item. The offset tells the Item where to relate its Z position to. In other words, the Z offset is where a Z coordinate of 0 is for this item. This is automatically set when using an action to add an Item to another Item.

Return

number:

This action will return the current X origin of this Item2D. By default, the origin is at the coordinates 0, 0.

Return

number:

This action will return the current Y origin of this Item2D. By default, the origin is at the coordinates 0, 0.

Return

number:

This action returns the parent of this Item2D. An Item2D gets a parent when it is added to another Item using the Add action.

Return

Libraries.Interface.Item2D:

This action returns the height of the Control relative to the size of its container, if the container's Layout supports it.

Return

number: The target height as a percentage (as a value between 0.0 and 1.0) of the container's height.

Return

number

This action returns the x-coordinate of the "origin" of the Control, as a percentage of its width. The origin is the point that the Control is positioned by. For example, by default, the origin is at 0% x and 0% y, or the bottom-left corner of the Control. Changing the percentage origin x and y to 0.5 (50%) would mean the Control should be positioned using its center instead. The origin point is used by layouts that allow for specific positioning, such as ManualLayout or GridLayout. It is ignored by layouts that have special positioning rules, such as FlowLayout.

Return

number:

This action returns the y-coordinate of the "origin" of the Control, as a percentage of its width. The origin is the point that the Control is positioned by. For example, by default, the origin is at 0% x and 0% y, or the bottom-left corner of the Control. Changing the percentage origin x and y to 0.5 (50%) would mean the Control should be positioned using its center instead. The origin point is used by layouts that allow for specific positioning, such as ManualLayout or GridLayout. It is ignored by layouts that have special positioning rules, such as FlowLayout.

Return

number:

This action returns the width of the Control relative to the size of its container, if the container's Layout supports it.

Return

number: The target width as a percentage (as a value between 0.0 and 1.0) of the container's width.

This action returns the x position of the Control relative to the size of its container, if the container's Layout supports it.

Return

number: The target x position as a percentage (as a value between 0.0 and 1.0) of the container's width.

This action returns the y position of the Control relative to the size of its container, if the container's Layout supports it.

Return

number: The target y position as a percentage (as a value between 0.0 and 1.0) of the container's height.

This action computes the distance of the passed point from the collision shape attached to this item. This action is used internally and users should not need to use this action.

Return

Libraries.Game.Physics.PhysicsProperties2D: The distance of the point from the collision shape of this item

This action returns the target height of the Control in pixels. Note that this may not be used by some layouts (such as FlowLayout).

Return

number: The target height of this Control in pixels.

This action gets the Control object containing the entire scrollable region in the text box.

Return

number:

This action returns the target width of the Control in pixels. Note that this may not be used by some layouts (such as FlowLayout).

Return

number: The target height of this Control in pixels.

This action returns the target x position of the Control in pixels. Note that this may not be used by some layouts (such as FlowLayout).

Return

number: The target x position of this Control in pixels.

This action returns the target y position of the Control in pixels. Note that this may not be used by some layouts (such as FlowLayout).

Return

number: The target y position of this Control in pixels.

The GetContextMenu action returns this Control's context menu, if it has one. A context menu is a PopupMenu which appears when a user wants additonal context about this Control (most commonly by right-clicking on the Control).

Return

Libraries.Interface.Controls.PopupMenu:

This action gets the TextFieldSavePreviousCaretPositionBehavior position for use by the TextFieldSelectToMouseClickBehavior.

Return

integer:

This action returns the previous focus item. When this Item has the focus and the user requests the focus to move backwards (e.g. by pressing shift & tab), the returned value is the previous item to receive that focus, if it is defined. If it isn't defined, the focus can not move backwards from this Item.

Return

Libraries.Interface.Item: The previous Item to receive focus before this one.

Return

integer

Parameters

• text key

Return

Libraries.Data.Formats.JavaScriptObjectNotation

Return

Libraries.Containers.Iterator

This action is used to update this items position in physics space after physics solving is finished for this item. This action is used internally and users should not need to use this action.

Return

number:

This action gets the inverse mass of the item (i.e., one divided by the mass of this item). Physics must be enabled on this item before using this action.

Return

integer: The inverse mass of this item

This action gets the total torque on this item. The units are kilogram units squared per second per second. Physics must be enabled on this item before using this action.

Return

number: The total torque in kilogram units squared per second per second

This action gets the right margin size. The right margin is the space outside of the right border.

Return

number: the number amount of right margin.

This action gets the right padding size. The right padding is the space inside of the right border.

Return

number: the number amount of right padding.

Gets the current degree of rotation of this Item.

Return

number:

Gets the current rotation of this Item in radians.

Return

number:

This action will return the current x-scaling value of this Item2D. By default, the x-scaling value of an Item is 1.

Return

number:

This action will return the current y-scaling value of this Item2D. By default, the y-scaling value of an Item is 1.

Return

number:

This action returns the x coordinate of the Item on the screen. If the Item hasn't been attached to a Layer, this will return a "Not a Number" value instead.

Return

number:

This action returns the y coordinate of the Item on the screen. If the Item hasn't been attached to a Layer, this will return a "Not a Number" value instead.

Return

number:

This action gets the Control object scroll as a fraction 1.0 / the number of lines in the text box.

Return

number:

This action returns a percentage (represented between 0 and 1) indicating how much of the content's height can be viewed in the scrollable region. For example, if the content is 400 pixels tall and the scrollable region is 100 pixels tall, the percent of viewable height returned will be 0.25. This value cannot be set directly. It is calculated from the dimensions of the content and the Control.

Return

number:

This action returns a percentage (represented between 0 and 1) indicating how much of the content's width can be viewed in the scrollable region. For example, if the content is 400 pixels wide and the scrollable region is 100 pixels wide, the percent of viewable width returned will be 0.25. This value cannot be set directly. It is calculated from the dimensions of the content and the Control.

Return

number:

This action returns how far the content has been scrolled along the x-axis. In other words, it's a percentage represented between 0 and 1 indicating how far the horizontal scroll bar has been moved to the right. This percentage represents the position of the start of the scroll bar. For example, a scroll percent of 0.4 indicates that the view begins 40% of the way through the scrollable area.

Return

number:

This action returns how far the content has been scrolled along the y-axis. In other words, it's a percentage represented between 0 and 1 indicating how far the vertical scroll bar has been moved down. This percentage represents the position of the start of the scroll bar. For example, a scroll percent of 0.4 indicates that the view begins 40% of the way through the scrollable area.

Return

number:

This action gets the Control object containing the entire scrollable region in the text box.

Return

Libraries.Interface.Controls.Control:

The HideCaret action hides the TextBox's caret. It will not be visible until the caret is displayed again as a consequence of the TextBox being modified, gaining selection, or calling ShowCaret.

Return

Libraries.Interface.Selections.TextBoxSelection:

This action gets the selection border color.

Return

Libraries.Game.Graphics.ColorGroup: the selection border color.

This action gets the selection color from the control.

Return

Libraries.Game.Graphics.ColorGroup: the selection color.

This action gets the selection font color on the control.

Return

Libraries.Game.Graphics.ColorGroup: the selection font color.

This action return an iterator of all SelectionListeners which have been added to the Control of the given SelectionEvent.

Return

Libraries.Containers.Iterator: All SelectionListeners registered with the Control.

Return

number

This action gets the shaddow color from the control.

Return

Libraries.Game.Graphics.ColorGroup: the shaddow color.

This action returns the shadow edge fade property.

Return

number: the shadow edge fade number.

This action returns the shadow height property.

Return

number: the shadow height number.

This action returns the shadow width property.

Return

number: the shadow width number.

This action returns the shadow X value.

Return

number: the shadow X value.

This action returns the shadow Y value.

Return

number: the shadow Y value.

This item returns the collision shape of this item. The collision shape is the shape the collision system will use to test for collisions with this item. Note that this may be different from the shape drawn on the screen.

Return

Libraries.Game.Collision.Shapes.CollisionShape2D: The collision shape for this item

This action returns an integer representing the type of collision shape currently attached to this item.

Return

integer: The integer representing the type of collision shape for this item

This action returns the total number of characters of text in the TextBox.

Return

integer:

This action gets the children of this item in an array.

Return

number: The children of this item in an array

The GoToLine action will adjust the vertical scroll position of the TextBox to view the given line. The TextBox will try to position the line in the center of the view pane.

Return

integer:

This action returns the swept movement of this item used for time of impact solving for the physics system. This action is used internally and users should not need to call this action.

Return

Libraries.Game.Collision.Sweep2D: The swept motion of this item

This action will return the line index containing the provided global index.

Parameters

• integer startIndex
• integer endIndex

Return

text:

This action will return the number of lines in the text.

Return

text:

This action gets the TextFieldSavePreviousCaretPositionBehavior position for use by the TextFieldSelectToMouseClickBehavior.

Parameters

• integer startIndex
• integer endIndex

Return

Libraries.Game.Shapes.Rectangle:

Setting the scroll region width to -1 forces recalculation.

Return

Libraries.Interface.Undo.TextBoxEditManager:

The MoveCaretDown action moves the caret one position downward, as if the user had just pressed the down arrow key. If the provided boolean is true, the action will adjust the selection as the caret moves.

Return

Libraries.Containers.Array:

On the first pass of the loop, we haven't checked any of them yet, so start from the beginning.

Parameters

• text name

Return

Libraries.Interface.Controls.TextStyles.TextStyle:

Parameters

• integer index

Return

Libraries.Containers.Array

Because the TextStyles are sorted from lowest to highest start index, once we've found a style with an excessive start index, we know all of the remaining ones will too.

Parameters

• integer line

Return

Libraries.Containers.Array:

This action finds the end index of the first token after the given search index. If the search index is located in the middle of a token, the index returned will be for that token. If the search index is exactly at the end of a token, the end index of the next token will be returned instead.

Parameters

• integer searchIndex: The global index within the text to begin the search from.

Return

integer: A global index pointing to the end of the first token after the search index.

This action finds the end index of the first token after the caret within the TextBox. If the caret is located in the middle of a token, the index returned will be for that token. If the caret is exactly at the end of a token, the end index of the next token will be returned instead.

Return

integer: A global index pointing to the end of the first token after the caret.

This action finds the start index of the first token before the caret within the TextBox. If the caret is located in the middle of a token, the index returned will be for that token. If the caret is exactly at the beginning of a token, the start index of the previous token will be returned instead.

Return

integer: A global index pointing to the beginning of the first token before the caret.

This action finds the start index of the first token before the given search index. If the search index is located in the middle of a token, the index returned will be for that token. If the search index is exactly at the beginning of a token, the start index of the previous token will be returned instead.

Parameters

• integer searchIndex: The global index within the text to begin the search from.

Return

integer: A global index pointing to the beginning of the first token before the search index.

This action returns the top left pixel rounding value.

Return

number: the top left pixel rounding value.

This action returns the top left rounding value.

Return

number: the top left rounding value.

This action gets the top margin size. The top margin is the space outside of the top border.

Return

number: the number amount of top margin.

This action gets the top padding size. The top padding is the space inside of the top border.

Return

number: the number amount of top padding.

This action returns the top right pixel rounding value.

Return

number: the top right pixel rounding value.

This action returns the top right rounding value.

Return

number: the top right rounding value.

This action gets the total torque on this item. The units are kilogram units squared per second per second. Physics must be enabled on this item before using this action.

Return

number: The total torque in kilogram units squared per second per second

Force a recalculation of the width by setting its value to -1.

Return

number:

thus all lines are the same height).

Return

number:

Return

number

This action returns an Iterator containing all of the TouchListeners that have been added to this Item using the AddTouchListener action.

Return

Libraries.Containers.Iterator: An iterator containing all of the registered TouchListeners.

This action returns the position of the item in physical space. This acction is used internally and should not be used by users to get the position of this item on the screen.

Return

Libraries.Game.Collision.PhysicsPosition2D: The position and angle of this item in physics space

This action gets the position of the item in physics space from the previous frame. This action is used internally and users should not need to use this action

Return

Libraries.Game.Collision.PhysicsPosition2D: The position and angle of the item in physics space in the previous frame

This action gets the unfocused selection border color on the control.

Return

Libraries.Game.Graphics.ColorGroup: the unfocused selection border color.

This action gets the unfocused selection color on the control.

Return

Libraries.Game.Graphics.ColorGroup: the unfocused selection color.

This action gets the unfocused selection font color on the control.

Return

Libraries.Game.Graphics.ColorGroup: the unfocused selection font color.

Return

number

The SetVerticalLayoutMode is used to determine how the height of a Control is calculated. It should be one of the following constants: STANDARD, which will calculate the height as a set number of pixels plus a percentage of the container's height. FILL, which will make the height fill the remaining height of the container. FIT_CONTENTS, which will calculate the height to fit the children contents. FIT_FONT, which will fit the height of the Control to the line height of the Font set in this LayoutProperties.

Return

integer: the integer that maps to the layout mode constant, one of STANDARD, FILL, FILL_CONTENTS, or FIT_FONT.

This action translate a pixel value to a percentage scroll Y value. The pixel value is relative to the Spreadsheet.

Parameters

• number y

Return

number:

The SetClipping action is used to enable or disable clipping. If it is enabled, when the Item and its children are drawn as part of the QueueForDrawing action, any pixels that would be drawn outside of the unrotated dimensions of the Item are not rendered. In other words, the Item will only draw inside the exact rectangle formed by its x, y position and its width and height.

Return

Libraries.Interface.Views.View2D:

This action searches through all Items stored in this Item2D and finds the deepest Item which contains the given point in global coordinates. This action will only return items which are visible (that is, IsShowing() returns true).

Parameters

• number x
• number y

Return

Libraries.Interface.Item2D: The deepest visible item in the children hierarchy at the given point.

returns the number of lines that are currently visible in the textbox, used for pagedown and pageup behaviors

Return

integer:

This action will return the currently set width of the Item2D.

Return

number:

This action gets the position of the center of this item in global (world) coordinates.

Return

Libraries.Compute.Vector2: The vector representing the center of this item in global coordinates

Given a point relative to the center of this item, this action computes and returns that point in screen coordinates.

Parameters

• Libraries.Compute.Vector2: The point in coordinates with respect to the center of this item

Return

Libraries.Compute.Vector2: The screen coordinates of the passed local point

Given the local coordinates of a vector, this action computes the screen coordinates of the corresponding vector.

Parameters

• Libraries.Compute.Vector2: The coordinates of a local vector

Return

Libraries.Compute.Vector2: The coordinates of the corresponding global vector Attribute Example use Libraries.Interface.Item2D use Libraries.Compute.Vector2 Item2D item Vector2 localVector item:SetWidth(100) item:SetHeight(100) item:SetPosition(400, 250) localVector:Set(0, 0) // Get the coordinates of the center of the item Vector2 worldVector = item:GetWorldVector(localVector)

This action returns the currently set X coordinate of the Item.

Return

number:

This action returns the currently set Y coordinate of the Item.

Return

number:

This action returns the currently set Z value of this Item2D.

Return

number:

The GoToLine action will adjust the vertical scroll position of the TextBox to view the given line. The TextBox will try to position the line in the center of the view pane.

Parameters

• number line: The line index of the line that should be visible in the view.

This action returns true when the border thickness on the control has been set.

Return

boolean: true when the border has thickness on the control.

This action returns true when teh bottom border is enabled.

Return

boolean:

This action returns the current status of the bottom left pixel rounding value.

Return

boolean: true if the control has a bottom left pixel rounding value.

This action returns the current status of the bottom left rounding value.

Return

boolean: true if the control has a bottom left rounding value.

This action returns the current status of the bottom right pixel rounding value.

Return

boolean: true if the control has a bottom right pixel rounding value.

This action returns the current status of the bottom right rounding value.

Return

boolean: true if the control has a bottom right rounding value.

This action gets whether the color property override is activated.

Parameters

• text property

Return

boolean: true if the color property is overridden.

This action returns the current status of the font outline thickness.

Return

boolean: true if the control has a font outline thickness set.

This action returns true when teh left border is enabled.

Return

boolean:

This action returns an integer representing the type of collision shape currently attached to this item.

Return

boolean: The integer representing the type of collision shape for this item

This action gets whether the number property override is activated.

Parameters

• text property

Return

boolean: true if the number property is overridden.

Return

boolean

Parameters

• text key

Return

boolean

This action returns true when teh right border is enabled.

Return

boolean:

This action returns the current status of the shadow edge fade.

Return

boolean: true if the control has a shadow edge fade.

This action returns the current status of the shadow height.

Return

boolean: true if the control has a shadow height.

This action returns the current status of the shadow width.

Return

boolean: true if the control has a shadow width.

This action returns the current status of the shadow X value.

Return

boolean: true if the control has a shadow X value.

This action returns the current status of the shadow Y value.

Return

boolean: true if the control has a shadow Y value.

Use the line that's immediately off the screen and go back by the line separator, or use the end of the text if there isn't an extra line.

Parameters

• text name

Return

boolean:

This action returns true when teh top border is enabled.

Return

boolean:

This action returns the current status of the top left pixel rounding value.

Return

boolean: true if the control has a top left pixel rounding value.

This action returns the current status of the top left rounding value.

Return

boolean: true if the control has a top left rounding value.

This action returns the current status of the top right pixel rounding value.

Return

boolean: true if the control has a top right pixel rounding value.

This action returns the current status of the top right rounding value.

Return

boolean: true if the control has a top right rounding value.

This action is used to indicate that an Item and all Items that were added to it should not be visible on the screen. Note that the Item class on its own cannot be drawn on the screen, but classes that inherit from it such as Libraries.Game.Graphics.Drawable can be. By default, Items are considered visible.

The HideCaret action hides the TextBox's caret. It will not be visible until the caret is displayed again as a consequence of the TextBox being modified, gaining selection, or calling ShowCaret.

This action inserts the provided text at the requested global text index. This action does not move the caret and has no otherwise visual impact.

Parameters

• integer index: The index to insert the new text at.
• text value: The new text to be inserted.
• boolean moveCaret: whether to move the caret

This action inserts the provided text at the requested global text index. This action moves the caret to the requested index before the insertion, so in practice the new caret position will be immediately after the inserted text.

Parameters

• integer index: The index to insert the new text at.
• text value: The new text to be inserted.

This action inserts the provided text after the current caret's position. After the insertion, the caret will be placed immediately following the inserted text.

Parameters

• text value: The new text to be inserted.

This action returns whether or not this Item accepts mouse input. If the value is true, this will intercept incoming mouse events, triggering any related MouseListeners and InputSets and preventing the mouse event from propagating to other Items on the Layer. The default value is true.

Return

boolean: True if this Item can receive mouse events, or false otherwise.

This action returns the nearest parent object that is accessible. This can be anything that the programmer wants to be accessible, from user interface components in a 2D interface to 3D components relative in 3-space on screen. By default, items have no accessible parent and are self-contained, but user interface components normally override the behavior so that controls can be logically nested within each other. attribute: returns Item

Return

boolean:

The IsClipping action returns true if pixel clipping is enabled, or false if it is disabled. If it is enabled, when the Item and its children are drawn as part of the QueueForDrawing action, any pixels that would be drawn outside of the unrotated dimensions of the Item are not rendered. In other words, the Item will only draw inside the exact rectangle formed by its x, y position and its width and height.

Return

boolean: Whether or not pixel clipping is enabled for this Item.

This action determines whether this item is collidable.

Return

boolean: True if this item is collidable, false otherwise

The IsCustomDrawing action returns whether or not this Item is directly managing how itself and its children are drawn. When this value is true, the Item is responsible for determining its rendering via the Draw(Painter2D) action -- if this action isn't overridden, the Item and its children won't be drawn. This is an advanced feature only necessary for complex custom components, and most users will not need to use this functionality.

Return

boolean: Whether or not this Item is currently using custom drawing rules.

This action returns whether or not any items are contained in this Item.

Return

boolean:

This action sets this item's angular velocity in radians per second. Physics must be enabled in this item before using this action.

Return

boolean:

This action will return if the Item2D is currently flipped across the x-axis.

Return

boolean:

This action will return if the Item2D is currently flipped across the y-axis.

Return

boolean:

This action returns whether or not the Item can currently receive focus. This property can be set with SetFocusable().

Return

boolean:

The IsFocused action determines if this Item is currently focused, returning true if it is, or false if it is not.

Return

boolean:

This flag tells the textbox to move the focus on a tab, as opposed to doing indentation. This thus directly turns off the indentation manager.

Return

boolean:

This action gets the number of broadphase nodes this item has. This action is used internally and users should not need to use this action.

Return

boolean: The number of broadphase nodes attached to this item

This action returns true if the item has been added to a Layer, or false otherwise.

Return

boolean: True if the item is on a Layer, or false otherwise.

This action determines whether physics is currently enabled for this item.

Return

boolean: True if physics is enabled for this item, false otherwise

This action determines if the TextBox should place characters so that they're touching the base line. In practice, if this is true, the TextBox will position characters slightly lower, providing more whitespace above the first line. If this value is false, the characters will be positioned higher, which may look better for TextBoxes that are approximately one line in height. The default value is true.

Return

boolean:

Returns true if rendering the focus event.

Return

boolean:

Returns true if rendering the mouse down event.

Return

boolean:

Returns true if rendering the mouse over event.

Return

boolean:

Returns true if rendering the selection event.

Return

boolean:

This action sets this item to be collidable. Passing true turns on collision for this item while passing false turns off collision for this item.

Return

boolean:

This action determines whether physics is currently enabled for this item.

Return

boolean: True if physics is enabled for this item, false otherwise

This action returns whether the Item is currently set to be visible on the screen.

Return

boolean: A boolean representing whether or not the Item is currently visible.

This action translate a pixel value to a percentage scroll Y value. The pixel value is relative to the Spreadsheet.

Return

boolean:

This action returns a percentage (represented between 0 and 1) indicating how much of the content's height can be viewed in the scrollable region. For example, if the content is 400 pixels tall and the scrollable region is 100 pixels tall, the percent of viewable height returned will be 0.25. This value cannot be set directly. It is calculated from the dimensions of the content and the Control.

Return

boolean:

This action gets the position of the center of this item in local coordinates (i.e., with respect to itself).

Return

boolean: The vector representing the center of this item in local coordinates

This action sets the x-component of this item's linear velocity in units per second. Physics must be enabled on this item before using this action.

Return

boolean:

This action creates the nodes for this item for the broadphase collision. This action is needed in order to add the item to the collision detection system. This action is used internally and users should not need to use this action.

Return

boolean:

This action is used to load the graphical components of the Control. This is handled automatically by the Game engine as needed, and most users shouldn't need to use this action directly.

Parameters

• Libraries.Interface.Layouts.LayoutProperties

This action locks a region of the TextBox from being edited.

Parameters

• integer lockStart
• integer lockEnd

Force a recalculation of the width by setting its value to -1.

Parameters

• Libraries.Interface.Events.FocusEvent

This action is used when a control loses the selection.

This action positions the caret in accordance with the provided mouse event. This is called internally by the system as needed, and shouldn't be called directly by users.

Parameters

• Libraries.Interface.Events.MouseEvent
• boolean dragging

This action will increase the x and y coordinates of this Item by the values stored in the provided Vector2.

Parameters

• Libraries.Compute.Vector2

This action will increase the x and y coordinates of this Item by the given amounts.

Parameters

• number xAmount
• number yAmount

The MoveCaretDown action moves the caret one position downward, as if the user had just pressed the down arrow key. If the provided boolean is true, the action will adjust the selection as the caret moves.

Parameters

• boolean selecting: Whether or not the selection should be modified as the caret moves.

The MoveCaretLeft action moves the caret one position to the left, as if the user had just pressed the left arrow key. If the provided boolean is true, the action will adjust the selection as the caret moves.

Parameters

• boolean selecting: Whether or not the selection should be modified as the caret moves.

The MoveCaretRight action moves the caret one position to the right, as if the user had just pressed the right arrow key. If the provided boolean is true, the action will adjust the selection as the caret moves.

Parameters

• boolean selecting: Whether or not the selection should be modified as the caret moves.

The MoveCaretUp action moves the caret one position upwards, as if the user had just pressed the up arrow key. If the provided boolean is true, the action will adjust the selection as the caret moves.

Parameters

• boolean selecting: Whether or not the selection should be modified as the caret moves.

This action will increase the x-coordinate of this Item by the given amount.

Parameters

• number xAmount

This action will increase the y-coordinate of this Item by the given amount.

Parameters

• number yAmount

This action will increase the z-coordinate of this Item by the given amount.

Parameters

• number zAmount

This action is used to respond to a MouseEvent created by the mouse moving.

Parameters

• Libraries.Interface.Events.MouseEvent: A MouseEvent describing the mouse movement.

This action returns whether or not the Control is in need of laying out by its container (or the parent Layer2D, if no container Control exists).

Return

boolean:

This action adds a different Item2D into this one, storing the added Item2D at a specific index in the internal array.

Parameters

• Libraries.Interface.Events.ControlActivationEvent

This action will notify all SelectionListeners which have been added to the Control of the given SelectionEvent.

Parameters

• Libraries.Interface.Events.SelectionEvent: The SelectionEvent to send to all SelectionListeners registered with the Control.

Checks to see if the Item2D's internal vertices are up to date, and updates them if they are not. This is used primarily internally to ensure that the item's vertices are properly aligned before use, e.g. to project an image on the screen at the coordinates of the vertices. Most users will never need to use this action directly.

This action takes a gesture event and handles it. It will first test to see if the gesture event took place within the bounds of this Item. If so, it will notify any GestureListeners of the event. If the event was not contained within this Item, or if there are no GestureListeners on this Item, the Item will ask its parent Item to process the event, if there is a parent.

Parameters

• Libraries.Interface.Events.GestureEvent

This action takes a mouse event and handles it. It will first test to see if the mouse event took place within the bounds of this Item. If so, it will notify any MouseListeners of the event. If the event was not contained within this Item, or if there are no MouseListeners on this Item, the Item will ask its parent Item to process the mouse event, if there is a parent.

Parameters

• Libraries.Interface.Events.MouseEvent

This action takes a touch event and handles it. It will first test to see if the touch event took place within the bounds of this Item. If so, it will notify any TouchListeners of the event. If the event was not contained within this Item, or if there are no TouchListeners on this Item, the Item will ask its parent Item to process the touch event, if there is a parent.

Parameters

• Libraries.Interface.Events.TouchEvent

This action is used to draw this Item on the screen, and then draw all of the Item's children hierarchy on the screen. Note that Items themselves can not be drawn, but some classes that extend the Item class, such as the Libraries.Game.Graphics.Drawable class, can be. To see how they draw, see their documentation.

Parameters

• Libraries.Game.Graphics.Painter2D

This action inserts the provided text at the requested global text index. This action does not move the caret and has no otherwise visual impact.

Parameters

• Libraries.Interface.Events.MouseEvent

This action is used when a control is released by the mouse.

This action removes an Item2D at a specifed index from the internal array.

Parameters

• integer index

Return

Libraries.Interface.Item2D:

Parameters

• Libraries.Interface.Controls.Gutter

This action removes an Item2D from the internal array.

Parameters

• Libraries.Interface.Item2D

Return

boolean:

This action removes an Item2D from the internal array.

Parameters

• Libraries.Interface.Events.ControlActivationListener

This action removes a FocusListener from the Item. The listener will no longer receive notification if the Item gets a FocusEvent.

Parameters

• Libraries.Interface.Events.FocusListener

This action removes a GestureListener from the Item. The listener will no longer receive notification if the Item gets a GestureEvent.

Parameters

• Libraries.Interface.Events.GestureListener

The DeleteForward action deletes a portion of the text, as if the user had just pressed the delete key. If a portion of text is selected, the selection will be deleted -- otherwise, the character immediately following the caret will be deleted.

Parameters

• integer index

The ideal long-term solution is to have each line in the MultipleLineText class maintain its width, which is updated during changes. Then finding the width is O(n) for n lines. Currently that class only maintains text for monospaced fonts, so we calculate from that for now. This approach only works due to the constrained conditions of the first version of this TextBox: - All of the text is styled with a single font. - The text is monospaced. If it isn't, we attempt to err on the side of too much space, rather than not enough.

Returns true if rendering the mouse over event.

Parameters

• Libraries.Interface.Layouts.LayoutProperties

This action removes a MouseListener from the Item. The listener will no longer receive notification if the Item gets a mouse click event.

Parameters

• Libraries.Interface.Events.MouseListener

This action removes a MouseMovementListener from the Item. The listener will no longer receive notification if the Item gets a mouse movement event.

Parameters

• Libraries.Interface.Events.MouseMovementListener

This action removes a MouseWheelListener from the Item. The listener will no longer receive notification if the Item gets a mouse wheel event.

Parameters

• Libraries.Interface.Events.MouseWheelListener

This action removes the given SelectionListeners from the Control.

Parameters

• Libraries.Interface.Events.SelectionListener: the selectionListener to remove from the control.

Return

boolean: true if the selectionListener is removed.

If going down a line made us escape the locked region, reset the values back and return.

Parameters

• Libraries.Interface.Events.TextChangeListener

The GetLineSeparator action returns the text which is used to designate the end of a line in the TextBox. By default, this is the same as the value used by the operating system.

Parameters

• Libraries.Interface.Controls.TextStyles.TextStyle

Return

boolean: The character(s) used to designate the end of a line.

False if no text styles were applied to the character, true if we did apply something.

Parameters

• text name

Return

boolean:

This action removes a TouchListener from the Item. The listener will no longer receive notification if the Item gets a TouchEvent.

Parameters

• Libraries.Interface.Events.TouchListener

This action requests that this Control should be laid out by its container (or the Layer2D if there is no containing Control) during the next Update.

This action requests that this Control (as well as all of its descendents) should reload their graphics during the next Update.

This action informs the engine that this Item needs to recalculate its vertex values before they can be used (most commonly, to be drawn to the screen). Most users will never need to call this directly. If you are using a custom ShaderProgram with this Item, you can use this action to indicate that the shader mapping should reset the vertex values for this Item before its drawn again.

This action sets the y-component of this item's linear velocity in units per second. Physics must be enabled on this item before using this action.

Parameters

• boolean flag

This action is used to indicate that the Control no longer needs to be laid out. This is called internally by the system as needed, and shouldn't be necessary for most users.

This action sets the mass, mass moment of inertia, and how the 2D item should move (via linear velocity) to be at the desired location.

The Resize action is used to recalculate the size and position of Controls that are being controlled by a Layout. Calling Resize on an Item2D won't have a direct effect on it, but if the Item's children hierarchy contains any Controls, those Controls will be resized.

Rotates this Item2D by the given number of degrees. This will also rotate all Items in the children hierarchy of this Item.

Parameters

• number degrees

This action will multiply the current scaling value by the given number. A parameter of 0 or less will be ignored.

Parameters

• number amount

This action will multiply the x scaling and y scaling values, respectively, by the given numbers. A parameter of 0 or less will be ignored.

Parameters

• number xAmount
• number yAmount

This action will multiply the current scaling value by the given number. A parameter of 0 or less will be ignored. This action will increase or decrease the scale of the object from the center, and update the Item's x,y coordinates to reflect the new bottom-left corner of the Item.

Parameters

• number amount

This action will multiply the current scaling values of the x and y planes by the given number. A parameter of 0 or less will be ignored. This action will increase or decrease the scale of the object from the center, and update the Item's x,y coordinates to reflect the new bottom-left corner of the Item.

Parameters

• number xAmount
• number yAmount

This action translate a pixel value to a percentage scroll X value. The pixel value is relative to the Spreadsheet.

Parameters

• Libraries.Interface.Events.MouseEvent

Force a recalculation of the width by setting its value to -1.

Parameters

• integer startIndex
• integer endIndex

The DeleteBackward action deletes a portion of the text, as if the user had just pressed the backspace key. If a portion of text is selected, the selection will be deleted -- otherwise, the character immediately preceding the caret will be deleted.

Parameters

• integer startIndex
• integer endIndex
• boolean caretAtEnd

This action selects an item in the Control using first letter navigation, if the Control supports it. If the Control doesn't support first letter navigation, this will do nothing.

Parameters

• text firstLetter

This action sets the accent color on the control.

Parameters

• Libraries.Game.Graphics.ColorGroup: the accent control.

This action sets whether or not this Item accepts mouse input. If set to true, this will intercept incoming mouse events, triggering any related MouseListeners and InputSets and preventing the mouse event from propagating to other Items on the Layer. The default value is true.

Parameters

• boolean accepts: True to set this Item to receive mouse events, or false to ignore them.

This action changes the accessibility code for this Item. This should be done with care because setting the accessiblity code to the incorrect type can cause accessibility to stop functioning or, in some cases, cause the program to crash.

Parameters

• integer newAccessibilityCode: the new accessibility code for this Item.

This action sets a custom accessibility role description for this item. This should only be done if there is not a standard accessibility code for the type of item being implemented. If the item behaves very similarly to a standard control type, then set the accessibility code to that standard type while also setting the role description. For example, if implementing an item that extends Control, is keyboard focusable, and responds to activation via both mouse clicks and the Space key, like a button, but it shouldn't be described as a button, then set the accessibility code to BUTTON and the custom role description to whatever is appropriate. If there isn't a suitable accessibility code, or if in doubt, set the accessibility code to CUSTOM.

Parameters

• text newRoleDescription: the new custom role description for this Item.

This action gets the rotational inertia of this item. The inertia is in kilogram units squared.

Parameters

• number angularDamping

This action sets this item's angular velocity in radians per second. Physics must be enabled in this item before using this action.

Parameters

• number angularVelocity: The angular velocity of this item in radians per second

This action sets the background color in the Control.

Parameters

• Libraries.Game.Graphics.ColorGroup: the background color.

This action sets how far the view of content should be scrolled along the y-axis. In other words, it's a percentage represented between 0 and 1 indicating how far the vertical scroll bar should be moved downwards. This percentage represents the position of the start of the scroll bar. For example, a scroll percent of 0.4 indicates that the view begins 40% of the way through the scrollable area.

Parameters

• integer barThickness

This action sets the border color of the control.

Parameters

• Libraries.Game.Graphics.ColorGroup: the border color.

This action sets the border style either, LayoutProperties.TOP, LayoutProperties.BOTTOM, LayoutProperties.LEFT, LayoutProperties.RIGHT, and LayoutProperties.ALL.

Parameters

• integer style

This action sets the border thickness on the control.

Parameters

• number value: the border thickness.

This action sets the bottom left pixel rounding value.

Parameters

• number value: the bottom left pixel rounding value.

This action sets the bottom left rounding value.

Parameters

• number value: the bottom left rounding value.

This action sets the bottom margin size. The bottom margin is the space outside of the bottom border.

Parameters

• number padding: the amount of bottom margin.

This action sets the bottom padding size. The bottom padding is the space inside of the bottom border.

Parameters

• number padding: the amount of bottom margin.

This action sets the bottom right pixel rounding value.

Parameters

• number value: the bottom right pixel rounding value.

This action sets the bottom right rounding value.

Parameters

• number value: the bottom right rounding value.

This action will set the x coordinate, y coordinate, width, and height of the Item2D, respectively.

Parameters

• number newX
• number newY
• number newWidth
• number newHeight

This action sets how long it takes for the caret to cycle between visible and hidden when the caret is idle. The time provided describes the number of seconds it takes to transition from one stage to another -- e.g., if the provided time is one second, the caret will remain visible for one second, then hide for one second, and so on.

Parameters

• number time: The number of seconds the caret should wait before cycling between visible and hidden while idle.

This action sets the number of seconds the caret should wait before automatically moving when the user presses and holds a movement key.

Parameters

• number time: The number of seconds a user must hold a movement key before the caret moves automatically.

This action sets the number of seconds it should take for the caret to move a single character when the caret is automatically moving due to the user pressing and holding a movement key.

Parameters

• number time: The number of seconds it takes for an automatically moving caret to move a single character.

The SetCaretPosition action places the caret at the requested global index within the text of the TextBox. Note that if the index requested would be in the middle of a line separator, the caret will be placed at the end of the line separator on the next line, which can cause the actual index of the caret to be slightly higher. If the selection is locked to a region, attempting to set the caret to a position outside of the lock will instead go to the appropriate end of the locked region instead.

Parameters

• integer index

The SetCaretPositionToLine action sets the caret to the beginning of the specified line.

Parameters

• integer line

This action will set the X and Y coordinates of the Item so that the center of the Item is located at the given X, Y coordinates.

Parameters

• number setX
• number setY

This action will set the X coordinate of the Item so that the center of the Item is aligned with the given X coordinate value.

Parameters

• number setX

This action will set the Y coordinate of the Item so that the center of the Item is aligned with the given Y coordinate value.

Parameters

• number setY

The SetChildrenProcessingMouseEvents action is used to set whether or not children items should receive mouse events if this Item is using custom drawing. This affects only custom drawing Items -- if the Item isn't drawing, children objects will always receive the mouse events first. This value is false by default. This is an advanced feature only necessary for complex custom components, and most users will not need to use this.

Parameters

• boolean shouldProcess

This action sets the clipping coordinates of the given painter to respect the coordinates of this Item (if it's clipping) as well as any clipping being performed by parent Items. This action is called automatically by the Game engine as necessary, and most users will never need to use this action directly.

Parameters

• Libraries.Game.Graphics.Painter2D

The SetClipping action is used to enable or disable clipping. If it is enabled, when the Item and its children are drawn as part of the QueueForDrawing action, any pixels that would be drawn outside of the unrotated dimensions of the Item are not rendered. In other words, the Item will only draw inside the exact rectangle formed by its x, y position and its width and height.

Parameters

• boolean clip: True to enable pixel clipping, false to disable.

This action sets this item to be collidable. Passing true turns on collision for this item while passing false turns off collision for this item.

Parameters

• boolean flag: Whether or not to turn collision on for this item

This action gets the position of the item in physics space from the previous frame. This action is used internally and users should not need to use this action

Parameters

• boolean flag

This action sets the total torque on this item. The units are kilogram units squared per second per second. This action should be used to set the total torque on this item. If we want to apply a torque to this item, we should use the ApplyTorque actions instead. Physics must be enabled on this action before using this action.

Parameters

• boolean flag

This action sets the total force on this item. The units are kilogram units per second per second. This action should be used to set the total force on this item. If we want to apply a force to this item, we should use the ApplyForce actions instead. Physics must be enabled on this item before using this action.

Parameters

• integer index

This is an action used internally by the physics system to keep track of the collisions with this item in a linked list structure. This action sets the head of the linked list of collisions to the passed CollisionEdge2D object. This action is used internally and users should not need to use this action.

Parameters

• Libraries.Game.Collision.CollisionEdge2D: The new head of the linked list of collisions

This action sets the color and property in the Control.

Parameters

• text property
• Libraries.Game.Graphics.ColorGroup: the color.

This action sets how many rows this Control should be divided into when using a GridLayout. This will have no effect if this Control is not a container or if it is using a different layout. If this value is 0 or less, then the GridLayout will use its default grid height and ignore this value.

Parameters

• integer containerGridHeight

This action sets how many columns this Control should be divided into when using a GridLayout. This will have no effect if this Control is not a container or if it is using a different layout. If this value is 0 or less, then the GridLayout will use its default grid width and ignore this value.

Parameters

• integer containerGridWidth

This action sets how much rounding to apply to the four corners of a rectangular control. This action takes the amount of rounding to apply as a number of pixels.

Parameters

• number bottomLeft: The rounding value to be applied to the bottom left corner, in pixels.
• number bottomRight: The rounding value to be applied to the bottom right corner, in pixels.
• number topLeft: The rounding value to be applied to the top left corner, in pixels.
• number topRight: The rounding value to be applied to the top right corner, in pixels.

This action sets how much rounding to apply to the four corners of a rectangular control. The expected values are between 0 and 1, where 0 indicates no rounding, and 1 indicates full rounding. (If all four corners are set to have full rounding, the result will appear to be a circle.)

Parameters

• number bottomLeft: The rounding value to be applied to the bottom left corner (between 0 and 1).
• number bottomRight: The rounding value to be applied to the bottom right corner (between 0 and 1).
• number topLeft: The rounding value to be applied to the top left corner (between 0 and 1).
• number topRight: The rounding value to be applied to the top right corner (between 0 and 1).

The SetCustomDrawing action is used to indicate that this Item wants to directly manage how itself and its children are drawn. When this is set to true, the Item must be responsible for determining this rendering via the Draw(Painter2D) action -- if this action isn't overridden, the Item and its children won't be drawn. This is an advanced feature only necessary for complex custom components, and most users will not need to use this functionality.

Parameters

• boolean isCustom: True if this Item should use custom drawing, or false to use default drawing rules.

This action applies an angular impulse to this item. The units are in kilogram units squared per second. This modifies the angular velocity of this item. Physics must be enabled on this item before using this action.

Parameters

• number density