Histórico da Página

Composition Setup
import.css=/download/attachments/6062824/tecnologia.css

Pagetitle

	Construtor TGet:Create
	Construtor TGet:Create

...

Bloco de código

collapse	false

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

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)


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

Exemplos

Bloco de código

language	cpp
theme	Eclipse
linenumbers	true
collapse	false

  cTGet2 := "Teste TGet 02"
  oTGet2 := TGet():Create( oDlg,{|u|if(PCount()==0,cTGet2,cTGet2:=u)},14,01,096,009,"@!",,0,,,.F.,,.T.,,.F.,,.F.,.F.,,.F.,.F.,,cTGet2,,,, )

Árvore de páginas

Versões comparadas

Versão antiga 2

Nova versão Atual

Chave

Parâmetros

Retorno

Observações

Exemplos