ReturnStatus-egenskapen (DataDOMEvent-objektet)

Microsoft Office InfoPath

Angir eller henter en boolsk verdi som viser returstatusen for datavalideringshendelsen.

expression.ReturnStatus

expression    Obligatorisk. Returnerer en referanse til DataDOMEvent-objektet.

Sikkerhetsnivå

2: Kan åpnes bare av skjemaer som kjører på samme domene som skjemaet som i øyeblikket er åpent, eller av skjemaer som har fått tillatelser på tvers av domener.

Merknader

Hvis ReturnStatus-egenskapen er satt til False, forkastes endringene i XML DOM-noden (Document Object Model), og datavalideringshendelsen mislykkes. Hvis egenskapen er satt til True, har det ikke oppstått noen datavalideringsfeil, og datavalideringshendelsen er vellykket.

Eksempel

I eksemplet nedenfor brukes ReturnStatus-egenskapen for DataDOMEvent-objektet til å angi at datavalideringshendelsen mislyktes. Koden bruker også ReturnMessage-egenskapen for DataDOMEvent-objektet til å vise en melding for brukeren.

function msoxd__id_attr::OnBeforeChange(eventObj)
{
   if (eventObj.NewValue == "")
   {
      eventObj.ReturnMessage = "You must supply a value for this field.";
      eventObj.ReturnStatus = false;
      return;
   }
}