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
-
- sourceListSelectionIsChanging:
Invoked when the Source List's selection changes. -
- sourceListSelectionDidChange:
Invoked immediately after the Source List's selection has changed.
Item Expanding/Collapsing
-
- sourceListItemWillExpand:
Invoked whenever the user is about to expand an item in the Source List. -
- sourceListItemDidExpand:
Invoked when an item in the Source List is expanded. -
- sourceListItemWillCollapse:
Invoked whenever the user is about to collapse an item in the Source List. -
- sourceListItemDidCollapse:
Invoked when an item in the Source List is collapsed.
Delete Key Handling
-
- sourceListDeleteKeyPressedOnRows:
Invoked whenever the delete key is pressed on a row in the Source List.
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