Fonction ScriptIsComplex (usp10.h)

Article
03/03/2024

Détermine si une chaîne Unicode nécessite un traitement de script complexe.

Syntaxe

HRESULT ScriptIsComplex(
  [in] const WCHAR *pwcInChars,
  [in] int         cInChars,
  [in] DWORD       dwFlags
);

Paramètres

[in] pwcInChars

Pointeur vers la chaîne à tester.

[in] cInChars

Longueur de la chaîne d’entrée, en caractères.

[in] dwFlags

Indicateurs spécifiant les détails des tests. Ce paramètre peut avoir l’une des valeurs suivantes.

Valeur	Signification
SIC_ASCIIDIGIT	Traitez les chiffres U+0030 à U+0039 comme complexes. L’application définit cet indicateur si la chaîne est affichée avec la substitution de chiffres activée. Si l’application suit les paramètres NLS (National Language Support) de l’utilisateur à l’aide de la fonction ScriptRecordDigitSubstitution , elle peut passer une structure SCRIPT_DIGITSUBSTITUTE avec le membre DigitSubstitute défini sur SCRIPT_DIGITSUBSTITUTE_NONE.
SIC_COMPLEX	Traitez les lettres de script complexes comme complexes. Cet indicateur doit normalement être défini.
SIC_NEUTRAL	Traiter les neutres comme complexes. L’application définit cet indicateur pour afficher la chaîne avec l’ordre de lecture de droite à gauche.

Valeur retournée

Retourne S_OK si la chaîne nécessite un traitement de script complexe. La fonction retourne S_FALSE si la chaîne peut être gérée par des appels de fonction d’API standard, c’est-à-dire qu’elle contient uniquement des caractères disposés côte à côte et de gauche à droite. La fonction retourne une valeur HRESULT différente de zéro si elle ne réussit pas.

Remarques

Consultez Affichage de texte avec uniscribe pour une présentation du contexte dans lequel cette fonction est normalement appelée.

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

Affichage du texte avec un caractères non inscrit

SCRIPT_DIGITSUBSTITUTE

ScriptRecordDigitSubstitution

Annuler l’inscription

Annuler l’inscription de fonctions

Partager via