Partager via


CDC::GetTabbedTextExtent

Appelez la fonction membre pour calculer la largeur et la hauteur d'une chaîne à l'aide de m_hAttribDC, le contexte de périphérique d'attribut.

CSize GetTabbedTextExtent( 
   LPCTSTR lpszString, 
   int nCount, 
   int nTabPositions, 
   LPINT lpnTabStopPositions  
) const; 
CSize GetTabbedTextExtent( 
   const CString& str, 
   int nTabPositions, 
   LPINT lpnTabStopPositions  
) const;

Paramètres

  • lpszString
    Pointe vers une chaîne. Vous pouvez également passer 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 caractères de tabulation du tableau pointée pointe vers lpnTabStopPositions.

  • lpnTabStopPositions
    Indique un tableau d'entiers 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. Il n'autorise pas les onglets arrières.

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

Valeur de retour

Les dimensions de la chaîne (en unités logiques) dans un objet de CSize .

Notes

Si la chaîne contient un ou plusieurs caractères de tabulation, la largeur de la chaîne est basée sur les taquets de tabulation spécifiés par lpnTabStopPositions. La fonction utilise la police sélectionnée pour calculer les dimensions de la chaîne.

La région de découpage en cours ne compense pas la largeur et la hauteur retournée par la fonction d' GetTabbedTextExtent .

Étant donné que certains appareils ne définit pas les caractères dans les tableaux de cellules ordinaires (autrement dit, ils Kern les caractères), la somme des ampleurs des caractères dans une chaîne peut ne pas être égale jusqu'au niveau de la chaîne.

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 laquelle lpnTabStopPositions indique. Si des points d' lpnTabStopPositions à plus qu'une seule valeur, un taquet de tabulation sont définis pour chaque valeur du tableau, jusqu ' à le nombre spécifié par nTabPositions.

Configuration requise

Header: afxwin.h

Voir aussi

Référence

CDC, classe

Graphique de la hiérarchie

CDC::GetTextExtent

CDC::GetOutputTabbedTextExtent

CDC::GetOutputTextExtent

CDC::TabbedTextOut

GetTabbedTextExtent

CSize, classe