Window Object

  • Article
InfoPath Developer Reference

Represents a window that is used in the Microsoft Office InfoPath 2007 application.

Version Information
 Version Added:  InfoPath 2003

Remarks

Window objects represent the two types of windows that are used in the InfoPath application: the editing window that is used as the form area when a user fills out a form, and the designing window that is used as the design mode when a user designs a form.

The Window object provides a number of properties and methods that can be used to programmatically interact with InfoPath windows, including the ability to activate or close a window and the ability to interact with the task panes and command bars that they contain. The Window object also provides a property for accessing the form's underlying XML document that is associated with the window.

Bb229878.vs_note(en-us,office.12).gif  Note
Some properties of the Window object are only available when using the editing window type; they will return an error if used with the designing window type.

The Window objects of an InfoPath form are accessed through the Item property of the Windows collection. The type of window can be determined by the Type property of the Window object.

You can access the currently open window directly by using the ActiveWindow property of the Application object, without going through the Windows collection. You can also access the Window object that is associated with a view by using the Window property of the View object.

For more information about using the Window object, see Working with form windows.

Example

In the following example, implemented as an OnClick event handler for a button control, the ActiveWindow property is used to set a reference to the current window. Then the code checks the window type; if it is the editing window type, it displays the number of task panes contained in the window in a message box.

JScript 
  function WindowObject::OnClick(eventObj)
{

var objWindow;


// Set a reference to the current window.
objWindow = Application.ActiveWindow;


// Check that the window is an editing window type.
if (objWindow.Type == 0)
{
// Display the number of task panes in the window.
XDocument.UI.Alert("Number of task panes: " +
objWindow.TaskPanes.Count);
}


objWindow = null;
}

See Also