This article was previously published under Q162352
This article has been archived. It is offered "as is" and will no longer be updated.
This article describes how to use the WindowState property from within aMicrosoft PowerPoint macro.
The WindowState property stores information about the window such aswhether the Window is maximized, minimized, or normal. Two types of windowsuse the WindowState property: ActiveWindow (the presentation) andApplication (PowerPoint). The following constants are used to describe thedifferent window states.
The WindowState can be one of the following three ppWindowState constants:
Name of Constant Description---------------- -----------ppWindowMaximized Specifies that the window is maximized.ppWindowMinimized Specifies that the window is minimized.ppWindowNormal Specifies the window is neither maximized nor minimized.
Retrieving a WindowState
Microsoft provides programming examples for illustration only, without warranty either expressed or implied. This includes, but is not limited to, the implied warranties of merchantability or fitness for a particular purpose. This article assumes that you are familiar with the programming language that is being demonstrated and with the tools that are used to create and to debug procedures. Microsoft support engineers can help explain the functionality of a particular procedure, but they will not modify these examples to provide added functionality or construct procedures to meet your specific requirements. The following sample Microsoft Visual Basic for Applications code retrievesthe current WindowState of the ActiveWindow and the application.
Sub GetWindowState() ' WindowState property is a long. Dim lPowerPointWindowState As Long Dim lActiveWindowState As Long ' Retrieve the application window state. lPowerPointWindowState = PowerPoint.Application.WindowState ' Retrieve the active window's window state. lActiveWindowState = ActiveWindow.WindowState End Sub
The WindowState property is a Long data type. So, the two variables(lPowerPointWindowState and lActiveWindowState) are declared as longs.
NOTE: The lower case "l" is used at the beginning of the variable names toindicate that they are long data types.
Setting a WindowState
The following Visual Basic example sets a WindowState for the ActiveWindowand for PowerPoint.
Sub SetWindowState() ' Minimizes the active presentation. ActiveWindow.WindowState = ppWindowMinimized ' Maximizes PowerPoint. PowerPoint.Application.WindowState = ppWindowMaximized End Sub
NOTE: You can only set the WindowState of a presentation that is currentlythe ActiveWindow.
To determine whether a WindowState is a particular state, you can add thefollowing code to your macro:
If ActiveWindow.WindowState <> ppWindowMinimized Then ActiveWindow.WindowState = ppWindowMinimized End If
This code example changes the WindowState only if the ActiveWindow isnot already minimized. If the ActiveWindow is minimized, the code continuesafter the End If statement.
For additional information about getting help with Visual Basic forApplications, please see the following article in the Microsoft KnowledgeBase:
163435 VBA: Programming Resources for Visual Basic for Applications