Advanced Search
Apple Developer Connection
Member Login Log In | Not a Member? Contact ADC

Previous Book Contents Book Index Next

Inside Macintosh: Operating System Utilities /
Chapter 5 - Control Panel Extensions / Control Panel Extensions Reference
Control Panel Extension-Defined Routines / Managing Panel Components


MyPanelGetTitle

A control panel extension should respond to the kPanelGetTitleSelect request code but is not required to do so. A control panel sends this request code to your extension to get the name of your panel extension. A control panel extension typically responds to the kPanelGetTitleSelect request code by calling an extension-defined subroutine (for example, MyPanelGetTitle) to handle the request.

FUNCTION MyPanelGetTitle (self: ComponentInstance; title: Str255) 
                         : ComponentResult;
self
A component instance identifying the specific instance of your control panel extension.
title
On exit, the name of your control panel extension as you want it to appear in the panel-selection pop-up menu of the control panel.
DESCRIPTION
Your MyPanelGetTitle function should return, through the title parameter, a string that is the desired title of your control panel extension. This name appears as a menu item in the pop-up menu that lets the user select which panel to view.

SPECIAL CONSIDERATIONS
Currently, all control panels use the component name as the title of the control panel extension. The MyPanelGetTitle function is intended to allow your extension to assign a title different from the component name. Future control panels are likely to call your MyPanelGetTitle function.

RESULT CODES
Your MyPanelGetTitle function should return noErr if successful, or an appropriate result code otherwise.


Previous Book Contents Book Index Next

© Apple Computer, Inc.
6 JUL 1996

Get information on Apple products.
Visit the Apple Store online or at retail locations.
1-800-MY-APPLE

Copyright © 2004 Apple Computer, Inc.
All rights reserved. | Terms of use | Privacy Notice