root/Trunk/AIUtilities.framework/Versions/A/Headers/AIFlexibleToolbarItem.h @ 2

//
//  AIFlexibleToolbarItem.h
//  AIUtilities.framework
//
//  Created by Evan Schoenberg on 10/16/04.
//  Copyright (c) 2004-2005 The Adium Team. All rights reserved.
//

@class AIFlexibleToolbarItem;

/*!
 * @class AIFlexibleToolbarItem
 * @brief Toolbar item with a validation delegate
 *
 * Normally, an NSToolbarItem does not validate if it has a custom view. <tt>AIFlexibleToolbarItem</tt> sends its delegate validate methods regardless of its configuration, allowing validation when using custom views.  Adium uses this, for example, to change the image on a toolbar button when conditions change in its window.
 *
 * @see <tt><a href="category_n_s_object(_e_s_flexible_toolbar_item_delegate).html">NSObject(AIFlexibleToolbarItemDelegate)</a></tt>
 */
@interface AIFlexibleToolbarItem : NSToolbarItem {
        id      validationDelegate;
}

/*!
 * @brief Set the validation delegate
 *
 * Set the validation delegate, which must implement the methods in <tt>AIFlexibleToolbarItemDelegate</tt> and will receive validation messages.
 * @param inDelegate The delegate
 */
- (void)setValidationDelegate:(id)inDelegate;

@end

/*!
 * @protocol AIFlexibleToolbarItemDelegate
 * @brief Required protocol for an AIFlexibleToolbarItem's validation delegate
 *
 * The delegate is sent - (void)validateFlexibleToolbarItem:(AIFlexibleToolbarItem *)toolbarItem, which must be efficient
 */
@protocol AIFlexibleToolbarItemDelegate
/*!
 * @brief Sent when the toolbar item is validated
 *
 * @param toolbarItem The toolbar item
 */
- (void)validateFlexibleToolbarItem:(AIFlexibleToolbarItem *)toolbarItem;
@end