Fonction ScriptStringXtoCP (usp10.h)

Article
03/03/2024

Convertit une coordonnée x en position de caractère.

Syntaxe

HRESULT ScriptStringXtoCP(
  [in]  SCRIPT_STRING_ANALYSIS ssa,
  [in]  int                    iX,
  [out] int                    *piCh,
  [out] int                    *piTrailing
);

Paramètres

[in] ssa

Structure SCRIPT_STRING_ANALYSIS pour la chaîne.

[in] iX

Coordonnée x.

[out] piCh

Pointeur vers une variable dans laquelle cette fonction récupère la position de caractère correspondant à la coordonnée x.

[out] piTrailing

Pointeur vers une variable dans laquelle cette fonction récupère une valeur indiquant si la coordonnée x correspond au bord d’entrée ou au bord de fin de la position de caractère. Pour plus d'informations, consultez la section Notes.

Valeur retournée

Retourne S_OK en cas de réussite. La fonction retourne une valeur HRESULT différente de zéro si elle ne réussit pas. L’application peut tester la valeur de retour avec les macros SUCCEEDED et FAILED .

Remarques

Si la coordonnée x correspond au bord d’entrée du caractère, la valeur de piTrailing est 0. Si la coordonnée x correspond au bord de fin du caractère, la valeur de piTrailing est un entier positif. Comme pour ScriptXtoCP, la valeur est 1 pour un caractère qui peut être rendu seul. La valeur est supérieure à 1 si le caractère fait partie d’un cluster dans un script pour lequel les curseurs ne sont pas placés dans un cluster, pour indiquer le décalage vers la position de curseur logique légitime suivante.

Si la coordonnée x se trouve avant le début de la ligne, la fonction récupère -1 pour piCh et 1 pour piTrailing, indiquant le bord de fin du caractère inexistant avant la ligne. Si la coordonnée x se trouve après la fin de la ligne, la fonction récupère pour piCh le premier index au-delà de la longueur de la ligne et 0 pour piTrailing. La valeur 0 indique le bord d’avant du caractère inexistant après la ligne.

Important À compter de Windows 8 : pour conserver la possibilité de s’exécuter sur Windows 7, un module qui utilise Uniscribe doit spécifier Usp10.lib avant gdi32.lib dans sa liste de bibliothèques.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	usp10.h
Bibliothèque	Usp10.lib
DLL	Usp10.dll
Composant redistribuable	Internet Explorer 5 ou version ultérieure sur Windows Me/98/95

Voir aussi

SCRIPT_STRING_ANALYSIS

Uniscribe

Fonctions uniscribe

Partager via