Función SetTextJustification (wingdi.h)

Artículo
08/27/2023

La función SetTextJustification especifica la cantidad de espacio que el sistema debe agregar a los caracteres de interrupción en una cadena de texto. El espacio se agrega cuando una aplicación llama a las funciones TextOut o ExtTextOut .

Sintaxis

BOOL SetTextJustification(
  [in] HDC hdc,
  [in] int extra,
  [in] int count
);

Parámetros

[in] hdc

Identificador del contexto del dispositivo.

[in] extra

Espacio adicional total, en unidades lógicas, que se va a agregar a la línea de texto. Si el modo de asignación actual no es MM_TEXT, el valor identificado por el parámetro nBreakExtra se transforma y redondea al píxel más cercano.

[in] count

Número de caracteres de salto en la línea.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero.

Comentarios

El carácter de interrupción suele ser el carácter de espacio (ASCII 32), pero puede definirse mediante una fuente como otro carácter. La función GetTextMetrics se puede usar para recuperar el carácter de interrupción de una fuente.

La función TextOut distribuye el espacio adicional especificado uniformemente entre los caracteres de interrupción de la línea.

La función GetTextExtentPoint32 siempre se usa con la función SetTextJustification . A veces, la función GetTextExtentPoint32 tiene en cuenta la justificación al calcular el ancho de una línea especificada antes de la justificación y, a veces, no. Para obtener más información sobre esto, vea GetTextExtentPoint32. Este ancho debe conocerse antes de que se pueda calcular un valor nBreakExtra adecuado.

SetTextJustification se puede usar para justificar una línea que contiene varias cadenas en diferentes fuentes. En este caso, cada cadena debe justificarse por separado.

Dado que los errores de redondeo pueden producirse durante la justificación, el sistema mantiene un término de error en ejecución que define el valor de error actual. Al justificar una línea que contiene varias ejecuciones, GetTextExtentPoint usa automáticamente este término de error cuando calcula la extensión de la siguiente ejecución, lo que permite que TextOut combine el error en la nueva ejecución. Una vez justificada cada línea, este término de error debe borrarse para evitar que se incorpore a la siguiente línea. El término se puede borrar llamando a SetTextJustification con nBreakExtra establecido en cero.

Requisitos


Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	wingdi.h (incluye Windows.h)
Library	Gdi32.lib
Archivo DLL	Gdi32.dll