# dxGetTextWidth (Cliente)

> Mide el ancho que ocupa un texto en la pantalla, en su línea más ancha.

- **Plataforma**: MY Multiplayer (MYMP)
- **Tipo**: Función Lua
- **Lado**: Cliente
- **Categoría**: Dibujo en pantalla
- **URL**: https://wiki.mymp.gg/es/dxGetTextWidth

## Sintaxis

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

## Parámetros

| Nombre | Tipo | Descripción |
| --- | --- | --- |
| `text` | `string` | El texto. |
| `scale` | `float` | Escala del texto. *(por defecto: `1`)* |
| `font` | `string\|element` | El nombre de una fuente (de un pack o dado a `dxCreateFont`) o un elemento de fuente de `dxCreateFont`. *(por defecto: `default`)* |
| `colorCoded` | `bool` | Deja fuera de la medida los códigos de color `#RRGGBB`. *(por defecto: `false`)* |

## Retorno

El ancho en píxeles, o `false` si la fuente no existe.

## Ejemplo

```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)
```

## Ver también

- [dxGetTextSize (Cliente)](https://wiki.mymp.gg/es/dxGetTextSize.md): Mide el ancho y el alto que ocupa un texto en la pantalla.
- [dxGetFontHeight (Cliente)](https://wiki.mymp.gg/es/dxGetFontHeight.md): Devuelve el alto de una línea de texto de una fuente.
- [dxDrawText (Cliente)](https://wiki.mymp.gg/es/dxDrawText.md): Dibuja un texto en la pantalla durante un fotograma, dentro de una caja.
