Class

NSPathControl

A display of a file system path or virtual path information.

Declaration

@interface NSPathControl : NSControl

Overview

The NSPathControl class uses NSPathCell to implement its user interface. NSPathControl provides cover methods for most NSPathCell methods—the cover method simply invokes the corresponding cell method. See also NSPathComponentCell, which represents individual components of the path, and two associated protocols: NSPathCellDelegate and NSPathControlDelegate.

NSPathControl has three styles represented by the NSPathStyle enumeration constants NSPathStyleStandard, NSPathStyleNavigationBar, and NSPathStylePopUp. The represented path can be a file system path or any other type of path leading through a sequence of nodes or components, as defined by the programmer.

NSPathControl automatically supports drag and drop, which can be further customized via delegate methods. To accept drag and drop, NSPathControl calls registerForDraggedTypes: with NSFilenamesPboardType and NSURLPboardType. When the URL value in the NSPathControl object changes because of an automatic drag and drop operation or the user selecting a new path via the open panel, the action is sent. In OS X v10.5 the value returned by clickedPathComponentCell is nil, in macOS 10.6 and later, clickedPathComponentCell returns the clicked cell.

Topics

Setting the Control Style

pathStyle

The receiver’s path style.

Setting the Background Color

backgroundColor

The receiver’s background color.

Managing Path Components

- clickedPathComponentCell

Returns the clicked cell.

Deprecated
- pathComponentCells

Returns an array of the NSPathComponentCell objects currently being displayed.

Deprecated
- setPathComponentCells:

Sets the array of NSPathComponentCell objects currently being displayed.

Deprecated

Setting the Double-Click Action

doubleAction

The receiver’s double-click action method.

Setting the Path

URL

The path value displayed by the receiver.

Setting the Delegate

delegate

The receiver’s delegate.

Setting the Drag Operation Mask

Setting Popup Menu

menu

The menu that is used for the path control’s cells.

Relationships

Inherits From