wingdi.h


GetTextExtentPoint

GetTextExtentPoint se proporciona para compatibilidad con versiones de Windows de 16-bit. Las aplicaciones basadas en Win32 deben llamar a la función GetTextExtentPoint32, que proporciona mayor precisión en los resultados.

Sintaxis

BOOL GetTextExtentPoint(
    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 GetTextExtentPoint 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.