OBJECT Get text orientation
OBJECT Get text orientation ( {* ;} objeto ) : Integer
| Parámetro | Tipo | Descripción | |
|---|---|---|---|
| * | Operador | → | Si se especifica, objeto es un nombre de objeto (cadena) Si se omite, objeto es un campo o una variable |
| objeto | any | → | Nombre de objeto (si se especifica *) o Campo o variable (si se omite *) |
| Resultado | Integer | ← | Ángulo de rotación de texto |
Este comando no es hilo seguro, no puede ser utilizado en código apropiativo.
Descripción
El comando OBJECT Get text orientation devuelve el valor de orientación actual aplicado al texto del objeto o de los objetos designado(s) por los parámetros objeto y *.
Puede configurar la opción "Orientación" para un objeto en modo de diseño utilizando la lista de propiedades, o utilizando el comando OBJECT SET TEXT ORIENTATION.
Si pasa el parámetro opcional * indica que el parámetro objeto es un nombre de objeto (cadena). Si no se pasa este parámetro, indica que el parámetro objeto es un campo o una variable. En este caso, se pasa una referencia de campo o variable en lugar de una cadena (campo o variable objeto únicamente).
El valor que se devuelve corresponde a una de las siguientes constantes, que se encuentran en el tema "Propiedades de los objetos":
| Constante | Tipo | Valor | Comentario |
|---|---|---|---|
| Orientation 0° | Entero largo | 0 | Sin rotación (valor por defecto) |
| Orientation 180° | Entero largo | 180 | Orientación del texto a 180° en el sentido horario |
| Orientation 90° left | Entero largo | 270 | Orientación del texto a 90° en el sentido antihorario |
| Orientation 90° right | Entero largo | 90 | Orientación del texto a 90° en el sentido horario |
Ejemplo
Dado el siguiente objeto (donde se aplicó una orientación "90 ° a la izquierda" en el editor de formularios):
Cuando se ejecuta el formulario, si se llama a la siguiente declaración:
OBJECT SET TEXT ORIENTATION(*;"myText";Orientation 180°)
... a continuación, el objeto aparece de la siguiente manera:
$vOrt:=OBJECT Get text orientation(*;"myText") //$vOrt=180