Window Interface

Definition

Namespace:

Microsoft.Office.Interop.Excel

Assembly:

Microsoft.Office.Interop.Excel.dll

Represents a window. Many worksheet characteristics, such as scroll bars and gridlines, are actually properties of the window.

public interface class Window

[System.Runtime.InteropServices.Guid("00020893-0000-0000-C000-000000000046")]
[System.Runtime.InteropServices.InterfaceType(2)]
public interface Window

Public Interface Window

Attributes

GuidAttribute InterfaceTypeAttribute

Remarks

The Window object is a member of the Windows collection. The Windows collection returned by the Windows property of the Application object contains all the windows in the application, whereas the Windows collection returned by the Windows property of the Workbook object contains only the windows in the specified workbook.

Use Windows(index), where index is the window name or index number, to return a single Window object.

Note that the active window is always Windows(1).

The window caption is the text shown in the title bar at the top of the window when the window isn’t maximized. The caption is also shown in the list of open files on the bottom of the Windows menu. Use the Caption property to set or return the window caption. Changing the window caption doesn’t change the name of the workbook.

Properties

_DisplayRightToLeft	Reserved for internal use.
ActiveCell	Returns a Range object that represents the active cell in the active window (the window on top) or in the specified window. If the window isn't displaying a worksheet, this property fails.
ActiveChart	Returns a Chart object that represents the active chart (either an embedded chart or a chart sheet). An embedded chart is considered active when it's either selected or activated. When no chart is active, this property returns Nothing.
ActivePane	Returns a Pane object that represents the active pane in the window.
ActiveSheet	Returns an object that represents the active sheet (the sheet on top) in the active workbook or in the specified window or workbook. Returns Nothing if no sheet is active.
ActiveSheetView	Returns an object that represents the view of the active sheet in the specified window. Read-only.
Application	Returns an Application object that represents the Excel application.
AutoFilterDateGrouping	True if the auto filter for date grouping is currently displayed in the specified window. Read/write.
Caption	The name that appears in the title bar of the document window.
Creator	Returns a 32-bit integer that indicates the application in which this object was created.
DisplayFormulas	True if the window is displaying formulas; False if the window is displaying values.
DisplayGridlines	True if gridlines are displayed.
DisplayHeadings	True if both row and column headings are displayed; False if there are no headings displayed.
DisplayHorizontalScrollBar	True if the horizontal scroll bar is displayed.
DisplayOutline	True if outline symbols are displayed.
DisplayRightToLeft	True if the specified window is displayed from right to left instead of from left to right. False if the object is displayed from left to right.
DisplayRuler	True if a ruler is displayed for the specified window. Read/write.
DisplayVerticalScrollBar	True if the vertical scroll bar is displayed.
DisplayWhitespace	True if whitespace is displayed. Read/write.
DisplayWorkbookTabs	True if the workbook tabs are displayed.
DisplayZeros	True if zero values are displayed.
EnableResize	True if the window can be resized.
FreezePanes	True if split panes are frozen.
GridlineColor	Returns or sets the gridline color as an RGB value.
GridlineColorIndex	Returns or sets the gridline color as an index into the current color palette or as an XlColorIndex constant.
Height	The height of the window in points.
Hwnd	Returns the window handle of the specified window.
Index	Returns the index number of the object within the collection of similar objects.
Left	The distance in points from the left edge of the client area to the left edge of the window.
OnWindow	Returns or sets the name of the procedure that’s run whenever you activate a window.
Panes	Returns a Panes collection that represents all the panes in the specified window.
Parent	Returns the parent object for the specified object.
RangeSelection	Returns a Range object that represents the selected cells on the worksheet in the specified window even if a graphic object is active or selected on the worksheet.
ScrollColumn	Returns or sets the number of the leftmost column in the pane or window.
ScrollRow	Returns or sets the number of the row that appears at the top of the pane or window.
SelectedSheets	Returns a Sheets collection that represents all the selected sheets in the specified window.
Selection	Returns the selected object in the specified window.
SheetViews	Returns the SheetViews object for the specified window. Read-only.
Split	True if the window is split.
SplitColumn	Returns or sets the column number where the window is split into panes (the number of columns to the left of the split line).
SplitHorizontal	Returns or sets the location of the horizontal window split in points.
SplitRow	Returns or sets the row number where the window is split into panes (the number of rows above the split).
SplitVertical	Returns or sets the location of the vertical window split in points.
TabRatio	Returns or sets the ratio of the width of the workbook's tab area to the width of the window's horizontal scroll bar (as a number between 0 (zero) and 1; the default value is 0.6).
Top	The distance in points from the top edge of the window to the top edge of the usable area (below the menus, any toolbars docked at the top, and the formula bar).
Type	Returns or sets the window type.
UsableHeight	Returns the maximum height in points of the space that a window can occupy in the application window area.
UsableWidth	Returns the maximum width in points of the space that a window can occupy in the application window area.
View	Returns or sets the view showing in the window.
Visible	Determines whether the object is visible.
VisibleRange	Returns a Range object that represents the range of cells that are visible in the window or pane. If a column or row is partially visible, it's included in the range.
Width	The width in points of the window.
WindowNumber	Returns the window number. For example, a window named "Book1.xls:2" has 2 as its window number. Most windows have the window number 1.
WindowState	Returns or sets the state of the window.
Zoom	Returns or sets the display size of the window as a percentage (100 equals normal size, 200 equals double size, and so on).

Methods

_PrintOut(Object, Object, Object, Object, Object, Object, Object, Object)
Activate()	Brings the window to the front of the z-order.
ActivateNext()	Activates the specified window, and then sends it to the back of the window z-order.
ActivatePrevious()	Activates the specified window and then activates the window at the back of the window z-order.
Close(Object, Object, Object)	Closes the object.
LargeScroll(Object, Object, Object, Object)	Scrolls the contents of the window by pages.
NewWindow()	Creates a new window or a copy of the specified window.
PointsToScreenPixelsX(Int32)	Converts a horizontal measurement from points (document coordinates) to screen pixels (screen coordinates).
PointsToScreenPixelsY(Int32)	Converts a vertical measurement from points (document coordinates) to screen pixels (screen coordinates).
PrintOut(Object, Object, Object, Object, Object, Object, Object, Object)	Prints the object.
PrintPreview(Object)	Shows a preview of the object as it would look when printed.
RangeFromPoint(Int32, Int32)	Returns the Shape or Range object that is positioned at the specified pair of screen coordinates. If there isn’t a shape located at the specified coordinates, this method returns Nothing.
ScrollIntoView(Int32, Int32, Int32, Int32, Object)	Scrolls the document window so that the contents of a specified rectangular area are displayed in either the upper-left or lower-right corner of the document window or pane.
ScrollWorkbookTabs(Object, Object)	Scrolls through the workbook tabs at the bottom of the window.
SmallScroll(Object, Object, Object, Object)	Scrolls the contents of the window by rows or columns.