CDC::SetTextJustification

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 CDCMembros de classe | Gráfico de hierarquia

Consulte tambémnbsp;CDC::GetMapMode, CDC::GetTextExtent, CDC::GetTextMetrics, CDC::SetMapMode, CDC::TextOut, :: SetTextJustification

Index