Mac Developer Library

Developer

AppKit Framework Reference NSBrowser Class Reference

Options
Deployment Target:

On This Page
Language:

NSBrowser

This class provides a user interface for displaying and selecting items from a list of data or from hierarchically organized lists of data such as directory paths. Instances of this class are known as browsers. When working with a hierarchy of data, the levels are displayed in columns, which are indexed from left to right. More...

Import Statement


import AppKit @import AppKit;

Availability


Available in OS X v10.0 and later.
  • Indicates whether the browser reuses matrix objects after their columns are unloaded.

    Declaration

    Swift

    var reusesColumns: Bool

    Objective-C

    @property BOOL reusesColumns

    Return Value

    YEStrue if NSMatrix objects aren't freed when their columns are unloaded; otherwise, NOfalse.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.0 and later.

  • Specifies whether matrices can be reused.

    Declaration

    Swift

    var reusesColumns: Bool

    Objective-C

    @property BOOL reusesColumns

    Parameters

    flag

    YEStrue to prevent NSMatrix objects from being freed when their columns are unloaded, so they can be reused; otherwise, NOfalse.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.0 and later.

  • Returns the maximum number of visible columns.

    Declaration

    Swift

    var maxVisibleColumns: Int

    Objective-C

    @property NSInteger maxVisibleColumns

    Return Value

    The maximum number of visible columns.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.0 and later.

  • Sets the maximum number of columns that can be displayed.

    Declaration

    Swift

    var maxVisibleColumns: Int

    Objective-C

    @property NSInteger maxVisibleColumns

    Parameters

    columnCount

    The maximum number of visible columns.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.0 and later.

  • Returns whether the browser automatically hides its scroller.

    Declaration

    Swift

    var autohidesScroller: Bool

    Objective-C

    @property BOOL autohidesScroller

    Return Value

    YEStrue if the scroller is automatically hidden; otherwise, NOfalse.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.6 and later.

  • Allows the browser to hide its scroller automatically.

    Declaration

    Swift

    var autohidesScroller: Bool

    Objective-C

    @property BOOL autohidesScroller

    Parameters

    flag

    If YEStrue, the browser hides its scroller automatically; if NOfalse, it does not.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.6 and later.

  • Provides the browser’s background color.

    Declaration

    Swift

    var backgroundColor: NSColor

    Objective-C

    @property(strong) NSColor *backgroundColor

    Return Value

    The browser’s background color.

    Discussion

    The default value is [NSColor whiteColor]

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.5 and later.

  • Specifies the browser’s background color.

    Declaration

    Swift

    var backgroundColor: NSColor

    Objective-C

    @property(strong) NSColor *backgroundColor

    Parameters

    backgroundColor

    [NSColor clearColor] specifies a transparent background.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.5 and later.

  • Returns the minimum column width.

    Declaration

    Swift

    var minColumnWidth: CGFloat

    Objective-C

    @property CGFloat minColumnWidth

    Return Value

    The minimum column width, in pixels.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.0 and later.

  • Sets the minimum column width.

    Declaration

    Swift

    var minColumnWidth: CGFloat

    Objective-C

    @property CGFloat minColumnWidth

    Parameters

    columnWidth

    The minimum column width, in pixels.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.0 and later.

  • Indicates whether columns are separated by bezeled borders.

    Declaration

    Swift

    var separatesColumns: Bool

    Objective-C

    @property BOOL separatesColumns

    Return Value

    YEStrue if the browser's columns are separated by bezeled borders; otherwise, NOfalse.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.0 and later.

  • Separates columns with bezeled borders.

    Declaration

    Swift

    var separatesColumns: Bool

    Objective-C

    @property BOOL separatesColumns

    Parameters

    flag

    YEStrue if the browser's columns should be separated by bezeled borders; otherwise, NOfalse. This value is ignored if isTitled does not return NOfalse.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.0 and later.

  • Indicates whether a column takes its title from the selected cell in the previous column.

    Declaration

    Swift

    var takesTitleFromPreviousColumn: Bool

    Objective-C

    @property BOOL takesTitleFromPreviousColumn

    Return Value

    YEStrue if the title of a column is set to the string value of the selected NSCell in the previous column; otherwise, NOfalse.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.0 and later.

  • Sets whether the title of a column is set to the string value of the selected cell in the previous column.

    Declaration

    Swift

    var takesTitleFromPreviousColumn: Bool

    Objective-C

    @property BOOL takesTitleFromPreviousColumn

    Parameters

    flag

    YEStrue if the title of a column should be set to the string value of the selected NSCell in the previous column; otherwise, NOfalse.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.0 and later.

  • Adjusts the various subviews of the browser—scrollers, columns, titles, and so on—without redrawing.

    Declaration

    Swift

    func tile()

    Objective-C

    - (void)tile

    Discussion

    Your code shouldn’t send this message. It’s invoked any time the appearance of the browser changes.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.0 and later.

  • Indicates whether the browser allows navigation using the arrow keys.

    Deprecation Statement

    There is no replacement.

    Declaration

    Objective-C

    - (BOOL)acceptsArrowKeys

    Return Value

    YEStrue if the arrow keys are enabled; otherwise, NOfalse.

    Import Statement

    Availability

    Available in OS X v10.0 and later.

    Deprecated in OS X v10.6.

  • Specifies whether the browser allows navigation using the arrow keys.

    Deprecation Statement

    There is no replacement.

    Declaration

    Objective-C

    - (void)setAcceptsArrowKeys:(BOOL)flag

    Parameters

    flag

    YEStrue to enable the use of the arrow keys for navigating within and between browsers; otherwise, NOfalse.

    Import Statement

    Availability

    Available in OS X v10.0 and later.

    Deprecated in OS X v10.6.

  • Returns the browser’s delegate.

    Declaration

    Swift

    unowned(unsafe) var delegate: NSBrowserDelegate?

    Objective-C

    @property(assign) id<NSBrowserDelegate> delegate

    Return Value

    The browser's delegate.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.0 and later.

  • Sets the browser’s delegate.

    Declaration

    Swift

    unowned(unsafe) var delegate: NSBrowserDelegate?

    Objective-C

    @property(assign) id<NSBrowserDelegate> delegate

    Parameters

    anObject

    The object to set at the browser's delegate.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.0 and later.

    See Also

    – delegate

  • Indicates whether the browser is opaque.

    Declaration

    Objective-C

    - (BOOL)isOpaque

    Return Value

    YEStrue when the browser doesn’t have a title and its background color’s alpha component is 1.0; otherwise, NOfalse.

    Discussion

    This method overrides the isOpaque method of NSView.

    Import Statement

  • Returns the NSBrowserCell class.

    Declaration

    Swift

    class func cellClass() -> AnyClass

    Objective-C

    + (Class)cellClass

    Return Value

    Always returns the NSBrowserCell class (even if the developer has sent a setCellClass: message to a particular instance).

    Discussion

    This method is used by NSControl during initialization and is not meant to be used by applications.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.0 and later.

  • Sets the class of the cell to be used by the matrices in the columns of the browser.

    Declaration

    Swift

    func setCellClass(_ factoryId: AnyClass)

    Objective-C

    - (void)setCellClass:(Class)factoryId

    Parameters

    factoryId

    The class of NSCell used by the matrices in the columns of the browser. This method creates an instance of the class and calls setCellPrototype:.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.0 and later.

  • Returns the browser’s prototype NSCell.

    Declaration

    Swift

    var cellPrototype: AnyObject!

    Objective-C

    @property(strong) id cellPrototype

    Return Value

    The prototype NSCell. The prototype NSCell instance is copied to display items in the matrices of the browser.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.0 and later.

  • Sets the prototype cell for displaying items in the matrices in the columns of the browser.

    Declaration

    Swift

    var cellPrototype: AnyObject!

    Objective-C

    @property(strong) id cellPrototype

    Parameters

    aCell

    The prototype NSCell instance.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.0 and later.

  • matrixClass() matrixClass (OS X v10.10)

    Returns the matrix class used in the browser’s columns.

    Declaration

    Swift

    func matrixClass() -> AnyClass

    Objective-C

    - (Class)matrixClass

    Return Value

    The class of NSMatrix used in the browser's columns.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.0 and later.

    Deprecated in OS X v10.10.

  • Sets the matrix class to be used in the browser’s columns.

    Declaration

    Swift

    func setMatrixClass(_ factoryId: AnyClass)

    Objective-C

    - (void)setMatrixClass:(Class)factoryId

    Parameters

    factoryId

    The matrix class (NSMatrix or an NSMatrix subclass) used in the browser's columns.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.0 and later.

    Deprecated in OS X v10.10.

    See Also

    – matrixClass

  • Indicates whether the user can select branch items.

    Declaration

    Swift

    var allowsBranchSelection: Bool

    Objective-C

    @property BOOL allowsBranchSelection

    Return Value

    YEStrue if the user can select branch items when multiple selection is enabled; otherwise, NOfalse.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.0 and later.

  • Allows the user to select branch items.

    Declaration

    Swift

    var allowsBranchSelection: Bool

    Objective-C

    @property BOOL allowsBranchSelection

    Parameters

    flag

    YEStrue if the user can select branch items when multiple selection is enabled; otherwise, NOfalse.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.0 and later.

  • Indicates whether there can be nothing selected.

    Declaration

    Swift

    var allowsEmptySelection: Bool

    Objective-C

    @property BOOL allowsEmptySelection

    Return Value

    YEStrue if the browser allows the selection to be empty; otherwise, NOfalse.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.0 and later.

  • Allows the user to select nothing.

    Declaration

    Swift

    var allowsEmptySelection: Bool

    Objective-C

    @property BOOL allowsEmptySelection

    Parameters

    flag

    YEStrue if the browser allows an empty selection; otherwise, NOfalse.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.0 and later.

  • Indicates whether the user can select multiple items.

    Declaration

    Swift

    var allowsMultipleSelection: Bool

    Objective-C

    @property BOOL allowsMultipleSelection

    Return Value

    YEStrue if the browser allows the user to select multiple items at once; otherwise, NOfalse.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.0 and later.

  • Allows the user to select multiple items.

    Declaration

    Swift

    var allowsMultipleSelection: Bool

    Objective-C

    @property BOOL allowsMultipleSelection

    Parameters

    flag

    YEStrue if the user can select multiple items at once; otherwise, NOfalse.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.0 and later.

  • Provides the indexes of the selected rows in a given column of the browser.

    Declaration

    Swift

    func selectedRowIndexesInColumn(_ columnIndex: Int) -> NSIndexSet?

    Objective-C

    - (NSIndexSet *)selectedRowIndexesInColumn:(NSInteger)columnIndex

    Parameters

    columnIndex

    The column whose selected rows are provided.

    Return Value

    Rows selected in column columnIndex.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.5 and later.

  • Specifies the selected rows in a given column of the browser.

    Declaration

    Swift

    func selectRowIndexes(_ rowIndexes: NSIndexSet, inColumn columnIndex: Int)

    Objective-C

    - (void)selectRowIndexes:(NSIndexSet *)rowIndexes inColumn:(NSInteger)columnIndex

    Parameters

    rowIndexes

    Rows to be selected in column columnIndex.

    columnIndex

    Column in which to select rows rowIndexes.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.5 and later.

  • Indicates whether the browser allows keystroke-based selection (type select).

    Declaration

    Swift

    var allowsTypeSelect: Bool

    Objective-C

    @property BOOL allowsTypeSelect

    Return Value

    YEStrue (default) when the browser allows keystroke-based selection; otherwise, NOfalse.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.5 and later.

  • Allows the browser to accept keystroke-based selection.

    Declaration

    Swift

    var allowsTypeSelect: Bool

    Objective-C

    @property BOOL allowsTypeSelect

    Parameters

    allowsTypeSelection

    YEStrue to allow type selection; NOfalse to disallow it.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.5 and later.

  • Returns the last (rightmost and lowest) selected cell.

    Declaration

    Objective-C

    @property(readonly, strong) id selectedCell

    Return Value

    The selected cell (NSCell). Returns nil if there is no selection.

    Import Statement

    Availability

    Available in OS X v10.0 and later.

  • Returns the last (lowest) cell selected in the given column.

    Declaration

    Swift

    func selectedCellInColumn(_ column: Int) -> AnyObject?

    Objective-C

    - (id)selectedCellInColumn:(NSInteger)column

    Parameters

    column

    The column whose last selected cell is to be returned.

    Return Value

    The last (or lowest) selected cell. Returns nil if there is no selection.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.0 and later.

  • Returns all cells selected in the rightmost column.

    Declaration

    Swift

    var selectedCells: [AnyObject]? { get }

    Objective-C

    @property(readonly, copy) NSArray *selectedCells

    Return Value

    An array of NSCell objects representing the selected cells in the rightmost browser column. Returns an empty array if there is no selection.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.0 and later.

  • Selects all cells in the last column of the browser.

    Declaration

    Swift

    func selectAll(_ sender: AnyObject?)

    Objective-C

    - (void)selectAll:(id)sender

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.0 and later.

  • Returns the row index of the selected cell in the specified column.

    Declaration

    Swift

    func selectedRowInColumn(_ column: Int) -> Int

    Objective-C

    - (NSInteger)selectedRowInColumn:(NSInteger)column

    Parameters

    column

    The column index specifying the column for which to return the selected row.

    Return Value

    The row index of the selected cell in the specified column. Returns -1 if there is no selection.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.0 and later.

  • Selects the cell at the specified row and column index.

    Declaration

    Swift

    func selectRow(_ row: Int, inColumn column: Int)

    Objective-C

    - (void)selectRow:(NSInteger)row inColumn:(NSInteger)column

    Parameters

    row

    The row index of the cell to select.

    column

    The column index of the cell to select.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.0 and later.

  • Returns the index path of the item selected in the browser.

    Declaration

    Swift

    @NSCopying var selectionIndexPath: NSIndexPath

    Objective-C

    @property(copy) NSIndexPath *selectionIndexPath

    Return Value

    The index path of the selected item, or nil if there is no selection.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.6 and later.

  • Sets the browser’s selection to the item with the specified path.

    Declaration

    Swift

    @NSCopying var selectionIndexPath: NSIndexPath

    Objective-C

    @property(copy) NSIndexPath *selectionIndexPath

    Parameters

    path

    The path of the item to select.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.6 and later.

  • Returns an array containing the index paths of all items selected in the browser.

    Declaration

    Swift

    var selectionIndexPaths: [AnyObject]

    Objective-C

    @property(copy) NSArray *selectionIndexPaths

    Return Value

    The array containing the index paths of the selected items.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.6 and later.

  • Sets the browser’s selection to the items whose index paths are in the specified array.

    Declaration

    Swift

    var selectionIndexPaths: [AnyObject]

    Objective-C

    @property(copy) NSArray *selectionIndexPaths

    Parameters

    paths

    The array containing the index paths of the items to select.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.6 and later.

  • Loads, if necessary, and returns the cell at the specified row and column location.

    Declaration

    Swift

    func loadedCellAtRow(_ row: Int, column column: Int) -> AnyObject?

    Objective-C

    - (id)loadedCellAtRow:(NSInteger)row column:(NSInteger)column

    Parameters

    row

    The row index of the cell to return.

    column

    The column index of the cell to return.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.0 and later.

  • Returns the matrix located in the specified column.

    Declaration

    Swift

    func matrixInColumn(_ column: Int) -> NSMatrix?

    Objective-C

    - (NSMatrix *)matrixInColumn:(NSInteger)column

    Parameters

    column

    The column index of the matrix to obtain.

    Return Value

    The matrix located in the column.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.0 and later.

    Deprecated in OS X v10.10.

  • Begins editing the item at the specified path.

    Declaration

    Swift

    func editItemAtIndexPath(_ indexPath: NSIndexPath, withEvent theEvent: NSEvent, select select: Bool)

    Objective-C

    - (void)editItemAtIndexPath:(NSIndexPath *)indexPath withEvent:(NSEvent *)theEvent select:(BOOL)select

    Parameters

    indexPath

    The path of the item.

    theEvent

    The event to use when beginning the edit.

    select

    If YEStrue, the cells contents will be selected; if NOfalse, they will not be selected.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.6 and later.

  • Returns the item at the specified index path.

    Declaration

    Swift

    func itemAtIndexPath(_ indexPath: NSIndexPath) -> AnyObject?

    Objective-C

    - (id)itemAtIndexPath:(NSIndexPath *)indexPath

    Parameters

    indexPath

    The index path of the item to return.

    Return Value

    The item.

    Discussion

    This method can only be used if the delegate implements the item data source methods. The specified index path must be displayable in the browser.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.6 and later.

  • Returns the item located at the specified row and column.

    Declaration

    Swift

    func itemAtRow(_ row: Int, inColumn column: Int) -> AnyObject?

    Objective-C

    - (id)itemAtRow:(NSInteger)row inColumn:(NSInteger)column

    Parameters

    row

    The row of the item.

    column

    The column of the item.

    Return Value

    The item.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.6 and later.

  • Returns the index path of the item whose children are displayed in the given column.

    Declaration

    Swift

    func indexPathForColumn(_ column: Int) -> NSIndexPath

    Objective-C

    - (NSIndexPath *)indexPathForColumn:(NSInteger)column

    Parameters

    column

    The column to find the index path for.

    Return Value

    The index path of the column.

    Discussion

    This method can only be used if the delegate implements the item data source methods.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.6 and later.

  • Returns whether the specified item is a leaf item.

    Declaration

    Swift

    func isLeafItem(_ item: AnyObject?) -> Bool

    Objective-C

    - (BOOL)isLeafItem:(id)item

    Parameters

    item

    The item to be checked.

    Return Value

    YEStrue if the item is a leaf item; otherwise, NOfalse.

    Discussion

    This method may return NOfalse if the item has never been displayed in the browser or accessed via itemAtIndexPath:. Overriding this method has no effect. It may be used only if the browser’s delegate implements the item data source methods.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.6 and later.

  • Returns the item that contains the children located in the specified column.

    Declaration

    Swift

    func parentForItemsInColumn(_ column: Int) -> AnyObject?

    Objective-C

    - (id)parentForItemsInColumn:(NSInteger)column

    Parameters

    column

    The column.

    Return Value

    The parent item for the specified column.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.6 and later.

  • Returns a string representing the browser’s current path.

    Declaration

    Swift

    func path() -> String

    Objective-C

    - (NSString *)path

    Return Value

    The path representing the current selection. The components of this path are separated with the string returned by pathSeparator.

    Discussion

    Invoking this method is equivalent to invoking pathToColumn: for all columns.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.0 and later.

  • Sets the path to be displayed by the browser.

    Declaration

    Swift

    func setPath(_ path: String) -> Bool

    Objective-C

    - (BOOL)setPath:(NSString *)path

    Parameters

    path

    The path to display. If path is prefixed by the path separator, the path is absolute, containing the full path from the browser’s first column. Otherwise, the path is relative, extending the browser’s current path starting at the last column.

    Return Value

    YEStrue if the given path is valid; otherwise, NOfalse.

    Discussion

    While parsing path, the browser compares each component with the entries in the current column. If an exact match is found, the matching entry is selected, and the next component is compared to the next column’s entries. If no match is found for a component, the method exits and returns NOfalse; the final path is set to the valid portion of path. If each component of path specifies a valid branch or leaf in the browser’s hierarchy, the method returns YEStrue.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.0 and later.

  • Returns a string representing the path from the first column up to, but not including, the column at the given index.

    Declaration

    Swift

    func pathToColumn(_ column: Int) -> String

    Objective-C

    - (NSString *)pathToColumn:(NSInteger)column

    Parameters

    column

    The index of the column at which the path stops.

    Return Value

    The path of the current selection up to, but not including, the specified column. The components of this path are separated with the string returned by pathSeparator.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.0 and later.

  • Returns the path separator.

    Declaration

    Swift

    var pathSeparator: String

    Objective-C

    @property(copy) NSString *pathSeparator

    Return Value

    The path separator. The default is “/”.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.0 and later.

  • Sets the path separator.

    Declaration

    Swift

    var pathSeparator: String

    Objective-C

    @property(copy) NSString *pathSeparator

    Parameters

    newString

    The new path separator.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.0 and later.

  • Adds a column to the right of the last column.

    Declaration

    Swift

    func addColumn()

    Objective-C

    - (void)addColumn

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.0 and later.

  • Updates the browser to display all loaded columns.

    Deprecation Statement

    Use setNeedsDisplayInRect:

    Declaration

    Objective-C

    - (void)displayAllColumns

    Import Statement

    Availability

    Available in OS X v10.0 and later.

    Deprecated in OS X v10.3.

  • Updates the browser to display the given column.

    Deprecation Statement

    Use setNeedsDisplayInRect: instead.

    Declaration

    Objective-C

    - (void)displayColumn:(NSInteger)column

    Parameters

    column

    The index of the column to display.

    Import Statement

    Availability

    Available in OS X v10.0 and later.

    Deprecated in OS X v10.3.

  • Returns the column number in which the given matrix is located.

    Declaration

    Swift

    func columnOfMatrix(_ matrix: NSMatrix) -> Int

    Objective-C

    - (NSInteger)columnOfMatrix:(NSMatrix *)matrix

    Parameters

    matrix

    The matrix for which to return the column number.

    Return Value

    The index of the column in which the specified matrix appears.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.0 and later.

    Deprecated in OS X v10.10.

  • Returns the index of the last column with a selected item.

    Declaration

    Swift

    var selectedColumn: Int { get }

    Objective-C

    @property(readonly) NSInteger selectedColumn

    Return Value

    The index of the last column with a selected item, or -1 if there is no column selected.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.0 and later.

  • Returns the index of the last column loaded.

    Declaration

    Swift

    var lastColumn: Int

    Objective-C

    @property NSInteger lastColumn

    Return Value

    The index of the last loaded column.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.0 and later.

  • Sets the last column.

    Declaration

    Swift

    var lastColumn: Int

    Objective-C

    @property NSInteger lastColumn

    Parameters

    column

    The index of the last column.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.0 and later.

    See Also

    – lastColumn

  • Returns the index of the first visible column.

    Declaration

    Swift

    var firstVisibleColumn: Int { get }

    Objective-C

    @property(readonly) NSInteger firstVisibleColumn

    Return Value

    The index of the first visible column.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.0 and later.

  • Returns the number of columns that are visible.

    Declaration

    Swift

    var numberOfVisibleColumns: Int { get }

    Objective-C

    @property(readonly) NSInteger numberOfVisibleColumns

    Return Value

    The number of visible columns.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.0 and later.

  • Returns the index of the last visible column.

    Declaration

    Swift

    var lastVisibleColumn: Int { get }

    Objective-C

    @property(readonly) NSInteger lastVisibleColumn

    Return Value

    The index of the last visible column.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.0 and later.

  • Validates the browser’s visible columns.

    Declaration

    Swift

    func validateVisibleColumns()

    Objective-C

    - (void)validateVisibleColumns

    Discussion

    This method invokes the delegate method browser:isColumnValid:

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.0 and later.

  • isLoaded isLoaded Available in OS X v10.0 through OS X v10.9

    Returns whether column 0 is loaded.

    Declaration

    Objective-C

    - (BOOL)isLoaded

    Return Value

    YEStrue if column 0 is loaded; otherwise, NOfalse.

    Import Statement

    Availability

    Available in OS X v10.0 through OS X v10.9.

  • Loads column 0; unloads previously loaded columns.

    Declaration

    Swift

    func loadColumnZero()

    Objective-C

    - (void)loadColumnZero

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.0 and later.

  • Reloads the given column.

    Declaration

    Swift

    func reloadColumn(_ column: Int)

    Objective-C

    - (void)reloadColumn:(NSInteger)column

    Parameters

    column

    The index of the column to reload.

    Discussion

    If after reloading the selected item no longer exists in the column, the column is set to be the last column.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.0 and later.

  • Returns the title displayed for the given column.

    Declaration

    Swift

    func titleOfColumn(_ column: Int) -> String?

    Objective-C

    - (NSString *)titleOfColumn:(NSInteger)column

    Parameters

    column

    The index of the column for which to get the title.

    Return Value

    The title of the specified column.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.0 and later.

  • Sets the title of the given column.

    Declaration

    Swift

    func setTitle(_ aString: String, ofColumn column: Int)

    Objective-C

    - (void)setTitle:(NSString *)aString ofColumn:(NSInteger)column

    Parameters

    aString

    The title of the column.

    column

    The index of the column whose title should be set.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.0 and later.

  • isTitled isTitled Available in OS X v10.0 through OS X v10.9

    Indicates whether columns display titles.

    Declaration

    Objective-C

    - (BOOL)isTitled

    Return Value

    YEStrue if the columns in a browser display titles; otherwise, NOfalse.

    Import Statement

    Availability

    Available in OS X v10.0 through OS X v10.9.

    See Also

    – setTitled:

  • Sets columns to display titles.

    Declaration

    Swift

    var titled: Bool

    Objective-C

    @property(getter=isTitled) BOOL titled

    Parameters

    flag

    YEStrue if the columns in a browser display titles; otherwise, NOfalse.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.0 and later.

    See Also

    – isTitled

  • Draws the title for the specified column within the given rectangle.

    Declaration

    Swift

    func drawTitleOfColumn(_ column: Int, inRect aRect: NSRect)

    Objective-C

    - (void)drawTitleOfColumn:(NSInteger)column inRect:(NSRect)aRect

    Parameters

    column

    The index of the column for which to draw the title.

    aRect

    The rectangle within which to draw the title.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.0 and later.

  • Returns the height of the column titles.

    Declaration

    Swift

    var titleHeight: CGFloat { get }

    Objective-C

    @property(readonly) CGFloat titleHeight

    Return Value

    The height of the column titles for the browser.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.0 and later.

  • Returns the bounds of the title frame for the specified column.

    Declaration

    Swift

    func titleFrameOfColumn(_ column: Int) -> NSRect

    Objective-C

    - (NSRect)titleFrameOfColumn:(NSInteger)column

    Parameters

    column

    The index of the column for which to return the title frame.

    Return Value

    The rectangle specifying the bounds of the column's title frame.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.0 and later.

  • Immediately retiles the browser’s columns using row heights specified by the browser’s delegate.

    Declaration

    Swift

    func noteHeightOfRowsWithIndexesChanged(_ indexSet: NSIndexSet, inColumn columnIndex: Int)

    Objective-C

    - (void)noteHeightOfRowsWithIndexesChanged:(NSIndexSet *)indexSet inColumn:(NSInteger)columnIndex

    Parameters

    indexSet

    The indexes of the rows to resize.

    columnIndex

    The column to retile.

    Discussion

    The browser’s delegate must implement

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.6 and later.

  • Updates the rows in the column with the specified column index with indexes in the specified set.

    Declaration

    Swift

    func reloadDataForRowIndexes(_ rowIndexes: NSIndexSet, inColumn column: Int)

    Objective-C

    - (void)reloadDataForRowIndexes:(NSIndexSet *)rowIndexes inColumn:(NSInteger)column

    Parameters

    rowIndexes

    The set of row indexes of the rows to be updated.

    column

    The column containing the rows to be updated.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.6 and later.

  • Updates the horizontal scroller to reflect column positions.

    Deprecation Statement

    There is no replacement.

    Declaration

    Objective-C

    - (void)updateScroller

    Import Statement

    Availability

    Available in OS X v10.0 and later.

    Deprecated in OS X v10.3.

  • Indicates whether the browser has a horizontal scroller.

    Declaration

    Swift

    var hasHorizontalScroller: Bool

    Objective-C

    @property BOOL hasHorizontalScroller

    Return Value

    YEStrue if the browser uses an NSScroller object to scroll horizontally; otherwise, NOfalse.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.0 and later.

  • Sets whether the browser has a scroller to scroll horizontally.

    Declaration

    Swift

    var hasHorizontalScroller: Bool

    Objective-C

    @property BOOL hasHorizontalScroller

    Parameters

    flag

    YEStrue if the browser uses an NSScroller object to scroll horizontally; otherwise, NOfalse.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.0 and later.

  • Scrolls to make the specified column visible.

    Declaration

    Swift

    func scrollColumnToVisible(_ column: Int)

    Objective-C

    - (void)scrollColumnToVisible:(NSInteger)column

    Parameters

    column

    The index of the column to scroll to.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.0 and later.

  • Scrolls columns left by the specified number of columns.

    Declaration

    Swift

    func scrollColumnsLeftBy(_ shiftAmount: Int)

    Objective-C

    - (void)scrollColumnsLeftBy:(NSInteger)shiftAmount

    Parameters

    shiftAmount

    The number of columns by which to scroll the browser.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.0 and later.

  • Scrolls columns right by the specified number of columns.

    Declaration

    Swift

    func scrollColumnsRightBy(_ shiftAmount: Int)

    Objective-C

    - (void)scrollColumnsRightBy:(NSInteger)shiftAmount

    Parameters

    shiftAmount

    The number of columns by which to scroll the browser.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.0 and later.

  • Scrolls the specified row to be visible within the specified column.

    Declaration

    Swift

    func scrollRowToVisible(_ row: Int, inColumn column: Int)

    Objective-C

    - (void)scrollRowToVisible:(NSInteger)row inColumn:(NSInteger)column

    Parameters

    row

    The index of the row to scroll.

    column

    The index of the column containing the row to scroll.

    Discussion

    The row’s column will not be scrolled to visible via this method. To scroll the column to visible, use scrollColumnToVisible:.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.6 and later.

  • Scrolls columns left or right based on an NSScroller.

    Deprecation Statement

    There is no replacement.

    Declaration

    Objective-C

    - (void)scrollViaScroller:(NSScroller *)sender

    Parameters

    sender

    The NSScroller object that determines the scrolling of the browser columns.

    Import Statement

    Availability

    Available in OS X v10.0 and later.

    Deprecated in OS X v10.3.

  • Returns the rectangle containing the given column.

    Declaration

    Swift

    func frameOfColumn(_ column: Int) -> NSRect

    Objective-C

    - (NSRect)frameOfColumn:(NSInteger)column

    Parameters

    column

    The index of the column for which to retrieve the frame.

    Return Value

    The rectangle containing the specified column.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.0 and later.

  • Returns the rectangle containing the specified column, not including borders.

    Declaration

    Swift

    func frameOfInsideOfColumn(_ column: Int) -> NSRect

    Objective-C

    - (NSRect)frameOfInsideOfColumn:(NSInteger)column

    Parameters

    column

    The index of the column for which to retrieve the inside frame.

    Return Value

    The rectangle containing the column, not including the column borders.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.0 and later.

  • Returns the frame of the cell at the specified location, including the expandable arrow.

    Declaration

    Swift

    func frameOfRow(_ row: Int, inColumn column: Int) -> NSRect

    Objective-C

    - (NSRect)frameOfRow:(NSInteger)row inColumn:(NSInteger)column

    Parameters

    row

    The row of the cell.

    column

    The column of the cell.

    Return Value

    The frame of the cell, in the NSBrowser coordinate space.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.6 and later.

  • Gets the row and column coordinates for the specified point, if a cell exists at that point.

    Declaration

    Swift

    func getRow(_ row: UnsafeMutablePointer<Int>, column column: UnsafeMutablePointer<Int>, forPoint point: NSPoint) -> Bool

    Objective-C

    - (BOOL)getRow:(NSInteger *)row column:(NSInteger *)column forPoint:(NSPoint)point

    Parameters

    row

    On output, the row number of the cell at the specified point, or -1 if there is no cell at the point.

    column

    On output, he column number of the cell at the specified point, or -1 if there is no cell at the point.

    point

    The point to test.

    Return Value

    YEStrue if a cell exists at the specified point; otherwise, NOfalse.

    Discussion

    If a row does not exist at point, then -1 is set for the row. If a column does not exist at point, then -1 is set for the column.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.6 and later.

  • Returns the browser’s double-click action method.

    Declaration

    Swift

    var doubleAction: Selector

    Objective-C

    @property SEL doubleAction

    Return Value

    The action method invoked when the user double-clicks on the browser.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.0 and later.

  • Sets the browser’s double-click action.

    Declaration

    Swift

    var doubleAction: Selector

    Objective-C

    @property SEL doubleAction

    Parameters

    aSelector

    The action method to invoke when the browser is double-clicked.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.0 and later.

  • Returns whether pressing an arrow key causes an action message to be sent.

    Declaration

    Swift

    var sendsActionOnArrowKeys: Bool

    Objective-C

    @property BOOL sendsActionOnArrowKeys

    Return Value

    NOfalse if pressing an arrow key scrolls the browser; YEStrue if it also sends the action message specified by setAction:.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.0 and later.

  • Allows the specified action message to be sent when the user presses an arrow key.

    Declaration

    Swift

    var sendsActionOnArrowKeys: Bool

    Objective-C

    @property BOOL sendsActionOnArrowKeys

    Parameters

    flag

    YEStrue if pressing an arrow key should send the action message specified by setAction: in addition to scrolling the browser; NOfalse if it should only scroll the browser.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.0 and later.

  • Sends the action message to the target.

    Declaration

    Swift

    var sendAction: Bool { get }

    Objective-C

    @property(readonly) BOOL sendAction

    Return Value

    YEStrue if successful; NOfalse if no target for the message could be found.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.0 and later.

  • Responds to (single) mouse clicks in a column of the browser.

    Declaration

    Swift

    func doClick(_ sender: AnyObject?)

    Objective-C

    - (void)doClick:(id)sender

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.0 and later.

    See Also

    – sendAction

  • Responds to double clicks in a column of the browser.

    Declaration

    Swift

    func doDoubleClick(_ sender: AnyObject?)

    Objective-C

    - (void)doDoubleClick:(id)sender

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.0 and later.

  • Returns the column number of the cell that the user clicked to display a context menu.

    Declaration

    Swift

    var clickedColumn: Int { get }

    Objective-C

    @property(readonly) NSInteger clickedColumn

    Return Value

    The column number of the clicked cell, or -1 if no context menu is active.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.6 and later.

    See Also

    – clickedRow

  • Returns the row number of the cell that the user clicked to display a context menu.

    Declaration

    Swift

    var clickedRow: Int { get }

    Objective-C

    @property(readonly) NSInteger clickedRow

    Return Value

    The row number of the clicked cell, or -1 if no context menu is active.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.6 and later.

  • Removes the column configuration data stored under the given name from the application’s user defaults.

    Declaration

    Swift

    class func removeSavedColumnsWithAutosaveName(_ name: String)

    Objective-C

    + (void)removeSavedColumnsWithAutosaveName:(NSString *)name

    Parameters

    name

    The name of the column configuration data to remove.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.3 and later.

  • Returns the name used to automatically save the browser’s column configuration.

    Declaration

    Swift

    var columnsAutosaveName: String

    Objective-C

    @property(copy) NSString *columnsAutosaveName

    Return Value

    The name used to save the column configuration.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.3 and later.

  • Sets the name used to automatically save the browser’s column configuration.

    Declaration

    Swift

    var columnsAutosaveName: String

    Objective-C

    @property(copy) NSString *columnsAutosaveName

    Parameters

    name

    The name used to save the column configuration. If name is different from the current name, this method also reads in any column configuration data previously saved under name and applies the values to the browser.

    Discussion

    Column configuration is defined as an array of column content widths. One width is saved for each level the user has reached. That is, the browser saves column width based on depth, not on unique paths. To do more complex column persistence, you should register for NSBrowserColumnConfigurationDidChangeNotification and handle persistence yourself. This setting is persistent.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.3 and later.

  • Returns the content width for a given column width.

    Declaration

    Swift

    func columnContentWidthForColumnWidth(_ columnWidth: CGFloat) -> CGFloat

    Objective-C

    - (CGFloat)columnContentWidthForColumnWidth:(CGFloat)columnWidth

    Parameters

    columnWidth

    The width of the column. This width is the entire scrolling text view.

    Return Value

    The width of the content for the column. This is the width of the matrix in the column.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.3 and later.

  • Returns the column width for the width of the given column’s content.

    Declaration

    Swift

    func columnWidthForColumnContentWidth(_ columnContentWidth: CGFloat) -> CGFloat

    Objective-C

    - (CGFloat)columnWidthForColumnContentWidth:(CGFloat)columnContentWidth

    Parameters

    columnContentWidth

    The width of the column's content (the width of the the matrix in the column).

    Return Value

    The width of the column (the width of the entire scrolling text view).

    Discussion

    For example, to guarantee that 16 pixels of your browser cell are always visible, call:

    • [browser setMinColumnWidth: [browser columnWidthForColumnContentWidth:16]]

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.3 and later.

  • Returns the browser’s column resizing type.

    Declaration

    Swift

    var columnResizingType: NSBrowserColumnResizingType

    Objective-C

    @property NSBrowserColumnResizingType columnResizingType

    Return Value

    A constant indicating the column resizing type. Possible return values are described in “NSBrowserColumnResizingType”. The default is NSBrowserAutoColumnResizing

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.3 and later.

  • Sets the browser’s column resizing type.

    Declaration

    Swift

    var columnResizingType: NSBrowserColumnResizingType

    Objective-C

    @property NSBrowserColumnResizingType columnResizingType

    Parameters

    columnResizingType

    The column resizing type. Possible values are described in “NSBrowserColumnResizingType”. The default is NSBrowserAutoColumnResizing. This setting is persistent.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.3 and later.

  • Returns whether the browser is set to resize all columns simultaneously rather than resizing a single column at a time.

    Declaration

    Swift

    var prefersAllColumnUserResizing: Bool

    Objective-C

    @property BOOL prefersAllColumnUserResizing

    Return Value

    YEStrue if the browser is set to resize all columns simultaneously; otherwise, NOfalse. The default is NOfalse.

    Discussion

    This setting applies only to browsers that allow the user to resize columns (see the constant NSBrowserUserColumnResizing. Holding down the Option key while resizing switches the type of resizing used.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.3 and later.

  • Causes the browser to resize all column simultaneously rather than resize a single column at a time.

    Declaration

    Swift

    var prefersAllColumnUserResizing: Bool

    Objective-C

    @property BOOL prefersAllColumnUserResizing

    Parameters

    prefersAllColumnResizing

    YEStrue to cause the browser to resize all columns simultaneously; the default is single column resizing (NOfalse). This setting applies only to browsers that allow the user to resize columns (see NSBrowserUserColumnResizing. Holding down the Option key while resizing switches the type of resizing used. This setting is persistent.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.3 and later.

  • Returns the width of the specified column.

    Declaration

    Swift

    func widthOfColumn(_ column: Int) -> CGFloat

    Objective-C

    - (CGFloat)widthOfColumn:(NSInteger)column

    Parameters

    column

    The index of the column for which to retrieve the width.

    Return Value

    The width of the column.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.3 and later.

  • Sets the width of the specified column.

    Declaration

    Swift

    func setWidth(_ columnWidth: CGFloat, ofColumn columnIndex: Int)

    Objective-C

    - (void)setWidth:(CGFloat)columnWidth ofColumn:(NSInteger)columnIndex

    Parameters

    columnWidth

    The new width of the specified column.

    columnIndex

    The index of the column for which to set the width.

    Discussion

    This method can be used to set the initial width of browser columns unless the column sizing is automatic; setWidth:ofColumn: does nothing if columnResizingType is NSBrowserAutoColumnResizing. To set the default width for new columns (that don’t otherwise have initial widths from defaults or via the delegate), use a columnIndex of –1. A value set for columnIndex of –1 is persistent. An NSBrowserColumnConfigurationDidChangeNotification notification is posted (not immediately), if necessary, so that the browser can autosave the new column configuration.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.3 and later.

  • Returns the default column width of the browser’s columns.

    Declaration

    Swift

    func defaultColumnWidth() -> CGFloat

    Objective-C

    - (CGFloat)defaultColumnWidth

    Return Value

    The default column width.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.6 and later.

  • Sets the default column width for new browser columns that do not otherwise have an initial width from defaults or the browser’s delegate.

    Declaration

    Swift

    func setDefaultColumnWidth(_ columnWidth: CGFloat)

    Objective-C

    - (void)setDefaultColumnWidth:(CGFloat)columnWidth

    Parameters

    columnWidth

    The default column width to set.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.6 and later.

  • Returns the height of the browser’s rows.

    Declaration

    Swift

    var rowHeight: CGFloat

    Objective-C

    @property CGFloat rowHeight

    Return Value

    The row height.

    Discussion

    The default value is 17.0. rowHeight and setRowHeight: are only available when using the item delegate methods. An exception is thrown if you are using the matrix delegate methods.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.6 and later.

  • Sets the height of the browser’s rows to the specified value.

    Declaration

    Swift

    var rowHeight: CGFloat

    Objective-C

    @property CGFloat rowHeight

    Parameters

    height

    The new height to set.

    Discussion

    The value must be greater than 0. Any fractional value will be forced to an integral value for drawing. For variable row height browsers (ones whose delegates implement browser:heightOfRow:inColumn:), the row height will be used to draw alternating rows past the last row in each browser column. rowHeight and setRowHeight: are only available when using the item delegate methods. An exception is thrown if you are using the matrix delegate methods.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.6 and later.

    See Also

    – rowHeight

  • Types of browser column resizing.

    Declaration

    Swift

    enum NSBrowserColumnResizingType : UInt { case NoColumnResizing case AutoColumnResizing case UserColumnResizing }

    Objective-C

    enum { NSBrowserNoColumnResizing = 0, NSBrowserAutoColumnResizing = 1, NSBrowserUserColumnResizing = 2 }; typedef NSUInteger NSBrowserColumnResizingType;

    Constants

    • NoColumnResizing

      NSBrowserNoColumnResizing

      Neither NSBrowser nor the user can change the column width. The developer must explicitly set all column widths.

      Available in OS X v10.3 and later.

    • AutoColumnResizing

      NSBrowserAutoColumnResizing

      All columns have the same width, calculated using a combination of the minimum column width and maximum number of visible columns settings. The column width changes as the window size changes. The user cannot resize columns.

      Available in OS X v10.3 and later.

    • UserColumnResizing

      NSBrowserUserColumnResizing

      The developer chooses the initial column widths, but users can resize all columns simultaneously or each column individually.

      Available in OS X v10.3 and later.

    Discussion

    These constants are used by the setColumnResizingType: and columnResizingType methods.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.3 and later.

  • The type used to specify the drop type of a drag-and-drop operation. See browser:validateDrop:proposedRow:column:dropOperation: for more information.

    Declaration

    Swift

    enum NSBrowserDropOperation : UInt { case On case Above }

    Objective-C

    enum { NSBrowserDropOn, NSBrowserDropAbove }; typedef NSUInteger NSBrowserDropOperation;

    Constants

    • On

      NSBrowserDropOn

      The drop occurs at the row to which the item was dragged.

      Available in OS X v10.5 and later.

    • Above

      NSBrowserDropAbove

      The drop occurs above the row to which the item was dragged.

      Available in OS X v10.5 and later.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.5 and later.

  • The version of the AppKit.framework containing a specific bug fix or capability.

    Declaration

    Swift

    var NSAppKitVersionNumberWithContinuousScrollingBrowser: Double { get } var NSAppKitVersionNumberWithColumnResizingBrowser: Double { get }

    Objective-C

    #define NSAppKitVersionNumberWithContinuousScrollingBrowser 680.0 #define NSAppKitVersionNumberWithColumnResizingBrowser 685.0

    Constants

    • NSAppKitVersionNumberWithContinuousScrollingBrowser

      NSAppKitVersionNumberWithContinuousScrollingBrowser

      The specific version of the AppKit framework that introduced support the continuous scrolling in NSBrowser. Developers should not need to use this constant unless they are writing applications for OS X v10.3 and earlier.

      Available in OS X v10.3 and later.

    • NSAppKitVersionNumberWithColumnResizingBrowser

      NSAppKitVersionNumberWithColumnResizingBrowser

      The specific version of the AppKit framework that introduced support for resizing individual browser columns. Developers should not need to use this constant unless they are writing applications for OS X v10.3 and earlier.

      Available in OS X v10.3 and later.

    Import Statement

  • Notifies the delegate when the width of a browser column has changed. The notification object is the browser whose column sizes need to be made persistent. This notification does not contain a userInfo dictionary. If the user resizes more than one column, a single notification is posted when the user is finished resizing.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.3 and later.