NSView

Класс сразу

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

NSView класс обеспечивает инфраструктуру для рисования, печати и обработки событий в Вашем приложении. Экземпляры NSView класс (или один из его подклассов) обычно известен как объекты представления, или просто как представления.

Представления обрабатывают представление и взаимодействие с видимым содержанием Вашего приложения. Вы располагаете одно или более представлений в NSWindow объект, действующий как обертка для Вашего содержания. Объект представления определяет прямоугольную область для рисования и получения событий от нажатия мыши. Представления обрабатывают другую работу по дому также, включая перетаскивание значков и работу с NSScrollView класс для поддержки эффективной прокрутки.

Большая часть функциональности NSView класс автоматически вызывается Набором Приложения. Если Вы не реализуете конкретный подкласс NSView или работая глубоко с содержанием иерархии представления во время выполнения, Вы не должны знать много об интерфейсе этого класса. Посмотрите Обычно Используемые Методы для методов, которые Вы могли бы использовать независимо.

Для получения дополнительной информации о как NSView экземпляры обрабатывают событие и сообщения действия, видят Руководство по Обработке событий Какао. Для получения дополнительной информации об отображении подсказок и контекстных меню, посмотрите Контекстные меню Отображения и Управление Подсказками.

Разделение на подклассы примечаний

NSView возможно, самый важный класс в Наборе Приложения когда дело доходит до разделения на подклассы и наследования. Большинство объектов пользовательского интерфейса, которые Вы видите в приложении Какао, является объектами, наследовавшимися от NSView. Если Вы хотите создать объект, рисующий себя специальным способом, или это реагирует на щелчки мышью специальным способом, Вы создали бы пользовательский подкласс NSView (или класса, наследовавшегося от NSView). Разделение на подклассы NSView такая общая и важная процедура, которую описывают несколько технических документов, как и нарисовать в пользовательских подклассах и реагировать на события в пользовательских подклассах. Посмотрите, что Какао Рисует Руководство по Обработке событий Руководства и Какао (особенно «Обрабатывающий События от нажатия мыши» и «События от нажатия мыши»).

Обработка событий в подклассе

Если Вы разделяете на подклассы NSView непосредственно и определенные типы дескриптора событий, реализация Ваших событийных методов не должна обычно вызывать super. Представления наследовали свои возможности обработки событий от их NSResponder родительский класс. Поведение по умолчанию для респондентов состоит в том, чтобы передать события цепочка респондента, которая не является поведением, которое Вы обычно хотите при обработке событий в пользовательском представлении. Поэтому Вы не должны вызывать super если Ваше представление реализует какой-либо из следующих методов и обрабатывает событие:

Если Ваше представление убывает от класса кроме NSView, вызвать super позволять родительскому представлению обработать любые события, которые Вы не делаете.

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

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

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

Swift

import AppKit

Objective C

@import AppKit;

Доступность

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

Создание экземпляров

init (кадр:) - initWithFrame: Определяемый инициализатор

Инициализирует и возвращается недавно выделенный NSView объект с указанным прямоугольником кадра.

Объявление

Swift

init(frame frameRect: NSRect)

Objective C

- (instancetype)initWithFrame:(NSRect)frameRect

Параметры

frameRect

Прямоугольник кадра для создаваемого объекта представления.

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

Инициализированный NSView объект или ноль, если не мог бы быть создан объект.

Обсуждение

Новый объект представления должен быть вставлен в иерархию представления окна, прежде чем это сможет использоваться. Этот метод является определяемым инициализатором для NSView класс. Возвращает инициализированный объект.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– addSubview:
– addSubview:positioned:relativeTo:
кадр
prepareForReuse () - prepareForReuse

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

Объявление

Swift

func prepareForReuse()

Objective C

- (void)prepareForReuse

Обсуждение

Реализация по умолчанию этого метода устанавливает альфу окна в 1.0 и его скрытое состояние к NOfalse. Подклассы могут переопределить этот метод и использовать его для возврата представления его начальному состоянию. Подклассы должны вызвать super в некоторый момент в их реализации.

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Управление иерархией представления

суперпредставление суперпредставление Свойство

Представление, которое является родителем текущего представления. (только для чтения)

Объявление

Swift

unowned(unsafe) var superview: NSView? { get }

Objective C

@property(readonly, assign) NSView *superview

Обсуждение

Суперпредставление является непосредственным наследователем текущего представления. Значение этого свойства nil когда представление не установлено в иерархии представления. Для установки значения этого свойства используйте addSubview: метод для встраивания текущего представления в другом представлении.

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

окно
подпредставления
– removeFromSuperview


    
    setSubviews:
    - setSubviews:

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

Объявление

Objective C

- (void)setSubviews:(NSArray *)newSubviews

Параметры


      newSubviews

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

Обсуждение

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

Поданный допустимый массив представлений newSubviews, setSubviews: выполняет любую требуемую сортировку массива подпредставлений, а также отправку любого addSubview: и removeFromSuperview сообщения по мере необходимости для отъезда получателя с требуемым новым массивом подпредставлений. Любой элемент newSubviews это уже не подпредставление получателя, добавляется. Любой элемент существующего представления subviews массив, который не находится в newSubviews удален. И любые представления, которые находятся в обоих subviews и newSubviews перемещены в массив подпредставлений по мере необходимости, не будучи удаленным и повторно добавлены.

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

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

Objective C

@import AppKit;

Доступность

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

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

Массив представлений встраивается в текущее представление.

Объявление

Swift

var subviews: [AnyObject]

Objective C

@property(copy) NSArray *subviews

Обсуждение

Этот массив содержит нуль или больше NSView объекты, представляющие представления, встроенные в содержание текущего представления. Текущее представление действует как суперпредставление для каждого подпредставления. Порядок подпредставлений можно рассмотреть как являющийся наоборот, но это не подразумевает поведение получения и аннулирование.

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

При выполнении операций теста хита на представлении необходимо запустить при последнем представлении в этом массиве и работе назад.

Примечание:

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

суперпредставление
– addSubview:
– addSubview:positioned:relativeTo:
– removeFromSuperview
окно окно Свойство

Объект окна получателя, если это установлено в окне. (только для чтения)

Объявление

Swift

unowned(unsafe) var window: NSWindow? { get }

Objective C

@property(readonly, assign) NSWindow *window

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

суперпредставление
addSubview (_:) - addSubview:

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

Объявление

Swift

func addSubview(_ aView: NSView)

Objective C

- (void)addSubview:(NSView *)aView

Параметры

aView

Представление для добавления к получателю как подпредставление.

Обсуждение

Этот метод также устанавливает получатель как следующего респондента aView.

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– addSubview:positioned:relativeTo:
подпредставления
– removeFromSuperview
setNextResponder: (NSResponder)
– viewWillMoveToSuperview:
– viewWillMoveToWindow:


    
    addSubview (_: positioned:relativeTo:)
    - addSubview:positioned:relativeTo:

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

Объявление

Swift

func addSubview(_ aView: NSView, positioned place: NSWindowOrderingMode, relativeTo otherView: NSView?)

Objective C

- (void)addSubview:(NSView *)aView positioned:(NSWindowOrderingMode)place relativeTo:(NSView *)otherView

Параметры

`aView`	Объект представления добавить к получателю как подпредставление.
`place`	`enum` постоянное указание позиции `aView` относительно `otherView`. Допустимые значения `NSWindowAbove` или `NSWindowBelow`.
`otherView`	Другое представление `aView` должен быть расположен относительно. Если `otherView` `nil` (или не подпредставление получателя), `aView` добавляется выше или ниже всех его новых одноуровневых элементов.

Обсуждение

Этот метод также устанавливает получатель как следующего респондента aView.

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– addSubview:
подпредставления
– removeFromSuperview
setNextResponder: (NSResponder)

didAddSubview (_:) - didAddSubview:

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

Объявление

Swift

func didAddSubview(_ subview: NSView)

Objective C

- (void)didAddSubview:(NSView *)subview

Параметры

subview

Представление, добавленное как подпредставление.

Обсуждение

Этот метод вызывается addSubview:.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

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

Объявление

Swift

func removeFromSuperview()

Objective C

- (void)removeFromSuperview

Обсуждение

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

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

Никогда не вызывайте этот метод во время дисплея.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– addSubview:
– addSubview:positioned:relativeTo:
– removeFromSuperviewWithoutNeedingDisplay
removeFromSuperviewWithoutNeedingDisplay () - removeFromSuperviewWithoutNeedingDisplay

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

Объявление

Swift

func removeFromSuperviewWithoutNeedingDisplay()

Objective C

- (void)removeFromSuperviewWithoutNeedingDisplay

Обсуждение

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

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– addSubview:
– addSubview:positioned:relativeTo:


    
    replaceSubview (_: с:)
    - replaceSubview:with:

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

Объявление

Swift

func replaceSubview(_ oldView: NSView, with newView: NSView)

Objective C

- (void)replaceSubview:(NSView *)oldView with:(NSView *)newView

Параметры

`oldView`	Представление, которое будет заменено `newView`. Может не быть `nil`.
`newView`	Представление для замены `oldView`. Может не быть `nil`.

Обсуждение

Этот метод ничего не делает если oldView не подпредставление получателя.

Ни один oldView ни newView может быть nil, если любой из этих параметров, и поведение не определено nil.

Этот метод причины oldView быть выпущенным; если Вы планируете снова использовать его, несомненно, сохранят его прежде, чем отправить это сообщение и выпустить его столь же надлежащий при добавлении его как подпредставление другого NSView.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– addSubview:
– addSubview:positioned:relativeTo:


    
    isDescendantOf (_:)
    - isDescendantOf:

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

Объявление

Swift

func isDescendantOf(_ aView: NSView) -> Bool

Objective C

- (BOOL)isDescendantOf:(NSView *)aView

Параметры


      aView

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

Обсуждение

Возвраты метода YEStrue если получатель является или непосредственным или удаленным подпредставлением aView.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

суперпредставление
подпредставления
– ancestorSharedWithView:

opaqueAncestor opaqueAncestor Свойство

Самый близкий непрозрачный наследователь представления, который мог бы быть самим представлением. (только для чтения)

Объявление

Swift

unowned(unsafe) var opaqueAncestor: NSView? { get }

Objective C

@property(readonly, assign) NSView *opaqueAncestor

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

непрозрачный
– displayRectIgnoringOpacity:
– displayIfNeededIgnoringOpacity
– displayIfNeededInRectIgnoringOpacity:


    
    ancestorSharedWithView (_:)
    - ancestorSharedWithView:

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

Объявление

Swift

func ancestorSharedWithView(_ aView: NSView) -> NSView?

Objective C

- (NSView *)ancestorSharedWithView:(NSView *)aView

Параметры


      aView

Представление для тестирования (вместе с получателем) для самого близкого совместно используемого наследователя.

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

Самый близкий наследователь или nil если нет такого объекта. Возвраты self если aView идентично получателю.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– isDescendantOf:


    
    sortSubviewsUsingFunction (_: контекст:)
    - sortSubviewsUsingFunction:context:

Упорядочивает непосредственные подпредставления получателя с помощью указанной функции компаратора.

Объявление

Swift

func sortSubviewsUsingFunction(_ compare: CFunctionPointer<((AnyObject!, AnyObject!, UnsafeMutablePointer<Void>) -> NSComparisonResult)>, context context: UnsafeMutablePointer<Void>)

Objective C

- (void)sortSubviewsUsingFunction:(NSComparisonResult (*)(id, id, void *))compare context:(void *)context

Параметры


      compare

Указатель на функцию компаратора. Эта функция должна взять в качестве параметров два подпредставления, которые будут упорядочены и контекстные данные (предоставленный в context то, которое может быть произвольными данными, раньше помогало в сравнении. Функция компаратора должна возвратиться NSOrderedAscending если первое подпредставление должно быть упорядочено ниже, NSOrderedDescending если второе подпредставление должно быть упорядочено ниже, и NSOrderedSame если их упорядочивание не важно.


      context

Произвольные данные, которые могли бы помочь компаратору функционировать compare в его решениях.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

sortedArrayUsingFunction:context: (NSArray)

viewDidMoveToSuperview () - viewDidMoveToSuperview

Сообщает получателю, что его суперпредставление изменилось (возможно к nil).

Объявление

Swift

func viewDidMoveToSuperview()

Objective C

- (void)viewDidMoveToSuperview

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– viewDidMoveToWindow
– viewWillMoveToSuperview:
– viewWillMoveToWindow:
viewDidMoveToWindow () - viewDidMoveToWindow

Сообщает получателю, что он был добавлен к новой иерархии представления.

Объявление

Swift

func viewDidMoveToWindow()

Objective C

- (void)viewDidMoveToWindow

Обсуждение

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

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– viewDidMoveToSuperview
– viewWillMoveToSuperview:
– viewWillMoveToWindow:


    
    viewWillMoveToSuperview (_:)
    - viewWillMoveToSuperview:

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

Объявление

Swift

func viewWillMoveToSuperview(_ newSuperview: NSView?)

Objective C

- (void)viewWillMoveToSuperview:(NSView *)newSuperview

Параметры


      newSuperview

Объект представления, который будет новым суперпредставлением получателя.

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– viewDidMoveToSuperview
– viewDidMoveToWindow
– viewWillMoveToWindow:


    
    viewWillMoveToWindow (_:)
    - viewWillMoveToWindow:

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

Объявление

Swift

func viewWillMoveToWindow(_ newWindow: NSWindow?)

Objective C

- (void)viewWillMoveToWindow:(NSWindow *)newWindow

Параметры


      newWindow

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

Обсуждение

Когда окно представления изменяется, AppKit вызывает этот метод. Это также вызывает его в случаях, где представление остается в том же окне, но его позиции в его изменениях иерархии представления. Представление, переместившееся также, вызывает этот метод на всех его подпредставлениях, давая каждому из них шанс реагировать на изменение.

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

Когда окно освобождено, AppKit вызывает этот метод для каждого представления в окне, передавая nil для newWindow параметр. AppKit не обязательно вызывает этот метод при закрытии окна, все же. Закрытие окна обычно просто скрывает окно. Закрывшие окна освобождены только если их isReleasedWhenClosed возвраты метода YEStrue.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– viewDidMoveToSuperview
– viewDidMoveToWindow
– viewWillMoveToSuperview:

willRemoveSubview (_:) - willRemoveSubview:

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

Объявление

Swift

func willRemoveSubview(_ subview: NSView)

Objective C

- (void)willRemoveSubview:(NSView *)subview

Параметры

subview

Подпредставление, которое будет удалено.

Обсуждение

Этот метод вызывается когда subview получает a removeFromSuperview сообщение или subview удален из получателя вследствие его добавляемый к другому представлению с addSubview:.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

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

Объявление

Swift

var enclosingMenuItem: NSMenuItem? { get }

Objective C

@property(readonly, strong) NSMenuItem *enclosingMenuItem

Обсуждение

Значение этого свойства nil если представление не находится в пункте меню.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Изменение прямоугольника кадра

кадр кадр Свойство

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

Объявление

Swift

var frame: NSRect

Objective C

@property NSRect frame

Обсуждение

Изменение значения этого свойства меняет местоположение и изменяет размеры получателя в системе координат его суперпредставления. Изменение кадра не отмечает представление как бывший должный быть выведенным на экран. Вызовите setNeedsDisplay: метод, когда Вы хотите, чтобы было восстановлено представление.

Если Ваше представление не использует пользовательский прямоугольник границ, этот метод также устанавливает границы представления для соответствия размера нового кадра. Можно указать пользовательский прямоугольник границ путем изменения bounds свойство или путем вызова setBoundsOrigin:, setBoundsRotation:, или setBoundsSize: метод явно. После того, как набор, представление создает внутреннее преобразование для преобразования от координат кадра до координат границ. Пока отношение ширины к высоте этих двух систем координат остается тем же, Ваше содержание кажется нормальным. Если отношения отличаются, Ваше содержание может казаться скошенным.

Прямоугольник кадра может быть повернут относительно системы координат его суперпредставления. Для получения дополнительной информации посмотрите frameRotation свойство.

Изменение значения этого свойства приводит к регистрации NSViewFrameDidChangeNotification к центру уведомления по умолчанию, если представление сконфигурировано, чтобы сделать так. Можно сконфигурировать это поведение путем вызова setPostsFrameChangedNotifications: метод.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

границы
setFrameOrigin (_:) - setFrameOrigin:

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

Объявление

Swift

func setFrameOrigin(_ newOrigin: NSPoint)

Objective C

- (void)setFrameOrigin:(NSPoint)newOrigin

Параметры

newOrigin

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

Обсуждение

Изменение кадра не отмечает представление как бывший должный быть выведенным на экран. Вызовите setNeedsDisplay: метод, когда Вы хотите, чтобы было восстановлено представление.

Изменение источника кадра приводит к регистрации NSViewFrameDidChangeNotification к центру уведомления по умолчанию, если представление сконфигурировано, чтобы сделать так. Можно сконфигурировать это поведение путем вызова setPostsFrameChangedNotifications: метод.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

кадр
– setFrameSize:
frameRotation
– setPostsFrameChangedNotifications:


    
    setFrameSize (_:)
    - setFrameSize:

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

Объявление

Swift

func setFrameSize(_ newSize: NSSize)

Objective C

- (void)setFrameSize:(NSSize)newSize

Параметры


      newSize

NSSize структура, указывающая новую высоту и ширину прямоугольника кадра.

Обсуждение

Изменение кадра не отмечает представление как бывший должный быть выведенным на экран. Вызовите setNeedsDisplay: метод, когда Вы хотите, чтобы было восстановлено представление.

Изменение типа телосложения приводит к регистрации NSViewFrameDidChangeNotification к центру уведомления по умолчанию, если представление сконфигурировано, чтобы сделать так. Можно сконфигурировать это поведение путем вызова setPostsFrameChangedNotifications: метод.

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

кадр
– setFrameOrigin:
– setPostsFrameChangedNotifications:

frameRotation frameRotation Свойство

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

Объявление

Swift

var frameRotation: CGFloat

Objective C

@property CGFloat frameRotation

Обсуждение

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

Изменение вращения кадра оценивает результаты в регистрации NSViewFrameDidChangeNotification к центру уведомления по умолчанию, если представление сконфигурировано, чтобы сделать так. Можно сконфигурировать это поведение путем вызова setPostsFrameChangedNotifications: метод.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

boundsRotation

Изменение прямоугольника границ

границы границы Свойство

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

Объявление

Swift

var bounds: NSRect

Objective C

@property NSRect bounds

Обсуждение

По умолчанию это свойство содержит прямоугольник, источник которого (0, 0) и чей размер соответствует размер прямоугольника кадра получателя (измеренный в точках). В OS X v10.5 и позже, если получатель представляется в контексте графики OpenGL (использующий NSOpenGLContext объект), источник границ по умолчанию все еще (0, 0), но размер границ по умолчанию измеряется в пикселях вместо точек. Таким образом, для масштабных коэффициентов пространства пользователя кроме 1,0, размер по умолчанию прямоугольника границ может быть больше или меньшим, чем размер по умолчанию прямоугольника кадра при рисовании с OpenGL.

Важный

Разработчики приложений OpenGL не должны полагаться на прямоугольник в этом свойстве для преобразования координат в пиксели автоматически в будущих выпусках. Вместо этого необходимо преобразовать координаты в пространство устройства явно с помощью convertPointToBase:, convertSizeToBase:, или convertRectToBase: методы или их более ранние дубликаты convertPoint:toView:, convertSize:toView:, или convertRect:toView:.

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

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

Изменение значения этого свойства приводит к регистрации NSViewBoundsDidChangeNotification к центру уведомления по умолчанию, если представление сконфигурировано, чтобы сделать так. Можно сконфигурировать это поведение путем вызова setPostsBoundsChangedNotifications: метод.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

кадр
setBoundsOrigin (_:) - setBoundsOrigin:

Устанавливает источник прямоугольника границ получателя к указанной точке,

Объявление

Swift

func setBoundsOrigin(_ newOrigin: NSPoint)

Objective C

- (void)setBoundsOrigin:(NSPoint)newOrigin

Параметры

newOrigin

Точка, указывающая новый источник границ получателя.

Обсуждение

В установке нового источника границ этот метод эффективно смещает систему координат получателя так newOrigin находится в источнике прямоугольника кадра получателя. Это не восстанавливает изображение получателя и не отмечает его как нуждающийся в дисплее. Вызовите setNeedsDisplay: метод, когда Вы хотите, чтобы было восстановлено представление.

Этот метод отправляет NSViewBoundsDidChangeNotification к центру уведомления по умолчанию, если представление сконфигурировано, чтобы сделать так. Можно сконфигурировать это поведение путем вызова setPostsBoundsChangedNotifications: метод.

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– translateOriginToPoint:
границы
boundsRotation
– setBoundsSize:


    
    setBoundsSize (_:)
    - setBoundsSize:

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

Объявление

Swift

func setBoundsSize(_ newSize: NSSize)

Objective C

- (void)setBoundsSize:(NSSize)newSize

Параметры


      newSize

NSSize структура, указывающая новую ширину и высоту прямоугольника границ получателя.

Обсуждение

Например, объект представления с типом телосложения (100.0, 100.0) и размер границ (200.0, 100.0) рисует вдвое менее широкий вдоль оси X. Этот метод не восстанавливает изображение получателя и не отмечает его как нуждающийся в дисплее. Вызовите setNeedsDisplay: метод, когда Вы хотите, чтобы было восстановлено представление.

Этот метод отправляет NSViewBoundsDidChangeNotification к центру уведомления по умолчанию, если представление сконфигурировано, чтобы сделать так. Можно сконфигурировать это поведение путем вызова setPostsBoundsChangedNotifications: метод.

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

границы
– setBoundsOrigin:

boundsRotation boundsRotation Свойство

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

Объявление

Swift

var boundsRotation: CGFloat

Objective C

@property CGFloat boundsRotation

Обсуждение

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

Вращение границ влияет на ориентацию получения в прямоугольнике кадра объекта представления, но не ориентацию самого прямоугольника кадра. Кроме того, для повернутого прямоугольника границ, чтобы включить все видимые области его объекта представления — т.е. гарантировать покрытие по прямоугольнику кадра — это должно также содержать некоторые области, которые не видимы. Это может заставить ненужное получение требоваться, который может влиять на производительность. Может быть лучше во многих случаях повернуть систему координат в drawRect: метод, а не использование этот метод.

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

Изменение значения этого свойства приводит к регистрации NSViewBoundsDidChangeNotification к центру уведомления по умолчанию, если представление сконфигурировано, чтобы сделать так. Можно сконфигурировать это поведение путем вызова setPostsBoundsChangedNotifications: метод.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– rotateByAngle:

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

wantsLayer wantsLayer Свойство

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

Объявление

Swift

var wantsLayer: Bool

Objective C

@property BOOL wantsLayer

Обсуждение

Установка значения этого свойства к YEStrue превращает представление в поддержанное уровнем представление — т.е. представление использует a CALayer объект управлять его представленным содержанием. Создание поддержанного уровнем представления неявно заставляет всю иерархию представления при том представлении становиться поддержанной уровнем. Таким образом представление и все его подпредставления (включая подпредставления подпредставлений) становятся поддержанными уровнем. Значение по умолчанию этого свойства NOfalse.

В поддержанном уровнем представлении любое получение, сделанное представлением, кэшируется к объекту нижележащего слоя. Этим кэшируемым содержанием можно тогда управлять способами, которые более производительны, чем перерисовка содержания представления явно. AppKit автоматически создает объект нижележащего слоя (использование makeBackingLayer метод) и дескрипторы кэширование содержания представления. Если wantsUpdateLayer возвраты метода NOfalse, Вы не должны взаимодействовать с объектом нижележащего слоя непосредственно. Вместо этого используйте методы этого класса для внесения любых изменений в представление и его уровень. Если wantsUpdateLayer возвраты YEStrue, это является приемлемым (и надлежащим) изменить уровень в представлении updateLayer метод.

Для поддержанных уровнем представлений можно сгладить иерархию слоев путем установки canDrawSubviewsIntoLayer свойство к YEStrue. Для препятствования подпредставлению выравнивание его содержания на уровень этого представления явно установите значение подпредставления wantsLayer свойство к YEStrue.

В дополнение к созданию поддержанного уровнем представления можно создать размещающее уровень представление путем присвоения уровня непосредственно представлению layer свойство. В размещающем уровень представлении Вы ответственны за управление уровнем представления. Для создания размещающего уровень представления необходимо установить layer свойство сначала и затем набор это свойство к YEStrue. Порядок, в котором Вы устанавливаете значения этих свойств, крайне важен.

В размещающем уровень представлении не полагайтесь на представление для рисования. Точно так же не добавляйте подпредставления к размещающему уровень представлению. Корневой слой — т.е. уровень Вы устанавливаете использование layer свойство — становится корневым слоем дерева уровня. Любые манипуляции тем деревом уровня должны быть сделаны с помощью Базовых интерфейсов Анимации. Вы все еще используете представление для обработки событий от нажатия мыши и событий клавиатуры, но получение должно быть обработано Базовой Анимацией.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

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

Объявление

Swift

var wantsUpdateLayer: Bool { get }

Objective C

@property(readonly) BOOL wantsUpdateLayer

Обсуждение

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

Если Ваше представление поддерживается уровнем и обновляет себя путем изменения его уровня, переопределите это свойство и измените возвращаемое значение на YEStrue. Изменение уровня значительно быстрее, чем перерисовка использования содержания уровня drawRect:. Если Вы переопределяете это свойство, чтобы быть YEStrue, необходимо также переопределить updateLayer метод Вашего представления и использования это для внесения изменений в уровень. Не изменяйте свой уровень в Вашей реализации этого свойства. Ваша реализация должна возвратиться YEStrue или NOfalse быстро и не выполняют другие задачи.

Если canDrawSubviewsIntoLayer свойство установлено в YEStrue, представление игнорирует значение, возвращенное этим методом. Вместо этого представление всегда использует drawRect: метод для рисования его содержания.

Примечание:

При использовании updateLayer метод для обновления представления рекомендуется установить политику перерисовки представления в NSViewLayerContentsRedrawOnSetNeedsDisplay. Когда Вы хотите обновить содержание уровня, эта политика позволяет Вам управлять.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– updateLayer
уровень уровень Свойство

Базовый Слой анимации, который представление использует в качестве его запоминающего устройства.

Объявление

Swift

var layer: CALayer?

Objective C

@property(strong) CALayer *layer

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

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

Объявление

Swift

func makeBackingLayer() -> CALayer

Objective C

- (CALayer *)makeBackingLayer

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

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Политика размещения содержания текущего слоя.

Объявление

Swift

var layerContentsPlacement: NSViewLayerContentsPlacement

Objective C

@property NSViewLayerContentsPlacement layerContentsPlacement

Обсуждение

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

Для получения дополнительной информации о влиянии производительности этого свойства посмотрите layerContentsRedrawPolicy свойство.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

layerContentsRedrawPolicy
layerContentsRedrawPolicy layerContentsRedrawPolicy Свойство

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

Объявление

Swift

var layerContentsRedrawPolicy: NSViewLayerContentsRedrawPolicy

Objective C

@property NSViewLayerContentsRedrawPolicy layerContentsRedrawPolicy

Обсуждение

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

Для представления, не имеющего никакого связанного уровня, или это было присвоено предоставленный разработчиками уровень (размещающее уровень представление) использование layer свойство, политика перерисовки содержания по умолчанию NSViewLayerContentsRedrawNever и layerContentsPlacement свойство установлено в NSViewLayerContentsPlacementScaleAxesIndependently. Эти политики говорят AppKit не заменять содержание уровня и обеспечивать то же размещение содержания как kCAGravityResize опция. Для поддержанного уровнем представления — т.е. представление, для которого AppKit создал уровень — AppKit, устанавливает политику перерисовки содержания в NSViewLayerContentsRedrawDuringViewResize по умолчанию. Эта политика вынуждает содержание представления постоянно перерисовываться на уровень поддержки представления во время анимированного изменения размеров представления, производящего корректный, но не оптимальные результаты производительности.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

layerContentsRedrawPolicy
canDrawSubviewsIntoLayer canDrawSubviewsIntoLayer Свойство

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

Объявление

Swift

var canDrawSubviewsIntoLayer: Bool

Objective C

@property BOOL canDrawSubviewsIntoLayer

Обсуждение

Когда значение этого свойства YEStrue, любые подпредставления, имеющие неявно создаваемый уровень — т.е. уровни, для которых Вы явно не устанавливали wantsLayer свойство к YEStrue— вовлеките их содержание в уровень текущего представления. Другими словами, подпредставления не получают собственный уровень. Вместо этого они вовлекают свое содержание в уровень родительского представления. Все представления, вовлеченные в работу, рисуют свое содержание с помощью их drawRect: метод. Они не используют updateLayer метод для обновления их содержания уровня, даже если wantsUpdateLayer свойство установлено в YEStrue.

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

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Булево значение, указывающее, фильтрует ли Изображение Ядра использования уровня представления и нуждается в незавершенном рендеринге.

Объявление

Swift

var layerUsesCoreImageFilters: Bool

Objective C

@property BOOL layerUsesCoreImageFilters

Обсуждение

Если Ваше представление использует пользовательский уровень, и Вы присвоили Базовое Изображение тому уровню непосредственно, необходимо установить это свойство в YEStrue сообщить AppKit того факта. В OS X v10.9 и позже, AppKit предпочитает представлять деревья уровня из процесса, но не может сделать так, если какие-либо уровни имеют Базовые фильтры Изображения, присоединенные к ним. Указание YEStrue поскольку свойство позволяет AppKit знать, что это должно положить обратно рендеринг иерархии слоев в процесс Вашего приложения. Если значение этого свойства NOfalse, добавление фильтра к уровню представления инициировало исключение.

Вы не должны изменять это свойство при присвоении фильтров с помощью backgroundFilters, compositingFilter, или contentFilters свойства представления. Те методы автоматически позволяют AppKit знать, что он должен представить незавершенную иерархию слоев. Установите его, только если Вы устанавливаете фильтры на уровне непосредственно.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– setLayerUsesCoreImageFilters:

Управление связанными с уровнем свойствами

alphaValue alphaValue Свойство

Непрозрачность представления.

Объявление

Swift

var alphaValue: CGFloat

Objective C

@property CGFloat alphaValue

Обсуждение

Это свойство содержит opacity значение от уровня представления. Приемлемый диапазон значений для этого свойства между 0.0 (прозрачный) и 1.0 (непрозрачный). Значение по умолчанию этого свойства 1.0.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

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

Объявление

Swift

var frameCenterRotation: CGFloat

Objective C

@property CGFloat frameCenterRotation

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Массив Базового Изображения фильтрует для применения к фону представления.

Объявление

Swift

var backgroundFilters: [AnyObject]

Objective C

@property(copy) NSArray *backgroundFilters

Обсуждение

Это свойство содержит массив CIFilter объекты. Этот массив представляет фоновые фильтры, сохраненные в backgroundFilters свойство уровня представления. Если представление не имеет уровня, устанавливание значения этого свойства не имеет никакого эффекта.

Значение по умолчанию этого свойства является пустым массивом.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Базовый фильтр Изображения раньше составлял содержание представления с его фоном.

Объявление

Swift

var compositingFilter: CIFilter?

Objective C

@property(strong) CIFilter *compositingFilter

Обсуждение

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

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Массив Базового Изображения фильтрует для применения к содержанию представления и его подуровней.

Объявление

Swift

var contentFilters: [AnyObject]

Objective C

@property(copy) NSArray *contentFilters

Обсуждение

Это свойство содержит массив CIFilter объекты. Этот массив представляет фильтры, сохраненные в filters свойство уровня представления. Если представление не имеет уровня, устанавливание значения этого свойства не имеет никакого эффекта.

Значение по умолчанию этого свойства является пустым массивом.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Тень, выведенная на экран под представлением.

Объявление

Swift

@NSCopying var shadow: NSShadow?

Objective C

@property(copy) NSShadow *shadow

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

Экземпляр NSShadow это создается с помощью shadowColor,shadowOffset, shadowOpacity и shadowRadius свойства уровня получателя.

Обсуждение

Значение по умолчанию этого свойства обычно nil. Когда Вы конфигурируете любое из связанных с тенью свойств на уровне представления, такой как shadowColor,shadowOffset, shadowOpacity или shadowRadius свойства, это свойство содержит NSShadow объект, инкапсулирующий ту информацию. Присвоение нового теневого объекта к этому наборы свойств соответствующие связанные с тенью свойства на уровне представления.

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Рисование

updateLayer () - updateLayer

Обновляет содержание представления путем изменения его нижележащего слоя.

Объявление

Swift

func updateLayer()

Objective C

- (void)updateLayer

Обсуждение

Вы используете этот метод для оптимизации рендеринга представления в ситуациях, где можно представлять содержание представлений полностью с помощью расположенного на слое объекта. Если Ваше представление wantsUpdateLayer свойство YEStrue, представление вызывает этот метод вместо drawRect: во время представления обновляют цикл. Пользовательские представления могут переопределить этот метод и использовать его для изменения свойств объекта нижележащего слоя. Изменение свойств слоя является намного более эффективным способом обновить Ваше представление, чем перерисовывает его содержание каждый раз, когда что-то изменяется.

Когда Вы захотите обновить содержание своего уровня, отметьте представление как грязное путем вызова setNeedsDisplay: метод со значением YEStrue. Выполнение так добавляет представление к списку представлений, которые должны быть обновлены во время следующего цикла обновления. Во время того цикла обновления этот метод вызывают еслиwantsUpdateLayer свойство тихо YEStrue.

Ваша реализация этого метода не должна вызывать super.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

wantsUpdateLayer


    
    drawRect (_:)
    - drawRect:

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

Объявление

Swift

func drawRect(_ dirtyRect: NSRect)

Objective C

- (void)drawRect:(NSRect)dirtyRect

Параметры


      dirtyRect

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

Обсуждение

Используйте этот метод для рисования указанной части содержания представления. Ваша реализация этого метода должна быть максимально быстро и действительно как можно меньше работает. dirtyRect параметр помогает Вам достигнуть лучшей производительности путем указания части представления, которое должно быть нарисовано. Необходимо всегда ограничивать получение содержанием в этом прямоугольнике. Для еще лучшей производительности можно вызвать getRectsBeingDrawn:count: метод и использование список прямоугольников, возвращенных тем методом для ограничения получения еще больше. Можно также использовать needsToDrawRect: тест метода, должны ли быть нарисованы объекты в определенном прямоугольнике.

Реализация по умолчанию ничего не делает. Подклассы должны переопределить этот метод, если они делают пользовательское получение. До вызова этого метода AppKit создает надлежащий контекст получения и конфигурирует его для рисования к представлению; Вы не должны конфигурировать контекст получения сами. Если Ваше приложение управляет содержанием с помощью своего расположенного на слое объекта вместо этого, используйте updateLayer метод для обновления уровня вместо того, чтобы переопределить этот метод.

Если Ваше пользовательское представление является прямым NSView подкласс, Вы не должны вызывать super. Для всех других представлений вызвать super в некоторый момент в Вашей реализации так, чтобы родительский класс мог выполнить любое дополнительное получение.

Для получения информации о том, как нарисовать в Вашем приложении, посмотрите, что Какао Рисует Руководство.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– дисплей
– getRectsBeingDrawn:count:
зеркально отраженный
– needsToDrawRect:
– setNeedsDisplayInRect:
– shouldDrawColor
– updateLayer

canDraw canDraw Свойство

Булево значение, указывающее, приведут ли команды рисования к каким-либо результатам. (только для чтения)

Объявление

Swift

var canDraw: Bool { get }

Objective C

@property(readonly) BOOL canDraw

Обсуждение

Значение этого свойства YEStrue когда получение приводит к ожидаемым результатам. Объект представления может нарисовать на экране, если он не скрыт, он присоединен к иерархии представления в окне (NSWindow), и окно имеет соответствующее устройство окна. Объект представления может также нарисовать во время печати, если это - потомок распечатываемого представления.

Проверьте значение этого свойства прежде, чем попытаться вызвать получение к определенному контексту. Например, если значение этого свойства NOfalse, не вызывать lockFocus или действительно выпустите любые команды рисования от представления. Вы не должны проверять, может ли получение произойти при вызове display метод или любой из его связанных методов. Методы дисплея выполняют надлежащие проверки прежде, чем попросить, чтобы представление нарисовало себя.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

скрытый
canDrawConcurrently canDrawConcurrently Свойство

Булево значение, указывающее, может ли представление нарисовать свое содержание на фоновом потоке.

Объявление

Swift

var canDrawConcurrently: Bool

Objective C

@property BOOL canDrawConcurrently

Обсуждение

Если Ваше представление drawRect: реализация может нарисовать безопасно на фоновом потоке, установить это свойство в YEStrue. Выполнение так предоставляет AppKit возможность выполнить код для прорисовки Вашего представления от основного потока приложения, который может улучшить производительность. Окно представления должно также иметь allowsConcurrentViewDrawing набор свойств к YEStrue (значение по умолчанию) для потокового получения представления для появления.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Часть представления, не отсекающегося его суперпредставлениями. (только для чтения)

Объявление

Swift

var visibleRect: NSRect { get }

Objective C

@property(readonly) NSRect visibleRect

Обсуждение

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

Во время работы печати видимый прямоугольник далее отсекается к отображаемой странице.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

скрытый
isVisible (NSWindow)
documentVisibleRect (NSScrollView)
documentVisibleRect (NSClipView)


    
    getRectsBeingDrawn (_: количество:)
    - getRectsBeingDrawn:count:

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

Объявление

Swift

func getRectsBeingDrawn(_ rects: UnsafeMutablePointer<UnsafePointer<NSRect>>, count count: UnsafeMutablePointer<Int>)

Objective C

- (void)getRectsBeingDrawn:(const NSRect **)rects count:(NSInteger *)count

Параметры

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

Обсуждение

Реализация drawRect: может использовать эту информацию для тестирования или объекты, или области в представлении пересекаются с прямоугольниками в списке, и таким образом избегают ненужного получения, которое было бы полностью отсечено далеко.

needsToDrawRect: метод дает Вам удобный способ протестировать отдельные объекты на пересечение с областью, нарисованной в drawRect:. Однако можно хотеть получить и непосредственно проверить прямоугольный список, если это - более эффективный способ выполнить перекрестное тестирование.

Необходимо отправить это сообщение только из a drawRect: реализация. aRect параметр drawRect: прямоугольник, включающий возвращенный список прямоугольников; можно использовать его в начальной передаче для отклонения объектов, которые являются ясно вне области, которая будет нарисована.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

wantsDefaultClipping

needsToDrawRect (_:) - needsToDrawRect:

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

Объявление

Swift

func needsToDrawRect(_ aRect: NSRect) -> Bool

Objective C

- (BOOL)needsToDrawRect:(NSRect)aRect

Параметры

aRect

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

Обсуждение

Вы обычно отправляете это сообщение из a drawRect: реализация. Это дает Вам удобный способ определить, ли какая-либо часть данного графического объекта, возможно, должна была бы быть нарисована. Это оптимизировано для эффективного отклонения любого прямоугольника, находящегося вне ограничительной рамки области, которую получатель просят подойти к концу drawRect:.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Булево значение, указывающее, имеет ли отсечение AppKit по умолчанию поведения силу. (только для чтения)

Объявление

Swift

var wantsDefaultClipping: Bool { get }

Objective C

@property(readonly) BOOL wantsDefaultClipping

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

YEStrue если отсечение по умолчанию имеет силу, NOfalse иначе. По умолчанию, этот метод возвраты YEStrue.

Обсуждение

Значение по умолчанию этого свойства YEStrue. Когда значение этого свойства YEStrue, AppKit устанавливает текущую область отсечения в границы представления до вызова что представление drawRect: метод. Подклассы могут переопределить это свойство и возврат NOfalse подавить это поведение отсечения значения по умолчанию. Вы могли бы сделать это для предотвращения стоимости установки, осуществления и очистки траектории отсечения. Если Вы действительно изменяете значение на NOfalse, Вы ответственны за то, что сделали Ваше собственное отсечение или ограничение получения соответственно. Отказ сделать так мог представление для повреждения содержания других представлений в окне.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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


    
    bitmapImageRepForCachingDisplayInRect (_:)
    - bitmapImageRepForCachingDisplayInRect:

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

Объявление

Swift

func bitmapImageRepForCachingDisplayInRect(_ aRect: NSRect) -> NSBitmapImageRep?

Objective C

- (NSBitmapImageRep *)bitmapImageRepForCachingDisplayInRect:(NSRect)aRect

Параметры


      aRect

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

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

Автовыпущенный NSBitmapImageRep объект или nil если не мог бы быть создан объект.

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– cacheDisplayInRect:toBitmapImageRep:


    
    cacheDisplayInRect (_: toBitmapImageRep:)
    - cacheDisplayInRect:toBitmapImageRep:

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

Объявление

Swift

func cacheDisplayInRect(_ rect: NSRect, toBitmapImageRep bitmapImageRep: NSBitmapImageRep)

Objective C

- (void)cacheDisplayInRect:(NSRect)rect toBitmapImageRep:(NSBitmapImageRep *)bitmapImageRep

Параметры

`rect`	Прямоугольник, определяющий область, которая будет вовлечена `bimapImageRep`.
`bitmapImageRep`	`NSBitmapImageRep` объект. Для совместимости формата пикселя, `bitmapImageRep` должен был быть получен из `bitmapImageRepForCachingDisplayInRect:`.

Обсуждение

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

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– bitmapImageRepForCachingDisplayInRect:

Печать

печать (_:) - печать:

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

Объявление

Swift

func print(_ sender: AnyObject?)

Objective C

- (void)print:(id)sender

Параметры

sender

Объект, отправивший сообщение.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– dataWithEPSInsideRect:
– writeEPSInsideRect:toPasteboard:


    
    beginPageInRect (_: atPlacement:)
    - beginPageInRect:atPlacement:

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

Объявление

Swift

func beginPageInRect(_ aRect: NSRect, atPlacement location: NSPoint)

Objective C

- (void)beginPageInRect:(NSRect)aRect atPlacement:(NSPoint)location

Параметры

`aRect`	Прямоугольник, определяющий область, которая будет переведена.
`location`	Точка, которая является конечной точкой перевода.

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

dataWithEPSInsideRect (_:) - dataWithEPSInsideRect:

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

Объявление

Swift

func dataWithEPSInsideRect(_ aRect: NSRect) -> NSData

Objective C

- (NSData *)dataWithEPSInsideRect:(NSRect)aRect

Параметры

aRect

Прямоугольник, определяющий область.

Обсуждение

Эти данные могут быть помещены в NSPasteboard объект, записанный в файл или используемый для создания NSImage объект.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– writeEPSInsideRect:toPasteboard:
dataWithPDFInsideRect (_:) - dataWithPDFInsideRect:

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

Объявление

Swift

func dataWithPDFInsideRect(_ aRect: NSRect) -> NSData

Objective C

- (NSData *)dataWithPDFInsideRect:(NSRect)aRect

Параметры

aRect

Прямоугольник, определяющий область.

Обсуждение

Эти данные могут быть помещены в NSPasteboard объект, записанный в файл или используемый для создания NSImage объект.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– writePDFInsideRect:toPasteboard:
printJobTitle printJobTitle Свойство

Должность печати представления. (только для чтения)

Объявление

Swift

var printJobTitle: String { get }

Objective C

@property(readonly, copy) NSString *printJobTitle

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Строка заголовка по умолчанию, включающая должность печати и дату. (только для чтения)

Объявление

Swift

@NSCopying var pageHeader: NSAttributedString { get }

Objective C

@property(readonly, copy) NSAttributedString *pageHeader

Обсуждение

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

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

pageFooter
pageFooter pageFooter Свойство

Строка нижнего колонтитула по умолчанию, включающая текущий номер страницы и количество страницы. (только для чтения)

Объявление

Swift

@NSCopying var pageFooter: NSAttributedString { get }

Objective C

@property(readonly, copy) NSAttributedString *pageFooter

Обсуждение

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

Нижние колонтитулы сгенерированы, только если пользовательские значения по умолчанию содержат ключ NSPrintHeaderAndFooter со значением YEStrue.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

pageHeader


    
    writeEPSInsideRect (_: toPasteboard:)
    - writeEPSInsideRect:toPasteboard:

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

Объявление

Swift

func writeEPSInsideRect(_ aRect: NSRect, toPasteboard pboard: NSPasteboard)

Objective C

- (void)writeEPSInsideRect:(NSRect)aRect toPasteboard:(NSPasteboard *)pboard

Параметры

`aRect`	Прямоугольник, определяющий область.
`pboard`	Объект, представляющий область монтажа.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– dataWithEPSInsideRect:


    
    writePDFInsideRect (_: toPasteboard:)
    - writePDFInsideRect:toPasteboard:

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

Объявление

Swift

func writePDFInsideRect(_ aRect: NSRect, toPasteboard pboard: NSPasteboard)

Objective C

- (void)writePDFInsideRect:(NSRect)aRect toPasteboard:(NSPasteboard *)pboard

Параметры

`aRect`	Прямоугольник, определяющий область.
`pboard`	Объект, представляющий область монтажа.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– dataWithPDFInsideRect:

drawPageBorderWithSize (_:) - drawPageBorderWithSize:

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

Объявление

Swift

func drawPageBorderWithSize(_ borderSize: NSSize)

Objective C

- (void)drawPageBorderWithSize:(NSSize)borderSize

Параметры

borderSize

NSSize структура, определяющая логическую страницу.

Обсуждение

Метки могут быть такими вещами как метки выравнивания или виртуальная граница листа размера borderSize. Реализация по умолчанию ничего не рисует.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– drawSheetBorderWithSize:
drawSheetBorderWithSize (_:) - drawSheetBorderWithSize:

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

Объявление

Swift

func drawSheetBorderWithSize(_ borderSize: NSSize)

Objective C

- (void)drawSheetBorderWithSize:(NSSize)borderSize

Параметры

borderSize

NSSize структура, определяющая печатный лист.

Обсуждение

Метки могут быть такими вещами как метки обрезки или свернуть строки размера borderSize. Этот метод был осужден.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– drawPageBorderWithSize:

Разбиение на страницы

heightAdjustLimit heightAdjustLimit Свойство

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

Объявление

Swift

var heightAdjustLimit: CGFloat { get }

Objective C

@property(readonly) CGFloat heightAdjustLimit

Обсуждение

Значение этого свойства является числом с плавающей точкой в диапазоне 0.0 к 1.0. Эта часть используется для вычисления предела базового края для adjustPageHeightNew:top:bottom:limit: сообщение.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

widthAdjustLimit
widthAdjustLimit widthAdjustLimit Свойство

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

Объявление

Swift

var widthAdjustLimit: CGFloat { get }

Objective C

@property(readonly) CGFloat widthAdjustLimit

Обсуждение

Значение этого свойства является числом с плавающей точкой в диапазоне 0.0 к 1.0. Эта часть используется для вычисления предела правого края для a adjustPageWidthNew:left:right:limit: сообщение.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

heightAdjustLimit


    
    adjustPageWidthNew (_: left:right:limit:)
    - adjustPageWidthNew:left:right:limit:

Переопределенный подклассами для корректировки страницы width во время автоматического разбиения на страницы.

Объявление

Swift

func adjustPageWidthNew(_ newRight: UnsafeMutablePointer<CGFloat>, left left: CGFloat, right proposedRight: CGFloat, limit rightLimit: CGFloat)

Objective C

- (void)adjustPageWidthNew:(CGFloat *)newRight left:(CGFloat)left right:(CGFloat)proposedRight limit:(CGFloat)rightLimit

Параметры

`newRight`	Возвраты косвенно новое `float` значение для правого края незаконченного прямоугольника страницы в системе координат получателя.
`left`	A `float` значение, устанавливающее левый край незаконченного прямоугольника страницы в системе координат получателя.
`proposedRight`	A `float` значение, устанавливающее правый край незаконченного прямоугольника страницы в системе координат получателя.
`rightLimit`	Крайнее левое `float` значение `newRight` может быть установлен в, как вычислено использование значения `widthAdjustLimit` свойство.

Обсуждение

Этот метод вызывается print:. Получатель может вытянуть в правом краю и возвратить новое значение в newRight, разрешение его предотвратить элементы, такие как маленькие изображения или столбцы текста от того, чтобы быть разделенным через страницы. Если rightLimit превышен, механизм разбиения на страницы просто использует rightLimit для правого края.

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– adjustPageHeightNew:top:bottom:limit:


    
    adjustPageHeightNew (_: top:bottom:limit:)
    - adjustPageHeightNew:top:bottom:limit:

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

Объявление

Swift

func adjustPageHeightNew(_ newBottom: UnsafeMutablePointer<CGFloat>, top top: CGFloat, bottom proposedBottom: CGFloat, limit bottomLimit: CGFloat)

Objective C

- (void)adjustPageHeightNew:(CGFloat *)newBottom top:(CGFloat)top bottom:(CGFloat)proposedBottom limit:(CGFloat)bottomLimit

Параметры

`newBottom`	Возвраты косвенно новое `float` значение для базового края незаконченного прямоугольника страницы в системе координат получателя.
`top`	A `float` значение, устанавливающее главный край незаконченного прямоугольника страницы в системе координат получателя.
`proposedBottom`	A `float` значение, устанавливающее базовый край незаконченного прямоугольника страницы в системе координат получателя.
`bottomLimit`	Самое верхнее значение плавающее `newBottom` может быть установлен в, как вычислено использование значения `heightAdjustLimit` свойство.

Обсуждение

Этот метод вызывается print:. Получатель может повысить базовый край и возвратить новое значение в newBottom, разрешение его предотвратить элементы, такие как строки текста от того, чтобы быть разделенным через страницы. Если bottomLimit превышен, механизм разбиения на страницы просто использует bottomLimit для базового края.

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– adjustPageWidthNew:left:right:limit:


    
    knowsPageRange (_:)
    - knowsPageRange:

Возвраты YEStrue если получатель обрабатывает границы страницы, NOfalse иначе.

Объявление

Swift

func knowsPageRange(_ aRange: NSRangePointer) -> Bool

Objective C

- (BOOL)knowsPageRange:(NSRangePointer)aRange

Параметры


      aRange

По возврату, содержит диапазон страницы если YEStrue возвращается непосредственно. Номера страниц на основе одни — который является страницами, выполненными от одного до N.

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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


    
    rectForPage (_:)
    - rectForPage:

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

Объявление

Swift

func rectForPage(_ pageNumber: Int) -> NSRect

Objective C

- (NSRect)rectForPage:(NSInteger)pageNumber

Параметры


      pageNumber

Целое число, указывающее номер страницы. Номера страниц на основе одни — который является страницами, выполненными от одного до N.

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

Прямоугольник, определяющий область получателя, который будет распечатан для pageNumber. Этот метод возвраты NSZeroRect если pageNumber вне границ получателя.

Обсуждение

Если ответил получатель YEStrue к более раннему knowsPageRange: сообщение, этот метод вызывается для каждой страницы, которую это указало в параметры того сообщения. Получатель позже сделан вывести на экран этот прямоугольник для генерации изображения для этой страницы.

Если NSView объект отвечает NOfalse к knowsPageRange:, этот метод не вызывается механизмом печати.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– adjustPageHeightNew:top:bottom:limit:
– adjustPageWidthNew:left:right:limit:


    
    locationOfPrintRect (_:)
    - locationOfPrintRect:

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

Объявление

Swift

func locationOfPrintRect(_ aRect: NSRect) -> NSPoint

Objective C

- (NSPoint)locationOfPrintRect:(NSRect)aRect

Параметры


      aRect

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

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

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

Обсуждение

Места реализации по умолчанию aRect согласно состоянию NSPrintInfo объект для задания печати. По умолчанию это помещает изображение в верхний левый угол страницы, но если NSPrintInfo методы isHorizontallyCentered или isVerticallyCentered возвратиться YEStrue, это центрирует изображение единственной страницы вдоль надлежащей оси. Документ многократной страницы, однако, всегда помещается так, разделенные части могут быть собраны в их краях.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Лишение законной силы содержания представления


    
    setNeedsDisplay:
    - setNeedsDisplay:

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

Объявление

Swift

var needsDisplay: Bool

Objective C

@property BOOL needsDisplay

Параметры


      flag

Если YEStrue, отмечает все границы получателя как нуждающийся в дисплее; если NOfalse, метки это как не нуждающийся в дисплее.

Обсуждение

Каждый раз, когда данные или состояние, используемое для рисования объекта представления изменения, представление должно быть отправлено setNeedsDisplay: сообщение. NSView объекты, отмеченные как нуждающийся в дисплее, автоматически восстановлены на каждом, проходят через цикл событий приложения. (Объекты представления, которые должны восстановить изображение перед циклом событий, приходят, может, конечно, сразу быть отправлен надлежащее display... метод.)

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– setNeedsDisplayInRect:
– needsDisplay


    
    setNeedsDisplayInRect (_:)
    - setNeedsDisplayInRect:

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

Объявление

Swift

func setNeedsDisplayInRect(_ invalidRect: NSRect)

Objective C

- (void)setNeedsDisplayInRect:(NSRect)invalidRect

Параметры


      invalidRect

Прямоугольная область получателя для маркировки как недопустимый; это должно быть указано в системе координат получателя.

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– setNeedsDisplay:
– needsDisplay

needsDisplay needsDisplay Свойство

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

Объявление

Swift

var needsDisplay: Bool

Objective C

@property BOOL needsDisplay

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Выводит на экран получатель и все его подпредставления, если это возможно, вызывая каждый из NSView методы lockFocus, drawRect:, и unlockFocus по мере необходимости.

Объявление

Swift

func display()

Objective C

- (void)display

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

canDraw
opaqueAncestor
visibleRect
– displayIfNeededIgnoringOpacity


    
    displayRect (_:)
    - displayRect:

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

Объявление

Swift

func displayRect(_ aRect: NSRect)

Objective C

- (void)displayRect:(NSRect)aRect

Параметры


      aRect

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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


    
    displayRectIgnoringOpacity (_:)
    - displayRectIgnoringOpacity:

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

Объявление

Swift

func displayRectIgnoringOpacity(_ aRect: NSRect)

Objective C

- (void)displayRectIgnoringOpacity:(NSRect)aRect

Параметры


      aRect

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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


    
    displayRectIgnoringOpacity (_: inContext:)
    - displayRectIgnoringOpacity:inContext:

Заставляет получатель и его потомков быть перерисованным к указанному графическому контексту.

Объявление

Swift

func displayRectIgnoringOpacity(_ aRect: NSRect, inContext context: NSGraphicsContext)

Objective C

- (void)displayRectIgnoringOpacity:(NSRect)aRect inContext:(NSGraphicsContext *)context

Параметры

`aRect`	Прямоугольник, определяющий область получателя, который будет перерисован. Это должно быть указано в системе координат получателя.
`context`	Графический контекст, в котором произойдет получение. Посмотрите обсуждение ниже для больше об этом параметре.

Обсуждение

Акты как display, но получение ограничений к aRect. Даже если получатель не непрозрачен, этот метод инициирует получение с получателем. Надлежащие масштабные коэффициенты для представления получены из context.

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

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

displayIfNeeded () - displayIfNeeded

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

Объявление

Swift

func displayIfNeeded()

Objective C

- (void)displayIfNeeded

Обсуждение

Этот метод вызывает NSView методы lockFocus, drawRect:, и unlockFocus по мере необходимости. Если получатель не непрозрачен, этот метод копирует иерархию представления первому непрозрачному наследователю, вычисляет часть непрозрачного наследователя, покрытого получателем, и начинает отображать оттуда.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

needsDisplay
– дисплей
– displayIfNeededIgnoringOpacity


    
    displayIfNeededInRect (_:)
    - displayIfNeededInRect:

Акты как displayIfNeeded, ограничение получения к указанной области получателя..

Объявление

Swift

func displayIfNeededInRect(_ aRect: NSRect)

Objective C

- (void)displayIfNeededInRect:(NSRect)aRect

Параметры


      aRect

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

displayIfNeededIgnoringOpacity () - displayIfNeededIgnoringOpacity

Акты как displayIfNeeded, за исключением того, что этот метод не отступает до первого непрозрачного наследователя — он просто заставляет получатель и его потомков выполнять их код для прорисовки.

Объявление

Swift

func displayIfNeededIgnoringOpacity()

Objective C

- (void)displayIfNeededIgnoringOpacity

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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


    
    displayIfNeededInRectIgnoringOpacity (_:)
    - displayIfNeededInRectIgnoringOpacity:

Акты как displayIfNeeded, но ограничение получения к aRect и не отступая до первого непрозрачного наследователя — это просто заставляет получатель и его потомков выполнять их код для прорисовки.

Объявление

Swift

func displayIfNeededInRectIgnoringOpacity(_ aRect: NSRect)

Objective C

- (void)displayIfNeededInRectIgnoringOpacity:(NSRect)aRect

Параметры


      aRect

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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


    
    translateRectsNeedingDisplayInRect (_::)
    - translateRectsNeedingDisplayInRect:by:

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

Объявление

Swift

func translateRectsNeedingDisplayInRect(_ clipRect: NSRect, by delta: NSSize)

Objective C

- (void)translateRectsNeedingDisplayInRect:(NSRect)clipRect by:(NSSize)delta

Параметры

`clipRect`	Прямоугольник, определяющий область получателя, обычно границы получателя.
`delta`	Структура NSSize, указывающая смещение от от источника aRect.

Обсуждение

Этот метод выполняет смещение грязных прямоугольников что эквивалент scrollRect:by: работа вызвала бы, не выполняя фактическую работу прокрутки. Только полезно в очень редких случаях, где представление реализует свою собственную низкоуровневую механику прокрутки.

Этот метод:

Собирает грязные прямоугольники представления получения.
Очищает все грязные прямоугольники в пересечении clipRect и границы представления.
Смещает полученные прямоугольники на delta смещение.
Отсекает результат к пересечению clipRect и границы представления
Отмечает результирующие прямоугольники как нуждающийся в дисплее.

Разработчик должен гарантировать это clipRect и delta выравниваются пикселем для гарантии корректного получения. Посмотрите Координаты Представления Преобразования К и От Основного Пространства для описания того, как к пикселю - выравнивают координаты представления.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

непрозрачный непрозрачный Свойство

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

Объявление

Swift

var opaque: Bool { get }

Objective C

@property(getter=isOpaque, readonly) BOOL opaque

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

opaqueAncestor
– displayRectIgnoringOpacity:
– displayIfNeededIgnoringOpacity
– displayIfNeededInRectIgnoringOpacity:
viewWillDraw () - viewWillDraw
Сообщает получателю, что он потребуется, чтобы рисовать содержание.

Объявление

Swift

func viewWillDraw()

Objective C

- (void)viewWillDraw
Обсуждение

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

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

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

Следующее является примером универсальной реализации подкласса:
- (void)viewWillDraw {

// Perform some operations before recursing for descendants.

// Now recurse to handle all our descendants.

// Overrides must call up to super like this.

[super viewWillDraw];

// Perform some operations that might depend on descendants

// already having had a chance to update.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Преобразование координатных значений


    
    backingAlignedRect (_: опции:)
    - backingAlignedRect:options:

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

Объявление

Swift

func backingAlignedRect(_ aRect: NSRect, options options: NSAlignmentOptions) -> NSRect

Objective C

- (NSRect)backingAlignedRect:(NSRect)aRect options:(NSAlignmentOptions)options

Параметры

`aRect`	Прямоугольник в поле зрения координирует.
`options`	Опции выравнивания. Посмотрите `NSAlignmentOptions` для возможных значений.

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

Прямоугольник, который является выровненный к пикселям запоминающего устройства с помощью указанных опций. Прямоугольник находится в координатах окна.

Обсуждение

Использование NSIntegralRectWithOptions функционируйте для создания выровненного прямоугольника пикселя запоминающего устройства из данного входного прямоугольника в координатах окна.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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


    
    convertPointFromBacking (_:)
    - convertPointFromBacking:

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

Объявление

Swift

func convertPointFromBacking(_ aPoint: NSPoint) -> NSPoint

Objective C

- (NSPoint)convertPointFromBacking:(NSPoint)aPoint

Параметры


      aPoint

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

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

Точка во внутренней системе координат представления.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– convertPointToBacking:

convertPointToBacking (_:) - convertPointToBacking:

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

Объявление

Swift

func convertPointToBacking(_ aPoint: NSPoint) -> NSPoint

Objective C

- (NSPoint)convertPointToBacking:(NSPoint)aPoint

Параметры

aPoint

Точка во внутренней системе координат представления.

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

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– convertPointFromBacking:
convertPointFromLayer (_:) - convertPointFromLayer:

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

Объявление

Swift

func convertPointFromLayer(_ aPoint: NSPoint) -> NSPoint

Objective C

- (NSPoint)convertPointFromLayer:(NSPoint)aPoint

Параметры

aPoint

Точка во внутренней системе координат уровня.

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

Точка во внутренней системе координат представления.

Обсуждение

Пространство уровня является виртуальным, и не принимает во внимание уровень contentsScale установка.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– convertPointToLayer:
convertPointToLayer (_:) - convertPointToLayer:

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

Объявление

Swift

func convertPointToLayer(_ aPoint: NSPoint) -> NSPoint

Objective C

- (NSPoint)convertPointToLayer:(NSPoint)aPoint

Параметры

aPoint

Точка во внутренней системе координат представления.

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

Точка во внутренней системе координат уровня представления.

Обсуждение

Пространство уровня является виртуальным, и не принимает во внимание уровень contentsScale установка.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– convertPointFromLayer:


    
    convertRectFromBacking (_:)
    - convertRectFromBacking:

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

Объявление

Swift

func convertRectFromBacking(_ aRect: NSRect) -> NSRect

Objective C

- (NSRect)convertRectFromBacking:(NSRect)aRect

Параметры


      aRect

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

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

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– convertRectToBacking:

convertRectToBacking (_:) - convertRectToBacking:

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

Объявление

Swift

func convertRectToBacking(_ aRect: NSRect) -> NSRect

Objective C

- (NSRect)convertRectToBacking:(NSRect)aRect

Параметры

aRect

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

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

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– convertRectFromBacking:
convertRectFromLayer (_:) - convertRectFromLayer:

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

Объявление

Swift

func convertRectFromLayer(_ aRect: NSRect) -> NSRect

Objective C

- (NSRect)convertRectFromLayer:(NSRect)aRect

Параметры

aRect

Прямоугольник во внутренней системе координат уровня.

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

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

Обсуждение

Пространство уровня является виртуальным, и не принимает во внимание уровень contentsScale установка.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– convertRectToLayer:
convertRectToLayer (_:) - convertRectToLayer:

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

Объявление

Swift

func convertRectToLayer(_ aRect: NSRect) -> NSRect

Objective C

- (NSRect)convertRectToLayer:(NSRect)aRect

Параметры

aRect

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

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

Прямоугольник во внутренней системе координат уровня.

Обсуждение

Пространство уровня является виртуальным, и не принимает во внимание уровень contentsScale установка.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– convertRectFromLayer:
convertSizeFromBacking (_:) - convertSizeFromBacking:

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

Объявление

Swift

func convertSizeFromBacking(_ aSize: NSSize) -> NSSize

Objective C

- (NSSize)convertSizeFromBacking:(NSSize)aSize

Параметры

aSize

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

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

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– convertSizeToBacking:
convertSizeToBacking (_:) - convertSizeToBacking:

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

Объявление

Swift

func convertSizeToBacking(_ aSize: NSSize) -> NSSize

Objective C

- (NSSize)convertSizeToBacking:(NSSize)aSize

Параметры

aSize

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

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

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– convertSizeToBacking:
convertSizeFromLayer (_:) - convertSizeFromLayer:

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

Объявление

Swift

func convertSizeFromLayer(_ aSize: NSSize) -> NSSize

Objective C

- (NSSize)convertSizeFromLayer:(NSSize)aSize

Параметры

aSize

Размер во внутренней системе координат уровня.

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

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

Обсуждение

Пространство уровня является виртуальным, и не принимает во внимание уровень contentsScale установка.

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– convertSizeToLayer:
convertSizeToLayer (_:) - convertSizeToLayer:

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

Объявление

Swift

func convertSizeToLayer(_ aSize: NSSize) -> NSSize

Objective C

- (NSSize)convertSizeToLayer:(NSSize)aSize

Параметры

aSize

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

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

Размер во внутренней системе координат уровня.

Обсуждение

Пространство уровня является виртуальным, и не принимает во внимание уровень contentsScale установка.

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– convertSizeFromLayer:


    
    convertPoint (_: fromView:)
    - convertPoint:fromView:

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

Объявление

Swift

func convertPoint(_ aPoint: NSPoint, fromView aView: NSView?) -> NSPoint

Objective C

- (NSPoint)convertPoint:(NSPoint)aPoint fromView:(NSView *)aView

Параметры

`aPoint`	Точка, указывающая расположение в системе координат `aView`.
`aView`	Представление с `aPoint` в его системе координат. Оба `aView` и получатель должен принадлежать тому же `NSWindow` объект и то окно не должны быть `nil`. Если `aView` `nil`, этот метод преобразовывает из координат окна вместо этого.

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

Точка, преобразованная в систему координат получателя.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– convertRect:fromView:
– convertSize:fromView:
– ancestorSharedWithView:
contentView (NSWindow)


    
    convertPoint (_: toView:)
    - convertPoint:toView:

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

Объявление

Swift

func convertPoint(_ aPoint: NSPoint, toView aView: NSView?) -> NSPoint

Objective C

- (NSPoint)convertPoint:(NSPoint)aPoint toView:(NSView *)aView

Параметры


      aPoint

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


      aView

Представление то, в чей систему координат aPoint должен быть преобразован. Оба aView и получатель должен принадлежать тому же NSWindow объект и то окно не должны быть nil. Если aView nil, этот метод преобразовывает в координаты окна вместо этого.

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

Точка, преобразованная в систему координат aView.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– convertRect:toView:
– convertSize:toView:
– ancestorSharedWithView:
contentView (NSWindow)


    
    convertSize (_: fromView:)
    - convertSize:fromView:

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

Объявление

Swift

func convertSize(_ aSize: NSSize, fromView aView: NSView?) -> NSSize

Objective C

- (NSSize)convertSize:(NSSize)aSize fromView:(NSView *)aView

Параметры

`aSize`	Размер (ширина и высота) в `aView`система координат.
`aView`	Представление с `aSize` в его системе координат. Оба `aView` и получатель должен принадлежать тому же `NSWindow` объект и то окно не должны быть `nil`. Если `aView` `nil`, этот метод преобразовывает из координат окна вместо этого.

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

Преобразованный размер, как NSSize структура.

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– convertPoint:fromView:
– convertRect:fromView:
– ancestorSharedWithView:
contentView (NSWindow)


    
    convertSize (_: toView:)
    - convertSize:toView:

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

Объявление

Swift

func convertSize(_ aSize: NSSize, toView aView: NSView?) -> NSSize

Objective C

- (NSSize)convertSize:(NSSize)aSize toView:(NSView *)aView

Параметры


      aSize

Размер (ширина и высота) в системе координат получателя.


      aView

Представление, которое является целью работы преобразования. Оба aView и получатель должен принадлежать тому же NSWindow объект и то окно не должны быть nil. Если aView nil, этот метод преобразовывает в координаты окна вместо этого.

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

Преобразованный размер, как NSSize структура.

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– convertPoint:toView:
– convertRect:toView:
– ancestorSharedWithView:
contentView (NSWindow)


    
    convertRect (_: fromView:)
    - convertRect:fromView:

Преобразовывает прямоугольник из системы координат другого представления к тому из получателя.

Объявление

Swift

func convertRect(_ aRect: NSRect, fromView aView: NSView?) -> NSRect

Objective C

- (NSRect)convertRect:(NSRect)aRect fromView:(NSView *)aView

Параметры

`aRect`	Прямоугольник в `aView`система координат.
`aView`	Представление с `aRect` в его системе координат. Оба `aView` и получатель должен принадлежать тому же `NSWindow` объект и то окно не должны быть `nil`. Если `aView` `nil`, этот метод преобразовывает из координат окна вместо этого.

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

Преобразованный прямоугольник.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– convertPoint:fromView:
– convertSize:fromView:
– ancestorSharedWithView:
contentView (NSWindow)


    
    convertRect (_: toView:)
    - convertRect:toView:

Преобразовывает прямоугольник от системы координат получателя до того из другого представления.

Объявление

Swift

func convertRect(_ aRect: NSRect, toView aView: NSView?) -> NSRect

Objective C

- (NSRect)convertRect:(NSRect)aRect toView:(NSView *)aView

Параметры


      aRect

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


      aView

Представление, которое является целью работы преобразования. Оба aView и получатель должен принадлежать тому же NSWindow объект и то окно не должны быть nil. Если aView nil, этот метод преобразовывает прямоугольник в координаты окна вместо этого.

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

Преобразованный прямоугольник.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– convertPoint:toView:
– convertSize:toView:
– ancestorSharedWithView:
contentView (NSWindow)

centerScanRect (_:) - centerScanRect:

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

Объявление

Swift

func centerScanRect(_ aRect: NSRect) -> NSRect

Objective C

- (NSRect)centerScanRect:(NSRect)aRect

Параметры

aRect

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

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

Скорректированный прямоугольник.

Обсуждение

Этот метод преобразовывает данный прямоугольник в координаты устройства, корректирует прямоугольник для расположения в центре пикселей и преобразовывает получающийся прямоугольник назад в систему координат получателя. Обратите внимание на то, что этот метод не принимает во внимание, что любые трансформации выполнили использование NSAffineTransform класс или Кварц 2D подпрограммы.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– isRotatedOrScaledFromBase

Изменение системы координат

translateOriginToPoint (_:) - translateOriginToPoint:

Переводит систему координат получателя так, чтобы ее источник переместился в новое расположение.

Объявление

Swift

func translateOriginToPoint(_ newOrigin: NSPoint)

Objective C

- (void)translateOriginToPoint:(NSPoint)newOrigin

Параметры

newOrigin

Точка, указывающая новый источник.

Обсуждение

В процессе, источник прямоугольника границ получателя смещается на (–newOrigin.x, –newOrigin.y). Этот метод не восстанавливает изображение получателя и не отмечает его как нуждающийся в дисплее. Необходимо сделать это сами с display или setNeedsDisplay:.

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

Этот метод отправляет NSViewBoundsDidChangeNotification к центру уведомления по умолчанию, если получатель сконфигурирован, чтобы сделать так.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– setBoundsOrigin:
границы
– setPostsBoundsChangedNotifications:
scaleUnitSquareToSize (_:) - scaleUnitSquareToSize:

Масштабирует систему координат получателя так, чтобы квадрат модуля масштабировался к указанным размерностям.

Объявление

Swift

func scaleUnitSquareToSize(_ newUnitSize: NSSize)

Objective C

- (void)scaleUnitSquareToSize:(NSSize)newUnitSize

Параметры

newUnitSize

NSSize структура, указывающая новый размер модуля.

Обсуждение

Например, a newUnitSize из (0.5, 1.0) заставляет горизонтальные координаты получателя быть разделенными на два, поочередно удваивая ширину его прямоугольника границ. Обратите внимание на то, что масштабирование выполняется от источника системы координат, (0.0, 0.0), не источника прямоугольника границ; в результате и источник и размер прямоугольника границ изменяются. Прямоугольник кадра остается неизменным.

Этот метод не восстанавливает изображение получателя и не отмечает его как нуждающийся в дисплее. Необходимо сделать это сами с display или setNeedsDisplay:.

Этот метод отправляет NSViewBoundsDidChangeNotification к центру уведомления по умолчанию, если получатель сконфигурирован, чтобы сделать так.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– setBoundsSize:
– setPostsBoundsChangedNotifications:
rotateByAngle (_:) - rotateByAngle:

Поворачивает прямоугольник границ получателя на указанное значение градуса вокруг источника системы координат, (0.0, 0.0).

Объявление

Swift

func rotateByAngle(_ angle: CGFloat)

Objective C

- (void)rotateByAngle:(CGFloat)angle

Параметры

angle

A float значение, указывающее угол вращения, в градусах.

Обсуждение

Посмотрите boundsRotation описание метода для получения дополнительной информации. Этот метод не восстанавливает изображение получателя и не отмечает его как нуждающийся в дисплее. Необходимо сделать это сами с display или setNeedsDisplay:.

Этот метод отправляет NSViewBoundsDidChangeNotification к центру уведомления по умолчанию, если получатель сконфигурирован, чтобы сделать так.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

frameRotation
postsBoundsChangedNotifications

Исследование модификаций системы координат

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

Булево значение, указывающее, использует ли представление зеркально отраженную систему координат. (только для чтения)

Объявление

Swift

var flipped: Bool { get }

Objective C

@property(getter=isFlipped, readonly) BOOL flipped

Обсуждение

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

Если Вы хотите, чтобы Ваше представление использовало зеркально отраженную систему координат, переопределите это свойство и возврат YEStrue.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

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

Объявление

Swift

var rotatedFromBase: Bool { get }

Objective C

@property(getter=isRotatedFromBase, readonly) BOOL rotatedFromBase

Обсуждение

Значение этого свойства YEStrue если у представления или какого-либо из его наследователей был его frameRotation или boundsRotation свойства, измененные в любое время. Значение тихо YEStrue если фактор вращения изменяется на ненулевое значение и затем назад к 0.

Используйте эту информацию для оптимизации получения и координатного вычисления. Не используйте его для отражения точного состояния системы координат получателя.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

frameRotation
boundsRotation
rotatedOrScaledFromBase rotatedOrScaledFromBase Свойство

Булево значение, указывающее, применялись ли представлению или какому-либо из его наследователей когда-либо к фактору вращения его кадр или границы, или масштабировались от основной системы координат окна. (только для чтения)

Объявление

Swift

var rotatedOrScaledFromBase: Bool { get }

Objective C

@property(getter=isRotatedOrScaledFromBase, readonly) BOOL rotatedOrScaledFromBase

Обсуждение

Значение этого свойства YEStrue если у представления или какого-либо из его наследователей был его frameRotation или boundsRotation свойства, измененные в любое время. Значение тихо YEStrue если фактор вращения изменяется на ненулевое значение и затем назад к 0.

Используйте эту информацию для оптимизации получения и координатного вычисления. Не используйте его для отражения точного состояния системы координат получателя.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

frameRotation
boundsRotation
– centerScanRect:
границы
– setBoundsSize:
– scaleUnitSquareToSize:

Изменение размеров подпредставлений

autoresizesSubviews autoresizesSubviews Свойство

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

Объявление

Swift

var autoresizesSubviews: Bool

Objective C

@property BOOL autoresizesSubviews

Обсуждение

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

Значение по умолчанию этого свойства YEStrue.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

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

Объявление

Swift

var autoresizingMask: NSAutoresizingMaskOptions

Objective C

@property NSAutoresizingMaskOptions autoresizingMask

Обсуждение

Значение этого свойства является целочисленной битовой маской, указанной путем объединения опций, описанных в NSAutoresizingMaskOptions. Эта маска используется resizeWithOldSuperviewSize: метод, когда должно быть изменено представление.

Если маска автоизменения размеров установлена в NSViewNotSizable (т.е. если ни одна из опций не установлена), получатель не изменяет размеры вообще. Когда больше чем одна опция вдоль оси установлена, resizeWithOldSuperviewSize: метод распределяет различие в размере максимально равномерно среди гибких частей. Например, если NSViewWidthSizable и NSViewMaxXMargin установлены и суперпредставление width увеличилось 10.0 точки, кадр получателя и правое поле каждый расширены 5.0 точки.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

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

Объявление

Swift

func resizeSubviewsWithOldSize(_ oldBoundsSize: NSSize)

Objective C

- (void)resizeSubviewsWithOldSize:(NSSize)oldBoundsSize

Параметры

oldBoundsSize

Предыдущий размер прямоугольника границ получателя.

Обсуждение

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

Реализация по умолчанию отправляет resizeWithOldSuperviewSize: к подпредставлениям получателя с oldBoundsSize как параметр. Вы не должны вызывать этот метод непосредственно, но можно переопределить его для определения определенного поведения перемозаичного размещения.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

autoresizesSubviews
resizeWithOldSuperviewSize (_:) - resizeWithOldSuperviewSize:

Сообщает получателю, что изменился размер границ его суперпредставления.

Объявление

Swift

func resizeWithOldSuperviewSize(_ oldBoundsSize: NSSize)

Objective C

- (void)resizeWithOldSuperviewSize:(NSSize)oldBoundsSize

Параметры

oldBoundsSize

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

Обсуждение

Этот метод обычно вызывается автоматически от resizeSubviewsWithOldSize:.

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

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Управление ограничениями

ограничения ограничения Свойство

Ограничения сохранены представлением. (только для чтения)

Объявление

Swift

var constraints: [AnyObject] { get }

Objective C

@property(readonly, copy) NSArray *constraints

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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


    
    addConstraint (_:)
    - addConstraint:

Добавляет ограничение на расположение представления получения или его подпредставлений.

Объявление

Swift

func addConstraint(_ constraint: NSLayoutConstraint)

Objective C

- (void)addConstraint:(NSLayoutConstraint *)constraint

Параметры


      constraint

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

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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


    
    addConstraints (_:)
    - addConstraints:

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

Объявление

Swift

func addConstraints(_ constraints: [AnyObject])

Objective C

- (void)addConstraints:(NSArray *)constraints

Параметры


      constraints

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

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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


    
    removeConstraint (_:)
    - removeConstraint:

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

Объявление

Swift

func removeConstraint(_ constraint: NSLayoutConstraint)

Objective C

- (void)removeConstraint:(NSLayoutConstraint *)constraint

Параметры


      constraint

Ограничение для удаления. Удаление ограничения, не сохраненного представлением, не имеет никакого эффекта.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

removeConstraints (_:) - removeConstraints:

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

Объявление

Swift

func removeConstraints(_ constraints: [AnyObject])

Objective C

- (void)removeConstraints:(NSArray *)constraints

Параметры

constraints

Ограничения для удаления.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Измерение в расположении на основе ограничений

fittingSize fittingSize Свойство

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

Объявление

Swift

var fittingSize: NSSize { get }

Objective C

@property(readonly) NSSize fittingSize

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

NSLayoutPriorityFittingSizeCompression
intrinsicContentSize intrinsicContentSize Свойство

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

Объявление

Swift

var intrinsicContentSize: NSSize { get }

Objective C

@property(readonly) NSSize intrinsicContentSize

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

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

Обсуждение

Значения ширины и высоты по умолчанию этого свойства установлены в NSViewNoInstrinsicMetric. Для пользовательского представления можно переопределить это свойство и использовать его для передачи, какой размер Вы хотели бы, чтобы Ваше представление основывалось на своем содержании. Вы могли бы сделать это в случаях, где система расположения не может определить размер представления, базируемого исключительно на его текущих ограничениях. Например, текстовое поле могло бы переопределить этот метод и возвратить внутренний размер на основе текста, который это содержит. Внутренний размер, который Вы предоставляете, должен быть независим от довольного кадр, потому что нет никакого способа динамично передать измененную ширину к системе расположения на основе измененной высоты. Если Ваше пользовательское представление не имеет никакого внутреннего размера для данной размерности, можно установить соответствующую размерность в NSViewNoInstrinsicMetric.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.7 и позже.
invalidateIntrinsicContentSize () - invalidateIntrinsicContentSize

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

Объявление

Swift

func invalidateIntrinsicContentSize()

Objective C

- (void)invalidateIntrinsicContentSize

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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


    
    contentCompressionResistancePriorityForOrientation (_:)
    - contentCompressionResistancePriorityForOrientation:

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

Объявление

Swift

func contentCompressionResistancePriorityForOrientation(_ orientation: NSLayoutConstraintOrientation) -> NSLayoutPriority

Objective C

- (NSLayoutPriority)contentCompressionResistancePriorityForOrientation:(NSLayoutConstraintOrientation)orientation

Параметры


      orientation

Ориентация размерности представления, которое могло бы быть сокращено.

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

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

Обсуждение

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

Подклассы не должны переопределять этот метод. Вместо этого пользовательские представления должны установить значения по умолчанию для своего содержания на создании, обычно к NSLayoutPriorityDefaultLow или NSLayoutPriorityDefaultHigh.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– setContentCompressionResistancePriority:forOrientation:


    
    setContentCompressionResistancePriority (_: forOrientation:)
    - setContentCompressionResistancePriority:forOrientation:

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

Объявление

Swift

func setContentCompressionResistancePriority(_ priority: NSLayoutPriority, forOrientation orientation: NSLayoutConstraintOrientation)

Objective C

- (void)setContentCompressionResistancePriority:(NSLayoutPriority)priority forOrientation:(NSLayoutConstraintOrientation)orientation

Параметры

`priority`	Новый приоритет.
`orientation`	Ориентация, для которой должен быть установлен приоритет сопротивления сжатия.

Обсуждение

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

Подклассы не должны переопределять этот метод.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– contentCompressionResistancePriorityForOrientation:


    
    contentHuggingPriorityForOrientation (_:)
    - contentHuggingPriorityForOrientation:

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

Объявление

Swift

func contentHuggingPriorityForOrientation(_ orientation: NSLayoutConstraintOrientation) -> NSLayoutPriority

Objective C

- (NSLayoutPriority)contentHuggingPriorityForOrientation:(NSLayoutConstraintOrientation)orientation

Параметры


      orientation

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

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

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

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– setContentHuggingPriority:forOrientation:


    
    setContentHuggingPriority (_: forOrientation:)
    - setContentHuggingPriority:forOrientation:

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

Объявление

Swift

func setContentHuggingPriority(_ priority: NSLayoutPriority, forOrientation orientation: NSLayoutConstraintOrientation)

Objective C

- (void)setContentHuggingPriority:(NSLayoutPriority)priority forOrientation:(NSLayoutConstraintOrientation)orientation

Параметры

`priority`	Новый приоритет.
`orientation`	Ориентация, для которой довольное должен быть установлен приоритет объятия.

Обсуждение

Подклассы не должны переопределять этот метод.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– contentHuggingPriorityForOrientation:

Выравнивание представлений с расположением на основе ограничений

alignmentRectForFrame (_:) - alignmentRectForFrame:

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

Объявление

Swift

func alignmentRectForFrame(_ frame: NSRect) -> NSRect

Objective C

- (NSRect)alignmentRectForFrame:(NSRect)frame

Параметры

frame

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

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

Прямоугольник выравнивания для указанного кадра.

Обсуждение

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

Реализация по умолчанию возвращает кадр представления, измененный вставками, указанными представлением alignmentRectInsets метод. Большинство пользовательских представлений может переопределить alignmentRectInsets указать расположение их содержания в их кадре. Пользовательские представления, требующие произвольных трансформаций, могут переопределить alignmentRectForFrame: и frameForAlignmentRect: описать расположение их содержания. Эти два метода должны всегда быть инверсиями друг друга.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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


    
    frameForAlignmentRect (_:)
    - frameForAlignmentRect:

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

Объявление

Swift

func frameForAlignmentRect(_ alignmentRect: NSRect) -> NSRect

Objective C

- (NSRect)frameForAlignmentRect:(NSRect)alignmentRect

Параметры


      alignmentRect

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

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

Кадр для указанного прямоугольника выравнивания

Обсуждение

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

Возвраты реализации по умолчанию alignmentRect измененный вставками указан представлением alignmentRectInsets метод. Большинство пользовательских представлений может переопределить alignmentRectInsets указать расположение их содержания в их кадре. Пользовательские представления, требующие произвольных трансформаций, могут переопределить alignmentRectForFrame: и frameForAlignmentRect: описать расположение их содержания. Эти два метода должны всегда быть инверсиями друг друга.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

alignmentRectInsets alignmentRectInsets Свойство

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

Объявление

Swift

var alignmentRectInsets: NSEdgeInsets { get }

Objective C

@property(readonly) NSEdgeInsets alignmentRectInsets

Обсуждение

Значение по умолчанию NSEdgeInsets структура со значением 0 для каждого компонента. Пользовательские представления, рисующие украшение вокруг их содержания, могут переопределить это свойство и возвратить вставки, выравнивающиеся с краями содержания, исключая украшение. Это позволяет системе расположения на основе ограничений выравнивать представления на основе их содержания, а не просто их кадра.

Пользовательские представления, расположение содержания которых не может быть выражено простым набором вставок, должны переопределить alignmentRectForFrame: и frameForAlignmentRect: описать их пользовательское преобразование между прямоугольником выравнивания и кадром.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

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

Объявление

Swift

var baselineOffsetFromBottom: CGFloat { get }

Objective C

@property(readonly) CGFloat baselineOffsetFromBottom

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Инициирование расположения на основе ограничений

needsLayout needsLayout Свойство

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

Объявление

Swift

var needsLayout: Bool

Objective C

@property BOOL needsLayout

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

YEStrue если для представления нужна передача расположения, NOfalse иначе.

Обсуждение

Если представление реализует, только когда-либо необходимо изменять значение этого свойства layout метод, потому что это имеет пользовательский макет, который не является выразимым в системе расположения на основе ограничений. Установка этого свойства к YEStrue позволяет системе знать, что расположение представления должно быть обновлено, прежде чем это будет нарисовано. Система проверяет значение этого свойства до применения правил макета на основе ограничений для представления.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.7 и позже.
расположение () - расположение

Выполните расположение совместно с системой расположения на основе ограничений.

Объявление

Swift

func layout()

Objective C

- (void)layout

Обсуждение

Переопределите этот метод, если Ваше пользовательское представление должно выполнить пользовательский макет не выразимое использование системы расположения на основе ограничений. В этом случае Вы ответственны за вызов setNeedsLayout: когда что-то, что влияет на Ваши изменения пользовательского макета.

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

Необходимо вызвать [super layout] как часть Вашей реализации.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.7 и позже.
layoutSubtreeIfNeeded () - layoutSubtreeIfNeeded

Обновляет расположение представления получения и его подпредставлений на основе текущих представлений и ограничений.

Объявление

Swift

func layoutSubtreeIfNeeded()

Objective C

- (void)layoutSubtreeIfNeeded

Обсуждение

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

Подклассы не должны переопределять этот метод.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

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

Объявление

Swift

var needsUpdateConstraints: Bool

Objective C

@property BOOL needsUpdateConstraints

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.7 и позже.
updateConstraints () - updateConstraints

Ограничения обновления для представления.

Объявление

Swift

func updateConstraints()

Objective C

- (void)updateConstraints

Обсуждение

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

Вы не можете лишить законной силы ограничения как часть Вашей ограничительной фазы обновления. Вы также не можете вызвать расположение или фазу получения как часть ограничительного обновления.

Необходимо вызвать [super updateConstraints] в конце Вашей реализации.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.7 и позже.
updateConstraintsForSubtreeIfNeeded () - updateConstraintsForSubtreeIfNeeded

Обновляет ограничения для представления получения и его подпредставлений.

Объявление

Swift

func updateConstraintsForSubtreeIfNeeded()

Objective C

- (void)updateConstraintsForSubtreeIfNeeded

Обсуждение

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

Подклассы не должны переопределять этот метод.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Выбор в к расположению на основе ограничений

requiresConstraintBasedLayout () + requiresConstraintBasedLayout

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

Объявление

Swift

class func requiresConstraintBasedLayout() -> Bool

Objective C

+ (BOOL)requiresConstraintBasedLayout

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

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

Обсуждение

Пользовательские представления должны переопределить это для возврата YEStrue если они не могут расположение правильно с помощью автоизменения размеров.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

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

Объявление

Swift

var translatesAutoresizingMaskIntoConstraints: Bool

Objective C

@property BOOL translatesAutoresizingMaskIntoConstraints

Обсуждение

Когда это свойство установлено в YEStrue, суперпредставление представления смотрит на маску автоизменения размеров представления, производит ограничения, реализующие его, и добавляет те ограничения к себе (суперпредставление). Если Ваше представление имеет гибкие ограничения, требующие динамической корректировки, устанавливающие это свойство в NOfalse и примените ограничения сами.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Отладка расположения на основе ограничений

Дополнительную информацию см. в Автоматическом Руководстве по Расположению при отладке расположения на основе ограничений.


    
    constraintsAffectingLayoutForOrientation (_:)
    - constraintsAffectingLayoutForOrientation:

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

Объявление

Swift

func constraintsAffectingLayoutForOrientation(_ orientation: NSLayoutConstraintOrientation) -> [AnyObject]

Objective C

- (NSArray *)constraintsAffectingLayoutForOrientation:(NSLayoutConstraintOrientation)orientation

Параметры


      orientation

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

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

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

Обсуждение

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

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

hasAmbiguousLayout hasAmbiguousLayout Свойство

Булево значение, указывающее, указывают ли ограничения, влияющие на расположение представления не полностью, расположение представления. (только для чтения)

Объявление

Swift

var hasAmbiguousLayout: Bool { get }

Objective C

@property(readonly) BOOL hasAmbiguousLayout

Обсуждение

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

Доступ к этому свойству затрагивает механизм расположения, чтобы определить, удовлетворил ли бы какой-либо другой кадр также ограничения на представление. Поскольку этот процесс включает разметку представления, получение доступ к свойству может быть дорогой работой, но это может также обеспечить полезную отладочную информацию. Когда окно просят визуализировать его ограничения с помощью, AppKit автоматически вызывает этот метод visualizeConstraints: метод.

Важный

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– exerciseAmbiguityInLayout
exerciseAmbiguityInLayout () - exerciseAmbiguityInLayout

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

Объявление

Swift

func exerciseAmbiguityInLayout()

Objective C

- (void)exerciseAmbiguityInLayout

Обсуждение

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

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– hasAmbiguousLayout

Фокусировка

lockFocus () - lockFocus

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

Объявление

Swift

func lockFocus()

Objective C

- (void)lockFocus

Обсуждение

Если Вы не используете a display... метод для рисования NSView объект, необходимо вызвать lockFocus прежде, чем вызвать методы, которые отправляют команды в сервер окна и должны сбалансировать его с unlockFocus сообщение по окончании.

Сокрытие или миниатюризация окна с одним выстрелом заставляют запоминающее устройство для того окна быть выпущенным. Если Вы не используете стандартный механизм дисплея для рисования, необходимо использовать lockFocusIfCanDraw вместо lockFocus в то время как окно или миниатюризировано или скрыто, если существует шанс рисования. Этот метод выдает исключение, если представление скрыто или если получение не может произойти по некоторой другой причине. Чтобы гарантировать, что можно заблокировать фокус успешно, удостоверьтесь canDraw свойство YEStrue; можно также вызвать lockFocusIfCanDraw вместо этого и использование возвращаемое значение того метода, чтобы определить, был ли фокус получен успешно.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

+ focusView
– дисплей
– drawRect:
– lockFocusIfCanDraw
lockFocusIfCanDraw () - lockFocusIfCanDraw

Блокирует фокус к получателю атомарно если canDraw возвраты метода YEStrue и возвращает значение canDraw.

Объявление

Swift

func lockFocusIfCanDraw() -> Bool

Objective C

- (BOOL)lockFocusIfCanDraw

Обсуждение

Ваш поток не будет вытеснен другими потоками между canDraw метод и блокировка. Этому методу не удается заблокировать фокус и возвраты NOfalse, когда получатель скрыт, и текущий контекст рисует на экран (в противоположность контексту печати).

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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


    
    lockFocusIfCanDrawInContext (_:)
    - lockFocusIfCanDrawInContext:

Если получение может произойти в указанном графическом контексте, блокирует фокус к получателю атомарно.

Объявление

Swift

func lockFocusIfCanDrawInContext(_ context: NSGraphicsContext) -> Bool

Objective C

- (BOOL)lockFocusIfCanDrawInContext:(NSGraphicsContext *)context

Параметры


      context

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

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

YEStrue если успешный; иначе, возвраты NOfalse.

Обсуждение

Ваш поток не будет вытеснен другими потоками между canDraw метод и блокировка.

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

Специальные замечания

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– lockFocus
– lockFocusIfCanDraw

unlockFocus () - unlockFocus

Разблокировал фокус от текущего представления.

Объявление

Swift

func unlockFocus()

Objective C

- (void)unlockFocus

Обсуждение

Вызовите этот метод после предыдущего вызова к lockFocus, lockFocusIfCanDraw, или lockFocusIfCanDrawInContext: метод этого объекта представления. Выполнение так выпускает фокус от текущего представления и возвратов это назад к ранее фокусируемому представлению, если таковые имеются. Этот метод повышает NSInvalidArgumentException если текущее представление не имеет фокуса.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– allocateGState
focusView () + focusView

Возвращается в настоящее время фокусируемый NSView объект, или nil если нет ни одного.

Объявление

Swift

class func focusView() -> NSView?

Objective C

+ (NSView *)focusView

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– lockFocus
– unlockFocus

Получение фокусирующего кольца

focusRingType focusRingType Свойство

Тип фокусирующего кольца, нарисованного вокруг получателя.

Объявление

Swift

var focusRingType: NSFocusRingType

Objective C

@property NSFocusRingType focusRingType

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

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

Обсуждение

Используйте это свойство для указания типа фокусирующего кольца для рисования. Для списка возможных значений посмотрите NSFocusRingType.

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

Изменение значения в этом свойстве не заставляет представление рисовать фактическое фокусирующее кольцо. Вы ответственны за рисование фокусирующего кольца в drawRect Вашего представления: метод каждый раз, когда Ваше представление сделано первым респондентом.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Границы маски фокусирующего кольца, указанные в координатном пространстве представления. (только для чтения)

Объявление

Swift

var focusRingMaskBounds: NSRect { get }

Objective C

@property(readonly) NSRect focusRingMaskBounds

Обсуждение

Прямоугольник в этом свойстве указан относительно внутренней части представления (границы) координатное пространство. Границы маски позволяют полному размеру фокусирующего кольца и позиции быть определенным, прежде чем это будет нарисовано. Переопределите это свойство, если Ваше представление требует дисплея фокусирующего кольца. Значение по умолчанию этого свойства NSZeroRect.

Примечание:

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– noteFocusRingMaskChanged
– drawFocusRingMask
drawFocusRingMask () - drawFocusRingMask

Рисует маску фокусирующего кольца для представления.

Объявление

Swift

func drawFocusRingMask()

Objective C

- (void)drawFocusRingMask

Обсуждение

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

Подклассы, считающие поведение по умолчанию недостаточным, должны только нарисовать форму фокусирующего кольца.

NSView реализация этого метода просто заполняется [self bounds].

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– focusRingMaskBounds
– noteFocusRingMaskChanged
noteFocusRingMaskChanged () - noteFocusRingMaskChanged

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

Объявление

Swift

func noteFocusRingMaskChanged()

Objective C

- (void)noteFocusRingMaskChanged

Обсуждение

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

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

Если, однако, представление показывает фокусирующее кольцо вокруг некоторой части его содержания ( NSImage, возможно), и что содержание изменяется, клиент должен обеспечить уведомление путем вызова этого метода так, чтобы focusRingMaskBounds и drawFocusRingMask будет вызван для перерисовки фокусирующего кольца.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

focusRingMaskBounds
– drawFocusRingMask


    
    setKeyboardFocusRingNeedsDisplayInRect (_:)
    - setKeyboardFocusRingNeedsDisplayInRect:

Лишает законной силы область вокруг фокусирующего кольца.

Объявление

Swift

func setKeyboardFocusRingNeedsDisplayInRect(_ rect: NSRect)

Objective C

- (void)setKeyboardFocusRingNeedsDisplayInRect:(NSRect)rect

Параметры


      rect

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

defaultFocusRingType () + defaultFocusRingType

Возвращает тип фокусирующего кольца по умолчанию.

Объявление

Swift

class func defaultFocusRingType() -> NSFocusRingType

Objective C

+ (NSFocusRingType)defaultFocusRingType

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

Тип по умолчанию фокусирующего кольца для объектов класса получателя. Возможные возвращаемые значения перечислены в NSFocusRingType.

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Получение установки вибрации

allowsVibrancy allowsVibrancy Свойство

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

Объявление

Swift

var allowsVibrancy: Bool { get }

Objective C

@property(readonly) BOOL allowsVibrancy

Обсуждение

AppKit проверяет это свойство, когда представление включено в иерархию представления, использующую вибрацию. Если свойство YEStrue, представление принимает надлежащие меры, чтобы гарантировать, что его содержание является вибрирующим поверх любого базового материала. Значение по умолчанию этого свойства NOfalse. Однако некоторые подклассы представления AppKit изменяют значение этого свойства на основе иллюстраций, которые они рисуют.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Полноэкранный режим


    
    enterFullScreenMode (_: withOptions:)
    - enterFullScreenMode:withOptions:

Устанавливает получатель в полноэкранный режим.

Объявление

Swift

func enterFullScreenMode(_ screen: NSScreen, withOptions options: [NSObject : AnyObject]?) -> Bool

Objective C

- (BOOL)enterFullScreenMode:(NSScreen *)screen withOptions:(NSDictionary *)options

Параметры

`screen`	Экран получатель должен покрыть.
`options`	Словарь опций для режима. Для возможных ключей посмотрите `“Full Screen Mode Options”`.

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

YEStrue если получатель смог перейти к полноэкранному режиму, иначе NOfalse.

Обсуждение

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

Если Вы не хотите получать экран при движении в полноэкранный режим, можно добавить NSFullScreenModeApplicationPresentationOptions к словарю опций со значением, возвращенным presentationOptions.

Когда NSFullScreenModeApplicationPresentationOptions опции указаны, выйдя из полноэкранного использования режима exitFullScreenModeWithOptions: восстановит ранее активный presentationOptions.

Специальные замечания

На OS X v 10.5, вызывающем этот метод, когда получатель не был в окне, вызовет исключение. На OS X v 10.6 и позже, можно теперь отправить это сообщение в представление не в окне. Для приложений, которые должны также работать на OS X v 10.5, простое обходное решение должно поместить представление во внеэкранное фиктивное окно.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– exitFullScreenModeWithOptions:
inFullScreenMode


    
    exitFullScreenModeWithOptions (_:)
    - exitFullScreenModeWithOptions:

Дает получателю команду выходить из полноэкранного режима.

Объявление

Swift

func exitFullScreenModeWithOptions(_ options: [NSObject : AnyObject]?)

Objective C

- (void)exitFullScreenModeWithOptions:(NSDictionary *)options

Параметры


      options

Словарь опций для режима. Для возможных ключей посмотрите “Full Screen Mode Options”.

Обсуждение

Когда NSFullScreenModeApplicationPresentationOptions опции указаны когда enterFullScreenMode:withOptions: вызывается, выходить из полноэкранного режима восстановит ранее активный presentationOptions.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– enterFullScreenMode:withOptions:
inFullScreenMode

inFullScreenMode inFullScreenMode Свойство

Булево значение, указывающее, является ли представление в полноэкранном режиме. (только для чтения)

Объявление

Swift

var inFullScreenMode: Bool { get }

Objective C

@property(getter=isInFullScreenMode, readonly) BOOL inFullScreenMode

Обсуждение

Значение этого свойства YEStrue когда представление находится в полноэкранном режиме или NOfalse когда это не.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– enterFullScreenMode:withOptions:
– exitFullScreenModeWithOptions:

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

скрытый скрытый Свойство

Булево значение, указывающее, скрыто ли представление.

Объявление

Swift

var hidden: Bool

Objective C

@property(getter=isHidden) BOOL hidden

Обсуждение

Это свойство отражает состояние текущего представления только, как установлено в Интерфейсном Разработчике или через новое изменение в этом свойстве. Свойство не составляет состояние наследователей получателя в иерархии представления. Таким образом, если представление имеет скрытого наследователя, значение этого свойства может все еще быть NOfalse даже при том, что само представление не видимо. Чтобы определить, скрыто ли представление эффективно по любой причине, получают значение hiddenOrHasHiddenAncestor свойство вместо этого.

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

Сокрытие представления, которое является текущим первым респондентом окна, вызывает следующее допустимое ключевое представление представления (nextValidKeyView) стать новым первым респондентом. Скрытое представление остается в nextKeyView цепочка представлений это было ранее частью, но проигнорировано во время перемещения с помощью клавиатуры.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

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

Объявление

Swift

var hiddenOrHasHiddenAncestor: Bool { get }

Objective C

@property(getter=isHiddenOrHasHiddenAncestor, readonly) BOOL hiddenOrHasHiddenAncestor

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

скрытый
viewDidHide () - viewDidHide

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

Объявление

Swift

func viewDidHide()

Objective C

- (void)viewDidHide

Обсуждение

Получатель получает это сообщение когда hiddenOrHasHiddenAncestor свойство изменяется от NOfalse к YEStrue. Это происходит, когда представление или наследователь отмечены, как скрытый, или когда представление или наследователь введены в новую иерархию представления.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

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

Объявление

Swift

func viewDidUnhide()

Objective C

- (void)viewDidUnhide

Обсуждение

Когда его isHiddenOrHasHiddenAncestor состояние идет от, получатель получает это сообщение YEStrue к NOfalse. Это может произойти, когда представление или наследователь отмечены как не скрытый, или когда представление или наследователь удалены из его содержания иерархии представления.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Живое управление изменяет размеры

inLiveResize inLiveResize Свойство

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

Объявление

Swift

var inLiveResize: Bool { get }

Objective C

@property(readonly) BOOL inLiveResize

Обсуждение

AppKit устанавливает значение этого свойства к YEStrue когда живая работа изменения размеров, включающая представление, в стадии реализации. Используйте это свойство для определения, когда оптимизировать поведение получения представления. Как правило, Вы получаете доступ к этому свойству от Вашего drawRect: метод и использование значение для изменения точности содержания Вы рисуете, или нарисовать Ваше содержание более эффективно.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– viewDidEndLiveResize
– viewWillStartLiveResize
preservesContentDuringLiveResize preservesContentDuringLiveResize Свойство

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

Объявление

Swift

var preservesContentDuringLiveResize: Bool { get }

Objective C

@property(readonly) BOOL preservesContentDuringLiveResize

Обсуждение

Значение по умолчанию этого свойства NOfalse. Если Ваше сохранение содержания поддержек представления, переопределите это свойство и возврат YEStrue. Сохранение содержания позволяет Вашему представлению решить, что перерисовать во время живого, изменяют размеры работы. Если Ваше представление поддерживает эту функцию, необходимо также обеспечить пользовательскую реализацию setFrameSize: метод, лишающий законной силы части Вашего представления, которое фактически должно быть перерисовано.

Для получения информации о том, как реализовать эту опцию в Ваших представлениях, см. Инструкции по Производительности Какао.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– setFrameSize:


    
    getRectsExposedDuringLiveResize (_: количество:)
    - getRectsExposedDuringLiveResize:count:

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

Объявление

Swift

func getRectsExposedDuringLiveResize(_ exposedRects: UnsafeMutablePointer<NSRect>, count count: UnsafeMutablePointer<Int>)

Objective C

- (void)getRectsExposedDuringLiveResize:(NSRect [4])exposedRects count:(NSInteger *)count

Параметры

`exposedRects`	По возврату, содержит список прямоугольников. Возвращенные прямоугольники находятся в координатном пространстве получателя.
`count`	Содержит число прямоугольников в `exposedRects`; это значение может быть 0 и, как гарантируют, будет не больше, чем 4.

Обсуждение

Если Ваше представление не делает сохранения содержания поддержки во время живого изменения размеров, вся область Вашего представления возвращается в exposedRects параметр. К сохранению содержания поддержки переопределите preservesContentDuringLiveResize свойство в Вашем представлении и имеет Ваш возврат реализации YEStrue.

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

preservesContentDuringLiveResize
rectPreservedDuringLiveResize

rectPreservedDuringLiveResize rectPreservedDuringLiveResize Свойство

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

Объявление

Swift

var rectPreservedDuringLiveResize: NSRect { get }

Objective C

@property(readonly) NSRect rectPreservedDuringLiveResize

Обсуждение

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

Если Ваше представление не сделает сохранения содержания поддержки во время живого изменения размеров, то прямоугольник будет пуст. К сохранению содержания поддержки переопределите preservesContentDuringLiveResize свойство в Вашем представлении и имеет Ваш возврат реализации YEStrue.

Примечание:

Окно, содержащее Ваше представление, должно также сохранение содержания поддержки. Для включения поддержки этой функции в окне используйте setPreservesContentDuringLiveResize: метод NSWindow.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– getRectsExposedDuringLiveResize:count:
preservesContentDuringLiveResize
viewWillStartLiveResize () - viewWillStartLiveResize

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

Объявление

Swift

func viewWillStartLiveResize()

Objective C

- (void)viewWillStartLiveResize

Обсуждение

В простом случае отправляется представление viewWillStartLiveResize прежде чем первые изменяют размеры работы на содержании окна и viewDidEndLiveResize после того, как последние изменяют размеры работы. Представление, неоднократно добавляющееся и удаляющееся из окна во время живого, изменяет размеры, получит только один viewWillStartLiveResize (на первом разе это добавляется к окну), и один viewDidEndLiveResize (когда окно завершилось, живые изменяют размеры работы). Это позволяет суперпредставление такой как NSBrowser объект добавить и удалить NSMatrix подпредставления во время живого изменяют размеры без NSMatrix объект, получающий множественные вызовы этих методов.

Представление могло бы выделить структуры данных рисующей кэш информации в viewWillStartLiveResize и должен очистить эти структуры данных в viewDidEndLiveResize. Кроме того, представление, делающее оптимизированное получение во время живого, изменяет размеры, мог бы хотеть сделать полное получение после viewDidEndLiveResize, несмотря на то, что представление не должно предполагать, что имеет контекст получения в viewDidEndLiveResize (так как это, возможно, было удалено из окна во время живого, изменяют размеры). Представление, хотящее перерисовать себя после живой, изменяет размеры, должен вызвать [self setNeedsDisplay:YES] в viewDidEndLiveResize.

Подкласс представления должен вызвать super от этих методов.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– viewDidEndLiveResize
inLiveResize
viewDidEndLiveResize () - viewDidEndLiveResize

Сообщает, что получатель конца живого изменяет размеры.

Объявление

Swift

func viewDidEndLiveResize()

Objective C

- (void)viewDidEndLiveResize

Обсуждение

В простом случае отправляется представление viewWillStartLiveResize прежде чем первые изменяют размеры работы на содержании окна и viewDidEndLiveResize после того, как последние изменяют размеры работы. Представление, неоднократно добавляющееся и удаляющееся из окна во время живого, изменяет размеры, получит только один viewWillStartLiveResize (на первом разе это добавляется к окну), и один viewDidEndLiveResize (когда окно завершилось, живые изменяют размеры работы). Это позволяет суперпредставление такой как NSBrowser объект добавить и удалить NSMatrix подпредставления во время живого изменяют размеры без NSMatrix получение множественных вызовов этих методов.

Представление могло бы выделить структуры данных рисующей кэш информации в viewWillStartLiveResize и должен очистить эти структуры данных в viewDidEndLiveResize. Кроме того, представление, делающее оптимизированное получение во время живого, изменяет размеры, мог бы хотеть сделать полное получение после viewDidEndLiveResize, несмотря на то, что представление не должно предполагать, что имеет контекст получения в viewDidEndLiveResize (так как это, возможно, было удалено из окна во время живого, изменяют размеры). Представление, хотящее перерисовать себя после живой, изменяет размеры, должен вызвать [self setNeedsDisplay:YES] в viewDidEndLiveResize.

Подкласс представления должен вызвать super от этих методов.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– viewWillStartLiveResize
inLiveResize

Управление устройствами распознавания жеста

gestureRecognizers gestureRecognizers Свойство

Жест распознает объекты, в настоящее время присоединяемые к представлению.

Объявление

Swift

var gestureRecognizers: [AnyObject]

Objective C

@property(copy) NSArray *gestureRecognizers

Обсуждение

Объекты в массиве являются конкретными реализациями NSGestureRecognizer класс. Если представление не имеет никаких присоединенных устройств распознавания жеста, массив пуст.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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


    
    addGestureRecognizer (_:)
    - addGestureRecognizer:

Присоединяет устройство распознавания жеста к представлению.

Объявление

Swift

func addGestureRecognizer(_ gestureRecognizer: NSGestureRecognizer)

Objective C

- (void)addGestureRecognizer:(NSGestureRecognizer *)gestureRecognizer

Параметры


      gestureRecognizer

Устройство распознавания жеста для присоединения к представлению. Этот параметр не должен быть nil.

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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


    
    removeGestureRecognizer (_:)
    - removeGestureRecognizer:

Отсоединяет устройство распознавания жеста от представления.

Объявление

Swift

func removeGestureRecognizer(_ gestureRecognizer: NSGestureRecognizer)

Objective C

- (void)removeGestureRecognizer:(NSGestureRecognizer *)gestureRecognizer

Параметры


      gestureRecognizer

Устройство распознавания жеста для удаления. Этот параметр не должен быть nil.

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Обработка событий


    
    acceptsFirstMouse (_:)
    - acceptsFirstMouse:

Переопределенный подклассами для возврата YEStrue если получатель должен быть отправлен a mouseDown: сообщение для начального события mouseDown, NOfalse если нет.

Объявление

Swift

func acceptsFirstMouse(_ theEvent: NSEvent) -> Bool

Objective C

- (BOOL)acceptsFirstMouse:(NSEvent *)theEvent

Параметры


      theEvent

Начальное событие mouseDown, которое должно быть по получателю в его окне.

Обсуждение

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

Переопределите этот метод в подклассе, чтобы позволить экземплярам реагировать на щелчок - через. Это позволяет пользователю щелкать по представлению в неактивном окне, активируя представление одним щелчком, вместо того, чтобы щелкнуть сначала, чтобы сделать окно активным и затем щелкнуть по представлению. Объекты представления Most отказываются от щелчка - посредством попытки, таким образом, событие просто активирует окно. Много объектов управления, однако, таких как экземпляры NSButton и NSSlider, действительно примите их, таким образом, пользователь может сразу управлять управлением, не имея необходимость отпускать кнопку мыши.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– hitTest:


    
    hitTest (_:)
    - hitTest:

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

Объявление

Swift

func hitTest(_ aPoint: NSPoint) -> NSView?

Objective C

- (NSView *)hitTest:(NSPoint)aPoint

Параметры


      aPoint

Точка, которая находится в системе координат суперпредставления получателя, не самого получателя.

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

Объект представления, который является самым дальним потомком aPoint.

Обсуждение

Этот метод используется прежде всего NSWindow объект определить, какое представление должно получить событие mouseDown. Необходимо было бы редко вызывать этот метод, но Вы могли бы хотеть переопределить его для имения объекта представления, скрывают события mouseDown от его подпредставлений. Этот метод игнорирует скрытые представления.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– mouse:inRect:
– convertPoint:toView:
– setHidden:


    
    мышь (_: inRect:)
    - mouse:inRect:

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

Объявление

Swift

func mouse(_ aPoint: NSPoint, inRect aRect: NSRect) -> Bool

Objective C

- (BOOL)mouse:(NSPoint)aPoint inRect:(NSRect)aRect

Параметры

`aPoint`	Точка, выраженная в системе координат получателя. Эта точка обычно представляет горячую точку курсора мыши.
`aRect`	Прямоугольник, выраженный в системе координат получателя.

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

YEStrue если aRect содержит aPoint, NOfalse иначе.

Обсуждение

Функции точки в прямоугольнике обычно предполагают, что базовый край прямоугольника за пределами прямоугольных границ, в то время как верхний край в границах. Этот метод представления aRect с точки зрения пользователя — т.е. этот метод всегда обрабатывает базовый край прямоугольника как одно самое близкое к базовому краю экрана пользователя. Путем внесения этой корректировки эта функция гарантирует непротиворечивое поведение обнаружения мыши с точки зрения пользователя.

Никогда не используйте Основу NSPointInRect функция вместо этого метода. Это не составляет зеркально отраженные системы координат.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– hitTest:
зеркально отраженный
NSMouseInRect (Функции основы)
– convertPoint:fromView:

performKeyEquivalent (_:) - performKeyEquivalent:

Реализованный подклассами для ответа на ключевые эквиваленты (также известный как сочетания клавиш).

Объявление

Swift

func performKeyEquivalent(_ theEvent: NSEvent) -> Bool

Objective C

- (BOOL)performKeyEquivalent:(NSEvent *)theEvent

Параметры

theEvent

Ключевой вниз объект-событие, представляющий ключевой эквивалент.

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

YEStrue если theEvent ключевой эквивалент, который получатель обработал, NOfalse если это не ключевой эквивалент, который это должно обработать.

Обсуждение

Если ключевой эквивалент получателя совпадает с символами ключевого вниз события theEvent, как возвращено charactersIgnoringModifiers, получатель должен принять соответствующие меры и возврат YEStrue. Иначе, это должно возвратить результат вызова superреализация. Реализация по умолчанию этого метода просто передает сообщение вниз иерархия представления (от суперпредставлений до подпредставлений) и возвраты NOfalse если ни одно из подпредставлений получателя не отвечает YEStrue.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

keyDown: (NSWindow)
rightMouseDown: - rightMouseDown:

Сообщает получателю, что пользователь нажал правую кнопку мыши.

Объявление

Objective C

- (void)rightMouseDown:(NSEvent *)theEvent

Параметры

theEvent

Информация об инкапсуляции объекта о событии mouseDown.

Обсуждение

Вызовы реализации по умолчанию menuForEvent: и, если нет nil, представляет контекстное меню. В OS X v10.7 и позже, если событие не обрабатывается, этот метод передает его цепочка респондента.

Доступность

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

См. также

rightMouseDown: (NSResponder)
mouseDownCanMoveWindow mouseDownCanMoveWindow Свойство

Булево значение, указывающее, может ли представление передать мышь вниз события через к ее суперпредставлениям. (только для чтения)

Объявление

Swift

var mouseDownCanMoveWindow: Bool { get }

Objective C

@property(readonly) BOOL mouseDownCanMoveWindow

Обсуждение

Это свойство позволяет Вам создать приложения iApp-стиля, где Вы определяете область, которой может быть перемещено окно. Значение по умолчанию этого свойства NOfalse если представление непрозрачно; иначе, это установлено в YEStrue. Подклассы могут переопределить это свойство для возврата различных значений на основе события.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

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

Объявление

Swift

var inputContext: NSTextInputContext? { get }

Objective C

@property(readonly, strong) NSTextInputContext *inputContext

Обсуждение

Значение этого свойства nil когда представление не соответствует NSTextInputClient протокол.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Сенсорная обработка событий

acceptsTouchEvents acceptsTouchEvents Свойство

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

Объявление

Swift

var acceptsTouchEvents: Bool

Objective C

@property BOOL acceptsTouchEvents

Обсуждение

Когда значение этого свойства, представление принимает сенсорные события YEStrue. По умолчанию представления не принимают сенсорные события, таким образом, значение по умолчанию этого свойства NOfalse. Можно переопределить это свойство и возвратить различное значение, если Вы хотите, чтобы Ваше представление обработало сенсорные события.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Булево значение, указывающее, хочет ли представление оставить касания.

Объявление

Swift

var wantsRestingTouches: Bool

Objective C

@property BOOL wantsRestingTouches

Обсуждение

Когда пользователь кладет их ползунок на устройство (например, стеклянная сенсорная панель MacBook), происходит покоящееся касание. По умолчанию эти касания не поставлены и не включены в набор события касаний. Касания могут перейти в и из отдыха в любое время. Если представление не хочет оставить касания, начался / законченные события моделируются как сенсорный переход от отдыха до активного и наоборот.

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Управление циклом ключевого представления

canBecomeKeyView canBecomeKeyView Свойство

Булево значение, указывающее, может ли получатель стать ключевым представлением. (только для чтения)

Объявление

Swift

var canBecomeKeyView: Bool { get }

Objective C

@property(readonly) BOOL canBecomeKeyView

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

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

Объявление

Swift

var needsPanelToBecomeKey: Bool { get }

Objective C

@property(readonly) BOOL needsPanelToBecomeKey

Обсуждение

Значение по умолчанию этого свойства NOfalse. Подклассы могут переопределить это свойство и использовать их реализацию, чтобы определить, требует ли представление, чтобы его панель стала ключевым окном так, чтобы это могло обработать ввод с клавиатуры и навигацию. Такой подкласс должен также переопределить acceptsFirstResponder возвратиться YEStrue.

Это свойство также используется в перемещении с помощью клавиатуры. Это определяет, должен ли щелчок мышью дать фокус представлению — т.е. сделайте его первым респондентом). Некоторые представления (например, текстовые поля) хотят получить клавиатурный фокус, когда Вы щелкаете в них. Другие представления (например, кнопки) получают фокус только, когда Вы снабжаете вкладками им. Вы не хотели бы, чтобы фокус сместился от текстового поля, имеющего происходящее редактирование просто, потому что Вы щелкнули по флажку.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

becomesKeyOnlyIfNeeded (NSPanel)
nextKeyView nextKeyView Свойство

Объект представления, следующий за текущим представлением в ключевом цикле представления.

Объявление

Swift

unowned(unsafe) var nextKeyView: NSView?

Objective C

@property(assign) NSView *nextKeyView

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

nextValidKeyView
previousKeyView
previousValidKeyView
selectNextKeyView: (NSWindow)
selectKeyViewFollowingView: (NSWindow)
selectPreviousKeyView: (NSWindow)
selectKeyViewPrecedingView: (NSWindow)
nextValidKeyView nextValidKeyView Свойство

Самое близкое представление возражает в ключевом цикле представления, следующем за текущим представлением в ключевом цикле представления и принимающем первое состояние респондента. (только для чтения)

Объявление

Swift

unowned(unsafe) var nextValidKeyView: NSView? { get }

Objective C

@property(readonly, assign) NSView *nextValidKeyView

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

Самое близкое представление возражает в ключевом цикле представления, следующем за получателем и принимающем первое состояние респондента, или nil если нет ни одного.

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

nextKeyView
previousKeyView
previousValidKeyView
selectNextKeyView: (NSWindow)
selectKeyViewFollowingView: (NSWindow)
selectPreviousKeyView: (NSWindow)
selectKeyViewPrecedingView: (NSWindow)
скрытый
previousKeyView previousKeyView Свойство

Объект представления предшествование текущему представлению в ключевом цикле представления. (только для чтения)

Объявление

Swift

unowned(unsafe) var previousKeyView: NSView? { get }

Objective C

@property(readonly, assign) NSView *previousKeyView

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

previousValidKeyView
nextKeyView
nextValidKeyView
selectNextKeyView: (NSWindow)
selectKeyViewFollowingView: (NSWindow)
selectPreviousKeyView: (NSWindow)
selectKeyViewPrecedingView: (NSWindow)
previousValidKeyView previousValidKeyView Свойство

Самое близкое представление возражает в ключевом цикле представления, предшествующем текущему представлению и принимающем первое состояние респондента. (только для чтения)

Объявление

Swift

unowned(unsafe) var previousValidKeyView: NSView? { get }

Objective C

@property(readonly, assign) NSView *previousValidKeyView

Обсуждение

Значение в этом свойстве nil если нет никакого представления, предшествующего текущему представлению и принимающего первое состояние респондента. AppKit игнорирует скрытые представления, когда он определяет предыдущее допустимое ключевое представление.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

previousKeyView
nextValidKeyView
nextKeyView
selectNextKeyView: (NSWindow)
selectKeyViewFollowingView: (NSWindow)
selectPreviousKeyView: (NSWindow)
selectKeyViewPrecedingView: (NSWindow)
скрытый

Прокрутка

isCompatibleWithResponsiveScrolling () + isCompatibleWithResponsiveScrolling

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

Объявление

Swift

class func isCompatibleWithResponsiveScrolling() -> Bool

Objective C

+ (BOOL)isCompatibleWithResponsiveScrolling

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

YEStrue если представление поддерживает быстро реагирующую прокрутку или NOfalse если это не делает.

Обсуждение

Реализация по умолчанию этого метода возвраты YEStrue если класс не переопределяет lockFocus или scrollWheel: метод. Подклассы такой как NSScrollView и NSClipView переопределите этот метод и выполните дополнительные проверки.

AppKit включает быстро реагирующую прокрутку когда представления, вовлеченные в прокрутку — NSScrollView, NSClipView, и встроенное представление документа — весь возврат YEStrue от этого метода. Можно переопределить этот метод в пользовательских представлениях и возвратить надлежащее значение для отражения поддержки представления функции.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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


    
    prepareContentInRect (_:)
    - prepareContentInRect:

Подготавливает превысить ограничения область к рисованию.

Объявление

Swift

func prepareContentInRect(_ rect: NSRect)

Objective C

- (void)prepareContentInRect:(NSRect)rect

Параметры


      rect

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

Обсуждение

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

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

AppKit может вызвать этот метод многократно для роста, ток медленно превышают ограничения область. Каждый раз, когда это вызывает метод, это расширяется, превысить ограничения прямоугольник передал в rect параметр. Если Вы передаете тот же прямоугольник super дважды по очереди AppKit прекращает генерировать дополнительный, превышают ограничения содержание. Можно использовать это поведение избежать генерировать, больше превышает ограничения содержание, чем целесообразен для приложения. Если пользователь прокручивает содержание, AppKit сбрасывают ток, превышают ограничения область, и начинает просить у Вашего приложения содержание снова. Можно также сбросить ток, превышают ограничения область путем присвоения значения preparedContentRect свойство.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

preparedContentRect preparedContentRect Свойство

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

Объявление

Swift

var preparedContentRect: NSRect

Objective C

@property NSRect preparedContentRect

Обсуждение

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

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

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

Объявление

Swift

func scrollPoint(_ aPoint: NSPoint)

Objective C

- (void)scrollPoint:(NSPoint)aPoint

Параметры

aPoint

Точка в получателе для прокрутки к.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– автопрокрутка:
scrollToPoint: (NSClipView)
– isDescendantOf:
scrollRectToVisible (_:) - scrollRectToVisible:

Прокручивает самого близкого наследователя получателя NSClipView возразите минимальному расстоянию, необходимому, таким образом, указанная область получателя становится видимой в представлении клипа.

Объявление

Swift

func scrollRectToVisible(_ aRect: NSRect) -> Bool

Objective C

- (BOOL)scrollRectToVisible:(NSRect)aRect

Параметры

aRect

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

Обсуждение

YEStrue если выполняется какая-либо прокрутка; иначе возвраты NOfalse.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– автопрокрутка:
scrollToPoint: (NSClipView)
– isDescendantOf:


    
    автопрокрутите (_:)
    - автопрокрутка:

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

Объявление

Swift

func autoscroll(_ theEvent: NSEvent) -> Bool

Objective C

- (BOOL)autoscroll:(NSEvent *)theEvent

Параметры


      theEvent

Объект-событие, расположение которого должно быть выражено в основной системе координат окна (который это обычно), не представление получения.

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

Возвраты YEStrue если выполняется какая-либо прокрутка; иначе возвраты NOfalse.

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

autoscroll: (NSClipView)
– scrollPoint:
– isDescendantOf:

adjustScroll (_:) - adjustScroll:

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

Объявление

Swift

func adjustScroll(_ proposedVisibleRect: NSRect) -> NSRect

Objective C

- (NSRect)adjustScroll:(NSRect)proposedVisibleRect

Параметры

proposedVisibleRect

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

Обсуждение

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

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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


    
    scrollRect (_::)
    - scrollRect:by:

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

Объявление

Swift

func scrollRect(_ aRect: NSRect, by offset: NSSize)

Objective C

- (void)scrollRect:(NSRect)aRect by:(NSSize)offset

Параметры

`aRect`	Прямоугольник, определяющий область получателя.
`offset`	A `NSSize` структура, указывающая смещение от от `aRect`источник.

Обсуждение

Этот метод полезен во время прокрутки или перевода системы координат для эффективного перемещения как можно большего количества представленного изображения получателя, не требуя, чтобы он был перерисован, выполнив эти шаги:

Вызвать scrollRect:by: скопировать представленное изображение.
Переместите источник объекта представления или прокрутите его в его суперпредставлении.
Вычислите недавно представленные прямоугольники и вызовите также setNeedsDisplay: или setNeedsDisplayInRect: привлечь их.

Необходимо редко должны быть использовать этот метод, как бы то ни было. scrollPoint:, scrollRectToVisible:, и autoscroll: методы автоматически выполняют оптимизированную прокрутку.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– setBoundsOrigin:
– translateOriginToPoint:

enclosingScrollView enclosingScrollView Свойство

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

Объявление

Swift

var enclosingScrollView: NSScrollView? { get }

Objective C

@property(readonly, strong) NSScrollView *enclosingScrollView

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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


    
    scrollClipView (_: toPoint:)
    - scrollClipView:toPoint:

Уведомляет суперпредставление относительно представления клипа, что представление клипа должно сбросить источник своего прямоугольника границ.

Объявление

Swift

func scrollClipView(_ aClipView: NSClipView, toPoint newOrigin: NSPoint)

Objective C

- (void)scrollClipView:(NSClipView *)aClipView toPoint:(NSPoint)newOrigin

Параметры

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

Обсуждение

Суперпредставление aClipView должен тогда отправить a scrollToPoint: сообщение к aClipView с newOrigin как параметр. Этот механизм предоставлен так NSClipView суперпредставление объекта может скоординировать прокрутку многократных мозаичных представлений клипа.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

scrollToPoint: (NSClipView)

reflectScrolledClipView (_:) - reflectScrolledClipView:

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

Объявление

Swift

func reflectScrolledClipView(_ aClipView: NSClipView)

Objective C

- (void)reflectScrolledClipView:(NSClipView *)aClipView

Параметры

aClipView

NSClipView возразите, чье суперпредставление должно быть уведомлено.

Обсуждение

NSScrollView реализации этот метод для обновления NSScroller объекты.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Перетаскивание операций


    
    registerForDraggedTypes (_:)
    - registerForDraggedTypes:

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

Объявление

Swift

func registerForDraggedTypes(_ newTypes: [AnyObject])

Objective C

- (void)registerForDraggedTypes:(NSArray *)newTypes

Параметры


      newTypes

Массив универсальных идентификаторов типов. Посмотрите Типы для Стандартных Данных (OS X v10.6 и позже) для описаний идентификаторов типов области монтажа.

Обсуждение

Регистрация NSView объект для перетащенных типов автоматически делает его целевым объектом кандидата для сеанса перетаскивания. Также, это должно должным образом реализовать некоторых или весь из NSDraggingDestination методы протокола. Как удобство, NSView обеспечивает реализации по умолчанию этих методов. Посмотрите NSDraggingDestination спецификация протокола для подробных данных.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

registeredDraggedTypes
– unregisterDraggedTypes

unregisterDraggedTypes () - unregisterDraggedTypes

Не регистрирует получатель как возможное место назначения в сеансе перетаскивания.

Объявление

Swift

func unregisterDraggedTypes()

Objective C

- (void)unregisterDraggedTypes

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– registerForDraggedTypes:
– dragImage:at:offset:event:pasteboard:source:slideBack:
– shouldDelayWindowOrderingForEvent:
– beginDraggingSessionWithItems:event:source:
registeredDraggedTypes registeredDraggedTypes Свойство

Массив области монтажа перетаскивает типы, которые может принять представление. (только для чтения)

Объявление

Swift

var registeredDraggedTypes: [AnyObject] { get }

Objective C

@property(readonly, copy) NSArray *registeredDraggedTypes

Обсуждение

Это свойство содержит массив NSString объекты, каждый из которых соответствует универсальному идентификатору типа. Элементы матрицы без определенного порядка, но массив, как гарантируют, не будет содержать двойные записи. Для регистрации типов перетаскивания представления используйте registerForDraggedTypes: метод.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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


    
    beginDraggingSessionWithItems (_: event:source:)
    - beginDraggingSessionWithItems:event:source:

Инициирует сеанс перетаскивания с группой перетаскивания элементов.

Объявление

Swift

func beginDraggingSessionWithItems(_ items: [AnyObject], event event: NSEvent, source source: NSDraggingSource) -> NSDraggingSession

Objective C

- (NSDraggingSession *)beginDraggingSessionWithItems:(NSArray *)items event:(NSEvent *)event source:(id<NSDraggingSource>)source

Параметры

`items`	Элементы перетаскивания. Свойство кадра каждого `NSDraggingItem` должен быть в системе координат представления.
`event`	Объект события mouseDown, от которого можно инициировать работу перетаскивания. В частности его расположение мыши используется для смещения перетаскиваемого значка.
`source`	Объект, служащий контроллером работы перетаскивания. Это должно соответствовать `NSDraggingSource` протокол и обычно является самим получателем или `NSWindow` объект.

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

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

Обсуждение

Основное перетаскивание запускается путем вызова beginDraggingSessionWithItems:event:source:.

Вызывающая сторона может взять возвращенный NSDraggingSession и продолжайте изменять его свойства. Когда перетаскивание фактически запускается, источник отправляется a draggingSession:willBeginAtPoint: сообщение, сопровождаемое кратным числом draggingSession:movedToPoint: сообщения как пользователь перетаскивают.

Как только перетаскивание заканчивается или отменяется, источник получает a draggingSession:endedAtPoint:operation: метод и перетаскивание завершены.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– registerForDraggedTypes:
– unregisterDraggedTypes
– dragImage:at:offset:event:pasteboard:source:slideBack:
– shouldDelayWindowOrderingForEvent:


    
    dragFile (_: fromRect:slideBack:event:)
    - dragFile:fromRect:slideBack:event:

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

Объявление

Swift

func dragFile(_ fullPath: String, fromRect aRect: NSRect, slideBack slideBack: Bool, event theEvent: NSEvent) -> Bool

Objective C

- (BOOL)dragFile:(NSString *)fullPath fromRect:(NSRect)aRect slideBack:(BOOL)slideBack event:(NSEvent *)theEvent

Параметры

`fullPath`	Строка, указывающая абсолютный путь для перетаскивающегося файла.
`aRect`	Прямоугольник, описывающий позицию значка в системе координат получателя.
`slideBack`	Булевская переменная, указывающая, должен ли перетаскиваемый значок скользить назад к его позиции в получателе, если не принят файл. Значок скользит назад к `aRect` если `slideBack` `YEStrue`, файл не принят местом назначения перетаскивания, и пользователь не отключил анимацию значка; иначе это просто исчезает.
`theEvent`	Объект события mouseDown, от которого можно инициировать работу перетаскивания. В частности его расположение мыши используется для смещения перетаскиваемого значка.

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

YEStrue если получатель успешно инициирует работу перетаскивания (который не обязательно означает работу перетаскивания, завершенную успешно). Иначе возвраты NOfalse.

Обсуждение

Этот метод должен быть вызван только в реализации mouseDown: метод.

Посмотрите NSDraggingSource, NSDraggingInfo, и NSDraggingDestination спецификации протокола для получения дополнительной информации о перетаскивании операций.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– dragImage:at:offset:event:pasteboard:source:slideBack:
– shouldDelayWindowOrderingForEvent:


    
    dragPromisedFilesOfTypes (_: fromRect:source:slideBack:event:)
    - dragPromisedFilesOfTypes:fromRect:source:slideBack:event:

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

Объявление

Swift

func dragPromisedFilesOfTypes(_ typeArray: [AnyObject], fromRect aRect: NSRect, source sourceObject: AnyObject, slideBack slideBack: Bool, event theEvent: NSEvent) -> Bool

Objective C

- (BOOL)dragPromisedFilesOfTypes:(NSArray *)typeArray fromRect:(NSRect)aRect source:(id)sourceObject slideBack:(BOOL)slideBack event:(NSEvent *)theEvent

Параметры

`typeArray`	Массив обещанных типов файлов. Элементы матрицы могут состоять из расширений файла и типов HFS, закодированных с `NSFileTypeForHFSTypeCode` функция. При обещании каталога файлов только включайте главный каталог в массив.
`aRect`	Прямоугольник, описывающий позицию значка в системе координат получателя.
`sourceObject`	Объект, служащий контроллером работы перетаскивания. Это должно соответствовать `NSDraggingSource` протокол, и обычно является самим получателем или `NSWindow` объект.
`slideBack`	Булевская переменная, указывающая, должен ли перетаскиваемый значок скользить назад к его позиции в получателе, если не принят файл. Значок скользит назад к `aRect` если `slideBack` `YEStrue`, обещанные файлы не приняты местом назначения перетаскивания, и пользователь не отключил анимацию значка; иначе это просто исчезает.
`theEvent`	Объект события mouseDown, от которого можно инициировать работу перетаскивания. В частности его расположение мыши используется для смещения перетаскиваемого значка.

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

YEStrue если работа перетаскивания инициируется успешно, NOfalse иначе.

Обсуждение

Этот метод должен быть вызван только в реализации mouseDown: метод. Как часть его реализации, этот метод вызывает dragImage:at:offset:event:pasteboard:source:slideBack:.

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

Посмотрите, что Перетаскивание Программирует Темы для получения дополнительной информации о перетаскивании операций.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– registerForDraggedTypes:
– unregisterDraggedTypes
– dragImage:at:offset:event:pasteboard:source:slideBack:
– shouldDelayWindowOrderingForEvent:
– beginDraggingSessionWithItems:event:source:

shouldDelayWindowOrderingForEvent (_:) - shouldDelayWindowOrderingForEvent:

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

Объявление

Swift

func shouldDelayWindowOrderingForEvent(_ theEvent: NSEvent) -> Bool

Objective C

- (BOOL)shouldDelayWindowOrderingForEvent:(NSEvent *)theEvent

Параметры

theEvent

Объект, представляющий начальное событие mouseDown.

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

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

Обсуждение

Никогда не вызывайте этот метод непосредственно; это вызывается автоматически для каждого события mouseDown, направленного на NSView.

NSView подкласс, позволяющий перетаскивать, должен реализовать этот метод для возврата YEStrue если theEvent потенциально начало сеанса перетаскивания или некоторого другого контекста, где упорядочивание окна не является надлежащим. Этот метод вызывается прежде a mouseDown: сообщение для theEvent отправляется. Возвраты реализации по умолчанию NOfalse.

Если после задерживающегося упорядочивания окна получатель фактически инициирует сеанс перетаскивания или подобную работу, это должно также отправить a preventWindowOrdering сообщение к NSApp, который полностью препятствует тому, чтобы окно упорядочило вперед и активация от становления активным. preventWindowOrdering отправляется автоматически NSViewdragImage:... и dragFile:... методы.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– registerForDraggedTypes:
– unregisterDraggedTypes
– dragImage:at:offset:event:pasteboard:source:slideBack:
– beginDraggingSessionWithItems:event:source:

Обработка умного увеличения


    
    rectForSmartMagnificationAtPoint (_: inRect:)
    - rectForSmartMagnificationAtPoint:inRect:

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

Объявление

Swift

func rectForSmartMagnificationAtPoint(_ location: NSPoint, inRect visibleRect: NSRect) -> NSRect

Objective C

- (NSRect)rectForSmartMagnificationAtPoint:(NSPoint)location inRect:(NSRect)visibleRect

Параметры

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

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

Прямоугольник для использования для увеличения, указанного в системе координат представления. Для получения поведения увеличения по умолчанию возвратиться NSZeroRect.

Обсуждение

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

Используйте этот метод для обеспечения AppKit прямоугольниками для пользовательского содержания представления. Если содержание Вашего представления может быть разделено на логические группы содержания, используйте предоставленное location и visibleRect параметры для определения, какая группа предназначается и затем возвращает прямоугольник, полностью включающий ту группу. Например, представление с многократными столбцами содержания могло возвратить прямоугольник для предназначенного столбца. Возвращенный прямоугольник должен всегда полностью включать содержание, независимо от того, больше ли тот прямоугольник, чем видимый прямоугольник.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

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

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

Объявление

Swift

var postsFrameChangedNotifications: Bool

Objective C

@property BOOL postsFrameChangedNotifications
Обсуждение

Когда значение этого свойства YEStrue и прямоугольные изменения кадра представления в новом значении, представление отправляет a NSViewFrameDidChangeNotification к центру уведомления по умолчанию. Уведомление не отправляется при установке прямоугольника кадра в значение, это уже имеет. Значение по умолчанию этого свойства YEStrue.

Если значение этого свойства в настоящее время NOfalse и и кадр изменился, изменив значение на YEStrue заставляет представление отправлять a NSViewFrameDidChangeNotification уведомление сразу. Это происходит, даже когда не было никакого чистого изменения в прямоугольнике кадра представления.

Следующие методы и свойства могут инициировать уведомление изменения кадра:
- кадр
- setFrameOrigin:
- setFrameSize:
- frameRotation
Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.0 и позже.
postsBoundsChangedNotifications postsBoundsChangedNotifications Свойство
Булево значение, указывающее, отправляет ли представление уведомления, когда изменяется его прямоугольник границ.

Объявление

Swift

var postsBoundsChangedNotifications: Bool

Objective C

@property BOOL postsBoundsChangedNotifications
Обсуждение

Когда значение этого свойства YEStrue и прямоугольные изменения границ представления в новом значении, представление отправляет a NSViewBoundsDidChangeNotification к центру уведомления по умолчанию. Уведомление не отправляется при установке прямоугольника границ в значение, это уже имеет. Значение по умолчанию этого свойства YEStrue.

Если значение этого свойства в настоящее время NOfalse и и границы изменились, изменив значение на YEStrue заставляет представление отправлять a NSViewBoundsDidChangeNotification уведомление сразу. Это происходит, даже когда не было никакого чистого изменения в прямоугольнике границ представления.

Следующие методы и свойства могут инициировать уведомление изменения кадра:
- границы
- setBoundsOrigin:
- setBoundsSize:
- boundsRotation
- translateOriginToPoint:
- scaleUnitSquareToSize:
- rotateByAngle:
Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Реакция на изменения в свойствах запоминающего устройства

viewDidChangeBackingProperties () - viewDidChangeBackingProperties

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

Объявление

Swift

func viewDidChangeBackingProperties()

Objective C

- (void)viewDidChangeBackingProperties

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Поиск тегом

viewWithTag (_:) - viewWithTag:

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

Объявление

Swift

func viewWithTag(_ aTag: Int) -> AnyObject?

Objective C

- (id)viewWithTag:(NSInteger)aTag

Параметры

aTag

Целочисленный идентификатор, связанный с целью, возражает.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

тег
тег тег Свойство

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

Объявление

Swift

var tag: Int { get }

Objective C

@property(readonly) NSInteger tag

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– viewWithTag:

Подсказки


    
    addToolTipRect (_: owner:userData:)
    - addToolTipRect:owner:userData:

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

Объявление

Swift

func addToolTipRect(_ aRect: NSRect, owner anObject: AnyObject, userData userData: UnsafeMutablePointer<Void>) -> NSToolTipTag

Objective C

- (NSToolTipTag)addToolTipRect:(NSRect)aRect owner:(id)anObject userData:(void *)userData

Параметры

`aRect`	Прямоугольник, определяющий область получателя для соединения подсказку с.
`anObject`	Объект, из которого можно получить строку подсказки. Объект должен или реализовать `view:stringForToolTip:point:userData:`, или возвратите подходящую строку из `description` метод. (Это может поэтому просто быть `NSString` объект.) Важный Получатель поддерживает слабую ссылку на `anObject`. Вы ответственны за обеспечение этого `anObject` остается допустимым столько, сколько это может быть необходимо.
`userData`	Любая дополнительная информация Вы хотите передать `view:stringForToolTip:point:userData:`; это не используется если `anObject` не реализует этот метод.

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

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

Обсуждение

Строка подсказки получена динамично из anObject путем вызова любого NSToolTipOwner неофициальный метод протокола view:stringForToolTip:point:userData:, если реализовано, или NSObject метод протокола description.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– removeToolTip:
– removeAllToolTips

removeAllToolTips () - removeAllToolTips

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

Объявление

Swift

func removeAllToolTips()

Objective C

- (void)removeAllToolTips

Обсуждение

Этот метод воздействует на подсказки, создаваемые с помощью также addToolTipRect:owner:userData: или набор с помощью toolTip свойство.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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


    
    removeToolTip (_:)
    - removeToolTip:

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

Объявление

Swift

func removeToolTip(_ tag: NSToolTipTag)

Objective C

- (void)removeToolTip:(NSToolTipTag)tag

Параметры

tag

Целочисленный тег, который является значением, возвращенным предыдущим addToolTipRect:owner:userData: сообщение.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

подсказка подсказка Свойство

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

Объявление

Swift

var toolTip: String?

Objective C

@property(copy) NSString *toolTip

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Управление прямоугольниками отслеживания


    
    addTrackingRect (_: owner:userData:assumeInside:)
    - addTrackingRect:owner:userData:assumeInside:

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

Объявление

Swift

func addTrackingRect(_ aRect: NSRect, owner userObject: AnyObject, userData userData: UnsafeMutablePointer<Void>, assumeInside flag: Bool) -> NSTrackingRectTag

Objective C

- (NSTrackingRectTag)addTrackingRect:(NSRect)aRect owner:(id)userObject userData:(void *)userData assumeInside:(BOOL)flag

Параметры

`aRect`	Прямоугольник, определяющий область получателя для отслеживания вводимых в мышь и вышедших мышью событий.
`userObject`	Объект, отправляющийся сообщения о событиях. Это может быть сам получатель или некоторый другой объект (такой как NSCursor или пользовательский объект инструмента для рисования), пока это реагирует на обоих `mouseEntered:` и `mouseExited:`.
`userData`	Данные, хранившие в `NSEvent` объект для каждого события отслеживания.
`flag`	Если `YEStrue`, когда курсор уедет, первое событие будет сгенерировано `aRect`, независимо, если курсор внутри `aRect` когда добавляется прямоугольник отслеживания. Если `NOfalse` когда курсор уедет, первое событие будет сгенерировано `aRect` если курсор первоначально внутри `aRect`, или когда входит курсор `aRect` если курсор первоначально снаружи `aRect`. Вы обычно хотите установить этот флаг в `NOfalse`.

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

Тег, идентифицирующий прямоугольник отслеживания. Это сохранено в связанном NSEvent объекты и могут использоваться для удаления прямоугольника отслеживания.

Обсуждение

Отслеживающие прямоугольники обеспечивают общий механизм, который может использоваться для инициирования действий на основе позиции курсора (например, строка состояния или поле подсказки, предоставляющее информацию об элементе, курсор находится). Для простого изменения курсора по определенной области использовать addCursorRect:cursor:. Если необходимо использовать прямоугольники отслеживания для изменения курсора, NSCursor спецификация класса описывает дополнительные методы, которые должны быть вызваны для изменения курсоров при помощи отслеживания прямоугольников.

На OS X v10.5 и позже, отслеживающие области обеспечивают больший диапазон функциональности (см. addTrackingArea:).

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– removeTrackingRect:
– addTrackingArea:
userData (NSEvent)


    
    removeTrackingRect (_:)
    - removeTrackingRect:

Удаляет прямоугольник отслеживания, идентифицированный тегом.

Объявление

Swift

func removeTrackingRect(_ aTag: NSTrackingRectTag)

Objective C

- (void)removeTrackingRect:(NSTrackingRectTag)aTag

Параметры


      aTag

Целочисленное значение, идентифицирующее прямоугольник отслеживания. Это было возвращено ранее отправленный addTrackingRect:owner:userData:assumeInside: сообщение.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– addTrackingRect:owner:userData:assumeInside:
– removeTrackingArea:

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

addTrackingArea (_:) - addTrackingArea:

Добавляет данное отслеживание области к получателю.

Объявление

Swift

func addTrackingArea(_ trackingArea: NSTrackingArea)

Objective C

- (void)addTrackingArea:(NSTrackingArea *)trackingArea

Параметры

trackingArea

Область отслеживания для добавления к получателю.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

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

Объявление

Swift

func removeTrackingArea(_ trackingArea: NSTrackingArea)

Objective C

- (void)removeTrackingArea:(NSTrackingArea *)trackingArea

Параметры

trackingArea

Область отслеживания для удаления из получателя.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Массив областей отслеживания получателя. (только для чтения)

Объявление

Swift

var trackingAreas: [AnyObject] { get }

Objective C

@property(readonly, copy) NSArray *trackingAreas

Обсуждение

Это свойство содержит массив NSTrackingArea объекты. Если представление не имеет никаких областей отслеживания, массив пуст.

Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.5 и позже.
updateTrackingAreas () - updateTrackingAreas

Вызванный автоматически, когда геометрия представления изменяется таким образом, что должны быть повторно вычислены ее области отслеживания.

Объявление

Swift

func updateTrackingAreas()

Objective C

- (void)updateTrackingAreas

Обсуждение

Необходимо переопределить этот метод, чтобы удалить устаревший области отслеживания и добавить повторно вычисленные области отслеживания; Ваша реализация должна вызвать super.

Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.5 и позже.

Управление отслеживанием курсора


    
    addCursorRect (_: курсор:)
    - addCursorRect:cursor:

Устанавливает курсор, который будет использоваться, когда указатель мыши находится в указанной области.

Объявление

Swift

func addCursorRect(_ aRect: NSRect, cursor aCursor: NSCursor)

Objective C

- (void)addCursorRect:(NSRect)aRect cursor:(NSCursor *)aCursor

Параметры

`aRect`	Прямоугольник, определяющий область получателя.
`aCursor`	Объект, представляющий курсор.

Обсуждение

Прямоугольники курсора не подвергаются отсечению суперпредставлениями, и при этом они не предназначаются для использования с повернутыми представлениями. Необходимо явно ограничить прямоугольник курсора видимым прямоугольником представления для предотвращения неподходящего поведения.

Этот метод предназначается, чтобы быть вызванным только resetCursorRects метод. Если вызвано любым другим способом, получающийся прямоугольник курсора будет отброшен в следующий раз, когда прямоугольники курсора представления восстановлены.

Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.0 и позже.

См. также

– removeCursorRect:cursor:
– discardCursorRects
– resetCursorRects
visibleRect


    
    removeCursorRect (_: курсор:)
    - removeCursorRect:cursor:

Полностью удаляет прямоугольник курсора из получателя.

Объявление

Swift

func removeCursorRect(_ aRect: NSRect, cursor aCursor: NSCursor)

Objective C

- (void)removeCursorRect:(NSRect)aRect cursor:(NSCursor *)aCursor

Параметры

`aRect`	Прямоугольник, определяющий область получателя. Должен соответствовать значение ранее указало использование `addCursorRect:cursor:`.
`aCursor`	Объект, представляющий курсор. Должен соответствовать значение ранее указало использование `addCursorRect:cursor:`.

Обсуждение

Необходимо редко должны быть использовать этот метод. resetCursorRects метод, который вызывают, когда прямоугольники курсора должны быть восстановлены, должен установить только необходимые прямоугольники курсора. Если Вы реализуете resetCursorRects таким образом можно тогда просто изменить состояние это resetCursorRects использование, чтобы создать его прямоугольники курсора и затем вызвать NSWindow метод invalidateCursorRectsForView:.

Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.0 и позже.

См. также

– discardCursorRects

discardCursorRects () - discardCursorRects

Лишает законной силы все прямоугольники курсора, установленные с помощью addCursorRect:cursor:.

Объявление

Swift

func discardCursorRects()

Objective C

- (void)discardCursorRects

Обсуждение

Вы никогда не должны вызывать этот метод непосредственно; и при этом это обычно не вызывается во время аннулирования прямоугольников курсора. NSWindow автоматически лишает законной силы прямоугольники курсора в ответ на invalidateCursorRectsForView: и прежде чем прямоугольники курсора получателя восстановлены с помощью resetCursorRects. Этот метод вызывается непосредственно перед тем, как получатель удален из окна и когда освобожден получатель.

Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.0 и позже.

См. также

discardCursorRects (NSWindow)
resetCursorRects () - resetCursorRects

Переопределенный подклассами для определения их прямоугольников курсора по умолчанию.

Объявление

Swift

func resetCursorRects()

Objective C

- (void)resetCursorRects

Обсуждение

Реализация подкласса должна вызвать addCursorRect:cursor: для каждого прямоугольника курсора это хочет установить. Реализация по умолчанию ничего не делает.

Код приложения никогда не должен вызывать этот метод непосредственно; это вызывается автоматически, как описано в «Ответе на Пользовательские события и Действия». Используйте invalidateCursorRectsForView: метод вместо этого для явного восстановления прямоугольников курсора.

Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.0 и позже.

См. также

visibleRect

Контекстные меню

menuForEvent (_:) - menuForEvent:

Переопределенный подклассами для возврата контекстно-зависимого всплывающего меню для данного события mouseDown.

Объявление

Swift

func menuForEvent(_ theEvent: NSEvent) -> NSMenu?

Objective C

- (NSMenu *)menuForEvent:(NSEvent *)theEvent

Параметры

theEvent

Объект, представляющий событие mouseDown.

Обсуждение

Получатель может использовать информацию в событии от нажатия мыши, таком как его расположение по определенному элементу получателя, для определения какой меню для возврата. Например, текстовый объект мог бы вывести на экран меню редактирования текста, когда курсор находится по тексту и меню для изменения графических атрибутов, когда курсор находится по встроенному изображению.

Реализация по умолчанию возвращает нормальное меню получателя.

Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.0 и позже.

См. также

+ defaultMenu
menu (NSResponder)
defaultMenu () + defaultMenu

Переопределенный подклассами для возврата всплывающего меню по умолчанию для экземпляров класса получения.

Объявление

Swift

class func defaultMenu() -> NSMenu?

Objective C

+ (NSMenu *)defaultMenu

Обсуждение

Возвраты реализации по умолчанию nil.

Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.0 и позже.

См. также

– menuForEvent:
menu (NSResponder)

Запись приспосабливающий рендерингу инструкций

beginDocument () - beginDocument

Вызванный в начале сеанса печати, этот метод устанавливает текущий графический контекст.

Объявление

Swift

func beginDocument()

Objective C

- (void)beginDocument

Обсуждение

Обратите внимание на то, что этот метод может быть вызван в подпотоке.

Переопределите это для конфигурирования печати связало настройки. Необходимо сохранить настройки в объекте, возвращенном NSPrintInfo sharedPrintInfo метод класса, который, как гарантируют, возвратит экземпляр, определенный для потока, в котором Вы вызываете этот метод. При переопределении этого метода вызовите реализацию суперкласса.

Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.0 и позже.
endDocument () - endDocument

Этот метод вызывается в конце сеанса печати.

Объявление

Swift

func endDocument()

Objective C

- (void)endDocument

Обсуждение

При переопределении этого метода вызовите реализацию суперкласса.

Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.0 и позже.
endPage () - endPage

Пишет конец соответствующей страницы.

Объявление

Swift

func endPage()

Objective C

- (void)endPage

Обсуждение

Этот метод вызывается после того, как каждая страница распечатана. Это вызывает unlockFocus. Этот метод также генерирует комментарии для ограничительной рамки и шрифтов страницы, если они были указаны как являющийся в конце страницы.

Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.0 и позже.

Отображение Windows определения


    
    showDefinitionForAttributedString (_: atPoint:)
    - showDefinitionForAttributedString:atPoint:

Показывает окно, выводящее на экран определение приписанной строки в указанной точке.

Объявление

Swift

func showDefinitionForAttributedString(_ attrString: NSAttributedString?, atPoint textBaselineOrigin: NSPoint)

Objective C

- (void)showDefinitionForAttributedString:(NSAttributedString *)attrString atPoint:(NSPoint)textBaselineOrigin

Параметры


      attrString

Приписанная строка, для которой можно показать определение. Если получатель является экземпляром NSTextView, attrString может быть nil, когда текстовое представление автоматически предоставит значения, подходящие для отображения определений для указанного диапазона в его текстовом содержании.


      textBaselineOrigin

Указывает базовый источник attrString в системе координат представления получателя.

Обсуждение

Показывает окно, выводящее на экран определение (или другой предмет в зависимости от доступных словарей) указанной приписанной строки.

Этот метод может использоваться для реализации той же функциональности как NSTextView Контекстное меню «Look Up in Dictionary» на пользовательском представлении.

Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.6 и позже.

См. также

– showDefinitionForAttributedString:range:options:baselineOriginProvider:


    
    showDefinitionForAttributedString (_: range:options:baselineOriginProvider:)
    - showDefinitionForAttributedString:range:options:baselineOriginProvider:

Показывает окно, выводящее на экран определение указанного диапазона приписанной строки.

Объявление

Swift

func showDefinitionForAttributedString(_ attrString: NSAttributedString?, range range: NSRange, options options: [NSObject : AnyObject]?, baselineOriginProvider originProvider: ((NSRange) -> NSPoint)?)

Objective C

- (void)showDefinitionForAttributedString:(NSAttributedString *)attrString range:(NSRange)range options:(NSDictionary *)options baselineOriginProvider:(NSPoint (^)(NSRange adjustedRange))originProvider

Параметры


      attrString


      range

Диапазон приписанной строки для определения. Можно передать диапазон нулевой длины, и надлежащий диапазон будет автоматически обнаружен вокруг смещения диапазона. Когда нет никакого выбора, это - рекомендуемый подход.


      options

Дополнительный словарь, указывающий, как определение выведено на экран. См. Константы Представления NSDefinition для ключа, и это - возможные значения.


      originProvider

Блочный объект originProvider должен возвратить базовый источник для первого символа в скорректированном диапазоне.

Если получатель является экземпляром NSTextView, originProvider может быть NULL, когда текстовое представление автоматически предоставит значения, подходящие для отображения определений для указанного диапазона в его текстовом содержании.

Блочный объект берет отдельный аргумент:


      adjustedRange

Скорректированный диапазон.

Блочный объект возвращается NSPoint чтобы использоваться в качестве базового источника первого символа, в получателе просматривают систему координат.

Обсуждение

Этот метод не вызывает прокрутку, таким образом, клиенты должны выполнить любую необходимую прокрутку прежде, чем вызвать этот метод.

Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.6 и позже.

См. также

– showDefinitionForAttributedString:atPoint:

Получение находит индикатор

drawingFindIndicator drawingFindIndicator Свойство

Булево значение, указывающее, привлекаются ли представление или один из его наследователей для индикатора находки. (только для чтения)

Объявление

Swift

var drawingFindIndicator: Bool { get }

Objective C

@property(getter=isDrawingFindIndicator, readonly) BOOL drawingFindIndicator

Обсуждение

Значение этого свойства YEStrue когда содержание представления рисуется так, чтобы они были легко читаемы против фона индикатора находки. Значение по умолчанию этого свойства NOfalse.

Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.7 и позже.

Управление направлением макета содержания

userInterfaceLayoutDirection userInterfaceLayoutDirection Свойство

Направление макета для содержания в представлении.

Объявление

Swift

var userInterfaceLayoutDirection: NSUserInterfaceLayoutDirection

Objective C

@property NSUserInterfaceLayoutDirection userInterfaceLayoutDirection

Обсуждение

Различные языки поддерживают различные направления для разметки содержания. В то время как много языков поддерживают слева направо расположение, некоторая поддержка справа налево расположение. Это свойство содержит предпочтительное направление макета, используемое представлением. Это - ответственность представления уважать это значение и разметить его содержание соответственно.

В OS X v10.9 и позже, если никакое направление макета не установлено явно, это свойство содержит значение, о котором сообщает приложение userInterfaceLayoutDirection свойство. В предыдущих версиях OS X это возвращает значение NSUserInterfaceLayoutDirectionLeftToRight по умолчанию. Определенные подклассы AppKit, такой как NSOutlineView, уважайте значение, возвращенное этим методом, и скорректируйте их расположение соответственно.

Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.8 и позже.

Указание разрешения поверхности OpenGL

wantsBestResolutionOpenGLSurface wantsBestResolutionOpenGLSurface Свойство

Булево значение, указывающее, хочет ли представление поверхность поддержки OpenGL с разрешением, больше, чем 1 пиксель за точку.

Объявление

Swift

var wantsBestResolutionOpenGLSurface: Bool

Objective C

@property BOOL wantsBestResolutionOpenGLSurface

Возвращаемое значение

YEStrue если представление хочет поверхность поддержки высокого разрешения или NOfalse если это не делает.

Обсуждение

Это свойство важно только для представлений к который NSOpenGLContext объект связывается (включая, но не ограничиваясь этим, NSOpenGLView объекты). Поддержанные уровнем представления игнорируют значение в этом свойстве и конфигурируют их собственную поверхность поддержки в надлежащем разрешении.

Для совместимости значение по умолчанию этого свойства NOfalse, который приводит к кадровому буферу 1 пикселя за точку независимо от отступающего масштабного коэффициента для дисплея, представление занимает. (Когда отступающий масштабный коэффициент больше, чем 1,0, представленное поверхностное содержание увеличено к надлежащему пользовательскому размеру.) Изменение значения к YEStrue говорит AppKit, что он имеет разрешение выделить более высокий кадровый буфер разрешения для представления. AppKit использует отступающий масштабный коэффициент и предназначенный дисплей, чтобы определить, является ли более высокий буфер разрешения надлежащим, и это может изменить поверхностное разрешение, когда изменения режима отображения или представление перемещаются в различный дисплей.

Когда Вы устанавливаете это свойство в YEStrue, представление должно быть в состоянии преобразовать между модулями представления и пиксельными модулями при необходимости. Например, передавая границы представления, неизмененные к glViewport функционируйте приводит к неправильным результатам при поддержке масштабных коэффициентов кроме 1.0. Можно использовать convertPointToBacking:, convertRectToBacking:, и convertSizeToBacking: методы для преобразования координатных значений в разрешение запоминающего устройства.

Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.7 и позже.

Устаревшие методы

convertPointToBase: - convertPointToBase: (OS X v10.7)

Преобразовывает точку от системы координат получателя до основной системы координат.

Оператор осуждения

Использовать convertPointToBacking: вместо этого.

Объявление

Objective C

- (NSPoint)convertPointToBase:(NSPoint)aPoint

Параметры

aPoint

Точка, указывающая расположение в системе координат получателя.

Возвращаемое значение

Точка, преобразованная в основную систему координат.

Обсуждение

Посмотрите Координаты Представления Преобразования К и От Основного Пространства для описания координаты представления для базирования координатного преобразования.

Оператор импорта

Objective C

@import AppKit;

Доступность

Доступный в OS X v10.5 и позже.
Осуждаемый в OS X v10.7.
convertPointFromBase: - convertPointFromBase: (OS X v10.7)

Преобразовывает точку от основной системы координат до системы координат получателя.

Оператор осуждения

Использовать convertPointFromBacking: вместо этого.

Объявление

Objective C

- (NSPoint)convertPointFromBase:(NSPoint)aPoint

Параметры

aPoint

Точка, указывающая расположение в основной системе координат.

Возвращаемое значение

Точка, преобразованная в основную систему координат получателя.

Обсуждение

Посмотрите Координаты Представления Преобразования К и От Основного Пространства для описания координаты представления для базирования координатного преобразования.

Оператор импорта

Objective C

@import AppKit;

Доступность

Доступный в OS X v10.5 и позже.
Осуждаемый в OS X v10.7.
convertSizeToBase: - convertSizeToBase: (OS X v10.7)

Преобразовывает размер от системы координат получателя до основной системы координат.

Оператор осуждения

Использовать convertSizeToBacking: вместо этого.

Объявление

Objective C

- (NSSize)convertSizeToBase:(NSSize)aSize

Параметры

aSize

Размер в системе координат получателя

Возвращаемое значение

Размер, преобразованный в основную систему координат.

Обсуждение

Посмотрите Координаты Представления Преобразования К и От Основного Пространства для описания координаты представления для базирования координатного преобразования.

Оператор импорта

Objective C

@import AppKit;

Доступность

Доступный в OS X v10.5 и позже.
Осуждаемый в OS X v10.7.
convertSizeFromBase: - convertSizeFromBase: (OS X v10.7)

Преобразовывает размер от основной системы координат до системы координат получателя.

Оператор осуждения

Использовать convertSizeFromBacking: вместо этого.

Объявление

Objective C

- (NSSize)convertSizeFromBase:(NSSize)aSize

Параметры

aSize

Размер в основной системе координат

Возвращаемое значение

Размер, преобразованный в систему координат получателя.

Обсуждение

Посмотрите Координаты Представления Преобразования К и От Основного Пространства для описания координаты представления для базирования координатного преобразования.

Оператор импорта

Objective C

@import AppKit;

Доступность

Доступный в OS X v10.5 и позже.
Осуждаемый в OS X v10.7.
convertRectToBase: - convertRectToBase: (OS X v10.7)

Преобразовывает прямоугольник от системы координат получателя до основной системы координат.

Оператор осуждения

Использовать convertRectToBacking: вместо этого.

Объявление

Objective C

- (NSRect)convertRectToBase:(NSRect)aRect

Параметры

aRect

Прямоугольник в системе координат получателя

Возвращаемое значение

Прямоугольник в основной системе координат

Обсуждение

Посмотрите Координаты Представления Преобразования К и От Основного Пространства для описания координаты представления для базирования координатного преобразования.

Оператор импорта

Objective C

@import AppKit;

Доступность

Доступный в OS X v10.5 и позже.
Осуждаемый в OS X v10.7.
convertRectFromBase: - convertRectFromBase: (OS X v10.7)

Преобразовывает прямоугольник от основной системы координат до системы координат получателя.

Оператор осуждения

Использовать convertRectFromBacking: вместо этого.

Объявление

Objective C

- (NSRect)convertRectFromBase:(NSRect)aRect

Параметры

aRect

Прямоугольник в основной системе координат

Возвращаемое значение

Прямоугольник в системе координат получателя

Обсуждение

Посмотрите Координаты Представления Преобразования К и От Основного Пространства для описания координаты представления для базирования координатного преобразования.

Оператор импорта

Objective C

@import AppKit;

Доступность

Доступный в OS X v10.5 и позже.
Осуждаемый в OS X v10.7.
performMnemonic: - performMnemonic: (OS X v10.8)

Реализованный подклассами для ответа на мнемонику.

Оператор осуждения

Поведение, предлагаемое этим методом, больше не необходимо.

Объявление

Objective C

- (BOOL)performMnemonic:(NSString *)aString

Параметры

aString

Строка, представляющая мнемосхему для обработки.

Обсуждение

Если мнемосхема получателя совпадает с символами строки aString, получатель должен принять соответствующие меры и возврат YEStrue. Иначе, это должно возвратить результат вызова superреализация. Реализация по умолчанию этого метода просто передает сообщение вниз иерархия представления (от суперпредставлений до подпредставлений) и возвраты NOfalse если ни одно из подпредставлений получателя не отвечает YEStrue. Мнемоника не поддерживается в OS X.

Оператор импорта

Objective C

@import AppKit;

Доступность

Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.8.

См. также

– performKeyEquivalent:
keyDown: (NSWindow)
shouldDrawColor () - shouldDrawColor (OS X v10.10)

Возвращает булево значение, указывающее, рисуется ли представление к среде, поддерживающей цвет.

Оператор осуждения

Поведение, предлагаемое этим методом, больше не необходимо.

Объявление

Swift

func shouldDrawColor() -> Bool

Objective C

- (BOOL)shouldDrawColor

Возвращаемое значение

YEStrue если окно представления поддерживает цветное получение или NOfalse если это не делает.

Обсуждение

Объект представления может базировать свое поведение получения на возвращаемом значении этого метода для улучшения его появления в полутоновых окнах. Этот метод мог бы возвратиться NOfalse когда окно представления не хранит информацию о цвете, потому что содержание предназначено для полутонового принтера.

Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.10.

См. также

– drawRect:
canStoreColor (NSWindow)
allocateGState () - allocateGState (OS X v10.10)

Заставляет получатель поддерживать частный объект состояния графики, инкапсулирующий все параметры графической среды.

Оператор осуждения

Управляйте состоянием графики с помощью NSGraphicsContext объект.

Объявление

Swift

func allocateGState()

Objective C

- (void)allocateGState

Обсуждение

Если Вы не вызываете allocateGState, объект состояния графики создается с нуля каждый раз, когда NSView фокусируется.

Получатель создает использование параметров состояния графики setUpGState, тогда автоматически устанавливает это состояние графики каждый раз, когда фокус заблокирован на нем. Состояние графики может улучшить производительность для объектов представления, которые часто фокусируются и должны установить много параметров, но использование типичных операторов рендеринга обычно достаточно эффективно.

Поскольку состояния графики занимают изрядное количество памяти, они могут фактически ухудшить производительность. Убедитесь производительности тестового приложения с и без частного состояния графики перед передаванием его использования.

Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.10.

См. также

– setUpGState
– gState
– renewGState
– releaseGState
– lockFocus
gState () - gState (OS X v10.10)

Если получатель не имеет объекта состояния графики, возвращает идентификатор для объекта состояния графики получателя, или 0.

Оператор осуждения

Управляйте состоянием графики с помощью NSGraphicsContext объект.

Объявление

Swift

func gState() -> Int

Objective C

- (NSInteger)gState

Обсуждение

Объект состояния графики объекта представления воссоздается с нуля каждый раз, когда представление фокусируется, если allocateGState метод был вызван. Таким образом, если получатель не фокусировался или не получил allocateGState сообщение, этот метод возвращается 0.

Несмотря на то, что приложения редко должны использовать значение, возвращенное gState, это может быть передано нескольким методам, берущим идентификатор объекта в качестве параметра.

Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.10.

См. также

– allocateGState
– setUpGState
– renewGState
– releaseGState
– lockFocus
setUpGState () - setUpGState (OS X v10.10)

Переопределенный подклассами к (ре) инициализируют объект состояния графики получателя.

Оператор осуждения

Управляйте состоянием графики с помощью NSGraphicsContext объект.

Объявление

Swift

func setUpGState()

Objective C

- (void)setUpGState

Обсуждение

Когда объект состояния графики создал использование, этот метод автоматически вызывается allocateGState потребности, которые будут инициализированы. Реализация по умолчанию ничего не делает. Ваш подкласс может переопределить его для установки текущего шрифта, ширины строки или любого другого параметра состояния графики кроме координатных трансформаций и траектории отсечения — они установлены кадром, и ограничивает прямоугольники и методами такой как scaleUnitSquareToSize: и translateOriginToPoint:. Обратите внимание на то, что drawRect: может далее преобразовать систему координат и траекторию отсечения для любых временных эффектов, в которых это нуждается.

Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.10.

См. также

– allocateGState
– renewGState
renewGState () - renewGState (OS X v10.10)

Лишает законной силы объект состояния графики получателя, если он имеет тот.

Оператор осуждения

Управляйте состоянием графики с помощью NSGraphicsContext объект.

Объявление

Swift

func renewGState()

Objective C

- (void)renewGState

Обсуждение

Объект состояния графики получателя будет регенерирован с помощью setUpGState в следующий раз получатель фокусируется для рисования

Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.10.

См. также

– lockFocus
releaseGState () - releaseGState (OS X v10.10)

Освобождает объект состояния графики получателя, если он имеет тот.

Оператор осуждения

Управляйте состоянием графики с помощью NSGraphicsContext объект.

Объявление

Swift

func releaseGState()

Objective C

- (oneway void)releaseGState

Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.10.

См. также

– allocateGState


    
    dragImage:at:offset:event:pasteboard:source:slideBack:
    - dragImage:at:offset:event:pasteboard:source:slideBack:

(OS X v10.7)

Инициирует работу перетаскивания от получателя, позволяя пользователю перетащить произвольные данные с указанным значком в любое приложение, имеющее окно или объекты представления, принимающие перетащенные данные.

Оператор осуждения

Использовать beginDraggingSessionWithItems:event:source: вместо этого.

Объявление

Objective C

- (void)dragImage:(NSImage *)anImage at:(NSPoint)imageLoc offset:(NSSize)mouseOffset event:(NSEvent *)theEvent pasteboard:(NSPasteboard *)pboard source:(id)sourceObject slideBack:(BOOL)slideBack

Параметры

`anImage`	`NSImage` объект, который будет перетащен.
`imageLoc`	Расположение нижнего левого угла изображения, в системе координат получателя. Это определяет размещение перетащенного изображения под курсором. При определении расположения изображения необходимо использовать мышь, вниз координируют, предоставленный в `theEvent`, вместо текущего расположения мыши.
`mouseOffset`	Этот параметр проигнорирован.
`theEvent`	Левое событие mouseDown, инициировавшее работу перетаскивания (см. обсуждение ниже).
`pboard`	Область монтажа, содержащая данные, которые будут переданы месту назначения (см. обсуждение ниже).
`sourceObject`	Объект, служащий контроллером работы перетаскивания. Это должно соответствовать `NSDraggingSource` протокол и обычно является самим получателем или `NSWindow` объект.
`slideBack`	Булевская переменная, определяющая, должно ли изображение перетаскивания скользить назад, если это отклоняется. Изображение скользит назад к `imageLoc` если `slideBack` `YEStrue` и изображение не принято местом назначения перетаскивания. Если `NOfalse` изображение не скользит назад.

Обсуждение

Этот метод должен быть вызван только в реализации mouseDown: или mouseDragged: методы.

Прежде, чем вызвать этот метод, необходимо поместить данные, которые будут переданы на pboard. Чтобы сделать это, получите объект области монтажа перетаскивания (NSDragPboard), объявите типы данных, и затем поместите данные по области монтажа. Этот фрагмент кода инициирует работу перетаскивания на самом изображении (т.е. изображение является данными, которые будут переданы):

      - (void)mouseDown:(NSEvent *)theEvent
{
    NSSize dragOffset = NSMakeSize(0.0, 0.0);
    NSPasteboard *pboard;
 
    pboard = [NSPasteboard pasteboardWithName:NSDragPboard];
    [pboard declareTypes:[NSArray arrayWithObject:NSTIFFPboardType]  owner:self];
    [pboard setData:[[self image] TIFFRepresentation] forType:NSTIFFPboardType];
 
    [self dragImage:[self image] at:[self imageLocation] offset:dragOffset
        event:theEvent pasteboard:pboard source:self slideBack:YES];
 
    return;
}


  

Оператор импорта

Objective C

@import AppKit;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.7.

См. также

– dragFile:fromRect:slideBack:event:
– shouldDelayWindowOrderingForEvent:

Типы данных

NSToolTipTag NSToolTipTag

Этот тип описывает прямоугольник, используемый для идентификации прямоугольника подсказки.

Объявление

Swift

typealias NSToolTipTag = Int

Objective C

typedef NSInteger NSToolTipTag;

Обсуждение

Если значение этого типа 0, это недопустимо. Посмотрите методы addToolTipRect:owner:userData: иremoveToolTip:.

Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.0 и позже.
NSTrackingRectTag NSTrackingRectTag

Этот тип описывает прямоугольник, используемый для отслеживания мыши.

Объявление

Swift

typealias NSTrackingRectTag = Int

Objective C

typedef NSInteger NSTrackingRectTag;

Обсуждение

Если значение этого типа 0, это недопустимо. Посмотрите методы addTrackingRect:owner:userData:assumeInside: и removeTrackingRect:.

Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.0 и позже.

Константы

NSBorderType
Эти константы указывают тип границы представления.

Объявление

Swift

enum NSBorderType : UInt { case NoBorder case LineBorder case BezelBorder case GrooveBorder }

Objective C

enum { NSNoBorder = 0, NSLineBorder = 1, NSBezelBorder = 2, NSGrooveBorder = 3 }; typedef NSUInteger NSBorderType;

Константы
- BezelBorder
  
  NSBezelBorder
  
  Вогнутая граница, заставляющая представление выглядеть затонувшим.
  
  Доступный в OS X v10.0 и позже.
- GrooveBorder
  
  NSGrooveBorder
  
  Тонкая рамка, выглядящая вытравленной вокруг изображения.
  
  Доступный в OS X v10.0 и позже.
- LineBorder
  
  NSLineBorder
  
  Граница черного пятна вокруг представления.
  
  Доступный в OS X v10.0 и позже.
- NoBorder
  
  NSNoBorder
  
  Никакая граница.
  
  Доступный в OS X v10.0 и позже.
Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.0 и позже.
NSAutoresizingMaskOptions
Константы, используемые autoresizingMask свойство.

Объявление

Swift

struct NSAutoresizingMaskOptions : RawOptionSetType { init(_ rawValue: UInt) init(rawValue rawValue: UInt) static var ViewNotSizable: NSAutoresizingMaskOptions { get } static var ViewMinXMargin: NSAutoresizingMaskOptions { get } static var ViewWidthSizable: NSAutoresizingMaskOptions { get } static var ViewMaxXMargin: NSAutoresizingMaskOptions { get } static var ViewMinYMargin: NSAutoresizingMaskOptions { get } static var ViewHeightSizable: NSAutoresizingMaskOptions { get } static var ViewMaxYMargin: NSAutoresizingMaskOptions { get } }

Objective C

typedef enum NSAutoresizingMaskOptions : NSUInteger { NSViewNotSizable = 0, NSViewMinXMargin = 1, NSViewWidthSizable = 2, NSViewMaxXMargin = 4, NSViewMinYMargin = 8, NSViewHeightSizable = 16, NSViewMaxYMargin = 32 } NSAutoresizingMaskOptions;

Константы
- ViewNotSizable
  
  NSViewNotSizable
  
  Получатель не может быть изменен.
  
  Доступный в OS X v10.0 и позже.
- ViewMinXMargin
  
  NSViewMinXMargin
  
  Левое поле между получателем и его суперпредставлением гибко.
  
  Доступный в OS X v10.0 и позже.
- ViewWidthSizable
  
  NSViewWidthSizable
  
  Ширина получателя гибка.
  
  Доступный в OS X v10.0 и позже.
- ViewMaxXMargin
  
  NSViewMaxXMargin
  
  Правое поле между получателем и его суперпредставлением гибко.
  
  Доступный в OS X v10.0 и позже.
- ViewMinYMargin
  
  NSViewMinYMargin
  
  Нижнее поле между получателем и его суперпредставлением гибко.
  
  Доступный в OS X v10.0 и позже.
- ViewHeightSizable
  
  NSViewHeightSizable
  
  Высота получателя гибка.
  
  Доступный в OS X v10.0 и позже.
- ViewMaxYMargin
  
  NSViewMaxYMargin
  
  Верхнее поле между получателем и его суперпредставлением гибко.
  
  Доступный в OS X v10.0 и позже.
Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.10 и позже.
Полноэкранные опции режима
Эти константы являются ключами, в которых можно использовать в словаре опций enterFullScreenMode:withOptions: и exitFullScreenModeWithOptions:.

Объявление

Swift

let NSFullScreenModeAllScreens: NSString! let NSFullScreenModeSetting: NSString! let NSFullScreenModeWindowLevel: NSString! let NSFullScreenModeApplicationPresentationOptions: NSString!

Objective C

NSString * const NSFullScreenModeAllScreens; NSString * const NSFullScreenModeSetting; NSString * const NSFullScreenModeWindowLevel; NSString * const NSFullScreenModeApplicationPresentationOptions;

Константы
- NSFullScreenModeAllScreens
  
  NSFullScreenModeAllScreens
  
  Ключ, соответствующее значение которого указывает, должно ли представление принять все экраны.
  
  Соответствующее значение является экземпляром NSNumber содержа булево значение.
  
  Доступный в OS X v10.5 и позже.
- NSFullScreenModeSetting
  
  NSFullScreenModeSetting
  
  Ключ, соответствующее значение которого указывает полноэкранную установку режима.
  
  Соответствующее значение является экземпляром NSDictionary это содержит ключи, указанные в Display Mode Standard Properties и Display Mode Optional Properties в кварцевой ссылке служб дисплея.
  
  Когда NSFullScreenModeApplicationPresentationOptions указан в словаре опций, указывающем, что эта опция также вызовет исключение.
  
  Доступный в OS X v10.5 и позже.
- NSFullScreenModeWindowLevel
  
  NSFullScreenModeWindowLevel
  
  Ключ, соответствующее значение которого указывает экранный уровень окна режима.
  
  Соответствующее значение является экземпляром NSNumber содержа целочисленное значение.
  
  Доступный в OS X v10.5 и позже.
- NSFullScreenModeApplicationPresentationOptions
  
  NSFullScreenModeApplicationPresentationOptions
  
  Ключ, соответствующее значение которого указывает опции представления приложения..
  
  Соответствующее значение является экземпляром NSNumber содержа значение целого без знака NSApplicationPresentationOptions. Те опции могут быть объединены с помощью C поразрядно OR оператор, прежде чем создается NSNumber экземпляр. См. раздел констант Ссылки класса NSApplication NSApplicationPresentationOptions для получения дополнительной информации об этих опциях.
  
  Доступный в OS X v10.5 и позже.
NSViewLayerContentsRedrawPolicy
Константы, указывающие, как изменение размеров уровня обрабатывается, когда представление поддерживается уровнем или хостинг уровня. Для получения дополнительной информации посмотрите layerContentsRedrawPolicy свойство.

Объявление

Swift

enum NSViewLayerContentsRedrawPolicy : Int { case Never case OnSetNeedsDisplay case DuringViewResize case BeforeViewResize case Crossfade }

Objective C

enum { NSViewLayerContentsRedrawNever = 0, NSViewLayerContentsRedrawOnSetNeedsDisplay = 1, NSViewLayerContentsRedrawDuringViewResize = 2, NSViewLayerContentsRedrawBeforeViewResize = 3, NSViewLayerContentsRedrawCrossfade = 4 }; typedef NSInteger NSViewLayerContentsRedrawPolicy;

Константы
- Never
  
  NSViewLayerContentsRedrawNever
  
  Оставьте содержание уровня в покое. Никогда не отмечайте уровень как нуждающийся в дисплее или рисуйте содержание представления к уровню. Это - то, как разработчик создал уровни (размещающие уровень представления) обрабатываются.
  
  Доступный в OS X v10.6 и позже.
- OnSetNeedsDisplay
  
  NSViewLayerContentsRedrawOnSetNeedsDisplay
  
  Любой из setNeedsDisplay... методы, отправленные в представление, вызовут перерисовку представления затронутые части уровня путем вызова представления drawRect:, но ни один, уровень или представление отмечены как нуждающийся в дисплее, когда изменяется размер представления.
  
  Доступный в OS X v10.6 и позже.
- DuringViewResize
  
  NSViewLayerContentsRedrawDuringViewResize
  
  Измените размеры уровня поддержки представления и перерисуйте представление к уровню, когда изменится размер представления. Если изменение размеры будет анимировано, то AppKit будет управлять самой изменять размеры анимацией и сделает, это изменяет размеры и перерисовывает на каждом шаге анимации. Когда представление будет отмечено как нуждающийся в дисплее, затронутые части уровня будут также перерисованы. Этот режим является надмножеством NSViewLayerContentsRedrawOnSetNeedsDisplay. Это - способ, которым в настоящее время обрабатываются поддержанные уровнем представления.
  
  Доступный в OS X v10.6 и позже.
- BeforeViewResize
  
  NSViewLayerContentsRedrawBeforeViewResize
  
  Измените размеры уровня и перерисуйте представление к уровню, когда изменится размер представления. Это будет сделано только один раз в начале изменять размеры анимации, не в каждом кадре анимации. Когда представление будет отмечено как нуждающийся в дисплее, затронутые части уровня будут также перерисованы. Этот режим является надмножеством NSViewLayerContentsRedrawOnSetNeedsDisplay.
  
  Доступный в OS X v10.6 и позже.
- Crossfade
  
  NSViewLayerContentsRedrawCrossfade
  
  Перерисуйте содержание уровня в новом размере и выгорите от старого содержания до нового содержания. Используйте это в сочетании с NSViewLayerContentsPlacement константы для получения хорошего плавно накладывают анимацию для комплекса поддержанные уровнем представления, которые не могут обновить правильно на каждом шаге анимации.
  
  Доступный в OS X v10.9 и позже.
Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.6 и позже.
NSViewLayerContentsPlacement
Когда содержание не повторно представляется в ответ на изменение размеров представления, эти константы указывают расположение содержания уровня. Для получения дополнительной информации посмотрите layerContentsPlacement свойство.

Объявление

Swift

enum NSViewLayerContentsPlacement : Int { case ScaleAxesIndependently case ScaleProportionallyToFit case ScaleProportionallyToFill case Center case Top case TopRight case Right case BottomRight case Bottom case BottomLeft case Left case TopLeft }

Objective C

enum { NSViewLayerContentsPlacementScaleAxesIndependently = 0, NSViewLayerContentsPlacementScaleProportionallyToFit = 1, NSViewLayerContentsPlacementScaleProportionallyToFill = 2, NSViewLayerContentsPlacementCenter = 3, NSViewLayerContentsPlacementTop = 4, NSViewLayerContentsPlacementTopRight = 5, NSViewLayerContentsPlacementRight = 6, NSViewLayerContentsPlacementBottomRight = 7, NSViewLayerContentsPlacementBottom = 8, NSViewLayerContentsPlacementBottomLeft = 9, NSViewLayerContentsPlacementLeft = 10, NSViewLayerContentsPlacementTopLeft = 11 }; typedef NSInteger NSViewLayerContentsPlacement;

Константы
- ScaleAxesIndependently
  
  NSViewLayerContentsPlacementScaleAxesIndependently
  
  Содержание изменено для адаптации всему прямоугольнику границ.
  
  Доступный в OS X v10.6 и позже.
- ScaleProportionallyToFit
  
  NSViewLayerContentsPlacementScaleProportionallyToFit
  
  Содержание изменено для адаптации прямоугольнику границ, сохранив аспект содержания. Если содержание не полностью заполняет прямоугольник границ, содержание центрируется в частичной оси.
  
  Доступный в OS X v10.6 и позже.
- ScaleProportionallyToFill
  
  NSViewLayerContentsPlacementScaleProportionallyToFill
  
  Содержание изменено для завершенного заполнения прямоугольника границ, все еще сохраняя аспект содержания. Содержание центрируется в оси, которую оно превышает.
  
  Доступный в OS X v10.6 и позже.
- Center
  
  NSViewLayerContentsPlacementCenter
  
  Содержание горизонтально и вертикально центрируется в прямоугольнике границ.
  
  Доступный в OS X v10.6 и позже.
- Top
  
  NSViewLayerContentsPlacementTop
  
  Содержание горизонтально центрируется в главном краю прямоугольника границ.
  
  Доступный в OS X v10.6 и позже.
- TopRight
  
  NSViewLayerContentsPlacementTopRight
  
  Содержание расположено в верхний правый угол прямоугольника границ.
  
  Доступный в OS X v10.6 и позже.
- Right
  
  NSViewLayerContentsPlacementRight
  
  Содержание вертикально центрируется в правом краю прямоугольника границ.
  
  Доступный в OS X v10.6 и позже.
- BottomRight
  
  NSViewLayerContentsPlacementBottomRight
  
  Содержание расположено в нижний правый угол прямоугольника границ.
  
  Доступный в OS X v10.6 и позже.
- Bottom
  
  NSViewLayerContentsPlacementBottom
  
  Содержание горизонтально центрируется в базовом краю прямоугольника границ.
  
  Доступный в OS X v10.6 и позже.
- BottomLeft
  
  NSViewLayerContentsPlacementBottomLeft
  
  Содержание расположено в нижний левый угол прямоугольника границ.
  
  Доступный в OS X v10.6 и позже.
- Left
  
  NSViewLayerContentsPlacementLeft
  
  Содержание вертикально центрируется в левом краю прямоугольника границ.
  
  Доступный в OS X v10.6 и позже.
- TopLeft
  
  NSViewLayerContentsPlacementTopLeft
  
  Содержание расположено в верхний левый угол прямоугольника границ.
  
  Доступный в OS X v10.6 и позже.
Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.6 и позже.
Константы представления NSDefinition
Эти константы используются, чтобы управлять, как окна определения выведены на экран showDefinitionForAttributedString:range:options:baselineOriginProvider:. Если эта опция будет неуказанной, то определение будет показано в любой из тех форм представления в зависимости от 'Контекстного меню': установка в установках приложения Словаря.

Объявление

Swift

let NSDefinitionPresentationTypeKey: NSString! let NSDefinitionPresentationTypeOverlay: NSString! let NSDefinitionPresentationTypeDictionaryApplication: NSString!

Objective C

NSString * const NSDefinitionPresentationTypeKey; NSString * const NSDefinitionPresentationTypeOverlay; NSString * const NSDefinitionPresentationTypeDictionaryApplication;

Константы
- NSDefinitionPresentationTypeKey
  
  NSDefinitionPresentationTypeKey
  
  Дополнительный ключ в словаре опций, указывающем тип презентации дисплея определения. Это может иметь значение NSDefinitionPresentationTypeOverlay или NSDefinitionPresentationTypeDictionaryApplication.
  
  Доступный в OS X v10.6 и позже.
- NSDefinitionPresentationTypeOverlay
  
  NSDefinitionPresentationTypeOverlay
  
  Возможное значение NSDefinitionPresentationTypeKey ключ словаря, производящий маленькое окно наложения в строковом расположении,
  
  Доступный в OS X v10.6 и позже.
- NSDefinitionPresentationTypeDictionaryApplication
  
  NSDefinitionPresentationTypeDictionaryApplication
  
  Возможное значение NSDefinitionPresentationTypeKey ключ словаря, вызывающий приложение Dictionary для отображения определения.
  
  Доступный в OS X v10.6 и позже.
NSView внутренняя метрическая константа
Используемый, чтобы указать, что представление не имеет никакой внутренней метрики для данного числового свойства.

Объявление

Swift

let NSViewNoInstrinsicMetric: CGFloat

Objective C

const CGFloat NSViewNoInstrinsicMetric ; // -1

Константы
- NSViewNoInstrinsicMetric
  
  NSViewNoInstrinsicMetric
  
  Используемый, чтобы указать, что представление не имеет никакой внутренней метрики для данного числового свойства.
  
  Доступный в OS X v10.7 и позже.

Уведомления

NSViewBoundsDidChangeNotification NSViewBoundsDidChangeNotification
Отправленный каждый раз, когда NSViewпрямоугольник границ изменяется на новое значение независимо от прямоугольника кадра, но только когда представление postsBoundsChangedNotifications свойство YEStrue.
Объект уведомления NSView возразите, чей прямоугольник границ изменился. Это уведомление не содержит a userInfo словарь.
Следующие методы могут привести к регистрации уведомления:
- Границы @property
- setBoundsOrigin:
- @property boundsRotation
- setBoundsSize:
- translateOriginToPoint:
- scaleUnitSquareToSize:
- rotateByAngle:
Обратите внимание на то, что прямоугольник границ изменяет размеры автоматически для отслеживания прямоугольника кадра. Однако изменения в прямоугольнике кадра не приводят к этому измененному на границы уведомлению.
Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.0 и позже.
NSViewFocusDidChangeNotification NSViewFocusDidChangeNotification

Осуждаемый в OS X v10.4 и позже. Отправленный для NSView возразите и каждый из его потомков (рекурсивно) каждый раз, когда изменились кадр или геометрия границ представления.
Вместо этого используйте NSViewBoundsDidChangeNotification и NSViewFrameDidChangeNotification получить ту же информацию, предоставленную этим уведомлением.
Объект уведомления является представлением, геометрия которого изменилась. Это уведомление не содержит a userInfo словарь.

Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Осуждаемый в OS X v10.4 и позже.
NSViewFrameDidChangeNotification NSViewFrameDidChangeNotification
Отправленный каждый раз, когда прямоугольник кадра представления изменяется на новое значение, но только когда представление postsFrameChangedNotifications свойство YEStrue.
Объект уведомления NSView возразите, чей прямоугольник кадра изменился. Это уведомление не содержит a userInfo словарь.
Следующие методы могут привести к регистрации уведомления:
- Кадр @property
- setFrameOrigin:
- @property frameRotation
- setFrameSize:
Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.0 и позже.
NSViewDidUpdateTrackingAreasNotification NSViewDidUpdateTrackingAreasNotification

Отправленный каждый раз, когда NSView объект повторно вычисляет свои области отслеживания. Это отправляется после того, как представление получает updateTrackingAreas.

Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.5 и позже.
NSViewGlobalFrameDidChangeNotification NSViewGlobalFrameDidChangeNotification

Отправленный каждый раз, когда NSView объект, присоединивший поверхности (т.е. NSOpenGLContext объекты), перемещается в различный экран или другие случаи где NSOpenGLContext возразите должен быть обновлен. Объект уведомления является представлением поверхности. Это уведомление не содержит a userInfo словарь.

Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.1 и позже.