The Sprite class is a basic display list building block: a display list node that can display graphics and can also contain children.

A Sprite object is similar to a movie clip, but does not have a timeline. Sprite is an appropriate base class for objects that do not require timelines. For example, Sprite would be a logical base class for user interface(UI) components that typically do not use the timeline.

The Sprite class is new in ActionScript 3.0. It provides an alternative to the functionality of the MovieClip class, which retains all the functionality of previous ActionScript releases to provide backward compatibility.

### Hierarchy

- DisplayObjectContainer
  - Sprite
    - DOMSprite
    - MovieClip

### Implements

- IEventDispatcher
- IBitmapDrawable

## Index

### Constructors

- constructor

### Properties

- alpha
- blendMode
- buttonMode
- cacheAsBitmap
- doubleClickEnabled
- dropTarget
- filters
- focusRect
- graphics
- height
- hitArea
- loaderInfo
- mask
- mouseChildren
- mouseEnabled
- mouseX
- mouseY
- name
- needsSoftKeyboard
- numChildren
- opaqueBackground
- parent
- root
- rotation
- scale9Grid
- scaleX
- scaleY
- scrollRect
- softKeyboardInputAreaOfInterest
- stage
- tabChildren
- tabEnabled
- tabIndex
- transform
- useHandCursor
- visible
- width
- x
- y

### Methods

- addChild
- addChildAt
- addEventListener
- areInaccessibleObjectsUnderPoint
- contains
- dispatchEvent
- getBounds
- getChildAt
- getChildByName
- getChildIndex
- getObjectsUnderPoint
- getRect
- globalToLocal
- hasEventListener
- hitTestObject
- hitTestPoint
- localToGlobal
- removeChild
- removeChildAt
- removeChildren
- removeEventListener
- requestSoftKeyboard
- setChildIndex
- startDrag
- stopAllMovieClips
- stopDrag
- swapChildren
- swapChildrenAt
- toString
- willTrigger

## Constructors

### constructor

- new Sprite(): Sprite

- Overrides DisplayObjectContainer.constructor

  - Defined in lib/openfl/display/Sprite.d.ts:93

  Creates a new Sprite instance. After you create the Sprite instance, call the `DisplayObjectContainer.addChild()` or `DisplayObjectContainer.addChildAt()` method to add the Sprite to a parent DisplayObjectContainer.

  #### Returns Sprite

## Properties

### alpha

alpha: number

Inherited from DisplayObject.alpha

- Defined in lib/openfl/display/DisplayObject.d.ts:159

Indicates the alpha transparency value of the object specified. Valid values are 0(fully transparent) to 1(fully opaque). The default value is

1. Display objects with `alpha` set to 0 are active, even though they are invisible.

### blendMode

blendMode: BlendMode

Inherited from DisplayObject.blendMode

- Defined in lib/openfl/display/DisplayObject.d.ts:185

A value from the BlendMode class that specifies which blend mode to use. A bitmap can be drawn internally in two ways. If you have a blend mode enabled or an external clipping mask, the bitmap is drawn by adding a bitmap-filled square shape to the vector render. If you attempt to set this property to an invalid value, Flash runtimes set the value to `BlendMode.NORMAL`.

The `blendMode` property affects each pixel of the display object. Each pixel is composed of three constituent colors(red, green, and blue), and each constituent color has a value between 0x00 and 0xFF. Flash Player or Adobe AIR compares each constituent color of one pixel in the movie clip with the corresponding color of the pixel in the background. For example, if `blendMode` is set to `BlendMode.LIGHTEN`, Flash Player or Adobe AIR compares the red value of the display object with the red value of the background, and uses the lighter of the two as the value for the red component of the displayed color.

The following table describes the `blendMode` settings. The BlendMode class defines string values you can use. The illustrations in the table show `blendMode` values applied to a circular display object(2) superimposed on another display object(1).

### buttonMode

buttonMode: boolean

- Defined in lib/openfl/display/Sprite.d.ts:57

Specifies the button mode of this sprite. If `true`, this sprite behaves as a button, which means that it triggers the display of the hand cursor when the pointer passes over the sprite and can receive a `click` event if the enter or space keys are pressed when the sprite has focus. You can suppress the display of the hand cursor by setting the `useHandCursor` property to `false`, in which case the pointer is displayed.

Although it is better to use the SimpleButton class to create buttons, you can use the `buttonMode` property to give a sprite some button-like functionality. To include a sprite in the tab order, set the `tabEnabled` property(inherited from the InteractiveObject class and `false` by default) to `true`. Additionally, consider whether you want the children of your sprite to be user input enabled. Most buttons do not enable user input interactivity for their child objects because it confuses the event flow. To disable user input interactivity for all child objects, you must set the `mouseChildren` property(inherited from the DisplayObjectContainer class) to `false`.

If you use the `buttonMode` property with the MovieClip class(which is a subclass of the Sprite class), your button might have some added functionality. If you include frames labeled _up, _over, and _down, Flash Player provides automatic state changes(functionality similar to that provided in previous versions of ActionScript for movie clips used as buttons). These automatic state changes are not available for sprites, which have no timeline, and thus no frames to label.

### cacheAsBitmap

cacheAsBitmap: boolean

Inherited from DisplayObject.cacheAsBitmap

- Defined in lib/openfl/display/DisplayObject.d.ts:242

All vector data for a display object that has a cached bitmap is drawn to the bitmap instead of the main display. If `cacheAsBitmapMatrix` is null or unsupported, the bitmap is then copied to the main display as unstretched, unrotated pixels snapped to the nearest pixel boundaries. Pixels are mapped 1 to 1 with the parent object. If the bounds of the bitmap change, the bitmap is recreated instead of being stretched.

If `cacheAsBitmapMatrix` is non-null and supported, the object is drawn to the off-screen bitmap using that matrix and the stretched and/or rotated results of that rendering are used to draw the object to the main display.

No internal bitmap is created unless the `cacheAsBitmap` property is set to `true`.

After you set the `cacheAsBitmap` property to `true`, the rendering does not change, however the display object performs pixel snapping automatically. The animation speed can be significantly faster depending on the complexity of the vector content.

The `cacheAsBitmap` property is automatically set to `true` whenever you apply a filter to a display object(when its `filter` array is not empty), and if a display object has a filter applied to it, `cacheAsBitmap` is reported as `true` for that display object, even if you set the property to `false`. If you clear all filters for a display object, the `cacheAsBitmap` setting changes to what it was last set to.

A display object does not use a bitmap even if the `cacheAsBitmap` property is set to `true` and instead renders from vector data in the following cases:

- The bitmap is too large. In AIR 1.5 and Flash Player 10, the maximum size for a bitmap image is 8,191 pixels in width or height, and the total number of pixels cannot exceed 16,777,215 pixels.(So, if a bitmap image is 8,191 pixels wide, it can only be 2,048 pixels high.) In Flash Player 9 and earlier, the limitation is is 2880 pixels in height and 2,880 pixels in width.
- The bitmap fails to allocate(out of memory error).

The `cacheAsBitmap` property is best used with movie clips that have mostly static content and that do not scale and rotate frequently. With such movie clips, `cacheAsBitmap` can lead to performance increases when the movie clip is translated(when its x and y position is changed).

### doubleClickEnabled

doubleClickEnabled: boolean

Inherited from InteractiveObject.doubleClickEnabled

- Defined in lib/openfl/display/InteractiveObject.d.ts:1072

Specifies whether the object receives `doubleClick` events. The default value is `false`, which means that by default an InteractiveObject instance does not receive `doubleClick` events. If the `doubleClickEnabled` property is set to `true`, the instance receives `doubleClick` events within its bounds. The `mouseEnabled` property of the InteractiveObject instance must also be set to `true` for the object to receive `doubleClick` events.

No event is dispatched by setting this property. You must use the `addEventListener()` method to add an event listener for the `doubleClick` event.

### dropTarget

dropTarget: DisplayObject

- Defined in lib/openfl/display/Sprite.d.ts:59

### filters

filters: Array< BitmapFilter >

Inherited from DisplayObject.filters

- Defined in lib/openfl/display/DisplayObject.d.ts:319

An indexed array that contains each filter object currently associated with the display object. The openfl.filters package contains several classes that define specific filters you can use.

Filters can be applied in Flash Professional at design time, or at run time by using ActionScript code. To apply a filter by using ActionScript, you must make a temporary copy of the entire `filters` array, modify the temporary array, then assign the value of the temporary array back to the `filters` array. You cannot directly add a new filter object to the `filters` array.

To add a filter by using ActionScript, perform the following steps (assume that the target display object is named `myDisplayObject`):

1. Create a new filter object by using the constructor method of your chosen filter class.
2. Assign the value of the `myDisplayObject.filters` array to a temporary array, such as one named `myFilters`.
3. Add the new filter object to the `myFilters` temporary array.
4. Assign the value of the temporary array to the `myDisplayObject.filters` array.

If the `filters` array is undefined, you do not need to use a temporary array. Instead, you can directly assign an array literal that contains one or more filter objects that you create. The first example in the Examples section adds a drop shadow filter by using code that handles both defined and undefined `filters` arrays.

To modify an existing filter object, you must use the technique of modifying a copy of the `filters` array:

1. Assign the value of the `filters` array to a temporary array, such as one named `myFilters`.
2. Modify the property by using the temporary array, `myFilters`. For example, to set the quality property of the first filter in the array, you could use the following code: `myFilters[0].quality = 1;`
3. Assign the value of the temporary array to the `filters` array.

At load time, if a display object has an associated filter, it is marked to cache itself as a transparent bitmap. From this point forward, as long as the display object has a valid filter list, the player caches the display object as a bitmap. This source bitmap is used as a source image for the filter effects. Each display object usually has two bitmaps: one with the original unfiltered source display object and another for the final image after filtering. The final image is used when rendering. As long as the display object does not change, the final image does not need updating.

The openfl.filters package includes classes for filters. For example, to create a DropShadow filter, you would write:

throws

  ArgumentError When `filters` includes a ShaderFilter and the shader output type is not compatible with this operation(the shader must specify a `pixel4` output).

throws

  ArgumentError When `filters` includes a ShaderFilter and the shader doesn't specify any image input or the first input is not an `image4` input.

throws

  ArgumentError When `filters` includes a ShaderFilter and the shader specifies an image input that isn't provided.

throws

  ArgumentError When `filters` includes a ShaderFilter, a ByteArray or Vector.<Number> instance as a shader input, and the `width` and `height` properties aren't specified for the ShaderInput object, or the specified values don't match the amount of data in the input data. See the `ShaderInput.input` property for more information.

### focusRect

focusRect: boolean | null

Inherited from InteractiveObject.focusRect

- Defined in lib/openfl/display/InteractiveObject.d.ts:1074

### graphics

graphics: Graphics

- Defined in lib/openfl/display/Sprite.d.ts:65

Specifies the Graphics object that belongs to this sprite where vector drawing commands can occur.

### height

height: number

Inherited from DisplayObject.height

- Defined in lib/openfl/display/DisplayObject.d.ts:331

Indicates the height of the display object, in pixels. The height is calculated based on the bounds of the content of the display object. When you set the `height` property, the `scaleY` property is adjusted accordingly, as shown in the following code:

Except for TextField and Video objects, a display object with no content(such as an empty sprite) has a height of 0, even if you try to set `height` to a different value.

### hitArea

hitArea: Sprite

- Defined in lib/openfl/display/Sprite.d.ts:67

### loaderInfo

loaderInfo: LoaderInfo

Inherited from DisplayObject.loaderInfo

- Defined in lib/openfl/display/DisplayObject.d.ts:346

Returns a LoaderInfo object containing information about loading the file to which this display object belongs. The `loaderInfo` property is defined only for the root display object of a SWF file or for a loaded Bitmap(not for a Bitmap that is drawn with ActionScript). To find the `loaderInfo` object associated with the SWF file that contains a display object named `myDisplayObject`, use `myDisplayObject.root.loaderInfo`.

A large SWF file can monitor its download by calling `this.root.loaderInfo.addEventListener(Event.COMPLETE, func)`.

### mask

mask: DisplayObject

Inherited from DisplayObject.mask

- Defined in lib/openfl/display/DisplayObject.d.ts:379

The calling display object is masked by the specified `mask` object. To ensure that masking works when the Stage is scaled, the `mask` display object must be in an active part of the display list. The `mask` object itself is not drawn. Set `mask` to `null` to remove the mask.

To be able to scale a mask object, it must be on the display list. To be able to drag a mask Sprite object(by calling its `startDrag()` method), it must be on the display list. To call the `startDrag()` method for a mask sprite based on a `mouseDown` event being dispatched by the sprite, set the sprite's `buttonMode` property to `true`.

When display objects are cached by setting the `cacheAsBitmap` property to `true` an the `cacheAsBitmapMatrix` property to a Matrix object, both the mask and the display object being masked must be part of the same cached bitmap. Thus, if the display object is cached, then the mask must be a child of the display object. If an ancestor of the display object on the display list is cached, then the mask must be a child of that ancestor or one of its descendents. If more than one ancestor of the masked object is cached, then the mask must be a descendent of the cached container closest to the masked object in the display list.

Note: A single `mask` object cannot be used to mask more than one calling display object. When the `mask` is assigned to a second display object, it is removed as the mask of the first object, and that object's `mask` property becomes `null`.

### mouseChildren

mouseChildren: boolean

Inherited from DisplayObjectContainer.mouseChildren

- Defined in lib/openfl/display/DisplayObjectContainer.d.ts:54

Determines whether or not the children of the object are mouse, or user input device, enabled. If an object is enabled, a user can interact with it by using a mouse or user input device. The default is `true`.

This property is useful when you create a button with an instance of the Sprite class(instead of using the SimpleButton class). When you use a Sprite instance to create a button, you can choose to decorate the button by using the `addChild()` method to add additional Sprite instances. This process can cause unexpected behavior with mouse events because the Sprite instances you add as children can become the target object of a mouse event when you expect the parent instance to be the target object. To ensure that the parent instance serves as the target objects for mouse events, you can set the `mouseChildren` property of the parent instance to `false`.

No event is dispatched by setting this property. You must use the `addEventListener()` method to create interactive functionality.

### mouseEnabled

mouseEnabled: boolean

Inherited from InteractiveObject.mouseEnabled

- Defined in lib/openfl/display/InteractiveObject.d.ts:1092

Specifies whether this object receives mouse, or other user input, messages. The default value is `true`, which means that by default any InteractiveObject instance that is on the display list receives mouse events or other user input events. If `mouseEnabled` is set to `false`, the instance does not receive any mouse events(or other user input events like keyboard events). Any children of this instance on the display list are not affected. To change the `mouseEnabled` behavior for all children of an object on the display list, use `openfl.display.DisplayObjectContainer.mouseChildren`.

No event is dispatched by setting this property. You must use the `addEventListener()` method to create interactive functionality.

### mouseX

mouseX: number

Inherited from DisplayObject.mouseX

- Defined in lib/openfl/display/DisplayObject.d.ts:388

Indicates the x coordinate of the mouse or user input device position, in pixels.

Note: For a DisplayObject that has been rotated, the returned x coordinate will reflect the non-rotated object.

### mouseY

mouseY: number

Inherited from DisplayObject.mouseY

- Defined in lib/openfl/display/DisplayObject.d.ts:397

Indicates the y coordinate of the mouse or user input device position, in pixels.

Note: For a DisplayObject that has been rotated, the returned y coordinate will reflect the non-rotated object.

### name

name: string

Inherited from DisplayObject.name

- Defined in lib/openfl/display/DisplayObject.d.ts:409

Indicates the instance name of the DisplayObject. The object can be identified in the child list of its parent display object container by calling the `getChildByName()` method of the display object container.

throws

  IllegalOperationError If you are attempting to set this property on an object that was placed on the timeline in the Flash authoring tool.

### needsSoftKeyboard

needsSoftKeyboard: boolean

Inherited from InteractiveObject.needsSoftKeyboard

- Defined in lib/openfl/display/InteractiveObject.d.ts:1116

Specifies whether a virtual keyboard(an on-screen, software keyboard) should display when this InteractiveObject instance receives focus.

By default, the value is `false` and focusing an InteractiveObject instance does not raise a soft keyboard. If the `needsSoftKeyboard` property is set to `true`, the runtime raises a soft keyboard when the InteractiveObject instance is ready to accept user input. An InteractiveObject instance is ready to accept user input after a programmatic call to set the Stage `focus` property or a user interaction, such as a "tap." If the client system has a hardware keyboard available or does not support virtual keyboards, then the soft keyboard is not raised.

The InteractiveObject instance dispatches `softKeyboardActivating`, `softKeyboardActivate`, and `softKeyboardDeactivate` events when the soft keyboard raises and lowers.

Note: This property is not supported in AIR applications on iOS.

### numChildren

numChildren: number

Inherited from DisplayObjectContainer.numChildren

- Defined in lib/openfl/display/DisplayObjectContainer.d.ts:59

Returns the number of children of this object.

### opaqueBackground

opaqueBackground: number | null

Inherited from DisplayObject.opaqueBackground

- Defined in lib/openfl/display/DisplayObject.d.ts:435

Specifies whether the display object is opaque with a certain background color. A transparent bitmap contains alpha channel data and is drawn transparently. An opaque bitmap has no alpha channel(and renders faster than a transparent bitmap). If the bitmap is opaque, you specify its own background color to use.

If set to a number value, the surface is opaque(not transparent) with the RGB background color that the number specifies. If set to `null`(the default value), the display object has a transparent background.

The `opaqueBackground` property is intended mainly for use with the `cacheAsBitmap` property, for rendering optimization. For display objects in which the `cacheAsBitmap` property is set to true, setting `opaqueBackground` can improve rendering performance.

The opaque background region is not matched when calling the `hitTestPoint()` method with the `shapeFlag` parameter set to `true`.

The opaque background region does not respond to mouse events.

### parent

parent: DisplayObjectContainer

Inherited from DisplayObject.parent

- Defined in lib/openfl/display/DisplayObject.d.ts:451

Indicates the DisplayObjectContainer object that contains this display object. Use the `parent` property to specify a relative path to display objects that are above the current display object in the display list hierarchy.

You can use `parent` to move up multiple levels in the display list as in the following:

throws

  SecurityError The parent display object belongs to a security sandbox to which you do not have access. You can avoid this situation by having the parent movie call the `Security.allowDomain()` method.

### root

root: DisplayObject

Inherited from DisplayObject.root

- Defined in lib/openfl/display/DisplayObject.d.ts:479

For a display object in a loaded SWF file, the `root` property is the top-most display object in the portion of the display list's tree structure represented by that SWF file. For a Bitmap object representing a loaded image file, the `root` property is the Bitmap object itself. For the instance of the main class of the first SWF file loaded, the `root` property is the display object itself. The `root` property of the Stage object is the Stage object itself. The `root` property is set to `null` for any display object that has not been added to the display list, unless it has been added to a display object container that is off the display list but that is a child of the top-most display object in a loaded SWF file.

For example, if you create a new Sprite object by calling the `Sprite()` constructor method, its `root` property is `null` until you add it to the display list(or to a display object container that is off the display list but that is a child of the top-most display object in a SWF file).

For a loaded SWF file, even though the Loader object used to load the file may not be on the display list, the top-most display object in the SWF file has its `root` property set to itself. The Loader object does not have its `root` property set until it is added as a child of a display object for which the `root` property is set.

### rotation

rotation: number

Inherited from DisplayObject.rotation

- Defined in lib/openfl/display/DisplayObject.d.ts:489

Indicates the rotation of the DisplayObject instance, in degrees, from its original orientation. Values from 0 to 180 represent clockwise rotation; values from 0 to -180 represent counterclockwise rotation. Values outside this range are added to or subtracted from 360 to obtain a value within the range. For example, the statement `my_video.rotation = 450` is the same as `my_video.rotation = 90`.

### scale9Grid

scale9Grid: Rectangle

Inherited from DisplayObject.scale9Grid

- Defined in lib/openfl/display/DisplayObject.d.ts:553

The current scaling grid that is in effect. If set to `null`, the entire display object is scaled normally when any scale transformation is applied.

When you define the `scale9Grid` property, the display object is divided into a grid with nine regions based on the `scale9Grid` rectangle, which defines the center region of the grid. The eight other regions of the grid are the following areas:

- The upper-left corner outside of the rectangle
- The area above the rectangle
- The upper-right corner outside of the rectangle
- The area to the left of the rectangle
- The area to the right of the rectangle
- The lower-left corner outside of the rectangle
- The area below the rectangle
- The lower-right corner outside of the rectangle

You can think of the eight regions outside of the center(defined by the rectangle) as being like a picture frame that has special rules applied to it when scaled.

When the `scale9Grid` property is set and a display object is scaled, all text and gradients are scaled normally; however, for other types of objects the following rules apply:

- Content in the center region is scaled normally.
- Content in the corners is not scaled.
- Content in the top and bottom regions is scaled horizontally only. Content in the left and right regions is scaled vertically only.
- All fills(including bitmaps, video, and gradients) are stretched to fit their shapes.

If a display object is rotated, all subsequent scaling is normal(and the `scale9Grid` property is ignored).

For example, consider the following display object and a rectangle that is applied as the display object's `scale9Grid`:

A common use for setting `scale9Grid` is to set up a display object to be used as a component, in which edge regions retain the same width when the component is scaled.

throws

  ArgumentError If you pass an invalid argument to the method.

### scaleX

scaleX: number

Inherited from DisplayObject.scaleX

- Defined in lib/openfl/display/DisplayObject.d.ts:563

Indicates the horizontal scale(percentage) of the object as applied from the registration point. The default registration point is(0,0). 1.0 equals 100% scale.

Scaling the local coordinate system changes the `x` and `y` property values, which are defined in whole pixels.

### scaleY

scaleY: number

Inherited from DisplayObject.scaleY

- Defined in lib/openfl/display/DisplayObject.d.ts:573

Indicates the vertical scale(percentage) of an object as applied from the registration point of the object. The default registration point is(0,0). 1.0 is 100% scale.

Scaling the local coordinate system changes the `x` and `y` property values, which are defined in whole pixels.

### scrollRect

scrollRect: Rectangle

Inherited from DisplayObject.scrollRect

- Defined in lib/openfl/display/DisplayObject.d.ts:601

The scroll rectangle bounds of the display object. The display object is cropped to the size defined by the rectangle, and it scrolls within the rectangle when you change the `x` and `y` properties of the `scrollRect` object.

The properties of the `scrollRect` Rectangle object use the display object's coordinate space and are scaled just like the overall display object. The corner bounds of the cropped window on the scrolling display object are the origin of the display object(0,0) and the point defined by the width and height of the rectangle. They are not centered around the origin, but use the origin to define the upper-left corner of the area. A scrolled display object always scrolls in whole pixel increments.

You can scroll an object left and right by setting the `x` property of the `scrollRect` Rectangle object. You can scroll an object up and down by setting the `y` property of the `scrollRect` Rectangle object. If the display object is rotated 90° and you scroll it left and right, the display object actually scrolls up and down.

### softKeyboardInputAreaOfInterest

softKeyboardInputAreaOfInterest: Rectangle

Inherited from InteractiveObject.softKeyboardInputAreaOfInterest

- Defined in lib/openfl/display/InteractiveObject.d.ts:1117

### stage

stage: Stage

Inherited from DisplayObject.stage

- Defined in lib/openfl/display/DisplayObject.d.ts:613

The Stage of the display object. A Flash runtime application has only one Stage object. For example, you can create and load multiple display objects into the display list, and the `stage` property of each display object refers to the same Stage object(even if the display object belongs to a loaded SWF file).

If a display object is not added to the display list, its `stage` property is set to `null`.

### tabChildren

tabChildren: boolean

Inherited from DisplayObjectContainer.tabChildren

- Defined in lib/openfl/display/DisplayObjectContainer.d.ts:75

Determines whether the children of the object are tab enabled. Enables or disables tabbing for the children of the object. The default is `true`.

Note: Do not use the `tabChildren` property with Flex. Instead, use the `mx.core.UIComponent.hasFocusableChildren` property.

throws

  IllegalOperationError Calling this property of the Stage object throws an exception. The Stage object does not implement this property.

### tabEnabled

tabEnabled: boolean

Inherited from InteractiveObject.tabEnabled

- Defined in lib/openfl/display/InteractiveObject.d.ts:1118

### tabIndex

tabIndex: number

Inherited from InteractiveObject.tabIndex

- Defined in lib/openfl/display/InteractiveObject.d.ts:1119

### transform

transform: Transform

Inherited from DisplayObject.transform

- Defined in lib/openfl/display/DisplayObject.d.ts:653

An object with properties pertaining to a display object's matrix, color transform, and pixel bounds. The specific properties - matrix, colorTransform, and three read-only properties (`concatenatedMatrix`, `concatenatedColorTransform`, and `pixelBounds`) - are described in the entry for the Transform class.

Each of the transform object's properties is itself an object. This concept is important because the only way to set new values for the matrix or colorTransform objects is to create a new object and copy that object into the transform.matrix or transform.colorTransform property.

For example, to increase the `tx` value of a display object's matrix, you must make a copy of the entire matrix object, then copy the new object into the matrix property of the transform object: `var myMatrix:Matrix = myDisplayObject.transform.matrix; myMatrix.tx += 10; myDisplayObject.transform.matrix = myMatrix;`

You cannot directly set the `tx` property. The following code has no effect on `myDisplayObject`: `myDisplayObject.transform.matrix.tx += 10;`

You can also copy an entire transform object and assign it to another display object's transform property. For example, the following code copies the entire transform object from `myOldDisplayObj` to `myNewDisplayObj`: `myNewDisplayObj.transform = myOldDisplayObj.transform;`

The resulting display object, `myNewDisplayObj`, now has the same values for its matrix, color transform, and pixel bounds as the old display object, `myOldDisplayObj`.

Note that AIR for TV devices use hardware acceleration, if it is available, for color transforms.

### useHandCursor

useHandCursor: boolean

- Defined in lib/openfl/display/Sprite.d.ts:93

A Boolean value that indicates whether the pointing hand(hand cursor) appears when the pointer rolls over a sprite in which the `buttonMode` property is set to `true`. The default value of the `useHandCursor` property is `true`. If `useHandCursor` is set to `true`, the pointing hand used for buttons appears when the pointer rolls over a button sprite. If `useHandCursor` is `false`, the arrow pointer is used instead.

You can change the `useHandCursor` property at any time; the modified sprite immediately takes on the new cursor appearance.

Note: In Flex or Flash Builder, if your sprite has child sprites, you might want to set the `mouseChildren` property to `false`. For example, if you want a hand cursor to appear over a Flex control, set the `useHandCursor` and `buttonMode` properties to `true`, and the `mouseChildren` property to `false`.

### visible

visible: boolean

Inherited from DisplayObject.visible

- Defined in lib/openfl/display/DisplayObject.d.ts:660

Whether or not the display object is visible. Display objects that are not visible are disabled. For example, if `visible=false` for an InteractiveObject instance, it cannot be clicked.

### width

width: number

Inherited from DisplayObject.width

- Defined in lib/openfl/display/DisplayObject.d.ts:672

Indicates the width of the display object, in pixels. The width is calculated based on the bounds of the content of the display object. When you set the `width` property, the `scaleX` property is adjusted accordingly, as shown in the following code:

Except for TextField and Video objects, a display object with no content(such as an empty sprite) has a width of 0, even if you try to set `width` to a different value.

### x

x: number

Inherited from DisplayObject.x

- Defined in lib/openfl/display/DisplayObject.d.ts:684

Indicates the x coordinate of the DisplayObject instance relative to the local coordinates of the parent DisplayObjectContainer. If the object is inside a DisplayObjectContainer that has transformations, it is in the local coordinate system of the enclosing DisplayObjectContainer. Thus, for a DisplayObjectContainer rotated 90° counterclockwise, the DisplayObjectContainer's children inherit a coordinate system that is rotated 90° counterclockwise. The object's coordinates refer to the registration point position.

### y

y: number

Inherited from DisplayObject.y

- Defined in lib/openfl/display/DisplayObject.d.ts:696

Indicates the y coordinate of the DisplayObject instance relative to the local coordinates of the parent DisplayObjectContainer. If the object is inside a DisplayObjectContainer that has transformations, it is in the local coordinate system of the enclosing DisplayObjectContainer. Thus, for a DisplayObjectContainer rotated 90° counterclockwise, the DisplayObjectContainer's children inherit a coordinate system that is rotated 90° counterclockwise. The object's coordinates refer to the registration point position.

## Methods

### addChild

- addChild(child: DisplayObject ): DisplayObject

- Inherited from DisplayObjectContainer.addChild

  - Defined in lib/openfl/display/DisplayObjectContainer.d.ts:125

  Adds a child DisplayObject instance to this DisplayObjectContainer instance. The child is added to the front(top) of all other children in this DisplayObjectContainer instance.(To add a child to a specific index position, use the `addChildAt()` method.)

  If you add a child object that already has a different display object container as a parent, the object is removed from the child list of the other display object container.

  Note: The command `stage.addChild()` can cause problems with a published SWF file, including security problems and conflicts with other loaded SWF files. There is only one Stage within a Flash runtime instance, no matter how many SWF files you load into the runtime. So, generally, objects should not be added to the Stage, directly, at all. The only object the Stage should contain is the root object. Create a DisplayObjectContainer to contain all of the items on the display list. Then, if necessary, add that DisplayObjectContainer instance to the Stage.

  throws

    ArgumentError Throws if the child is the same as the parent. Also throws if the caller is a child(or grandchild etc.) of the child being added.

  :event

    added Dispatched when a display object is added to the display list.

  #### Parameters

  - ##### child: DisplayObject

    The DisplayObject instance to add as a child of this DisplayObjectContainer instance.

  #### Returns DisplayObject

  The DisplayObject instance that you pass in the `child` parameter.

### addChildAt

- addChildAt(child: DisplayObject, index: number): DisplayObject

- Inherited from DisplayObjectContainer.addChildAt

  - Defined in lib/openfl/display/DisplayObjectContainer.d.ts:157

  Adds a child DisplayObject instance to this DisplayObjectContainer instance. The child is added at the index position specified. An index of 0 represents the back(bottom) of the display list for this DisplayObjectContainer object.

  For example, the following example shows three display objects, labeled a, b, and c, at index positions 0, 2, and 1, respectively:

  If you add a child object that already has a different display object container as a parent, the object is removed from the child list of the other display object container.

  throws

    ArgumentError Throws if the child is the same as the parent. Also throws if the caller is a child(or grandchild etc.) of the child being added.

  throws

    RangeError Throws if the index position does not exist in the child list.

  :event

    added Dispatched when a display object is added to the display list.

  #### Parameters

  - ##### child: DisplayObject

    The DisplayObject instance to add as a child of this DisplayObjectContainer instance.

  - ##### index: number

    The index position to which the child is added. If you specify a currently occupied index position, the child object that exists at that position and all higher positions are moved up one position in the child list.

  #### Returns DisplayObject

  The DisplayObject instance that you pass in the `child` parameter.

### addEventListener

- addEventListener(type: string, listener: function, useCapture?: boolean, priority?: number, useWeakReference?: boolean): void

- Inherited from EventDispatcher.addEventListener

  - Defined in lib/openfl/events/EventDispatcher.d.ts:168

  Registers an event listener object with an EventDispatcher object so that the listener receives notification of an event. You can register event listeners on all nodes in the display list for a specific type of event, phase, and priority.

  After you successfully register an event listener, you cannot change its priority through additional calls to `addEventListener()`. To change a listener's priority, you must first call `removeListener()`. Then you can register the listener again with the new priority level.

  Keep in mind that after the listener is registered, subsequent calls to `addEventListener()` with a different `type` or `useCapture` value result in the creation of a separate listener registration. For example, if you first register a listener with `useCapture` set to `true`, it listens only during the capture phase. If you call `addEventListener()` again using the same listener object, but with `useCapture` set to `false`, you have two separate listeners: one that listens during the capture phase and another that listens during the target and bubbling phases.

  You cannot register an event listener for only the target phase or the bubbling phase. Those phases are coupled during registration because bubbling applies only to the ancestors of the target node.

  If you no longer need an event listener, remove it by calling `removeEventListener()`, or memory problems could result. Event listeners are not automatically removed from memory because the garbage collector does not remove the listener as long as the dispatching object exists(unless the `useWeakReference` parameter is set to `true`).

  Copying an EventDispatcher instance does not copy the event listeners attached to it.(If your newly created node needs an event listener, you must attach the listener after creating the node.) However, if you move an EventDispatcher instance, the event listeners attached to it move along with it.

  If the event listener is being registered on a node while an event is being processed on this node, the event listener is not triggered during the current phase but can be triggered during a later phase in the event flow, such as the bubbling phase.

  If an event listener is removed from a node while an event is being processed on the node, it is still triggered by the current actions. After it is removed, the event listener is never invoked again(unless registered again for future processing).

  throws

    ArgumentError The `listener` specified is not a function.

  #### Parameters

  - ##### type: string

    The type of event.

  - ##### listener: function

    - - (event: object): void

      - #### Parameters

        - ##### event: object

        #### Returns void

  - ##### Optional useCapture: boolean

    Determines whether the listener works in the capture phase or the target and bubbling phases. If `useCapture` is set to `true`, the listener processes the event only during the capture phase and not in the target or bubbling phase. If `useCapture` is `false`, the listener processes the event only during the target or bubbling phase. To listen for the event in all three phases, call `addEventListener` twice, once with `useCapture` set to `true`, then again with `useCapture` set to `false`.

  - ##### Optional priority: number

    The priority level of the event listener. The priority is designated by a signed 32-bit integer. The higher the number, the higher the priority. All listeners with priority n are processed before listeners of priority n-1. If two or more listeners share the same priority, they are processed in the order in which they were added. The default priority is 0.

  - ##### Optional useWeakReference: boolean

    Determines whether the reference to the listener is strong or weak. A strong reference(the default) prevents your listener from being garbage-collected. A weak reference does not.

                            Class-level member functions are not subject to
                            garbage collection, so you can set
                            `useWeakReference` to `true`
                            for class-level member functions without
                            subjecting them to garbage collection. If you set
                            `useWeakReference` to `true`
                            for a listener that is a nested inner function,
                            the function will be garbage-collected and no
                            longer persistent. If you create references to the
                            inner function(save it in another variable) then
                            it is not garbage-collected and stays
                            persistent.

  #### Returns void

### areInaccessibleObjectsUnderPoint

- areInaccessibleObjectsUnderPoint(point: Point ): boolean

- Inherited from DisplayObjectContainer.areInaccessibleObjectsUnderPoint

  - Defined in lib/openfl/display/DisplayObjectContainer.d.ts:180

  Indicates whether the security restrictions would cause any display objects to be omitted from the list returned by calling the `DisplayObjectContainer.getObjectsUnderPoint()` method with the specified `point` point. By default, content from one domain cannot access objects from another domain unless they are permitted to do so with a call to the `Security.allowDomain()` method. For more information, related to security, see the Flash Player Developer Center Topic: Security.

  The `point` parameter is in the coordinate space of the Stage, which may differ from the coordinate space of the display object container(unless the display object container is the Stage). You can use the `globalToLocal()` and the `localToGlobal()` methods to convert points between these coordinate spaces.

  #### Parameters

  - ##### point: Point

    The point under which to look.

  #### Returns boolean

  `true` if the point contains child display objects with security restrictions.

### contains

- contains(child: DisplayObject ): boolean

- Inherited from DisplayObjectContainer.contains

  - Defined in lib/openfl/display/DisplayObjectContainer.d.ts:195

  Determines whether the specified display object is a child of the DisplayObjectContainer instance or the instance itself. The search includes the entire display list including this DisplayObjectContainer instance. Grandchildren, great-grandchildren, and so on each return `true`.

  #### Parameters

  - ##### child: DisplayObject

    The child object to test.

  #### Returns boolean

  `true` if the `child` object is a child of the DisplayObjectContainer or the container itself; otherwise `false`.

### dispatchEvent

- dispatchEvent(event: Event ): boolean

- Inherited from EventDispatcher.dispatchEvent

  - Defined in lib/openfl/events/EventDispatcher.d.ts:186

  Dispatches an event into the event flow. The event target is the EventDispatcher object upon which the `dispatchEvent()` method is called.

  throws

    Error The event dispatch recursion limit has been reached.

  #### Parameters

  - ##### event: Event

    The Event object that is dispatched into the event flow. If the event is being redispatched, a clone of the event is created automatically. After an event is dispatched, its `target` property cannot be changed, so you must create a new copy of the event for redispatching to work.

  #### Returns boolean

  A value of `true` if the event was successfully dispatched. A value of `false` indicates failure or that `preventDefault()` was called on the event.

### getBounds

- getBounds(targetCoordinateSpace: DisplayObject ): Rectangle

- Inherited from DisplayObject.getBounds

  - Defined in lib/openfl/display/DisplayObject.d.ts:726

  Returns a rectangle that defines the area of the display object relative to the coordinate system of the `targetCoordinateSpace` object. Consider the following code, which shows how the rectangle returned can vary depending on the `targetCoordinateSpace` parameter that you pass to the method:

  Note: Use the `localToGlobal()` and `globalToLocal()` methods to convert the display object's local coordinates to display coordinates, or display coordinates to local coordinates, respectively.

  The `getBounds()` method is similar to the `getRect()` method; however, the Rectangle returned by the `getBounds()` method includes any strokes on shapes, whereas the Rectangle returned by the `getRect()` method does not. For an example, see the description of the `getRect()` method.

  #### Parameters

  - ##### targetCoordinateSpace: DisplayObject

    The display object that defines the coordinate system to use.

  #### Returns Rectangle

  The rectangle that defines the area of the display object relative to the `targetCoordinateSpace` object's coordinate system.

### getChildAt

- getChildAt(index: number): DisplayObject

- Inherited from DisplayObjectContainer.getChildAt

  - Defined in lib/openfl/display/DisplayObjectContainer.d.ts:211

  Returns the child display object instance that exists at the specified index.

  throws

    RangeError Throws if the index does not exist in the child list.

  throws

    SecurityError This child display object belongs to a sandbox to which you do not have access. You can avoid this situation by having the child movie call `Security.allowDomain()`.

  #### Parameters

  - ##### index: number

    The index position of the child object.

  #### Returns DisplayObject

  The child display object at the specified index position.

### getChildByName

- getChildByName(name: string): DisplayObject

- Inherited from DisplayObjectContainer.getChildByName

  - Defined in lib/openfl/display/DisplayObjectContainer.d.ts:232

  Returns the child display object that exists with the specified name. If more that one child display object has the specified name, the method returns the first object in the child list.

  The `getChildAt()` method is faster than the `getChildByName()` method. The `getChildAt()` method accesses a child from a cached array, whereas the `getChildByName()` method has to traverse a linked list to access a child.

  throws

    SecurityError This child display object belongs to a sandbox to which you do not have access. You can avoid this situation by having the child movie call the `Security.allowDomain()` method.

  #### Parameters

  - ##### name: string

    The name of the child to return.

  #### Returns DisplayObject

  The child display object with the specified name.

### getChildIndex

- getChildIndex(child: DisplayObject ): number

- Inherited from DisplayObjectContainer.getChildIndex

  - Defined in lib/openfl/display/DisplayObjectContainer.d.ts:243

  Returns the index position of a `child` DisplayObject instance.

  throws

    ArgumentError Throws if the child parameter is not a child of this object.

  #### Parameters

  - ##### child: DisplayObject

    The DisplayObject instance to identify.

  #### Returns number

  The index position of the child display object to identify.

### getObjectsUnderPoint

- getObjectsUnderPoint(point: Point ): Array< DisplayObject >

- Inherited from DisplayObjectContainer.getObjectsUnderPoint

  - Defined in lib/openfl/display/DisplayObjectContainer.d.ts:265

  Returns an array of objects that lie under the specified point and are children(or grandchildren, and so on) of this DisplayObjectContainer instance. Any child objects that are inaccessible for security reasons are omitted from the returned array. To determine whether this security restriction affects the returned array, call the `areInaccessibleObjectsUnderPoint()` method.

  The `point` parameter is in the coordinate space of the Stage, which may differ from the coordinate space of the display object container(unless the display object container is the Stage). You can use the `globalToLocal()` and the `localToGlobal()` methods to convert points between these coordinate spaces.

  #### Parameters

  - ##### point: Point

    The point under which to look.

  #### Returns Array< DisplayObject >

  An array of objects that lie under the specified point and are children(or grandchildren, and so on) of this DisplayObjectContainer instance.

### getRect

- getRect(targetCoordinateSpace: DisplayObject ): Rectangle

- Inherited from DisplayObject.getRect

  - Defined in lib/openfl/display/DisplayObject.d.ts:747

  Returns a rectangle that defines the boundary of the display object, based on the coordinate system defined by the `targetCoordinateSpace` parameter, excluding any strokes on shapes. The values that the `getRect()` method returns are the same or smaller than those returned by the `getBounds()` method.

  Note: Use `localToGlobal()` and `globalToLocal()` methods to convert the display object's local coordinates to Stage coordinates, or Stage coordinates to local coordinates, respectively.

  #### Parameters

  - ##### targetCoordinateSpace: DisplayObject

    The display object that defines the coordinate system to use.

  #### Returns Rectangle

  The rectangle that defines the area of the display object relative to the `targetCoordinateSpace` object's coordinate system.

### globalToLocal

- globalToLocal(pos: Point ): Point

- Inherited from DisplayObject.globalToLocal

  - Defined in lib/openfl/display/DisplayObject.d.ts:767

  Converts the `point` object from the Stage(global) coordinates to the display object's(local) coordinates.

  To use this method, first create an instance of the Point class. The x and y values that you assign represent global coordinates because they relate to the origin(0,0) of the main display area. Then pass the Point instance as the parameter to the `globalToLocal()` method. The method returns a new Point object with x and y values that relate to the origin of the display object instead of the origin of the Stage.

  #### Parameters

  - ##### pos: Point

  #### Returns Point

  A Point object with coordinates relative to the display object.

### hasEventListener

- hasEventListener(type: string): boolean

- Inherited from EventDispatcher.hasEventListener

  - Defined in lib/openfl/events/EventDispatcher.d.ts:209

  Checks whether the EventDispatcher object has any listeners registered for a specific type of event. This allows you to determine where an EventDispatcher object has altered handling of an event type in the event flow hierarchy. To determine whether a specific event type actually triggers an event listener, use `willTrigger()`.

  The difference between `hasEventListener()` and `willTrigger()` is that `hasEventListener()` examines only the object to which it belongs, whereas `willTrigger()` examines the entire event flow for the event specified by the `type` parameter.

  When `hasEventListener()` is called from a LoaderInfo object, only the listeners that the caller can access are considered.

  #### Parameters

  - ##### type: string

    The type of event.

  #### Returns boolean

  A value of `true` if a listener of the specified type is registered; `false` otherwise.

### hitTestObject

- hitTestObject(obj: DisplayObject ): boolean

- Inherited from DisplayObject.hitTestObject

  - Defined in lib/openfl/display/DisplayObject.d.ts:783

  Evaluates the bounding box of the display object to see if it overlaps or intersects with the bounding box of the `obj` display object.

  #### Parameters

  - ##### obj: DisplayObject

    The display object to test against.

  #### Returns boolean

  `true` if the bounding boxes of the display objects intersect; `false` if not.

### hitTestPoint

- hitTestPoint(x: number, y: number, shapeFlag?: boolean): boolean

- Inherited from DisplayObject.hitTestPoint

  - Defined in lib/openfl/display/DisplayObject.d.ts:802

  Evaluates the display object to see if it overlaps or intersects with the point specified by the `x` and `y` parameters. The `x` and `y` parameters specify a point in the coordinate space of the Stage, not the display object container that contains the display object(unless that display object container is the Stage).

  #### Parameters

  - ##### x: number

    The x coordinate to test against this object.

  - ##### y: number

    The y coordinate to test against this object.

  - ##### Optional shapeFlag: boolean

    Whether to check against the actual pixels of the object (`true`) or the bounding box (`false`).

  #### Returns boolean

  `true` if the display object overlaps or intersects with the specified point; `false` otherwise.

### localToGlobal

- localToGlobal(point: Point ): Point

- Inherited from DisplayObject.localToGlobal

  - Defined in lib/openfl/display/DisplayObject.d.ts:828

  Converts the `point` object from the display object's(local) coordinates to the Stage(global) coordinates.

  This method allows you to convert any given x and y coordinates from values that are relative to the origin(0,0) of a specific display object(local coordinates) to values that are relative to the origin of the Stage(global coordinates).

  To use this method, first create an instance of the Point class. The x and y values that you assign represent local coordinates because they relate to the origin of the display object.

  You then pass the Point instance that you created as the parameter to the `localToGlobal()` method. The method returns a new Point object with x and y values that relate to the origin of the Stage instead of the origin of the display object.

  #### Parameters

  - ##### point: Point

    The name or identifier of a point created with the Point class, specifying the x and y coordinates as properties.

  #### Returns Point

  A Point object with coordinates relative to the Stage.

### removeChild

- removeChild(child: DisplayObject ): DisplayObject

- Inherited from DisplayObjectContainer.removeChild

  - Defined in lib/openfl/display/DisplayObjectContainer.d.ts:287

  Removes the specified `child` DisplayObject instance from the child list of the DisplayObjectContainer instance. The `parent` property of the removed child is set to `null` , and the object is garbage collected if no other references to the child exist. The index positions of any display objects above the child in the DisplayObjectContainer are decreased by 1.

  The garbage collector reallocates unused memory space. When a variable or object is no longer actively referenced or stored somewhere, the garbage collector sweeps through and wipes out the memory space it used to occupy if no other references to it exist.

  throws

    ArgumentError Throws if the child parameter is not a child of this object.

  #### Parameters

  - ##### child: DisplayObject

    The DisplayObject instance to remove.

  #### Returns DisplayObject

  The DisplayObject instance that you pass in the `child` parameter.

### removeChildAt

- removeChildAt(index: number): DisplayObject

- Inherited from DisplayObjectContainer.removeChildAt

  - Defined in lib/openfl/display/DisplayObjectContainer.d.ts:312

  Removes a child DisplayObject from the specified `index` position in the child list of the DisplayObjectContainer. The `parent` property of the removed child is set to `null`, and the object is garbage collected if no other references to the child exist. The index positions of any display objects above the child in the DisplayObjectContainer are decreased by 1.

  The garbage collector reallocates unused memory space. When a variable or object is no longer actively referenced or stored somewhere, the garbage collector sweeps through and wipes out the memory space it used to occupy if no other references to it exist.

  throws

    RangeError Throws if the index does not exist in the child list.

  throws

    SecurityError This child display object belongs to a sandbox to which the calling object does not have access. You can avoid this situation by having the child movie call the `Security.allowDomain()` method.

  #### Parameters

  - ##### index: number

    The child index of the DisplayObject to remove.

  #### Returns DisplayObject

  The DisplayObject instance that was removed.

### removeChildren

- removeChildren(beginIndex?: number, endIndex?: number): void

- Inherited from DisplayObjectContainer.removeChildren

  - Defined in lib/openfl/display/DisplayObjectContainer.d.ts:315

  #### Parameters

  - ##### Optional beginIndex: number

  - ##### Optional endIndex: number

  #### Returns void

### removeEventListener

- removeEventListener(type: string, listener: function, useCapture?: boolean): void

- Inherited from EventDispatcher.removeEventListener

  - Defined in lib/openfl/events/EventDispatcher.d.ts:227

  Removes a listener from the EventDispatcher object. If there is no matching listener registered with the EventDispatcher object, a call to this method has no effect.

  #### Parameters

  - ##### type: string

    The type of event.

  - ##### listener: function

    - - (event: object): void

      - #### Parameters

        - ##### event: object

        #### Returns void

  - ##### Optional useCapture: boolean

    Specifies whether the listener was registered for the capture phase or the target and bubbling phases. If the listener was registered for both the capture phase and the target and bubbling phases, two calls to `removeEventListener()` are required to remove both, one call with `useCapture()` set to `true`, and another call with `useCapture()` set to `false`.

  #### Returns void

### requestSoftKeyboard

- requestSoftKeyboard(): boolean

- Inherited from InteractiveObject.requestSoftKeyboard

  - Defined in lib/openfl/display/InteractiveObject.d.ts:1153

  Raises a virtual keyboard.

  Calling this method focuses the InteractiveObject instance and raises the soft keyboard, if necessary. The `needsSoftKeyboard` must also be `true`. A keyboard is not raised if a hardware keyboard is available, or if the client system does not support virtual keyboards.

  Note: This method is not supported in AIR applications on iOS.

  #### Returns boolean

  A value of `true` means that the soft keyboard request was granted; `false` means that the soft keyboard was not raised.

### setChildIndex

- setChildIndex(child: DisplayObject, index: number): void

- Inherited from DisplayObjectContainer.setChildIndex

  - Defined in lib/openfl/display/DisplayObjectContainer.d.ts:346

  Changes the position of an existing child in the display object container. This affects the layering of child objects. For example, the following example shows three display objects, labeled a, b, and c, at index positions 0, 1, and 2, respectively:

  When you use the `setChildIndex()` method and specify an index position that is already occupied, the only positions that change are those in between the display object's former and new position. All others will stay the same. If a child is moved to an index LOWER than its current index, all children in between will INCREASE by 1 for their index reference. If a child is moved to an index HIGHER than its current index, all children in between will DECREASE by 1 for their index reference. For example, if the display object container in the previous example is named `container`, you can swap the position of the display objects labeled a and b by calling the following code:

  This code results in the following arrangement of objects:

  throws

    ArgumentError Throws if the child parameter is not a child of this object.

  throws

    RangeError Throws if the index does not exist in the child list.

  #### Parameters

  - ##### child: DisplayObject

    The child DisplayObject instance for which you want to change the index number.

  - ##### index: number

    The resulting index number for the `child` display object.

  #### Returns void

### startDrag

- startDrag(lockCenter?: boolean, bounds?: Rectangle ): void

- - Defined in lib/openfl/display/Sprite.d.ts:125

  Lets the user drag the specified sprite. The sprite remains draggable until explicitly stopped through a call to the `Sprite.stopDrag()` method, or until another sprite is made draggable. Only one sprite is draggable at a time.

  Three-dimensional display objects follow the pointer and `Sprite.startDrag()` moves the object within the three-dimensional plane defined by the display object. Or, if the display object is a two-dimensional object and the child of a three-dimensional object, the two-dimensional object moves within the three dimensional plane defined by the three-dimensional parent object.

  #### Parameters

  - ##### Optional lockCenter: boolean

    Specifies whether the draggable sprite is locked to the center of the pointer position(`true`), or locked to the point where the user first clicked the sprite(`false`).

  - ##### Optional bounds: Rectangle

    Value relative to the coordinates of the Sprite's parent that specify a constraint rectangle for the Sprite.

  #### Returns void

### stopAllMovieClips

- stopAllMovieClips(): void

- Inherited from DisplayObjectContainer.stopAllMovieClips

  - Defined in lib/openfl/display/DisplayObjectContainer.d.ts:349

  #### Returns void

### stopDrag

- stopDrag(): void

- - Defined in lib/openfl/display/Sprite.d.ts:138

  Ends the `startDrag()` method. A sprite that was made draggable with the `startDrag()` method remains draggable until a `stopDrag()` method is added, or until another sprite becomes draggable. Only one sprite is draggable at a time.

  #### Returns void

### swapChildren

- swapChildren(child1: DisplayObject, child2: DisplayObject ): void

- Inherited from DisplayObjectContainer.swapChildren

  - Defined in lib/openfl/display/DisplayObjectContainer.d.ts:362

  Swaps the z-order(front-to-back order) of the two specified child objects. All other child objects in the display object container remain in the same index positions.

  throws

    ArgumentError Throws if either child parameter is not a child of this object.

  #### Parameters

  - ##### child1: DisplayObject

    The first child object.

  - ##### child2: DisplayObject

    The second child object.

  #### Returns void

### swapChildrenAt

- swapChildrenAt(index1: number, index2: number): void

- Inherited from DisplayObjectContainer.swapChildrenAt

  - Defined in lib/openfl/display/DisplayObjectContainer.d.ts:374

  Swaps the z-order(front-to-back order) of the child objects at the two specified index positions in the child list. All other child objects in the display object container remain in the same index positions.

  throws

    RangeError If either index does not exist in the child list.

  #### Parameters

  - ##### index1: number

    The index position of the first child object.

  - ##### index2: number

    The index position of the second child object.

  #### Returns void

### toString

- toString(): string

- Inherited from EventDispatcher.toString

  - Defined in lib/openfl/events/EventDispatcher.d.ts:230

  #### Returns string

### willTrigger

- willTrigger(type: string): boolean

- Inherited from EventDispatcher.willTrigger

  - Defined in lib/openfl/events/EventDispatcher.d.ts:253

  Checks whether an event listener is registered with this EventDispatcher object or any of its ancestors for the specified event type. This method returns `true` if an event listener is triggered during any phase of the event flow when an event of the specified type is dispatched to this EventDispatcher object or any of its descendants.

  The difference between the `hasEventListener()` and the `willTrigger()` methods is that `hasEventListener()` examines only the object to which it belongs, whereas the `willTrigger()` method examines the entire event flow for the event specified by the `type` parameter.

  When `willTrigger()` is called from a LoaderInfo object, only the listeners that the caller can access are considered.

  #### Parameters

  - ##### type: string

    The type of event.

  #### Returns boolean

  A value of `true` if a listener of the specified type will be triggered; `false` otherwise.

Generated using TypeDoc