Partilhar via


CDC::GetTextExtentExPointI

Retorna o número de caracteres em uma cadeia de caracteres especificada que ele caiba em um espaço especificado e preenche uma matriz com a extensão de texto para cada um de esses caracteres.

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

Parâmetros

  • pgiIn
    Um ponteiro para um array de índices de glifo para que as extensões devem ser recuperadas.

  • cgi
    Especifica o número de glifos na matriz apontada por pgiIn.

  • nMaxExtent
    - Especifica o comprimento máximo permitido, em unidades lógicas, da cadeia de caracteres formatada.

  • lpnFit
    Um ponteiro para um número inteiro que recebeu uma contagem do número máximo de caracteres que caberão no espaço especificado por nMaxExtent. Quando lpnFit é NULO, nMaxExtent será ignorado.

  • alpDx
    Um ponteiro para uma matriz de inteiros que recebe extensões parciais de glifos. Cada elemento na matriz fornece a distância, em unidades lógicas, entre o início da matriz de índices de glifo e um dos glifos que se encaixam no espaço especificado por nMaxExtent. Embora essa matriz deve ter pelo menos quantos elementos como os índices de glifo especificados por cgi, a função preenche a matriz com as extensões somente para tantas índices de glifo como são especificados por lpnFit. Se o lpnDx é NULO, a função não calcula larguras parciais de cadeia de caracteres.

  • lpSize
    Ponteiro a estrutura de TAMANHO que receberá as dimensões da matriz índices de glifo, em unidades lógicas. Esse valor pode não ser NULO.

Valor de retorno

Diferente de zero se a função é com êxito; se não 0.

Comentários

Essa função de membro emula a funcionalidade de função GetTextExtentExPointI, como descrito em Windows SDK.

Requisitos

Cabeçalho: afxwin.h

Consulte também

Referência

CDC Class

Gráfico da hierarquia

CDC::GetTextExtentPointI