Ссылка функций AppKit

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

Функции

Доступность

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

NSAccessibilityActionDescription (_:) NSAccessibilityActionDescription

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

Объявление

Swift

func NSAccessibilityActionDescription(_ action: String!) -> String!

Objective C

NSString * NSAccessibilityActionDescription ( NSString *action );

Обсуждение

Эта функция возвращает стандартное описание для action.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

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

Объявление

Swift

func NSAccessibilityPostNotification(_ element: AnyObject!, _ notification: String!)

Objective C

void NSAccessibilityPostNotification ( id element, NSString *notification );

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

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

Объявление

Swift

func NSAccessibilityPostNotificationWithUserInfo(_ element: AnyObject!, _ notification: String!, _ userInfo: [NSObject : AnyObject]!)

Objective C

void NSAccessibilityPostNotificationWithUserInfo ( id element, NSString *notification, NSDictionary *userInfo );

Обсуждение

Отправляет notification и userInfo к любым вспомогательным приложениям, зарегистрировавшимся для получения уведомления из объекта пользовательского интерфейса element в Вашем приложении. userInfo значения словаря ограничиваются теми же значениями, которыми ограничиваются атрибуты доступности (для списка этих значений, посмотрите Атрибуты). userInfo словарь может также быть nil (большинство уведомлений доступности не требует его).

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

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

Объявление

Swift

func NSAccessibilityRaiseBadArgumentException(_ element: AnyObject!, _ attribute: String!, _ value: AnyObject!)

Objective C

void NSAccessibilityRaiseBadArgumentException ( id element, NSString *attribute, id value );

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

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

Объявление

Swift

func NSAccessibilityRoleDescription(_ role: String!, _ subrole: String!) -> String!

Objective C

NSString * NSAccessibilityRoleDescription ( NSString *role, NSString *subrole );

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

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

Объявление

Swift

func NSAccessibilityRoleDescriptionForUIElement(_ element: AnyObject!) -> String!

Objective C

NSString * NSAccessibilityRoleDescriptionForUIElement ( id element );

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Наборы возможно, ли приложение, защитило содержание.

Объявление

Swift

func NSAccessibilitySetMayContainProtectedContent(_ flag: Bool) -> Bool

Objective C

BOOL NSAccessibilitySetMayContainProtectedContent ( BOOL flag );

Обсуждение

Использует значение flag указать возможно, ли приложение, защитило содержание. Защищенное содержание идентифицируется значением YEStrue для NSAccessibilityContainsProtectedContentAttribute, но если NSAccessibilitySetMayContainProtectedContent возвраты NOfalse, значение NSAccessibilityContainsProtectedContentAttribute проигнорирован. Эта функция возвраты YEStrue на успехе.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

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

Объявление

Swift

func NSAccessibilityUnignoredChildren(_ originalChildren: [AnyObject]!) -> [AnyObject]!

Objective C

NSArray * NSAccessibilityUnignoredChildren ( NSArray *originalChildren );

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

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

Объявление

Swift

func NSAccessibilityUnignoredChildrenForOnlyChild(_ originalChild: AnyObject!) -> [AnyObject]!

Objective C

NSArray * NSAccessibilityUnignoredChildrenForOnlyChild ( id originalChild );

Обсуждение

Тесты, ли originalChild проигнорированный объект и возвращает массив, содержащий также originalChild, если это не проигнорировано, или его непроигнорированные потомки.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

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

Объявление

Swift

func NSAccessibilityUnignoredDescendant(_ element: AnyObject!) -> AnyObject!

Objective C

id NSAccessibilityUnignoredDescendant ( id element );

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

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

Объявление

Swift

func NSAccessibilityUnignoredAncestor(_ element: AnyObject!) -> AnyObject!

Objective C

id NSAccessibilityUnignoredAncestor ( id element );

Обсуждение

Тесты, ли element проигнорированный объект, возвращаясь также element, если это не проигнорировано, или первый непроигнорированный наследователь element.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Возвращает кадр в координатах экрана.

Объявление

Swift

func NSAccessibilityFrameInView(_ parentView: NSView!, _ frame: NSRect) -> NSRect

Objective C

NSRect NSAccessibilityFrameInView ( NSView *parentView, NSRect frame );

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Возвращает точку в координатах экрана.

Объявление

Swift

func NSAccessibilityPointInView(_ parentView: NSView!, _ point: NSPoint) -> NSPoint

Objective C

NSPoint NSAccessibilityPointInView ( NSView *parentView, NSPoint point );

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Приложения

Дополнительная информация о NSApplication может быть найден в Ссылке класса NSApplication.

NSApplicationLoad () NSApplicationLoad

Функция запуска для вызова при выполнении Какао кодирует из приложения Углерода.

Объявление

Swift

func NSApplicationLoad() -> Bool

Objective C

BOOL NSApplicationLoad ( void );

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

YEStrue если NSApplication объект был успешно инициализирован и может теперь использоваться из Вашего приложения Углерода или NOfalse если была ошибка во время инициализации.

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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


    
    NSApplicationMain (_: _:)
    NSApplicationMain

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

Объявление

Swift

func NSApplicationMain(_ argc: Int32, _ argv: UnsafeMutablePointer<UnsafePointer<Int8>>) -> Int32

Objective C

int NSApplicationMain ( int argc, const char *argv[] );

Параметры

`argc`	Число параметров в argv параметре.
`argv`	Массив указателей, содержащих параметры, переданные приложению при запуске.

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

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

Обсуждение

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

Специальные замечания

NSApplicationMain самостоятельно игнорирует argc и argv параметры. Вместо этого Какао получает свои параметры косвенно через _NSGetArgv, _NSGetArgc, и _NSGetEnviron (см. <crt_externs.h>).

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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


    
    NSPerformService (_: _:)
    NSPerformService

Программно вызывает службу меню Services.

Объявление

Swift

func NSPerformService(_ itemName: String!, _ pboard: NSPasteboard!) -> Bool

Objective C

BOOL NSPerformService ( NSString *itemName, NSPasteboard *pboard );

Параметры

`itemName`	Указывает пункт меню Services, на любом языке. Если требуемая служба из подменю меню Services, значение должно содержать наклонную черту (например, «Почта/Выбор»).
`pboard`	Область монтажа, содержащая данные, требуется службой. Эти данные должны присутствовать для службы для следования. На выводе эта область монтажа содержит данные, возвращенные поставщиком услуг.

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

YEStrue если служба успешно выполнялась или NOfalse если это не было.

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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


    
    NSRegisterServicesProvider (_: _:)
    NSRegisterServicesProvider

Регистрирует поставщика услуг.

Объявление

Swift

func NSRegisterServicesProvider(_ provider: AnyObject!, _ name: String!)

Objective C

void NSRegisterServicesProvider ( id provider, NSString *name );

Параметры

`provider`	Объект, предоставляющий услугу, Вы хотите зарегистрироваться.
`name`	Уникальное имя для соединения со службой. Эта строка используется для распространения службы заинтересованным клиентам.

Обсуждение

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

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

NSSetShowsServicesMenuItem (_: _:) NSSetShowsServicesMenuItem

Указывает, должен ли элемент быть включен в меню Services.

Объявление

Swift

func NSSetShowsServicesMenuItem(_ itemName: String!, _ enabled: Bool) -> Int

Objective C

NSInteger NSSetShowsServicesMenuItem ( NSString *itemName, BOOL enabled );

Обсуждение

Осуждаемый. Эта функция просто возвращается 0.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

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

Объявление

Swift

func NSShowsServicesMenuItem(_ itemName: String!) -> Bool

Objective C

BOOL NSShowsServicesMenuItem ( NSString *itemName );

Обсуждение

Осуждаемый. Эта функция просто возвращается YEStrue.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Не регистрирует поставщика услуг.

Объявление

Swift

func NSUnregisterServicesProvider(_ name: String!)

Objective C

void NSUnregisterServicesProvider ( NSString *name );

Параметры

name

Имя службы Вы хотите не зарегистрироваться.

Обсуждение

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

Вы не должны использовать эту функцию, чтобы не зарегистрировать услуги, предоставленные Вашим приложением. Для служб Вашего приложения необходимо использовать setServicesProvider: метод NSApplication, передача a nil параметр.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Заставляет информацию о службах для системы быть обновленной.

Объявление

Swift

func NSUpdateDynamicServices()

Objective C

void NSUpdateDynamicServices ( void );

Обсуждение

Используемый обеспечивающим службу приложением, чтобы повторно зарегистрировать службы это готово обеспечить. Чтобы сделать это, Вы создаете пакет с расширением “.service” и поместите его в путь приложения или ~/Library/Services. Содержание пакета идентично нормальному пакету службы. Вы тогда вызываете эту функцию.

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Создание словаря

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

Объявление

Objective C

#define NSDictionaryOfVariableBindings(...) _NSDictionaryOfVariableBindings(@"" # __VA_ARGS__, __VA_ARGS__, nil)
Обсуждение

Когда создание Автоматических Ограничений макета — видит Автоматическое Руководство по Расположению, этот макрос особенно полезен. Например, следующий код:
NSDictionary *viewsDictionary = NSDictionaryOfVariableBindings(button1, button2);
создает словарь { @"button1" = button1, @"button2 = button2 }.
Оператор импорта

Objective C

@import AppKit;

Доступность

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

События

NSEventMaskFromType (_:) NSEventMaskFromType

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

Объявление

Swift

func NSEventMaskFromType(_ type: NSEventType) -> NSEventMask

Objective C

NSEventMask NSEventMaskFromType ( NSEventType type );

Параметры

type

Тип события, маску которого Вы хотите получить.

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

Маска события, соответствующая указанному типу. Возвращенная маска эквивалентна номеру 1, лево-смещенному на type биты.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Шрифты

NSConvertGlyphsToPackedGlyphs (_: _: _: _:) NSConvertGlyphsToPackedGlyphs

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

Объявление

Swift

func NSConvertGlyphsToPackedGlyphs(_ glBuf: UnsafeMutablePointer<NSGlyph>, _ count: Int, _ packing: NSMultibyteGlyphPacking, _ packedGlyphs: UnsafeMutablePointer<Int8>) -> Int

Objective C

NSInteger NSConvertGlyphsToPackedGlyphs ( NSGlyph *glBuf, NSInteger count, NSMultibyteGlyphPacking packing, char *packedGlyphs );

Обсуждение

Берет буфер глифов, указанных в glBuf параметр, и упаковывает их в сжатый символьный массив. Символьный массив возвращается в packedGlyphs параметр, который должен иметь достаточно пространства для, по крайней мере ((4 * количество) + 1) байты, чтобы гарантировать, что соответствуют упакованные глифы. count указывает число глифов в glBuf. packing указывает, как в настоящее время упаковываются глифы.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Графика

NSCopyBits (_: _: _:) NSCopyBits (OS X v10.10)

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

Объявление

Swift

func NSCopyBits(_ srcGState: Int, _ srcRect: NSRect, _ destPoint: NSPoint)

Objective C

void NSCopyBits ( NSInteger srcGState, NSRect srcRect, NSPoint destPoint );

Обсуждение

Копирует пиксели в прямоугольнике, указанном srcRect к расположению, указанному destPoint. Исходный прямоугольник определяется в состоянии графики, определяемом srcGState. Если srcGState NSNullObject, текущее состояние графики принято. destPoint место назначения определяется в текущем состоянии графики.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Считает число экранных окон.

Объявление

Objective C

void NSCountWindows ( NSInteger *count );

Параметры

count

На выводе этот параметр содержит число экранных окон.

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

Objective C

@import AppKit;

Доступность

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

Считает число экранных окон, принадлежащих определенному приложению.

Объявление

Objective C

void NSCountWindowsForContext ( NSInteger context, NSInteger *count );

Обсуждение

Считает число экранных окон, принадлежащих определенному приложению, идентифицированному context, который является серверным соединением окна ID. Функция возвращает число ссылкой в count.

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

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

Objective C

@import AppKit;

Доступность

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

Отключает экранные обновления.

Объявление

Swift

func NSDisableScreenUpdates()

Objective C

void NSDisableScreenUpdates ( void );

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Включает экранные обновления

Объявление

Swift

func NSEnableScreenUpdates()

Objective C

void NSEnableScreenUpdates ( void );

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Рисует ограниченный прямоугольник.

Объявление

Swift

func NSDottedFrameRect(_ aRect: NSRect)

Objective C

void NSDottedFrameRect ( NSRect aRect );

Обсуждение

Осуждаемый. Используйте штриховое NSBezierPath вместо этого.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

NSDrawTiledRects
NSDrawBitmap (_: _: _: _: _: _: _: _: _: _: _:) NSDrawBitmap

Составляет растровое изображение.

Объявление

Swift

func NSDrawBitmap(_ rect: NSRect, _ width: Int, _ height: Int, _ bps: Int, _ spp: Int, _ bpp: Int, _ bpr: Int, _ isPlanar: Bool, _ hasAlpha: Bool, _ colorSpaceName: String!, _ data: UnsafePointer<UnsafePointer<UInt8>>)

Objective C

void NSDrawBitmap ( NSRect rect, NSInteger width, NSInteger height, NSInteger bps, NSInteger spp, NSInteger bpp, NSInteger bpr, BOOL isPlanar, BOOL hasAlpha, NSString *colorSpaceName, const unsigned char *const data[5] );

Обсуждение

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

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

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

Остающиеся параметры описывают растровые данные, как объяснено в следующих параграфах.

bitsPerSample параметром является число битов на выборку для каждого пикселя и samplesPerPixel число выборок на пиксель. bitsPerPixel основывается samplesPerPixel и конфигурация битового массива: если конфигурация является планарной, то значение bitsPerPixel должен равняться значению bitsPerSample; если конфигурация не является планарной (пойман в сети вместо этого), bitsPerPixel должен равняться bitsPerSample * samplesPerPixel.

bytesPerRow параметр вычисляется одним из двух способов, в зависимости от конфигурации данных изображения (конфигурация данных описана ниже). Если данные являются планарными, bytesPerRow is (7 + (pixelsWide * bitsPerSample)) / 8. Если данные пойманы в сети, bytesPerRow is (7 + (pixelsWide * bitsPerSample * samplesPerPixel)) / 8.

Выборка является данными, описывающими один компонент пикселя. В цветовой системе RGB красные, зеленые, и синие компоненты цвета указаны как отдельные выборки, как голубые, пурпурные, желтые, и черные компоненты в системе CMYK. Значения цвета в шкале полутонов являются единственной выборкой. Альфа-значения, определяющие прозрачность и непрозрачность, указаны как выборка покрытия, отдельная от цвета. В растровых изображениях с альфой цвет (или серый) компоненты должны быть предварительно умножены с альфой. Это - способ, которым выведены на экран изображения с альфой, это - способ, которым они читаются назад, и это - способ, которым они сохранены в TIFFs.

isPlanar параметр относится к способу, которым данные сконфигурированы в битовом массиве. Этот флаг должен быть установлен в YEStrue если отдельный канал передачи данных используется для каждой выборки. Функция предусматривает до пяти каналов, data1, data2, data3, data4, и data5. Это должно быть установлено NOfalse если демонстрационные значения вплетены в единственном (пойманном в сети) канале; все значения для одного пикселя указаны перед значениями для следующего пикселя.

Полутоновые окна хранят пиксельные данные в планарной конфигурации; окна цвета хранят его в решетчатой конфигурации. NSDrawBitmap может представить пойманные в сети данные в планарном окне или планарные данные в решетчатом окне. Однако более эффективно, если изображение имеет глубину (bitsPerSample) и конфигурация (isPlanar) то соответствие окно.

hasAlpha параметр указывает, содержит ли изображение альфу. Если это делает, число выборок должно быть 1 большим, чем число компонентов цвета в модели (например, 4 для RGB).

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

Если данные изображения являются планарными, data[0] через data[samplesPerPixel– 1] укажите на плоскости; если data пойман в сети, только data[0] потребности, которые будут установлены.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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


    
    NSDrawButton (_: _:)
    NSDrawButton

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

Объявление

Swift

func NSDrawButton(_ aRect: NSRect, _ clipRect: NSRect)

Objective C

void NSDrawButton ( NSRect aRect, NSRect clipRect );

Параметры

`aRect`	Ограничительный прямоугольник (в текущей системе координат), в котором можно нарисовать. Только те части `aRect` та ложь в `clipRect` фактически нарисованы.
`clipRect`	Прямоугольник отсечения для использования во время получения.

Обсуждение

Рисует серо-заполненный прямоугольник, используемый для выражения кнопки пользовательского интерфейса. Так как эта функция часто используется для рисования границы представления, aRect параметр обычно содержит прямоугольник границ представления. Для кнопки Aqua используйте NSButton объект вместо этого.

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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


    
    NSDrawDarkBezel (_: _:)
    NSDrawDarkBezel

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

Объявление

Swift

func NSDrawDarkBezel(_ aRect: NSRect, _ clipRect: NSRect)

Objective C

void NSDrawDarkBezel ( NSRect aRect, NSRect clipRect );

Параметры

`aRect`	Ограничительный прямоугольник (в текущей системе координат), в котором можно нарисовать. Только те части `aRect` та ложь в `clipRect` фактически нарисованы.
`clipRect`	Прямоугольник отсечения для использования во время получения.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

NSDrawTiledRects


    
    NSDrawGrayBezel (_: _:)
    NSDrawGrayBezel

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

Объявление

Swift

func NSDrawGrayBezel(_ aRect: NSRect, _ clipRect: NSRect)

Objective C

void NSDrawGrayBezel ( NSRect aRect, NSRect clipRect );

Параметры

`aRect`	Ограничительный прямоугольник (в текущей системе координат), в котором можно нарисовать. Только те части `aRect` та ложь в `clipRect` фактически нарисованы.
`clipRect`	Прямоугольник отсечения для использования во время получения.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

NSDrawTiledRects


    
    NSDrawGroove (_: _:)
    NSDrawGroove

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

Объявление

Swift

func NSDrawGroove(_ aRect: NSRect, _ clipRect: NSRect)

Objective C

void NSDrawGroove ( NSRect aRect, NSRect clipRect );

Параметры

`aRect`	Ограничительный прямоугольник (в текущей системе координат), в котором можно нарисовать. Только те части `aRect` та ложь в `clipRect` фактически нарисованы.
`clipRect`	Прямоугольник отсечения для использования во время получения.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

NSDrawTiledRects


    
    NSDrawLightBezel (_: _:)
    NSDrawLightBezel

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

Объявление

Swift

func NSDrawLightBezel(_ aRect: NSRect, _ clipRect: NSRect)

Objective C

void NSDrawLightBezel ( NSRect aRect, NSRect clipRect );

Параметры

`aRect`	Ограничительный прямоугольник (в текущей системе координат), в котором можно нарисовать. Только те части `aRect` та ложь в `clipRect` фактически нарисованы.
`clipRect`	Прямоугольник отсечения для использования во время получения.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

NSDrawTiledRects


    
    NSDrawThreePartImage (_: _: _: _: _: _: _: _:)
    NSDrawThreePartImage

Рисует трехчастное мозаичное изображение.

Объявление

Swift

func NSDrawThreePartImage(_ frame: NSRect, _ startCap: NSImage!, _ centerFill: NSImage!, _ endCap: NSImage!, _ vertical: Bool, _ op: NSCompositingOperation, _ alphaFraction: CGFloat, _ flipped: Bool)

Objective C

void NSDrawThreePartImage ( NSRect frame, NSImage *startCap, NSImage *centerFill, NSImage *endCap, BOOL vertical, NSCompositingOperation op, CGFloat alphaFraction, BOOL flipped );

Параметры

`frame`	Прямоугольник (указанный в текущей системе координат), в котором можно нарисовать изображения.
`startCap`	Для горизонтального трехчастного изображения это - изображение, расположенное в левом краю прямоугольника кадра. Для вертикального трехчастного изображения это изображение появляется наверху экрана в незеркально отраженной системе координат и внизу экрана в зеркально отраженной системе координат.
`centerFill`	Изображение раньше размещало пространство рядом между `startCap` и `endCap` изображения.
`endCap`	Для горизонтального трехчастного изображения это - изображение, расположенное в правом краю прямоугольника кадра. Для вертикального трехчастного изображения это изображение появляется внизу экрана в незеркально отраженной системе координат и наверху экрана в зеркально отраженной системе координат.
`vertical`	Указать `YEStrue` если изображения должны быть сложены поверх друг друга для создания вертикально ориентированного элемента. Указать `NOfalse` если изображения должны быть размечены бок о бок для создания горизонтально ориентированного элемента.
`op`	Составляющая композит работа для использования при рендеринге изображений.
`alphaFraction`	Альфа-значение для применения к представленному изображению. Это значение может расположиться между 0,0 и 1.0, с 0,0 являющийся полностью прозрачным и 1.0 являющийся полностью непрозрачным.
`flipped`	Указать `YEStrue` если Вы рисуете изображения в зеркально отраженной системе координат; иначе, указать `NOfalse`.

Обсуждение

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

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

При рисовании горизонтально ориентированного управления, изображений в startCap, centerFill, и endCap параметры должны все иметь ту же высоту, и та высота должна соответствовать высоту прямоугольника кадра. Если высота изображения не соответствует высоту прямоугольника кадра, это масштабируется, пока это действительно не соответствует, который мог бы привести к менее желательным результатам. Для вертикально ориентированных средств управления ширины изображения масштабируются вместо высот.

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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


    
    NSDrawNinePartImage (_: _: _: _: _: _: _: _: _: _: _: _: _:)
    NSDrawNinePartImage

Рисует мозаичное изображение с девятью частями.

Объявление

Swift

func NSDrawNinePartImage(_ frame: NSRect, _ topLeftCorner: NSImage!, _ topEdgeFill: NSImage!, _ topRightCorner: NSImage!, _ leftEdgeFill: NSImage!, _ centerFill: NSImage!, _ rightEdgeFill: NSImage!, _ bottomLeftCorner: NSImage!, _ bottomEdgeFill: NSImage!, _ bottomRightCorner: NSImage!, _ op: NSCompositingOperation, _ alphaFraction: CGFloat, _ flipped: Bool)

Objective C

void NSDrawNinePartImage ( NSRect frame, NSImage *topLeftCorner, NSImage *topEdgeFill, NSImage *topRightCorner, NSImage *leftEdgeFill, NSImage *centerFill, NSImage *rightEdgeFill, NSImage *bottomLeftCorner, NSImage *bottomEdgeFill, NSImage *bottomRightCorner, NSCompositingOperation op, CGFloat alphaFraction, BOOL flipped );

Параметры

`frame`	Прямоугольник (указанный в текущей системе координат), в котором можно нарисовать изображения.
`topLeftCorner`	Изображение для отображения в верхнем левом углу.
`topEdgeFill`	Изображение раньше размещало пространство рядом между `topLeftCorner` и `topRightCorner` изображения.
`topRightCorner`	Изображение для отображения в верхнем правом углу.
`leftEdgeFill`	Изображение раньше размещало пространство рядом между `topLeftCorner` и `bottomLeftCorner` изображения.
`centerFill`	Изображение раньше размещало центральную область рядом между другими восемью изображениями.
`rightEdgeFill`	Изображение раньше размещало пространство рядом между `topRightCorner` и `bottomRightCorner` изображения.
`bottomLeftCorner`	Изображение для отображения в нижнем левом углу.
`bottomEdgeFill`	Изображение раньше размещало пространство рядом между `bottomLeftCorner` и `bottomRightCorner` изображения.
`bottomRightCorner`	Изображение для отображения в нижнем правом углу.
`op`	Составляющая композит работа для использования при рендеринге изображений.
`alphaFraction`	Альфа-значение для применения к представленному изображению. Это значение может расположиться между 0,0 и 1.0, с 0,0 являющийся полностью прозрачным и 1.0 являющийся полностью непрозрачным.
`flipped`	Указать `YEStrue` если Вы рисуете изображения в зеркально отраженной системе координат; иначе, указать `NOfalse`.

Обсуждение

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

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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


    
    NSDrawTiledRects (_: _: _: _: _:)
    NSDrawTiledRects

Рисует прямоугольники с границами.

Объявление

Swift

func NSDrawTiledRects(_ boundsRect: NSRect, _ clipRect: NSRect, _ sides: UnsafePointer<NSRectEdge>, _ grays: UnsafePointer<CGFloat>, _ count: Int) -> NSRect

Objective C

NSRect NSDrawTiledRects ( NSRect boundsRect, NSRect clipRect, const NSRectEdge *sides, const CGFloat *grays, NSInteger count );

Параметры

`boundsRect`	Ограничительный прямоугольник (в текущей системе координат), в котором можно нарисовать. Так как эта функция часто используется для рисования границы представления, этот прямоугольник обычно будет то, что прямоугольник границ представления. Только те части `boundsRect` та ложь в `clipRect` фактически нарисованы.
`clipRect`	Прямоугольник отсечения для использования во время получения.
`sides`	Стороны прямоугольника, для которого Вы хотите указать пользовательские уровни серого. Каждая сторона должна иметь соответствующую запись в `grays` параметр.
`grays`	Уровни серого для рисования для каждого из краев, перечисленных в `sides` параметр.
`count`	Число частей с 1.0 единицами в ширину для привлечения указанных сторон.

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

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

Обсуждение

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

sides, grays, и count параметры определяют, насколько толстый граница и какие уровни серого используются для формирования ее. Эта функция использует NSDivideRect функционируйте для взятия последовательных частей с 1.0 единицами в ширину со сторон прямоугольника, указанного sides параметр. Каждая часть нарисована с помощью соответствующего уровня серого из grays параметр. Эта функция делает и рисует эти части count число раз. При указании той же стороны несколько раз вторая часть нарисована в первом.

Следующий пример использует эту функцию для рисования границы bezeled, состоящей из белой строки с 1.0 единицами в ширину наверху и на левой стороне и темно-серой строки с 1.0 единицами в ширину в черном пятне с 1.0 единицами в ширину на других двух сторонах. Получающийся прямоугольник в этой границе тогда заполнен в использовании светло-серого.

      NSRectEdge mySides[] = {NSMinYEdge, NSMaxXEdge, NSMaxYEdge, NSMinXEdge,
                        NSMinYEdge, NSMaxXEdge};
float myGrays[] = {NSBlack, NSBlack, NSWhite, NSWhite,
                        NSDarkGray, NSDarkGray};
NSRect aRect, clipRect; // Assume exists
 
aRect = NSDrawTiledRects(aRect, clipRect, mySides, myGrays, 6);
[[NSColor grayColor] set];
NSRectFill(aRect);


  

В предыдущем примере, mySides массив, указывающий стороны прямоугольника; например, NSMinYEdge выбирает сторону, параллельную оси X с самым маленьким значением координаты y. myGrays массив, указывающий последовательные уровни серого, которые будут использоваться в рисовании частей границы.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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


    
    NSDrawColorTiledRects (_: _: _: _: _:)
    NSDrawColorTiledRects

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

Объявление

Swift

func NSDrawColorTiledRects(_ boundsRect: NSRect, _ clipRect: NSRect, _ sides: UnsafePointer<NSRectEdge>, _ colors: AutoreleasingUnsafeMutablePointer<NSColor?>, _ count: Int) -> NSRect

Objective C

NSRect NSDrawColorTiledRects ( NSRect boundsRect, NSRect clipRect, const NSRectEdge *sides, NSColor **colors, NSInteger count );

Параметры

`boundsRect`	Ограничительный прямоугольник (в текущей системе координат), в котором можно нарисовать. Так как эта функция часто используется для рисования границы представления, этот прямоугольник обычно будет то, что прямоугольник границ представления. Только те части `boundsRect` та ложь в `clipRect` фактически нарисованы.
`clipRect`	Прямоугольник отсечения для использования во время получения.
`sides`	Стороны прямоугольника, для которого Вы хотите указать пользовательские цвета. Каждая сторона должна иметь соответствующую запись в `colors` параметр.
`colors`	Цвета для рисования для каждого из краев, перечисленных в `sides` параметр.
`count`	Число частей с 1.0 единицами в ширину для привлечения указанных сторон.

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

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

Обсуждение

Ведет себя то же как NSDrawTiledRects кроме него рисует его границу с помощью цветов от colors массив.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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


    
    NSDrawWhiteBezel (_: _:)
    NSDrawWhiteBezel

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

Объявление

Swift

func NSDrawWhiteBezel(_ aRect: NSRect, _ clipRect: NSRect)

Objective C

void NSDrawWhiteBezel ( NSRect aRect, NSRect clipRect );

Параметры

`aRect`	Ограничительный прямоугольник (в текущей системе координат), в котором можно нарисовать. Только те части `aRect` та ложь в `clipRect` фактически нарисованы.
`clipRect`	Прямоугольник отсечения для использования во время получения.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

NSDrawTiledRects


    
    NSDrawWindowBackground (_:)
    NSDrawWindowBackground

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

Объявление

Swift

func NSDrawWindowBackground(_ aRect: NSRect)

Objective C

void NSDrawWindowBackground ( NSRect aRect );

Параметры


      aRect

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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


    
    NSEraseRect (_:)
    NSEraseRect

Стирает указанный rect путем заполнения его белым.

Объявление

Swift

func NSEraseRect(_ aRect: NSRect)

Objective C

void NSEraseRect ( NSRect aRect );

Параметры


      aRect

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

Обсуждение

Эта функция заполняет указанный прямоугольник белым. Это не изменяет текущий цвет.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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


    
    NSFrameRect (_:)
    NSFrameRect

Нарисуйте ограниченный прямоугольник.

Объявление

Swift

func NSFrameRect(_ aRect: NSRect)

Objective C

void NSFrameRect ( NSRect aRect );

Параметры


      aRect

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

Обсуждение

Рисует кадр вокруг внутренней части aRect в текущем цвете и использовании NSCompositeCopy составление композита работы. Ширина равна 1,0 в текущей системе координат. Так как кадр нарисован в прямоугольнике, это будет видимо, даже если получение будет отсечено к прямоугольнику.

Поскольку эта функция не рисует непосредственно на строке, а скорее в нем, это использует текущий цвет заливки (не цвет обводки) при рисовании.

Для списка составляющих композит операций и как Вы используете их, посмотрите, что Какао Рисует Руководство.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

NSDrawTiledRects


    
    NSFrameRectWithWidth (_: _:)
    NSFrameRectWithWidth

Нарисуйте ограниченный прямоугольник.

Объявление

Swift

func NSFrameRectWithWidth(_ aRect: NSRect, _ frameWidth: CGFloat)

Objective C

void NSFrameRectWithWidth ( NSRect aRect, CGFloat frameWidth );

Параметры

`aRect`	Ограничительный прямоугольник (в текущей системе координат), в котором можно нарисовать.
`frameWidth`	Ширина кадра, указанного в точках.

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

NSDrawTiledRects


    
    NSFrameRectWithWidthUsingOperation (_: _: _:)
    NSFrameRectWithWidthUsingOperation

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

Объявление

Swift

func NSFrameRectWithWidthUsingOperation(_ aRect: NSRect, _ frameWidth: CGFloat, _ op: NSCompositingOperation)

Objective C

void NSFrameRectWithWidthUsingOperation ( NSRect aRect, CGFloat frameWidth, NSCompositingOperation op );

Параметры

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

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

NSEdgeInsetsMake NSEdgeInsetsMake

Возвраты NSEdgeInsets структура с указанными вставками.

Объявление

Objective C

NSEdgeInsets NSEdgeInsetsMake(CGFloat top, CGFloat left, CGFloat bottom, CGFloat right) { NSEdgeInsets e; e.top = top; e.left = left; e.bottom = bottom; e.right = right; return e; }
NSGetWindowServerMemory (_: _: _: _:) NSGetWindowServerMemory

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

Объявление

Swift

func NSGetWindowServerMemory(_ context: Int, _ virtualMemory: UnsafeMutablePointer<Int>, _ windowBackingMemory: UnsafeMutablePointer<Int>, _ windowDumpString: AutoreleasingUnsafeMutablePointer<NSString?>) -> Int

Objective C

NSInteger NSGetWindowServerMemory ( NSInteger context, NSInteger *virtualMemory, NSInteger *windowBackingMemory, NSString **windowDumpString );

Обсуждение

Вычисляет объем памяти, используемый в данный момент данным context. Если NULL передается для context, текущий контекст используется. Сумма виртуальной памяти, используемой текущим контекстом, возвращается в интервале, указал virtualMemory; сумма запоминающего устройства окна, используемого окнами, принадлежавшими текущему контексту, возвращается в интервале, указал windowBackingMemory. Сумма этих двух чисел является суммой памяти, за которую этот контекст ответственен.

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

Если nil не передается в для windowDumpStream, информация возвратилась, отражен к указанному потоку. Этот факт может быть полезен для обнаружения больше, о котором окна израсходовали Ваше хранение.

Обычно, NSGetWindowServerMemory возвраты 0. Если NULL передается для context и нет никакого текущего контекста дисплея, эта функция возвращается –1.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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


    
    NSHighlightRect
    NSHighlightRect

(OS X v10.0)

Выделяет указанный rect путем заполнения его белым.

Объявление

Objective C

void NSHighlightRect ( NSRect aRect );

Параметры


      aRect

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

Обсуждение

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

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

Objective C

@import AppKit;

Доступность

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

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


    
    NSReadPixel (_:)
    NSReadPixel

Читает цвет пикселя в указанном расположении.

Объявление

Swift

func NSReadPixel(_ passedPoint: NSPoint) -> NSColor!

Objective C

NSColor * NSReadPixel ( NSPoint passedPoint );

Параметры


      passedPoint

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

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

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

Обсуждение

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

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

NSRectClip (_:) NSRectClip

Изменяет текущую траекторию отсечения путем пересечения его с переданным rect.

Объявление

Swift

func NSRectClip(_ aRect: NSRect)

Objective C

void NSRectClip ( NSRect aRect );

Параметры

aRect

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

Обсуждение

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

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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


    
    NSRectClipList (_: _:)
    NSRectClipList

Изменяет текущую траекторию отсечения путем пересечения его с переданным rect.

Объявление

Swift

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

Objective C

void NSRectClipList ( const NSRect *rects, NSInteger count );

Параметры

`rects`	Указатель на массив `NSRect` структуры, объединенные и пересеченные с текущей траекторией отсечения.
`count`	Число прямоугольников в `rects`.

Обсуждение

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

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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


    
    NSRectFill (_:)
    NSRectFill

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

Объявление

Swift

func NSRectFill(_ aRect: NSRect)

Objective C

void NSRectFill ( NSRect aRect );

Параметры


      aRect

`aRect`	Прямоугольник для заполнения текущим цветом заливки.
`op`	Составляющая композит работа для использования при заполнении прямоугольника.

Обсуждение

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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


    
    NSSetFocusRingStyle (_:)
    NSSetFocusRingStyle

Указывает, как будет нарисовано фокусирующее кольцо.

Объявление

Swift

func NSSetFocusRingStyle(_ placement: NSFocusRingPlacement)

Objective C

void NSSetFocusRingStyle ( NSFocusRingPlacement placement );

Параметры


      placement

Указывает, как Вы хотите, чтобы было нарисовано фокусирующее кольцо.

Обсуждение

Использовать NSFocusRingAbove для рисования фокусирующего кольца по изображению использовать NSFocusRingBelow нарисовать фокусирующее кольцо в соответствии с текстом и использование NSFocusRingOnly если у Вас нет изображения или текста. Для NSFocusRingOnly случай, заполняет форму для добавления фокусирующего кольца вокруг формы.

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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


    
    NSShowAnimationEffect (_: _: _: _: _: _:)
    NSShowAnimationEffect

Выполняет системный эффект анимации.

Объявление

Swift

func NSShowAnimationEffect(_ animationEffect: NSAnimationEffect, _ centerLocation: NSPoint, _ size: NSSize, _ animationDelegate: AnyObject!, _ didEndSelector: Selector, _ contextInfo: UnsafeMutablePointer<Void>)

Objective C

void NSShowAnimationEffect ( NSAnimationEffect animationEffect, NSPoint centerLocation, NSSize size, id animationDelegate, SEL didEndSelector, void *contextInfo );

Параметры

`animationEffect`	Тип анимации Вы хотите применяться.
`centerLocation`	Расположение, в котором можно показать изображение с анимацией, указанное в координатах экрана. Анимация центрируется на точке, которую Вы указываете.
`size`	Желаемый размер изображения с анимацией. Указать `NSZeroSize` выполнять анимацию в размере по умолчанию.
`animationDelegate`	Объект уведомить, когда завершается анимация. Указать `nil` когда анимация завершается, если Вы не должны быть уведомлены.
`didEndSelector`	Селектор `animationDelegate` вызывать, когда завершается анимация. Указать `nil` когда анимация завершается, если Вы не должны быть уведомлены. При указании селектора соответствующий метод должен иметь следующую подпись: `- (void)animationEffectDidEnd:(void *)contextInfo;`
`contextInfo`	Указатель на любую дополнительную информацию, которую Вы хотите, передал в качестве параметра селектору в `didEndSelector` параметр.

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

NSWindowList NSWindowList (OS X v10.6)

Получает информацию об экранных окнах.

Объявление

Objective C

void NSWindowList ( NSInteger size, NSInteger list[] );

Обсуждение

Обеспечивает упорядоченный список всех экранных окон. Это заполняется list с до size числа окна; порядок окон в массиве совпадает с их порядком в экранном списке сервера окна (их порядок грудь-спина на экран). Используйте количество, полученное NSCountWindows указать размер массива для этой функции.

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

Objective C

@import AppKit;

Доступность

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

Получает информацию об экранных окнах приложения.

Объявление

Objective C

void NSWindowListForContext ( NSInteger context, NSInteger size, NSInteger list[] );

Обсуждение

Обеспечивает упорядоченный список экранных окон для определенного приложения, идентифицированного context, который является серверным соединением окна ID. Это заполняется list с до size числа окна; порядок окон в массиве совпадает с их порядком в экранном списке сервера окна (их порядок грудь-спина на экран). Используйте количество, полученное NSCountWindowsForContext функция для указания размера массива для этой функции.

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

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

Objective C

@import AppKit;

Доступность

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

Глубина графического окна

NSAvailableWindowDepths () NSAvailableWindowDepths

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

Объявление

Swift

func NSAvailableWindowDepths() -> UnsafePointer<NSWindowDepth>

Objective C

const NSWindowDepth * NSAvailableWindowDepths ( void );

Обсуждение

Возвращает завершенный нулем массив NSWindowDepth—Window Depth значения, указывающие, какие глубины окна в настоящее время доступны. Значения глубины окна преобразовываются в определенные свойства дисплея с помощью функций NSBitsPerPixelFromDepth, NSBitsPerSampleFromDepth, NSColorSpaceFromDepth, и NSPlanarFromDepth.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

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

Объявление

Swift

func NSBestDepth(_ colorSpace: String!, _ bps: Int, _ bpp: Int, _ planar: Bool, _ exactMatch: UnsafeMutablePointer<ObjCBool>) -> NSWindowDepth

Objective C

NSWindowDepth NSBestDepth ( NSString *colorSpace, NSInteger bps, NSInteger bpp, BOOL planar, BOOL *exactMatch );

Обсуждение

Возвращается глубина окна достаточно глубоко для данного числа раскрашивает colorSpace, биты на выборку, указанную bps, биты на пиксель, указанные bpp, и ли планарный, как указано planar. По возврату, переменная, которой указывают exactMatch YEStrue если глубина окна может разместить все значения, указанные параметрами, NOfalse если это не может.

Используйте эту функцию для вычислений глубин окна. Эта функция пытается разместить все параметры (соответствие или лучше); если существуют многократные соответствия, это дает самое близкое с соответствием colorSpace во-первых, тогда bps, тогда planar, тогда bpp. bpp «биты на пиксель»; 0 указывает значение по умолчанию (то же как число битов на плоскость, также bps или bps * NSNumberOfColorComponents); другие значения могут использоваться в качестве подсказок для обеспечения запоминающих устройств различной конфигурации; например, 8-разрядный цвет. exactMatch параметр является дополнительным и указывает, соответствовали ли все параметры точно.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

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

Объявление

Swift

func NSBitsPerPixelFromDepth(_ depth: NSWindowDepth) -> Int

Objective C

NSInteger NSBitsPerPixelFromDepth ( NSWindowDepth depth );

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Возвращает биты на выборку для указанной глубины окна.

Объявление

Swift

func NSBitsPerSampleFromDepth(_ depth: NSWindowDepth) -> Int

Objective C

NSInteger NSBitsPerSampleFromDepth ( NSWindowDepth depth );

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

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

Объявление

Swift

func NSColorSpaceFromDepth(_ depth: NSWindowDepth) -> String!

Objective C

NSString * NSColorSpaceFromDepth ( NSWindowDepth depth );

Обсуждение

Возвращает имя цветового пространства для указанного depth. Например, возвращенное имя цветового пространства может быть NSCalibratedRGBColorSpace, или NSDeviceCMYKColorSpace.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

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

Объявление

Swift

func NSNumberOfColorComponents(_ colorSpaceName: String!) -> Int

Objective C

NSInteger NSNumberOfColorComponents ( NSString *colorSpaceName );

Обсуждение

Возвращает число компонентов цвета в цветовом пространстве, именем которого предоставлены colorSpaceName.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

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

Объявление

Swift

func NSPlanarFromDepth(_ depth: NSWindowDepth) -> Bool

Objective C

BOOL NSPlanarFromDepth ( NSWindowDepth depth );

Обсуждение

Возвраты YEStrue если указанное окно depth является планарным и NOfalse если это не.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Стили интерфейса

NSInterfaceStyleForKey NSInterfaceStyleForKey (OS X v10.8)

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

Объявление

Objective C

NSInterfaceStyle NSInterfaceStyleForKey ( NSString *key, NSResponder *responder );

Обсуждение

Используемый для определения стиля интерфейса на основе ключа и респондента, любой из которых может быть nil. NSInterfaceStyle значение указывает стиль, в котором должен быть нарисован интерфейсный элемент, такой как кнопка или полоса прокрутки. Например, значение NSMacintoshInterfaceStyle указывает, что элемент должен быть нарисован в стиле Macintosh. Значения, определенные для NSInterfaceStyle NSNoInterfaceStyle, NSNextStepInterfaceStyle, NSWindows95InterfaceStyle, и NSMacintoshInterfaceStyle. Обратите внимание на то, что эта функция никогда не возвращается NSNoInterfaceStyle.

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

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

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

Система значений по умолчанию позволяет приложению настраивать свое поведение соответствовать предпочтения пользователя. Можно читать о системе значений по умолчанию в документации для NSUserDefaults.

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

Objective C

@import AppKit;

Доступность

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

Привязка значения ключа


    
    NSIsControllerMarker (_:)
    NSIsControllerMarker

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

Объявление

Swift

func NSIsControllerMarker(_ Term: AnyObject!) -> Bool

Objective C

BOOL NSIsControllerMarker ( id object );

Параметры


      Term

Укажите объект, который Вы хотите проверить. Этот параметр может быть nil.

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

YEStrue если объект является одним из определяемых маркеров контроллера или NOfalse если это не.

Обсуждение

Эта функция помогает Вам создать привязку между объектами контроллера и элементами пользовательского интерфейса. Набор Приложения предопределяет несколько специальных объектов маркера, используемых в качестве значений для указания состояния выбора; в настоящее время это NSMultipleValuesMarker, NSNoSelectionMarker, и NSNotApplicableMarker. Эти маркеры вводятся как id и только существуйте в целях указания состояния; они никогда не архивируются и не могут использоваться в качестве объектных значений в средствах управления. Вы используете эту функцию, чтобы протестировать, является ли данное объектное значение маркером, когда это не непосредственно присваиваемо связывающемуся объекту. Эта проверка важна, тем более, что дополнительные маркеры могут быть добавлены в будущем.

Посмотрите NSKeyValueBinding.h заголовочный файл для получения дальнейшей информации.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

OpenGL

NSOpenGLGetOption (_: _:) NSOpenGLGetOption

Глобальные опции OpenGL возвратов.

Объявление

Swift

func NSOpenGLGetOption(_ pname: NSOpenGLGlobalOption, _ param: UnsafeMutablePointer<GLint>)

Objective C

void NSOpenGLGetOption ( NSOpenGLGlobalOption pname, GLint *param );

Обсуждение

Возвраты в param значение глобального параметра OpenGL pname. Доступные параметры перечисляются NSOpenGLGlobalOption ввести.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Возвращает номера версий NSOpenGL.

Объявление

Swift

func NSOpenGLGetVersion(_ major: UnsafeMutablePointer<GLint>, _ minor: UnsafeMutablePointer<GLint>)

Objective C

void NSOpenGLGetVersion ( GLint *major, GLint *minor );

Обсуждение

Возвраты ссылкой номера основной версии и номера вспомогательной версии реализации NSOpenGL. Эта функция не является тем же как версией OpenGL.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Глобальные опции OpenGL наборов.

Объявление

Swift

func NSOpenGLSetOption(_ pname: NSOpenGLGlobalOption, _ param: GLint)

Objective C

void NSOpenGLSetOption ( NSOpenGLGlobalOption pname, GLint param );

Обсуждение

Устанавливает значение глобального параметра OpenGL pname к param. Доступные параметры перечисляются NSOpenGLGlobalOption ввести.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Панели

NSBeginAlertSheet NSBeginAlertSheet (OS X v10.10)
Создает и выполняет предупредительный лист.

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

Использовать NSAlert вместо этого.

Объявление

Objective C

void NSBeginAlertSheet ( NSString *title, NSString *defaultButton, NSString *alternateButton, NSString *otherButton, NSWindow *docWindow, id modalDelegate, SEL didEndSelector, SEL didDismissSelector, void *contextInfo, NSString *msgFormat, ... );
Обсуждение

Создает и работает на предупредительном листе docWindow, с заголовком title, текст msg, и кнопки с заголовками defaultButton, alternateButton, и otherButton.

Кнопки размечаются на нижнем правом углу листа, с defaultButton справа, alternateButton слева, и otherButton в середине. Если title nil или пустая строка, локализованный заголовок значения по умолчанию используется («Предупреждение» на английском языке). Если defaultButton nil или пустая строка, значение по умолчанию локализовало заголовок кнопки («OK» на английском языке) используется. Для остающихся кнопок эта функция создает их, только если их соответствующий заголовок кнопки не -nil.

Ключ Command-D, эквивалентный для кнопки «Do not Save», предоставлен, если Вы найдены. Заголовки кнопки ищутся локализованное значение для, “не Сохраняют”. Если соответствие найдено, та кнопка присваивается эквивалентный ключ Command-D, если это не кнопка по умолчанию.

Если Вы создаете модальное использование панели runModalForWindow: или beginSheet:modalForWindow:modalDelegate:didEndSelector:contextInfo:, можно присвоить ключевой эквивалент сами, с помощью setKeyEquivalent: и setKeyEquivalentModifierMask:.

msg параметром является сообщение, это выведено на экран в панели. Это может использовать символы форматирования printf-стиля; любые необходимые параметры должны быть перечислены в конце списка аргументов функции (после того, как msg параметр). Для получения дополнительной информации о символах форматирования см. страницу справочника для printf.

Когда модальный сеанс заканчивается, и прежде чем лист будет отклонен, didEndSelector вызывается на modalDelegate. передача contextInfo. После того, как лист отклонен, didDismissSelector вызывается на modalDelegate, передача contextInfo. Как правило, Вы захотите реализовать didEndSelector но можно передать NULL для didDismissSelector. Эти два селектора должны быть определены следующим образом:
sheetDidEnd:(NSWindow *)sheet returnCode:(int)returnCode contextInfo:(void *)contextInfo;

sheetDidDismiss:(NSWindow *)sheet returnCode:(int)returnCode contextInfo:(void *)contextInfo;
где sheet предупредительный лист, returnCode указывает, которые снабжают кнопками пользователя, нажатого, и contextInfo то же contextInfo переданный в NSBeginAlertSheet. returnCode может быть одно из следующего:
- NSAlertDefaultReturn означает, что пользователь нажал кнопку по умолчанию.
- NSAlertAlternateReturn означает, что пользователь нажал альтернативную кнопку.
- NSAlertOtherReturn означает, что пользователь нажал другую кнопку.
- NSAlertErrorReturn означает, что ошибка произошла при выполнении предупредительной панели.
Оператор импорта

Objective C

@import AppKit;

Доступность

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

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

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

Использовать NSAlert вместо этого.

Объявление

Objective C

void NSBeginCriticalAlertSheet ( NSString *title, NSString *defaultButton, NSString *alternateButton, NSString *otherButton, NSWindow *docWindow, id modalDelegate, SEL didEndSelector, SEL didDismissSelector, void *contextInfo, NSString *msgFormat, ... );

Обсуждение

Создает и работает на критическом предупредительном листе docWindow, с заголовком title, текст msg, и кнопки с заголовками defaultButton, alternateButton, и otherButton.

См. описание NSBeginAlertSheet для получения информации о расположении, параметрах по умолчанию и селекторах.

Лист, представленный пользователю, под маркой со значком предупреждения. Критические предупреждения должны использоваться только, как указано в разделе "Alerts” Инструкций по Элементу UI: глава Windows Инструкций по Интерфейсу пользователя OS X.

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

Objective C

@import AppKit;

Доступность

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

Создает и выполняет информационный предупредительный лист.

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

Использовать NSAlert вместо этого.

Объявление

Objective C

void NSBeginInformationalAlertSheet ( NSString *title, NSString *defaultButton, NSString *alternateButton, NSString *otherButton, NSWindow *docWindow, id modalDelegate, SEL didEndSelector, SEL didDismissSelector, void *contextInfo, NSString *msgFormat, ... );

Обсуждение

Создает и работает на информационном предупредительном листе docWindow, с заголовком title, текст msg, и кнопки с заголовками defaultButton, alternateButton, и otherButton.

См. описание NSBeginAlertSheet для получения информации о расположении, параметрах по умолчанию и селекторах.

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

Objective C

@import AppKit;

Доступность

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

Возвращает предупредительную панель.

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

Использовать NSAlert вместо этого.

Объявление

Objective C

id NSGetAlertPanel ( NSString *title, NSString *msgFormat, NSString *defaultButton, NSString *alternateButton, NSString *otherButton, ... );

Обсуждение

Возвраты NSPanel это может использоваться для установки модального сеанса. Модальный сеанс полезен для разрешения пользователю прервать программу. Во время модального сеанса можно выполнить действия, в то время как панель выведена на экран и проверка в различных точках в программе, нажал ли пользователь одну из кнопок панели. Параметры за эту функцию совпадают с теми для NSRunAlertPanel, но в отличие от той функции, никакая кнопка не выведена на экран если defaultButton nil.

Для установки модального сеанса отправьте Объект приложения beginModalSessionForWindow: с панелью, возвращенной NSGetAlertPanel как его параметр. Когда Вы хотите проверить, нажал ли пользователь одну из кнопок панели, использовать runModalSession:. Для окончания модального сеанса использовать endModalSession:. Когда Вы закончены с панелью, создаваемой NSGetAlertPanel, необходимо избавиться от него путем передачи его NSReleaseAlertPanel.

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

Objective C

@import AppKit;

Доступность

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

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

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

Использовать NSAlert вместо этого.

Объявление

Objective C

id NSGetCriticalAlertPanel ( NSString *title, NSString *msgFormat, NSString *defaultButton, NSString *alternateButton, NSString *otherButton, ... );

Обсуждение

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

Параметры за эту функцию совпадают с теми для NSGetAlertPanel. Для получения дополнительной информации об использовании панели в модальном сеансе посмотрите NSGetAlertPanel.

Панель, представленная пользователю, под маркой со значком предупреждения. Критические предупреждения должны использоваться только, как указано в разделе "Alerts” Инструкций по Элементу UI: глава Windows Инструкций по Интерфейсу пользователя OS X.

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

Objective C

@import AppKit;

Доступность

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

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

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

Использовать NSAlert вместо этого.

Объявление

Objective C

id NSGetInformationalAlertPanel ( NSString *title, NSString *msgFormat, NSString *defaultButton, NSString *alternateButton, NSString *otherButton, ... );

Обсуждение

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

Параметры за эту функцию совпадают с теми для NSRunAlertPanel функция. Для получения дополнительной информации об использовании панели в модальном сеансе посмотрите NSGetAlertPanel.

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

Objective C

@import AppKit;

Доступность

Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.10.
NSReleaseAlertPanel (_:) NSReleaseAlertPanel (OS X v10.10)

Избавляется от предупредительной панели.

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

Использовать NSAlert вместо этого.

Объявление

Swift

func NSReleaseAlertPanel(_ panel: AnyObject!)

Objective C

void NSReleaseAlertPanel ( id panel );

Обсуждение

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

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Создает предупредительную панель.

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

Использовать NSAlert вместо этого.

Объявление

Objective C

NSInteger NSRunAlertPanel ( NSString *title, NSString *msgFormat, NSString *defaultButton, NSString *alternateButton, NSString *otherButton, ... );

Обсуждение

Создает и выполняет предупредительную панель (или диалоговое окно) с заголовком title и кнопки с заголовками defaultButton, alternateButton, и otherButton. Дополнительное предупредительное сообщение, указанное msgFormat должно быть статическое значение, которое может состоять из значений переменных с помощью строки формата (перечислите любые необходимые параметры за эту отформатированную строку в конце списка аргументов функции), неформатированная строка или пустая строка (@""), но нет nil. Обратите внимание на то, что передавая недоверяемую строку в msgFormat может привести к проблемам безопасности. См. описание NSBeginAlertSheet для получения информации о расположении кнопок, параметров по умолчанию и возможных возвращаемых значений. NSRunAlertPanel выполняет панель в модальном цикле событий.

Ключ Command-D, эквивалентный для кнопки «Do not Save», предоставлен, если Вы найдены. Заголовки кнопки ищутся локализованное значение для, “не Сохраняют”. Если соответствие найдено, та кнопка присваивается эквивалентный ключ Command-D, если это не кнопка по умолчанию.

Если Вы создаете модальное использование панели runModalForWindow: или beginSheet:modalForWindow:modalDelegate:didEndSelector:contextInfo:, можно присвоить ключевой эквивалент сами, с помощью setKeyEquivalent: и setKeyEquivalentModifierMask:.

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

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

Objective C

@import AppKit;

Доступность

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

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

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

Использовать NSAlert вместо этого.

Объявление

Objective C

NSInteger NSRunCriticalAlertPanel ( NSString *title, NSString *msgFormat, NSString *defaultButton, NSString *alternateButton, NSString *otherButton, ... );

Обсуждение

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

Панель, представленная пользователю, под маркой со значком предупреждения. Критические предупреждения должны использоваться только, как указано в разделе "Alerts” Инструкций по Элементу UI: глава Windows Инструкций по Интерфейсу пользователя OS X.

Параметры за эту функцию совпадают с теми для NSRunAlertPanel.

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

Objective C

@import AppKit;

Доступность

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

Создает и выполняет информационную предупредительную панель.

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

Использовать NSAlert вместо этого.

Объявление

Objective C

NSInteger NSRunInformationalAlertPanel ( NSString *title, NSString *msgFormat, NSString *defaultButton, NSString *alternateButton, NSString *otherButton, ... );

Обсуждение

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

Параметры за эту функцию совпадают с теми для NSRunAlertPanel.

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

Objective C

@import AppKit;

Доступность

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

Области монтажа

NSCreateFileContentsPboardType (_:) NSCreateFileContentsPboardType

Возвращает тип области монтажа на основе переданного типа файла.

Содержание файла pboard тип позволило Вам синтезировать тип pboard для содержания файла на основе расширения файла. Используя UTI файла для представления его содержания теперь заменяет эту функциональность.

Объявление

Swift

func NSCreateFileContentsPboardType(_ fileType: String!) -> String!

Objective C

NSString * NSCreateFileContentsPboardType ( NSString *fileType );

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Возвращает тип области монтажа на основе переданного типа файла.

Содержание файла pboard тип позволило Вам синтезировать тип pboard для содержания файла на основе расширения файла. Используя UTI файла для представления его содержания теперь заменяет эту функциональность.

Объявление

Swift

func NSCreateFilenamePboardType(_ fileType: String!) -> String!

Objective C

NSString * NSCreateFilenamePboardType ( NSString *fileType );

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Возвращает тип файла на основе переданного типа области монтажа.

Содержание файла pboard тип позволило Вам синтезировать тип pboard для содержания файла на основе расширения файла. Используя UTI файла для представления его содержания теперь заменяет эту функциональность.

Объявление

Swift

func NSGetFileType(_ pboardType: String!) -> String!

Objective C

NSString * NSGetFileType ( NSString *pboardType );

Обсуждение

Эта функция является инверсией обоих NSCreateFileContentsPboardType и NSCreateFilenamePboardType. Когда передано тип области монтажа, как возвращено теми функциями, это возвращает дополнительное или имя файла, из которого был получен тип. Это возвращается nil если pboardType не тип области монтажа, создаваемый теми функциями.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Возвращает массив типов файлов на основе переданных типов области монтажа.

Содержание файла pboard тип позволило Вам синтезировать тип pboard для содержания файла на основе расширения файла. Используя UTI файла для представления его содержания теперь заменяет эту функциональность.

Объявление

Swift

func NSGetFileTypes(_ pboardTypes: [AnyObject]!) -> [AnyObject]!

Objective C

NSArray * NSGetFileTypes ( NSArray *pboardTypes );

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Системный звуковой сигнал

Дополнительная информация о звуках может быть найдена в NSSound.

NSBeep () NSBeep

Играет системный звуковой сигнал.

Объявление

Swift

func NSBeep()

Objective C

void NSBeep ( void );

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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