Árvore de páginas

Carregando...

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

Bloco de código
collapsefalse
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 ], [ lPicturePriority ], [ lFocSel ] )

Parâmetros

oWnd

Nome

Tipo

Descrição

Obrigatório

Referência

objeto

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

 

 

bSetGet

codeblock

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ériconumeric

Indica a coordenada vertical em pixels ou caracteres. 

 



nCol

numériconumeric

Indica a coordenada horizontal em pixels ou caracteres.

 

 



nWidth

numériconumeric

Indica a largura em pixels do objeto.

 

 



nHeight

numériconumeric

Indica a altura em pixels do objeto.

 

 



cPict

caracterecharacter

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

 

 



bValid

bloco de códigocodeblock

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ériconumeric

Indica a cor do texto do objeto.

 

 



nClrBack

numériconumeric

Indica a cor de fundo do objeto.

 

 



oFont

objetoobject

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ógicological

Compatibilidade

 

 



uParam13

objetoobject

Compatibilidade

 

 



lPixel

lógicological

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

 

 



uParam15

caracterecharacter

Compatibilidade

 

 



uParam16

lógicological

Compatibilidade

 

 



bWhen

bloco de códigocodeblock

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ógicological

Compatibilidade

 

 



uParam19

lógicological

Compatibilidade

 

 



bChange

bloco de códigocodeblock

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ógicological

Indica se o objeto pode ser editado.

 

 



lPassword

lógicological

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

 



uParam23

caracterecharacter

Compatibilidade

 

 



cReadVar

caracterecharacter

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

caracterecharacter

Compatibilidade 

 



uParam26

caracterecharacter

Compatibilidade

 

 



uParam27

lógicological

Compatibilidade 

 



lHasButton

lógicological

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

 

 



uParam29

lógicological

Compatibilidade 

 



uParam30

lógicological

Compatibilidade

 

 



cLabelText

caracterecharacter

indica o texto que será apresentado na Label.

 

 



nLabelPos

numériconumeric

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

 

 



oLabelFont

objetoobject

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

 

 



nLabelColor

numériconumeric

Indica a cor do texto da Label. 

 



cPlaceHold

caracterecharacter

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

lógicological

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.

 

 

lFocSel

lógico

Define se seleciona o texto (.T.) ou não (.F.) quando o TGet recebe o foco.

 

 



Retorno

Nome

Tipo

Descrição

oObj

objetoobject

Nova instância da classe TGet

...

  • 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.O parâmetro lFocSel
  • está disponível em build superior a versão 17.2.1.3A 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

Bloco de código
languagecpp
themeEclipse
linenumberstrue
collapsefalse
  cTGet2 := "Teste TGet 02"
  oTGet2 := TGet():Create( oDlg,{||cTGet2},14,01,096,009,"@!",,0,,,.F.,,.T.,,.F.,,.F.,.F.,,.F.,.F.,,cTGet2,,,, )