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

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

Разработчик

Ссылка класса NSPasteboardItem

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

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

NSPasteboardItem

NSPasteboardItem универсальный класс для представления элемента на области монтажа.

Существует три основного использования для NSPasteboardItem объект:

  1. Предоставление данных на области монтажа.

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

  2. Настройка данных уже по области монтажа.

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

  3. Получение данных от области монтажа.

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

Элемент области монтажа может быть связан с единственной областью монтажа. При создании элемента он может быть записан в любую область монтажа. Когда Вы передаете элемент области монтажа в writeObjects:, тот элемент становится связанным к области монтажа, в которую он был записан. Когда Вы получаете элементы от использования области монтажа pasteboardItems или readObjectsForClasses:options:, возвращенные элементы связаны с переданной областью монтажа. Передача элемента, уже связанного с областью монтажа в writeObjects: заставляет исключение быть повышенным.

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

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


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


Swift

import AppKit

Objective C

@import AppKit;

Доступность


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

    Массив строк UTI типов данных поддерживается получателем. (только для чтения)

    Объявление

    Swift

    var types: [AnyObject]! { get }

    Objective C

    @property(readonly, copy) NSArray *types

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

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

    Объявление

    Swift

    func availableTypeFromArray(_ types: [AnyObject]) -> String?

    Objective C

    - (NSString *)availableTypeFromArray:(NSArray *)types

    Параметры

    types

    Массив строк, представляющих UTIs, расположенный в порядке предпочтения (самый предпочтительный как 0th элемент в массиве).

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

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

    Обсуждение

    Метод проверяет на соответствие UTI требуемых типов, предпочитая точное совпадение соответствию.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

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

    Объявление

    Swift

    func setDataProvider(_ dataProvider: NSPasteboardItemDataProvider!, forTypes types: [AnyObject]) -> Bool

    Objective C

    - (BOOL)setDataProvider:(id<NSPasteboardItemDataProvider>)dataProvider forTypes:(NSArray *)types

    Параметры

    dataProvider

    Провайдер данных области монтажа.

    types

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

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

    YEStrue если провайдер данных был установлен успешно, иначе NOfalse.

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • Устанавливает значение для указанного типа как NSData объект.

    Объявление

    Swift

    func setData(_ data: NSData!, forType type: String) -> Bool

    Objective C

    - (BOOL)setData:(NSData *)data forType:(NSString *)type

    Параметры

    data

    NSData объект, содержащий значение для представления, указанного type.

    type

    UTI вводит строку.

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

    YEStrue если значение было установлено успешно, иначе NOfalse.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

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

    Объявление

    Swift

    func setString(_ string: String!, forType type: String) -> Bool

    Objective C

    - (BOOL)setString:(NSString *)string forType:(NSString *)type

    Параметры

    string

    Строка для представления, указанного type.

    type

    UTI вводит строку.

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

    YEStrue если значение было установлено успешно, иначе NOfalse.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

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

    Объявление

    Swift

    func setPropertyList(_ propertyList: AnyObject!, forType type: String) -> Bool

    Objective C

    - (BOOL)setPropertyList:(id)propertyList forType:(NSString *)type

    Параметры

    propertyList

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

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

    type

    UTI вводит строку.

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

    YEStrue если значение было установлено успешно, иначе NOfalse.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

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

    Объявление

    Swift

    func dataForType(_ type: String) -> NSData?

    Objective C

    - (NSData *)dataForType:(NSString *)type

    Параметры

    type

    UTI вводит строку.

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

    Значение для указанного типа как NSData объект.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

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

    Объявление

    Swift

    func stringForType(_ type: String) -> String?

    Objective C

    - (NSString *)stringForType:(NSString *)type

    Параметры

    type

    UTI вводит строку.

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

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

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

    Объявление

    Swift

    func propertyListForType(_ type: String) -> AnyObject?

    Objective C

    - (id)propertyListForType:(NSString *)type

    Параметры

    type

    UTI вводит строку.

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

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

    Обсуждение

    Для больше о списках свойств, см. Руководство по программированию Списка свойств.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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