MyPanelGetTitleA control panel extension should respond to the
kPanelGetTitleSelectrequest 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
kPanelGetTitleSelectrequest code by calling an extension-defined subroutine (for example,
MyPanelGetTitle) to handle the request.
FUNCTION MyPanelGetTitle (self: ComponentInstance; title: Str255) : ComponentResult;
- A component instance identifying the specific instance of your control panel extension.
- 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.
MyPanelGetTitlefunction should return, through the
titleparameter, 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 CONSIDERATIONSCurrently, all control panels use the component name as the title of the control panel extension. The
MyPanelGetTitlefunction is intended to allow your extension to assign a title different from the component name. Future control panels are likely to call your
MyPanelGetTitlefunction should return
noErrif successful, or an appropriate result code otherwise.