The OBJECT Get text orientation command returns the current orientation value applied to the text of the object(s) designated by the object and * parameters.
You can set the "Orientation" option for an object in Design mode using the Property List, or using the OBJECT SET TEXT ORIENTATION command.
Passing the optional * parameter indicates that the object parameter is an object name (string). If you do not pass this parameter, it indicates that the object parameter is a field or variable. In this case, you pass a field or variable reference instead of a string (field or variable object only).
The value returns corresponds to one of the following constants, found in the "Form Objects (Properties)" theme:
Constant |
Type |
Value |
Comment |
Orientation 0° |
Longint |
0 |
No rotation (default value) |
Orientation 180° |
Longint |
180 |
Orientation of text to 180° clockwise |
Orientation 90° left |
Longint |
270 |
Orientation of text to 90° counter-clockwise |
Orientation 90° right |
Longint |
90 |
Orientation of text to 90° clockwise |
Given the following object (where a "90° left" orientation was applied in the Form editor):
When the form is executed, if you call the following statement:
... then the object appears as follows:
$vOrt:=OBJECT Get text orientation(*;"myText")