NSPathCell

NSPathCell реализует пользовательский интерфейс NSPathControl объект. Это поддерживает набор NSPathComponentCell объекты, представляющие определенный путь, который будет выведен на экран пользователю.

Показанный путь может быть установлен с setURL: метод. Выполнение так удаляет все выведенные на экран NSPathComponentCell объекты и автоматически заполняют управление NSPathComponentCell набор объектов для имения надлежащих значков выведите на экран заголовки, и NSURL значения для определенного компонента контура они представляют. Также можно заполнить управление вручную путем установки массива ячеек или непосредственно изменения существующих ячеек.

Оба действие и дважды щелкает по действию, могут быть установлены для управления трактом. Для обнаружения, по какой ячейке компонента контура щелкнули в действии можно считать значение clickedPathComponentCell. Когда стиль установлен в NSPathStylePopUp, действие все еще отправляется, и clickedPathComponentCell значение для представленного пункта меню правильно установлено. clickedPathComponentCell значение допустимо только, когда отправляется действие. Когда клавиатура используется для вызова действия, это также допустимо.

Автоматическое анимированное расширение частично скрытого NSPathComponentCell если Вы правильно вызываете, объекты происходят mouseEntered: и mouseExited: для каждого NSPathComponentCell в NSPathCell объект. Это не требуется если pathStyle установлен в NSPathStylePopUp, или если Вы хотите не иметь анимацию.

NSPathCell поддержки несколько стилей отображения пути. NSPathStyleStandard имеет голубой фон со стрелками, указывающими путь. NSPathStyleNavigationBar больше определил стрелки (двойные угловые скобки) и немного походит на сегментированную кнопку. NSPathStylePopUp взгляды и работы как NSPopUpButton возразите для отображения полного пути, или, если ячейка доступна для редактирования, выберите новый путь.

Если ячейка isEditable возвраты метода YEStrue (значение по умолчанию), можно перетащить в ячейку для изменения значения. Можно ограничить то, что может быть отброшено с помощью UTIs (Универсальные Идентификаторы типов) с setAllowedTypes: или надлежащие методы делегата для NSPathControl.

Если ячейка isSelectable возвраты метода YEStrue (значение по умолчанию), содержание ячейки может автоматически быть вытащено. Надлежащий UTI, имя файла и URL помещаются в область монтажа. Можно далее управлять или ограничить это при помощи надлежащих методов делегата для NSPathControl.

Если ячейка доступна для редактирования и имеет набор стиля пути к NSPathStylePopUp, дополнительный элемент во всплывающем меню позволяет выбирать другое расположение. По умолчанию, NSOpenPanel объект сконфигурирован на основе позволенных типов. NSOpenPanel объект может быть настроен с методом делегата.

Наследование

NSObject
NSCell
NSActionCell
NSPathCell

NSObject
NSCell
NSActionCell
NSPathCell

Соответствует

Оператор импорта

Swift

import AppKit

Objective C

@import AppKit;

Доступность

Доступный в OS X v10.5 и позже.

Отображение скрытых компонентов


    
    mouseEntered (_: withFrame:inView:)
    - mouseEntered:withFrame:inView:

Выводит на экран компонент ячейки, над которым нависает мышь.

Объявление

Swift

func mouseEntered(_ event: NSEvent, withFrame frame: NSRect, inView view: NSView)

Objective C

- (void)mouseEntered:(NSEvent *)event withFrame:(NSRect)frame inView:(NSView *)view

Параметры

`event`	Вводимое в мышь событие.
`frame`	Кадр, в котором расположена ячейка.
`view`	Представление, в котором расположена ячейка.

Обсуждение

NSPathCell объект динамично анимирует для отображения компонента, что мышь нависает над использованием вводимых в мышь и вышедших мышью событий. Управление должно вызвать эти методы для корректного отображения колебавшегося компонента пользователю. Управление может получить прямоугольники для отслеживания использования rectOfPathComponentCell:withFrame:inView:.

Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.5 и позже.


    
    mouseExited (_: withFrame:inView:)
    - mouseExited:withFrame:inView:

Скрывает компонент ячейки, над которым нависает мышь.

Объявление

Swift

func mouseExited(_ event: NSEvent, withFrame frame: NSRect, inView view: NSView)

Objective C

- (void)mouseExited:(NSEvent *)event withFrame:(NSRect)frame inView:(NSView *)view

Параметры

`event`	Вышедшее мышью событие.
`frame`	Кадр, в котором расположена ячейка.
`view`	Представление, в котором расположена ячейка.

Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.5 и позже.

Установка позволенных типов

allowedTypes - allowedTypes

Когда ячейка доступна для редактирования, возвращает типы компонента, позволенные по пути.

Объявление

Swift

var allowedTypes: [AnyObject]?

Objective C

@property(copy) NSArray *allowedTypes

Возвращаемое значение

Массив строк, представляющих или расширения файла или UTIs. Может быть nil, значение по умолчанию, позволяя все типы или пустой массив, ничего не позволяя.

Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.5 и позже.


    
    setAllowedTypes:
    - setAllowedTypes:

Когда ячейка доступна для редактирования, устанавливает типы компонента, позволенные по пути.

Объявление

Swift

var allowedTypes: [AnyObject]?

Objective C

@property(copy) NSArray *allowedTypes

Параметры


      allowedTypes

Массив строк, представляющих или расширения файла или UTIs. Может быть nil, значение по умолчанию, позволяя все типы.

Обсуждение

allowedTypes массив может содержать расширения файла (без периода, начинающего расширение), или UTIs. Для разрешения папок включайте public.folder идентификатор. Для разрешения любого типа использовать nil. Если значение allowedTypes пустой массив, ничто не позволяется. Значение по умолчанию nil, разрешение всех типов.

Если ячейка доступна для редактирования, и ее тип NSPathStylePopUp, Выбрать элемент включен для включения выбора различного пути путем вызова панели Open. Позволенные типы передаются панели Open для отфильтровывания других типов. Позволенные типы также используются с перетаскиванием, чтобы указать, позволяется ли отбрасывание.

Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.5 и позже.

Установка стиля управления

pathStyle - pathStyle

Возвращает стиль пути получателя.

Объявление

Swift

var pathStyle: NSPathStyle

Objective C

@property NSPathStyle pathStyle

Возвращаемое значение

Стиль пути.

Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.5 и позже.

См. также
setPathStyle: - setPathStyle:

Устанавливает стиль пути получателя.

Объявление

Swift

var pathStyle: NSPathStyle

Objective C

@property NSPathStyle pathStyle

Параметры

style

Новый стиль пути.

Обсуждение

Посмотрите setControlSize: для получения информации о стиле пути и зависимостях от размера элемента управления.

Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.5 и позже.

См. также

– pathStyle
– setControlSize:
setControlSize: - setControlSize: Доступный в OS X v10.5 через OS X v10.9

Устанавливает размер элемента управления получателя.

Объявление

Objective C

- (void)setControlSize:(NSControlSize)size

Параметры

size

Новый размер элемента управления.

Обсуждение

NSPathCell должным образом уважает размер элемента управления за NSPathStyleStandard и NSPathStylePopUp стили. Когда размер элемента управления установлен, новый размер распространен к подъячейкам. Когда стиль пути установлен в NSPathStyleNavigationBar, Вы не можете изменить размер элемента управления, и он всегда устанавливается в NSSmallControlSize. Попытка изменить размер элемента управления, когда стиль пути NSPathStyleNavigationBar вызывает утверждение. Установка пути разрабатывает к NSPathStyleNavigationBar вынуждает размер элемента управления быть NSSmallControlSize.

Оператор импорта

Objective C

@import AppKit;

Доступность

Доступный в OS X v10.5 через OS X v10.9.

См. также

– setPathStyle:
– pathStyle

Установка объектного значения

setObjectValue (_:) - setObjectValue:

Устанавливает объектное значение получателя.

Объявление

Swift

func setObjectValue(_ obj: NSCopying?)

Objective C

- (void)setObjectValue:(id<NSCopying>)obj

Параметры

obj

Новое объектное значение для ячейки.

Обсуждение

Если setObjectValue: вызывается с NSURL объект, setURL: автоматически вызывается. objectValue метод возвращается последний раз набор значение URL. setObjectValue: метод может также принять строковое значение с элементами, разделенными разделителем пути (/). Любое другое значение является программной ошибкой и вызовет утверждение.

Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.5 и позже.

Установка появления ячейки

placeholderAttributedString - placeholderAttributedString

Возвращается заполнитель приписал строку.

Объявление

Swift

@NSCopying var placeholderAttributedString: NSAttributedString?

Objective C

@property(copy) NSAttributedString *placeholderAttributedString

Возвращаемое значение

Заполнитель приписал строку.

Обсуждение

Если NSPathCell объект содержит нет NSPathComponentCell объекты, приписанная строка заполнителя нарисована в их месте, если это не nil. Если приписанная строка заполнителя nil, (неприписанная) строка заполнителя нарисована с атрибутами по умолчанию, если это не nil.

Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.5 и позже.
setPlaceholderAttributedString: - setPlaceholderAttributedString:

Устанавливает значение приписанной строки заполнителя.

Объявление

Swift

@NSCopying var placeholderAttributedString: NSAttributedString?

Objective C

@property(copy) NSAttributedString *placeholderAttributedString

Параметры

string

Строка для установки для заполнителя приписала строку.

Обсуждение

Если NSPathCell объект содержит нет NSPathComponentCell объекты, приписанная строка заполнителя нарисована в их месте, если это не nil. Если приписанная строка заполнителя nil, (неприписанная) строка заполнителя нарисована с атрибутами по умолчанию, если это не nil.

Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.5 и позже.
setPlaceholderString: - setPlaceholderString:

Устанавливает значение строки заполнителя.

Объявление

Swift

var placeholderString: String?

Objective C

@property(copy) NSString *placeholderString

Параметры

string

Строка для установки для заполнителя.

Обсуждение

Если NSPathCell объект содержит нет NSPathComponentCell объекты, приписанная строка заполнителя нарисована в их месте, если это не nil. Если приписанная строка заполнителя nil, (неприписанная) строка заполнителя нарисована с атрибутами по умолчанию, если это не nil.

Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.5 и позже.
placeholderString - placeholderString

Возвращает строку заполнителя.

Объявление

Swift

var placeholderString: String?

Objective C

@property(copy) NSString *placeholderString

Возвращаемое значение

Строка заполнителя.

Обсуждение

Если NSPathCell объект содержит нет NSPathComponentCell объекты, приписанная строка заполнителя нарисована в их месте, если это не nil. Если приписанная строка заполнителя nil, (неприписанная) строка заполнителя нарисована с атрибутами по умолчанию, если это не nil.

Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.5 и позже.
setBackgroundColor: - setBackgroundColor:

Выбирает цвет фона получателя.

Объявление

Swift

@NSCopying var backgroundColor: NSColor?

Objective C

@property(copy) NSColor *backgroundColor

Параметры

color

Цвет, который будет нарисован.

Обсуждение

По умолчанию фон установлен в голубой цвет для NSPathStyleStandard, и nil для других стилей. Можно использовать [NSColor clearColor] сделать фон прозрачным.

Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.5 и позже.
backgroundColor - backgroundColor

Возвращает текущий фоновый цвет получателя.

Объявление

Swift

@NSCopying var backgroundColor: NSColor?

Objective C

@property(copy) NSColor *backgroundColor

Возвращаемое значение

Цвет фона.

Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.5 и позже.

Управление компонентами контура

pathComponentCellClass () + pathComponentCellClass

Возвращается класс раньше создавал pathComponentCell объекты, автоматически заполняя управление.

Объявление

Swift

class func pathComponentCellClass() -> AnyClass

Objective C

+ (Class)pathComponentCellClass

Возвращаемое значение

Класс раньше создавал NSPathComponentCell объекты.

Обсуждение

Подклассы могут переопределить этот метод для возврата автоматически использующегося пользовательского класса ячейки. По умолчанию, возвраты метода [NSPathComponentCell class], или специализированный подкласс этого.

Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.5 и позже.


    
    rectOfPathComponentCell (_: withFrame:inView:)
    - rectOfPathComponentCell:withFrame:inView:

Возвращает текущий прямоугольник, выводимый на экран для данной ячейки компонента контура, относительно данного кадра в высказанном мнении.

Объявление

Swift

func rectOfPathComponentCell(_ cell: NSPathComponentCell, withFrame frame: NSRect, inView view: NSView) -> NSRect

Objective C

- (NSRect)rectOfPathComponentCell:(NSPathComponentCell *)cell withFrame:(NSRect)frame inView:(NSView *)view

Параметры

`cell`	Ячейка компонента контура.
`frame`	Кадр представления, в котором появляется ячейка.
`view`	Представление, в котором появляется ячейка.

Возвращаемое значение

Прямоугольник занят ячейкой компонента контура. NSZeroRect возвращается если cell не найден или не в настоящее время видим.

Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.5 и позже.


    
    pathComponentCellAtPoint (_: withFrame:inView:)
    - pathComponentCellAtPoint:withFrame:inView:

Возвращает ячейку, расположенную в данной точке в данном кадре высказанного мнения.

Объявление

Swift

func pathComponentCellAtPoint(_ point: NSPoint, withFrame frame: NSRect, inView view: NSView) -> NSPathComponentCell?

Objective C

- (NSPathComponentCell *)pathComponentCellAtPoint:(NSPoint)point withFrame:(NSRect)frame inView:(NSView *)view

Параметры

`point`	Точка в возвращенной ячейке.
`frame`	Кадр, в котором расположена точка.
`view`	Представление, в котором расположен кадр.

Возвращаемое значение

Ячейка компонента, в которой данная точка расположена, или nil если никакая ячейка не существует в том расположении.

Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.5 и позже.

clickedPathComponentCell - clickedPathComponentCell

Возвращает ячейку, по которой щелкают.

Объявление

Swift

var clickedPathComponentCell: NSPathComponentCell? { get }

Objective C

@property(readonly, strong) NSPathComponentCell *clickedPathComponentCell

Возвращаемое значение

Ячейка компонента, по которой щелкнули, или nil, если не щелкнули ни по какой ячейке.

Обсуждение

Значение возвратилось, обычно допустимо только, когда действие или дважды щелкает по действию, отправляется.

Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.5 и позже.
pathComponentCells - pathComponentCells

Возвращает массив NSPathComponentCell объекты, в настоящее время выводимые на экран.

Объявление

Swift

var pathComponentCells: [AnyObject]

Objective C

@property(copy) NSArray *pathComponentCells

Возвращаемое значение

Массив NSPathComponentCell объекты.

Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.5 и позже.
setPathComponentCells: - setPathComponentCells:

Устанавливает массив NSPathComponentCell объекты, в настоящее время выводимые на экран.

Объявление

Swift

var pathComponentCells: [AnyObject]

Objective C

@property(copy) NSArray *pathComponentCells

Параметры

cells

Массив NSPathComponentCell объекты.

Обсуждение

Каждый элемент в массиве должен быть экземпляром NSPathComponentCell или подкласс этого. Вы не можете установить это значение в nil, но можно установить его в использование пустого массива, например, [NSArray array].

Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.5 и позже.

Установка действия двойного щелчка

doubleAction - doubleAction

Возвращает метод действия двойного щелчка получателя.

Объявление

Swift

var doubleAction: Selector

Objective C

@property SEL doubleAction

Возвращаемое значение

Когда пользователь дважды щелкает по получателю, метод действия вызвал.

Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.5 и позже.
setDoubleAction: - setDoubleAction:

Устанавливает действие двойного щелчка получателя.

Объявление

Swift

var doubleAction: Selector

Objective C

@property SEL doubleAction

Параметры

action

Метод действия вызвать, когда дважды щелкают по получателю.

Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.5 и позже.

Установка пути

URL - URL

Возвращает путь, выведенный на экран получателем.

Объявление

Swift

@NSCopying var URL: NSURL?

Objective C

@property(copy) NSURL *URL

Возвращаемое значение

Значение пути.

Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.5 и позже.
setURL: - setURL: Доступный в OS X v10.5 через OS X v10.9

Устанавливает значение пути, выведенного на экран получателем.

Объявление

Objective C

- (void)setURL:(NSURL *)url

Параметры

url

Новый путь оценивает дисплею.

Обсуждение

При установке, массив NSPathComponentCell объекты автоматически установлены, на основе пути в url. Тип NSPathComponentCell создаваемыми объектами можно управлять путем разделения на подклассы NSPathCell и переопределение pathComponentCellClass.

Если url файл URL (возвраты YEStrue от isFileURL), изображения автоматически заполнены значками файла, если существует путь. URL ценит себя, сохранен в objectValue свойство ячейки.

Оператор импорта

Objective C

@import AppKit;

Доступность

Доступный в OS X v10.5 через OS X v10.9.

Установка делегата

делегат - делегат

Возвращает делегата получателя.

Объявление

Swift

unowned(unsafe) var delegate: NSPathCellDelegate?

Objective C

@property(assign) id<NSPathCellDelegate> delegate

Возвращаемое значение

Делегат получателя.

Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.5 и позже.
setDelegate: - setDelegate:

Устанавливает делегата получателя.

Объявление

Swift

unowned(unsafe) var delegate: NSPathCellDelegate?

Objective C

@property(assign) id<NSPathCellDelegate> delegate

Параметры

delegate

объект установить как делегат получателя.

Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.5 и позже.

Константы

NSPathStyle
NSPathStyle константы представляют различные визуальные и поведенческие стили NSPathControl или NSPathCell объект может иметь.

Объявление

Swift

enum NSPathStyle : Int { case Standard case PopUp case NavigationBar }

Objective C

enum { NSPathStyleStandard, NSPathStyleNavigationBar, NSPathStylePopUp, }; typedef NSInteger NSPathStyle;

Константы
- Standard
  
  NSPathStyleStandard
  
  Стандартный стиль отображения и поведение. Все ячейки компонента контура выведены на экран с названием картинки значка и именем компонента. Если путь не может полностью быть выведен на экран, средние части усеченные как требуется.
  
  Доступный в OS X v10.5 и позже.
- NavigationBar
  
  NSPathStyleNavigationBar
  
  Стиль отображения панели навигации и поведение. Подобный NSPathStyleStandard со стилем рисования панели навигации. Также известный как стиль навигационной цепочки.
  
  Доступный в OS X v10.5 и позже.
  Осуждаемый в OS X v10.7.
- PopUp
  
  NSPathStylePopUp
  
  Раскрывающийся стиль отображения и поведение. Только последний компонент контура выведен на экран с названием картинки значка и именем компонента. Когда пользователь щелкает по ячейке, полный путь показан. Если ячейка доступна для редактирования, Выбрать элемент включен, чтобы позволить выбрать различный путь.
  
  Доступный в OS X v10.5 и позже.
Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.5 и позже.

NSPathCell

Отображение скрытых компонентов

Объявление

Параметры

Обсуждение

Оператор импорта

Доступность

Объявление

Параметры

Оператор импорта

Доступность

Установка позволенных типов

Объявление

Возвращаемое значение

Оператор импорта

Доступность

Объявление

Параметры

Обсуждение

Оператор импорта

Доступность

Установка стиля управления

Объявление

Возвращаемое значение

Оператор импорта

Доступность

См. также

Объявление

Параметры

Обсуждение

Оператор импорта

Доступность

См. также

Объявление

Параметры

Обсуждение

Оператор импорта

Доступность

См. также

Установка объектного значения

Объявление

Параметры

Обсуждение

Оператор импорта

Доступность

Установка появления ячейки

Объявление

Возвращаемое значение

Обсуждение

Оператор импорта

Доступность

Объявление

Параметры

Обсуждение

Оператор импорта

Доступность

Объявление

Параметры

Обсуждение

Оператор импорта

Доступность

Объявление

Возвращаемое значение

Обсуждение

Оператор импорта

Доступность

Объявление

Параметры

Обсуждение

Оператор импорта

Доступность

Объявление

Возвращаемое значение

Оператор импорта

Доступность

Управление компонентами контура

Объявление

Возвращаемое значение

Обсуждение

Оператор импорта