# dxGetTextWidth (Cliente)

> Mede a largura que um texto ocupa na tela, na linha mais larga.

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

## Sintaxe

```lua
float|false dxGetTextWidth(string text [, float scale = 1, string|element font = default, bool colorCoded = false])
```

## Parâmetros

| Nome | Tipo | Descrição |
| --- | --- | --- |
| `text` | `string` | O texto. |
| `scale` | `float` | Escala do texto. *(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`)* |
| `colorCoded` | `bool` | Ignora os códigos de cor `#RRGGBB` na medida. *(padrão: `false`)* |

## Retorno

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

## Exemplo

```lua
local text = "Bem-vindo"
local width = dxGetTextWidth(text, 2, "default")

addEventHandler("onClientRender", root, function()
    local sx = getScreenSize()
    dxDrawText(text, (sx - width) / 2, 40, 0, 0, tocolor(255, 255, 255), 2)
end)
```

## Veja também

- [dxGetTextSize (Cliente)](https://wiki.mymp.gg/pt/dxGetTextSize.md): Mede a largura e a altura que um texto ocupa na tela.
- [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.