Construtor TGet:Create
Método construtor da classe.
Sintaxe
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 ] )
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) |
|
|
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.
Exemplos
cTGet2 := "Teste TGet 02" oTGet2 := TGet():Create( oDlg,{||cTGet2},14,01,096,009,"@!",,0,,,.F.,,.T.,,.F.,,.F.,.F.,,.F.,.F.,,cTGet2,,,, )