Legacy Document

Inside Macintosh: Macintosh Toolbox Essentials /

Chapter 4 - Window Manager / Window Manager Reference

Window Manager Routines / Naming Windows

GetWTitle

Use the GetWTitle procedure to retrieve a window's title.

PROCEDURE GetWTitle (theWindow: WindowPtr; VAR title: Str255);

theWindow

A pointer to the window record.

title

The window title.

DESCRIPTION

The GetWTitle procedure returns the title of the window in the title parameter.

Your application seldom needs to determine a window's title. It might need to do so, however, when presenting user dialog boxes during operations that can affect multiple files. A spell-checking command, for example, might display a dialog box that lets the user select from all currently open documents.

When you need to retrieve a window's title, you should always use GetWTitle instead of reading the title from a window's window record.