Show All

# ReturnMessage Property

Sets or retrieves a string value indicating the error message that will be returned if the data validation event is not successful.

expression.ReturnMessage

expression Required. Returns a reference to the DataDOMEvent object.

## 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.

## Remarks

Used in conjunction with the ReturnStatus property of the DataDOMEvent object, the ReturnMessage property displays a message box to the user with the specified text message.

## Example

In the following example, the ReturnMessage property of the DataDOMEvent object is used to display a message to the user if the data validation for the XML DOM node fails:

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

©2003-2004 Microsoft Corporation. All rights reserved. Permission to copy, display and distribute this document is available at: http://msdn.microsoft.com/library/en-us/odcXMLRef/html/odcXMLRefLegalNotice.asp