NSPasteboardItem
NSPasteboardItem
универсальный класс для представления элемента на области монтажа.
Существует три основного использования для NSPasteboardItem
объект:
Предоставление данных на области монтажа.
Можно создать один или несколько элементов области монтажа, установить провайдеров данных или провайдеров данных для типов, и записать в них область монтажа.
Настройка данных уже по области монтажа.
Как делегат или подкласс, можно в настоящее время получать элементы области монтажа на области монтажа, считать существующие типы и данные и установить новые данные и провайдеров данных для типов по мере необходимости.
Получение данных от области монтажа.
Можно получить элементы области монтажа от области монтажа, тогда считывает данные для типов, которыми Вы интересуетесь.
Элемент области монтажа может быть связан с единственной областью монтажа. При создании элемента он может быть записан в любую область монтажа. Когда Вы передаете элемент области монтажа в writeObjects:
, тот элемент становится связанным к области монтажа, в которую он был записан. Когда Вы получаете элементы от использования области монтажа pasteboardItems
или readObjectsForClasses:options:
, возвращенные элементы связаны с переданной областью монтажа. Передача элемента, уже связанного с областью монтажа в writeObjects:
заставляет исключение быть повышенным.
Элементы области монтажа предназначаются, чтобы использоваться во время единственного взаимодействия области монтажа, не сохраненного на, и неоднократно использовали. Элемент области монтажа только допустим до владельца изменений области монтажа.
Соответствует
-
AnyObject
-
CVarArgType
-
Сопоставимый
-
Hashable
-
NSObjectProtocol
-
NSPasteboardReading
-
NSPasteboardWriting
-
Печатаемый
-
NSObject
-
NSPasteboardReading
-
NSPasteboardWriting
Оператор импорта
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?Параметры
types
Массив строк, представляющих UTIs, расположенный в порядке предпочтения (самый предпочтительный как 0th элемент в массиве).
Возвращаемое значение
Первое (согласно упорядочиванию отправителя
types
) ввестиtypes
содержавшийся в элементе области монтажа, илиnil
если получатель не содержит поданных типовtypes
.Обсуждение
Метод проверяет на соответствие UTI требуемых типов, предпочитая точное совпадение соответствию.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.6 и позже.
-
Устанавливает провайдера данных для указанных типов.
Объявление
Swift
func setDataProvider(_
dataProvider
: NSPasteboardItemDataProvider!, forTypestypes
: [AnyObject]) -> BoolObjective C
- (BOOL)setDataProvider:(id<NSPasteboardItemDataProvider>)
dataProvider
forTypes:(NSArray *)types
Параметры
dataProvider
Провайдер данных области монтажа.
types
Массив строк, указывающих UTIs для представлений данных
dataProvider
может обеспечить.Возвращаемое значение
YES
true
если провайдер данных был установлен успешно, иначеNO
false
.Обсуждение
Этот метод регистрирует провайдера данных, чтобы быть переданным для предоставления данных для любого из указанных типов, когда требуется.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.6 и позже.
-
Устанавливает значение для указанного типа как
NSData
объект.Объявление
Параметры
data
NSData
объект, содержащий значение для представления, указанногоtype
.type
UTI вводит строку.
Возвращаемое значение
YES
true
если значение было установлено успешно, иначеNO
false
.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.6 и позже.
-
Устанавливает значение для указанного типа как строка.
Объявление
Параметры
string
Строка для представления, указанного
type
.type
UTI вводит строку.
Возвращаемое значение
YES
true
если значение было установлено успешно, иначеNO
false
.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.6 и позже.
-
Устанавливает значение для указанного типа как список свойств.
Объявление
Swift
func setPropertyList(_
propertyList
: AnyObject!, forTypetype
: String) -> BoolObjective C
- (BOOL)setPropertyList:(id)
propertyList
forType:(NSString *)type
Параметры
propertyList
Объект списка свойств, содержащий значение для представления, указанного
type
.Для приблизительно списков свойств см. Руководство по программированию Списка свойств.
type
UTI вводит строку.
Возвращаемое значение
YES
true
если значение было установлено успешно, иначеNO
false
.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.6 и позже.
-
Возвращает значение для указанного типа как
NSData
объект.Объявление
Параметры
type
UTI вводит строку.
Возвращаемое значение
Значение для указанного типа как
NSData
объект.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.6 и позже.
-
Возвращает значение для указанного типа как строка.
Объявление
Параметры
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 и позже.