method getBoxesByTag

This method iterates each box in the scene's dom to locate each box with a given tag. Each matching box's proxy is stored in a basics::array and returned to the caller. If not boxes are found with given tag an empty array is returned.

function onSample()
{
    var array = scene.getBoxesByTag("button");
    if (array)
    {
        var count = array.count;
        for (var i = 0; i < count; ++i)
        {
            var box = array.getValue(i);
            if (box)
            {
                shell.print(box.label);
            }
        }
    }
}