Saltar para o conteúdo principal
Versão: Próximo

OBJECT Get text orientation

OBJECT Get text orientation ( {* ;} object ) : Integer

ParâmetroTipoDescrição
*OperadorSe especifica, objeto é um nome de objeto (cadeia) Se omite, objeto é um campo ou uma variável
objectanyNome de objeto (se for especificado *) ou Campo ou variável (se for omitido *)
ResultadoIntegerÂ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 ":

ConstanteTipoValorComentário
Orientation 0°Inteiro longo0Sem rotação (valor por padrão)
Orientation 180°Inteiro longo180Orientação do texto a 180° no sentido horário
Orientation 90° leftInteiro longo270Orientação do texto a 90° no sentido anti horário
Orientation 90° rightInteiro longo90Orientaçã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

Ver também

OBJECT SET TEXT ORIENTATION