Comparteix via


Esdeveniment Column OnChange (referència de l'API del client)

L'esdeveniment OnChange es produeix en les situacions següents:

  • Les dades d'una columna de formulari han canviat i s'ha perdut el focus. Hi ha una excepció a aquest comportament que s'aplica a les columnes Sí/No que estan formatades per utilitzar botons d'opció o caselles de selecció. En aquests casos l'esdeveniment es produeix immediatament.
  • Els canvis de dades al servidor es recuperen per actualitzar una columna quan s'actualitza el formulari, com ara després de desar un registre.
  • S'utilitza el mètode attribute.fireOnchange .

Totes les columnes admeten l'esdeveniment OnChange . Les dades de la columna es validen abans i després de l'esdeveniment OnChange .

L'esdeveniment OnChange no es produeix si la columna es canvia mitjançant programació mitjançant el mètode attribute.setValue . Si voleu que els controladors d'incidències de l'esdeveniment OnChange s'executin després de definir el valor, heu d'utilitzar el formContext.data.entity attribute. mètode fireOnchange al codi. L'esdeveniment OnChange tampoc es produeix si la columna es canvia programàticament quan es descarten els canvis si l'usuari s'allunya d'un formulari brut.

Nota

Tot i que la columna Estat admet l'esdeveniment, la columna és només de lectura al formulari, de manera que l'esdeveniment no es pot produir mitjançant laOnChange interacció de l'usuari. Un altre script podria fer que es produeixi aquest esdeveniment mitjançant el mètode fireOnchange a la columna.

Nota

OnChange Els esdeveniments són síncrons. No heu d'utilitzar codi asíncron en un OnChange controlador d'incidències que necessiti una acció per dur a terme o gestionar la resolució del codi asíncron. Això provoca problemes si el controlador de resolució espera que el context de l'aplicació continuï sent el mateix que quan es va iniciar el codi asíncron. Tampoc heu de fer sol·licituds de xarxa síncrones en un controlador d'incidències OnChange. Això pot fer que l'aplicació no respongui.

Mètodes admesos per a aquest esdeveniment

Hi ha tres mètodes que podeu utilitzar per treballar amb l'esdeveniment d'una OnChange columna:

Columnes (referència de l'API del client)
Esdeveniments (referència de l'API del client)
Esdeveniments en formularis i quadrícules en aplicacions basades en models