NSWindow
NSWindow
класс определяет объекты (известный как окна), которые управляют и координируют окна отображения приложения на экране. Сингл NSWindow
объект соответствует самое большее одному экранному окну. Две основных функции окна должны обеспечить область, в которой представления могут быть помещены и принять и распределить к надлежащим представлениям, события, которые пользователь провоцирует посредством действий с мышью и клавиатурой.
Соответствует
-
AnyObject
-
CVarArgType
-
Сопоставимый
-
Hashable
-
NSAccessibility
-
NSAccessibilityElementProtocol
-
NSAnimatablePropertyContainer
-
NSAppearanceCustomization
-
NSCoding
-
NSObjectProtocol
-
NSUserInterfaceItemIdentification
-
NSUserInterfaceValidations
-
Печатаемый
-
NSAccessibility
-
NSAccessibilityElement
-
NSAnimatablePropertyContainer
-
NSAppearanceCustomization
-
NSCoding
-
NSObject
-
NSUserInterfaceItemIdentification
-
NSUserInterfaceValidations
Оператор импорта
Swift
import AppKit
Objective C
@import AppKit;
Доступность
Доступный в OS X v10.0 и позже.
-
Инициализирует окно с указанными значениями.
Объявление
Swift
init(contentRect
contentRect
: NSRect, styleMaskwindowStyle
: Int, backingbufferingType
: NSBackingStoreType, deferdeferCreation
: Bool)Objective C
- (instancetype)initWithContentRect:(NSRect)
contentRect
styleMask:(NSUInteger)windowStyle
backing:(NSBackingStoreType)bufferingType
defer:(BOOL)deferCreation
Параметры
contentRect
Источник и размер предметной области окна в координатах экрана. Обратите внимание на то, что сервер окна ограничивает координаты положения окна ±16 000 и размеры к 10 000.
windowStyle
Стиль окна. Это может быть
NSBorderlessWindowMask
, или это может содержать любую из опций, описанных в Масках Стиля окна, объединенное использование оператора битового «ИЛИ» C. Безграничные окна не выводят на экран ни один из обычных периферийных элементов и обычно полезны только для дисплея или кэширующихся целей; Вы не должны обычно должны быть создавать их. Кроме того, обратите внимание на то, что маска стиля окна должна включатьNSTitledWindowMask
если это включает каких-либо из других.bufferingType
Указывает, как получение, сделанное в окне, буферизуется устройством окна, и возможные значения описаны в NSBackingStoreType — Буферизированное Получение Окна.
deferCreation
Указывает, создает ли сервер окна устройство окна для окна сразу. Когда
YES
true
, сервер окна задерживает создание устройства окна, пока окно не перемещено на экране. Все сообщения дисплея, отправленные в окно или его представления, отложены, пока окно не создается, непосредственно перед тем, как это переместилось на экране.Возвращаемое значение
Инициализированное окно.
Обсуждение
Этот метод является определяемым инициализатором для
NSWindow
класс.Задержка создания окна улучшает время запуска и минимизирует нагрузку виртуальной памяти на сервер окна.
Новое окно создает представление, чтобы быть его представлением содержания по умолчанию. Можно заменить его собственным объектом при помощи
setContentView:
метод.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
init (contentRect:styleMask:backing:defer:screen:) - initWithContentRect:styleMask:backing:defer:screen:
Инициализирует выделенное окно с указанными значениями.
Объявление
Swift
convenience init(contentRect
contentRect
: NSRect, styleMaskwindowStyle
: Int, backingbufferingType
: NSBackingStoreType, deferdeferCreation
: Bool, screenscreen
: NSScreen?)Objective C
- (instancetype)initWithContentRect:(NSRect)
contentRect
styleMask:(NSUInteger)windowStyle
backing:(NSBackingStoreType)bufferingType
defer:(BOOL)deferCreation
screen:(NSScreen *)screen
Параметры
contentRect
Источник и размер предметной области окна в координатах экрана. Источник относительно источника предоставленного экрана. Обратите внимание на то, что сервер окна ограничивает координаты положения окна ±16 000 и размеры к 10 000.
windowStyle
Стиль окна. Это может быть
NSBorderlessWindowMask
, или это может содержать любую из опций, описанных в Масках Стиля окна, объединенное использование оператора битового «ИЛИ» C. Безграничные окна не выводят на экран ни один из обычных периферийных элементов и обычно полезны только для дисплея или кэширующихся целей; Вы не должны обычно должны быть создавать их. Кроме того, обратите внимание на то, что маска стиля окна должна включатьNSTitledWindowMask
если это включает каких-либо из других.bufferingType
Указывает, как получение, сделанное в окне, буферизуется устройством окна; возможные значения описаны в NSBackingStoreType — Буферизированное Получение Окна.
deferCreation
Указывает, создает ли сервер окна устройство окна для окна сразу. Когда
YES
true
, сервер окна задерживает создание устройства окна, пока окно не перемещено на экране. Все сообщения дисплея, отправленные в окно или его представления, отложены, пока окно не создается, непосредственно перед тем, как это переместилось на экране.screen
Указывает экран, на который расположено окно. Прямоугольник содержания расположен относительно нижнего левого угла
screen
. Когдаnil
, прямоугольник содержания расположен относительно (0, 0), который является источником основного экрана.Возвращаемое значение
Инициализированное окно.
Обсуждение
Основной экран является тем, содержащим текущее ключевое окно или, если нет никакого ключевого окна, то, содержащее главное меню. Если нет ни ключевого окна, ни главного меню (если нет никакого активного приложения), основной экран является тем, где расположен источник системы координаты экрана.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Возвращает маску стиля окна, указывая, какие виды элементов управления она выводит на экран.
Возвращаемое значение
Маска стиля окна.
Обсуждение
Посмотрите информацию о маске стиля в Масках Стиля окна.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Устанавливает маску стиля окна в данное значение.
Объявление
Objective C
- (void)setStyleMask:(NSUInteger)
styleMask
Параметры
styleMask
Модернизированное значение маски. Посмотрите Маски Стиля окна для возможных значений.
Обсуждение
Значения маски допустимого стиля являются теми же значениями, приемлемыми для использования в
initWithContentRect:styleMask:backing:defer:
. Некоторые изменения маски стиля заставляют иерархию представления быть восстановленной.Оператор импорта
Objective C
@import AppKit;
Доступность
Доступный в OS X v10.6 и позже.
См. также
-
Взятый окно в или из полноэкранного режима,
Объявление
Swift
func toggleFullScreen(_
sender
: AnyObject?)Objective C
- (void)toggleFullScreen:(id)
sender
Параметры
sender
Объект, отправивший сообщение.
Обсуждение
Если полноэкранная поддержка приложений, это должно добавить пункт меню к меню View с
toggleFullScreen:
как действие, иnil
как цель.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.7 и позже.
-
Указывает, в состоянии ли окно получить события клавиатуры и события от нажатия мыши, даже когда некоторое другое окно выполняется модально.
Объявление
Swift
var worksWhenModal: Bool { get }
Objective C
@property(readonly) BOOL worksWhenModal
Возвращаемое значение
YES
true
если окно в состоянии получить события клавиатуры и события от нажатия мыши, даже когда некоторое другое окно выполняется модально; иначе,NO
false
.Обсуждение
NSWindow
реализация этого метода возвратыNO
false
. Только подклассыNSPanel
должен переопределить это значение по умолчанию.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
setWorksWhenModal:
(NSPanel
) -
Возвращает альфа-значение окна.
Объявление
Swift
var alphaValue: CGFloat
Objective C
@property CGFloat alphaValue
Возвращаемое значение
Альфа-значение окна.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Применяет данное альфа-значение ко всему окну.
Объявление
Swift
var alphaValue: CGFloat
Objective C
@property CGFloat alphaValue
Параметры
windowAlpha
Альфа-значение для применения.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Возвращает цвет фона окна.
Объявление
Swift
@NSCopying var backgroundColor: NSColor!
Objective C
@property(copy) NSColor *backgroundColor
Возвращаемое значение
Цвет фона окна.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Выбирает цвет фона окна к данному цвету.
Объявление
Swift
@NSCopying var backgroundColor: NSColor!
Objective C
@property(copy) NSColor *backgroundColor
Параметры
color
Цвет для установки как цвет фона окна.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Возвращает цветовое пространство окна.
Объявление
Swift
var colorSpace: NSColorSpace?
Objective C
@property(strong) NSColorSpace *colorSpace
Возвращаемое значение
Цветовое пространство. Возвратится
nil
Если окно не имеет запоминающего устройства и является внеэкранным.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.6 и позже.
См. также
-
Устанавливает цветовое пространство окна.
Объявление
Swift
var colorSpace: NSColorSpace?
Objective C
@property(strong) NSColorSpace *colorSpace
Параметры
colorSpace
Цветовое пространство для установки.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.6 и позже.
См. также
-
Возвращает представление содержания окна, самое высокое доступное
NSView
объект в иерархии представления окна.Объявление
Swift
var contentView: AnyObject?
Objective C
@property(strong) id contentView
Возвращаемое значение
Довольное представление.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Делает высказанное мнение представлением содержания окна.
Объявление
Swift
var contentView: AnyObject?
Objective C
@property(strong) id contentView
Параметры
view
Представление, которое должно стать представлением содержания окна.
Обсуждение
Окно сохраняет новое довольное представление и владеет им после того.
view
объект изменен для адаптации точно в предметной области окна. Вы можете изменить систему координат представления содержания через ее прямоугольник границ, но не можете изменить ее прямоугольник кадра (т.е. его размер или расположение) непосредственно.Этот метод заставляет старое довольное представление быть выпущенным; если Вы планируете снова использовать его, несомненно, сохранят его прежде, чем отправить это сообщение и выпустить его как надлежащий при добавлении его к другому
NSWindow
объект илиNSView
.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Указывает, может ли окно быть скрыто, когда его приложение становится скрытым (во время выполнения
NSApplication
hide:
метод).Объявление
Swift
var canHide: Bool
Objective C
@property BOOL canHide
Возвращаемое значение
YES
true
когда его приложение становится скрытым, если может быть скрыто окно; иначе,NO
false
.Обсуждение
Значение по умолчанию
YES
true
.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Указывает, может ли окно быть скрыто, когда его приложение становится скрытым (во время выполнения
NSApplication
hide:
метод).Объявление
Swift
var canHide: Bool
Objective C
@property BOOL canHide
Параметры
canHide
Если
YES
true
, когда его приложение становится скрытым, окно может быть скрыто; еслиNO
false
, это не может.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
canBeVisibleOnAllSpaces - canBeVisibleOnAllSpaces
(OS X v10.5)Указывает, может ли окно быть видимо на всех пробелах или только на одном пространстве за один раз.
Оператор осуждения
Использовать
setCollectionBehavior:
вместо этого.Объявление
Objective C
- (BOOL)canBeVisibleOnAllSpaces
Возвращаемое значение
YES
true
когда окно может быть видимо на всех пробелах;NO
false
когда это может быть видимо только на одном пространстве за один раз.Обсуждение
Значение по умолчанию
NO
false
.Оператор импорта
Objective C
@import AppKit;
Доступность
Доступный в OS X v10.5 и позже.
Осуждаемый в OS X v10.5.
-
setCanBeVisibleOnAllSpaces: - setCanBeVisibleOnAllSpaces:
(OS X v10.5)Указывает, может ли окно быть видимо на всех пробелах или только на одном пространстве за один раз.
Оператор осуждения
Использовать
collectionBehavior
вместо этого.Объявление
Objective C
- (void)setCanBeVisibleOnAllSpaces:(BOOL)
flag
Параметры
flag
YES
true
указывает, что окно может быть видимо на всех пробелах;NO
false
указывает, что окно может быть видимо только на одном пространстве за один раз.Оператор импорта
Objective C
@import AppKit;
Доступность
Доступный в OS X v10.5 и позже.
Осуждаемый в OS X v10.5.
-
isOnActiveSpace - isOnActiveSpace
Доступный в OS X v10.6 через OS X v10.9Указывает, является ли окно на в настоящее время активном пространстве.
Объявление
Objective C
- (BOOL)isOnActiveSpace
Возвращаемое значение
YES
true
если окно находится на в настоящее время активном пространстве; иначе,NO
false
.Обсуждение
Для видимых окон этот метод указывает, в настоящее время видимо ли окно на активном пространстве. Для невидимых окон это указывает, заставило ли бы упорядочивание окна на экране его быть на активном пространстве.
Оператор импорта
Objective C
@import AppKit;
Доступность
Доступный в OS X v10.6 через OS X v10.9.
-
Указывает, удалено ли окно из экрана, когда его приложение становится неактивным.
Объявление
Swift
var hidesOnDeactivate: Bool
Objective C
@property BOOL hidesOnDeactivate
Возвращаемое значение
YES
true
когда его приложение деактивировано, если окно удалено из экрана;NO
false
если это остается экранным.Обсуждение
Значение по умолчанию для
NSWindow
NO
false
; значение по умолчанию дляNSPanel
YES
true
.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Указывает, удалено ли окно из экрана, когда приложение неактивно.
Объявление
Swift
var hidesOnDeactivate: Bool
Objective C
@property BOOL hidesOnDeactivate
Параметры
hideOnDeactivate
YES
true
указывает, что окно должно быть скрыто (вынутый из экранного списка), когда приложение прекращает быть активным приложениемNO
false
указывает, что окно должно остаться экранным, когда приложение становится неактивным.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Идентифицирует поведение окна в наборах окна.
Объявление
Swift
var collectionBehavior: NSWindowCollectionBehavior
Objective C
@property NSWindowCollectionBehavior collectionBehavior
Возвращаемое значение
Идентификатор поведения набора.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.5 и позже.
См. также
-
Указывает поведение окна в наборах окна.
Объявление
Swift
var collectionBehavior: NSWindowCollectionBehavior
Objective C
@property NSWindowCollectionBehavior collectionBehavior
Параметры
collectionBehavior
Идентификатор поведения набора для установки.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.5 и позже.
См. также
-
isOpaque - isOpaque
Доступный в OS X v10.0 через OS X v10.9Указывает, непрозрачно ли окно.
Объявление
Objective C
- (BOOL)isOpaque
Возвращаемое значение
YES
true
когда окно непрозрачно; иначе,NO
false
.Обсуждение
Значение по умолчанию
YES
true
.Оператор импорта
Objective C
@import AppKit;
Доступность
Доступный в OS X v10.0 через OS X v10.9.
См. также
-
Указывает, непрозрачно ли окно.
Объявление
Swift
var opaque: Bool
Objective C
@property(getter=isOpaque) BOOL opaque
Параметры
opaque
Если
YES
true
, окно непрозрачно; еслиNO
false
, это не.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Указывает, имеет ли окно тень.
Объявление
Swift
var hasShadow: Bool
Objective C
@property BOOL hasShadow
Возвращаемое значение
YES
true
когда окно имеет тень; иначе,NO
false
.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Указывает, имеет ли окно тень.
Объявление
Swift
var hasShadow: Bool
Objective C
@property BOOL hasShadow
Параметры
hasShadow
Если
YES
true
, окно имеет тень; еслиNO
false
, это не делает.Обсуждение
Если установка тени изменяется, тень окна лишена законной силы, вынудив тень окна быть повторно вычисленной.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Лишает законной силы тень окна так, чтобы она была повторно вычислена на основе текущей формы окна.
Объявление
Swift
func invalidateShadow()
Objective C
- (void)invalidateShadow
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.2 и позже.
См. также
-
Указывает, вычисляет ли окно толщину данной границы автоматически.
Объявление
Swift
func autorecalculatesContentBorderThicknessForEdge(_
edge
: NSRectEdge) -> BoolObjective C
- (BOOL)autorecalculatesContentBorderThicknessForEdge:(NSRectEdge)
edge
Параметры
edge
Граница для проверки:
NSMaxYEdge
: Верхняя граница.NSMinYEdge
: Нижняя граница.
Возвращаемое значение
YES
true
когда окно автоповторно вычисляет толщину данной границы; иначе,NO
false
.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.5 и позже.
-
setAutorecalculatesContentBorderThickness (_: forEdge:) - setAutorecalculatesContentBorderThickness:forEdge:
Указывает, вычисляет ли окно толщину данной границы автоматически.
Объявление
Swift
func setAutorecalculatesContentBorderThickness(_
autorecalculateContentBorderThickness
: Bool, forEdgeedge
: NSRectEdge)Objective C
- (void)setAutorecalculatesContentBorderThickness:(BOOL)
autorecalculateContentBorderThickness
forEdge:(NSRectEdge)edge
Параметры
autorecalculateContentBorderThickness
Если
YES
true
, окно вычисляет толщину края автоматически; еслиNO
false
, это не делает.edge
Граница для установки автоперерасчета на или прочь:
NSMaxYEdge
: Верхняя граница.NSMinYEdge
: Нижняя граница.
Специальные замечания
Выключение состояния автоперерасчета границы устанавливает свою толщину границ в
0.0
.В нетекстурированном вызове окна
setAutorecalculatesContentBorderThickness:forEdge:
передачаNSMaxYEdge
повысит исключение (в нетекстурированном окне, это только допустимо для установки толщины границ содержания базового края). Это только допустимо для установки толщины границ содержания главного края в текстурированном окне.Как правило, если Вы вызываете
setContentBorderThickness:forEdge:
, необходимо также вызватьsetAutorecalculatesContentBorderThickness:NO forEdge:
.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.5 и позже.
-
Указывает толщину данной границы окна.
Объявление
Swift
func contentBorderThicknessForEdge(_
edge
: NSRectEdge) -> CGFloatObjective C
- (CGFloat)contentBorderThicknessForEdge:(NSRectEdge)
edge
Параметры
edge
Граница, чья толщина для получения:
NSMaxYEdge
: Верхняя граница.NSMinYEdge
: Нижняя граница.
Возвращаемое значение
Толщина данной границы, в точках.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.5 и позже.
См. также
-
Указывает толщину данной границы окна.
Объявление
Swift
func setContentBorderThickness(_
borderThickness
: CGFloat, forEdgeedge
: NSRectEdge)Objective C
- (void)setContentBorderThickness:(CGFloat)
borderThickness
forEdge:(NSRectEdge)edge
Параметры
borderThickness
Толщина для
edge
, в точках.edge
Граница, чья толщина для установки:
NSMaxYEdge
: Верхняя граница.NSMinYEdge
: Нижняя граница.
Обсуждение
В нетекстурированном вызове окна
setContentBorderThickness:forEdge:
передачаNSMaxYEdge
повысит исключение (в нетекстурированном окне, это только допустимо для установки толщины границ содержания базового края). Это только допустимо для установки толщины границ содержания главного края в текстурированном окне.Как правило, если Вы вызываете
setContentBorderThickness:forEdge:
, необходимо также вызватьsetAutorecalculatesContentBorderThickness:NO forEdge:
.contentBorder
не включает строку заголовка или панель инструментов, таким образом, текстурированное окно, просто хотящее градиент в строке заголовка и панели инструментов, должно иметь acontentBorderThickness
из0
дляNSMaxYEdge
.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.5 и позже.
-
Возвращает делегата окна.
Объявление
Swift
unowned(unsafe) var delegate: NSWindowDelegate?
Objective C
@property(assign) id<NSWindowDelegate> delegate
Возвращаемое значение
Делегат окна, или
nil
если это не имеет делегата.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Устанавливает делегата окна в данном объекте или удаляет существующего делегата.
Объявление
Swift
unowned(unsafe) var delegate: NSWindowDelegate?
Objective C
@property(assign) id<NSWindowDelegate> delegate
Параметры
delegate
Делегат к окну. Передача
nil
удалить существующего делегата.Обсуждение
NSWindow
делегат объекта введен в цепочку респондента после самого окна и сообщен о различных действиях окном через сообщения делегации.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
– делегат
– tryToPerform:with:
sendAction:to:from:
(NSApplication
) -
Указывает, предотвращает ли окно завершение приложения, когда модальный.
Объявление
Swift
var preventsApplicationTerminationWhenModal: Bool
Objective C
@property BOOL preventsApplicationTerminationWhenModal
Возвращаемое значение
YES
true
если окно предотвращает завершение приложения когда модальный; иначе,NO
false
.Обсуждение
Значение по умолчанию
YES
true
.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.6 и позже.
-
Указывает, предотвращает ли окно завершение приложения, когда модальный.
Объявление
Swift
var preventsApplicationTerminationWhenModal: Bool
Objective C
@property BOOL preventsApplicationTerminationWhenModal
Параметры
flag
Если
YES
true
, окно предотвратит завершение приложения когда модальный; еслиNO
false
, это не будет.Обсуждение
Обычно, когда модальное окно или лист открыты, не консультируясь с делегатом приложения, завершение приложения предотвращено. Некоторые окна могут хотеть не предотвратить завершение, как бы то ни было. Вызов этого метода с параметром
NO
false
даже если окно открыто, или через внезапный путь завершения, если включено, или после консалтинга с делегатом приложения, переопределяет поведение по умолчанию и позволяет завершению продолжаться.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.6 и позже.
-
Возвращает предел глубины по умолчанию для экземпляров
NSWindow
.Объявление
Swift
class func defaultDepthLimit() -> NSWindowDepth
Objective C
+ (NSWindowDepth)defaultDepthLimit
Возвращаемое значение
Глубина по умолчанию ограничивает для экземпляров
NSWindow
, определенный глубиной самого глубокого экранного уровня, доступного серверу окна.Обсуждение
Значение возвратилось, может быть исследован с функциями Набора Приложения
NSPlanarFromDepth
,NSColorSpaceFromDepth
,NSBitsPerSampleFromDepth
, иNSBitsPerPixelFromDepth
.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Обеспечивает число окна устройства окна окна.
Объявление
Swift
var windowNumber: Int { get }
Objective C
@property(readonly) NSInteger windowNumber
Возвращаемое значение
Число окна устройства окна окна.
Обсуждение
Каждому устройству окна в приложении дают, уникальное число окна — отмечают, что это не то же как глобальное число окна, присвоенное сервером окна. Это число может использоваться для идентификации устройства окна с
orderWindow:relativeTo:
метод и в функции Набора ПриложенияNSWindowList
. .Если окно не имеет устройства окна, значение возвратилось, будет равно или меньше чем 0.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Возвращает числа окна для всех видимых окон, удовлетворяющих указанные опции.
Объявление
Swift
class func windowNumbersWithOptions(_
options
: NSWindowNumberListOptions) -> [AnyObject]?Objective C
+ (NSArray *)windowNumbersWithOptions:(NSWindowNumberListOptions)
options
Параметры
options
Возможные варианты указаны в
“NSWindowNumberListOptions”
.Возвращаемое значение
Массив чисел окна для всех видимых окон, удовлетворяющих указанные опции. (Windows на активном пространстве возвращается в z-порядке; т.е. по всей длине.)
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.6 и позже.
-
Возвращает объект состояния графики окна.
Возвращаемое значение
Объект состояния графики связался с окном.
Обсуждение
Это состояние графики используется по умолчанию для всех
NSView
объекты в иерархии представления окна, но отдельные представления могут быть сделаны использовать свое собственное сNSView
методallocateGState
.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.10.
-
canStoreColor () - canStoreColor
(OS X v10.10)Указывает, имеет ли окно предел глубины, позволяющий ему хранить значения цвета.
Объявление
Swift
func canStoreColor() -> Bool
Objective C
- (BOOL)canStoreColor
Возвращаемое значение
YES
true
когда предел глубины окна позволяет ему хранить значения цвета; иначе,NO
false
.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.10.
См. также
– depthLimit
shouldDrawColor
(NSView
) -
Возвращает словарь, содержащий информацию о разрешении окна.
Объявление
Swift
var deviceDescription: [NSObject : AnyObject] { get }
Objective C
@property(readonly, copy) NSDictionary *deviceDescription
Возвращаемое значение
Словарь, содержащий информацию о разрешении об окне, таком как цвет, глубина, и т.д.
Обсуждение
Эта информация полезна для настройки изображений и цветов к возможностям дисплея окна. Содержание словаря описано в
“Display Device—Descriptions”
.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
deviceDescription
(NSScreen
)bestRepresentationForDevice:
(NSImage
)colorUsingColorSpaceName:
(NSColor
) -
Указывает, может ли окно быть выведено на экран в окне входа в систему. Значение по умолчанию:
NO
false
.Объявление
Swift
var canBecomeVisibleWithoutLogin: Bool
Objective C
@property BOOL canBecomeVisibleWithoutLogin
Возвращаемое значение
YES
true
когда окно может быть выведено на экран в окне входа в систему; иначе,NO
false
.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.5 и позже.
См. также
-
Указывает, может ли окно быть выведено на экран в окне входа в систему.
Объявление
Swift
var canBecomeVisibleWithoutLogin: Bool
Objective C
@property BOOL canBecomeVisibleWithoutLogin
Параметры
flag
YES
true
позволить окну быть выведенным на экран в окне входа в систему;NO
false
предотвратить это поведение.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.5 и позже.
См. также
-
Указывает уровень доступа, который другие процессы имеют к содержанию окна.
Объявление
Swift
var sharingType: NSWindowSharingType
Objective C
@property NSWindowSharingType sharingType
Возвращаемое значение
Уровень совместного использования содержания окна. Посмотрите NSWindowSharingType для возможных значений.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.5 и позже.
См. также
-
Указывает уровень доступа, который другие процессы имеют к содержанию окна.
Объявление
Swift
var sharingType: NSWindowSharingType
Objective C
@property NSWindowSharingType sharingType
Параметры
sharingType
Уровень совместного использования содержания окна. Посмотрите NSWindowSharingType для возможных значений.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.5 и позже.
См. также
-
Возвращает тип запоминающего устройства окна.
Объявление
Swift
var backingType: NSBackingStoreType
Objective C
@property NSBackingStoreType backingType
Возвращаемое значение
Тип запоминающего устройства.
Обсуждение
Возможные возвращаемые значения описаны в NSBackingStoreType — Буферизированное Получение Окна.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Устанавливает тип запоминающего устройства окна в данный тип.
Объявление
Swift
var backingType: NSBackingStoreType
Objective C
@property NSBackingStoreType backingType
Параметры
backingType
Тип запоминающего устройства для установки.
Обсуждение
Допустимые типы запоминающего устройства описаны в Константах.
Этот метод может использоваться только для переключения буферизированного окна на сохраненный или наоборот; Вы не можете изменить отступающий тип на или от несохраненного после инициализации
NSWindow
объект (ошибка сгенерирована, при попытке сделать так).Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Указывает расположение запоминающего устройства окна.
Объявление
Swift
var backingLocation: NSWindowBackingLocation { get }
Objective C
@property(readonly) NSWindowBackingLocation backingLocation
Возвращаемое значение
Расположение запоминающего устройства окна. Посмотрите NSWindowBackingLocation для возможных значений.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.5 и позже.
См. также
-
Указывает предпочтительное расположение для запоминающего устройства окна.
Объявление
Swift
var preferredBackingLocation: NSWindowBackingLocation
Objective C
@property NSWindowBackingLocation preferredBackingLocation
Возвращаемое значение
Предпочтительное расположение для запоминающего устройства окна. Посмотрите Константы для возможных значений.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.5 и позже.
-
Указывает предпочтительное расположение для запоминающего устройства окна.
Объявление
Swift
var preferredBackingLocation: NSWindowBackingLocation
Objective C
@property NSWindowBackingLocation preferredBackingLocation
Параметры
preferredBackingLocation
Предпочтительное расположение для запоминающего устройства окна. Посмотрите NSWindowBackingLocation для возможных значений.
Обсуждение
Используйте только при оптимизации для производительности.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.5 и позже.
См. также
-
isOneShot - isOneShot
Доступный в OS X v10.0 через OS X v10.9Указывает, освобождено ли устройство окна, которым управляет окно, когда это удалено из экранного списка.
Объявление
Objective C
- (BOOL)isOneShot
Возвращаемое значение
YES
true
когда устройство окна окна освобождено, когда оно удалено из экранного списка; иначе,NO
false
.Обсуждение
Значение по умолчанию
NO
false
.Оператор импорта
Objective C
@import AppKit;
Доступность
Доступный в OS X v10.0 через OS X v10.9.
См. также
-
Наборы, должно ли устройство окна, которым управляет окно, быть освобождено, когда это удалено из экранного списка.
Объявление
Swift
var oneShot: Bool
Objective C
@property(getter=isOneShot) BOOL oneShot
Параметры
oneShot
YES
true
освободить устройство окна окна, когда это удалено из экранного (скрытого) списка и создать другой, когда это возвращается к экрану;NO
false
снова использовать устройство окна.Обсуждение
Освобождение устройства окна, когда это удалено из экранного списка, может привести к сбережениям памяти и повышению производительности для
NSWindow
объекты, не занимающие много времени отображать. Это особенно подходяще дляNSWindow
возражает, что пользователь мог бы использовать несколько раз, но не отображать постоянно.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Возвращает предел глубины окна.
Возвращаемое значение
Предел глубины окна.
Обсуждение
Значение возвратилось, может быть исследован с функциями Набора Приложения
NSPlanarFromDepth
,NSColorSpaceFromDepth
,NSBitsPerSampleFromDepth
, иNSBitsPerPixelFromDepth
.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Устанавливает предел глубины окна к данному пределу.
Параметры
depthLimit
Предел глубины установленному.
Обсуждение
NSBestDepth
функция обеспечивает лучший предел глубины на основе ряда параметров.Передача значения
0
дляdepthLimit
устанавливает предел глубины к пределу глубины окна по умолчанию. Предел глубины 0 может быть полезен для возвращенияNSWindow
возразите против его начальной глубины.На OS X v10.6 и позже, можно передать одну из явных битовых глубин, определенных в Явные пределы глубины окна
NSWindowDepthTwentyfourBitRGB
значение по умолчанию.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Указывает, может ли предел глубины окна измениться для соответствия глубины экрана, это идет.
Объявление
Swift
var hasDynamicDepthLimit: Bool { get }
Objective C
@property(readonly) BOOL hasDynamicDepthLimit
Возвращаемое значение
YES
true
когда окно имеет динамический предел глубины; иначе,NO
false
.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Наборы, изменяет ли окно свою глубину для соответствия глубины экрана, это идет, или глубина самого глубокого экрана, когда это охватывает многократные экраны.
Объявление
Swift
func setDynamicDepthLimit(_
dynamicDepthLimit
: Bool)Objective C
- (void)setDynamicDepthLimit:(BOOL)
dynamicDepthLimit
Параметры
dynamicDepthLimit
Если
YES
true
, окно имеет динамический предел глубины; еслиNO
false
, это не делает.Обсуждение
Когда
dynamicDepthLimit
NO
false
, окно использует или свой предварительно установленный предел глубины или предел глубины по умолчанию. Различный, и нединамический, предел глубины может быть установлен сsetDepthLimit:
метод.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Возвращает прямоугольник содержания, используемый окном с данным прямоугольником кадра и стилем окна.
Объявление
Swift
class func contentRectForFrameRect(_
windowFrame
: NSRect, styleMaskwindowStyle
: Int) -> NSRectObjective C
+ (NSRect)contentRectForFrameRect:(NSRect)
windowFrame
styleMask:(NSUInteger)windowStyle
Параметры
windowFrame
Прямоугольник кадра для окна выражен в координатах экрана.
windowStyle
Стиль окна для окна. Посмотрите Константы для списка значений маски стиля.
Возвращаемое значение
Прямоугольник содержания, выраженный в координатах экрана, используемых окном с
windowFrame
иwindowStyle
.Обсуждение
Когда a
NSWindow
экземпляр доступен, необходимо использоватьcontentRectForFrameRect:
вместо этого метода.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Возвращает прямоугольник кадра, используемый окном с данным прямоугольником содержания и стилем окна.
Объявление
Swift
class func frameRectForContentRect(_
windowContentRect
: NSRect, styleMaskwindowStyle
: Int) -> NSRectObjective C
+ (NSRect)frameRectForContentRect:(NSRect)
windowContentRect
styleMask:(NSUInteger)windowStyle
Параметры
windowContentRect
Прямоугольник содержания для окна выражен в координатах экрана.
windowStyle
Стиль окна для окна. Посмотрите Маски Стиля окна для списка значений маски стиля.
Возвращаемое значение
Прямоугольник кадра, выраженный в координатах экрана, используемых окном с
windowContentRect
иwindowStyle
.Обсуждение
Когда a
NSWindow
экземпляр доступен, необходимо использоватьframeRectForContentRect:
вместо этого метода.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Возвращает минимальную ширину, которую прямоугольник кадра окна должен иметь для него для отображения заголовка с данным стилем окна.
Объявление
Swift
class func minFrameWidthWithTitle(_
windowTitle
: String, styleMaskwindowStyle
: Int) -> CGFloatObjective C
+ (CGFloat)minFrameWidthWithTitle:(NSString *)
windowTitle
styleMask:(NSUInteger)windowStyle
Параметры
windowTitle
Заголовок для окна.
windowStyle
Стиль окна для окна. Посмотрите Маски Стиля окна для списка значений маски стиля.
Возвращаемое значение
Минимальная ширина кадра окна, с помощью
windowStyle
, для отображенияwindowTitle
.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Возвращает прямоугольник содержания окна с данным прямоугольником кадра.
Объявление
Параметры
windowFrame
Прямоугольник кадра для окна выражен в координатах экрана.
Возвращаемое значение
Прямоугольник содержания окна, выраженный в координатах экрана, с
windowFrame
.Обсуждение
Окно использует свою маску текущего стиля в вычислениях прямоугольника содержания. Посмотрите Маски Стиля окна для списка значений маски стиля. Основное преимущество этого дубликата метода экземпляра к
contentRectForFrameRect:styleMask:
это, это позволяет Вам принимать панели инструментов во внимание при преобразовании между прямоугольниками кадра и содержанием. (Панель инструментов не включена в прямоугольник содержания.)Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.3 и позже.
-
Возвращает прямоугольник кадра окна с данным прямоугольником содержания.
Объявление
Параметры
windowContent
Прямоугольник содержания для окна выражен в координатах экрана.
Возвращаемое значение
Прямоугольник кадра окна, выраженный в координатах экрана, с
windowContent
.Обсуждение
Окно использует свою маску текущего стиля в вычислениях прямоугольника кадра. Посмотрите Маски Стиля окна для списка значений маски стиля. Главное преимущество этого дубликата метода экземпляра к
frameRectForContentRect:styleMask:
это, это позволяет Вам принимать панели инструментов во внимание при преобразовании между прямоугольниками кадра и содержанием. (Панель инструментов включена в прямоугольник кадра, но не прямоугольник содержания.)Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.3 и позже.
-
Возвращает набор секций, связанных с окном.
Объявление
Swift
var drawers: [AnyObject]? { get }
Objective C
@property(readonly, copy) NSArray *drawers
Возвращаемое значение
Набор секций связался с окном.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Возвращает контроллер окна окна.
Объявление
Swift
func windowController() -> AnyObject?
Objective C
- (id)windowController
Возвращаемое значение
Контроллер окна окна.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Устанавливает контроллер окна окна.
Объявление
Swift
func setWindowController(_
windowController
: NSWindowController?)Objective C
- (void)setWindowController:(NSWindowController *)
windowController
Параметры
windowController
Контроллер окна для установки.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Возвращает лист, присоединенный к окну.
Объявление
Swift
var attachedSheet: NSWindow? { get }
Objective C
@property(readonly, strong) NSWindow *attachedSheet
Возвращаемое значение
Лист, присоединенный к окну; ноль, когда окну не присоединяли лист.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.1 и позже.
-
Указывает, работало ли окно когда-либо как модальный лист.
Объявление
Objective C
- (BOOL)isSheet
Возвращаемое значение
YES
true
если окно когда-либо работало как модальный лист; иначе,NO
false
.Оператор импорта
Objective C
@import AppKit;
Доступность
Доступный в OS X v10.1 через OS X v10.9.
-
Запускает модальный документом сеанс и подарки — или очереди для представления — лист.
Объявление
Swift
func beginSheet(_
sheetWindow
: NSWindow, completionHandlerhandler
: ((NSModalResponse) -> Void)?)Objective C
- (void)beginSheet:(NSWindow *)
sheetWindow
completionHandler:(void (^)(NSModalResponse returnCode))handler
Параметры
sheetWindow
Объект окна, представляющий лист для представления.
handler
Обработчик завершения, который вызывают, когда заканчивается модальный сеанс листа.
Обсуждение
Если окно уже имеет представленный лист, этот метод ставит указанный лист в очередь для представления после того, как текущий лист отклонен и затем возвращает управление вызывающей стороне.
Если окно не имеет никаких представленных листов, этот метод выводит на экран указанный лист, делает его ключевым, и возвращает управление вызывающей стороне. В то время как лист остается видимым, большинство событий, предназначенных для получателя, запрещается. runloop не переходит ни к какому специальному режиму для выполнения этого.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.9 и позже.
-
Запускает модальный документом сеанс и представляет указанный критический лист.
Объявление
Swift
func beginCriticalSheet(_
sheetWindow
: NSWindow, completionHandlerhandler
: ((NSModalResponse) -> Void)?)Objective C
- (void)beginCriticalSheet:(NSWindow *)
sheetWindow
completionHandler:(void (^)(NSModalResponse returnCode))handler
Параметры
sheetWindow
Объект окна, представляющий критический лист для представления. Критический лист содержит содержание, которое строго ограничено во времени или очень важно для пользователя.
handler
Обработчик завершения, который вызывают, когда заканчивается модальный сеанс листа.
Обсуждение
Этот метод выводит на экран лист — поверх текущего листа окна, если Вы существуете — делает его ключом и возвращает управление вызывающей стороне. В то время как лист остается видимым, большинство событий, предназначенных для получателя, запрещается. runloop не переходит ни к какому специальному режиму для выполнения этого.
Если окно уже имеет лист, когда этот метод работает, существующий лист временно недоступен, в то время как представлен критический лист. Когда критический лист отклонен, ранее представленный лист продолжает свою стандартную работу.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.9 и позже.
См. также
-
Заканчивает модальный документом сеанс и отклоняет указанный лист.
Объявление
Swift
func endSheet(_
sheetWindow
: NSWindow)Objective C
- (void)endSheet:(NSWindow *)
sheetWindow
Параметры
sheetWindow
Объект окна, представляющий лист, который будет отклонен.
Обсуждение
Этот метод заканчивает модальный сеанс кодом возврата
NSModalResponseStop
.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.9 и позже.
-
Заканчивает модальный документом сеанс и отклоняет указанный лист.
Объявление
Swift
func endSheet(_
sheetWindow
: NSWindow, returnCodereturnCode
: NSModalResponse)Objective C
- (void)endSheet:(NSWindow *)
sheetWindow
returnCode:(NSModalResponse)returnCode
Параметры
sheetWindow
Объект окна, представляющий лист для отклонения.
returnCode
Код возврата для отправки к обработчику завершения. Можно использовать пользовательское значение, которое Вы определяете или один из кодов возврата, определенных в
NSModalResponse
перечисление или Дополнительные Значения NSModalResponse.Обсуждение
Этот метод заканчивает модальный сеанс указанным кодом возврата.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.9 и позже.
См. также
-
Возвращает окно, к которому присоединяется лист.
Объявление
Swift
var sheetParent: NSWindow? { get }
Objective C
@property(readonly, strong) NSWindow *sheetParent
Возвращаемое значение
Объект окна, к которому лист присоединяется или
nil
если получатель не является листом или не имеет никакого родителя листа.Обсуждение
Этот метод возвращает объект окна, к которому лист логически присоединяется, независимо от появления. Родительское отношение листа окна начинается с начала листа (например, через
beginSheet:completionHandler:
) и концы с увольнением листа (например, черезendSheet:
).Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.9 и позже.
-
Возвращает массив листов, в настоящее время присоединяемых к окну.
Объявление
Swift
var sheets: [AnyObject] { get }
Objective C
@property(readonly, copy) NSArray *sheets
Возвращаемое значение
Упорядоченный массив, содержащий — в порядке от начала до конца — представленные листы, которые присоединены к окну, сопровождаемому листами с очередями, в порядке, они были поставлены в очередь. Массив не включает вложенные листы или подлисты.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.9 и позже.
-
Возвращает прямоугольник кадра окна.
Возвращаемое значение
Прямоугольник кадра окна в координатах экрана, включая строку заголовка.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Располагает нижний левый угол прямоугольника кадра окна в данной точке в координатах экрана.
Объявление
Swift
func setFrameOrigin(_
point
: NSPoint)Objective C
- (void)setFrameOrigin:(NSPoint)
point
Параметры
point
Новая позиция нижнего левого угла окна в координатах экрана.
Обсуждение
Обратите внимание на то, что сервер окна ограничивает координаты положения окна ±16 000.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Располагает верхний левый угол прямоугольника кадра окна в данной точке в координатах экрана.
Объявление
Swift
func setFrameTopLeftPoint(_
point
: NSPoint)Objective C
- (void)setFrameTopLeftPoint:(NSPoint)
point
Параметры
point
Новая позиция верхнего левого угла окна в координатах экрана.
Обсуждение
Обратите внимание на то, что сервер окна ограничивает координаты положения окна ±16 000; при необходимости, корректироваться
aPoint
относительно нижнего левого угла окна для учета этого предела.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Изменяет и возвращает прямоугольник кадра так, чтобы его главный край нашелся на определенном экране.
Объявление
Параметры
frameRect
Предложенный прямоугольник кадра для корректировки.
screen
Экран, на котором должен лечь главный край кадра окна.
Возвращаемое значение
Скорректированный прямоугольник кадра.
Обсуждение
Если окно изменяемого размера, и высота окна больше, чем экранная высота, высота прямоугольника регулируется для адаптации в экране также. Ширина прямоугольника и горизонтальное расположение незатронуты. Вы не должны должны быть вызывать этот метод сами; это вызывается автоматически (и измененный кадр используется, чтобы определить местоположение и установить размер окна) каждый раз, когда названное
NSWindow
объект помещается на экране и каждый раз, когда изменяется его размер.Подклассы могут переопределить этот метод, чтобы препятствовать тому, чтобы их экземпляры были ограничены или ограничили их по-другому.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Располагает окно, верхнее левое в данную точку.
Объявление
Параметры
topLeft
Новая верхняя левая точка, в координатах экрана, для окна. Когда
NSZeroPoint
, окно не перемещено, за исключением необходимого для ограничения на видимый экранВозвращаемое значение
Точка сместилась из верхнего левого из окна в координатах экрана.
Обсуждение
Возвращенная точка может быть передана последующему вызову
cascadeTopLeftFromPoint:
для расположения следующего окна так, строки заголовка обоих окон полностью видимы.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Устанавливает источник и размер прямоугольника кадра окна согласно данному прямоугольнику кадра, таким образом устанавливая его позицию и размер на экране.
Объявление
Swift
func setFrame(_
windowFrame
: NSRect, displaydisplayViews
: Bool)Objective C
- (void)setFrame:(NSRect)
windowFrame
display:(BOOL)displayViews
Параметры
windowFrame
Прямоугольник кадра для окна, включая строку заголовка.
displayViews
Указывает, перерисовывает ли окно представления, которые должны быть выведены на экран. Когда
YES
true
окно отправляет adisplayIfNeeded
передайте вниз его иерархию представления, таким образом перерисовав все представления.Обсуждение
Обратите внимание на то, что сервер окна ограничивает координаты положения окна ±16 000 и размеры к 10 000.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Устанавливает источник и размер прямоугольника кадра окна, с дополнительной анимацией, согласно данному прямоугольнику кадра, таким образом устанавливая его позицию и размер на экране.
Объявление
Swift
func setFrame(_
windowFrame
: NSRect, displaydisplayViews
: Bool, animateperformAnimation
: Bool)Objective C
- (void)setFrame:(NSRect)
windowFrame
display:(BOOL)displayViews
animate:(BOOL)performAnimation
Параметры
windowFrame
Прямоугольник кадра для окна, включая строку заголовка.
displayViews
Указывает, перерисовывает ли окно представления, которые должны быть выведены на экран. Когда
YES
true
окно отправляет adisplayIfNeeded
передайте вниз его иерархию представления, таким образом перерисовав все представления.performAnimation
Указывает, выполняет ли окно гладкое, изменяют размеры.
YES
true
выполнять анимацию, продолжительность которой указанаanimationResizeTime:
.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Указывает продолжительность гладкого изменения типа телосложения.
Объявление
Swift
func animationResizeTime(_
newWindowFrame
: NSRect) -> NSTimeIntervalObjective C
- (NSTimeInterval)animationResizeTime:(NSRect)
newWindowFrame
Параметры
newWindowFrame
Прямоугольник кадра, указанный в
setFrame:display:animate:
.Возвращаемое значение
Продолжительность изменения типа телосложения.
Обсуждение
Подклассы могут переопределить этот метод для управления общим временем для изменения кадра.
NSWindow
реализация использует значение отNSWindowResizeTime
пользовательское значение по умолчанию как время в секундах для изменения размеров на 150 пикселей. Если это значение является неуказанным,NSWindowResizeTime
0,20 секунды (это значение по умолчанию может отличаться в различных выпусках OS X).Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Возвращает форматное соотношение окна, ограничивающее размер его прямоугольника кадра к интегральной сети магазинов этого отношения, когда пользователь изменяет размеры его.
Возвращаемое значение
Форматное соотношение окна.
Обсуждение
Размер прямоугольника кадра окна ограничивается к интегральной сети магазинов этого отношения, когда пользователь изменяет размеры его. Можно установить
NSWindow
размер объекта к любому отношению программно.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Устанавливает форматное соотношение окна, ограничивающее размер его прямоугольника кадра к интегральной сети магазинов этого отношения, когда пользователь изменяет размеры его.
Параметры
aspectRatio
Форматное соотношение, которое будет сохраняться во время изменения размеров действий.
Обсуждение
NSWindow
форматное соотношение объекта и изменять размеры инкрементов являются взаимоисключающими атрибутами. Фактически, установка одного атрибута отменяет установку другого. Например, для отмены установленной установки форматного соотношения дляNSWindow
объект, Вы отправляете ему asetResizeIncrements:
сообщение с набором ширины и высоты к1.0
:[myWindow setResizeIncrements:NSMakeSize(1.0,1.0)];
setContentAspectRatio:
метод имеет приоритет по этому методу.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Возвращает минимальный размер, к которому может быть измерен кадр окна (включая его строку заголовка).
Возвращаемое значение
Минимальный размер, к которому кадр окна (включая его строку заголовка) может быть измерен или пользователем или
setFrame...
методы кромеsetFrame:display:
иsetFrame:display:animate:
.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Устанавливает минимальный размер, к которому кадр окна (включая его строку заголовка) может быть измерен к
aSize
.Параметры
minFrameSize
Минимальный размер кадра окна.
Обсуждение
Минимальное ограничение размера осуществляется для изменения размеров пользователем, а также для
setFrame...
методы кромеsetFrame:display:
иsetFrame:display:animate:
.setContentMinSize:
метод имеет приоритет по этому методу.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Возвращает максимальный размер, к которому может быть измерен кадр окна (включая его строку заголовка).
Возвращаемое значение
Максимальный размер, к которому кадр окна (включая его строку заголовка) может быть измерен или пользователем или
setFrame...
методы кромеsetFrame:display:
иsetFrame:display:animate:
.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Устанавливает максимальный размер, к которому может быть измерен кадр окна (включая его строку заголовка).
Параметры
maxFrameSize
Максимальный размер кадра окна.
Обсуждение
Максимальное ограничение размера осуществляется для изменения размеров пользователем, а также для
setFrame...
методы кромеsetFrame:display:
иsetFrame:display:animate:
. Обратите внимание на то, что сервер окна ограничивает размеры окна 10 000.Максимальный размер по умолчанию окна
{FLT_MAX, FLT_MAX}
(FLT_MAX
определяется в/usr/include/float.h
). Как только максимальный размер окна был установлен, нет никакого способа сбросить его кроме указания этого максимального размера по умолчанию.setContentMaxSize: метод имеет приоритет по этому методу.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
isZoomed - isZoomed
Доступный в OS X v10.0 через OS X v10.9Возвращает булево значение, указывающее, является ли окно в масштабируемом состоянии.
Объявление
Objective C
- (BOOL)isZoomed
Возвращаемое значение
YES
true
если окно находится в масштабируемом состоянии; иначе,NO
false
.Обсуждение
Масштабируемое состояние окна определяется с помощью следующих шагов:
Если делегат или реализации класса окна
windowWillUseStandardFrame:defaultFrame:
, это вызывается для получения масштабируемого кадра окна. РезультатisZoomed
тогда определяется тем, равна ли текущая рамка окна масштабируемому кадру.Если ни делегат, ни реализации класса окна
windowWillUseStandardFrame:defaultFrame:
, выбран кадр по умолчанию, почти соответствующий экрану. Если делегат или реализации класса окна, это вызывается для проверки предложенного масштабируемого кадра. Как только масштабируемый кадр проверен, результатisZoomed
определяется тем, равна ли текущая рамка окна масштабируемому кадру.
Оператор импорта
Objective C
@import AppKit;
Доступность
Доступный в OS X v10.0 через OS X v10.9.
См. также
-
Этот метод действия моделирует пользователя, щелкающего по полю изменения масштаба путем мгновенного выделения кнопки и затем изменения масштаба окна.
Объявление
Swift
func performZoom(_
sender
: AnyObject?)Objective C
- (void)performZoom:(id)
sender
Параметры
sender
Объект, отправляющий сообщение.
Обсуждение
Если окно не имеет поля изменения масштаба или не может масштабироваться по некоторым причинам, компьютерные звуковые сигналы.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Этот метод действия переключает размер и расположение окна между его стандартным состоянием (предоставленный приложением как «лучший» размер для отображения данных окна) и его пользовательское состояние (новый размер и расположение, которое пользователь, возможно, установил путем перемещения или изменения размеров окна).
Объявление
Swift
func zoom(_
sender
: AnyObject?)Objective C
- (void)zoom:(id)
sender
Параметры
sender
Объект, отправляющий сообщение.
Обсуждение
Для получения дополнительной информации о стандарте и пользовательских состояниях, посмотрите
windowWillUseStandardFrame:defaultFrame:
.zoom:
метод обычно вызывается после того, как пользователь щелкает по полю изменения масштаба окна, но может также быть вызван программно отperformZoom:
метод. Это выполняет следующие шаги:Вызывает
windowWillUseStandardFrame:defaultFrame:
метод, если делегат или класс окна реализуют его, для получения «наиболее подходящего» кадра для окна. Если ни делегат, ни класс окна не реализуют метод, использует кадр по умолчанию, почти заполняющий текущий экран, определяющийся, чтобы быть экраном, содержащим самую большую часть текущего кадра окна.Корректирует получающийся кадр, при необходимости, для адаптации на текущем экране.
Сравнивает получающийся кадр с текущим кадром, чтобы определить, выводится ли стандартный кадр окна в настоящее время на экран. Если текущий кадр в нескольких пикселях стандартного кадра в размере и расположении, это считают соответствием.
Определяет новый кадр. Если окно в настоящее время находится в стандартном состоянии, новый кадр представляет пользовательское состояние, сохраненное во время предыдущего изменения масштаба. Если окно в настоящее время находится в пользовательском состоянии, новый кадр представляет стандартное состояние, вычисленное на шаге 1 выше. Если нет никакого состояния сохраненного пользователя, потому что не было никакого предыдущего изменения масштаба, размер и расположение окна не изменяются.
Определяет, позволяет ли окно в настоящее время масштабировать. По умолчанию изменение масштаба позволяется. Если делегат окна реализует
windowShouldZoom:toFrame:
метод,zoom:
вызывает тот метод. Если делегат не реализует метод, но окно делает,zoom:
вызывает версию окна.windowShouldZoom:toFrame:
возвратыNO
false
если в настоящее время не позволяется изменение масштаба.Если окно в настоящее время позволяет масштабировать, устанавливает новый кадр.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Возвращает поле флагов записи события для события mouseDown, инициировавшего сеанс изменения размеров.
Возвращаемое значение
Маска, указывающая, какая из модифицирующих клавиш удерживалась, когда произошло событие mouseDown. Флаги перечислены в
NSEvent
объектmodifierFlags
описание метода.Обсуждение
Этот метод допустим только, в то время как изменяется окно
Можно использовать этот метод для ограничения направления или суммы изменения размеров. Из-за его ограниченной законности этот метод должен только быть вызван из реализации метода делегата
windowWillResize:toSize:
.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Возвращает булево значение, указывающее, изменяет ли окно размеры индикатора, видимо.
Объявление
Swift
var showsResizeIndicator: Bool
Objective C
@property BOOL showsResizeIndicator
Возвращаемое значение
YES
true
то, когда окно изменяет размеры индикатора, видимо; иначе,NO
false
.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Указывает, изменяет ли окно размеры индикатора, видимо
Объявление
Swift
var showsResizeIndicator: Bool
Objective C
@property BOOL showsResizeIndicator
Параметры
showResizeIndicator
Указывает изменять размеры состояние индикатора.
YES
true
показать его,NO
false
скрыть его.Обсуждение
Этот метод не влияет, изменяемого размера ли окно.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Возвращает инкременты изменения размеров окна.
Возвращаемое значение
Инкременты изменения размеров окна.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Ограничивает возможность пользователя изменить размеры окна так изменение ширины и высоты сетью магазинов инкрементов ширины и высоты.
Параметры
resizeIncrements
Изменение размеров постепенно увеличивается для установки.
Обсуждение
Поскольку пользователь изменяет размеры окна, его изменений размера сетью магазинов
increments
.width
иincrements
.height
, который должен быть целыми числами, 1.0 или больше. Безотносительно текущих инкрементов изменения размеров можно установитьNSWindow
размер объекта к любой высоте и ширине программно.Измените размеры инкрементов, и форматное соотношение взаимоисключающие атрибуты. Для получения дополнительной информации посмотрите
setAspectRatio:
.setContentResizeIncrements: метод имеет приоритет по этому методу.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Возвраты, пытается ли окно оптимизировать инициируемый пользователями, изменяют размеры операций путем сохранения содержания не изменившихся представлений.
Объявление
Swift
var preservesContentDuringLiveResize: Bool
Objective C
@property BOOL preservesContentDuringLiveResize
Возвращаемое значение
YES
true
если окно пытается оптимизировать живой, изменяют размеры операций путем сохранения содержания не переместившихся представлений; иначе,NO
false
.Обсуждение
То, когда живой - изменяют размеры оптимизации, активно, окно перерисовывает только те представления, переместившиеся (или не поддерживайте эту оптимизацию) во время живого изменяют размеры работы.
Посмотрите
preservesContentDuringLiveResize
вNSView
для получения дополнительной информации о том, как поддерживать эту оптимизацию.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.4 и позже.
См. также
– setPreservesContentDuringLiveResize:
preservesContentDuringLiveResize
(NSView
) -
Указывает, пытается ли окно оптимизировать живой, изменяют размеры операций путем сохранения содержания не изменившихся представлений.
Объявление
Swift
var preservesContentDuringLiveResize: Bool
Objective C
@property BOOL preservesContentDuringLiveResize
Параметры
preservesContentDuringLiveResize
YES
true
включает живой - изменяют размеры оптимизации;NO
false
выключает его для окна и всех его содержавших представлений.Обсуждение
По умолчанию, живой - изменяют размеры оптимизации, включен.
Вы могли бы рассмотреть отключение этой оптимизации для окна, если ни одно из содержавших представлений окна не может использовать в своих интересах его. Отключение оптимизации для окна препятствует тому, чтобы он проверил каждое представление, чтобы видеть, поддерживается ли оптимизация.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.4 и позже.
См. также
-
Указывает, изменяется ли окно пользователем.
Объявление
Swift
var inLiveResize: Bool { get }
Objective C
@property(readonly) BOOL inLiveResize
Возвращаемое значение
YES
true
если окно живо измененный; иначе,NO
false
.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.6 и позже.
-
Возвращает форматное соотношение содержания окна.
Возвращаемое значение
Форматное соотношение содержания окна.
Обсуждение
Форматное соотношение содержания по умолчанию
(0, 0)
.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.3 и позже.
См. также
-
Устанавливает форматное соотношение (высота в связи с шириной) представления содержания окна, ограничивая размерности его прямоугольника содержания к интегральной сети магазинов того отношения, когда пользователь изменяет размеры его.
Параметры
contentAspectRatio
Форматное соотношение представления содержания окна.
Обсуждение
Можно установить представление содержания окна в любой размер программно, независимо от его форматного соотношения. Этот метод имеет приоритет
setAspectRatio:
.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.3 и позже.
См. также
-
Возвращает минимальный размер представления содержания окна.
Возвращаемое значение
Минимальный размер представления содержания окна.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.3 и позже.
См. также
-
Устанавливает минимальный размер представления содержания окна в основной системе координат окна.
Параметры
contentMinSize
Минимальный размер представления содержания окна в основной системе координат окна.
Обсуждение
Минимальное ограничение размера осуществляется для изменения размеров пользователем, а также для
setContentSize:
метод иsetFrame...
методы кромеsetFrame:display:
иsetFrame:display:animate:
. Этот метод имеет приоритетsetMinSize:
.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.3 и позже.
См. также
-
Устанавливает размер представления содержания окна к данному размеру, выраженному в основной системе координат окна.
Объявление
Swift
func setContentSize(_
size
: NSSize)Objective C
- (void)setContentSize:(NSSize)
size
Параметры
size
Новый размер представления содержания окна в основной системе координат окна.
Обсуждение
Этот размер поочередно изменяет размер
NSWindow
возразите себе. Обратите внимание на то, что сервер окна ограничивает размеры окна 10 000; при необходимости, обязательно ограничьтеaSize
относительно прямоугольника кадра.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Возвращает максимальный размер представления содержания окна.
Возвращаемое значение
Максимальный размер представления содержания окна.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.3 и позже.
См. также
-
Устанавливает максимальный размер представления содержания окна в основной системе координат окна.
Параметры
contentMaxSize
Максимальный размер представления содержания окна в основной системе координат окна.
Обсуждение
Максимальное ограничение размера осуществляется для изменения размеров пользователем, а также для
setContentSize:
метод иsetFrame...
методы кромеsetFrame:display:
иsetFrame:display:animate:
. Этот метод имеет приоритетsetMaxSize:
.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.3 и позже.
См. также
-
Возвращает инкременты изменения размеров довольного представления окна.
Объявление
Swift
var contentResizeIncrements: NSSize
Objective C
@property NSSize contentResizeIncrements
Возвращаемое значение
Инкременты изменения размеров довольного представления окна.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.3 и позже.
См. также
-
Ограничивает возможность пользователя изменить размеры окна так ширина и высота довольного изменение представления сетью магазинов инкрементов ширины и высоты.
Объявление
Swift
var contentResizeIncrements: NSSize
Objective C
@property NSSize contentResizeIncrements
Параметры
contentResizeIncrements
Изменение размеров довольного представления постепенно увеличивается для установки.
Обсуждение
Поскольку пользователь изменяет размеры окна, размера довольного изменения представления интегральной сетью магазинов
contentResizeIncrements
.width
иcontentResizeIncrements
.height
. Однако можно установить размер окна в любую ширину и высоту программно. Этот метод имеет приоритетsetResizeIncrements:
.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.3 и позже.
См. также
-
Удаляет окно из экранного списка, скрывающего окно.
Объявление
Swift
func orderOut(_
sender
: AnyObject?)Objective C
- (void)orderOut:(id)
sender
Параметры
sender
Отправитель сообщения.
Обсуждение
Если окно является ключевым или главным окном,
NSWindow
возразите сразу позади него, сделан ключевым или основным в его месте. ВызовorderOut:
метод заставляет окно быть удаленным из экрана, но не заставляет его быть выпущенным. Посмотритеclose
метод для получения информации о том, когда выпущено окно.Анимация по умолчанию на основе типа окна будет использоваться, когда окну прикажут уйти, если это не было изменено
setAnimationBehavior:
метод.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Перемещает окно в заднюю часть его уровня в экранном списке, не изменяясь или ключевое окно или главное окно.
Объявление
Swift
func orderBack(_
sender
: AnyObject?)Objective C
- (void)orderBack:(id)
sender
Параметры
sender
Отправитель сообщения.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Перемещает окно в переднюю сторону его уровня в экранном списке, не изменяясь или ключевое окно или главное окно.
Объявление
Swift
func orderFront(_
sender
: AnyObject?)Objective C
- (void)orderFront:(id)
sender
Параметры
sender
Отправитель сообщения.
Обсуждение
Анимация по умолчанию на основе типа окна будет использоваться, когда окну упорядочат переднюю сторону, если это не было изменено
setAnimationBehavior:
метод.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Даже если его приложение не активно, не изменяясь или ключевое окно или главное окно, перемещает окно в переднюю сторону его уровня.
Объявление
Swift
func orderFrontRegardless()
Objective C
- (void)orderFrontRegardless
Параметры
sender
Отправитель сообщения.
Обсуждение
Обычно
NSWindow
объект не может быть перемещен перед ключевым окном, если это и ключевое окно не находится в том же приложении. Необходимо редко должны быть вызвать этот метод; это разработано, чтобы использоваться, когда приложения сотрудничают таким способом, которым активное приложение (с ключевым окном) использует другое приложение для отображения данных.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Меняет местоположение устройства окна окна в экранном списке сервера окна.
Объявление
Swift
func orderWindow(_
orderingMode
: NSWindowOrderingMode, relativeTootherWindowNumber
: Int)Objective C
- (void)orderWindow:(NSWindowOrderingMode)
orderingMode
relativeTo:(NSInteger)otherWindowNumber
Параметры
orderingMode
NSWindowOut
: Окно удалено из экранного списка иotherWindowNumber
проигнорирован.NSWindowAbove
: Окно сразу упорядочивается перед окном, число окна которогоotherWindowNumber
NSWindowBelow
: Окно сразу помещается позади окна, представленногоotherWindowNumber
.
otherWindowNumber
Число окна окно должно быть помещено перед или позади. Передача
0
поместить окно перед (когдаorderingMode
NSWindowAbove
) или позади (когдаorderingMode
NSWindowBelow
) все другие окна на его уровне.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Возвращает уровень окна окна.
Возвращаемое значение
Уровень окна.
Обсуждение
Посмотрите Уровни Окна для списка возможных значений.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Устанавливает уровень окна окна в данный уровень.
Параметры
windowLevel
Уровень окна для установки.
Обсуждение
Некоторые полезные предопределенные значения, упорядоченные от самого низкого до самого высокого, описаны на Уровнях Окна.
Каждый уровень в окнах групп списка в нем перед теми во всех предыдущих группах. Плавающие окна, например, появляются перед всеми окнами нормального уровня. Когда окно вводит новый уровень, оно упорядочивается перед всеми его коллегами на том уровне.
Константа
NSTornOffMenuWindowLevel
предпочтительно для его синонима,NSSubmenuWindowLevel
.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
isVisible - isVisible
Доступный в OS X v10.0 через OS X v10.9Указывает, является ли окно видимым экранный (даже когда Оно затенено другими окнами).
Объявление
Objective C
- (BOOL)isVisible
Возвращаемое значение
YES
true
когда окно является экранным (даже если оно затенено другими окнами); иначе,NO
false
.Оператор импорта
Objective C
@import AppKit;
Доступность
Доступный в OS X v10.0 через OS X v10.9.
См. также
visibleRect
(NSView
) -
Возвращает состояние поглощения газов окна.
Объявление
Swift
var occlusionState: NSWindowOcclusionState { get }
Objective C
@property(readonly) NSWindowOcclusionState occlusionState
Возвращаемое значение
Если
occlusionState
NSWindowOcclusionStateVisible
, по крайней мере, часть окна видима; иначе, окно полностью закрывается.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.9 и позже.
-
Удаляет данные кадра, сохраненные под именем от пользовательских значений по умолчанию приложения.
Объявление
Swift
class func removeFrameUsingName(_
frameName
: String)Objective C
+ (void)removeFrameUsingName:(NSString *)
frameName
Параметры
frameName
Имя кадра для удаления.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Устанавливает прямоугольник кадра окна путем чтения прямоугольных данных, сохраненных под именем от системы значений по умолчанию.
Объявление
Swift
func setFrameUsingName(_
frameName
: String) -> BoolObjective C
- (BOOL)setFrameUsingName:(NSString *)
frameName
Параметры
frameName
Имя кадра для чтения.
Возвращаемое значение
YES
true
когдаframeName
читается и кадр установлен успешно; иначе,NO
false
.Обсуждение
Кадр ограничивается согласно минимальным и максимальным настройкам размера окна. Этот метод вызывает a
windowWillResize:toSize:
сообщение, которое будет отправлено делегату.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Устанавливает прямоугольник кадра окна путем чтения прямоугольных данных, сохраненных под именем от системы значений по умолчанию. Может воздействовать на окна неизменяемого размера.
Объявление
Swift
func setFrameUsingName(_
frameName
: String, forceforce
: Bool) -> BoolObjective C
- (BOOL)setFrameUsingName:(NSString *)
frameName
force:(BOOL)force
Параметры
frameName
Имя кадра для чтения.
force
YES
true
использоватьsetFrameUsingName:
на окне неизменяемого размера;NO
false
перестать работать на окне неизменяемого размера.Возвращаемое значение
YES
true
когдаframeName
читается и кадр установлен успешно; иначе,NO
false
.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Сохраняет прямоугольник кадра окна в пользовательской системе значений по умолчанию под именем.
Объявление
Swift
func saveFrameUsingName(_
frameName
: String)Objective C
- (void)saveFrameUsingName:(NSString *)
frameName
Параметры
frameName
Имя, под которым должен быть сохранен кадр.
Обсуждение
С сопутствующим методом
setFrameUsingName:
, можно сохранить и сброситьNSWindow
кадр объекта по различным запускам приложения. Значение по умолчанию принадлежит приложению и сохранено под именем"NSWindow Frame
frameName"
. ПосмотритеNSUserDefaults
для получения дополнительной информации.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Возвращает имя, используемое для автоматического сохранения прямоугольных данных кадра окна в системе значений по умолчанию, как установлено через
setFrameAutosaveName:
.Возвращаемое значение
Имя раньше сохраняло прямоугольник кадра окна автоматически в системе значений по умолчанию.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Определяет имя, используемое для автоматического сохранения прямоугольника кадра окна в системе значений по умолчанию к имени.
Объявление
Swift
func setFrameAutosaveName(_
frameName
: String) -> BoolObjective C
- (BOOL)setFrameAutosaveName:(NSString *)
frameName
Параметры
frameName
Имя, под которым должен быть сохранен кадр.
Возвращаемое значение
YES
true
когда имя кадра определяется успешно;NO
false
когда frameName используется в качестве имени автосохранения другимNSWindow
объект в приложении (когда старое название окна остается в силе).Обсуждение
Если
frameName
не пустая строка (@""
), кадр окна сохраняется как пользовательское значение по умолчанию (как описано вsaveFrameUsingName:
) каждый раз изменения кадра.Когда окно имеет имя автосохранения, его данные кадра записаны каждый раз, когда изменяется прямоугольник кадра.
Если существует прямоугольник кадра, ранее сохраненный для
frameName
в пользовательских значениях по умолчанию кадр окна установлен в этот прямоугольник кадра. Т.е. когда Вы вызываете этот метод с ранее используемыйframeName
, окно берет ранее сохраненную настройку. Например, если Вы вызываетеsetFrameAutosaveName:
для окна, которое является уже экранным, этот метод мог заставить окно перемещаться в различное расположение на экране. Поэтому обычно лучше вызвать этот метод, прежде чем окно будет видимо на экране.Следует иметь в виду, что контроллер окна может сменить положение окна, когда это выводит на экран его, если включено расположение каскадом окна. Устранить контроллер окна от того, чтобы менять положение окна от того сохранило в системе значений по умолчанию, необходимо отправить
setShouldCascadeWindows:NO
к контроллеру окна.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Возвращает строковое представление прямоугольника кадра окна.
Объявление
Swift
var stringWithSavedFrame: String { get }
Objective C
@property(readonly, copy) NSString *stringWithSavedFrame
Возвращаемое значение
Строковое представление прямоугольника кадра окна в формате, который может использоваться с более поздним
setFrameFromString:
сообщение.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Устанавливает прямоугольник кадра окна от данного строкового представления.
Объявление
Swift
func setFrameFromString(_
frameString
: String)Objective C
- (void)setFrameFromString:(NSString *)
frameString
Параметры
frameString
Строковое представление прямоугольника кадра, ранее создавая использование
stringWithSavedFrame
.Обсуждение
Если окно не будет изменяемого размера, то этот метод не изменит размеры окна. Кадр ограничивается согласно минимальным и максимальным настройкам размера окна. Этот метод вызывает a
windowWillResize:toSize:
сообщение, которое будет отправлено делегату.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
isKeyWindow - isKeyWindow
Доступный в OS X v10.0 через OS X v10.9Указывает, является ли окно ключевым окном для приложения.
Объявление
Objective C
- (BOOL)isKeyWindow
Возвращаемое значение
YES
true
если окно является ключевым окном для приложения; иначе,NO
false
.Оператор импорта
Objective C
@import AppKit;
Доступность
Доступный в OS X v10.0 через OS X v10.9.
См. также
-
Указывает, может ли окно стать ключевым окном.
Объявление
Swift
var canBecomeKeyWindow: Bool { get }
Objective C
@property(readonly) BOOL canBecomeKeyWindow
Возвращаемое значение
YES
true
если окно может стать ключевым окном, иначе,NO
false
.Обсуждение
Попытки сделать окно, от ключевого окна отказываются, если возвращается этот метод
NO
false
.NSWindow
возвраты реализацииYES
true
если окно имеет строку заголовка или изменять размеры панель, илиNO
false
иначе.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Делает окно ключевым окном.
Объявление
Swift
func makeKeyWindow()
Objective C
- (void)makeKeyWindow
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Перемещает окно в переднюю сторону экранного списка, в его уровне, и делает его ключевым окном; т.е. это показывает окно.
Объявление
Swift
func makeKeyAndOrderFront(_
sender
: AnyObject?)Objective C
- (void)makeKeyAndOrderFront:(id)
sender
Параметры
sender
Отправитель сообщения.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Вызванный автоматически, чтобы сообщить окну, что это стало ключевым окном; никогда не вызывайте этот метод непосредственно.
Объявление
Swift
func becomeKeyWindow()
Objective C
- (void)becomeKeyWindow
Обсуждение
Этот метод восстанавливает первого респондента окна, отправляет
becomeKeyWindow
обменивайтесь сообщениями к тому объекту, если он отвечает и отправляетNSWindowDidBecomeKeyNotification
к центру уведомления по умолчанию.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Вызванный автоматически, когда окно оставляет ключевое состояние окна; никогда не вызывайте этот метод непосредственно.
Объявление
Swift
func resignKeyWindow()
Objective C
- (void)resignKeyWindow
Обсуждение
Этот метод отправляет
resignKeyWindow
первому респонденту окна, отправляетwindowDidResignKey:
делегату окна и сообщениямNSWindowDidResignKeyNotification
к центру уведомления по умолчанию.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
isMainWindow - isMainWindow
Доступный в OS X v10.0 через OS X v10.9Указывает, является ли окно главным окном приложения.
Объявление
Objective C
- (BOOL)isMainWindow
Возвращаемое значение
YES
true
когда окно является главным окном для приложения; иначе,NO
false
.Оператор импорта
Objective C
@import AppKit;
Доступность
Доступный в OS X v10.0 через OS X v10.9.
См. также
-
Указывает, может ли окно стать главным окном приложения.
Объявление
Swift
var canBecomeMainWindow: Bool { get }
Objective C
@property(readonly) BOOL canBecomeMainWindow
Возвращаемое значение
YES
true
когда окно может стать главным окном; иначе,NO
false
.Обсуждение
Попытки сделать окно, от главного окна отказываются, если возвращается этот метод
NO
false
.NSWindow
возвраты реализацииYES
true
если окно видимо, неNSPanel
объект, и имеет строку заголовка или изменять размеры механизм. Иначе это возвращаетсяNO
false
.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Делает окно главным окном.
Объявление
Swift
func makeMainWindow()
Objective C
- (void)makeMainWindow
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Вызванный автоматически, чтобы сообщить окну, что это стало главным окном; никогда не вызывайте этот метод непосредственно.
Объявление
Swift
func becomeMainWindow()
Objective C
- (void)becomeMainWindow
Обсуждение
Этот метод отправляет
NSWindowDidBecomeMainNotification
к центру уведомления по умолчанию.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Вызванный автоматически, когда окно оставляет состояние главного окна; никогда не вызывайте этот метод непосредственно.
Объявление
Swift
func resignMainWindow()
Objective C
- (void)resignMainWindow
Обсуждение
Этот метод отправляет
windowDidResignMain:
делегату и сообщениям окнаNSWindowDidResignMainNotification
к центру уведомления по умолчанию.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Возвращает панель инструментов окна.
Возвращаемое значение
Панель инструментов окна.
Обсуждение
Посмотрите
NSToolbar
описание класса для получения дополнительной информации.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Устанавливает панель инструментов окна.
Параметры
toolbar
Панель инструментов для окна.
Обсуждение
Посмотрите
NSToolbar
описание класса для получения дополнительной информации.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Метод действия для пункта меню «Hide Toolbar» (который чередуется с, “Показывают Панель инструментов”).
Объявление
Swift
func toggleToolbarShown(_
sender
: AnyObject?)Objective C
- (void)toggleToolbarShown:(id)
sender
Параметры
sender
Отправитель сообщения.
Обсуждение
Посмотрите
NSToolbar
описание класса для получения дополнительной информации.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Метод действия для пункта меню «Customize Toolbar …».
Объявление
Swift
func runToolbarCustomizationPalette(_
sender
: AnyObject?)Objective C
- (void)runToolbarCustomizationPalette:(id)
sender
Параметры
sender
Отправитель сообщения.
Обсуждение
Посмотрите
NSToolbar
описание класса для получения дополнительной информации.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Возвращает массив присоединенных дочерних окон окна.
Объявление
Swift
var childWindows: [AnyObject]? { get }
Objective C
@property(readonly, copy) NSArray *childWindows
Возвращаемое значение
Массив, содержащий дочерние окна окна.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.2 и позже.
-
Добавляет данное окно как дочернее окно окна.
Объявление
Swift
func addChildWindow(_
childWindow
: NSWindow, orderedorderingMode
: NSWindowOrderingMode)Objective C
- (void)addChildWindow:(NSWindow *)
childWindow
ordered:(NSWindowOrderingMode)orderingMode
Параметры
childWindow
Дочернее окно для упорядочивания.
orderingMode
NSWindowAbove
:childWindow
сразу упорядочивается перед окном.NSWindowBelow
:childWindow
сразу упорядочивается позади окна.
Обсуждение
После
childWindow
добавляется как дочерний элемент окна, оно сохраняется в относительной позиции, обозначеннойorderingMode
для последующих операций упорядочивания, включающих любое окно. В то время как это присоединение активно, перемещаясьchildWindow
не заставит окно перемещаться (как в задвижение секции или), но перемещение окна вызоветchildWindow
перемещаться.Обратите внимание на то, что Вы не должны создавать циклы между родительскими и дочерними окнами. Например, Вы не должны добавлять окно B как дочерний элемент окна A, затем добавить окно A как дочерний элемент окна B.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.2 и позже.
-
Отсоединяет данное дочернее окно из окна.
Объявление
Swift
func removeChildWindow(_
childWindow
: NSWindow)Objective C
- (void)removeChildWindow:(NSWindow *)
childWindow
Параметры
childWindow
Дочернее окно для отсоединения.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.2 и позже.
-
Возвращает родительское окно, к которому окно присоединяется как дочерний элемент.
Объявление
Swift
unowned(unsafe) var parentWindow: NSWindow?
Objective C
@property(assign) NSWindow *parentWindow
Возвращаемое значение
Окно, к которому окно присоединяется как дочерний элемент.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.2 и позже.
-
Добавляет окно как дочерний элемент данного окна. Для использования подклассами при установке родительского окна в окне.
Объявление
Swift
unowned(unsafe) var parentWindow: NSWindow?
Objective C
@property(assign) NSWindow *parentWindow
Параметры
parentWindow
Окно, чтобы быть дочерним элементом данного окна.
Обсуждение
Этот метод нужно вызвать от подкласса, когда он переопределяется реализацией подкласса. Это нельзя вызвать иначе.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.2 и позже.
-
isFlushWindowDisabled - isFlushWindowDisabled
Доступный в OS X v10.0 через OS X v10.9Указывает, отключена ли возможность сбрасывания окна.
Объявление
Objective C
- (BOOL)isFlushWindowDisabled
Возвращаемое значение
YES
true
когда была отключена возможность сбрасывания окна; иначе,NO
false
.Оператор импорта
Objective C
@import AppKit;
Доступность
Доступный в OS X v10.0 через OS X v10.9.
См. также
-
Повторно включает
flushWindow
метод для окна после того, как это было отключено через предыдущееdisableFlushWindow
сообщение.Объявление
Swift
func enableFlushWindow()
Objective C
- (void)enableFlushWindow
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Отключает
flushWindow
метод для окна.Объявление
Swift
func disableFlushWindow()
Objective C
- (void)disableFlushWindow
Обсуждение
Если окно буферизуется, отключая
flushWindow
препятствует тому, чтобы получение было автоматически сброшеноNSView
display...
методы от запоминающего устройства окна до экрана. Этот метод разрешает нескольким представлениям быть нарисованными, прежде чем результаты будут показаны пользователю.В то время как дисплей окна обновляется, сбрасывание должно быть отключено только временно. Каждый
disableFlushWindow
сообщение должно быть соединено с последующимenableFlushWindow
сообщение. Вызовы этих методов могут быть вложены; сбрасывание не повторно включено до последнегоenableFlushWindow
сообщение отправляется.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Сбрасывает внеэкранный буфер окна на экран, если окно буферизуется, и сбрасывание включено.
Объявление
Swift
func flushWindow()
Objective C
- (void)flushWindow
Обсуждение
Ничего не делает для других дисплеев, таких как принтер. Этот метод автоматически вызывается
NSWindow
display
иdisplayIfNeeded
методы и соответствиеNSView
дисплей
иdisplayIfNeeded
методы.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Если сбрасывание включено и если последнее, сбрасывает внеэкранный буфер окна на экран
flushWindow
сообщение не имело никакого эффекта, потому что было отключено сбрасывание.Объявление
Swift
func flushWindowIfNeeded()
Objective C
- (void)flushWindowIfNeeded
Обсуждение
Для предотвращения ненужного сбрасывания используйте этот метод, а не
flushWindow
сброситьNSWindow
объект после сбрасывания был повторно включен.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Возвращает ячейку кнопки, выполняющую, как будто щелкнувший, когда окно получает Возврат (или Входят), ключевое событие.
Объявление
Swift
func defaultButtonCell() -> NSButtonCell?
Objective C
- (NSButtonCell *)defaultButtonCell
Возвращаемое значение
Ячейка кнопки.
Обсуждение
Эта ячейка рисует себя как фокальный элемент для управления интерфейсом клавиатуры, если другая ячейка кнопки не фокусируется на, когда ячейка кнопки по умолчанию временно рисует себя как нормальный и отключает ее ключевой эквивалент.
Окно получает событие клавиши Return, если никакой респондент в его цепочке респондента не требует его, или если пользователь нажимает Клавишу CTRL вместе с клавишей Return.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Делает ключевой эквивалент ячейки кнопки Возвратом (или Войдите), ключ, поэтому когда пользователь нажимает Return, который кнопка выполняет как будто щелкнувший.
Объявление
Swift
func setDefaultButtonCell(_
defaultButtonCell
: NSButtonCell?)Objective C
- (void)setDefaultButtonCell:(NSButtonCell *)
defaultButtonCell
Параметры
defaultButtonCell
Ячейка кнопки для выполнения, как будто щелкнувший, когда окно получает Возврат (или Входят), ключевое событие.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Повторно включает эквивалентный ключ ячейки кнопки по умолчанию, таким образом, он выполняет щелчок, когда пользователь нажимает Return (или Enter).
Объявление
Swift
func enableKeyEquivalentForDefaultButtonCell()
Objective C
- (void)enableKeyEquivalentForDefaultButtonCell
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Отключает эквивалентный ключ ячейки кнопки по умолчанию, таким образом, он не выполняет щелчок, когда пользователь нажимает Return (или Enter).
Объявление
Swift
func disableKeyEquivalentForDefaultButtonCell()
Objective C
- (void)disableKeyEquivalentForDefaultButtonCell
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Возвращает полевого редактора окна, создавая его, если требуется.
Объявление
Swift
func fieldEditor(_
createWhenNeeded
: Bool, forObjectanObject
: AnyObject?) -> NSText?Objective C
- (NSText *)fieldEditor:(BOOL)
createWhenNeeded
forObject:(id)anObject
Параметры
createWhenNeeded
Если
YES
true
, создает полевого редактора, если Вы не существуете; еслиNO
false
, не создает полевого редактора.Недавно создаваемый
NSWindow
объект не имеет полевого редактора. После того, как полевой редактор был создан для окна,createWhenNeeded
параметр проигнорирован. Путем передачиNO
false
дляcreateWhenNeeded
и тестируя возвращаемое значение, однако, можно утвердить действие с существованием полевого редактора.anObject
Выводящий на экран текст объект тот, для который делегат (в
windowWillReturnFieldEditor:toObject:
) присваивает пользовательского полевого редактора. Передачаnil
получить полевого редактора по умолчанию, который может бытьNSWindow
полевой редактор или пользовательский полевой редактор, возвращенный делегатом.Возвращаемое значение
Возвращает полевого редактора для заданного объекта (
anObject
) или, еслиanObject
nil
, полевой редактор по умолчанию. Возвратыnil
еслиcreateFlag
NO
false
и если не существует полевой редактор.Обсуждение
Полевой редактор является синглом
NSTextView
объект, совместно использующийся среди всех средств управления в окне для легких потребностей редактирования текста. Это автоматически инстанцируют при необходимости, и это может использоваться, однако, Ваше приложение считает целесообразным. Как правило, полевой редактор используется переносящими простой текст объектами — например,NSTextField
возразите использует полевого редактора его окна, чтобы вывести на экран и управлять текстом. Полевой редактор может быть совместно использован любым числом объектов, и таким образом, может постоянно изменяться его состояние. Поэтому это не должно использоваться для отображения текста, требующего сложное расположение (для этого, необходимо создать специализированноеNSTextView
объект).Полевой редактор может использоваться некоторым объектом представления, так, несомненно, должным образом сможет отделить его от того объекта прежде фактически использовать его самостоятельно (надлежащий способ сделать, это проиллюстрировано в описании
endEditingFor:
). Как только Вы получаете полевого редактора, можно вставить его в иерархию представления, установить делегата для интерпретации текстовых событий, и иметь его выполняют любое редактирование, необходим. Затем когда это отправляет atextDidEndEditing:
обменивайтесь сообщениями делегату, можно заставить его текст отображать или хранить и удалять полевого редактора, использующегоendEditingFor:
.Делегат окна может заменить пользовательским полевым редактором вместо полевого редактора окна путем реализации
windowWillReturnFieldEditor:toObject:
. Пользовательский полевой редактор может стать редактором по умолчанию (характерный для всех выводящих на экран текст объектов) или определенный для определенного выводящего на экран текст объекта (anObject
). Окно отправляет это сообщение своему делегату с собой иanObject
как параметры; если делегат возвращается не -nil
значение, возвраты окна, возражающие вместо его полевого редактора вfieldEditor:forObject:
. Однако отметьте следующее:Если делегат окна идентичен
anObject
,windowWillReturnFieldEditor:toObject:
не отправляется делегату.Объект, возвращенный методом делегата, хотя это может стать первым респондентом, не становится полевым редактором окна по умолчанию. Другие объекты продолжают использовать полевого редактора окна по умолчанию.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Вынуждает полевого редактора бросить его первое состояние респондента и подготавливает его к его следующему присвоению.
Объявление
Swift
func endEditingFor(_
object
: AnyObject?)Objective C
- (void)endEditingFor:(id)
object
Параметры
object
Объект, использующий полевого редактора окна.
Обсуждение
Если полевой редактор является первым респондентом, это сделано оставить то состояние даже если
resignFirstResponder
возвраты методаNO
false
. Эта регистрация вынуждает полевого редактора отправить atextDidEndEditing:
обменивайтесь сообщениями его делегату. Полевой редактор тогда удален из иерархии представления, ее делегат установлен вnil
, и это освобождено от любого текста, который это может содержать.Этот метод обычно вызывается объектом с помощью полевого редактора, когда это закончено. Другие объекты обычно изменяют первого респондента путем простого использования
makeFirstResponder:
, если, например, пользователь ввел недопустимое значение, который позволяет полевому редактору или другому объекту сохранить его первое состояние респондента.endEditingFor:
если полевой редактор отказывается оставлять первое состояние респондента, метод должен использоваться только как последнее прибежище. Даже в этом случае необходимо всегда позволять полевому редактору шанс проверить его текст и принять безотносительно других мер, в которых он нуждается сначала. Можно сделать это первой попыткой сделатьNSWindow
возразите первому респонденту:if ([myWindow makeFirstResponder:myWindow]) {
/* All fields are now valid; it’s safe to use fieldEditor:forObject:
to claim the field editor. */
}
else {
/* Force first responder to resign. */
[myWindow endEditingFor:nil];
}
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
– fieldEditor:forObject:
windowWillReturnFieldEditor:toObject:
(NSWindowDelegate
)
-
isExcludedFromWindowsMenu - isExcludedFromWindowsMenu
Доступный в OS X v10.0 через OS X v10.9Указывает, исключено ли окно из меню Windows приложения.
Объявление
Objective C
- (BOOL)isExcludedFromWindowsMenu
Возвращаемое значение
YES
true
когда окно исключено из меню Windows; иначе,NO
false
.Обсуждение
Начальная установка по умолчанию
NO
false
.Оператор импорта
Objective C
@import AppKit;
Доступность
Доступный в OS X v10.0 через OS X v10.9.
См. также
-
Указывает, опущен ли заголовок окна из меню Windows приложения.
Объявление
Swift
var excludedFromWindowsMenu: Bool
Objective C
@property(getter=isExcludedFromWindowsMenu) BOOL excludedFromWindowsMenu
Параметры
excludedFromWindowsMenu
Если
YES
true
, окно будет опущено из меню Windows приложения; еслиNO
false
, это не будет опущено.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Указывает, включены ли прямоугольники курсора окна.
Объявление
Swift
var areCursorRectsEnabled: Bool { get }
Objective C
@property(readonly) BOOL areCursorRectsEnabled
Возвращаемое значение
YES
true
когда включены прямоугольники курсора; иначе,NO
false
.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Повторно включает прямоугольное управление курсором в окне после a
disableCursorRects
сообщение.Объявление
Swift
func enableCursorRects()
Objective C
- (void)enableCursorRects
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Отключает все прямоугольное управление курсором в окне.
Объявление
Swift
func disableCursorRects()
Objective C
- (void)disableCursorRects
Обсуждение
Используйте этот метод, когда необходимо сделать некоторое специальное манипулирование курсором, и Вы не хотите вмешательство Набора Приложения.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Лишает законной силы все прямоугольники курсора в окне.
Объявление
Swift
func discardCursorRects()
Objective C
- (void)discardCursorRects
Обсуждение
Этот метод вызывается
resetCursorRects
убрать существующие прямоугольники курсора прежде, чем сбросить их. Вы не должны вызывать его в коде, который Вы пишете, но Вы могли бы хотеть переопределить его для изменения его поведения.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Знаки как недопустимые прямоугольники курсора данного
NSView
объект в иерархии представления окна, таким образом, они будут установлены снова, когда окно станет ключевым (или сразу если окно является ключевым).Объявление
Swift
func invalidateCursorRectsForView(_
view
: NSView)Objective C
- (void)invalidateCursorRectsForView:(NSView *)
view
Параметры
view
Представление в иерархии представления окна.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
– resetCursorRects
resetCursorRects
(NSView
) -
Очищает прямоугольники курсора окна и прямоугольники курсора
NSView
объекты в его иерархии представления.Объявление
Swift
func resetCursorRects()
Objective C
- (void)resetCursorRects
Обсуждение
Вызывает
discardCursorRects
для очистки прямоугольников курсора окна, затем отправляетresetCursorRects
к каждомуNSView
объект в иерархии представления окна.Этот метод обычно вызывается объектом NSApplication, когда это обнаруживает, что прямоугольники курсора ключевого окна недопустимы. В коде программы более эффективно вызвать
invalidateCursorRectsForView:
.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Возвращает новый экземпляр данной стандартной кнопки окна, измеренной соответственно для данного стиля окна.
Объявление
Swift
class func standardWindowButton(_
windowButtonKind
: NSWindowButton, forStyleMaskwindowStyle
: Int) -> NSButton?Objective C
+ (NSButton *)standardWindowButton:(NSWindowButton)
windowButtonKind
forStyleMask:(NSUInteger)windowStyle
Параметры
windowButtonKind
Вид стандартной кнопки окна для возврата.
windowStyle
Стиль окна тот, для который
windowButtonKind
должен быть измерен. Посмотрите Маски Стиля окна для списка допустимых значений.Возвращаемое значение
Новая кнопка окна вида, идентифицированного
windowButtonKind
;nil
когда не существует никакой такой вид кнопки.Обсуждение
Вызывающая сторона ответственна за добавление кнопки к иерархии представления и для того, чтобы поставить цель, чтобы быть окном.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.2 и позже.
См. также
-
Возвращает кнопку окна данного вида кнопки окна в иерархии представления окна.
Объявление
Swift
func standardWindowButton(_
windowButtonKind
: NSWindowButton) -> NSButton?Objective C
- (NSButton *)standardWindowButton:(NSWindowButton)
windowButtonKind
Параметры
windowButtonKind
Вид стандартной кнопки окна для возврата.
Возвращаемое значение
Кнопка Window в иерархии представления окна вида, идентифицированного
windowButtonKind
;nil
когда такая кнопка не находится в иерархии представления окна.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.2 и позже.
См. также
-
Указывает, выводится ли кнопка управления панели инструментов в настоящее время на экран.
Объявление
Swift
var showsToolbarButton: Bool
Objective C
@property BOOL showsToolbarButton
Возвращаемое значение
YES
true
если стандартная кнопка на панели инструментов в настоящее время выводится на экран; иначе,NO
false
.Обсуждение
Когда щелкнувшийся, кнопка управления панели инструментов показывает или скрывает панель инструментов окна. Кнопка управления панели инструментов появляется в строке заголовка окна.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.4 и позже.
См. также
-
Указывает, показывает ли окно кнопку управления панели инструментов.
Объявление
Swift
var showsToolbarButton: Bool
Objective C
@property BOOL showsToolbarButton
Параметры
showsToolbarButton
YES
true
вывести на экран кнопку управления панели инструментов;NO
false
скрыть кнопку.Обсуждение
Если окно не имеет панели инструментов, этот метод не имеет никакого эффекта.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.4 и позже.
См. также
-
Указывает, может ли окно вывести на экран подсказки, даже когда приложение в фоновом режиме.
Объявление
Swift
var allowsToolTipsWhenApplicationIsInactive: Bool
Objective C
@property BOOL allowsToolTipsWhenApplicationIsInactive
Возвращаемое значение
YES
true
если окно может вывести на экран подсказки, даже когда приложение в фоновом режиме; иначе,NO
false
.Обсуждение
Значение по умолчанию
NO
false
.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.3 и позже.
-
Указывает, может ли окно вывести на экран подсказки, даже когда приложение в фоновом режиме.
Объявление
Swift
var allowsToolTipsWhenApplicationIsInactive: Bool
Objective C
@property BOOL allowsToolTipsWhenApplicationIsInactive
Параметры
allowTooltipsWhenAppInactive
YES
true
для имения окна выводят на экран подсказки, даже когда его приложение неактивно;NO
false
подавить дисплей подсказки, когда неактивный.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.3 и позже.
-
Этот метод ничего не делает; это здесь для обратной совместимости.
Объявление
Swift
class func menuChanged(_
menu
: NSMenu)Objective C
+ (void)menuChanged:(NSMenu *)
menu
Параметры
menu
Изменившийся объект меню.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
menu
(NSResponder
) -
Возвращает событие, в настоящее время обрабатываемое приложением, путем вызова
NSApplication
currentEvent
метод.Объявление
Swift
var currentEvent: NSEvent? { get }
Objective C
@property(readonly, strong) NSEvent *currentEvent
Возвращаемое значение
Событие, обрабатываемое приложением.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Возвращает следующее событие, соответствующее данную маску.
Объявление
Objective C
- (NSEvent *)nextEventMatchingMask:(NSUInteger)
eventMask
Параметры
eventMask
Маска, которую должно соответствовать событие для возврата. События с несоответствием масок оставляют в очереди. Посмотрите
discardEventsMatchingMask:beforeEvent:
вNSApplication
для списка значений маски.Возвращаемое значение
Следующее событие, маска которого соответствует
eventMask
;nil
когда не было учреждено никакое мероприятие соответствия.Обсуждение
Этот метод отправляет сообщение
nextEventMatchingMask:eventMask untilDate:[NSDate distantFuture] inMode:NSEventTrackingRunLoopMode dequeue:YES
к приложению (NSApp
).Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
nextEventMatchingMask:untilDate:inMode:dequeue:
(NSApplication
) -
nextEventMatchingMask (_: untilDate:inMode:dequeue:) - nextEventMatchingMask:untilDate:inMode:dequeue:
Передает сообщение к глобальной переменной
NSApplication
объект,NSApp
.Объявление
Swift
func nextEventMatchingMask(_
eventMask
: Int, untilDateexpirationDate
: NSDate?, inModerunLoopMode
: String, dequeuedequeue
: Bool) -> NSEvent?Objective C
- (NSEvent *)nextEventMatchingMask:(NSUInteger)
eventMask
untilDate:(NSDate *)expirationDate
inMode:(NSString *)runLoopMode
dequeue:(BOOL)dequeue
Параметры
eventMask
Маска, которую должно соответствовать событие для возврата.
expirationDate
Дата, до которой можно ожидать событий.
runLoopMode
Режим цикла выполнения для использования при ожидании событий
dequeue
YES
true
удалить возвращенное событие из очереди событий;NO
false
оставить возвращенное событие в очереди.Возвращаемое значение
Следующее событие, маска которого соответствует
eventMask
;nil
когда не было учреждено никакое мероприятие соответствия.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
nextEventMatchingMask:untilDate:inMode:dequeue:
(NSApplication
) -
Передает сообщение к
NSApplication
объект,NSApp
.Объявление
Objective C
- (void)discardEventsMatchingMask:(NSUInteger)
eventMask
beforeEvent:(NSEvent *)lastEvent
Параметры
eventMask
Маска событий для отбрасывания.
lastEvent
Событие, до которого поставленные в очередь события отбрасываются от очереди.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
discardEventsMatchingMask:beforeEvent:
(NSApplication
) -
Передает сообщение к глобальной переменной
NSApplication
объект,NSApp
.Объявление
Swift
func postEvent(_
event
: NSEvent, atStartatStart
: Bool)Objective C
- (void)postEvent:(NSEvent *)
event
atStart:(BOOL)atStart
Параметры
event
Событие для добавления к очереди событий окна.
atStart
YES
true
поместить событие перед очередью;NO
false
поместить его в спину.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Этот метод действия диспетчеризирует события от нажатия мыши и события клавиатуры, отправленные в окно
NSApplication
объект.Параметры
event
Событие от нажатия мыши или событие клавиатуры для обработки.
Обсуждение
Никогда не вызывайте этот метод непосредственно. Правильное событие mouseDown в окне неактивного приложения не поставлено соответствию
NSWindow
объект. Это вместо этого поставленоNSApplication
объект через asendEvent:
сообщение с числом окна 0.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Действие отгрузок обменивается сообщениями с данным параметром.
Объявление
Swift
func tryToPerform(_
selector
: Selector, withobject
: AnyObject?) -> BoolObjective C
- (BOOL)tryToPerform:(SEL)
selector
with:(id)object
Параметры
selector
Селектор, чтобы попытаться выполниться.
object
Параметр сообщения.
Возвращаемое значение
YES
true
когда окно или его делегат выполняютselector
сobject
; иначе,NO
false
.Обсуждение
Окно пытается выполнить метод
selector
использование его наследованныйNSResponder
методtryToPerform:with:
. Если окно не выполняетselector
, делегату дают возможность выполнить его с помощью его наследованногоNSObject
методperformSelector:withObject:
.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Возвраты просматривают, это сделало первого респондента первым разом, когда окно помещается на экране.
Объявление
Swift
unowned(unsafe) var initialFirstResponder: NSView?
Objective C
@property(assign) NSView *initialFirstResponder
Возвращаемое значение
Представление это сделало первого респондента первым разом окно, помещается на экране.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Возвращает первого респондента окна.
Объявление
Swift
var firstResponder: NSResponder { get }
Objective C
@property(readonly, strong) NSResponder *firstResponder
Возвращаемое значение
Первый респондент.
Обсуждение
Первый респондент обычно является первым объектом в цепочке респондента, который получит сообщение действия или событие. В большинстве случаев первый респондент является объектом представления, в котором пользователь выбирает или активируется с мышью или клавиатурой.
Можно использовать
firstResponder
метод в пользовательских подклассах классов респондента (NSWindow
,NSApplication
,NSView
, и подклассы), чтобы определить, является ли экземпляр подкласса в настоящее время первым респондентом. Можно также использовать его, чтобы помочь определить местоположение текстового поля, в настоящее время имеющего состояние первого респондента. Для больше на этом предмете, см. “Основы Обработки событий “.В OS X v10.6 и позже,
firstResponder
значение ключа, наблюдающее совместимый.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
– makeFirstResponder:
acceptsFirstResponder
(NSResponder
) -
Устанавливает высказанное мнение как то, которое это сделало первого респондента (также названным ключевым представлением) первым разом, когда окно помещается на экране.
Объявление
Swift
unowned(unsafe) var initialFirstResponder: NSView?
Objective C
@property(assign) NSView *initialFirstResponder
Параметры
view
Представление для создания первого респондента первым разом окно помещается на экране.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Попытки сделать данного респондента первым респондентом для окна.
Объявление
Swift
func makeFirstResponder(_
responder
: NSResponder?) -> BoolObjective C
- (BOOL)makeFirstResponder:(NSResponder *)
responder
Параметры
responder
Респондент для установки как первый респондент окна.
nil
делает окно его первым респондентом.Возвращаемое значение
YES
true
когда работа успешна; иначе,NO
false
.Обсуждение
Если
responder
уже не первый респондент, этот метод сначала отправляет aresignFirstResponder
обменивайтесь сообщениями к объекту, который является первым респондентом. Если тот объект отказывается уходить в отставку, это остается первым респондентом, и этот метод сразу возвращаетсяNO
false
. Если текущий первый респондент уходит в отставку, этот метод отправляет abecomeFirstResponder
сообщение кresponder
. Еслиresponder
не принимает первое состояние респондента,NSWindow
объект становится первым респондентом; в этом случае, возвраты методаYES
true
даже еслиresponder
отказывается от первого состояния респондента.Если
responder
nil
, этот метод все еще отправляетresignFirstResponder
текущему первому респонденту. Если текущий первый респондент отказывается уходить в отставку, это остается первым респондентом, и этот метод сразу возвращаетсяNO
false
. Если возвращается текущий первый респондентYES
true
отresignFirstResponder
, окно сделано его собственным первым респондентом и этим методом возвратамиYES
true
.Платформа Набора Приложения использует этот метод для изменения первого респондента в ответ на события mouseDown; можно также использовать его для явной установки первого респондента из программы.
responder
объект обычноNSView
объект в иерархии представления окна. Если этот метод вызывают явно, сначала отправьтеacceptsFirstResponder
кresponder
, и не вызывайтеmakeFirstResponder:
еслиacceptsFirstResponder
возвратыNO
false
.Использовать
setInitialFirstResponder:
к набору первый респондент, который будет использоваться, когда окно принесено на экране впервые.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
becomeFirstResponder
(NSResponder
)resignFirstResponder
(NSResponder
)
-
Делает ключ представлением, предшествующим высказанному мнению.
Объявление
Swift
func selectKeyViewPrecedingView(_
referenceView
: NSView)Objective C
- (void)selectKeyViewPrecedingView:(NSView *)
referenceView
Параметры
referenceView
Представление, предыдущее представление которого в ключевом цикле представления разыскивается.
Обсуждение
Отправляет
previousValidKeyView
сообщение кreferenceView
и, если то сообщение возвращаетсяNSView
возразите, вызываетmakeFirstResponder:
с возвращенным объектом.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Делает ключ представлением, следующим за высказанным мнением.
Объявление
Swift
func selectKeyViewFollowingView(_
referenceView
: NSView)Objective C
- (void)selectKeyViewFollowingView:(NSView *)
referenceView
Параметры
referenceView
Представление, разыскивается следование которого за представлением в ключевом цикле представления.
Обсуждение
Отправляет
nextValidKeyView
сообщение кreferenceView
и, если то сообщение возвращаетсяNSView
возразите, вызываетmakeFirstResponder:
с возвращенным объектом.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Этот метод действия ищет кандидата предыдущее ключевое представление и, если это находит один, вызывает
makeFirstResponder:
установить его как первого респондента.Объявление
Swift
func selectPreviousKeyView(_
sender
: AnyObject?)Objective C
- (void)selectPreviousKeyView:(id)
sender
Параметры
sender
Отправитель сообщения.
Обсуждение
Кандидат является одним из следующих (разыскиваемый в этом порядке):
Предыдущее допустимое ключевое представление текущего первого респондента, как возвращено
previousValidKeyView
методNSView
Объект, определяемый как начальный первый респондент окна (использование
setInitialFirstResponder:
) если это возвращаетсяYES
true
кacceptsFirstResponder
сообщениеИначе, предыдущее допустимое ключевое представление начального первого респондента, которое может закончить тем, что было
nil
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Этот метод действия ищет кандидата следующее ключевое представление и, если это находит один, вызывает
makeFirstResponder:
установить его как первого респондента.Объявление
Swift
func selectNextKeyView(_
sender
: AnyObject?)Objective C
- (void)selectNextKeyView:(id)
sender
Параметры
sender
Отправитель сообщения.
Обсуждение
Кандидат является одним из следующих (разыскиваемый в этом порядке):
Следующее допустимое ключевое представление текущего первого респондента, как возвращено
nextValidKeyView
методNSView
Объект, определяемый как начальный первый респондент окна (использование
setInitialFirstResponder:
) если это возвращаетсяYES
true
кacceptsFirstResponder
сообщениеИначе, следующее допустимое ключевое представление начального первого респондента, которое может закончить тем, что было
nil
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Возвращает направление, которое окно в настоящее время использует для изменения ключевого представления.
Объявление
Swift
var keyViewSelectionDirection: NSSelectionDirection { get }
Objective C
@property(readonly) NSSelectionDirection keyViewSelectionDirection
Возвращаемое значение
Направление окно использует для изменения ключевого представления.
Обсуждение
Это направление может быть одним из значений, описанных в NSSelectionDirection — Направление Ключевого Изменения Представления.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Указывает, повторно вычисляет ли окно автоматически ключевой цикл представления, когда добавляются представления.
Объявление
Swift
var autorecalculatesKeyViewLoop: Bool
Objective C
@property BOOL autorecalculatesKeyViewLoop
Возвращаемое значение
YES
true
когда представления добавляются, если окно автоматически повторно вычисляет ключевой цикл представления; иначе,NO
false
.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.4 и позже.
-
Отмечает ключевой цикл представления как грязный и нуждающийся в перерасчете.
Объявление
Swift
func recalculateKeyViewLoop()
Objective C
- (void)recalculateKeyViewLoop
Обсуждение
Ключевой цикл представления фактически повторно вычисляется в следующий раз, когда кто-то запрашивает следующее или предыдущее ключевое представление окна. Перерасчетный цикл основывается на геометрическом порядке представлений в окне.
Если Вы не хотите поддерживать ключевой цикл представления своего окна вручную, можно использовать этот метод, чтобы сделать это для Вас. Когда это сначала загружается,
NSWindow
вызовы этот метод автоматически, если Ваше окно уже не имеет ключевого цикла представления установленным. Если Вы добавляете или удаляете представления позже, можно вызвать этот метод вручную для обновления ключевого цикла представления окна. Можно также вызватьsetAutorecalculatesKeyViewLoop:
для имения окна повторно вычисляют цикл автоматически.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.4 и позже.
-
Указывает, повторно вычислить ли ключевой цикл представления автоматически, когда представления добавлены или удалены.
Объявление
Swift
var autorecalculatesKeyViewLoop: Bool
Objective C
@property BOOL autorecalculatesKeyViewLoop
Параметры
autorecalculateKeyViewLoop
Если
YES
true
, окно повторно вычисляет ключевой цикл представления автоматически; еслиNO
false
, это не делает.Обсуждение
Если
autorecalculateKeyViewLoop
NO
false
, клиентский код должен обновить ключевой цикл представления вручную или вызовrecalculateKeyViewLoop
для имения окна повторно вычисляют его.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.4 и позже.
-
Обрабатывает данное событие клавиатуры, которое, возможно, должно быть интерпретировано как изменение ключевого представления или инициирование эквивалента клавиатуры.
Параметры
event
Событие клавиатуры для обработки.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
– selectNextKeyView:
nextKeyView
(NSView
)performMnemonic:
(NSView
)
-
Указывает, принимает ли окно перемещенные в мышь события.
Объявление
Swift
var acceptsMouseMovedEvents: Bool
Objective C
@property BOOL acceptsMouseMovedEvents
Возвращаемое значение
YES
true
когда окно принимает (и распределяет), перемещенные в мышь события; иначе,NO
false
.Обсуждение
NSWindow
значение по умолчаниюNO
false
.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Указывает, очевидно ли окно для событий от нажатия мыши.
Объявление
Swift
var ignoresMouseEvents: Bool
Objective C
@property BOOL ignoresMouseEvents
Возвращаемое значение
YES
true
когда окно очевидно для событий от нажатия мыши; иначе,NO
false
.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.2 и позже.
См. также
-
Указывает, очевидно ли окно для щелчков мышью и других событий от нажатия мыши, позволяя окна наложения.
Объявление
Swift
var ignoresMouseEvents: Bool
Objective C
@property BOOL ignoresMouseEvents
Параметры
ignoreMouseEvents
Если
YES
true
, окно проигнорирует события от нажатия мыши; еслиNO
false
, это не будет.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.2 и позже.
См. также
-
Возвращается текущее расположение указателя учло основную систему координат окна.
Объявление
Swift
var mouseLocationOutsideOfEventStream: NSPoint { get }
Objective C
@property(readonly) NSPoint mouseLocationOutsideOfEventStream
Возвращаемое значение
Текущее расположение указателя учло основную систему координат окна, независимо от обрабатываемого текущего события или любого ожидания событий.
Обсуждение
Для той же информации в координатах экрана использовать
NSEvent
mouseLocation
.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
currentEvent
(NSApplication
) -
Указывает, должно ли окно принять перемещенные в мышь события.
Объявление
Swift
var acceptsMouseMovedEvents: Bool
Objective C
@property BOOL acceptsMouseMovedEvents
Параметры
acceptMouseMovedEvents
YES
true
для имения окна принимают перемещенные в мышь события (и распределять их его респондентам);NO
false
не принять такие события.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
windowNumberAtPoint (_: belowWindowWithWindowNumber:) + windowNumberAtPoint:belowWindowWithWindowNumber:
Возвращает число frontmost окна, которое было бы поражено мышью вниз в указанном расположении на экране.
Объявление
Параметры
point
Расположение мыши вниз в координатах экрана.
windowNumber
Если не0, поиск запустится ниже
windowNumber
окно в z-порядке.Возвращаемое значение
Число окна окна под точкой. Число окна возвратилось, может соответствовать окну в другом приложении.
Обсуждение
Поскольку этот метод использует те же правила в качестве тестирования хита мыши вниз, окна с прозрачностью в данной точке и окна, игнорирующие события от нажатия мыши, не будут возвращены.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.6 и позже.
-
Указывает, сохраняется ли конфигурация окна между запусками приложения.
Объявление
Swift
var restorable: Bool
Objective C
@property(getter=isRestorable) BOOL restorable
Параметры
flag
Указать
YES
true
если Вы хотите, чтобы окно было сохранено илиNO
false
если Вы не хотите сохраненный.Обсуждение
Windows должен быть сохранен между циклами запуска для поддержания интерфейсной непрерывности для пользователя. Во время последующих циклов запуска система пытается воссоздать окно и восстановить его конфигурацию к сохраненному состоянию. Данные конфигурации обновляются по мере необходимости и сохраняются автоматически системой.
При включении сохранения для данного окна необходимо также указать класс восстановления для окна с помощью
setRestorationClass:
метод.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.7 и позже.
См. также
-
isRestorable - isRestorable
Доступный в OS X v10.7 через OS X v10.9Возвращает булево значение, указывающее, сохраняется ли конфигурация окна между запусками приложения.
Объявление
Objective C
- (BOOL)isRestorable
Возвращаемое значение
YES
true
если конфигурация окна сохраняется илиNO
false
если это не.Обсуждение
По умолчанию, этот метод возвраты
YES
true
если окноstyleMask
свойство включаетNSTitledWindowMask
флаг. Для других окон, этот метод возвратыNO
false
. Указание значения явно с помощьюsetRestorable:
метод переопределяет значения по умолчанию.Оператор импорта
Objective C
@import AppKit;
Доступность
Доступный в OS X v10.7 через OS X v10.9.
-
Указывает класс для использования для получения соответствующего объекта окна во время последующих запусков.
Объявление
Swift
var restorationClass: AnyObject.Type?
Objective C
@property(assign) Class<NSWindowRestoration> restorationClass
Параметры
restorationClass
Объект класса, соответствующий
NSWindowRestoration
протокол. AppKit использует этот объект обработать воссоздание объекта окна позже.Обсуждение
Класс восстановления окна ответственен за воссоздание не только, окно, но и любые другие объекты должно было управлять окном. Это почти всегда включает создание контроллера окна, и для приложений документа мультиокна также включает создание объекта документа. Поэтому класс восстановления должен быть в состоянии создать (или найти существующие экземпляры) все эти объекты во время запуска в Вашем приложении.
Если Вы отмечаете свои окна как восстановимые, необходимо связать класс восстановления с ними. Для приложений документа мультиокна AppKit связывается
NSDocumentController
класс с любыми окнами документа по умолчанию. Тот класс воссоздает сохраненные объекты документа, поочередно воссоздающие соответствующий контроллер окна и объекты окна. Для других типов окон необходимо установить класс восстановления явно.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.7 и позже.
См. также
-
Возвращает класс восстановления, связанный с окном.
Объявление
Swift
var restorationClass: AnyObject.Type?
Objective C
@property(assign) Class<NSWindowRestoration> restorationClass
Возвращаемое значение
Объект класса, соответствующий классу для использования для восстановления окна или
nil
если ни один не установлен.Обсуждение
Классы восстановления помогают в воссоздании объектов окна во время последующих запусков приложения. Когда запрошено AppKit, класс восстановления создает или получает окно, соответствующее тот же сохраненный тип. Это тогда пасует назад то окно к AppKit, продолжающемуся для реконфигурирования окна с сохраненной информацией состояния.
Для приложений документа мультиокна этот метод возвращается
NSDocumentController
класс для окон, связанных сNSDocument
объект по умолчанию. Для других типов окон, этот метод возвратыnil
по умолчанию.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.7 и позже.
См. также
-
Отключите восстановление снимка.
Объявление
Swift
func disableSnapshotRestoration()
Objective C
- (void)disableSnapshotRestoration
Обсуждение
В то время как восстановление снимка отключено, окно не будет создано снимки для восстановимого состояния.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.7 и позже.
См. также
-
Включите восстановление снимка.
Объявление
Swift
func enableSnapshotRestoration()
Objective C
- (void)enableSnapshotRestoration
Обсуждение
В то время как восстановление снимка включено, окно будет создано снимки для восстановимого состояния.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.7 и позже.
См. также
-
Хранит растровое изображение окна от данного прямоугольника, выраженного в основной системе координат окна.
Объявление
Swift
func cacheImageInRect(_
rectangle
: NSRect)Objective C
- (void)cacheImageInRect:(NSRect)
rectangle
Параметры
rectangle
Прямоугольник, представляющий изображение для кэширования.
Обсуждение
Этот метод позволяет окну выполнять временное получение, такое как полоса вокруг выбора, поскольку пользователь перетаскивает мышь, и быстро восстановить предыдущее изображение путем вызова
restoreCachedImage
иflushWindowIfNeeded
. В следующий раз дисплеи окна, это отбрасывает свои кэшируемые прямоугольники изображения. Можно также явно использоватьdiscardCachedImage
освободить память, занятую кэшируемыми прямоугольниками изображения.aRect
сделан интегралом прежде, чем кэшировать изображение, чтобы избежать сглаживать артефакты.Только последний кэшируемый прямоугольник помнят и можно восстановить.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Соединяет кэшируемые прямоугольники изображения окна, если таковые имеются, назад в его растровое изображение (и буфер, если он имеет один), отменяя эффект любого получения, выполняемого в тех областях, так как они были установлены с помощью
cacheImageInRect:
.Объявление
Swift
func restoreCachedImage()
Objective C
- (void)restoreCachedImage
Обсуждение
Необходимо вызвать
flushWindow
после этого метода для гарантии надлежащий восстанавливают изображение.NSWindow
возразите автоматически отбрасывает его кэшируемые прямоугольники изображения, когда это выводит на экран.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Отбрасывания все кэшируемые прямоугольники изображения окна.
Объявление
Swift
func discardCachedImage()
Objective C
- (void)discardCachedImage
Обсуждение
NSWindow
возразите автоматически отбрасывает его кэшируемые прямоугольники изображения, когда это выводит на экран.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Передает сообщение дисплея вниз иерархия представления окна, таким образом перерисовывая все представления в окне, включая представление кадра, рисующее границу, строку заголовка и другие периферийные элементы.
Объявление
Swift
func display()
Objective C
- (void)display
Обсуждение
Редко необходимо вызывать этот метод.
NSWindow
объекты обычно записывают, какое из их представлений должно вывести на экран и вывести на экран их автоматически на каждом, проходят через цикл событий.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Передачи a
displayIfNeeded
передайте вниз иерархию представления окна, таким образом перерисовав все представления, которые должны быть выведены на экран, включая представление кадра, рисующее границу, строку заголовка и другие периферийные элементы.Объявление
Swift
func displayIfNeeded()
Objective C
- (void)displayIfNeeded
Обсуждение
Этот метод полезен, когда Вы хотите изменить некоторое число представлений и затем вывести на экран только тех, которые были изменены.
Редко необходимо вызывать этот метод.
NSWindow
объекты обычно записывают, какое из их представлений должно вывести на экран и вывести на экран их автоматически на каждом, проходят через цикл событий.