CDC::SetTextJustification

int SetTextJustification ( int nBreakExtra, int nBreakCount );

Valor devuelto

Uno si la función es correcta; caso contrario 0.

Parámetros

nBreakExtra

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

nBreakCount

Especifica el número de caracteres de salto de la línea.

Observaciones

Agrega espacio a los caracteres de salto de una cadena. Una aplicación puede utilizar las funciones de miembro de GetTextMetrics para recuperar el carácter de salto de la fuente.

Después de llama a la función de miembro de SetTextJustification , una llamada a una función de salida de texto (como TextOut) distribuye el espacio adicional especificado uniformemente entre el número especificado de caracteres de salto. El carácter de salto es usualmente el carácter de espacio (ASCII 32), pero puede definirse mediante una fuente como algunos otros caracteres.

Normalmente se utiliza la función miembro GetTextExtent 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 el parámetro nBreakExtra restando el valor devuelto por GetTextExtent desde el ancho de la cadena después de alineación.

La función SetTextJustification puede utilizarse para alinear una línea que contenga varias carreras en distintas fuentes. En este caso, la línea debe crearse parciales por alinear y escrito por separado cada ejecución.

Debido a errores de redondeo pueden ocurrir durante la alineación, el sistema mantiene un término de error de ejecución que define el error actual. Al alinear una línea que contiene múltiples ejecuciones, GetTextExtent utiliza automáticamente este término de error cuando calcula el alcance de la siguiente ejecución. Esto permite que la función de salida de texto fusionar el error en la ejecución nueva.

Después de cada línea se ha alineado este término de error debe borrarse para impedir incorporarse a la línea siguiente. El término puede borrarse llamando a SetTextJustification con nBreakExtra establecido a 0.

Visió&n General de CDC |nbsp; Miembros de clase | Diagrama de jerarquía

Vea tambiénnbsp;CDC::GetMapMode, CDC::GetTextExtent, CDC::GetTextMetrics, CDC::SetMapMode, CDC::TextOut, :: SetTextJustification

Index