Função GetTextExtentPoint32W (wingdi.h)
A função GetTextExtentPoint32 calcula a largura e a altura da cadeia de caracteres de texto especificada.
Sintaxe
BOOL GetTextExtentPoint32W(
[in] HDC hdc,
[in] LPCWSTR lpString,
[in] int c,
[out] LPSIZE psizl
);
Parâmetros
[in] hdc
Um identificador para o contexto do dispositivo.
[in] lpString
Um ponteiro para um buffer que especifica a cadeia de caracteres de texto. A cadeia de caracteres não precisa ser terminada em nulo, pois o parâmetro c especifica o comprimento da cadeia de caracteres.
[in] c
O comprimento da cadeia de caracteres apontado por lpString.
[out] psizl
Um ponteiro para uma estrutura SIZE que recebe as dimensões da cadeia de caracteres, em unidades lógicas.
Valor de retorno
Se a função for bem-sucedida, o valor retornado não será zero.
Se a função falhar, o valor retornado será zero.
Observações
A função GetTextExtentPoint32 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.
Como alguns dispositivos kern caracteres, 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 de intercaracter definido pela função
Ao lidar com o texto exibido em uma tela, a largura da cadeia de caracteres calculada leva em conta o espaçamento entre caracteres definido pela função
- O resultado da impressão ignora o espaçamento entre caracteres, embora GetTextExtentPoint32 o leve em conta.
- O resultado da impressão leva em conta a justificativa, embora GetTextExtentPoint32 a ignore.
GetTextExtentPoint32 não considera "\n" (nova linha) ou "\r\n" (retorno de carro e nova linha) caracteres quando calcula a altura de uma cadeia de caracteres de texto.
Exemplos
Para obter um exemplo, consulte desenho de texto de fontes diferentes na mesma linha.
Nota
O cabeçalho wingdi.h define GetTextExtentPoint32 como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.
Requisitos
Requisito | Valor |
---|---|
de cliente com suporte mínimo | Windows 2000 Professional [somente aplicativos da área de trabalho] |
servidor com suporte mínimo | Windows 2000 Server [somente aplicativos da área de trabalho] |
da Plataforma de Destino |
Windows |
cabeçalho | wingdi.h (inclua Windows.h) |
biblioteca | Gdi32.lib |
de DLL |
Gdi32.dll |
Consulte também
ExtTextOut
tamanho do