File: xdproExtension.htm

package info (click to toggle)
office2003-schemas 1.0%2Bds-1
  • links: PTS, VCS
  • area: non-free
  • in suites: bookworm, forky, sid, trixie
  • size: 42,304 kB
  • sloc: javascript: 2,429; makefile: 29
file content (20 lines) | stat: -rw-r--r-- 4,422 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
<html dir="ltr"><head>
<META http-equiv="Content-Type" content="text/html; charset=UTF-8">
<META HTTP-EQUIV="assetid" CONTENT="HV01021284"><META NAME="lcid" CONTENT="1033"><title>Extension 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>Extension 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 reference to the global scripting object, which exposes the functions and global variables contained in a Microsoft Office InfoPath 2003  form's primary scripting file.</p>
      
        <p class="signature"><i>expression</i>.<b class="bterm">Extension</b></p>
      <p><i>expression   </i> Required. An expression that returns a reference to an <b class="bterm"><a href="xdobjXDocument.htm" id="HV01021254" lcid=" ">XDocument</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">Extension</b> property facilitates using the functions and global variables implemented in an InfoPath form's scripting file. Usually, it is used from a <a href="#" class="glossary" onclick="AppendPopup(this,'xdcustomtaskpane')" onkeypress="AppendPopup(this,'xdcustomtaskpane')">custom task pane</a>, from a custom dialog box, or in the <a href="#" class="glossary" onclick="AppendPopup(this,'xdxsltransformationxslt')" onkeypress="AppendPopup(this,'xdxsltransformationxslt')">XSL Transformation (XSLT)</a> of a view where direct access to the functions and variables may be needed.</p><p>For example, if you were to declare a global variable in your scripting file such as the following,<pre><code>var constCity = "Redmond";</code></pre></p><p>You could access that value in the code of your custom task pane or dialog box by using the <b class="bterm">Extension</b> property, as shown here:</p>
    <pre><code>XDocument.<b class="bterm">Extension</b>.constCity;</code></pre></p><p>To use the <b class="bterm">Extension</b> property within a custom task pane, you must first set a reference to the <b class="bterm">XDocument</b> object by using the <a href="#" class="glossary" onclick="AppendPopup(this,'IDH_ofdefDynamicHTML')" onkeypress="AppendPopup(this,'IDH_ofdefDynamicHTML')">Dynamic HTML (DHTML)</a><b class="bterm"> external</b> property of the DHTML <b class="bterm">window</b> object, as shown in this example:</p><pre><code>objXDocument = window.external.XDocument;</code></pre><h2><a id="#example" name="#example">Example</a></h2><p>
      <p>In the following example, the <b class="bterm">Extension</b> property of the <b class="bterm">XDocument</b> object is used to access a custom function:</p>
      <pre><code>objXDocument = window.external.XDocument;
objXDocument.<b class="bterm">Extension</b>.MyCustomFunction();</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/xdproExtension_l.htm"></iframe></span><center><a href="XMLSchemaCopyright_HV01147162.htm">&copy;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&amp;CTT=11&amp;Origin=HV011232471033" 

target="_new">http://msdn.microsoft.com/library/en-us/odcXMLRef/html/odcXMLRefLegalNotice.asp</a></center></body></html>