Spec-Zone .ru
спецификации, руководства, описания, API

Библиотека разработчика Mac

Разработчик

Ссылка платформы AppKit ссылка функций AppKit

Опции
Развертывание Target:

На этой странице
Язык:

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

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

Функции

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

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

    Объявление

    Swift

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

    Objective C

    NSString * NSAccessibilityActionDescription ( NSString *action );

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

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

    Объявление

    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 и позже.

  • Отправляет уведомление и дополнительное 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 и позже.

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

    Объявление

    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 и позже.

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

    Объявление

    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 и позже.

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

    Объявление

    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 и позже.

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

    Объявление

    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 и позже.

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

    Объявление

    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 и позже.

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

    Объявление

    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 и позже.

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

    Объявление

    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 и позже.

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

    Объявление

    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 и позже.

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

    Объявление

    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 и позже.

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

    Объявление

    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.

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

    Объявление

    Swift

    func NSApplicationLoad() -> Bool

    Objective C

    BOOL NSApplicationLoad ( void );

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

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

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

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

    Объявление

    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 и позже.

  • Программно вызывает службу меню 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 и позже.

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

    Объявление

    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 и позже.

  • Указывает, должен ли элемент быть включен в меню 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 и позже.

  • Указывает, включается ли в настоящее время пункт меню 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 и позже.

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

    Объявление

    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 и позже.

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

    Объявление

    Swift

    func NSUpdateDynamicServices()

    Objective C

    void NSUpdateDynamicServices ( void );

    Обсуждение

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

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

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

    Объявление

    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 и позже.

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

    Объявление

    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 и позже.

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

    Объявление

    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 и позже.

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

    Объявление

    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.

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

    Объявление

    Objective C

    void NSCountWindows ( NSInteger *count );

    Параметры

    count

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

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

    Objective C

    @import AppKit;

    Доступность

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

    Осуждаемый в 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.

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

    Объявление

    Swift

    func NSDisableScreenUpdates()

    Objective C

    void NSDisableScreenUpdates ( void );

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

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

    Объявление

    Swift

    func NSEnableScreenUpdates()

    Objective C

    void NSEnableScreenUpdates ( void );

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

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

    Объявление

    Swift

    func NSDottedFrameRect(_ aRect: NSRect)

    Objective C

    void NSDottedFrameRect ( NSRect aRect );

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    NSDrawTiledRects

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

    Объявление

    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 и позже.

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

    Объявление

    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 и позже.

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

    Объявление

    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

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

    Объявление

    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

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

    Объявление

    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

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

    Объявление

    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

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

    Объявление

    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 и позже.

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

    Объявление

    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.

    Обсуждение

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

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

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

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

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

    Объявление

    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 и позже.

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

    Объявление

    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 и позже.

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

    Объявление

    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

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

    Объявление

    Swift

    func NSDrawWindowBackground(_ aRect: NSRect)

    Objective C

    void NSDrawWindowBackground ( NSRect aRect );

    Параметры

    aRect

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

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

    Объявление

    Swift

    func NSEraseRect(_ aRect: NSRect)

    Objective C

    void NSEraseRect ( NSRect aRect );

    Параметры

    aRect

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

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

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

    Объявление

    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

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

    Объявление

    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

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

    Объявление

    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 и позже.

  • Возвраты 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; }

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

    Объявление

    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 и позже.

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

    Объявление

    Objective C

    void NSHighlightRect ( NSRect aRect );

    Параметры

    aRect

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

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Доступность

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

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

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

    Объявление

    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 и позже.

  • Изменяет текущую траекторию отсечения путем пересечения его с переданным 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 и позже.

  • Изменяет текущую траекторию отсечения путем пересечения его с переданным 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 и позже.

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

    Объявление

    Swift

    func NSRectFill(_ aRect: NSRect)

    Objective C

    void NSRectFill ( NSRect aRect );

    Параметры

    aRect

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

    Обсуждение

    Заливки aRect с текущим цветом с помощью составляющего композит режима NSCompositeCopy, который заполняется текущим цветом путем копирования значений RGBA. Использовать NSRectFillUsingOperation заполнить указание составляющего композит режима.

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

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

    Объявление

    Swift

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

    Objective C

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

    Параметры

    rects

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

    count

    Число прямоугольников в rects.

    Обсуждение

    Заполняет указанные прямоугольники текущим цветом заливки с помощью составляющего композит режима NSCompositeCopy.

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

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

    Объявление

    Swift

    func NSRectFillListWithColors(_ rects: UnsafePointer<NSRect>, _ colors: UnsafePointer<NSColor?>, _ num: Int)

    Objective C

    void NSRectFillListWithColors ( const NSRect *rects, NSColor *const *colors, NSInteger num );

    Параметры

    rects

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

    colors

    Указатель на массив NSColor объекты. Число цветовых объектов в этом параметре должно равняться числу прямоугольников в rects параметр.

    num

    Число прямоугольников в rects параметр.

    Обсуждение

    Берет список num прямоугольники и соответствующий список цветовых объектов. Первый прямоугольник заполнен первым цветом, вторым прямоугольником со вторым цветом, и т.д. Должно быть равное количество прямоугольников и значений цвета. Прямоугольники составляются с помощью NSCompositeCopy оператору и порядку, в котором прямоугольники заполнены, нельзя гарантировать; поэтому, перекрывающиеся прямоугольники могут не нарисовать как ожидалось. Эта функция изменяет текущий цвет текущего состояния графики, устанавливание его непредсказуемо к одному из значений передало в colors.

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • Заполняет прямоугольники в переданном списке с переданным списком серых оттенков.

    Объявление

    Swift

    func NSRectFillListWithGrays(_ rects: UnsafePointer<NSRect>, _ grays: UnsafePointer<CGFloat>, _ num: Int)

    Objective C

    void NSRectFillListWithGrays ( const NSRect *rects, const CGFloat *grays, NSInteger num );

    Параметры

    rects

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

    grays

    Указатель на массив значений с плавающей точкой в диапазоне 0.0 к 1,0, где 0.0 представляет абсолютный черный цвет и 1.0, представляет абсолютного белого, и промежуточные числа варьируются уровни серого цвета. Значения вне этого диапазона фиксируются к 0,0 или 1.0.

    num

    Число прямоугольников в rects параметр.

    Обсуждение

    Берет список num прямоугольники и соответствующий список уровней яркости. Первый прямоугольник заполнен первым серым, вторым прямоугольником со вторым серым, и т.д. Должно быть равное количество прямоугольников и уровней яркости. Прямоугольники составляются с помощью NSCompositeCopy оператору и порядку, в котором прямоугольники заполнены, нельзя гарантировать; поэтому, перекрывающиеся прямоугольники могут не нарисовать как ожидалось. Эта функция изменяет текущий цвет текущего состояния графики, устанавливание его непредсказуемо к одному из значений передало в grays.

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

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

    Объявление

    Swift

    func NSRectFillListUsingOperation(_ rects: UnsafePointer<NSRect>, _ count: Int, _ op: NSCompositingOperation)

    Objective C

    void NSRectFillListUsingOperation ( const NSRect *rects, NSInteger count, NSCompositingOperation op );

    Параметры

    rects

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

    count

    Число прямоугольников в rects параметр.

    op

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

    Обсуждение

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

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • Заполняет прямоугольники в списке с помощью указанных цветов и составляя работу.

    Объявление

    Swift

    func NSRectFillListWithColorsUsingOperation(_ rects: UnsafePointer<NSRect>, _ colors: UnsafePointer<NSColor?>, _ num: Int, _ op: NSCompositingOperation)

    Objective C

    void NSRectFillListWithColorsUsingOperation ( const NSRect *rects, NSColor *const *colors, NSInteger num, NSCompositingOperation op );

    Параметры

    rects

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

    colors

    Указатель на массив NSColor объекты. Число цветовых объектов в этом параметре должно равняться числу прямоугольников в rects параметр.

    num

    Число прямоугольников в rects параметр.

    op

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

    Обсуждение

    Берет список num прямоугольники и соответствующий список значений цвета. Первый прямоугольник заполнен первым цветом, вторым прямоугольником со вторым цветом, и т.д. Должно быть равное количество прямоугольников и значений цвета. Каждая операция заполнения выполняется с помощью составляющей композит работы op. Прямоугольники не должны накладываться; порядок, в котором они переполнены, не может быть гарантирован. Эта функция изменяет текущий цвет текущего состояния графики, устанавливание его непредсказуемо к одному из значений передало в colors.

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

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

    Объявление

    Swift

    func NSRectFillUsingOperation(_ aRect: NSRect, _ op: NSCompositingOperation)

    Objective C

    void NSRectFillUsingOperation ( NSRect aRect, NSCompositingOperation op );

    Параметры

    aRect

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

    op

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

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

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

    Объявление

    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 и позже.

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

    Объявление

    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.

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

    Объявление

    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.

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

    Объявление

    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 и позже.

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

    Объявление

    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 и позже.

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

    Объявление

    Swift

    func NSBitsPerPixelFromDepth(_ depth: NSWindowDepth) -> Int

    Objective C

    NSInteger NSBitsPerPixelFromDepth ( NSWindowDepth depth );

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

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

    Объявление

    Swift

    func NSBitsPerSampleFromDepth(_ depth: NSWindowDepth) -> Int

    Objective C

    NSInteger NSBitsPerSampleFromDepth ( NSWindowDepth depth );

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

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

    Объявление

    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 и позже.

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

    Объявление

    Swift

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

    Objective C

    NSInteger NSNumberOfColorComponents ( NSString *colorSpaceName );

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

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

    Объявление

    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 и позже.

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

    Объявление

    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.

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

    Объявление

    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 возвратов.

    Объявление

    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 и позже.

  • Возвращает номера версий 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 и позже.

  • Глобальные опции 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 и позже.

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

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

    Использовать 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.

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

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

    Использовать 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.

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

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

    Использовать 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.

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

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

    Использовать 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.

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

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

    Использовать 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.

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

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

    Использовать 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.

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

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

    Использовать 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.

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

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

    Использовать 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.

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

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

    Использовать 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.

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

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

    Использовать 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.

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

    Содержание файла 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 и позже.

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

    Содержание файла 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 и позже.

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

    Содержание файла 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 и позже.

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

    Содержание файла 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.

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

    Объявление

    Swift

    func NSBeep()

    Objective C

    void NSBeep ( void );

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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