Fixing other headers
[ITKit.git] / ITStatusItem.h
index 2824f9b..4116107 100755 (executable)
@@ -4,14 +4,31 @@
  *    NSStatusItem subclass which reduces suckage
  *
  *  Original Author : Joseph Spiros <joseph.spiros@ithinksw.com>
  *    NSStatusItem subclass which reduces suckage
  *
  *  Original Author : Joseph Spiros <joseph.spiros@ithinksw.com>
+ *  Original Author : Matt Judy <mjudy@ithinksw.com>
  *   Responsibility : Matt Judy <mjudy@ithinksw.com>
  *   Responsibility : Joseph Spiros <joseph.spiros@ithinksw.com>
  *
  *   Responsibility : Matt Judy <mjudy@ithinksw.com>
  *   Responsibility : Joseph Spiros <joseph.spiros@ithinksw.com>
  *
- *  Copyright (c) 2002 iThink Software.
+ *  Copyright (c) 2002 - 2003 iThink Software.
  *  All Rights Reserved
  *
  */
 
  *  All Rights Reserved
  *
  */
 
+/*
+ *     This subclass does 4 things to approximate NSMenuExtra's functionality:
+ *
+ *  1. Makes the status item smarter about highlighting.
+ *  2. Allows you to set an alternate (inverted) image.
+ *  3. Eliminates the pre-Jaguar shadow behind a normal status item.
+ *  4. If you use an image AND title, the text will be made slightly smaller
+ *     to resemble the visual interface of an NSMenuExtra.
+ *
+ *  Note:  In order to have the shadow not overlap the bottom of the
+ *  menubar, Apple moves the image up one pixel.  Since that shadow is
+ *  no longer drawn, please adjust your images DOWN one pixel to compensate.
+ *
+ */
+
+
 #import <Cocoa/Cocoa.h>
 
 
 #import <Cocoa/Cocoa.h>
 
 
 {
 }
 
 {
 }
 
+// Use this to create a new retained status item.
+// It will appear in the system status bar, and
+// default to YES for its highlightMode.
 - (id)initWithStatusBar:(NSStatusBar*)statusBar withLength:(float)length;
 
 - (id)initWithStatusBar:(NSStatusBar*)statusBar withLength:(float)length;
 
+// These allow you to use an alternate (selected) image for your status item.
 - (NSImage*) alternateImage;
 - (void) setAlternateImage:(NSImage*)image;
 
 - (NSImage*) alternateImage;
 - (void) setAlternateImage:(NSImage*)image;
 
+
 @end
 @end