Construtor TSimpleEditor:New
Método construtor da classe.
Sintaxe
TSimpleEditor():New( [ nRow ], [ nCol ], [ oWnd ], [ nWidth ], [ nHeight ], [ cText ], [ lReadOnly ], [ bSetGet ], [ oFont ], [ lPixel ], [ bWhen ], [ bValid ], [ cLabelText ], [ nLabelPos ], [ oLabelFont ], [ nLabelColor ], [ bChanged ] )
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. |
|
|
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. |
|
|
cText | caractere | Indica o texto que será apresentado na inicialização do objeto. |
|
|
lReadOnly | lógico | Indica se, verdadeiro (.T.), o texto não pode ser editado; caso contrário, falso (.F.). |
|
|
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. |
|
|
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. |
|
|
lPixel | lógico | Indica se considera as coordenadas passadas em pixels (.T.) ou caracteres (.F.). |
|
|
bWhen | bloco de código | Indica o bloco de código que será executado quando a mudança de foco da entrada de dados, na janela em que o controle foi criado, estiver sendo efetuada. Observação: O bloco de código retornará verdadeiro (.T.) se o controle permanecer habilitado; caso contrário, retornará falso (.F.). |
|
|
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.). |
|
|
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. |
|
|
bChanged | bloco de código | Indica o bloco de código que será disparado no método Load e no Recortar (CTRL+X) e Colar (CTRL+V). Parâmetro disponível em builds superiores à 131227A. |
|
|
Retorno
Nome | Tipo | Descrição |
---|---|---|
oObj | objeto | Nova instância da classe TSimpleEditor |
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. 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.
Exemplos
oEdit := TSimpleEditor():New( 0,0,oDlg,260,184 )