XGameUiShowTextEntryAsync
Muestra una interfaz de usuario de entrada de texto para que un usuario escriba información.Sintaxis
Parámetros
async _In_Tipo: XAsyncBlock* Un puntero al XAsyncBlock que se pasa a XAsyncRun. titleText _In_opt_z_
Tipo: char* El título de texto de la interfaz de usuario de entrada de texto. descriptionText _In_opt_z_
Tipo: char* La descripción de texto de la interfaz de usuario de entrada de texto. defaultText _In_opt_z_
Tipo: char* Texto predeterminado que se rellena inicialmente en la interfaz de usuario de entrada de texto. inputScope _In_
Tipo: 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_
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 y 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).Requisitos
Encabezado: XGameUI.h Biblioteca: xgameruntime.lib Plataformas compatibles: Windows, Steam Deck, consolas de la familia XBOX One y consolas XBOX SeriesConsulte también
XGameUICompatibilidad con teclado virtual XGameUIShowTextEntryResult
XGameUIShowTextEntryResultSize
Ciclo de vida del juego de XBOX (tema NDA)