Legacy Document

Inside Macintosh: Macintosh Toolbox Essentials /

Chapter 4 - Window Manager / Window Manager Reference

Window Manager Routines / Displaying Windows

ShowHide

Use the ShowHide procedure to set a window's visibility status.

PROCEDURE ShowHide (theWindow: WindowPtr; showFlag: Boolean);

theWindow

A pointer to the window's window record.

showFlag

A Boolean value that determines visibility status: TRUE makes a window visible; FALSE makes it invisible.

DESCRIPTION

The ShowHide procedure sets a window's visibility to the status specified by the showFlag parameter. If the value of showFlag is TRUE, ShowHide makes the window visible if it's not already visible and has no effect if it's already visible. If the value of showFlag is FALSE, ShowHide makes the window invisible if it's not already invisible and has no effect if it's already invisible.

The ShowHide procedure never changes the highlighting or front-to-back ordering of windows and generates no activate events.

WARNING

Use this procedure carefully and only in special circumstances where you need more control than that provided by HideWindow and ShowWindow. Do not, for example, use ShowHide to hide the active window without making another window active.