Apple IIgs #61
Window Title Handles

Written by Dave Lyons (July 1989)

This Technical Note discusses extensions to SetWTitle and GetWTitle in System Software 5.0 and later which allow handles to be used as window titles.

Prior to System Software 5.0, window titles were pointers to Pascal-style strings (with a leading length byte), but now window titles can be stored in handles, with bit 31 of titlePtr set to indicate that the parameter is actually a handle.

Once you call SetWTitle with a handle for the title parameter, the handle belongs to the Window Manager,which will dispose of it when the window is closed or retitled. You must not dispose of the handle yourself, and you must not change the data it contains.

Further Reference

This and all of the other Apple II Technical Notes have been converted to HTML by Aaron Heiss as a public service to the Apple II community, with permission by Apple Computer, Inc. Any and all trademarks, registered and otherwise, are properties of their owners.