This function performs a recursive search and returns the first child entity it finds with the specified name.

Syntax

• Entity* FindChild(const std::string& name)

Parameters

• name: the name of the child entity to search for.

Returns

Returns the first child entity found with the specified name. If no child is found, NULL will be returned.

Example

#include "Leadwerks.h"

using namespace Leadwerks;

int main(int argc, const char *argv[])
{
        Leadwerks::Window* window = Leadwerks::Window::Create();
        
        Context* context = Context::Create(window);
        
        World* world = World::Create();
        
        Camera* camera = Camera::Create();
        camera->SetRotation(35, 0, 0);
        camera->Move(0, 0, -3);

        Light* light = DirectionalLight::Create();
        light->SetRotation(35, 35, 0);

        //Load a model
        Entity* entity = Model::Box();

        Entity* child = Model::Box(1, 1, 1, entity);
        child->SetColor(1.0, 0.0, 0.0);
        child->SetPosition(2, -2, 0);
        child->SetKeyValue("name", "MyBox1");

        child = Model::Box(1, 1, 1, entity);
        child->SetColor(0.0, 1.0, 0.0);
        child->SetPosition(-2, -2, 0);
        child->SetKeyValue("name", "MyBox2");
        
        while (true)
        {
                if (window->Closed() || window->KeyDown(Key::Escape)) return false;
                Leadwerks::Leadwerks::Time::Update();
                world->Update();
                world->Render();

                Entity* child = entity->FindChild("MyBox2");

                context->SetBlendMode(Blend::Alpha);
                context->DrawText("Child position: " + child->GetPosition(true).ToString(), 2, 2);
                
                context->Sync();
        }
}