Partilhar via


CDC::SetTextJustification

Adiciona espaço para caracteres de interrupção em uma cadeia de caracteres.

int SetTextJustification(
   int nBreakExtra,
   int nBreakCount 
);

Parâmetros

  • nBreakExtra
    Especifica o espaço extra total a ser adicionado para a linha de texto (em unidades lógicas).Se o modo atual de mapeamento não é MM_TEXT, o valor fornecido por esse parâmetro é convertido para o modo atual de mapeamento e arredondado para a unidade de dispositivo a mais próxima.

  • nBreakCount
    Especifica o número de caracteres de interrupção na linha.

Valor de retorno

Um se a função é com êxito; se não 0.

Comentários

Um aplicativo pode usar as funções de membro de GetTextMetrics para recuperar o caractere de interrupção de uma fonte.

Depois que a função de membro de SetTextJustification é chamada, uma chamada à função do texto - saída (como) TextOutdistribuir 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 qualquer 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 a quantidade de espaço para especificar o parâmetro de nBreakExtra subtraindo o valor retornado por GetTextExtent largura da cadeia de caracteres após o alinhamento.

A função de SetTextJustification pode ser usada para alinhar uma linha que contém é executado em várias fontes diferentes.Em esse caso, a linha será criado para cada poucos alinhar e escrevendo um executado separadamente.

Porque erros de arredondamento pode ocorrer durante o alinhamento, o sistema mantém um termo em execução de erro que define o erro atual.Para alinhar uma linha que contém vários é executado, GetTextExtent automaticamente usa esse termo de erro quando calcula a extensão em seguida de execução.Isso permite que a função do texto - saída mistura o erro na nova execução.

Após cada linha foi alinhada, o termo de erro deve ser desmarcado para impedir que está inserida na próxima linha.O termo pode ser desmarcado chamando SetTextJustification com nBreakExtra definido como 0.

Requisitos

Cabeçalho: afxwin.h

Consulte também

Referência

CDC Class

Gráfico de hierarquia

CDC::GetMapMode

CDC::GetTextExtent

CDC::GetTextMetrics

CDC::SetMapMode

CDC::TextOut

SetTextJustification