_XDocument3.Extension Propriété

Définition

Espace de noms:

Microsoft.Office.Interop.InfoPath.SemiTrust

Assembly:

Microsoft.Office.Interop.InfoPath.SemiTrust.dll

Obtient une référence à l’objet de script global, qui expose les fonctions et les variables globales contenues dans le fichier de code de formulaire principal d’un formulaire Microsoft InfoPath.

public:
 property System::Object ^ Extension { System::Object ^ get(); };

public object Extension { get; }

member this.Extension : obj

Public ReadOnly Property Extension As Object

Valeur de propriété

Object

Implémente

Extension

Exemples

Dans l’exemple suivant, la propriété Extension est utilisée via l’interface ObjectWrapper pour appeler la méthode personnalisée appelée MyMethod. Cela s'avère nécessaire lorsque vous utilisez la propriété Extension dans du code managé :

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

Dans l’exemple suivant, une méthode appelée myCustomMethod de la classe de projet InfoPath est accessible à partir du volet Office personnalisé à l’aide de la propriété Extension :

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

Pour accéder à myCustomMethod partir du volet Office personnalisé, utilisez la propriété externe DHTML de l’objet de fenêtre DHTML :

objXDocument = window.external.XDocument;
myString = objXDocument.<span class="label">Extension</span>.myCustomMethod();

Dans l’exemple suivant, la propriété Extension est utilisée via l’interface ObjectWrapper pour appeler la méthode personnalisée appelée MyMethod. Cela s'avère nécessaire lorsque vous utilisez la propriété Extension dans du code managé :

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

Dans l’exemple suivant, une méthode appelée myCustomMethod de la classe de projet InfoPath est accessible à partir du volet Office personnalisé à l’aide de la propriété Extension :

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

Pour accéder à myCustomMethod partir du volet Office personnalisé, utilisez la propriété externe DHTML de l’objet de fenêtre DHTML :

objXDocument = window.external.XDocument;
myString = objXDocument.<span class="label">Extension</span>.myCustomMethod();

Remarques

L'objet Extension facilite l'utilisation des fonctions et des variables globales implémentées dans le fichier de script d'un formulaire InfoPath. Généralement, il est utilisé à partir d'un volet Office personnalisé, à partir d'une boîte de dialogue personnalisée ou dans la transformation XSL (XSLT) d'une vue où l'accès direct aux fonctions et aux variables risque d'être nécessaire.

Pour utiliser la propriété Extension dans un volet Office personnalisé, vous devez d'abord définir une référence à l'objet XDocument à l'aide de la propriété external DHTML de l'objet Window DHTML, comme l'illustre l'exemple suivant :

objXDocument = window.external.XDocument;

Important : ce membre est accessible uniquement par les formulaires s’exécutant dans le même domaine que le formulaire actuellement ouvert, ou par les formulaires auxquels des autorisations inter-domaines ont été accordées.