Share via

DataDOMEvent.Parent Property

  • Article
InfoPath Developer Reference

A read-only property that returns a reference to the XML Document Object Model (DOM) node of the parent of the XML DOM node being changed during a data validation event. Read-only

Version Information
 Version Added:  InfoPath 2003

Syntax

expression.Parent

expression   An expression that returns a DataDOMEvent object.

Return Value
[IXMLDOMNODE]

Remarks

After you have set a reference to the XML DOM node that the Parent property returns, you can use any of the properties and methods that are supported by the XML DOM. This can be especially useful during delete operations, because the Parent property maps to the location of the XML DOM node that was removed.

Bb250841.vs_note(en-us,office.12).gif  Note
To learn more about the XML DOM and all of the properties and methods that it supports, see the MSXML 5.0 SDK documentation in the Microsoft Script Editor (MSE) Help system.

Security Level 2: Can be accessed only by forms running in the same domain as the currently open form, or by forms that have been granted cross-domain permissions.

Example

In the following partial example, the Parent property of the DataDOMEvent object is used to check the name of the parent node; if it matches certain criteria, an error message is displayed:

JScript 
  function msoxd__shippingDates::OnBeforeChange(eventObj)
{
   var objOrderDate = new Date(XDocument.DOM.selectSingleNode
      ('/sampleData/shippingDates/orderDate')
      .text.replace(/(.*)-(.*)-(.*)/, "$2-$3-$1"));
   var objShipDate = new Date(XDocument.DOM.selectSingleNode
      ('/sampleData/shippingDates/shipDate')
      .text.replace(/(.*)-(.*)-(.*)/, "$2-$3-$1"));
   ...

if (objShipDate.toString() != "NaN" && objOrderDate.toString() == "NaN")
{
eventObj.ReturnMessage = "The Ship Date is invalid without an order date.";


  if (eventObj.<strong>Parent</strong>.nodeName == "orderDate")
     eventObj.ReturnMessage += "  You must delete the Ship Date " +
        "before deleting the Order Date.";

  eventObj.ReturnStatus = false;
  return;



}
...
}

See Also