Árvore de páginas

Construtor TGet:New

Método construtor da classe.

Sintaxe

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

Parâmetros

Nome

Tipo

Descrição

Obrigatório

Referência

nCol

numeric

Indica a coordenada horizontal em pixels ou caracteres.



bSetGet

codeblock

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.



oWnd

object

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



nWidth

numeric

Indica a largura em pixels do objeto.



nHeight

numeric

Indica a altura em pixels do objeto.



cPict

character

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



bValid

codeblock

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



nClrFore

numeric

Indica a cor do texto do objeto.



nClrBack

numeric

Indica a cor de fundo do objeto.



oFont

object

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

logical

Compatibilidade



uParam13

object

Compatibilidade



lPixel

logical

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



uParam15

character

Compatibilidade



uParam16

logical

Compatibilidade



bWhen

codeblock

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

logical

Compatibilidade



uParam19

logical

Compatibilidade



bChange

codeblock

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

logical

Indica se o objeto pode ser editado.



lPassword

logical

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



uParam23

character

Compatibilidade



cReadVar

character

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

character

Compatibilidade



uParam26

character

Compatibilidade



uParam27

logical

Compatibilidade



lHasButton

logical

Indica se, verdadeiro (.T.), o uso dos botões padrão, como calendário e calculadora.



lNoButton

logical

Oculta o botão F3 (HasButton).



uParam30

logical

Compatibilidade



cLabelText

character

indica o texto que será apresentado na Label.



nLabelPos

numeric

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



oLabelFont

object

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



nLabelColor

numeric

Indica a cor do texto da Label.



cPlaceHold

character

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)



lPicturePriority

logical

Quando .T. define que a quantidade de caracteres permitidos no TGet será baseada no tamanho da máscara (Picture) definida, mesmo que isto exceda a quantidade de caracteres definida na variável bSetGet, até mesmo se ela for vazia (essa variável deve ser do tipo caracter). Além disso este parâmetro ativa o controle dos espaços em branco, não incluindo na variável bSetGet os espaços inseridos automaticamente pela Picture. Ou seja, o TGet retornará somente os espaços em branco efetivamente digitados pelo usuário ou aqueles espaços que já foram inicializados na variável bSetGet. Disponível somente a partir da build 7.00.170117A.



Retorno

Nome

Tipo

Descrição

oObj

object

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.
  • A criação automática do label através dos parâmetros desse método não funciona se o componente estiver posicionado em algum layout (como o TGridLayout), neste caso é necessário criar o label utilizando o componente TSay.

Exemplos

  cTGet1 := "Teste TGet 01"
  oTGet1 := TGet():New( 01,01,{||cTGet1},oDlg,096,009,"@!",,0,,,.F.,,.T.,,.F.,,.F.,.F.,,.F.,.F.,,cTGet1,,,, )
  • Sem rótulos