Función SetTextAlign (wingdi.h)

Artículo
08/27/2023

La función SetTextAlign establece las marcas de alineación de texto para el contexto de dispositivo especificado.

Sintaxis

UINT SetTextAlign(
  [in] HDC  hdc,
  [in] UINT align
);

Parámetros

[in] hdc

Identificador del contexto del dispositivo.

[in] align

Alineación de texto mediante una máscara de los valores de la lista siguiente. Solo se puede elegir una marca de las que afectan a la alineación horizontal y vertical. Además, solo se puede elegir una de las dos marcas que modifican la posición actual.

Value	Significado
TA_BASELINE	El punto de referencia estará en la línea base del texto.
TA_BOTTOM	El punto de referencia estará en el borde inferior del rectángulo delimitador.
TA_TOP	El punto de referencia estará en el borde superior del rectángulo delimitador.
TA_CENTER	El punto de referencia se alineará horizontalmente con el centro del rectángulo delimitador.
TA_LEFT	El punto de referencia estará en el borde izquierdo del rectángulo delimitador.
TA_RIGHT	El punto de referencia estará en el borde derecho del rectángulo delimitador.
TA_NOUPDATECP	La posición actual no se actualiza después de cada llamada de salida de texto. El punto de referencia se pasa a la función de salida de texto.
TA_RTLREADING	Edición de idioma de Oriente Medio de Windows: El texto se coloca en orden de lectura de derecha a izquierda, en lugar del orden predeterminado de izquierda a derecha. Esto solo se aplica cuando la fuente seleccionada en el contexto del dispositivo es hebreo o árabe.
TA_UPDATECP	La posición actual se actualiza después de cada llamada de salida de texto. La posición actual se usa como punto de referencia.

Cuando la fuente actual tiene una línea base predeterminada vertical, como con Kanji, se deben usar los siguientes valores en lugar de TA_BASELINE y TA_CENTER.

Value	Significado
VTA_BASELINE	El punto de referencia estará en la línea base del texto.
VTA_CENTER	El punto de referencia se alineará verticalmente con el centro del rectángulo delimitador.

Los valores predeterminados son TA_LEFT, TA_TOP y TA_NOUPDATECP.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es la configuración de alineación de texto anterior.

Si se produce un error en la función, el valor devuelto es GDI_ERROR.

Comentarios

Las funciones TextOut y ExtTextOut usan las marcas de alineación de texto para colocar una cadena de texto en una pantalla u otro dispositivo. Las marcas especifican la relación entre un punto de referencia y un rectángulo que enlaza el texto. El punto de referencia es la posición actual o un punto pasado a una función de salida de texto.

El rectángulo que enlaza el texto está formado por las celdas de caracteres de la cadena de texto.

La mejor manera de obtener texto alineado a la izquierda es usar cualquiera de las dos


SetTextAlign (hdc, GetTextAlign(hdc) & (~TA_CENTER))


SetTextAlign (hdc,TA_LEFT | <other flags>)

También puede usar SetTextAlign (hdc, TA_LEFT) para este propósito, pero esto pierde cualquier configuración vertical o de derecha a izquierda.

Nota No debe usar SetTextAlign con TA_UPDATECP cuando use ScriptStringOut, ya que el texto seleccionado no se representa correctamente. Si debe usar esta marca, puede anular la configuración y restablecerla según sea necesario para evitar el problema.

Ejemplos

Para obtener un ejemplo, vea Establecer la alineación de texto.

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