---

NSTabViewItem Class Reference

Overview

An NSTabViewItem is a convenient way for presenting information in multiple pages. A tab view is usually distinguished by a row of tabs that give the visual appearance of folder tabs. When the user clicks a tab, the tab view displays a view page provided by your application. A tab view keeps a zero-based array of NSTabViewItems, one for each tab in the view.

Adopted Protocols

• – encodeWithCoder:

• – initWithCoder:

Tasks

Creating a Tab View Item

• – initWithIdentifier:

Working with Labels

• – drawLabel:inRect:
• – label
• – setLabel:
• – sizeOfLabel:

Checking the Tab Display State

• – tabState

Assigning an Identifier Object

• – identifier
• – setIdentifier:

Setting the Color

• – color
• – setColor:

Assigning a View

• – view
• – setView:

Setting the Initial First Responder

• – initialFirstResponder
• – setInitialFirstResponder:

Accessing the Parent Tab View

• – tabView

Instance Methods

color

Returns the color for the receiver.

- (NSColor *)color

Discussion

The color is specified by the current theme.

Availability

• Available in Mac OS X v10.0 and later.

See Also

• – setColor:

Declared In

NSTabViewItem.h

drawLabel:inRect:

Draws the receiver’s label in tabRect, which is the area between the curved end caps.

- (void)drawLabel:(BOOL)shouldTruncateLabel inRect:(NSRect)tabRect

Discussion

If shouldTruncateLabel is NO, draws the full label in the rectangle specified by tabRect. If shouldTruncateLabel is YES, draws the truncated label. You can override this method to perform customized label drawing. For example, you might want to add an icon to each tab in the view.

Availability

• Available in Mac OS X v10.0 and later.

See Also

• – sizeOfLabel:

Declared In

NSTabViewItem.h

identifier

Returns the receiver’s optional identifier object.

- (id)identifier

Discussion

To customize how your application works with tabs, you can initialize each tab view item with an identifier object.

Availability

• Available in Mac OS X v10.0 and later.

See Also

• – initWithIdentifier:
• – setIdentifier:

Declared In

NSTabViewItem.h

initialFirstResponder

Returns the initial first responder for the view associated with the receiver.

- (id)initialFirstResponder

Availability

• Available in Mac OS X v10.0 and later.

See Also

• – setInitialFirstResponder:

Declared In

NSTabViewItem.h

initWithIdentifier:

Performs default initialization for the receiver.

- (id)initWithIdentifier:(id)identifier

Discussion

Sets the receiver’s identifier object to identifier, if it is not nil. Use this method when creating tab view items programmatically.

Availability

• Available in Mac OS X v10.0 and later.

See Also

• – identifier
• – setIdentifier:

Declared In

NSTabViewItem.h

label

Returns the label text for the receiver.

- (NSString *)label

Availability

• Available in Mac OS X v10.0 and later.

See Also

• – setLabel:

Declared In

NSTabViewItem.h

setColor:

Deprecated. NSTabViewItems use a color supplied by the current theme.

- (void)setColor:(NSColor *)color

Availability

• Available in Mac OS X v10.0 and later.

See Also

• – color

Declared In

NSTabViewItem.h

setIdentifier:

Sets the receiver’s optional identifier object to identifier.

- (void)setIdentifier:(id)identifier

Discussion

To customize how your application works with tabs, you can specify an identifier object for each tab view item.

Availability

• Available in Mac OS X v10.0 and later.

See Also

• – identifier
• – initWithIdentifier:

Declared In

NSTabViewItem.h

setInitialFirstResponder:

Sets the initial first responder for the view associated with the receiver (the view that is displayed when a user clicks on the tab) to view.

- (void)setInitialFirstResponder:(NSView *)view

Availability

• Available in Mac OS X v10.0 and later.

See Also

• – initialFirstResponder

Declared In

NSTabViewItem.h

setLabel:

Sets the label text for the receiver to label.

- (void)setLabel:(NSString *)label

Availability

• Available in Mac OS X v10.0 and later.

See Also

• – label

Related Sample Code

• CoreRecipes

Declared In

NSTabViewItem.h

setView:

Sets the view associated with the receiver to view.

- (void)setView:(NSView *)view

Discussion

This is the view displayed when a user clicks the tab. When you set a new view, the old view is released.

Availability

• Available in Mac OS X v10.0 and later.

See Also

• – view

Related Sample Code

• CoreRecipes

Declared In

NSTabViewItem.h

sizeOfLabel:

Calculates the size of the receiver’s label.

- (NSSize)sizeOfLabel:(BOOL)shouldTruncateLabel

Discussion

If shouldTruncateLabel is NO, returns the size of the receiver’s full label. If shouldTruncateLabel is YES, returns the truncated size. If your application does anything to change the size of tab labels, such as overriding the drawLabel:inRect: method to add an icon to each tab, you should override sizeOfLabel: too so the NSTabView knows the correct size for the tab label.

Availability

• Available in Mac OS X v10.0 and later.

See Also

• – drawLabel:inRect:
• – setFont: (NSTabView)

Declared In

NSTabViewItem.h

tabState

Returns the current display state of the tab associated with the receiver.

- (NSTabState)tabState

Discussion

The possible values are NSSelectedTab, NSBackgroundTab, or NSPressedTab. Your application does not directly set the tab state.

Availability

• Available in Mac OS X v10.0 and later.

Declared In

NSTabViewItem.h

tabView

Returns the parent tab view for the receiver.

- (NSTabView *)tabView

Discussion

Note that this is the tab view itself, not the view displayed when a user clicks the tab.

A tab view item normally learns about its parent tab view when it is inserted into the view’s array of items. The NSTabView methods addTabViewItem: and insertTabViewItem:atIndex: set the tab view for the added or inserted item.

Availability

• Available in Mac OS X v10.0 and later.

See Also

• – setView:
• – view

Declared In

NSTabViewItem.h

view

Returns the view associated with the receiver.

- (id)view

Discussion

This is the view displayed when a user clicks the tab.

Availability

• Available in Mac OS X v10.0 and later.

See Also

• – setView:

Related Sample Code

• CarbonCocoaCoreImageTab
• Reducer

Declared In

NSTabViewItem.h

Constants

NSTabState

These constants describe the current display state of a tab:

typedef enum _NSTabState {
   NSSelectedTab = 0,
   NSBackgroundTab = 1,
   NSPressedTab = 2
} NSTabState;

Constants

NSBackgroundTab

A tab that’s not being displayed.

Available in Mac OS X v10.0 and later.

Declared in NSTabViewItem.h.

NSPressedTab

A tab that the user is in the process of clicking. That is, the user has pressed the mouse button while the cursor is over the tab but has not released the mouse button.

Available in Mac OS X v10.0 and later.

Declared in NSTabViewItem.h.

NSSelectedTab

The tab that’s being displayed.

Available in Mac OS X v10.0 and later.

Declared in NSTabViewItem.h.

Availability

• Available in Mac OS X v10.0 and later.

Declared In

NSTabViewItem.h

---