CDC::GetTextExtentExPointI

Artigo
08/25/2010

Recupera o número de caracteres em uma seqüência de caracteres especificada que couberem em um espaço especificado e preenche uma matriz com a extensão do texto para cada um desses caracteres.

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

Parâmetros

pgiIn
Um ponteiro para uma matriz de índices de glifo para o qual extensões devem ser recuperadas.
cgi
Especifica o número de glifos na matriz apontada por pgiIn.
nMaxExtent
Especifica a largura permitida máxima, em unidades lógicas, da seqüência formatada.
lpnFit
Um ponteiro para um número inteiro que recebe uma contagem do número máximo de caracteres que irá caber no espaço especificado por nMaxExtent. Quando lpnFit é NULO, nMaxExtent é ignorado.
alpDx
Um ponteiro para uma matriz de inteiros que recebe as extensões de glifo parcial.Cada elemento na matriz retorna a distância, em unidades lógicas, entre o início da matriz de índices de glifo e um dos glifos que cabe no espaço especificado por nMaxExtent. Embora essa matriz deve ter pelo menos o mesmo número de elementos sistema autônomo índices de glifo especificados por cgi, a função preenche a matriz com extensões somente para tantos índices de glifo conforme especificado pelo lpnFit. If lpnDx is NULO, a função não calcula larguras seqüência parcial.
lpSize
Ponteiro para um dimensionar estrutura que recebe as dimensões da matriz de índices de glifo, em unidades lógicas.Este valor não pode ser NULO.