NSPasteboard
NSPasteboard
объекты передают данные и от сервера области монтажа. Сервер совместно используется всеми запущенными приложениями. Это содержит данные, которые пользователь сократил или скопировал, а также другие данные, которые одно приложение хочет передать другому. NSPasteboard
объекты являются единственным интерфейсом приложения к серверу и ко всем операциям области монтажа.
NSPasteboard
объект также используется для передачи данных между поставщиками приложений и поставщиками услуг, перечисленными в меню Services каждого приложения. Область монтажа перетаскивания (NSDragPboard
) используется для передачи данных, перетаскивающихся пользователем.
В OS X v10.6 и позже, область монтажа может содержать многократные элементы. Можно непосредственно записать или считать любой объект, реализующий NSPasteboardWriting
или NSPasteboardReading
протокол соответственно. Это позволяет Вам писать и читать товары широкого потребления, такие как URLs, цвета, изображения, строки, приписали строки и звуки без посреднического объекта. Ваши пользовательские классы могут также реализовать эти протоколы для использования с областью монтажа.
Методы записи, доступные в OS X v10.5 и ранее, все воздействуют на то, что является концептуально первым элементом на области монтажа. Они принимают UTIs и pboard
введите строки. В будущем выпуске они могут взять только UTIs. В OS X v10.6 и позже, методы записи такой как setData:forType:
все еще обеспечьте удобные средние значения записи в первый элемент области монтажа, не имея необходимость создавать первый элемент области монтажа. Например, вместо
[pboard clearContents];
NSPasteboardItem *item = [[[NSPasteboardItem alloc] init]];
[item setData:data forType:type];
[pboard writeObjects:[NSArray arrayWithObject:item]];
можно записать:
[pboard clearContents];
[pboard setData:data forType:type];
В дополнение к тому, чтобы быть более компактным, это также немного более эффективно — это избегает потребности создать отдельный элемент области монтажа и массив.
Оператор импорта
Swift
import AppKit
Objective C
@import AppKit;
Доступность
Доступный в OS X v10.0 и позже.
-
Возвращает генерала
NSPasteboard
объект.Объявление
Swift
class func generalPasteboard() -> NSPasteboard
Objective C
+ (NSPasteboard *)generalPasteboard
Возвращаемое значение
Общая область монтажа.
Обсуждение
Вызывает
pasteboardWithName:
получить область монтажа.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Создает и возвращает новую область монтажа с уникальным именем, снабжающим указанными данными в как можно большем количестве типов, данных доступные службы фильтра.
Объявление
Параметры
data
Данные, которые будут помещены в область монтажа.
type
Тип данных в
data
параметр.Возвращаемое значение
Новый объект области монтажа.
Обсуждение
Возвращенная область монтажа также объявляет данные предоставленного
type
.Никакая служба фильтра не вызывается, пока данные фактически не запрашиваются, так вызов этого метода довольно недорог.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Создает и возвращает новую область монтажа с уникальным именем, снабжающим указанными данными файла в как можно большем количестве типов, данных доступные службы фильтра.
Объявление
Swift
init(byFilteringFile
filename
: String) -> NSPasteboardObjective C
+ (NSPasteboard *)pasteboardByFilteringFile:(NSString *)
filename
Параметры
filename
Имя файла, чтобы поставить область монтажа.
Возвращаемое значение
Новый объект области монтажа.
Обсуждение
Никакая служба фильтра не вызывается, пока данные фактически не запрашиваются, так вызов этого метода довольно недорог.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Создает и возвращает новую область монтажа с уникальным именем, снабжающим указанными данными области монтажа в как можно большем количестве типов, данных доступные службы фильтра.
Объявление
Swift
init(byFilteringTypesInPasteboard
pasteboard
: NSPasteboard) -> NSPasteboardObjective C
+ (NSPasteboard *)pasteboardByFilteringTypesInPasteboard:(NSPasteboard *)
pasteboard
Параметры
pasteboard
Исходный объект области монтажа.
Возвращаемое значение
Новый объект области монтажа. Этот метод возвращает объект в
pasteboard
параметр, если область монтажа была возвращена одним изpasteboardByFiltering...
методы. Это препятствует тому, чтобы область монтажа была расширена многократно.Обсуждение
Этот процесс может считаться расширением области монтажа, потому что новая область монтажа обычно содержит больше представлений данных, чем
pasteboard
.Этот метод только возвращает исходные типы и типы, которые могут быть созданы в результате единственного фильтра; область монтажа не имеет определенных типов, которые являются результатом перевода многократными фильтрами.
Никакая служба фильтра не вызывается, пока данные фактически не запрашиваются, так вызов этого метода довольно недорог.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Возвращает область монтажа с указанным именем.
Объявление
Swift
init(name
name
: String) -> NSPasteboardObjective C
+ (NSPasteboard *)pasteboardWithName:(NSString *)
name
Параметры
name
Имя области монтажа. Имена стандартных областей монтажа даны на Имена Области монтажа.
Возвращаемое значение
Область монтажа связалась с именем или новым
NSPasteboard
возразите, не имеет ли приложение еще объекта области монтажа для указанного имени.Обсуждение
Другие имена могут быть присвоены создать частные области монтажа для других целей.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Создает и возвращает новую область монтажа с именем, которое, как гарантируют, будет уникально относительно других областей монтажа на компьютере.
Объявление
Swift
class func pasteboardWithUniqueName() -> NSPasteboard
Objective C
+ (NSPasteboard *)pasteboardWithUniqueName
Возвращаемое значение
Новый объект области монтажа.
Обсуждение
Этот метод полезен для приложений, реализующих их собственное межпроцессное взаимодействие с помощью областей монтажа.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Высвобождает средства получателя в сервере области монтажа.
Объявление
Swift
func releaseGlobally()
Objective C
- (oneway void)releaseGlobally
Обсуждение
После того, как этот метод вызывается, никакое другое приложение не может использовать получатель.
Специальные замечания
Временная, конфиденциально именованная область монтажа может быть выпущена этот путь, когда это больше не необходимо, но стандартная область монтажа никогда не должна выпускаться глобально.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Очищает существующее содержание области монтажа
Возвращаемое значение
Количество изменения получателя.
Обсуждение
Очищает существующее содержание области монтажа, подготавливая его к новому содержанию. Это - первый шаг в предоставлении данных на области монтажа.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.6 и позже.
-
Пишет массив объектов к получателю.
Объявление
Swift
func writeObjects(_
objects
: [AnyObject]) -> BoolObjective C
- (BOOL)writeObjects:(NSArray *)
objects
Параметры
objects
Массив объектов, реализующих
NSPasteboardWriting
протокол (включая экземплярыNSPasteboardItem
).Возвращаемое значение
YES
true
если массив был успешно добавлен, иначеNO
false
.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.6 и позже.
-
Устанавливает определенные данные как представление для указанного типа для первого элемента на получателе.
Объявление
Параметры
data
Данные для записи в область монтажа.
dataType
Тип данных в
data
параметр. Тип, должно быть, был объявлен предыдущимdeclareTypes:owner:
сообщение.Возвращаемое значение
YES
true
если данные были записаны успешно, иначеNO
false
если изменилось владение области монтажа. Любая другая ошибка повышаетNSPasteboardCommunicationException
.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Устанавливает данный список свойств как представление для указанного типа для первого элемента на получателе.
Объявление
Swift
func setPropertyList(_
propertyList
: AnyObject, forTypedataType
: String) -> BoolObjective C
- (BOOL)setPropertyList:(id)
propertyList
forType:(NSString *)dataType
Параметры
propertyList
Данные списка свойств для записи в область монтажа.
dataType
Тип данных списка свойств в
propertyList
параметр. Тип, должно быть, был объявлен предыдущимdeclareTypes:owner:
сообщение.Возвращаемое значение
YES
true
если данные были записаны успешно, иначеNO
false
если изменилось владение области монтажа. Любая другая ошибка повышаетNSPasteboardCommunicationException
.Обсуждение
Этот метод вызывает
setData:forType:
с сериализированным параметром списка свойств.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Устанавливает данную строку как представление для указанного типа для первого элемента на получателе.
Объявление
Параметры
string
Строка для записи в область монтажа.
dataType
Тип строковых данных. Тип, должно быть, был объявлен предыдущим
declareTypes:owner:
сообщение.Возвращаемое значение
YES
true
если данные были записаны успешно, иначеNO
false
если изменилось владение области монтажа. Любая другая ошибка повышаетNSPasteboardCommunicationException
.Обсуждение
Этот метод вызывает
setData:forType:
выполнять запись.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Чтения от получателя возражают, что лучше всего соответствуют указанный массив классов.
Объявление
Swift
func readObjectsForClasses(_
classArray
: [AnyObject], optionsoptions
: [NSObject : AnyObject]?) -> [AnyObject]?Objective C
- (NSArray *)readObjectsForClasses:(NSArray *)
classArray
options:(NSDictionary *)options
Параметры
classArray
Массив объектов класса.
Поскольку этот метод создает экземпляр первого класса, который может считать данный элемент области монтажа, можно упорядочить классы в
classArray
соответствовать Ваш предпочтительный порядок представления. Классы в массиве должны соответствоватьNSPasteboardReading
протокол.options
Словарь, указывающий опции совершенствовать поиск элементов области монтажа, например ограничить поиск для регистрации URLs с определенными типами контента. Для допустимых ключей словаря посмотрите, что Область монтажа Читает Опции.
Возвращаемое значение
Массив, содержащий лучшее соответствие (если таковые имеются) для каждого из элементов на получателе, который может быть представлен классом, указанным в
classArray
. Возвратыnil
если никакие объекты указанных классов не могут быть созданы, если существует ошибка в получении требуемых элементов от области монтажа, или пустого массива.Обсуждение
Классы в
classArray
должен реализоватьNSPasteboardReading
протокол. Классы какао, реализующие этот протокол, включаютNSImage
,NSString
,NSURL
,NSColor
,NSAttributedString
, иNSPasteboardItem
. Для каждого элемента на области монтажа каждый класс в предоставленном массиве будет запрошен для типов, это может считать использованиеreadableTypesForPasteboard:
. Экземпляр создается из первого класса, найденного в предоставленном массиве, читаемые типы которого соответствуют соответствующий тип, содержавшийся в том элементе области монтажа. Любые экземпляры, которые могли быть созданы из данных элемента области монтажа, возвращаются к вызывающей стороне. Дополнительные опции, такие как ограничение поиска для регистрации URLs с определенными типами контента, могут быть указаны со словарем опций.Только объекты требуемых классов возвращаются. Можно всегда гарантировать для получения одного объекта на элемент на области монтажа включением
NSPasteboardItem
класс в массиве классов.Рассмотрите следующий пример: на области монтажа существует пять элементов, два содержат данные TIFF, два содержат данные RTF, каждый содержит частный тип данных. Следующая таблица показывает то, что возражает, что Вы возвращаетесь в возвращенном массиве для различных классов в
classArray
.Классы в
classArray
Возвращенные объекты
NSImage
Два
NSImage
объекты.NSAttributedString
Два
NSAttributedString
объекты.NSImage
,NSAttributedString
Два
NSImage
объекты, и дваNSAttributedString
объекты.NSImage
,NSAttributedString
,NSPasteboardItem
Два
NSImage
объекты, дваNSAttributedString
объекты, и одинNSPasteboardItem
объект, содержащий частный тип данных.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.6 и позже.
-
pasteboardItems pasteboardItems
СвойствоМассив, содержащий все элементы, сохраненные получателем или
nil
если существует ошибка при получении элементов области монтажа. (только для чтения)Объявление
Swift
var pasteboardItems: [AnyObject]? { get }
Objective C
@property(readonly, copy) NSArray *pasteboardItems
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.6 и позже.
См. также
-
Возвращает индекс указанного элемента области монтажа.
Объявление
Swift
func indexOfPasteboardItem(_
pasteboardItem
: NSPasteboardItem) -> IntObjective C
- (NSUInteger)indexOfPasteboardItem:(NSPasteboardItem *)
pasteboardItem
Параметры
pasteboardItem
Элемент области монтажа.
Возвращаемое значение
Индекс указанного элемента области монтажа. Если
pasteboardItem
не был добавлен ни к какой области монтажа или принадлежит другой области монтажа, возвратамNSNotFound
.Обсуждение
Индекс элемента в области монтажа полезен для провайдера данных элемента области монтажа, обещавшего данные для многократных элементов, чтобы быть в состоянии легко соответствовать элемент области монтажа к массиву исходных данных, из которых можно получить обещанные данные.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.6 и позже.
-
Возвращает данные для указанного типа от первого элемента в получателе, содержащем тип.
Объявление
Параметры
dataType
Тип данных Вы хотите читать из области монтажа. Это значение должно быть одним из типов, возвращенных
types
илиavailableTypeFromArray:
.Возвращаемое значение
Объект данных, содержащий данные для указанного типа от первого элемента в получателе, содержащем тип, или
nil
если содержание области монтажа изменилось, так как они были в последний раз проверены.Этот метод может также возвратиться
nil
если владелец области монтажа является медленным в ответе к a, если сервер области монтажа не может снабдить данными своевременно — например,pasteboard:provideDataForType:
обменивайтесь сообщениями и межпроцессное взаимодействие испытывает таймаут.Обсуждение
Ошибки кроме тайм-аута повышают
NSPasteboardCommunicationException
.Если
nil
возвращается, приложение должно поднять панель, сообщающую пользователю, что это было неспособно выполнить операцию вставки. Обратите внимание на то, что отправкаtypes
илиavailableTypeFromArray:
перед вызовомdataForType:
может помочь Вам определить ли anil
следуйте из метода чтения, вследствие чего-то как тайм-аут области монтажа.Специальные замечания
Для стандартных типов данных text, таких как строка, RTF и RTFD, текстовые данные от каждого элемента возвращаются как один объединенный результат, разделенный новыми строками.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Возвращает список свойств для указанного типа от первого элемента в получателе, содержащем тип.
Объявление
Swift
func propertyListForType(_
dataType
: String) -> AnyObject?Objective C
- (id)propertyListForType:(NSString *)
dataType
Параметры
dataType
Тип данных области монтажа, содержащий данные списка свойств.
Возвращаемое значение
Список свойств объектов указанного типа, полученного из первого элемента в получателе, содержащем тип. Возвращенный список свойств может содержать любую комбинацию объектов, пока каждый объект является допустимым типом списка свойств (для списка типов, посмотрите список свойств).
Обсуждение
Этот метод вызывает
dataForType:
метод.Специальные замечания
Это - хорошая идея проверить
types
или вызовитеavailableTypeFromArray:
перед вызовомpropertyListForType:
. Несмотря на то, что выполнение этой проверки не требуется, делание так может помочь Вам определить если anil
следуйте из метода чтения, вследствие чего-то как тайм-аут области монтажа.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Возвращает связь строк для указанного типа от всех элементов в получателе, содержащих тип.
Объявление
Параметры
dataType
Тип данных области монтажа для чтения.
Возвращаемое значение
Связь строк для указанного типа от всех элементов в получателе, содержащих тип, или
nil
если ни один из элементов не содержит строки указанного типа.Обсуждение
Этот метод вызывает
dataForType:
получить строку. Если строка не может быть получена,stringForType:
возвратыnil
. ПосмотритеdataForType:
для описания того, что вызоветnil
быть возвращенным.В OS X v10.6 и позже, если получатель содержит многократные элементы, которые могут обеспечить строку, RTF или данные RTFD, текстовые данные от каждого элемента возвращаются как объединенный результат, разделенный новыми строками.
Специальные замечания
Это - хорошая идея проверить
types
или вызовитеavailableTypeFromArray:
перед вызовомstringForType:
. Несмотря на то, что выполнение этой проверки не требуется, делание так может помочь Вам определить если anil
следуйте из метода чтения, вследствие чего-то как тайм-аут области монтажа.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Сканирует указанные типы для типа, который поддерживает получатель.
Объявление
Swift
func availableTypeFromArray(_
types
: [AnyObject]) -> String?Параметры
types
Массив
NSString
объекты, указывающие область монтажа, вводят Вашу поддержку приложений в предпочтительном порядке.Возвращаемое значение
Первая область монтажа вводит
types
это доступно на области монтажа, илиnil
если получатель не содержит ни одного из типов вtypes
.Обсуждение
Вы используете этот метод для определения лучшего представления, доступного на области монтажа. Например, если Ваша поддержка приложений RTFD, RTF и строковые данные, то Вы могли бы вызвать метод следующим образом:
NSArray *supportedTypes =
[NSArray arrayWithObjects: NSRTFDPboardType, NSRTFPboardType, NSStringPboardType, nil];
NSString *bestType = [[NSPasteboard generalPasteboard]
availableTypeFromArray:supportedTypes];
Если область монтажа содержит RTF и строковые данные, то
bestType
содержал быNSRTFPboardType
. Если область монтажа не содержит ни один из типов вsupportedTypes
, тогдаbestType
был быnil
.Необходимо отправить a
types
илиavailableTypeFromArray:
сообщение прежде, чем считать любые данные изNSPasteboard
объект. Если необходимо видеть, соответствует ли тип в возвращенном массиве строку типа, Вы сохранили локально, используйтеisEqualToString:
метод для выполнения сравнения.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Возвращает булево значение, указывающее, содержит ли получатель какие-либо элементы, соответствующие указанному UTIs.
Объявление
Swift
func canReadItemWithDataConformingToTypes(_
types
: [AnyObject]) -> BoolObjective C
- (BOOL)canReadItemWithDataConformingToTypes:(NSArray *)
types
Параметры
types
Массив
NSString
объекты, содержащие UTIs.Возвращаемое значение
YES
true
если получатель содержит какие-либо элементы, соответствующие UTIs, указанному вtypes
, иначеNO
false
.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.6 и позже.
-
Возвращает булево значение, указывающее, содержит ли получатель какие-либо элементы, которые могут быть представлены как экземпляр любого класса в данном массиве.
Объявление
Swift
func canReadObjectForClasses(_
classArray
: [AnyObject], optionsoptions
: [NSObject : AnyObject]?) -> BoolObjective C
- (BOOL)canReadObjectForClasses:(NSArray *)
classArray
options:(NSDictionary *)options
Параметры
classArray
Массив объектов класса.
Классы в массиве должны соответствовать
NSPasteboardReading
протокол.options
Словарь, указывающий опции совершенствовать поиск элементов области монтажа, например ограничить поиск для регистрации URLs с определенными типами контента. Для допустимых ключей словаря посмотрите, что Область монтажа Читает Опции.
Возвращаемое значение
YES
true
если получатель содержит какие-либо элементы, которые могут быть представлены как экземпляр класса, указанного вclassArray
, иначеNO
false
.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.6 и позже.
-
Массив поддерживаемых типов данных получателя. (только для чтения)
Объявление
Swift
var types: [AnyObject]? { get }
Objective C
@property(readonly, copy) NSArray *types
Обсуждение
types
массив является массивомNSString
объекты, содержащие объединение типов данных, объявляются для всех элементов области монтажа на получателе. Возвращенные типы перечислены в порядке, которым они были объявлены. Это - хорошая идея проверить значениеtypes
(или вызватьavailableTypeFromArray:
) прежде, чем считать любые данные изNSPasteboard
объект. Если необходимо видеть если тип вtypes
выстройте соответствует строку типа, которую Вы сохранили локально, используйтеisEqualToString:
метод для выполнения сравнения.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Возвращает типы данных, которые могут быть преобразованы в указанный тип с помощью доступных служб фильтра.
Объявление
Swift
class func typesFilterableTo(_
type
: String) -> [AnyObject]Параметры
type
Целевой тип данных.
Возвращаемое значение
Массив
NSString
объекты, содержащие типы, которые могут быть преобразованы в целевой тип данных.Обсуждение
Массив также содержит исходный тип.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Имя получателя. (только для чтения)
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
changeCount changeCount
СвойствоКоличество изменения получателя. (только для чтения)
Обсуждение
Когда клиент создает получатель и становится первым владельцем, количество изменения запускается в нуле. Количество изменения впоследствии постепенно увеличивает каждый раз изменения владения области монтажа.
Количество изменения также возвращается из
clearContents
иdeclareTypes:owner:
. Можно поэтому записать значениеchangeCount
в то время, когда Вы берете владение области монтажа и сравниваете его с более поздним значением, чтобы определить, есть ли у Вас все еще владение.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
Эти методы, которыми все управляют на том, что является концептуально первым элементом на области монтажа. Они принимают UTIs и строки типа pboard. В будущем выпуске они могут взять только UTIs.
-
Подготавливает получатель для разнообразия в его содержании путем объявления новых типов данных, которые он будет содержать и новый владелец.
Объявление
Swift
func declareTypes(_
newTypes
: [AnyObject], ownernewOwner
: AnyObject?) -> IntПараметры
newTypes
Массив
NSString
объекты, указывающие типы данных, которые могут быть добавлены к новой области монтажа. Типы должны быть упорядочены согласно предпочтению исходного приложения, с самым предпочтительным бывшим на первом месте типом (обычно, самое богатое представление).newOwner
Объект, ответственный за запись данных к области монтажа, или
nil
если Вы предоставляете данные для всех типов сразу. Если Вы указываете anewOwner
объект, это должно поддерживать все типы, объявленные вnewTypes
параметр и должен остаться живым столько, сколько данные обещаны на области монтажа.Возвращаемое значение
Новое количество изменения получателя.
Обсуждение
Этот метод является эквивалентом вызова
clearContents
, неявно при записи первого элемента области монтажа и затем вызоваaddTypes:owner:
обещать типы для первого элемента области монтажа.Специальные замечания
В целом Вы не должны использовать этот метод с
writeObjects:
, с тех порwriteObjects:
будет всегда писать дополнительные элементы в область монтажа и не будет уже влиять на элементы на области монтажа, включая элемент, неявно создаваемый этим методом.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
– clearContents
– addTypes:owner:
– changeCount
pasteboard:provideDataForType:
(NSPasteboardOwner
Неофициальный протокол) -
Добавляют обещания для указанных типов к первому элементу области монтажа.
Объявление
Swift
func addTypes(_
newTypes
: [AnyObject], ownernewOwner
: AnyObject?) -> IntПараметры
newTypes
Массив
NSString
объекты, каждый из которых указывает тип данных, которые могут быть предоставлены области монтажа.newOwner
Объект, предоставляющий данные для указанных типов.
Если данные для тех типов сразу предоставлены, владелец может быть
nil
. Если данные для добавленных типов будут предоставлены лениво, когда требуется от области монтажа, объект владельца должен состоять в том при условии, что реализации -pasteboard:provideDataForType:
методNSPasteboardOwner
неофициальный протокол.Возвращаемое значение
Новое количество изменения, или
0
если была ошибка при добавлении типов.Обсуждение
Этот метод добавляет обещания для указанных типов к первому элементу области монтажа.
Вы используете это методы для объявления дополнительных типов данных для первого элемента области монтажа в получателе. Можно также использовать его для замены существующих типов, добавленных предыдущим
declareTypes:owner:
илиaddTypes:owner:
сообщение.newTypes
параметр указывает типы данных, которые Вы обещаете области монтажа. Типы должны быть упорядочены согласно предпочтению исходного приложения, с самым предпочтительным бывшим на первом месте типом (обычно, самое богатое представление). Новые типы добавляются до конца списка, содержащего любые существующие типы, если таковые имеются.Если Вы указываете тип, уже объявленный, этот метод заменяет владельца того типа со значением в
newOwner
. Кроме того, любые данные, уже уже записанные в область монтажа для того типа, удалены.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Пишет содержание указанного файла к области монтажа.
Объявление
Swift
func writeFileContents(_
filename
: String) -> BoolObjective C
- (BOOL)writeFileContents:(NSString *)
filename
Параметры
filename
Имя файла для записи в область монтажа.
Возвращаемое значение
YES
true
если данные были успешно записаны, иначеNO
false
.Обсуждение
Пишет содержание файла
filename
к получателю и объявляет, что данные имеют типNSFileContentsPboardType
и также типа, подходящего для расширения файла (как возвращеноNSCreateFileContentsPboardType
функционируйте, когда передано расширение файлов), если оно имеет тот.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Пишет сериализированное содержание указанной обертки файла к области монтажа.
Объявление
Swift
func writeFileWrapper(_
wrapper
: NSFileWrapper) -> BoolObjective C
- (BOOL)writeFileWrapper:(NSFileWrapper *)
wrapper
Параметры
wrapper
Обертка файла для записи в область монтажа.
Возвращаемое значение
YES
true
если данные были успешно записаны, иначеNO
false
.Обсуждение
Пишет сериализированное содержание обертки файла
wrapper
к получателю и объявляет, что данные имеют типNSFileContentsPboardType
и также типа, подходящего для расширения файла (как возвращеноNSCreateFileContentsPboardType
функционируйте, когда передано расширение файлов), если оно имеет тот. Еслиwrapper
не имеет предпочтительного имени файла, этот метод повышает исключение.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
Эти методы, которыми все управляют на том, что является концептуально первым элементом на области монтажа. Они принимают UTIs и строки типа pboard. В будущем выпуске они могут взять только UTIs.
-
Данные чтений, представляющие содержание файла от получателя и записей это к указанному файлу.
Объявление
Параметры
type
Тип данных области монтажа для чтения. Необходимо обычно указывать значение для этого параметра. Если Вы указываете
nil
, расширение файла (в сочетании сNSCreateFileContentsPboardType
функция), используется для определения типа.filename
Файл для получения данных области монтажа.
Возвращаемое значение
Имя файла, в который были фактически записаны данные.
Обсуждение
Данные любого типа содержания файла должны только быть считаны с помощью этого метода. Если данные, соответствующие указанный тип, не найдены на области монтажа, данных типа
NSFileContentsPboardType
требуется.Специальные замечания
Необходимо отправить
availableTypeFromArray:
илиtypes
сообщение перед вызовомreadFileContentsType:toFile:
.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Данные чтений, представляющие содержание файла от получателя и возвратов это как обертка файла.
Объявление
Swift
func readFileWrapper() -> NSFileWrapper?
Objective C
- (NSFileWrapper *)readFileWrapper
Возвращаемое значение
Обертка файла, содержащая данные области монтажа, или
nil
если получатель не содержал данных типаNSFileContentsPboardType
.Обсуждение
В OS X v10.5 и ранее, содержание файла pboard тип позволило Вам синтезировать тип pboard для содержания файла на основе расширения файла. В OS X v10.5 и позже, с помощью UTI файла для представления его содержания теперь заменяет эту функциональность.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
NSPasteboard
класс определяет следующие именованные области монтажа.Объявление
Swift
var NSGeneralPboard: NSString! var NSFontPboard: NSString! var NSRulerPboard: NSString! var NSFindPboard: NSString! var NSDragPboard: NSString!
Objective C
NSString *NSGeneralPboard; NSString *NSFontPboard; NSString *NSRulerPboard; NSString *NSFindPboard; NSString *NSDragPboard;
Константы
-
NSGeneralPboard
NSGeneralPboard
Область монтажа это используется для обычного сокращения, копии и операций вставки.
Эта область монтажа содержит содержание последнего выбора, это было сокращено или скопировано.
Доступный в OS X v10.0 и позже.
-
NSFontPboard
NSFontPboard
Область монтажа, содержащая шрифт и символьную информацию и поддерживающая команды Copy Font и Paste Font, которые могут быть реализованы в текстовом редакторе.
Доступный в OS X v10.0 и позже.
-
NSRulerPboard
NSRulerPboard
Область монтажа, содержащая информацию о форматах абзаца в поддержку команд Copy Ruler и Paste Ruler, которые могут быть реализованы в текстовом редакторе.
Доступный в OS X v10.0 и позже.
-
NSFindPboard
NSFindPboard
Область монтажа, содержащая информацию о текущем состоянии панели находки активного приложения.
Эта информация разрешает пользователям вводить строку поиска в панель находки, затем переключаться на другое приложение для проведения другого поиска.
Доступный в OS X v10.0 и позже.
-
NSDragPboard
NSDragPboard
Область монтажа, хранящая данные, которые будут перемещены как результат работы перетаскивания.
Для получения дополнительной информации о работе с областью монтажа перетаскивания посмотрите, что Перетаскивание Программирует Темы.
Доступный в OS X v10.0 и позже.
-
-
NSPasteboard
класс использует следующие константы для определения UTIs для общих типов данных области монтажа.Объявление
Swift
let NSPasteboardTypeString: NSString! let NSPasteboardTypePDF: NSString! let NSPasteboardTypeTIFF: NSString! let NSPasteboardTypePNG: NSString! let NSPasteboardTypeRTF: NSString! let NSPasteboardTypeRTFD: NSString! let NSPasteboardTypeHTML: NSString! let NSPasteboardTypeTabularText: NSString! let NSPasteboardTypeFont: NSString! let NSPasteboardTypeRuler: NSString! let NSPasteboardTypeColor: NSString! let NSPasteboardTypeSound: NSString! let NSPasteboardTypeMultipleTextSelection: NSString! let NSPasteboardTypeFindPanelSearchOptions: NSString!
Objective C
NSString *const NSPasteboardTypeString; NSString *const NSPasteboardTypePDF; NSString *const NSPasteboardTypeTIFF; NSString *const NSPasteboardTypePNG; NSString *const NSPasteboardTypeRTF; NSString *const NSPasteboardTypeRTFD; NSString *const NSPasteboardTypeHTML; NSString *const NSPasteboardTypeTabularText; NSString *const NSPasteboardTypeFont; NSString *const NSPasteboardTypeRuler; NSString *const NSPasteboardTypeColor; NSString *const NSPasteboardTypeSound; NSString *const NSPasteboardTypeMultipleTextSelection; NSString *const NSPasteboardTypeFindPanelSearchOptions;
Константы
-
NSPasteboardTypeString
NSPasteboardTypeString
Доступный в OS X v10.6 и позже.
-
NSPasteboardTypePDF
NSPasteboardTypePDF
Данные PDF.
Доступный в OS X v10.6 и позже.
-
NSPasteboardTypeTIFF
NSPasteboardTypeTIFF
Данные Tag Image File Format (TIFF).
Доступный в OS X v10.6 и позже.
-
NSPasteboardTypePNG
NSPasteboardTypePNG
Данные изображения PNG.
Доступный в OS X v10.6 и позже.
-
NSPasteboardTypeRTF
NSPasteboardTypeRTF
Данные Формата Rich Text Format (RTF).
Доступный в OS X v10.6 и позже.
-
NSPasteboardTypeRTFD
NSPasteboardTypeRTFD
RTFD отформатировал содержание файла.
Доступный в OS X v10.6 и позже.
-
NSPasteboardTypeHTML
NSPasteboardTypeHTML
Данные HTML.
Доступный в OS X v10.6 и позже.
-
NSPasteboardTypeTabularText
NSPasteboardTypeTabularText
NSString
объект, содержащий разделенные от вкладки поля текста.Доступный в OS X v10.6 и позже.
-
NSPasteboardTypeFont
NSPasteboardTypeFont
Шрифт и символьная информация.
Доступный в OS X v10.6 и позже.
-
NSPasteboardTypeRuler
NSPasteboardTypeRuler
Информация о форматировании абзаца.
Доступный в OS X v10.6 и позже.
-
NSPasteboardTypeColor
NSPasteboardTypeColor
Цветные данные (
NSColor
объект).Доступный в OS X v10.6 и позже.
-
NSPasteboardTypeSound
NSPasteboardTypeSound
Звуковые данные (
NSSound
объект).Доступный в OS X v10.6 и позже.
-
NSPasteboardTypeMultipleTextSelection
NSPasteboardTypeMultipleTextSelection
Многократный текстовый выбор.
Доступный в OS X v10.6 и позже.
-
NSPasteboardTypeFindPanelSearchOptions
NSPasteboardTypeFindPanelSearchOptions
Введите для списка свойств метаданных панели Find.
Доступный в OS X v10.6 и позже.
-
-
NSPasteboard
класс использует следующие общие типы данных области монтажа.Объявление
Swift
var NSColorPboardType: NSString! var NSFileContentsPboardType: NSString! var NSFilenamesPboardType: NSString! var NSFontPboardType: NSString! var NSHTMLPboardType: NSString! var NSPDFPboardType: NSString! var NSPostScriptPboardType: NSString! var NSRulerPboardType: NSString! var NSRTFPboardType: NSString! var NSRTFDPboardType: NSString! var NSStringPboardType: NSString! var NSTabularTextPboardType: NSString! var NSTIFFPboardType: NSString! var NSURLPboardType: NSString! var NSVCardPboardType: NSString! var NSFilesPromisePboardType: NSString! var NSInkTextPboardType: NSString! var NSMultipleTextSelectionPboardType: NSString! let NSPasteboardTypeTextFinderOptions: NSString!
Objective C
NSString *NSStringPboardType; NSString *NSFilenamesPboardType; NSString *NSPostScriptPboardType; NSString *NSTIFFPboardType; NSString *NSRTFPboardType; NSString *NSTabularTextPboardType; NSString *NSFontPboardType; NSString *NSRulerPboardType; NSString *NSFileContentsPboardType; NSString *NSColorPboardType; NSString *NSRTFDPboardType; NSString *NSHTMLPboardType; NSString *NSPICTPboardType; NSString *NSURLPboardType; NSString *NSPDFPboardType; NSString *NSVCardPboardType; NSString *NSFilesPromisePboardType; NSString *NSMultipleTextSelectionPboardType;
Константы
-
NSColorPboardType
NSColorPboardType
NSColor
данные.На OS X v10.6 и позже, использовать
NSPasteboardTypeColor
(и Вы читаете и пишете цвета непосредственно в и от области монтажа).Доступный в OS X v10.0 и позже.
-
NSFileContentsPboardType
NSFileContentsPboardType
Представление содержания файла.
Содержание файла pboard тип позволило Вам синтезировать тип pboard для содержания файла на основе расширения файла.
На OS X v10.6 и позже, необходимо использовать UTI файла для представления его содержания вместо этого.
Доступный в OS X v10.0 и позже.
-
NSFilenamesPboardType
NSFilenamesPboardType
Массив
NSString
объекты, определяющие одни или более имен файлов.На OS X v10.6 и позже, использовать
writeObjects:
записать файлу URLs в область монтажа.Доступный в OS X v10.0 и позже.
-
NSFontPboardType
NSFontPboardType
Шрифт и символьная информация.
На OS X v10.6 и позже, использовать
NSPasteboardTypeFont
вместо этого.Доступный в OS X v10.0 и позже.
-
NSHTMLPboardType
NSHTMLPboardType
HTML (который
NSTextView
объект может читать из, но не записать в).На OS X v10.6 и позже, использовать
NSPasteboardTypeHTML
вместо этого.Доступный в OS X v10.1 и позже.
-
NSPDFPboardType
NSPDFPboardType
Данные PDF.
На OS X v10.6 и позже, использовать
NSPasteboardTypePDF
вместо этого.Доступный в OS X v10.0 и позже.
-
NSPICTPboardType
NSPICTPboardType
Данные изображения QuickDraw.
Формат PICT формально осуждался в OS X v10.4 вместе с QuickDraw. Вы не должны явно обеспечивать или искать данные PICT по области монтажа.
Помочь в этом осуждении, если PICT является единственным типом изображения на области монтажа, как, иногда имеет место при копировании изображений с 32-разрядных приложений Углерода, о переведенном типе изображения автоматически сообщат и предоставлены
NSPasteboard
. Переведенный тип добавляется к массиву типов перед PICT так, чтобы осуждаемый формат PICT не был предпочтительным форматом. Кроме того, когда приложение обеспечивает данные изображения дляNSPasteboard
, менеджер по Области монтажа Углерода автоматически сделает перевод PICT доступным для 32-разрядных приложений Углерода.Несмотря на то, что
NSPICTPboardType
, и его эквивалент UTIkUTTypePICT
, появится в массиве типа области монтажа, полученном от существующегоNSPasteboard
API, это может прекратить сообщаться в будущих выпусках.Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.6.
-
NSPostScriptPboardType
NSPostScriptPboardType
Инкапсулированный формат PostScript (EPS) код.
На OS X v10.6 и позже, использовать
@"com.adobe.encapsulated-postscript"
вместо этого.Доступный в OS X v10.0 и позже.
-
NSRulerPboardType
NSRulerPboardType
Информация о форматировании абзаца.
На OS X v10.6 и позже, использовать
NSPasteboardTypeRuler
вместо этого.Доступный в OS X v10.0 и позже.
-
NSRTFPboardType
NSRTFPboardType
Данные Формата Rich Text Format (RTF).
На OS X v10.6 и позже, использовать
NSPasteboardTypeRTF
вместо этого.Доступный в OS X v10.0 и позже.
-
NSRTFDPboardType
NSRTFDPboardType
RTFD отформатировал содержание файла.
На OS X v10.6 и позже, использовать
NSPasteboardTypeRTFD
вместо этого.Доступный в OS X v10.0 и позже.
-
NSStringPboardType
NSStringPboardType
NSString
данные.В приложениях, принимающих Тестовую среду приложения, используйте
NSURL
объект, закладка или область монтажа имени файла вводят вместо этого. В непоигравшем в песочнице приложении можно также использоватьNSPasteboardTypeString
тип области монтажа.Доступный в OS X v10.0 и позже.
-
NSTabularTextPboardType
NSTabularTextPboardType
NSString
объект, содержащий разделенные от вкладки поля текста.На OS X v10.6 и позже, использовать
NSPasteboardTypeTabularText
вместо этого.Доступный в OS X v10.0 и позже.
-
NSTIFFPboardType
NSTIFFPboardType
Данные Tag Image File Format (TIFF).
На OS X v10.6 и позже, использовать
NSPasteboardTypeTIFF
вместо этого.Доступный в OS X v10.0 и позже.
-
NSURLPboardType
NSURLPboardType
NSURL
данные для одного файла или ресурса.На OS X v10.6 и позже, использовать
writeObjects:
записать URLs непосредственно в область монтажа вместо этого.На OS X v10.5 и ранее: для записи URL в область монтажа, Вы используете
writeToPasteboard:
(NSURL
); для получения URL от области монтажа, Вы используетеURLFromPasteboard:
(NSURL
).Доступный в OS X v10.0 и позже.
-
NSVCardPboardType
NSVCardPboardType
Данные VCard.
На OS X v10.6 и позже, использовать
(NSString *)kUTTypeVCard
вместо этого.Доступный в OS X v10.2 и позже.
-
NSFilesPromisePboardType
NSFilesPromisePboardType
Обещанные файлы.
На OS X v10.6 и позже, использовать
(NSString *)kPasteboardTypeFileURLPromise
вместо этого.Для получения информации об обещанных файлах посмотрите Файлы Перетаскивания в одежде представителя противоположного пола и Темы Программирования Отбрасывания.
Доступный в OS X v10.2 и позже.
-
NSInkTextPboardType
NSInkTextPboardType
Текстовые данные чернил.
На OS X v10.6 и позже, использовать
(NSString *)kUTTypeInkText
вместо этого.Для получения информации о текстовых объектах чернил посмотрите Using Ink Services в Своем Приложении.
Доступный в OS X v10.4 и позже.
-
NSMultipleTextSelectionPboardType
NSMultipleTextSelectionPboardType
Многократный текстовый выбор.
На OS X v10.6 и позже, использовать
NSPasteboardTypeMultipleTextSelection
вместо этого.Доступный в OS X v10.5 и позже.
-
NSPasteboardTypeTextFinderOptions
NSPasteboardTypeTextFinderOptions
Введите для списка свойств метаданных панели Find..
Доступный в OS X v10.7 и позже.
Обсуждение
См. также
NSSoundPboardType
(NSSound
). -
-
Эти опции могут использоваться для обоих
readObjectsForClasses:options:
иcanReadObjectForClasses:options:
методы, если не указано иное. В настоящее время доступные параметры допускают настройку того, как URLS читается из области монтажа.Объявление
Swift
let NSPasteboardURLReadingFileURLsOnlyKey: NSString! let NSPasteboardURLReadingContentsConformToTypesKey: NSString!
Objective C
NSString *NSPasteboardURLReadingFileURLsOnlyKey; NSString *NSPasteboardURLReadingContentsConformToTypesKey;
Константы
-
NSPasteboardURLReadingFileURLsOnlyKey
NSPasteboardURLReadingFileURLsOnlyKey
Опция для чтения URLs для ограничения результатов зарегистрировать URLs только.
Значение для этого ключа
NSNumber
объект с булевым значением.Доступный в OS X v10.6 и позже.
-
NSPasteboardURLReadingContentsConformToTypesKey
NSPasteboardURLReadingContentsConformToTypesKey
Опция для чтения URLs для ограничения результатов URLs с содержанием, соответствующим любому из предоставленных типов UTI.
Если тип контента URL не может быть определен, это, как будут полагать, не будет соответствовать. Значение для этого ключа является массивом строк типа UTI.
Доступный в OS X v10.6 и позже.
-