int SetTextJustification ( int nBreakExtra, int nBreakCount );
Valor de retorno
Um se a função for bem-sucedida; caso contrário 0.
Parâmetros
nBreakExtra
Especifica o espaço extra total a ser adicionado à linha do texto (em unidades lógicas). Se o modo de mapeamento atual não é MM_TEXT, o valor dado por este parâmetro é convertido para o modo de mapeamento atual e arredondado para a unidade mais próxima do dispositivo.
nBreakCount
Especifica o número de caracteres de interrupção na linha.
Observações
Adiciona espaço para os caracteres em uma Cadeia de caracteres. Um aplicativo pode usar as funções de membro GetTextMetrics para recuperar o caractere de interrupção da fonte.
Depois que a função de membro SetTextJustification é chamada, uma chamada para uma função de saída de texto (como TextOut) distribui o espaço extra especificado igualmente entre o número especificado de caracteres de interrupção. 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 de membro GetTextExtent é normalmente usada com SetTextJustification. GetTextExtent calcula a largura de uma determinada linha antes de alinhamento. Um aplicativo pode determinar quanto espaço para especificar no parâmetro nBreakExtra , subtraindo o valor retornado por GetTextExtent da largura da Cadeia de caracteres após o alinhamento.
A função SetTextJustification pode ser usada para alinhar uma linha que contém Múltiplo execuções em diferentes fontes. Neste caso, a linha deve ser criada de forma fragmentada alinhando e escrever cada execução separadamente.
Porque arredondamento erros pode ocorrer durante o alinhamento, o sistema mantém um termo de erro executando que define o erro atual. Ao alinhar uma linha que contém Múltiplo execuções, GetTextExtent usa automaticamente esse termo de erro quando ele calcula a extensão da próxima execução. Isso permite que a função de saída de texto combinar o erro para a novo execução.
Depois de cada linha foi alinhada, esse termo de erro deve ser apurado para impedi-lo de ser incorporada a linha seguinte. O termo pode ser desmarcado por chamada SetTextJustification com nBreakExtra definido como 0.
Visão geral do CDC | Membros de classe | Gráfico de hierarquia
Consulte tambémnbsp;CDC::GetMapMode, CDC::GetTextExtent, CDC::GetTextMetrics, CDC::SetMapMode, CDC::TextOut, :: SetTextJustification