Partager via


Fonction ScriptStringOut (usp10.h)

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