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 de hierarquia

CDC::GetTextExtentPointI