Vis alt

DataDOMEvent-objektet

DataDOMEvent

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.