Share via


CDC::SetTextJustification

Agregue el espacio a caracteres de interrupción en una cadena.

int SetTextJustification(
   int nBreakExtra,
   int nBreakCount 
);

Parámetros

  • nBreakExtra
    especifica el espacio adicional total que se agregará a la línea de texto (en unidades lógicas).Si el modo actual de asignación no tiene MM_TEXT, el valor proporcionado por este parámetro se convierte el modo actual de asignación y redondeado a la unidad más cercana.

  • nBreakCount
    Especifica el número de caracteres de interrupción en la línea.

Valor devuelto

Uno si la función es correcta; si no 0.

Comentarios

Una aplicación puede utilizar las funciones miembro de GetTextMetrics para recuperar el carácter de la interrupción de una fuente.

Después de que se llame a la función miembro de SetTextJustification , una llamada a una función texto-generada (como TextOut) enruta el espacio adicional especificado uniformemente entre el número de caracteres especificado de interrupción.El carácter de interrupción es normalmente el carácter de espacio (32 ASCII), pero puede estar definida por una fuente como algún otro carácter.

La función GetTextExtent miembro se utiliza normalmente con SetTextJustification.GetTextExtent calcula el ancho de una línea determinada antes de alineación.Una aplicación puede determinar cuánto espacio para especificar en el parámetro de nBreakExtra restando el valor devuelto por GetTextExtent width de la cadena después de alineación.

La función de SetTextJustification se puede utilizar para alinear una línea que contenga varias ejecuciones en varias fuentes.En este caso, la línea debe crear bit a bit alineando y escribiendo cada ejecución por separado.

Porque el redondeo errores puede producir durante la alineación, el sistema mantiene un término actual de error que defina el error actual.Para alinear una línea que contenga varias ejecuciones, GetTextExtent utiliza automáticamente este término de error cuando calcula la extensión después de la ejecución.Esto permite que la función texto-generada mezcla el error el nueva ejecución.

Después de cada línea se ha alineado, este término de error se debe borrar para impedir especificada en la línea siguiente.El término puede ser barrido llamando a SetTextJustification con nBreakExtra establecido en 0.

Requisitos

encabezado: afxwin.h

Vea también

Referencia

Clase de la CDC

Gráfico de jerarquía

CDC::GetMapMode

CDC::GetTextExtent

CDC::GetTextMetrics

CDC::SetMapMode

CDC::TextOut

SetTextJustification