XmlForm.GetWorkflowTasks Method

  • Article

Gets a reference to a Microsoft.Office.Core.WorkflowTasks collection for the current form.

Namespace: Microsoft.Office.InfoPath
Assembly: Microsoft.Office.InfoPath (in microsoft.office.infopath.dll)

Syntax

'Declaration
'Usage

Return Value

A Microsoft.Office.Core.WorkflowTasks collection that contains any Microsoft.Office.Core.WorkflowTask objects for the current form.

Remarks

Important

For the GetWorkFlowTasks method to work, you must establish a reference to the Microsoft Office 12.0 Object Library (from the COM tab of the Add Reference dialog box in Microsoft Visual Studio Tools for Applications (VSTA) or Visual Studio). This will establish a reference to the Microsoft.Office.Core namespace, which contains the WorkflowTasks class.

This member can be accessed only by forms opened from a form template that as been configured to run with full trust using the Security and Trust category of the Form Options dialog box. This member requires full trust for the immediate caller and cannot be used by partially trusted code. For more information, see "Using Libraries from Partially Trusted Code" on MSDN.

This type or member can be accessed only from code running in forms opened in Microsoft Office InfoPath 2007.

Example

In the following example, clicking the Button control displays the count of workflow tasks associated with the current form.

This example requires a using or Imports directive for the Microsoft.Office.Core namespace in the declarations section of the form code module.

public void CTRL1_Clicked(object sender, ClickedEventArgs e)
{
   WorkflowTasks myWorkflowTasks = 
      (WorkflowTasks)this.GetWorkflowTasks();

   int workflowTasksCount = myWorkflowTasks.Count;

   MessageBox.Show("Get " + workflowTasksCount.ToString() + " 
      workflow tasks.");
}

Public Sub CTRL1_Clicked(ByVal sender As Object, _
   ByVal e As ClickedEventArgs)
   Dim myWorkflowTasks As WorkflowTasks = _
      DirectCast(Me.GetWorkflowTasks(), WorkflowTasks)

   Dim workflowTasksCount As Integer = myWorkflowTasks.Count

   MessageBox.Show("Get " & workflowTasksCount.ToString() & " _
      workflow tasks.")
End Sub

See Also

Reference

XmlForm Class
XmlForm Members
Microsoft.Office.InfoPath Namespace