Writing Word Macros, Second Edition

The Pane Object

In Word, a window can be split into two panes. Each pane is represented by a Pane object. The panes for a given window are stored in the window’s Panes collection. The Panes property of the Window object returns this Panes collection.

Note that a document window can be split into at most two window panes. How-ever, if the view is not page layout view, the Panes collection can contain Pane objects for such things as comments or footnotes. I confine our discussion to splitting a window into two document panes.

To retrieve the active pane (the pane with the focus), use the ActivePane property of the Window object.

Creating New Panes

To split a window, use the Add method of the Panes collection, the Split property of the Window object, or the SplitVertical property of the Window object.

The Add method

This method adds a new pane to a window. Its syntax is:

	Panes.Add(SplitVertical)

where SplitVertical is the percentage of the window, measured from top to bottom, that should appear above the split. Note that this method will generate an error if the window has already been split.

The Split property

This Boolean property can be set to True to split a window, or it can be read to see if the window is already split.

The SplitVertical property

This Long property returns or sets the vertical split percentage for the specified window. To remote the split, set this property to 0, which is equivalent to setting the Split property to False.

Properties and Methods of the Pane Object

Many of ...