Compartir a través de


CDC::GetTextExtentExPointI

Recupera el número de caracteres de una cadena especificada que se ajusta a un espacio especificado y rellena una matriz con la extensión de texto para cada uno de esos caracteres.

BOOL GetTextExtentExPointI(
   LPWORD pgiIn,
   int cgi,
   int nMaxExtent,
   LPINT lpnFit,
   LPINT alpDx,
   LPSIZE lpSize
) const;

Parámetros

  • pgiIn
    Puntero a una matriz de índices de glifo para los que las extensiones deben recuperarse.

  • cgi
    Especifica el número de glifos en la matriz indicada por pgiIn.

  • nMaxExtent
    Especifica el ancho máximo permitido, en unidades lógicas, de la cadena con formato.

  • lpnFit
    Un puntero a un entero que recibe un recuento del número de caracteres máximo que cabrá en el espacio especificado por nMaxExtent.Cuando lpnFit es NULL, se omite nMaxExtent .

  • alpDx
    Puntero a una matriz de enteros que recibe extensiones parciales del glifo.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 caben en el espacio especificado por nMaxExtent.Aunque esta matriz debe tener al menos tantos elementos como índices de glifo especificados por cgi, la función rellena la matriz con extensiones sólo para tantos índices de glifo como se especifican mediante lpnFit.Si el lpnDx es NULL, la función no calcula anchos parciales de cadena.

  • lpSize
    Puntero a una estructura de CALIBRE que recibe las dimensiones de la matriz de índices de glifo, en unidades lógicas.Este valor no puede ser NULL.

Valor devuelto

Distinto de cero si la función es correcta; si no 0.

Comentarios

Esta función miembro emula la funcionalidad de la función GetTextExtentExPointI, como se describe en Windows SDK.

Requisitos

encabezado: afxwin.h

Vea también

Referencia

Clase de la CDC

Gráfico de jerarquía

CDC::GetTextExtentPointI