> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XGameUiShowTextEntryAsync

> XGameUiShowTextEntryAsync

# XGameUiShowTextEntryAsync

Muestra una interfaz de usuario de entrada de texto para que un usuario escriba información.

## Sintaxis

```cpp theme={null}
HRESULT XGameUiShowTextEntryAsync(  
         XAsyncBlock* async,  
         const char* titleText,  
         const char* descriptionText,  
         const char* defaultText,  
         XGameUiTextEntryInputScope inputScope,  
         uint32_t maxTextLength  
)  
```

### Parámetros

*async*   \_In\_<br />Tipo: [XAsyncBlock\*](/reference/system/xasync/structs/xasyncblock)

Un puntero al [XAsyncBlock](/reference/system/xasync/structs/xasyncblock) que se pasa a [XAsyncRun](/reference/system/xasync/functions/xasyncrun).

*titleText*   \_In\_opt\_z\_<br />Tipo: char\*

El título de texto de la interfaz de usuario de entrada de texto.

*descriptionText*   \_In\_opt\_z\_<br />Tipo: char\*

La descripción de texto de la interfaz de usuario de entrada de texto.

*defaultText*   \_In\_opt\_z\_<br />Tipo: char\*

Texto predeterminado que se rellena inicialmente en la interfaz de usuario de entrada de texto.

*inputScope*   \_In\_<br />Tipo: [XGameUiTextEntryInputScope](/reference/system/xgameui/enums/xgameuitextentryinputscope)

Especifica el ámbito de entrada de la entrada de texto, que indica el tipo de información que se permite. Este ámbito proporciona una sugerencia sobre qué texto puede desear el juego. El juego tendrá que validar igualmente el texto que reciba del teclado.

*maxTextLength*   \_In\_<br />Tipo: uint32\_t

El número máximo de caracteres que el usuario puede escribir en la interfaz de usuario de entrada de texto. En la consola, el número máximo de caracteres es 1024. En PC, no hay limitación. Si se pasa el valor 0, se tratará como una longitud máxima de 1024 caracteres. Además, si *inputScope* es XGameUiTextEntryInputScope::Password, la longitud máxima será siempre 1024 y se omitirá el valor de *maxTextLength*.

### Valor devuelto

Tipo: HRESULT

HRESULT de éxito o código de error de la llamada asincrónica.

Para obtener el resultado, llame a [XGameUiShowTextEntryResultSize](/reference/system/xgameui/functions/xgameuishowtextentryresultsize) y [XGameUiShowTextEntryResult](/reference/system/xgameui/functions/xgameuishowtextentryresult) dentro de la devolución de llamada de *AsyncBlock* o después de que *AsyncBlock* se haya completado.

## Comentarios

En las consolas, esto proporcionará tanto un campo de entrada de texto como un teclado virtual en pantalla (OSK). En Windows, esto proporcionará una nueva ventana con un campo de entrada de texto. En Windows solo aparecerá un teclado virtual si el usuario está configurado para usar un teclado en pantalla (por ejemplo, si está en modo tableta) en lugar de usar un teclado físico.

Llamar a la interfaz de usuario hará que el juego entre en *modo restringido*. En modo restringido, el título recibirá menos recursos del sistema mientras esté en segundo plano respecto de la interfaz de usuario que se haya invocado. Para obtener más información sobre el modo restringido y otros modos operativos del título, lea [Ciclo de vida del juego de XBOX (tema NDA)](/build/console-features/console-workflows/xbox-game-life-cycle).

## Requisitos

**Encabezado:** XGameUI.h

**Biblioteca:** xgameruntime.lib

**Plataformas compatibles:** Windows, Steam Deck, consolas de la familia XBOX One y consolas XBOX Series

## Consulte también

[XGameUI](/reference/system/xgameui/xgameui_members)<br />[Compatibilidad con teclado virtual](/build/core-features/common/input/overviews/virtualkeyboardsupport) [XGameUIShowTextEntryResult](/reference/system/xgameui/functions/xgameuishowtextentryresult)<br />[XGameUIShowTextEntryResultSize](/reference/system/xgameui/functions/xgameuishowtextentryresultsize)<br />[Ciclo de vida del juego de XBOX (tema NDA)](/build/console-features/console-workflows/xbox-game-life-cycle)


## Related topics

- [XGameUiShowTextEntryResult](/es/reference/system/xgameui/functions/xgameuishowtextentryresult.md)
- [XGameUiShowTextEntryUiCallback](/es/reference/system/xgameui/functions/xgameuishowtextentryuicallback.md)
- [XGameUiShowTextEntryResultSize](/es/reference/system/xgameui/functions/xgameuishowtextentryresultsize.md)
- [XGameUiSetTextEntryUiResponse](/es/reference/system/xgameui/functions/xgameuisettextentryuiresponse.md)
- [XGameUiTextEntryInputScope](/es/reference/system/xgameui/enums/xgameuitextentryinputscope.md)