NSToolbar.ToolbarItemForItemIdentifierWillBeInsertedIntoToolbarEventHandler Delegate

Sent to request a new toolbar item; returns a toolbar item of the identified kind for the specified toolbar.

Original signature is '- (NSToolbarItem *)toolbar:(NSToolbar *)toolbar itemForItemIdentifier:(NSString *)itemIdentifier willBeInsertedIntoToolbar:(BOOL)flag'

Available in Mac OS X v10.0 and later.

Declaration Syntax

Visual Basic

Visual C++

public delegate NSToolbarItem ToolbarItemForItemIdentifierWillBeInsertedIntoToolbarEventHandler(
	NSToolbar toolbar,
	NSString itemIdentifier,
	bool flag
)

Public Delegate Function ToolbarItemForItemIdentifierWillBeInsertedIntoToolbarEventHandler ( _
	toolbar As NSToolbar, _
	itemIdentifier As NSString, _
	flag As Boolean _
) As NSToolbarItem

public delegate NSToolbarItem^ ToolbarItemForItemIdentifierWillBeInsertedIntoToolbarEventHandler(
	NSToolbar^ toolbar, 
	NSString^ itemIdentifier, 
	bool flag
)

Parameters

toolbar (NSToolbar): The toolbar for which the item is being requested.

itemIdentifier (NSString): The identifier for the requested item.

flag (Boolean): YES if the item will be immediately inserted into the toolbar. If flag is NO the toolbar item is being requested for display in the toolbar customization sheet and should always be enabled or provide some other canonical representation. If you ignore this parameter the same toolbar item will be used in the toolbar and in the customization sheet.

Return Value

The toolbar item for the specified toolbar and identifier. Return nil to indicate that the identified kind of toolbar item is not supported. When an item is requested again, you may return the same NSToolbarItem object returned earlier or a different instance.

Version Information

Available in Monobjc Bridge: 10.6 (For Mac OS X 10.6 and later), 10.5 (For Mac OS X 10.5 and later)

Assembly: Monobjc.AppKit (Module: Monobjc.AppKit)