display.getCurrentStage()

Overview

Returns a reference to the current stage object, which is the parent group for all display objects and groups. Currently, Corona has a single stage instance, so this function always returns a reference to the same object.

Syntax

display.getCurrentStage()

Examples

-- Used in conjunction with a touch event listener and the ":setFocus()" method

function object:touch( event )

    if event.phase == "began" then

        -- Get stage and call ":setFocus()" method
        local stage = display.getCurrentStage()
        stage:setFocus( self )
        self.isFocus = true

    elseif self.isFocus then
        if event.phase == "ended" or event.phase == "cancelled" then

            local stage = display.getCurrentStage()
            stage:setFocus( nil )
        end
    end

    return true
end

-- Ungroup an object from its current parent group by inserting it into the top-level "stage" group

local g = display.newGroup()
local obj = display.newImage( "image.png" )
g:insert( obj )

local stage = display.getCurrentStage()

-- Ungroup object by inserting into top-level stage group
stage:insert( obj )

-- Object no longer belongs to the "g" group