Función GetTextExtentExPointI (wingdi.h)
La función GetTextExtentExPointI recupera el número de caracteres de una cadena especificada que cabe dentro de un espacio especificado y rellena una matriz con la extensión de texto para cada uno de esos caracteres. (Una extensión de texto es la distancia entre el principio del espacio y un carácter que caberá en el espacio). Esta información es útil para los cálculos de ajuste de palabras.
Sintaxis
BOOL GetTextExtentExPointI(
[in] HDC hdc,
[in] LPWORD lpwszString,
[in] int cwchString,
[in] int nMaxExtent,
[out] LPINT lpnFit,
[out] LPINT lpnDx,
[out] LPSIZE lpSize
);
Parámetros
[in] hdc
Identificador del contexto del dispositivo.
[in] lpwszString
Puntero a una matriz de índices de glifo para la que se van a recuperar extensiones.
[in] cwchString
Número de glifos en la matriz a la que apunta el parámetro pgiIn .
[in] nMaxExtent
Ancho máximo permitido, en unidades lógicas, de la cadena con formato.
[out] lpnFit
Puntero a un entero que recibe un recuento del número máximo de caracteres que caberán en el espacio especificado por el parámetro nMaxExtent . Cuando el parámetro lpnFit es NULL, se omite el parámetro nMaxExtent .
[out] lpnDx
Puntero a una matriz de enteros que recibe extensiones de glifos parciales. Cada elemento de la matriz proporciona la distancia, en unidades lógicas, entre el principio de la matriz de índices de glifo y uno de los glifos que encajan en el espacio especificado por el parámetro nMaxExtent . Aunque esta matriz debe tener al menos tantos elementos como índices de glifo especificados por el parámetro cgi , la función rellena la matriz con extensiones solo para tantos índices de glifo como se especifican en el parámetro lpnFit . Si lpnFit es NULL, la función no calcula anchos de cadena parciales.
[out] lpSize
Puntero a una estructura SIZE que recibe las dimensiones de la matriz de índices de glifo, en unidades lógicas. Este valor no puede ser NULL.
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
Si los parámetros lpnFit y alpDx son NULL, llamar a la función GetTextExtentExPointI equivale a llamar a la función GetTextExtentPointI .
Cuando esta función devuelve la extensión de texto, se supone que el texto es horizontal, es decir, que el escape siempre es 0. Esto es cierto para las medidas horizontales y 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 convertirla explícitamente. Sin embargo, cuando el modo gráfico se establece en GM_ADVANCED y la orientación de caracteres 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 90 grados para la misma cadena, esta función devuelve las dimensiones de la cadena en la estructura SIZE como { cx : 18, cy : 116 }.
Requisitos
| Requisito | Value |
|---|---|
| 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 |