DataDOMEvent-objektet
Et hendelsesobjekt som brukes under datavalideringshendelser i Microsoft Office InfoPath 2003. DataDOMEvent-objektet inneholder en rekke egenskaper og en metode som kan brukes programmatisk i en datavalideringshendelse til å fungere interaktivt med dataene som valideres, og til å gi et svar hvis dataene ikke er gyldige.
Merknader
DataDOMEvent-objektet overføres som en parameter til OnBeforeChange-, OnValidate- og OnAfterChange-hendelsen.
Obs! OnValidate-hendelsen kan inntreffe uten at skjemaets underliggende XML-dokument endres.
DataDOMEvent-objektet brukes til å hente informasjon om XML DOM-noden (Document Object Model) som endres, og det inneholder også en egenskap for henting av referanse til et skjemas underliggende XML-dokument. Det inneholder i tillegg egenskaper for håndtering av dataendringer, inkludert forkasting av endringer og opprettelse av feilmelding.
Obs! DataDOMEvent-objektet overføres som et argument til en hendelsesbehandling for datavalidering. Egenskapene og metoden for objektet er bare tilgjengelige under hendelsen det overføres til.
Bruke DataDOMEvent-objektet
I eksemplet fra eksempelskjemaet Data Validation nedenfor brukes DataDOMEvent-objektet til å kontrollere verdien til noden som bruker Site-egenskapen. Hvis datavalideringen mislykkes, brukes ReportError-metoden til å opprette en egendefinert feil.
function msoxd__itemB_quantityListB::OnValidate(eventObj)
{
if (parseInt(eventObj.Site.nodeTypedValue, 10) > 50)
eventObj.ReportError(eventObj.Site, "Invalid quantity. " +
"The total number of each type of block cannot exceed 50.", false);
if (parseInt(eventObj.Site.nodeTypedValue, 10) < 0)
eventObj.ReportError(eventObj.Site, "Invalid quantity. " +
"The total number of each type of block cannot be less than 0.", false);
}
Hvis du vil ha mer informasjon om bruk av DataDOMEvent-objektet, se Reagere på skjemahendelser.