Función GetTextExtentPointI (wingdi.h)
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 |