Contents

NSPathControl

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

Declaration

class NSPathControl

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 NSPathControl.Style enumeration constants NSPathControl.Style.standard, NSPathStyleNavigationBar, and NSPathControl.Style.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 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

Setting the Background Color

Managing Path Components

Setting the Double-Click Action

Setting the Path

Setting the Delegate

Setting the Drag Operation Mask

Setting Popup Menu

Instance Properties

Enumerations