TabbedTextOutW, fonction (winuser.h)

Article
11/20/2024

La fonction TabbedTextOut écrit une chaîne de caractères à un emplacement spécifié, en développant les onglets dans les valeurs spécifiées dans un tableau de positions de taquet de tabulation. Le texte est écrit dans la police, la couleur d’arrière-plan et la couleur de texte actuellement sélectionnées.

Syntaxe

LONG TabbedTextOutW(
  [in] HDC       hdc,
  [in] int       x,
  [in] int       y,
  [in] LPCWSTR   lpString,
  [in] int       chCount,
  [in] int       nTabPositions,
  [in] const INT *lpnTabStopPositions,
  [in] int       nTabOrigin
);

Paramètres

[in] hdc

Handle vers le contexte de l’appareil.

[in] x

Coordonnée x du point de départ de la chaîne, en unités logiques.

[in] y

Coordonnée y du point de départ de la chaîne, en unités logiques.

[in] lpString

Pointeur vers la chaîne de caractères à dessiner. La chaîne n’a pas besoin d’être terminée par zéro, car nCount spécifie la longueur de la chaîne.

[in] chCount

Longueur de la chaîne pointée par lpString.

[in] nTabPositions

Nombre de valeurs dans le tableau de positions de taquet de tabulation.

[in] lpnTabStopPositions

Pointeur vers un tableau contenant les positions de taquet de tabulation, en unités logiques. Les taquets de tabulation doivent être triés dans l’ordre croissant ; la plus petite valeur x doit être le premier élément du tableau.

[in] nTabOrigin

Coordonnée x de la position de départ à partir de laquelle les onglets sont développés, en unités logiques.

Valeur de retour

Si la fonction réussit, la valeur de retour est les dimensions, en unités logiques, de la chaîne. La hauteur se trouve dans le mot de haut ordre et la largeur se trouve dans le mot de bas ordre.

Si la fonction échoue, la valeur de retour est égale à zéro.

Remarques

Si le paramètre nTabPositions est égal à zéro et que le paramètre lpnTabStopPositions est NULL, les onglets sont étendus à huit fois la largeur moyenne des caractères.

Si nTabPositions est 1, les taquets de tabulation sont séparés par la distance spécifiée par la première valeur du tableau lpnTabStopPositions.

Si le tableau lpnTabStopPositions contient plusieurs valeurs, un taquet de tabulation est défini pour chaque valeur du tableau, jusqu’au nombre spécifié par nTabPositions.

Le paramètre nTabOrigin permet à une application d’appeler la fonction TabbedTextOut plusieurs fois pour une seule ligne. Si l’application appelle TabbedTextOut plusieurs fois avec le nTabOrigin défini sur la même valeur chaque fois, la fonction développe tous les onglets par rapport à la position spécifiée par nTabOrigin.

Par défaut, la position actuelle n’est pas utilisée ou mise à jour par la fonction TabbedTextOut. Si une application doit mettre à jour la position actuelle lorsqu’elle appelle TabbedTextOut, l’application peut appeler la fonction SetTextAlign avec le paramètre wFlags défini sur TA_UPDATECP. Lorsque cet indicateur est défini, le système ignore les paramètres X et Y lors des appels suivants à la fonction TabbedTextOut , à l’aide de la position actuelle.

Remarque pour Windows Vista et versions ultérieures, TabbedTextOut ignore l’alignement du texte lorsqu’il dessine du texte.

Note

L’en-tête winuser.h définit TabbedTextOut comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
serveur minimum pris en charge	Windows 2000 Server [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	winuser.h (include Windows.h)
bibliothèque	User32.lib
DLL	User32.dll
ensemble d’API	ext-ms-win-ntuser-misc-l1-5-1 (introduit dans Windows 10, version 10.0.14393)