Class

NSPathControl

NSPathControl is a subclass of NSControl that represents a file system path or virtual path.

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 standard, NSPathStyleNavigationBar, and popUp. 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 register(forDraggedTypes:) 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.

Symbols

Setting the Control Style

var pathStyle: NSPathStyle

The receiver’s path style.

Setting the Background Color

var backgroundColor: NSColor?

The receiver’s background color.

Managing Path Components

func clickedPathComponentCell()

Returns the clicked cell.

Deprecated
func pathComponentCells()

Returns an array of the NSPathComponentCell objects currently being displayed.

Deprecated
func setPathComponentCells([NSPathComponentCell])

Sets the array of NSPathComponentCell objects currently being displayed.

Deprecated

Setting the Double-Click Action

var doubleAction: Selector?

The receiver’s double-click action method.

Setting the Path

var url: URL?

The path value displayed by the receiver.

Setting the Delegate

var delegate: NSPathControlDelegate?

The receiver’s delegate.

Setting the Drag Operation Mask

Setting Popup Menu

var menu: NSMenu?

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

Relationships

Inherits From

Conforms To