Compartir a través de


CDC::GetTabbedTextExtent

Llame a esta función miembro para calcular el ancho y el alto de una cadena de caracteres mediante m_hAttribDC, el contexto de dispositivo del atributo.

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

Parámetros

  • lpszString
    Señala una cadena de caracteres. También puede pasar un objeto de CString para este parámetro.

  • nCount
    Especifica el número de caracteres de la cadena. si es nCount – se calcula 1, la longitud.

  • nTabPositions
    Especifica el número de posiciones de la interrupción de tabulación en la matriz indicada por lpnTabStopPositions.

  • lpnTabStopPositions
    Señala a una matriz de enteros que contienen las posiciones de la interrupción de tabulación en unidades lógicas. Las tabulaciones deben ordenar en sentido orden; el x-valor menor debe ser el primer elemento de la matriz. las fichas posteriores no se permiten.

  • str
    Un objeto de CString que contiene los caracteres especificados que se va a dibujar.

Valor devuelto

las dimensiones de la cadena (en unidades lógicas) en un objeto de CSize .

Comentarios

Si la cadena contiene uno o más caracteres de tabulación, el ancho de la cadena se basa en las tabulaciones especificadas por lpnTabStopPositions. La función utiliza la fuente seleccionado actualmente para calcular las dimensiones de la cadena.

la zona de recorte actual no compensa el ancho y el alto devueltos por la función de GetTabbedTextExtent .

Puesto que algunos dispositivos no colocan los caracteres en matrices de celdas normales (es decir, interletran caracteres), la suma de las extensiones de los caracteres de una cadena puede no ser igual a la extensión de la cadena.

Si nTabPositions es 0 y lpnTabStopPositions es NULL, fichas se expanden a ocho veces el ancho de caracteres medio. Si nTabPositions es 1, las tabulaciones se separadas por la distancia especificada por el primer valor de la matriz al que lpnTabStopPositions señala. Si los puntos de lpnTabStopPositions más de un único valor, una tabulación se establecen para cada valor en la matriz, hasta el número especificado por nTabPositions.

Requisitos

encabezado: afxwin.h

Vea también

Referencia

CDC (clase)

Gráfico de jerarquías

CDC::GetTextExtent

CDC::GetOutputTabbedTextExtent

CDC::GetOutputTextExtent

CDC::TabbedTextOut

GetTabbedTextExtent

CSize Class