Carbon Menu Manager API Preliminary Documentation
For CarbonLib 1.0
Preliminary Draft Technical Publications © Apple Computer, Inc. 1999
Apple Computer, Inc. Even though Apple has reviewed this © 1999 Apple Computer, Inc. manual, APPLE MAKES NO All rights reserved. WARRANTY OR REPRESENTATION, EITHER EXPRESS OR IMPLIED, WITH No part of this publication may be RESPECT TO THIS MANUAL, ITS reproduced, stored in a retrieval QUALITY, ACCURACY, system, or transmitted, in any form MERCHANTABILITY, OR FITNESS or by any means, mechanical, FOR A PARTICULAR PURPOSE. AS A electronic, photocopying, recording, RESULT, THIS MANUAL IS SOLD “AS or otherwise, without prior written IS,” AND YOU, THE PURCHASER, ARE permission of Apple Computer, Inc., ASSUMING THE ENTIRE RISK AS TO except to make a backup copy of any ITS QUALITY AND ACCURACY. documentation provided on CD-ROM. IN NO EVENT WILL APPLE BE LIABLE The Apple logo is a trademark of FOR DIRECT, INDIRECT, SPECIAL, Apple Computer, Inc. INCIDENTAL, OR CONSEQUENTIAL Use of the “keyboard” Apple logo DAMAGES RESULTING FROM ANY (Option-Shift-K) for commercial DEFECT OR INACCURACY IN THIS purposes without the prior written MANUAL, even if advised of the consent of Apple may constitute possibility of such damages. trademark infringement and unfair THE WARRANTY AND REMEDIES competition in violation of federal SET FORTH ABOVE ARE EXCLUSIVE and state laws. AND IN LIEU OF ALL OTHERS, ORAL No licenses, express or implied, are OR WRITTEN, EXPRESS OR IMPLIED. granted with respect to any of the No Apple dealer, agent, or employee is technology described in this book. authorized to make any modification, Apple retains all intellectual extension, or addition to this warranty. property rights associated with the Some states do not allow the exclusion or technology described in this book. limitation of implied warranties or This book is intended to assist liability for incidental or consequential application developers to develop damages, so the above limitation or applications only for Apple-labeled exclusion may not apply to you. This or Apple-licensed computers. warranty gives you specific legal rights, Every effort has been made to ensure and you may also have other rights that the information in this manual is which vary from state to state. accurate. Apple is not responsible for typographical errors. Apple Computer, Inc. 1 Infinite Loop Cupertino, CA 95014 408-996-1010 Apple, the Apple logo, and Mac are trademarks of Apple Computer, Inc., registered in the United States and other countries. PowerPC is a trademark of International Business Machines Corporation, used under license therefrom. Simultaneously published in the United States and Canada.
© Apple Computer, Inc. 11/9/99
CHAPTER 1
Carbon Menu Manager Preliminary API Documentation: for CarbonLib 1.0 0
In the following sections, this document discusses the changes to the Menu Manager that are part of the Carbon library which is included with Mac OS 9.0: “Changes to Your Application and the Menu Manager With Carbon” (page 4) “New Apple Menu Behavior” (page 6) “Accessing Opaque Menu Data” (page 6) “Accessing Menu Item Data Using Universal Command IDs” (page 8) “Writing a Carbon MDEF” (page 10) “Working With Menu and Menu Item Attributes” (page 14) “Enabling and Disabling Menu Items” (page 16)
IMPORTANT This is a preliminary document. Although it has been reviewed for technical accuracy, it is not final. Apple Computer, Inc. is supplying this information to help you plan for the adoption of the technologies and programming interfaces described herein. This information is subject to change, and software implemented according to this document should be tested with final operating system
You can check
3 Preliminary draft. Apple Computer, Inc. 11/9/99
CHAPTER 1
Carbon Menu Manager Preliminary API Documentation: for CarbonLib 1.0
Changes to Your Application and the Menu Manager With Carbon 0
Tips for Working With the Carbon Menu Manager 0