1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39
|
<html dir="ltr"><head>
<META http-equiv="Content-Type" content="text/html; charset=UTF-8">
<META HTTP-EQUIV="assetid" CONTENT="HV01021312"><META NAME="lcid" CONTENT="1033"><title>NewValue Property</title><link rel="stylesheet" type="text/css" href="office10.css"><script type="text/javascript" language="Javascript" src="ExpCollapse.js"></script><script type="text/javascript" language="JavaScript" src="inline.js"></script></head><body><p id="ExpandAllLine" class="ExpFav"><a href="#" onclick="ExpandAll()" onkeypress="ExpandAll()" class="DropDown"><img id="picHeader" border="0" src="expandtri.gif" alt="Show All"><span id="ExpandAll">Show All</span></a></p><h1>NewValue Property</h1><DIV class="ofvbanav"><span class="ofvbanavreuse" id="seealso" onclick="toggleList()" onkeypress="toggleList()"></span><span class="ofvbanavreuse" id="appliesto" onclick="toggleList()" onkeypress="toggleList()"></span><a class="ofvbanavex" href="#example"><span class="ofvbanavreuse" id="example"></span></a><span class="ofvbanavreuse" id="specifics" onclick="toggleList()" onkeypress="toggleList()"></span></DIV><p>
<p>A read-only property that returns a string value indicating the value of an XML <a href="#" class="glossary" onclick="AppendPopup(this,'ofdocumentobjectmodeldom')" onkeypress="AppendPopup(this,'ofdocumentobjectmodeldom')">Document Object Model (DOM)</a> node that is being updated or inserted during a <a href="#" class="glossary" onclick="AppendPopup(this,'xddatavalidation')" onkeypress="AppendPopup(this,'xddatavalidation')">data validation</a> event.</p>
<p class="signature"><i>expression</i>.<b class="bterm">NewValue</b></p>
<p><i>expression </i> Required. Returns a reference to the <b class="bterm"><a href="xdobjDataDOMEvent.htm" id="HV01021239" lcid=" ">DataDOMEvent</a></b> object.</p>
</p><h2>Security Level</h2><p>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.</p><h2>Remarks</h2><p>
<p>The <b class="bterm">NewValue</b> property contains the value of the XML DOM node that will replace the existing value. To get the original value of the XML DOM node, use the <b class="bterm"><a href="xdproOldValue.htm" id="HV01021314" lcid=" ">OldValue</a></b> property of the <b class="bterm">DataDOMEvent</b> object.</p>
</p><h2><a id="#example" name="#example">Example</a></h2><p>
<p>In the following example from the ADO (ActiveX Data Objects) developer sample form, the <b class="bterm">NewValue</b> property of the <b class="bterm">DataDOMEvent</b> object is used to determine whether the new value of the XML DOM node is an empty string. If it is not, the code sets other fields to be empty strings.</p>
<pre><code>function msoxd__Employees_EmployeeID_attr::OnAfterChange(eventObj)
{
if (eventObj.IsUndoRedo)
{
// An undo or redo operation has occurred and the DOM is read-only.
return;
}
if (eventObj.<b class="bterm">NewValue</b> == "")
return;
if (XDocument.DOM.selectSingleNode
('/dfs:myFields/dfs:queryFields/q:Employees/@FirstName').text != "")
XDocument.DOM.selectSingleNode
('/dfs:myFields/dfs:queryFields/q:Employees/@FirstName').text = "";
if (XDocument.DOM.selectSingleNode
('/dfs:myFields/dfs:queryFields/q:Employees/@LastName').text != "")
XDocument.DOM.selectSingleNode
('/dfs:myFields/dfs:queryFields/q:Employees/@LastName').text = "";
}</code></pre>
</p><script type="text/javascript" language="JScript" src="ofvbanl.js"></script><span id="ofVBAISpan" class="ofvbaispan"><iframe id="ofVBAIFrame" frameborder="0" marginheight="0" marginwidth="4" scrolling="auto" width="100%" src="../links/xdproNewValue_l.htm"></iframe></span><center><a href="XMLSchemaCopyright_HV01147162.htm">©2003-2004 Microsoft Corporation. All rights reserved.</a>
Permission to copy, display and distribute this document is available at: <a
href="http://r.office.microsoft.com/r/rlidAWSContentRedir?AssetID=XT010988631033&CTT=11&Origin=HV011232471033"
target="_new">http://msdn.microsoft.com/library/en-us/odcXMLRef/html/odcXMLRefLegalNotice.asp</a></center></body></html>
|