Facilite a vida dos seus programadores com as caixas de lista
Janeiro 31, 2020
3 Tempo de leitura
O nosso principal objetivo é facilitar a vida dos programadores, dia após dia, e as caixas de lista são um dos objetos de formulário mais utilizados e poderosos do 4D que servem este propósito. Todos sabemos que as caixas de lista desencadeiam muitos eventos; por isso, na versão 4D v18 R2, melhorámos o Form event para que este retorne ainda mais informações quando os eventos das caixas de lista são acionados.
Quer livrar-se do seu código antigo e complicado para adivinhar em que linha, coluna ou cabeçalho clicou ou colocou o rato? Deixe-nos mostrar-lhe uma forma mais simples e inteligente de o fazer!
HDI: Exemplos para trabalhar facilmente com eventos de caixas de lista
Dependendo do evento, propriedades adicionais relevantes são agora devolvidas pelo Form event comando.
Vamos ver alguns exemplos.
No evento de clique no cabeçalho
O nome do objeto cabeçalho, o nome do objeto coluna e o número da coluna são agora devolvidos pelo Form event .
Aqui está um exemplo do objeto devolvido quando um evento On Header Click é acionado/
{"headerName":"headerLastname", // New property - Header object name
"columnName":"lastname", // New property - Column object name
"column":2, // New property - Column number
"code":42,
"description":"On Header Click",
"objectName":"EmployeesLB"}
Por exemplo, se definir o nome de um objeto de coluna com um nome de atributo real de uma classe de dados (por exemplo, lastname):
Ao clicar no cabeçalho da coluna que exibe o apelido dos funcionários, ordenamos a coluna pelos atributos lastname e firstname :
Form.event:=FORM Event
Case of
: (Form event code=On Header Click)
if (Form.event.columnName="lastname")
Form.employees:=Form.employees.orderBy(Form.event.columnName+", firstname")
End if
End case No evento DISPLAY DETAILS
Quando o evento On Display Details é acionado, propriedades adicionais relevantes (por exemplo, isRowSelected) são agora devolvidas pelo Form event comando. Isto pode ser útil para gerir a aparência das linhas de uma caixa de lista.
Segue-se um exemplo de um método (setColor) definido na propriedade de expressão Meta info de uma caixa de lista:
O método setColor:
C_OBJECT($event;$0;$meta)
$event:=FORM Event
$meta:=New object
Case of
: ($event.code=On Display Detail)
If ($event.isRowSelected) //set color when row is selected
$meta.fill:="lightblue"
End if
End case
$0:=$metaE eis como fica a caixa de lista quando as linhas são selecionadas:
Evento On Mouse Move
Outro evento frequentemente utilizado é o evento On Mouse Move. Abaixo estão exemplos de objetos devolvidos pelo Form event comando quando este é acionado.
Obtém imediatamente propriedades úteis para localizar onde colocou o rato!
O rato passa por cima de um cabeçalho
Form event o comando devolve:
{"area":"header", // The mouse is on a header
"areaName":"headerLastname", // Header object name
"column":2, // Column number
"columnName":"lastname", // Colmun object name
"code":37,
"description":"On Mouse Move",
"objectName":"EmployeesLB"}
O mouse passa sobre uma célula
Form event o comando devolve:
{"area":"cell", // The mouse is on a cell
"column":1, // Column number
"row":2, // Row number
"columnName":"firstname", // Colmun object name
"code":37,
"description":"On Mouse Move",
"objectName":"EmployeesLB"}Existem tantos eventos de caixas de lista que uma única publicação no blogue não é suficiente para os cobrir todos, por isso não deixe de consultar a documentação para encontrar informações detalhadas sobre cada evento e descarregue o HDI para saber mais!
De momento, não é possível deixar comentários nesta publicação.