wingdi.h


SetTextAlign

La función SetTextAlign activa las banderas de alineamiento de texto para el contexto de dispositivo especificadot.

Sintaxis

UINT SetTextAlign(
    HDC hdc,    // manipulador de contexto de dispositivo
    UINT fMode  // banderas de alineamiento de texto
   );

Parámetros

hdc: identifica el contexto de dispositivo.

fMode: especifica el alineamiento de texto mediante el uso de una máscara de los valores de la lista siguiente. Sólo una bandera puede ser elegida de aquellas que afecten al alineamiento horizontal y vertical. Además, sólo se puede elegir una de las dos banderas que alteran la posición del cursor.

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 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.

Los valores por defecto sone TA_LEFT, TA_TOP y TA_NOUPDATECP.

Valor de retorno

Si la función tiene éxito, el valor de retorno es el del valor previo de alineamiento de texto.

Si la función falla, el valor de retorno es GDI_ERROR. Para obtener información adicional, llamar a GetLastError.

Observaciones

Las funciones TextOut y ExtTextOut usan las banderas de alineamiento de texto para colocar la cadena de texto en la pantalla o en otros dispositivos. Las banderas especifican la relación entre un punto de referencia y un rectángulo que contiene el texto. El punto de referencia es o bien la posición actual de cursos o el punto pasado a la función de salida de texto.

El rectángulo que bordea el texto se forma por las celdas de los caracteres en la cadena de texto.