[TOC] [Prev] [Next] [Bottom]

NSTabViewItem

Inherits From:
NSObject

Conforms To:
NSCoding
NSObject (NSObject)

Declared In:
AppKit/NSTabViewItem.h

Class Description

Note: The NSTabView class and its supporting class NSTabViewItem are under development. If you want to use these classes, you will have to instantiate them programmatically because Interface Builder does not yet include support for them.

An NSTabView provides a convenient mechanism for presenting information in a multi-page format. A tab view is usually distinguished by a row of tabs that give the visual appearance of folder tabs. When the user clicks on 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. A tab view item provides access to the tab's color, state, label text, initial first responder, and associated view. Your application can supply each tab view item with an optional identifier object to customize tab handling.


Method Types

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

- (NSColor *)color

Returns the color for the tab view item. By default, the color is set to the system color used for the flat surfaces of a control.

See also: - setColor:


drawLabel:inRect:

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

If shouldTruncateLabel is NO, draws the full label in the rect 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.

See also: - sizeOfLabel:


identifier

- (id)identifier

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

See also: - initWithIdentifier:, - setIdentifier:


initialFirstResponder

- (id)initialFirstResponder

Returns the id for the initial first responder for the view associated with the tab view item.

See also: - setInitialFirstResponder:


initWithIdentifier:

- (id)initWithIdentifier:(id)identifier

Performs default initialization for the tab view item. Sets the item's identifier object to identifier, if it is not nil. Use this method when creating tab view items programmatically.

See also: - identifier, - setIdentifier:


label

- (NSString *)label

Returns the label text for the tab view item.

See also: - setLabel:


setColor:

- (void)setColor:(NSColor *)color

Sets the color for the tab view item to color.

See also: - color


setIdentifier:

- (void)setIdentifier:(id)identifier

Sets the tab view item's optional identifier object to identifier. To customize how your application works with tabs, you can specify an identifier object for each tab view item.

See also: - identifier, - initWithIdentifier:


setInitialFirstResponder:

- (void)setInitialFirstResponder:(NSView *)view

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

See also: - initialFirstResponder


setLabel:

- (void)setLabel:(NSString *)label

Sets the label text for the tab view item according to the passed string label.

See also: - label


setView:

- (void)setView:(NSView *)view

Sets the view associated with the tab view item to view. This is the view that is displayed when a user clicks on the tab. When you set a new view, the old view is released.

See also: - view


sizeOfLabel:

- (NSSize)sizeOfLabel:(BOOL)shouldTruncateLabel

If shouldTruncateLabel is NO, returns the size of the tab view item'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 that the NSTabView knows the correct size for the tab label.

See also: - drawLabel:inRect:, - setFont: (NSTabView)


tabState

- (NSTabState)tabState

Returns the current display state of the tab associated with this tab view item. The possible values are NSSelectedTab, NSBackgroundTab, or NSPressedTab. Your application does not directly set the tab state.


tabView

- (NSTabView *)tabView

Returns the parent tab view for the tab view item. Note that this is the tab view itself, not the view that is displayed when a user clicks on 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.

See also: - setView:, - view


view

- (id)view

Returns the id for the view associated with the tab view item. This is the view that is displayed when a user clicks on the tab.

See also: - setView:



[TOC] [Prev] [Next] [Bottom]

Copyright © 1997, Apple Computer, Inc. All rights reserved.