2011-03-20 15:16:13 +08:00
|
|
|
/* =============================================================================
|
|
|
|
|
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:
|
|
|
|
|
-------------------------------------------------------------------------- */
|
|
|
|
|
|
2011-08-02 01:02:41 +08:00
|
|
|
@interface UKPrefsPanel : NSObject <NSToolbarDelegate>
|
2011-03-20 15:16:13 +08:00
|
|
|
{
|
|
|
|
|
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
|
