PPT2000: How to Use the WindowState Property

ID: Q222761

The information in this article applies to:

Microsoft PowerPoint 2000

SUMMARY

This article describes how to use the WindowState property from within a Microsoft PowerPoint macro.

MORE INFORMATION

Microsoft provides programming examples for illustration only, without warranty either expressed or implied, including, but not limited to, the implied warranties of merchantability and/or fitness for a particular purpose. This article assumes that you are familiar with the programming language being demonstrated and the tools used to create and debug procedures. Microsoft Support professionals 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 needs. If you have limited programming experience, you may want to contact the Microsoft fee-based consulting line at (800) 936-5200. For more information about the support options available from Microsoft, please see the following page on the World Wide Web:

http://www.microsoft.com/support/supportnet/overview/overview.asp

NOTE: The following macro examples only work from within the PowerPoint application. Visual Basic for Applications macros are not supported by the Microsoft PowerPoint Viewer. For additional information, please see the following article in the Microsoft Knowledge Base:

Q230746 PPT: Viewer: Presentation Macros Don't Run

The WindowState property stores information about the window, such as if the window is maximized, minimized, or normal. Two types of windows use the WindowState property: ActiveWindow (the presentation) and Application (PowerPoint). The following constants are used to describe the different window states.

WindowState Constants

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

http://www.microsoft.com/support/supportnet/overview/overview.asp

Q230746 PPT: Viewer: Presentation Macros Don't Run

The following sample Microsoft Visual Basic for Applications code retrieves the 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. The two variables (lPowerPointWindowState and lActiveWindowState) are declared as Longs.

NOTE: The lower case "l" is used at the beginning of the variable names to indicate that they are the Long data type.

Setting a WindowState

The following Visual Basic example sets a WindowState for the ActiveWindow and 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 currently the ActiveWindow.

To determine whether a WindowState is in a particular state, you can add the following code to your macro:


If ActiveWindow.WindowState <> ppWindowMinimized Then

      ActiveWindow.WindowState = ppWindowMinimized

   End If

This code example changes the WindowState only if the ActiveWindow is not already minimized. If the ActiveWindow is minimized, the code continues after the End If statement.

REFERENCES

For more information about using the sample code in this article, please see the following article in the Microsoft Knowledge Base:

Q212536 OFF2000: How to Run Sample Code from Knowledge Base Articles

Additional query words: 9.00 ppt9 vba vbe ppt2k powerpt vba2k ppt9.0 ppt2000 program programming

Keywords : kbcode kbmacro kbprg kbdta kbdtacode kbpptvba
Version : WINDOWS:2000
Platform : WINDOWS
Issue type : kbhowto