Compartilhar via


Função GetTextExtentPointI (wingdi.h)

A função GetTextExtentPointI calcula a largura e a altura da matriz especificada de índices de glifo.

Sintaxe

BOOL GetTextExtentPointI(
  [in]  HDC    hdc,
  [in]  LPWORD pgiIn,
  [in]  int    cgi,
  [out] LPSIZE psize
);

Parâmetros

[in] hdc

Manipule para o contexto do dispositivo.

[in] pgiIn

Ponteiro para a matriz de índices de glifo.

[in] cgi

Especifica o número de índices de glifo.

[out] psize

Ponteiro para uma estrutura SIZE que recebe as dimensões da cadeia de caracteres, em unidades lógicas.

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero.

Comentários

A função GetTextExtentPointI usa a fonte selecionada no momento para calcular as dimensões da matriz de índices de glifo. A largura e a altura, em unidades lógicas, são computadas sem considerar nenhum recorte.

Quando essa função retorna a extensão de texto, ela pressupõe que o texto seja horizontal, ou seja, que o escape é sempre 0. Isso é verdadeiro para as medidas horizontais e verticais do texto. Mesmo que você use uma fonte que especifica um escape diferente de zero, essa função não usa o ângulo enquanto calcula a extensão de texto. O aplicativo deve convertê-lo explicitamente. No entanto, quando o modo gráfico é definido como GM_ADVANCED e a orientação do caractere está a 90 graus da orientação de impressão, os valores retornados por essa função não seguem essa regra. Quando a orientação do caractere e a orientação de impressão correspondem a uma determinada cadeia de caracteres, essa função retorna as dimensões da cadeia de caracteres na estrutura SIZE como { cx : 116, cy : 18 }. Quando a orientação do caractere e a orientação de impressão têm 90 graus de diferença para a mesma cadeia de caracteres, essa função retorna as dimensões da cadeia de caracteres na estrutura SIZE como { cx : 18, cy : 116 }.

Como alguns dispositivos kern characters, a soma das extensões dos índices de glifo individuais pode não ser igual à extensão de toda a matriz de índices de glifo.

A largura da cadeia de caracteres calculada leva em conta o espaçamento entre caracteres definido pela função SetTextCharacterExtra .

Requisitos

   
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho wingdi.h (inclua Windows.h)
Biblioteca Gdi32.lib
DLL Gdi32.dll

Confira também

Funções de fonte e texto

Visão geral de fontes e texto

GetTextExtentPoint

Gettextextentpoint32

SIZE

SetTextCharacterExtra