OBJECT Get text orientation
OBJECT Get text orientation ( {* ;} object ) : Integer
| Parâmetro | Tipo | Descrição | |
|---|---|---|---|
| * | Operador | → | Se especifica, objeto é um nome de objeto (cadeia) Se omite, objeto é um campo ou uma variável |
| object | any | → | Nome de objeto (se for especificado *) ou Campo ou variável (se for omitido *) |
| Resultado | Integer | ← | Ângulo de rotação de texto |
Esse comando não é seguro para thread e não pode ser usado em código adequado.
Descrição
O comando OBJECT Get text orientation devolve o valor de orientação atual aplicado ao texto do objeto ou dos objetos designado(s) pelos parâmetros objeto e *.
Pode configurar a opção "Orientação" para um objeto em modo de desenho utilizando a lista de propriedades, ou utilizando o comando OBJECT SET TEXT ORIENTATION.
Se passar o parâmetro opcional * indica que o parâmetro objeto é um nome de objeto (cadeia). Se não passa este parâmetro, indica que o parâmetro objeto é um campo ou uma variável. Neste caso, se passa uma referência de campo ou variável no lugar de uma cadeia (campo ou variável objeto unicamente).
O valor que se devolve corresponde a uma das seguintes constantes, que se encontram no tema "Propriedades dos objetos ":
| Constante | Tipo | Valor | Comentário |
|---|---|---|---|
| Orientation 0° | Inteiro longo | 0 | Sem rotação (valor por padrão) |
| Orientation 180° | Inteiro longo | 180 | Orientação do texto a 180° no sentido horário |
| Orientation 90° left | Inteiro longo | 270 | Orientação do texto a 90° no sentido anti horário |
| Orientation 90° right | Inteiro longo | 90 | Orientação do texto a 90° no sentido horário |
Exemplo
Dado o seguinte objeto (onde se aplicou uma orientação "90 ° a esquerda" no editor de formulários):
Quando se executa o formulário, é chamada a seguinte declaração:
OBJECT SET TEXT ORIENTATION(*;"myText";Orientation 180°)
... a continuação, o objeto aparece da seguinte maneira:
$vOrt:=OBJECT Get text orientation(*;"myText") //$vOrt=180