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

Consulte también

Funciones de fuente y texto

Información general sobre fuentes y texto

GetTextExtentPoint

SIZE