Função GetTextExtentPointA (wingdi.h)
A função GetTextExtentPoint calcula a largura e a altura da cadeia de caracteres de texto especificada.
Sintaxe
BOOL GetTextExtentPointA(
[in] HDC hdc,
[in] LPCSTR lpString,
[in] int c,
[out] LPSIZE lpsz
);
Parâmetros
[in] hdc
Um identificador para o contexto do dispositivo.
[in] lpString
Um ponteiro para a cadeia de caracteres que especifica o texto. A cadeia de caracteres não precisa ser terminada em zero, pois cbString especifica o comprimento da cadeia de caracteres.
[in] c
O comprimento da cadeia de caracteres apontada por lpString.
[out] lpsz
Um 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 GetTextExtentPoint usa a fonte selecionada no momento para calcular as dimensões da cadeia de caracteres. A largura e a altura, em unidades lógicas, são computadas sem considerar nenhum recorte. Além disso, essa função 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 use uma fonte especificando um escape diferente de zero, essa função não usará o ângulo ao calcular a extensão de texto. O aplicativo deve convertê-lo explicitamente.
Como alguns dispositivos kern characters, a soma das extensões dos caracteres em uma cadeia de caracteres pode não ser igual à extensão da cadeia de caracteres.
A largura da cadeia de caracteres calculada leva em conta o espaçamento entre caracteres definido pela função SetTextCharacterExtra .
Observação
O cabeçalho wingdi.h define GetTextExtentPoint como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.
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 |