Construtor TGet:New
Método construtor da classe.
Sintaxe
TGet():New( [ 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 ], [ uParam30 ], [ cLabelText ], [ nLabelPos ], [ oLabelFont ], [ nLabelColor ], [ cPlaceHold ], [ lPicturePriority ] )
Parâmetros
Nome | Tipo | Descrição | Obrigatório | Referência |
---|---|---|---|---|
nCol | numeric | Indica a coordenada horizontal em pixels ou caracteres. | ||
bSetGet | codeblock | 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 | object | Indica a janela ou controle visual onde o objeto será criado. | ||
nWidth | numeric | Indica a largura em pixels do objeto. | ||
nHeight | numeric | Indica a altura em pixels do objeto. | ||
cPict | character | Indica a máscara de formatação do conteúdo que será apresentada. Verificar Tabela de Pictures de Formatação | ||
bValid | codeblock | 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 | numeric | Indica a cor do texto do objeto. | ||
nClrBack | numeric | Indica a cor de fundo do objeto. | ||
oFont | object | 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 | logical | Compatibilidade | ||
uParam13 | object | Compatibilidade | ||
lPixel | logical | Indica se considera as coordenadas passadas em pixels (.T.) ou caracteres (.F.). | ||
uParam15 | character | Compatibilidade | ||
uParam16 | logical | Compatibilidade | ||
bWhen | codeblock | 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 | logical | Compatibilidade | ||
uParam19 | logical | Compatibilidade | ||
bChange | codeblock | 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 | logical | Indica se o objeto pode ser editado. | ||
lPassword | logical | Indica se, verdadeiro (.T.), o objeto apresentará asterisco (*) para entrada de dados de senha; caso contrário, falso (.F.). | ||
uParam23 | character | Compatibilidade | ||
cReadVar | character | 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 | character | Compatibilidade | ||
uParam26 | character | Compatibilidade | ||
uParam27 | logical | Compatibilidade | ||
lHasButton | logical | Indica se, verdadeiro (.T.), o uso dos botões padrão, como calendário e calculadora. | ||
lNoButton | logical | Oculta o botão F3 (HasButton). | ||
uParam30 | logical | Compatibilidade | ||
cLabelText | character | indica o texto que será apresentado na Label. | ||
nLabelPos | numeric | Indica a posição da label, sendo 1=Topo e 2=Esquerda | ||
oLabelFont | object | Indica o objeto, do tipo TFont, que será utilizado para definir as características da fonte aplicada na exibição da label. | ||
nLabelColor | numeric | Indica a cor do texto da Label. | ||
cPlaceHold | character | 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 | logical | 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. |
Retorno
Nome | Tipo | Descrição |
---|---|---|
oObj | object | 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.
- A 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
cTGet1 := "Teste TGet 01" oTGet1 := TGet():New( 01,01,{||cTGet1},oDlg,096,009,"@!",,0,,,.F.,,.T.,,.F.,,.F.,.F.,,.F.,.F.,,cTGet1,,,, )