Função SetTextJustification (wingdi.h)

Artigo
08/27/2023

A função SetTextJustification especifica a quantidade de espaço que o sistema deve adicionar aos caracteres de interrupção em uma cadeia de caracteres de texto. O espaço é adicionado quando um aplicativo chama as funções TextOut ou ExtTextOut .

Sintaxe

BOOL SetTextJustification(
  [in] HDC hdc,
  [in] int extra,
  [in] int count
);

Parâmetros

[in] hdc

Um identificador para o contexto do dispositivo.

[in] extra

O espaço extra total, em unidades lógicas, a ser adicionado à linha de texto. Se o modo de mapeamento atual não for MM_TEXT, o valor identificado pelo parâmetro nBreakExtra será transformado e arredondado para o pixel mais próximo.

[in] count

O número de caracteres de quebra na linha.

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

O caractere de interrupção geralmente é o caractere de espaço (ASCII 32), mas pode ser definido por uma fonte como algum outro caractere. A função GetTextMetrics pode ser usada para recuperar o caractere de quebra de uma fonte.

A função TextOut distribui o espaço extra especificado uniformemente entre os caracteres de quebra na linha.

A função GetTextExtentPoint32 é sempre usada com a função SetTextJustification . Às vezes, a função GetTextExtentPoint32 leva em conta a justificativa ao calcular a largura de uma linha especificada antes da justificativa e, às vezes, não. Para obter mais detalhes sobre isso, consulte GetTextExtentPoint32. Essa largura deve ser conhecida antes que um valor nBreakExtra apropriado possa ser calculado.

SetTextJustification pode ser usado para justificar uma linha que contém várias cadeias de caracteres em fontes diferentes. Nesse caso, cada cadeia de caracteres deve ser justificada separadamente.

Como erros de arredondamento podem ocorrer durante a justificativa, o sistema mantém um termo de erro em execução que define o valor de erro atual. Ao justificar uma linha que contém várias execuções, GetTextExtentPoint usa automaticamente esse termo de erro quando calcula a extensão da próxima execução, permitindo que TextOut misture o erro na nova execução. Depois que cada linha for justificada, esse termo de erro deverá ser limpo para evitar que ela seja incorporada à próxima linha. O termo pode ser limpo chamando SetTextJustification com nBreakExtra definido como zero.

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