UKPrefsPanel.h

/* =============================================================================
   FILE:		UKPrefsPanel.h

   AUTHORS:	M. Uli Kusterer (UK), (c) Copyright 2003, all rights reserved.

   REVISIONS:
   2003-08-13	UK	Added auto-save, fixed bug with empty window titles.
   2003-07-22  UK  Added Panther stuff, documented.
   2003-06-30  UK  Created.
   ========================================================================== */

/**		A class that creates a simple Safari-like Preferences window with a
   toolbar at the top.

   UKPrefsPanel is ridiculously easy to use: Create a tabless NSTabView,
   where the name of each tab is the name for the toolbar item, and the
   identifier of each tab is the identifier to be used for the toolbar
   item to represent it. Then create image files with the identifier as
   their names to be used as icons in the toolbar.

   Finally, drag UKPrefsPanel.h into the NIB with the NSTabView,
   instantiate a UKPrefsPanel and connect its tabView outlet to your
   NSTabView. When you open the window, the UKPrefsPanel will
   automatically add a toolbar to the window with all tabs represented by
   a toolbar item, and clicking an item will switch between the tab view's
   items. */



/* -----------------------------------------------------------------------------
   Headers:
   -------------------------------------------------------------------------- */

#import <Cocoa/Cocoa.h>
#import <Foundation/Foundation.h>

/* -----------------------------------------------------------------------------
   Classes:
   -------------------------------------------------------------------------- */

@interface UKPrefsPanel : NSObject
{
    IBOutlet NSTabView *tabView;                                ///< The tabless tab-view that we're a switcher for.
    NSMutableDictionary *itemsList;                             ///< Auto-generated from tab view's items.
    NSString *baseWindowName;                                   ///< Auto-fetched at awakeFromNib time. We append a colon and the name of the current page to the actual window title.
}

/// Mutator for specifying the tab view: (you should just hook this up in IB)
- (void)setTabView:(NSTabView *)tv;
- (NSTabView *)tabView;                                         ///< Accessor for tab view containing the different pref panes.

// Action for hooking up this object and the menu item:
- (IBAction)orderFrontPrefsPanel:(id)sender;

// Modification to original UKPrefsPanel suggested by OpenSword Pixen's code
- (void)resizeToFit:(NSBox *)box;

// You don't have to care about these:
- (void)mapTabsToToolbar;
- (IBAction)changePanes:(id)sender;

@end