ITStatusItem.h

   1 /*
   2  *      ITKit
   3  *  ITStatusItem
   4  *    NSStatusItem subclass which reduces suckage
   5  *
   6  *  Original Author : Joseph Spiros <joseph.spiros@ithinksw.com>
   7  *  Original Author : Matt Judy <mjudy@ithinksw.com>
   8  *   Responsibility : Matt Judy <mjudy@ithinksw.com>
   9  *   Responsibility : Joseph Spiros <joseph.spiros@ithinksw.com>
  10  *
  11  *  Copyright (c) 2002 - 2003 iThink Software.
  12  *  All Rights Reserved
  13  *
  14  */
  15
  16 /*
  17  *      This subclass does 4 things to approximate NSMenuExtra's functionality:
  18  *
  19  *  1. Makes the status item smarter about highlighting.
  20  *  2. Allows you to set an alternate (inverted) image.
  21  *  3. Eliminates the pre-Jaguar shadow behind a normal status item.
  22  *  4. If you use an image AND title, the text will be made slightly smaller
  23  *     to resemble the visual interface of an NSMenuExtra.
  24  *
  25  *  Note:  In order to have the shadow not overlap the bottom of the
  26  *  menubar, Apple moves the image up one pixel.  Since that shadow is
  27  *  no longer drawn, please adjust your images DOWN one pixel to compensate.
  28  *
  29  */
  30
  31
  32 #import <Cocoa/Cocoa.h>
  33
  34
  35 @interface ITStatusItem : NSStatusItem
  36 {
  37 }
  38
  39 // Use this to create a new retained status item.
  40 // It will appear in the system status bar, and
  41 // default to YES for its highlightMode.
  42 - (id)initWithStatusBar:(NSStatusBar*)statusBar withLength:(float)length;
  43
  44 // These allow you to use an alternate (selected) image for your status item.
  45 - (NSImage*) alternateImage;
  46 - (void) setAlternateImage:(NSImage*)image;
  47
  48
  49 @end