Histórico da Página
...
Bloco de código | ||
---|---|---|
| ||
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 | 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 | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
cTGet2 := "Teste TGet 02" oTGet2 := TGet():Create( oDlg,{||cTGet2},14,01,096,009,"@!",,0,,,.F.,,.T.,,.F.,,.F.,.F.,,.F.,.F.,,cTGet2,,,, ) |