Función GetTextAlign (wingdi.h)

Artículo
03/08/2023

La función GetTextAlign recupera la configuración de alineación de texto para el contexto de dispositivo especificado.

Sintaxis

UINT GetTextAlign(
  [in] HDC hdc
);

Parámetros

[in] hdc

Identificador del contexto del dispositivo.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es el estado de las marcas de alineación de texto. Para obtener más información sobre el valor devuelto, vea la sección Comentarios. El valor devuelto es una combinación de los siguientes valores.

Valor	Significado
TA_BASELINE	El punto de referencia está en la línea base del texto.
TA_BOTTOM	El punto de referencia está en el borde inferior del rectángulo delimitador.
TA_TOP	El punto de referencia está en el borde superior del rectángulo delimitador.
TA_CENTER	El punto de referencia se alinea horizontalmente con el centro del rectángulo delimitador.
TA_LEFT	El punto de referencia está en el borde izquierdo del rectángulo delimitador.
TA_RIGHT	El punto de referencia está en el borde derecho del rectángulo delimitador.
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_NOUPDATECP	La posición actual no se actualiza después de cada llamada de salida de texto.
TA_UPDATECP	La posición actual se actualiza después de cada llamada de salida de texto.

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

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

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

Comentarios

El rectángulo delimitador es un rectángulo que limita todas las celdas de caracteres de una cadena de texto. Sus dimensiones se pueden obtener llamando a la función GetTextExtentPoint32 .

Las marcas de alineación de texto determinan cómo las funciones TextOut y ExtTextOut alinean una cadena de texto en relación con el punto de referencia de la cadena proporcionado a TextOut o ExtTextOut.

Las marcas de alineación de texto no son necesariamente marcas de bits únicas y pueden ser iguales a cero. Las marcas deben examinarse en grupos de marcas relacionadas, como se muestra en la lista siguiente.

TA_LEFT, TA_RIGHT y TA_CENTER
TA_BOTTOM, TA_TOP y TA_BASELINE
TA_NOUPDATECP y TA_UPDATECP

Si la fuente actual tiene una línea base predeterminada vertical, las marcas relacionadas se muestran en la lista siguiente.

TA_LEFT, TA_RIGHT y VTA_BASELINE
TA_BOTTOM, TA_TOP y VTA_CENTER
TA_NOUPDATECP y TA_UPDATECP

Para comprobar que se establece una marca determinada en el valor devuelto de esta función:

Aplique el operador OR bit a bit a la marca y sus marcas relacionadas.
Aplique el operador AND bit a bit al resultado y al valor devuelto.
Pruebe la igualdad de este resultado y la marca.

Ejemplos

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

Requisitos

Requisito	Value
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