Función GetTextExtentPointI (wingdi.h)

Artículo
08/27/2023

La función GetTextExtentPointI calcula el ancho y alto de la matriz especificada de índices de glifo.

Sintaxis

BOOL GetTextExtentPointI(
  [in]  HDC    hdc,
  [in]  LPWORD pgiIn,
  [in]  int    cgi,
  [out] LPSIZE psize
);

Parámetros

[in] hdc

Identificador del contexto del dispositivo.

[in] pgiIn

Puntero a la matriz de índices de glifo.

[in] cgi

Especifica el número de índices de glifos.

[out] psize

Puntero a una estructura SIZE que recibe las dimensiones de la cadena, en unidades lógicas.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero.

Comentarios

La función GetTextExtentPointI usa la fuente seleccionada actualmente para calcular las dimensiones de la matriz de índices de glifo. El ancho y alto, en unidades lógicas, se calculan sin tener en cuenta ningún recorte.

Cuando esta función devuelve la extensión de texto, supone que el texto es horizontal, es decir, que el escape siempre es 0. Esto es cierto tanto para las medidas horizontales como verticales del texto. Incluso si usa una fuente que especifica un escape distinto de cero, esta función no usa el ángulo mientras calcula la extensión de texto. La aplicación debe convertirlo explícitamente. Sin embargo, cuando el modo gráfico se establece en GM_ADVANCED y la orientación del carácter es de 90 grados a partir de la orientación de impresión, los valores devueltos por esta función no siguen esta regla. Cuando la orientación de caracteres y la orientación de impresión coinciden con una cadena determinada, esta función devuelve las dimensiones de la cadena en la estructura SIZE como { cx : 116, cy : 18 }. Cuando la orientación de caracteres y la orientación de impresión están separadas por 90 grados para la misma cadena, esta función devuelve las dimensiones de la cadena en la estructura SIZE como { cx : 18, cy : 116 }.

Dado que algunos dispositivos intercalar caracteres, la suma de las extensiones de los índices de glifos individuales puede no ser igual a la extensión de toda la matriz de índices de glifo.

El ancho de cadena calculado tiene en cuenta el espaciado intercharacter establecido por la función SetTextCharacterExtra .

Requisitos


Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	wingdi.h (incluye Windows.h)
Library	Gdi32.lib
Archivo DLL	Gdi32.dll