# getElementByID (Compartilhado)

> Procura o primeiro elemento com um ID, a partir de um elemento e descendo pelos seus filhos.

- **Plataforma**: MY Multiplayer (MYMP)
- **Tipo**: Função Lua
- **Lado**: Compartilhado
- **Categoria**: Elementos
- **URL**: https://wiki.mymp.gg/pt/getElementByID

## Sintaxe

```lua
element|nil getElementByID(string id [, element startAt = root])
```

## Parâmetros

| Nome | Tipo | Descrição |
| --- | --- | --- |
| `id` | `string` | ID procurado. |
| `startAt` | `element` | Onde a busca começa. Ele mesmo também conta. *(padrão: `root`)* |

## Retorno

O elemento encontrado, ou `nil` se nenhum tem esse ID.

## Exemplo

```lua
local gate = getElementByID("lspd_gate", resourceRoot)
if gate then
    moveObject(gate, 3000, 1544.7, -1630.7, 10)
end
```

## Veja também

- [getElementID (Compartilhado)](https://wiki.mymp.gg/pt/getElementID.md): Lê o ID de um elemento, o nome que getElementByID procura.
- [setElementID (Compartilhado)](https://wiki.mymp.gg/pt/setElementID.md): Dá um id (nome) a um elemento, para encontrá-lo depois com getElementByID.
- [getElementsByType (Servidor)](https://wiki.mymp.gg/pt/getElementsByType-server.md): Lista todos os elementos de um tipo abaixo de um elemento da árvore no servidor.