Saltar para o conteúdo principal
Versão: 20 R7 BETA

OBJECT SET TEXT ORIENTATION

OBJECT SET TEXT ORIENTATION ( {* ;} objeto ; orientacao )

ParâmetroTipoDescrição
*OperadorSe especificado, objeto é um nome de objeto (cadeia) Se omitido, objeto é um campo ou uma variável
objetoanyNome de objeto (se * for especificado) ou
Campo ou variável (se * for omitido)
orientacaoIntegerValor de orientação do objeto

Descrição

O comando OBJECT SET TEXT ORIENTATION modifica a orientação do conteúdo do objeto ou dos objetos designados pelos parâmetros objeto e * para o processo atual.

A propriedade "Orientação", disponível no editor de formulários, realiza rotações de áreas de texto de maneira permanente em seus formulários. A diferença desta propriedade, o comando OBJECT SET TEXT ORIENTATION aplica a rotação ao conteúdo do objeto, mas não ao objeto em si. Para obter mais informação, consulte o Manual de Desenho.

Se passar o parâmetro opcional * indica que o parâmetro objeto é um nome de objeto (cadeia). Se não passar este parâmetro, indica que o parâmetro objeto é um campo ou uma variável. Neste caso, se passar uma referência de campo ou variável em lugar de uma cadeia (campo ou variável objeto unicamente).
Só os textos estáticos, assim como as variáveis e campos não editáveis podem girar. Se aplicar este comando a um objeto que não seja compatível com a orientação de texto, o comando não faz nada.

No parâmetro orientacao, passe a orientação absoluta que deseja atribuir ao objeto. Deve utilizar uma das seguintes constantes, do 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

Nota: só são admitidos os ângulos correspondentes a estes valores. Se passar qualquer outro valor, será ignorado.

Exemplo

Deseja aplicar uma orientação de 270° a uma variável em seu formulário:

 OBJECT SET ENTERABLE(*;"myVar";False)
  // Obrigatório se a variável é editável
 OBJECT SET TEXT ORIENTATION(*;"myVar";Orientation 90° left)

Ver também

OBJECT Get text orientation

Propriedades

Número do comando1284
Thread-seguro