Árvore de páginas

Você está vendo a versão antiga da página. Ver a versão atual.

Comparar com o atual Ver Histórico da Página

Versão 1 Próxima »

Construtor TGet:Create

Método construtor da classe.

Sintaxe

TGet():Create( [ oWnd ], [ bSetGet ], [ nRow ], [ nCol ], [ nWidth ], [ nHeight ], [ cPict ], [ bValid ], [ nClrFore ], [ nClrBack ], [ oFont ], [ uParam12 ], [ uParam13 ], [ lPixel ], [ uParam15 ], [ uParam16 ], [ bWhen ], [ uParam18 ], [ uParam19 ], [ bChange ], [ lReadOnly ], [ lPassword ], [ uParam23 ], [ cReadVar ], [ uParam25 ], [ uParam26 ], [ uParam27 ], [ lHasButton ], [ uParam29 ], [ uParam30 ], [ cLabelText ], [ nLabelPos ], [ oLabelFont ], [ nLabelColor ], [ cPlaceHold ] )

Parâmetros

Nome

Tipo

Descrição

Obrigatório

Referência

oWnd

objeto

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

 

 

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.

 

 

nRow

numérico

Indica a coordenada vertical em pixels ou caracteres.

 

 

nCol

numérico

Indica a coordenada horizontal em pixels ou caracteres.

 

 

nWidth

numérico

Indica a largura em pixels do objeto.

 

 

nHeight

numérico

Indica a altura em pixels do objeto.

 

 

cPict

caractere

Indica a máscara de formatação do conteúdo que será apresentada. Verificar Tabela de Pictures de Formatação

 

 

bValid

bloco de código

Indica o bloco de código de validação, que será executado quando este objeto estiver em foco, e o operador tentar mover o foco para outro componente da interface. Caso o bloco executado retorne .T., será permitida a mudança de foco. Caso o bloco executado retorne .F., não será permitido a remoção do foco do componente.

 

 

nClrFore

numérico

Indica a cor do texto do objeto.

 

 

nClrBack

numérico

Indica a cor de fundo do objeto.

 

 

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.

 

 

uParam12

lógico

Compatibilidade

 

 

uParam13

objeto

Compatibilidade

 

 

lPixel

lógico

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

 

 

uParam15

caractere

Compatibilidade

 

 

uParam16

lógico

Compatibilidade

 

 

bWhen

bloco de código

Indica o bloco de código que será executado quando a mudança de foco da entrada de dados no objeto criado estiver sendo realizada. Se o retorno for verdadeiro (.T.), o objeto continua habilitado; caso contrário, falso (.F.).

 

 

uParam18

lógico

Compatibilidade

 

 

uParam19

lógico

Compatibilidade

 

 

bChange

bloco de código

Indica o bloco de código que será executado quando o estado ou conteúdo do objeto é modificado pela ação sobre o controle visual.

 

 

lReadOnly

lógico

Indica se o objeto pode ser editado.

 

 

lPassword

lógico

Indica se, verdadeiro (.T.), o objeto apresentará asterisco (*) para entrada de dados de senha; caso contrário, falso (.F.).

 

 

uParam23

caractere

Compatibilidade

 

 

cReadVar

caractere

Indica o nome da variável, configurada no parâmetro bSetGet, que será manipulada pelo objeto. Além disso, esse parâmetro será o retorno da função ReadVar().

 

 

uParam25

caractere

Compatibilidade

 

 

uParam26

caractere

Compatibilidade

 

 

uParam27

lógico

Compatibilidade

 

 

lHasButton

lógico

Se definido .T. indica que deve ser aplicado o botão para seleção de Data ou Calculadora.

 

 

uParam29

lógico

Compatibilidade

 

 

uParam30

lógico

Compatibilidade

 

 

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.

 

 

cPlaceHold

caractere

Define o texto a ser utilizado como place holder, ou seja, o texto que ficará escrito em cor mais opaca quando nenhuma informação tiver sido digitada no campo. (disponível em builds superiores a 7.00.121227P)

 

 

Retorno

Nome

Tipo

Descrição

oObj

objeto

Nova instância da classe TGet

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.
  • 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

Exemplo 1
  cTGet2 := "Teste TGet 02"
  oTGet2 := TGet():Create( oDlg,{||cTGet2},14,01,096,009,"@!",,0,,,.F.,,.T.,,.F.,,.F.,.F.,,.F.,.F.,,cTGet2,,,, )
  • Sem rótulos