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:
- Aplicar el operador de bits OR a la bandera y sus banderas relacionadas.
- Aplicar el operador de bits AND entre el resultado anterior y al valor retornado.
- Verificar la igualdad entre ese resultado y la bandera a verificar.