display.newContainer()

Type Function
Library display.*
Revision Current Public Release (2014.2511)
Keywords groups, container
See also Container Programming Guide

Overview

Containers are a special kind of group in which the children are clipped (masked) by the bounds of the container.

See Container Programming Guide for more information.

Syntax

display.newContainer( [parent, ] width, height )

Gotchas

Container objects are created using a mask and there is a nested masking limit of 3. Thus, care must be taken when inserting other masked objects into containers. Display objects that utilize masks include display.newText, display.newEmbossedText, widget.newScrollView, widget.newTableView, other containers, and any other masked image, masked vector object, or masked display group. For example, a text object (one mask) inside a container (one mask) inside yet another container (one mask) would reach but not exceed the limit of 3 nested masks.

Example

-- Create a container
local container = display.newContainer( 128, 128 )

-- Create an image
local bkgd = display.newImage( "aquariumbackgroundIPhone.jpg" )
-- Insert the image into the container
container:insert( bkgd, true )
-- Center the container in the display area
container:translate( display.contentWidth*0.5, display.contentHeight*0.5 )

-- Transition (rotate) the container
transition.to( container, { rotation=360, transition=easing.inOutExpo} )