NSSplitView

Представление разделения управляет делителями и ориентацией для контроллера представления разделения (экземпляр NSSplitViewController класс.) По умолчанию делители ориентированы горизонтально так, чтобы одноуровневые представления были расположены вертикально, сверху донизу, в содержании контроллера представления разделения.

Индексы делителя основаны на нуле с крайним левым или самым верхним делителем (в зависимости от значения vertical свойство) наличие индекса 0.

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

NSObject
NSResponder
NSView
NSSplitView

NSObject
NSResponder
NSView
NSSplitView

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

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

Swift

import AppKit

Objective C

@import AppKit;

Доступность

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

Управление подпредставлениями

adjustSubviews () - adjustSubviews

Корректирует размеры подпредставлений представления разделения, таким образом, они (плюс делители) заполняют представление разделения.

Объявление

Swift

func adjustSubviews()

Objective C

- (void)adjustSubviews

Обсуждение

При вызове этого метода подпредставления представления разделения изменены пропорционально; относительные размеры подпредставлений не изменяются.

Реализация по умолчанию этого метода изменяет размеры подпредставлений пропорционально так, чтобы отношение высот (при использовании горизонтальных делителей) или ширины (при использовании вертикальных делителей) не изменялось, даже при том, что изменяются абсолютные размеры.

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

Этот метод лишает законной силы курсор, когда это - более чем делитель, гарантируя, что курсор всегда имеет корректный тип в течение и после изменения размеров анимаций.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– setDelegate:
setFrame: (в ссылке класса NSView)
isSubviewCollapsed (_:) - isSubviewCollapsed:

Возвраты, разрушено ли указанное представление.

Объявление

Swift

func isSubviewCollapsed(_ subview: NSView) -> Bool

Objective C

- (BOOL)isSubviewCollapsed:(NSView *)subview

Параметры

subview

Подпредставление в представлении разделения.

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

YEStrue если subview находится в разрушенном состоянии, NOfalse иначе.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.0 и позже.
holdingPriorityForSubviewAtIndex (_:) - holdingPriorityForSubviewAtIndex:

Возвращает приоритет подпредставления width или высота при изменении размеров.

Объявление

Swift

func holdingPriorityForSubviewAtIndex(_ subviewIndex: Int) -> NSLayoutPriority

Objective C

- (NSLayoutPriority)holdingPriorityForSubviewAtIndex:(NSInteger)subviewIndex

Параметры

subviewIndex

Индекс подпредставления.

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

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

Обсуждение

Приоритет является способом, под которым подпредставления представления разделения содержат свои ширины (для вертикального представления разделения) или высота (для горизонтального представления разделения). Если представление разделения будет расти или будет уменьшаться, представление с самым низким приоритетом будет первым для принятия дополнительной ширины.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– setHoldingPriority:forSubviewAtIndex:


    
    setHoldingPriority (_: forSubviewAtIndex:)
    - setHoldingPriority:forSubviewAtIndex:

Устанавливает приоритет, под которым подпредставления представления разделения поддерживают свою ширину или высоту.

Объявление

Swift

func setHoldingPriority(_ priority: NSLayoutPriority, forSubviewAtIndex subviewIndex: Int)

Objective C

- (void)setHoldingPriority:(NSLayoutPriority)priority forSubviewAtIndex:(NSInteger)subviewIndex

Параметры

`priority`	Приоритет.
`subviewIndex`	Индекс подпредставления

Обсуждение

Устанавливает приоритет, под которым подпредставления представления разделения содержат свои ширины (для вертикального представления разделения) или высота (для горизонтального представления разделения). Если представление разделения будет расти или будет уменьшаться, представление с самым низким приоритетом будет первым для принятия дополнительной ширины.

Значение по умолчанию NSLayoutPriorityDefaultLow. Нет никакой причины использовать значение по умолчанию, но необходимо использовать приоритеты меньше, чем NSLayoutPriorityDragThatCannotResizeWindow.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– holdingPriorityForSubviewAtIndex:

Управление ориентацией делителя

вертикальный вертикальный Свойство

Геометрическая ориентация делителей представления разделения, где результаты YES в вертикальных делителях и бок о бок просматривает.

Объявление

Swift

var vertical: Bool

Objective C

@property(getter=isVertical) BOOL vertical

Обсуждение

Значение по умолчанию этого свойства NOfalse, указание горизонтальных делителей и, следовательно, представления, сложенные один над другим (сверху донизу) в содержании разделения, просматривает представление контроллера.

Для указания вертикальных делителей и, следовательно, горизонталь (бок о бок) расположение представлений в контроллере представления разделения, реализуют это свойство для возврата YEStrue.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Присвоение делегата

делегат делегат Свойство

Делегат представления разделения.

Объявление

Swift

unowned(unsafe) var delegate: NSSplitViewDelegate?

Objective C

@property(assign) id< NSSplitViewDelegate > delegate

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Конфигурирование и рисование делителей

dividerStyle dividerStyle Свойство

Стиль делителя, нарисованного между представлениями.

Объявление

Swift

var dividerStyle: NSSplitViewDividerStyle

Objective C

@property NSSplitViewDividerStyle dividerStyle

Обсуждение

Возможные значения описаны в Стилях Делителя Представления Разделения.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

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

Объявление

Swift

@NSCopying var dividerColor: NSColor { get }

Objective C

@property(readonly, copy) NSColor *dividerColor

Обсуждение

Реализация по умолчанию этого метода возвраты clearColor когда dividerStyle возвраты NSSplitViewDividerStyleThick или когда dividerStyle возвраты NSSplitViewDividerStylePaneSplitter и получатель находится в текстурированном окне. Все другие тонкие делители нарисованы с цветом, выглядящим хорошим между двумя белыми областями.

Можно разделить на подклассы NSSplitView и переопределите этот метод для изменения цвета делителей.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Толщина делителей для представления разделения.

Объявление

Swift

var dividerThickness: CGFloat { get }

Objective C

@property(readonly) CGFloat dividerThickness

Обсуждение

Можно разделить на подклассы NSSplitView и переопределите этот метод для изменения толщины разделения делители представления.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– drawDividerInRect:


    
    drawDividerInRect (_:)
    - drawDividerInRect:

Рисует делитель между двумя из подпредставлений получателя.

Объявление

Swift

func drawDividerInRect(_ aRect: NSRect)

Objective C

- (void)drawDividerInRect:(NSRect)aRect

Параметры


      aRect

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

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– dividerThickness
compositeToPoint:operation: (NSImage)

Сохранение позиций подпредставления

autosaveName autosaveName Свойство

Имя, под которым автоматически сохраняется конфигурация делителя представления разделения.

Объявление

Swift

var autosaveName: String?

Objective C

@property(copy) NSString *autosaveName

Обсуждение

Если значение этого свойства nil или пустой, никакое автоматическое сохранение не выполняется.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Ограничение позиции разделения

minPossiblePositionOfDividerAtIndex (_:) - minPossiblePositionOfDividerAtIndex:

Возвращает минимальную возможную позицию делителя в указанном индексе.

Объявление

Swift

func minPossiblePositionOfDividerAtIndex(_ dividerIndex: Int) -> CGFloat

Objective C

- (CGFloat)minPossiblePositionOfDividerAtIndex:(NSInteger)dividerIndex

Параметры

dividerIndex

Индекс делителя.

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

CGFloat указание минимальной возможной позиции делителя.

Обсуждение

Позиция «возможна» в этом, ее диктуют границы получателя и текущая позиция других делителей. «Допустимые» позиции - те, которые следуют из разрешения делегату применить ограничения к возможным позициям.

Можно вызвать этот метод для определения диапазона значений, которые могут быть полезно переданы setPosition:ofDividerAtIndex:.

Можно также вызвать его от методов делегата как splitView:constrainSplitPosition:ofSubviewAt: реализовать относительно сложные способы поведения, зависящие от текущего состояния представления разделения.

Результаты вызова этого метода, когда adjustSubviews не был вызван, и кадры подпредставления недопустимы, не определено.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Возвращает максимальную возможную позицию делителя в указанном индексе.

Объявление

Swift

func maxPossiblePositionOfDividerAtIndex(_ dividerIndex: Int) -> CGFloat

Objective C

- (CGFloat)maxPossiblePositionOfDividerAtIndex:(NSInteger)dividerIndex

Параметры

dividerIndex

Индекс делителя.

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

CGFloat указание максимальной возможной позиции делителя.

Обсуждение

Позиция «возможна» в этом, ее диктуют границы получателя и текущая позиция других делителей. «Допустимые» позиции - те, которые следуют из разрешения делегату применить ограничения к возможным позициям.

Можно вызвать этот метод для определения диапазона значений, которые могут быть полезно переданы setPosition:ofDividerAtIndex:.

Можно также вызвать его от методов делегата как splitView:constrainSplitPosition:ofSubviewAt: реализовать относительно сложные способы поведения, зависящие от текущего состояния представления разделения.

Результаты вызова этого метода, когда adjustSubviews не был вызван, и кадры подпредставления недопустимы, не определено.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.5 и позже.
setPosition (_: ofDividerAtIndex:) - setPosition:ofDividerAtIndex:

Устанавливает позицию делителя в указанном индексе.

Объявление

Swift

func setPosition(_ position: CGFloat, ofDividerAtIndex dividerIndex: Int)

Objective C

- (void)setPosition:(CGFloat)position ofDividerAtIndex:(NSInteger)dividerIndex

Параметры

position

Позиция делителя

dividerIndex

Индекс делителя.

Обсуждение

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

Этот метод не вызывается NSSplitView самостоятельно.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Конфигурирование разделителей области

isPaneSplitter - isPaneSplitter (OS X v10.6)

Возвраты YEStrue если разделитель получателя является панелью, идущей через представление разделения. Возвраты NOfalse если разделитель является ползунком на регулярном фоновом образце.

Оператор осуждения

Эта функциональность больше не релевантна и нет никакого альтернативного метода.

Объявление

Objective C

- (BOOL)isPaneSplitter

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

Objective C

@import AppKit;

Доступность

Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.6.

См. также

– setIsPaneSplitter:


    
    setIsPaneSplitter:
    - setIsPaneSplitter:

(OS X v10.6)

Устанавливает тип разделителя.

Оператор осуждения

Эта функциональность больше не релевантна и нет никакого альтернативного метода.

Объявление

Objective C

- (void)setIsPaneSplitter:(BOOL)flag

Параметры


      flag

YEStrue если разделитель получателя является панелью, идущей через представление разделения. NOfalse если разделитель является ползунком на регулярном фоновом образце.

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

Objective C

@import AppKit;

Доступность

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

Осуждаемый в OS X v10.6.

См. также

– isPaneSplitter

Константы

Стили делителя представления разделения
Эти константы указывают возможные стили делителя, используемые dividerStyle и setDividerStyle:.

Объявление

Swift

enum NSSplitViewDividerStyle : Int { case Thick case Thin case PaneSplitter }

Objective C

enum { NSSplitViewDividerStyleThick = 1, NSSplitViewDividerStyleThin = 2, NSSplitViewDividerStylePaneSplitter = 3, }; typedef NSInteger NSSplitViewDividerStyle;

Константы
- Thick
  
  NSSplitViewDividerStyleThick
  
  Толстый делитель стиля выведен на экран между подпредставлениями. Это - значение по умолчанию.
  
  Доступный в OS X v10.5 и позже.
- Thin
  
  NSSplitViewDividerStyleThin
  
  Тонкий делитель стиля выведен на экран между подпредставлениями.
  
  Доступный в OS X v10.5 и позже.
- PaneSplitter
  
  NSSplitViewDividerStylePaneSplitter
  
  Толстый делитель стиля с 3D появлением выведен на экран между подпредставлениями.
  
  Доступный в OS X v10.6 и позже.
Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Уведомления

NSSplitViewDidResizeSubviewsNotification NSSplitViewDidResizeSubviewsNotification

Отправленный после того, как NSSplitView изменяет размеры некоторых или все его подпредставления. Объектом уведомления является NSSplitView, изменивший размеры его подпредставлений.

Примечание:

В OS X v10.5 и позже если уведомление отправляется, потому что пользователь перетаскивает делитель, userInfo словарь содержит ключ @"NSSplitViewDividerIndex" содержа NSNumber- обернутый NSInteger это - индекс перетаскиваемого делителя. Более ранние версии OS X не возвращают пользовательский информационный словарь ни в какой ситуации.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

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

Примечание:

В OS X v10.5 и позже если уведомление отправляется, потому что пользователь перетаскивает делитель, userInfo словарь содержит ключ @"NSSplitViewDividerIndex" содержа NSInteger- обернутый NSNumber это - индекс перетаскиваемого делителя. Более ранние версии OS X не возвращают пользовательский информационный словарь ни в какой ситуации.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

`position`	Позиция делителя
`dividerIndex`	Индекс делителя.

NSSplitView

Управление подпредставлениями

Объявление

Обсуждение

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

Доступность

См. также

Объявление

Параметры

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

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

Доступность

Объявление

Параметры

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

Обсуждение

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

Доступность

См. также

Объявление

Параметры

Обсуждение

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

Доступность

См. также

Управление ориентацией делителя

Объявление

Обсуждение

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

Доступность

Присвоение делегата

Объявление

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

Доступность

Конфигурирование и рисование делителей

Объявление

Обсуждение

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

Доступность

Объявление

Обсуждение

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

Доступность

Объявление

Обсуждение

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

Доступность

См. также

Объявление

Параметры

Обсуждение

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

Доступность

См. также

Сохранение позиций подпредставления

Объявление

Обсуждение

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

Доступность

Ограничение позиции разделения

Объявление

Параметры

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

Обсуждение

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

Доступность

Объявление

Параметры

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

Обсуждение

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

Доступность

Объявление

Параметры

Обсуждение

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

Доступность

Конфигурирование разделителей области

Оператор осуждения

Объявление