Histórico da Página

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

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	Caracter	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	Caracter	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.).
lCenter	Lógico	Compatibilidade.
lRight	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	Caracter	Compatibilidade.
cReadVar	Caracter	Indica o nome da variável, configurada no parâmetro , que será manipulada pelo objeto. Além disso, esse parâmetro será o retorno da função ReadVar().
uParam25	Caracter	Compatibilidade.
uParam26	Caracter	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

oObjeto

()

Retorna o objeto criado.

Em versões superiores à 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.

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

New

Método construtor da classe.

TGet(): New ( [ nRow], [ 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], [cLabelText] ,[nLabelPos], [oLabelFont], [nLabelColor], [cPlaceHold] ) --> oObjeto

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.
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.
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.
cPict	Caracter	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 o conteúdo do objeto for modificado. Retorna verdadeiro (.T.), se o conteúdo é válido; caso contrário, falso (.F.).
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	Caracter	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	Caracter	Compatibilidade.
cReadVar	Caracter	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	Caracter	Compatibilidade.
uParam26	Caracter	Compatibilidade.
uParam27	Lógico	Compatibilidade.
lHasButton	Lógico	Indica se, verdadeiro (.T.), o uso dos botões padrão, como calendário e calculadora.
lNoButton	Lógico	Oculta o botão F3 (HasButton).
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

oObjeto

()

Retorna o objeto criado.

Em versões superiores à 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.

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

Métodos

CtrlRefresh

Força a atualização do objeto.

TGet(): CtrlRefresh ( ) -->

oTGet:CtrlRefresh()

SelectAll

Seleciona todo o conteúdo da Get.

TGet(): SelectAll ( ) -->

oTGet:SelectAll()

SetContentAlign

Inclusão de trecho

	Classe TGet - Construtores
	Classe TGet - Construtores
nopanel	true

Propriedades

Inclusão de trecho

	Classe TGet - Propriedades
	Classe TGet - Propriedades
nopanel	true

Métodos

Inclusão de trecho

	Classe TGet - Métodos
	Classe TGet - Métodos
nopanel	true

Observações

Em builds superiores a 7.00.111010P o idioma do calendário, chamado a partir do componente TGet, respeitará o idioma definido no arquivo de inicialização do AppServer, na tag rpolanguage.
Em builds superiores a 7.00.121227P, caso o TGet tenha botão (calculadora, calendário, etc.), o CSS deste botão pode ser passado para o TGet que ele irá repassar para o botão.

SetContentAlign

Alinha o conteúdo interno do objeto.

TGet(): SetContentAlign ( < nAlign> ) -->

Parâmetros

Nome	Tipo	Descrição	Obrigatório	Referência
nAlign	Numérico	Indica o tipo de alinhamento. Para informações dos tipos disponíveis, consulte a área Observações.	X

...

Valor	Descrição
-1	Alinha conteúdo à esquerda.
0	Centraliza conteúdo.
1	Alinha conteúdo à direita.

Importante
Método disponível para builds da TOTVS Tec superiores a "7.00.080806P - Oct 2 2008 - 11:47:14"

...

Veja Também

GetBuild

...

borderColor	#95B0CB
bgColor	#FFFFFF
borderWidth	1
borderStyle	solid

Definindo os tipos de dados (Caracter, Data, Numerico)

...

A definição dos tipos de dados no componente TGet é feito a partir de dois pontos:

...

Definição do tipo de variável;

...

Definição do parametro lHasButton como Verdadeiro (.T.).

Veja o exemplo a seguir:

Exemplocodetrue

Bloco de código

language

cpp
theme	Eclipse

language

cpp

linenumbers

false
collapse	false

  #include "TOTVS.CH"

  User Function TGetTypes()
    Local cGet1 := "Define variable value" // Variavel do tipo caracter
    Local nGet2 := 0 // Variável do tipo numérica
    Local dGet3 := Date() // Variável do tipo Data
    Local lHasButton := .T.

    DEFINE MSDIALOG oDlg TITLE "Picture test" FROM 000, 000  TO 500, 500 COLORS 0, 16777215 PIXEL

    oGet1 := TGet():New( 005, 009, { | u | If( PCount() == 0, cGet1, cGet1 := u ) },oDlg, ;

  060, 010, "!@",, 0, 16777215,,.F.,,.T.,,.F.,,.F.,.F.,,.F.,.F. ,,"cGet1",,,,lHasButton  )

    oGet2 := TGet():New( 020, 009, { | u | If( PCount() == 0, nGet2, nGet2 := u ) },oDlg, ;

060, 010, "@E 999.99",, 0, 16777215,,.F.,,.T.,,.F.,,.F.,.F.,,.F.,.F. ,,"nGet2",,,,lHasButton  )

oGet3 := TGet():New( 035, 009, { | u | If( PCount() == 0, dGet3, dGet3 := u ) },oDlg, ;

  060, 010, "@D",, 0, 16777215,,.F.,,.T.,,.F.,,.F.,.F.,,.F.,.F. ,,"dGet3",,,,lHasButton  )


    ACTIVATE MSDIALOG oDlg CENTERED

  return

Preview - TGet com diferentes tipos de dados

Image Modified

...

Exemplos

PropriedadeDescriçãoTipo

Em builds superiores a 7.00.111010P o idioma do calendário, chamado a partir do componente TGet, respeitará o idioma definido no arquivo de inicialização do AppServer, na tag rpolanguage.

Em builds superiores a 7.00.121227P, caso o TGet tenha botão (calculadora, calendário, etc.), o CSS deste botão pode ser passado para o TGet que ele irá repassar para o botão.