NSObject(PXSourceListNotifications) category reference

PXSourceListDelegate.h

Overview

This category is used to contain all of the methods that are used as notification methods sent to delegates of PXSourceList objects.

The implementation of these methods is done by the delegate, and are called when necessary by the associated PXSourceList object.

However, since the underlying mechanism for the calling of these methods is through the NSNotificationCenter, any object can subscribe to the notifications described in the discussion for each method detailed below, and receive notifications when any of these events occur.

Note: All of these methods are optional.

Tasks

Handling Selection

Item Expanding/Collapsing

Delete Key Handling

Instance Methods

sourceListSelectionIsChanging:

Invoked when the Source List's selection changes.

- (void)sourceListSelectionIsChanging:(NSNotification *)notification
Parameters
notification

The associated NSNotification object

Discussion

This method is invoked as the result of posting a PXSLSelectionIsChangingNotification.

notification does not contain a userInfo dictionary.

Availability

Available in Mac OS X v10.5 and later

See Also
Declared In
PXSourceListDelegate.h

sourceListSelectionDidChange:

Invoked immediately after the Source List's selection has changed.

- (void)sourceListSelectionDidChange:(NSNotification *)notification
Parameters
notification

The associated NSNotification object

Discussion

This method is invoked as the result of posting a PXSLSelectionDidChangeNotification.

Availability

Available in Mac OS X v10.5 and later

See Also
Declared In
PXSourceListDelegate.h

sourceListItemWillExpand:

Invoked whenever the user is about to expand an item in the Source List.

- (void)sourceListItemWillExpand:(NSNotification *)notification
Parameters
notification

The associated NSNotification object

Discussion

This method is invoked as the result of posting a PXSLItemWillExpandNotification.

The item that is about to expand is contained in notification's userInfo dictionary, as the value of the @"NSObject" key.

Availability

Available in Mac OS X v10.5 and later

See Also
Declared In
PXSourceListDelegate.h

sourceListItemDidExpand:

Invoked when an item in the Source List is expanded.

- (void)sourceListItemDidExpand:(NSNotification *)notification
Parameters
notification

The associated NSNotification object

Discussion

This method is invoked as the result of posting a PXSLItemDidExpandNotification.

The item that was expanded is contained in notification's userInfo dictionary, as the value of the @"NSObject" key.

Availability

Available in Mac OS X v10.5 and later

See Also
Declared In
PXSourceListDelegate.h

sourceListItemWillCollapse:

Invoked whenever the user is about to collapse an item in the Source List.

- (void)sourceListItemWillCollapse:(NSNotification *)notification
Parameters
notification

The associated NSNotification object

Discussion

This method is invoked as the result of posting a PXSLItemWillCollapseNotification.

The item that is about to collapse is contained in notification's userInfo dictionary, as the value of the @"NSObject" key.

Availability

Available in Mac OS X v10.5 and later

See Also
Declared In
PXSourceListDelegate.h

sourceListItemDidCollapse:

Invoked when an item in the Source List is collapsed.

- (void)sourceListItemDidCollapse:(NSNotification *)notification
Parameters
notification

The associated NSNotification object

Discussion

This method is invoked as the result of posting a PXSLItemDidCollapseNotification.

The item that was collapsed is contained in notification's userInfo dictionary, as the value of the @"NSObject" key.

Availability

Available in Mac OS X v10.5 and later

See Also
Declared In
PXSourceListDelegate.h

sourceListDeleteKeyPressedOnRows:

Invoked whenever the delete key is pressed on a row in the Source List.

- (void)sourceListDeleteKeyPressedOnRows:(NSNotification *)notification
Parameters
notification

The associated NSNotification object

Discussion

This method is invoked as the result of posting a PXSLDeleteKeyPressedOnRowsNotification. The notification is posted when the number of selected rows in the Source List is greater than 0, and the backspace key or Cmd+backspace is pressed.

The row indexes that were selected when the delete key was pressed are contained in an NSIndexSet which can be found in the notification's userInfo dictionary, which is the value for the @"rows" key.

Availability

Available in Mac OS X v10.5 and later

Declared In
PXSourceListDelegate.h

Last updated: 2010-01-09
Back to index / hierarchy.