GetTextExtentPoint32

La función GetTextExtentPoint32 calcula la anchura y altura de la cadena de texto especificada. Esta función sustituye a GetTextExtentPoint.

Sintaxis

BOOL GetTextExtentPoint32(
    HDC hdc,           // manipulador de contexto de dispositivo
    LPCTSTR lpString,  // dirección de la cadena de texto
    int cbString,      // número de caracteres en la cadena
    LPSIZE lpSize      // dirección de la estructura para el tamaño de la cadena
   );

Parámetros

hdc: identifica el contexto de dispositivo.

lpString: puntero a la cadena de texto. La cadena no necesita estar terminada con cero, ya que el parámetro cbString especifica la longitud de la cadena.

cbString: especifica el número de caracteres en la cadena.

lpSize: puntero a una estructura SIZE en la que se almacenarán las dimensiones de la cadena.

Valor de retorno

Si la función tiene éxito, el valor de retorno es distinto de cero.

Si la función falla, el valor de retorno es cero. Para obtener información adicional sobre el error, llamar a GetLastError.

Observaciones

La función GetTextExtentPoint32 usa la fuente seleccionada actualmente para calcular las dimensiones de la cadena. La anchura y altura, en unidades lógicas, se calculan sin considerar ningún recorte.

Ya que algunos dispositivos superponen parte de los caracteres, la suma de los tamaños de los caracteres en la cadena no tiene por qué ser igual al tamaño de la cadena.

El valor de anchura de la cadena calculado tiene en cuenta el espacio entre las caracteres asignado mediante la función SetTextCharacterExtra.