wingdi.h


GetTextAlign

La función GetTextAlign recuoera el estado de alineamiento de texto para el contexto de dispositivo especificado.

Sintaxis

UINT GetTextAlign(
    HDC hdc  // manipulador de contexto de dispositivo
   );

Parámetros

hdc: identifica el contexto de dispositivo.

Valor de retorno

Si la función tiene éxito, el valor de retorno es el estado de las banderas de alineamiento de texto.

Si la función falla, el valor de retorno es GDI_ERROR. Para obtener mayor información sobre el motivo del error, llamar a GetLastError.

Para ver una lista de los valores de retorno de estado, ver la sección de observaciones. El valor de retorno es una combinación de uno o más de los siguientes valores:

Valor Significado
TA_BASELINE El punto de referencia es la línea de base del texto.
TA_BOTTOM El punto de referencia es el borde inferior del rectángulo externo que contiene el texto.
TA_TOP El punto de referencia es el borde superior del rectángulo que contiene el texto.
TA_CENTER El punto de referencia se alinea horizontalmente con el centro del rectángulo que contiene el texto.
TA_LEFT El punto de referencia es el borde izquierdo del rectángulo que contiene el texto.
TA_RIGHT El punto de referencia es el borde derecho del rectángulo que contiene el texto.
TA_RTLREADING Sólo en Windows 95: el texto se coloca de derecha a izquierda, como oposición al orden por defecto, de izquierda a derecha. Esto sólo se aplica cuando la fuente seleccionada en el contexto de dispositivo es Hebrea o Arábiga.
TA_NOUPDATECP La posición actual del cursor no se actualiza después de cada llamada a una función de escritura de texto.
TA_UPDATECP La posición actual del cursor se actualiza después de cada llamada a una función de escritura de texto

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

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

Observaciones

El rectángulo que contiene el texto es un rectángulo que contiene todas las celdas de los caracteres en la cadena de texto. Sus dimensiones pueden obtenerse llamando a la función GetTextExtentPoint32.

Las banderas de alineamiento de texto determinan el modo en que las funciones TextOut y ExtTextOut alinean una cadena de texto en relación al punto de referencia de la cadena proporcionado por TextOut o ExtTextOut.

Las banderas de alineamiento de texto no son necesariamente banderas de bits sueltos y pueden ser iguales a cero. Las banderas deben ser examinadas por grupos de banderas relacionadas, tal 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 de base vertical por defecto, las banderas mencionadas son como 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 verificar que una bandera particular está activa en un valor de retornado por esta función, la aplicación debe realizar los pasos siguientes:

  1. Aplicar el operador de bits OR a la bandera y sus banderas relacionadas.
  2. Aplicar el operador de bits AND entre el resultado anterior y al valor retornado.
  3. Verificar la igualdad entre ese resultado y la bandera a verificar.