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.