_XDocument4.Extension Propriedade

Definição

Namespace:

Microsoft.Office.Interop.InfoPath

Assembly:

Microsoft.Office.Interop.InfoPath.dll

Obtém uma referência ao objeto de script global, que expõe as funções e variáveis globais contidas no arquivo de código de formulário primário de um formulário do Microsoft InfoPath.

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

public object Extension { get; }

member this.Extension : obj

Public ReadOnly Property Extension As Object

Valor da propriedade

Object

Retorna Object.

Implementações

Extension

Exemplos

No exemplo a seguir, a propriedade Extension é usada por meio da Microsoft.Office.Interop.InfoPath.ObjectWrapper interface para invocar o método personalizado chamado MyMethod. Isso é necessário ao usar a propriedade Extension no código gerenciado:

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);

No exemplo a seguir, um método chamado myCustomMethod da classe de projeto InfoPath pode ser acessado no painel de tarefas personalizado usando a propriedade Extension :

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

Para acessar myCustomMethod no painel de tarefas personalizado, use a propriedade externa DHTML do objeto da janela DHTML:

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

No exemplo a seguir, a propriedade Extension é usada por meio da Microsoft.Office.Interop.InfoPath.ObjectWrapper interface para invocar o método personalizado chamado MyMethod. Isso é necessário ao usar a propriedade Extension no código gerenciado:

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);

No exemplo a seguir, um método chamado myCustomMethod da classe de projeto InfoPath pode ser acessado no painel de tarefas personalizado usando a propriedade Extension :

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

Para acessar myCustomMethod no painel de tarefas personalizado, use a propriedade externa DHTML do objeto da janela DHTML:

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

Comentários

O objeto Extension facilita o uso das funções e variáveis globais implementadas no arquivo de script de um formulário InfoPath. Normalmente, ele é usado de um painel de tarefas personalizado, de uma caixa de diálogo personalizada ou na XSL Transformation (XSLT) de uma exibição em que o acesso direto às funções e variáveis pode ser necessário.

Para usar o objeto Extension em um painel de tarefas personalizado, primeiro você deve definir uma referência ao objeto XDocument usando a propriedade externa DHTML (Dynamic HTML) do objeto de janela DHTML, conforme mostrado neste exemplo:

objXDocument = window.external.XDocument;