Fonction ScriptStringOut (usp10.h)

Article
08/26/2023

Affiche une chaîne générée par un appel antérieur à ScriptStringAnalyse et ajoute éventuellement une mise en surbrillance.

Syntaxe

HRESULT ScriptStringOut(
  [in]           SCRIPT_STRING_ANALYSIS ssa,
  [in]           int                    iX,
  [in]           int                    iY,
  [in]           UINT                   uOptions,
  [in, optional] const RECT             *prc,
  [in]           int                    iMinSel,
  [in]           int                    iMaxSel,
  [in]           BOOL                   fDisabled
);

Paramètres

[in] ssa

Structure SCRIPT_STRING_ANALYSIS pour la chaîne.

[in] iX

Coordonnée x du point de référence utilisé pour positionner la chaîne.

[in] iY

Coordonnée y du point de référence utilisé pour positionner la chaîne.

[in] uOptions

Options spécifiant l’utilisation du rectangle défini par l’application. Ce paramètre peut être défini sur 0 ou sur l’une des valeurs suivantes. Les valeurs peuvent être combinées avec le binaire OR.

Valeur	Signification
ETO_CLIPPED	Découpez le texte dans le rectangle.
ETO_OPAQUE	Utilisez la couleur d’arrière-plan actuelle pour remplir le rectangle.

[in, optional] prc

Pointeur vers une structure RECT qui définit le rectangle à utiliser. Si uOptions est défini sur ETO_OPAQUE et que NULL est fourni pour prc, la fonction réussit et retourne S_OK. Toutefois, si l’application définit uOptions sur ETO_CLIPPING et fournit NULL pour prc, la fonction retourne E_INVALIDARG. L’application peut définir ce paramètre sur NULL pour indiquer qu’aucune option n’est nécessaire.

[in] iMinSel

Index de base zéro spécifiant la position de départ dans la chaîne. Pour aucune sélection, l’application doit définir iMinSel>= iMaxSel.

[in] iMaxSel

Index de base zéro spécifiant la position de fin dans la chaîne.

[in] fDisabled

TRUE si le système d’exploitation applique la mise en surbrillance du texte désactivé en définissant la couleur d’arrière-plan sur COLOR_HIGHLIGHT derrière tous les caractères sélectionnés. L’application peut définir ce paramètre sur FALSE si le système d’exploitation applique la mise en surbrillance du texte activé en définissant la couleur d’arrière-plan sur COLOR_HIGHLIGHT et la couleur du texte sur COLOR_HIGHLIGHTTEXT pour chaque caractère sélectionné.

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 ne peut pas tester la valeur de retour avec les macros SUCCEEDED et FAILED .

Remarques

Pour utiliser cette fonction, l’application doit spécifier SSA_GLYPHS dans son appel d’origine à ScriptStringAnalyse.

L’application ne doit pas utiliser SetTextAlign avec TA_UPDATECP lors de l’utilisation de ScriptStringOut , car le texte sélectionné ne peut pas être restitué correctement. Si l’application doit utiliser cet indicateur, elle peut annuler et réinitialiser l’indicateur si nécessaire pour éviter le problème.

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

Voir aussi

SCRIPT_STRING_ANALYSIS

ScriptStringAnalyse

Annuler l’inscription

Annuler l’inscription de fonctions

Share via