Partager via


CDC::TabbedTextOut

Appelez la fonction membre pour écrire une chaîne de caractères à l'emplacement spécifié, le développement des tabulations en valeurs spécifiées dans le tableau de caractères de tabulation.

virtual CSize TabbedTextOut( 
   int x, 
   int y, 
   LPCTSTR lpszString, 
   int nCount, 
   int nTabPositions, 
   LPINT lpnTabStopPositions, 
   int nTabOrigin  
); 
CSize TabbedTextOut( 
   int x, 
   int y, 
   const CString& str, 
   int nTabPositions, 
   LPINT lpnTabStopPositions, 
   int nTabOrigin  
);

Paramètres

  • x
    Spécifie la coordonnée x logique du point de départ de la chaîne.

  • y
    Spécifie l'ordonnée logique du point de départ de la chaîne.

  • lpszString
    Points à la chaîne de caractères pour dessiner. Vous pouvez passer un pointeur vers un tableau de caractères ou un objet de CString pour ce paramètre.

  • nCount
    Spécifie le nombre de caractères dans la chaîne. Si nCount est à 1, la longueur est calculé.

  • nTabPositions
    Spécifie le nombre de valeurs dans le tableau de caractères de tabulation.

  • lpnTabStopPositions
    Pointe vers un tableau contenant les positions de tabulation (en unités logiques). Taquets de tabulation doivent être triées en augmentant la commande ; la plus petite valeur x doit être le premier élément du tableau.

  • nTabOrigin
    Spécifie la coordonnée x de la position de départ de laquelle les onglets sont développés (en unités logiques).

  • str
    Un objet d' CString qui contient les caractères spécifiés.

Valeur de retour

Les dimensions de la chaîne (en unités logiques) comme objet d' CSize .

Notes

Le texte est écrit dans la police sélectionnée. Si nTabPositions est 0 et lpnTabStopPositions est NULL, les onglets sont développés à huit fois la largeur de caractère moyenne.

Si nTabPositions est 1, les taquets de tabulation sont séparés par une distance spécifiée par la première valeur du tableau d' lpnTabStopPositions . Si le tableau d' lpnTabStopPositions contient plusieurs valeurs, un taquet de tabulation est défini pour chaque valeur du tableau, jusqu ' à le nombre spécifié par nTabPositions. Le paramètre d' nTabOrigin permet à une application d'appeler la fonction d' TabbedTextOut plusieurs fois pour une seule ligne. Si l'application appelle la fonction plusieurs fois avec nTabOrigin défini à 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 n'est pas mise à jour par la fonction. Si une application doit mettre à jour la position actuelle lorsqu'il appelle la fonction, l'application peut appeler la fonction membre de SetTextAlign avec nFlags affectez à TA_UPDATECP. Lorsque cette balise est définie, les fenêtres ignore les paramètres de x et y sur les appels suivants à TabbedTextOut, à l'aide de la position actuelle à la place.

Configuration requise

Header: afxwin.h

Voir aussi

Référence

CDC, classe

Graphique de la hiérarchie

CDC::GetTabbedTextExtent

CDC::SetTextAlign

CDC::TextOut

CDC::SetTextColor

TabbedTextOut

CSize, classe