setElementParent

Move um elemento para debaixo de outro na árvore.

Sintaxe

bool setElementParent ( element oElemento, element novoPai )

Retorno

true em caso de sucesso, false caso contrário.

A troca é recusada quando o elemento é o raiz, quando pai e filho são o mesmo elemento, ou quando o novo pai já é descendente do elemento — nenhum desses casos formaria uma árvore válida.

No cliente só é possível mover elementos que o próprio cliente criou, e o novo pai precisa ser um elemento do tipo "map" ou estar em algum ponto abaixo de um. A câmera não pode ser nem o elemento nem o pai.

Exemplo

local grupo = createElement("grupo")
setElementParent(veiculo, grupo)

Veja também

• getElementParent — Devolve o pai de um elemento.
• getElementChildren — Lista os filhos diretos de um elemento.
• getElementChild — Devolve um filho pelo índice.
• getElementChildrenCount — Conta os filhos diretos de um elemento.