The release notes has some good information, and there is quite a bit of documentation in the headers, but.... nothing helps like an example. In your code, at a minimum, you'd probably do something like the code snippets I've attached. HTH, chuck // Probably called from awakeFromNib, or - windowControllerDidLoadNib: - (void) setupToolbar { // Create a new toolbar instance, and attach it to our document window NSToolbar *toolbar = [[[NSToolbar alloc] initWithIdentifier: MyDocToolbarIdentifier] autorelease]; // Set up toolbar properties: Allow customization, give a default display mode, and remember state in user defaults [toolbar setAllowsUserCustomization: YES]; [toolbar setAutosavesConfiguration: YES]; [toolbar setDisplayMode: NSToolbarDisplayModeIconOnly]; // We are the delegate [toolbar setDelegate: self]; // Attach the toolbar to the document window [documentWindow setToolbar: toolbar]; } - (NSArray *) toolbarDefaultItemIdentifiers: (NSToolbar *) toolbar { // Required delegate method Returns the ordered list of items to be shown in the toolbar by default // If during the toolbar's initialization, no overriding values are found in the user defaults, or if the // user chooses to revert to the default items self set will be used return [NSArray arrayWithObjects: SaveDocToolbarItemIdentifier, NSToolbarPrintItemIdentifier, NSToolbarSeparatorItemIdentifier, NSToolbarShowColorsItemIdentifier, NSToolbarShowFontsItemIdentifier, NSToolbarFlexibleSpaceItemIdentifier, NSToolbarSpaceItemIdentifier, nil]; } - (NSArray *) toolbarAllowedItemIdentifiers: (NSToolbar *) toolbar { // Required delegate method Returns the list of all allowed items by identifier By default, the toolbar // does not assume any items are allowed, even the separator So, every allowed item must be explicitly listed // The set of allowed items is used to construct the customization palette return [NSArray arrayWithObjects: SaveDocToolbarItemIdentifier, NSToolbarPrintItemIdentifier, NSToolbarShowColorsItemIdentifier, NSToolbarShowFontsItemIdentifier, NSToolbarCustomizeToolbarItemIdentifier, NSToolbarFlexibleSpaceItemIdentifier, NSToolbarSpaceItemIdentifier, NSToolbarSeparatorItemIdentifier, nil]; } - (NSToolbarItem *) toolbar: (NSToolbar *)toolbar itemForItemIdentifier: (NSString *) itemIdent willBeInsertedIntoToolbar:(BOOL) willBeInserted { // Required delegate method Given an item identifier, self method returns an item // The toolbar will use self method to obtain toolbar items that can be displayed in the customization sheet, or in the toolbar itself // Note that the toolbar knows how to make the standard NS supplied items all on its own, we don't have to do that. NSToolbarItem *toolbarItem = [[[NSToolbarItem alloc] initWithItemIdentifier: itemIdent] autorelease]; if ([itemIdent isEqual: SaveDocToolbarItemIdentifier]) { // Set the text label to be displayed in the toolbar and customization palette [toolbarItem setLabel: @"Save"]; [toolbarItem setPaletteLabel: @"Save"]; // Set up a reasonable tooltip, and image Note, these aren't localized, but you will likely want to localize many of the item's properties [toolbarItem setToolTip: @"Save Your Document"]; [toolbarItem setImage: [NSImage imageNamed: @"SaveDocumentItemImage"]]; // Tell the item what message to send when it is clicked [toolbarItem setTarget: self]; [toolbarItem setAction: @selector(saveDocument:)]; } else { // itemIdent refered to a toolbar item that is not provide or supported by us or cocoa // Returning nil will inform the toolbar this kind of item is not supported toolbarItem = nil; } return toolbarItem; } On Saturday, April 28, 2001, at 08:01 PM, Andreas Wolf wrote: Hi cocoa-dev, has anybody experience using NSToolbar and NSToolbarItems and can he/she provide some sample code or a path to code using these classes? I've read the AppKit Release Notes and believe that I did all that was required to get a toolbar on my window, but still I don't see much more than a horizontal line. How can get items on that toolbar (predefined or custom made)? Thanx, -A _______________________________________________ cocoa-dev mailing list cocoa-dev@lists.apple.com http://www.lists.apple.com/mailman/listinfo/cocoa-dev