# dxGetTextSize (Cliente)

> Mede a largura e a altura que um texto ocupa na tela.

- **Plataforma**: MY Multiplayer (MYMP)
- **Tipo**: Função Lua
- **Lado**: Cliente
- **Categoria**: Desenho na tela
- **URL**: https://wiki.mymp.gg/pt/dxGetTextSize

## Sintaxe

```lua
float, float|false dxGetTextSize(string text [, float width = 0, float scaleX, scaleY = 1, string|element font = default, bool wordBreak = false, bool colorCoded = false])
```

## Parâmetros

| Nome | Tipo | Descrição |
| --- | --- | --- |
| `text` | `string` | O texto. |
| `width` | `float` | Largura disponível em pixels, usada com `wordBreak`. *(padrão: `0`)* |
| `scaleX, scaleY` | `float` | Escala do texto. Um único número vale para os dois eixos. Aceita também um vec2. *(padrão: `1`)* |
| `font` | `string\|element` | O nome de uma fonte (de um pack ou dada a `dxCreateFont`) ou um elemento de fonte de `dxCreateFont`. *(padrão: `default`)* |
| `wordBreak` | `bool` | Quebra as linhas que não cabem em `width`. *(padrão: `false`)* |
| `colorCoded` | `bool` | Ignora os códigos de cor `#RRGGBB` na medida. *(padrão: `false`)* |

## Retorno

A largura e a altura em pixels, ou `false` se a fonte não existe.

## Exemplo

```lua
local text = "Uma descrição longa que precisa quebrar em várias linhas."
local w, h = dxGetTextSize(text, 300, 1, "default", true)

addEventHandler("onClientRender", root, function()
    dxDrawRectangle(20, 20, w + 20, h + 20, tocolor(0, 0, 0, 160))
    dxDrawText(text, 30, 30, 330, 30 + h, tocolor(255, 255, 255), 1, "default", "left", "top", false, true)
end)
```

## Veja também

- [dxGetTextWidth (Cliente)](https://wiki.mymp.gg/pt/dxGetTextWidth.md): Mede a largura que um texto ocupa na tela, na linha mais larga.
- [dxGetFontHeight (Cliente)](https://wiki.mymp.gg/pt/dxGetFontHeight.md): Devolve a altura de uma linha de texto de uma fonte.
- [dxDrawText (Cliente)](https://wiki.mymp.gg/pt/dxDrawText.md): Desenha um texto na tela durante um quadro, dentro de uma caixa.