_XDocument3.Extension Property

Gets a reference to the global scripting object, which exposes the functions and global variables contained in a Microsoft InfoPath 2010 form's primary form code file.

Namespace:  Microsoft.Office.Interop.InfoPath.SemiTrust
Assembly:  Microsoft.Office.Interop.InfoPath.SemiTrust (in Microsoft.Office.Interop.InfoPath.SemiTrust.dll)

Syntax

'Declaration
ReadOnly Property Extension As Object
    Get
'Usage
Dim instance As _XDocument3
Dim value As Object

value = instance.Extension
Object Extension { get; }

Property Value

Type: System.Object

Implements

_XDocument2.Extension
_XDocument.Extension

Remarks

The Extension object facilitates using the functions and global variables implemented in an InfoPath form's scripting file. Usually, it is used from a custom task pane, from a custom dialog box, or in the XSL Transformation (XSLT) of a view where direct access to the functions and variables may be needed.

To use the Extension within a custom task pane, you must first set a reference to the XDocument object by using the Dynamic HTML (DHTML) external property of the DHTML window object, as shown in this example:

objXDocument = window.external.XDocument;

Important

This member 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.

Examples

In the following example, the Extension property is used through the ObjectWrapper interface to invoke the custom method called MyMethod. This is necessary when using the Extension property in managed code:

ObjectWrapper o = (ObjectWrapper)thisApplication.XDocuments[0].Extension;
 o.GetType().InvokeMember("MyMethod",
 BindingFlags.InvokeMethod |
 BindingFlags.DeclaredOnly | 
 BindingFlags.Public |  
 BindingFlags.Instance, null, o, null);

In the following example, a method called myCustomMethod of the InfoPath project class can be accessed from the custom task pane using the Extension property:

//Custom method added to the project
public string myCustomMethod()
{
return "Method value";
}

To access myCustomMethod from the custom task pane, use the DHTML external property of the DHTML window object:

objXDocument = window.external.XDocument;
myString = objXDocument.Extension.myCustomMethod();

See Also

Reference

_XDocument3 Interface

_XDocument3 Members

Extension Overload

Microsoft.Office.Interop.InfoPath.SemiTrust Namespace