Skip to main content

XGameUiTextEntryOpen

Ouvre un clavier virtuel pour lequel le titre est responsable de l’affichage du texte. Actuellement non implémenté sur ordinateur de bureau.

Syntaxe

Paramètres

options   _In_
Type : XGameUiTextEntryOptions
Indique l’ensemble initial d’options à appliquer au clavier lors de son ouverture, comme son emplacement et la configuration du clavier. maxLength   _In_
Type : uint32_t
Nombre maximal de caractères que l’utilisateur peut saisir dans le clavier virtuel. Ce nombre ne doit pas dépasser 32K. initialText   _In__opt_z_
Type : const char*
Chaîne de caractères terminée par un caractère null qui est initialement renseignée dans le clavier virtuel. initialCursorIndex   _In_
Type : uint32_t
Index en octets initial du curseur par rapport au caractère de début. handle   _Out_
Type : XGameUiTextEntryHandle
Handle du clavier virtuel nouvellement ouvert. ### Valeur de retour Type : HRESULT Code de réussite ou d’erreur HRESULT. Pour obtenir la liste des codes d’erreur, consultez Codes d’erreur.

Remarques

Cette fonction retourne dès qu’elle peut obtenir le handle, même si le clavier virtuel n’est pas encore visible. Toutes les autres fonctions XGameUiTextEntry peuvent être appelées en toute sécurité dès que le handle est retourné. L’exemple suivant illustre les principes de base de l’utilisation des fonctions XGameUiTextEntry.

Configuration requise

En-tête : XGameUI.h Bibliothèque : xgameruntime.lib Plateformes prises en charge : Windows, consoles de la famille XBOX One et consoles XBOX Series

Voir aussi

XGameUI
Prise en charge du clavier virtuel
Last modified on October 6, 2026