Árvore de páginas

Construtor TSimpleEditor:New

Método construtor da classe.

Sintaxe

TSimpleEditor():New( [ nRow ], [ nCol ], [ oWnd ], [ nWidth ], [ nHeight ], [ cText ], [ lReadOnly ], [ bSetGet ], [ oFont ], [ lPixel ], [ bWhen ], [ bValid ], [ cLabelText ], [ nLabelPos ], [ oLabelFont ], [ nLabelColor ], [ bChanged ] )

Parâmetros

Nome

Tipo

Descrição

Obrigatório

Referência

nRow

numérico

Indica a coordenada vertical em pixels ou caracteres.

 

 

nCol

numérico

Indica a coordenada horizontal em pixels ou caracteres.

 

 

oWnd

objeto

Indica a janela ou controle visual onde o objeto será criado.

 

 

nWidth

numérico

Indica a largura em pixels do objeto.

 

 

nHeight

numérico

Indica a altura em pixels do objeto.

 

 

cText

caractere

Indica o texto que será apresentado na inicialização do objeto.

 

 

lReadOnly

lógico

Indica se, verdadeiro (.T.), o texto não pode ser editado; caso contrário, falso (.F.).

 

 

bSetGet

bloco de código

Indica o bloco de código, no formato {|u| if( Pcount( )>0, := u, ) }, que será executado para atualizar a variável (essa variável deve ser do tipo caracter). Desta forma, se a lista for sequencial, o controle atualizará com o conteúdo do item selecionado, se for indexada, será atualizada com o valor do índice do item selecionado.

 

 

oFont

objeto

Indica o objeto do tipo TFont que será utilizado para definir as características da fonte aplicada na exibição do conteúdo do controle visual.

 

 

lPixel

lógico

Indica se considera as coordenadas passadas em pixels (.T.) ou caracteres (.F.).

 

 

bWhen

bloco de código

Indica o bloco de código que será executado quando a mudança de foco da entrada de dados, na janela em que o controle foi criado, estiver sendo efetuada. Observação: O bloco de código retornará verdadeiro (.T.) se o controle permanecer habilitado; caso contrário, retornará falso (.F.).

 

 

bValid

bloco de código

Indica o bloco de código de validação que será executado quando o conteúdo do objeto for modificado. Retorna verdadeiro (.T.), se o conteúdo é válido; caso contrário, falso (.F.).

 

 

cLabelText

caractere

indica o texto que será apresentado na Label.

 

 

nLabelPos

numérico

Indica a posição da label, sendo 1=Topo e 2=Esquerda

 

 

oLabelFont

objeto

Indica o objeto, do tipo TFont, que será utilizado para definir as características da fonte aplicada na exibição da label.

 

 

nLabelColor

numérico

Indica a cor do texto da Label.

 

 

bChanged

bloco de código

Indica o bloco de código que será disparado no método Load e no Recortar (CTRL+X) e Colar (CTRL+V). Parâmetro disponível em builds superiores à 131227A.

 

 

Retorno

Nome

Tipo

Descrição

oObj

objeto

Nova instância da classe TSimpleEditor

Observações

  • Em versões superiores à build 7.00.120420A foi implementada a opção para definição de uma label (descrição) do componente visual. Preenchendo os parâmetros cLabelText, nLabelPos, oLabelFont e nLabelColor será disponibilizada, ao topo ou à esquerda, a descrição definida para o componente. Esta característica visa diminuir a quantidade de interações entre o SmartClient e o AppServer na construção de telas, otimizando assim este processo. Importante: Quando utilizada esta opção não será possível alinhar o componente, sendo a Label um objeto independente ela não será alinhada juntamente com o Controle principal, nesta situação é necessário fazer o posicionamento manualmente.

Exemplos

  oEdit := TSimpleEditor():New( 0,0,oDlg,260,184 )
  • Sem rótulos