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() -> NSPasteboardObjective 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(byFilteringFilefilename: String) -> NSPasteboardObjective C
+ (NSPasteboard *)pasteboardByFilteringFile:(NSString *)filenameПараметры
filenameИмя файла, чтобы поставить область монтажа.
Возвращаемое значение
Новый объект области монтажа.
Обсуждение
Никакая служба фильтра не вызывается, пока данные фактически не запрашиваются, так вызов этого метода довольно недорог.
Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.0 и позже.
-
Создает и возвращает новую область монтажа с уникальным именем, снабжающим указанными данными области монтажа в как можно большем количестве типов, данных доступные службы фильтра.
Объявление
Swift
init(byFilteringTypesInPasteboardpasteboard: NSPasteboard) -> NSPasteboardObjective C
+ (NSPasteboard *)pasteboardByFilteringTypesInPasteboard:(NSPasteboard *)pasteboardПараметры
pasteboardИсходный объект области монтажа.
Возвращаемое значение
Новый объект области монтажа. Этот метод возвращает объект в
pasteboardпараметр, если область монтажа была возвращена одним изpasteboardByFiltering...методы. Это препятствует тому, чтобы область монтажа была расширена многократно.Обсуждение
Этот процесс может считаться расширением области монтажа, потому что новая область монтажа обычно содержит больше представлений данных, чем
pasteboard.Этот метод только возвращает исходные типы и типы, которые могут быть созданы в результате единственного фильтра; область монтажа не имеет определенных типов, которые являются результатом перевода многократными фильтрами.
Никакая служба фильтра не вызывается, пока данные фактически не запрашиваются, так вызов этого метода довольно недорог.
Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.0 и позже.
-
Возвращает область монтажа с указанным именем.
Объявление
Swift
init(namename: String) -> NSPasteboardObjective C
+ (NSPasteboard *)pasteboardWithName:(NSString *)nameПараметры
nameИмя области монтажа. Имена стандартных областей монтажа даны на Имена Области монтажа.
Возвращаемое значение
Область монтажа связалась с именем или новым
NSPasteboardвозразите, не имеет ли приложение еще объекта области монтажа для указанного имени.Обсуждение
Другие имена могут быть присвоены создать частные области монтажа для других целей.
Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.0 и позже.
-
Создает и возвращает новую область монтажа с именем, которое, как гарантируют, будет уникально относительно других областей монтажа на компьютере.
Объявление
Swift
class func pasteboardWithUniqueName() -> NSPasteboardObjective 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).Возвращаемое значение
YEStrueесли массив был успешно добавлен, иначеNOfalse.Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.6 и позже.
-
Устанавливает определенные данные как представление для указанного типа для первого элемента на получателе.
Объявление
Параметры
dataДанные для записи в область монтажа.
dataTypeТип данных в
dataпараметр. Тип, должно быть, был объявлен предыдущимdeclareTypes:owner:сообщение.Возвращаемое значение
YEStrueесли данные были записаны успешно, иначеNOfalseесли изменилось владение области монтажа. Любая другая ошибка повышаетNSPasteboardCommunicationException.Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.0 и позже.
-
Устанавливает данный список свойств как представление для указанного типа для первого элемента на получателе.
Объявление
Swift
func setPropertyList(_propertyList: AnyObject, forTypedataType: String) -> BoolObjective C
- (BOOL)setPropertyList:(id)propertyListforType:(NSString *)dataTypeПараметры
propertyListДанные списка свойств для записи в область монтажа.
dataTypeТип данных списка свойств в
propertyListпараметр. Тип, должно быть, был объявлен предыдущимdeclareTypes:owner:сообщение.Возвращаемое значение
YEStrueесли данные были записаны успешно, иначеNOfalseесли изменилось владение области монтажа. Любая другая ошибка повышаетNSPasteboardCommunicationException.Обсуждение
Этот метод вызывает
setData:forType:с сериализированным параметром списка свойств.Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.0 и позже.
-
Устанавливает данную строку как представление для указанного типа для первого элемента на получателе.
Объявление
Параметры
stringСтрока для записи в область монтажа.
dataTypeТип строковых данных. Тип, должно быть, был объявлен предыдущим
declareTypes:owner:сообщение.Возвращаемое значение
YEStrueесли данные были записаны успешно, иначеNOfalseесли изменилось владение области монтажа. Любая другая ошибка повышает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 *)classArrayoptions:(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.Возвращаемое значение
YEStrueесли получатель содержит какие-либо элементы, соответствующие UTIs, указанному вtypes, иначеNOfalse.Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.6 и позже.
-
Возвращает булево значение, указывающее, содержит ли получатель какие-либо элементы, которые могут быть представлены как экземпляр любого класса в данном массиве.
Объявление
Swift
func canReadObjectForClasses(_classArray: [AnyObject], optionsoptions: [NSObject : AnyObject]?) -> BoolObjective C
- (BOOL)canReadObjectForClasses:(NSArray *)classArrayoptions:(NSDictionary *)optionsПараметры
classArrayМассив объектов класса.
Классы в массиве должны соответствовать
NSPasteboardReadingпротокол.optionsСловарь, указывающий опции совершенствовать поиск элементов области монтажа, например ограничить поиск для регистрации URLs с определенными типами контента. Для допустимых ключей словаря посмотрите, что Область монтажа Читает Опции.
Возвращаемое значение
YEStrueесли получатель содержит какие-либо элементы, которые могут быть представлены как экземпляр класса, указанного вclassArray, иначеNOfalse.Оператор импорта
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:– changeCountpasteboard: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Имя файла для записи в область монтажа.
Возвращаемое значение
YEStrueесли данные были успешно записаны, иначеNOfalse.Обсуждение
Пишет содержание файла
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Обертка файла для записи в область монтажа.
Возвращаемое значение
YEStrueесли данные были успешно записаны, иначеNOfalse.Обсуждение
Пишет сериализированное содержание обертки файла
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;Константы
-
NSGeneralPboardNSGeneralPboardОбласть монтажа это используется для обычного сокращения, копии и операций вставки.
Эта область монтажа содержит содержание последнего выбора, это было сокращено или скопировано.
Доступный в OS X v10.0 и позже.
-
NSFontPboardNSFontPboardОбласть монтажа, содержащая шрифт и символьную информацию и поддерживающая команды Copy Font и Paste Font, которые могут быть реализованы в текстовом редакторе.
Доступный в OS X v10.0 и позже.
-
NSRulerPboardNSRulerPboardОбласть монтажа, содержащая информацию о форматах абзаца в поддержку команд Copy Ruler и Paste Ruler, которые могут быть реализованы в текстовом редакторе.
Доступный в OS X v10.0 и позже.
-
NSFindPboardNSFindPboardОбласть монтажа, содержащая информацию о текущем состоянии панели находки активного приложения.
Эта информация разрешает пользователям вводить строку поиска в панель находки, затем переключаться на другое приложение для проведения другого поиска.
Доступный в OS X v10.0 и позже.
-
NSDragPboardNSDragPboardОбласть монтажа, хранящая данные, которые будут перемещены как результат работы перетаскивания.
Для получения дополнительной информации о работе с областью монтажа перетаскивания посмотрите, что Перетаскивание Программирует Темы.
Доступный в 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;Константы
-
NSPasteboardTypeStringNSPasteboardTypeStringДоступный в OS X v10.6 и позже.
-
NSPasteboardTypePDFNSPasteboardTypePDFДанные PDF.
Доступный в OS X v10.6 и позже.
-
NSPasteboardTypeTIFFNSPasteboardTypeTIFFДанные Tag Image File Format (TIFF).
Доступный в OS X v10.6 и позже.
-
NSPasteboardTypePNGNSPasteboardTypePNGДанные изображения PNG.
Доступный в OS X v10.6 и позже.
-
NSPasteboardTypeRTFNSPasteboardTypeRTFДанные Формата Rich Text Format (RTF).
Доступный в OS X v10.6 и позже.
-
NSPasteboardTypeRTFDNSPasteboardTypeRTFDRTFD отформатировал содержание файла.
Доступный в OS X v10.6 и позже.
-
NSPasteboardTypeHTMLNSPasteboardTypeHTMLДанные HTML.
Доступный в OS X v10.6 и позже.
-
NSPasteboardTypeTabularTextNSPasteboardTypeTabularTextNSStringобъект, содержащий разделенные от вкладки поля текста.Доступный в OS X v10.6 и позже.
-
NSPasteboardTypeFontNSPasteboardTypeFontШрифт и символьная информация.
Доступный в OS X v10.6 и позже.
-
NSPasteboardTypeRulerNSPasteboardTypeRulerИнформация о форматировании абзаца.
Доступный в OS X v10.6 и позже.
-
NSPasteboardTypeColorNSPasteboardTypeColorЦветные данные (
NSColorобъект).Доступный в OS X v10.6 и позже.
-
NSPasteboardTypeSoundNSPasteboardTypeSoundЗвуковые данные (
NSSoundобъект).Доступный в OS X v10.6 и позже.
-
NSPasteboardTypeMultipleTextSelectionNSPasteboardTypeMultipleTextSelectionМногократный текстовый выбор.
Доступный в OS X v10.6 и позже.
-
NSPasteboardTypeFindPanelSearchOptionsNSPasteboardTypeFindPanelSearchOptionsВведите для списка свойств метаданных панели 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;Константы
-
NSColorPboardTypeNSColorPboardTypeNSColorданные.На OS X v10.6 и позже, использовать
NSPasteboardTypeColor(и Вы читаете и пишете цвета непосредственно в и от области монтажа).Доступный в OS X v10.0 и позже.
-
NSFileContentsPboardTypeNSFileContentsPboardTypeПредставление содержания файла.
Содержание файла pboard тип позволило Вам синтезировать тип pboard для содержания файла на основе расширения файла.
На OS X v10.6 и позже, необходимо использовать UTI файла для представления его содержания вместо этого.
Доступный в OS X v10.0 и позже.
-
NSFilenamesPboardTypeNSFilenamesPboardTypeМассив
NSStringобъекты, определяющие одни или более имен файлов.На OS X v10.6 и позже, использовать
writeObjects:записать файлу URLs в область монтажа.Доступный в OS X v10.0 и позже.
-
NSFontPboardTypeNSFontPboardTypeШрифт и символьная информация.
На OS X v10.6 и позже, использовать
NSPasteboardTypeFontвместо этого.Доступный в OS X v10.0 и позже.
-
NSHTMLPboardTypeNSHTMLPboardTypeHTML (который
NSTextViewобъект может читать из, но не записать в).На OS X v10.6 и позже, использовать
NSPasteboardTypeHTMLвместо этого.Доступный в OS X v10.1 и позже.
-
NSPDFPboardTypeNSPDFPboardTypeДанные PDF.
На OS X v10.6 и позже, использовать
NSPasteboardTypePDFвместо этого.Доступный в OS X v10.0 и позже.
-
NSPICTPboardTypeNSPICTPboardTypeДанные изображения QuickDraw.
Формат PICT формально осуждался в OS X v10.4 вместе с QuickDraw. Вы не должны явно обеспечивать или искать данные PICT по области монтажа.
Помочь в этом осуждении, если PICT является единственным типом изображения на области монтажа, как, иногда имеет место при копировании изображений с 32-разрядных приложений Углерода, о переведенном типе изображения автоматически сообщат и предоставлены
NSPasteboard. Переведенный тип добавляется к массиву типов перед PICT так, чтобы осуждаемый формат PICT не был предпочтительным форматом. Кроме того, когда приложение обеспечивает данные изображения дляNSPasteboard, менеджер по Области монтажа Углерода автоматически сделает перевод PICT доступным для 32-разрядных приложений Углерода.Несмотря на то, что
NSPICTPboardType, и его эквивалент UTIkUTTypePICT, появится в массиве типа области монтажа, полученном от существующегоNSPasteboardAPI, это может прекратить сообщаться в будущих выпусках.Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.6.
-
NSPostScriptPboardTypeNSPostScriptPboardTypeИнкапсулированный формат PostScript (EPS) код.
На OS X v10.6 и позже, использовать
@"com.adobe.encapsulated-postscript"вместо этого.Доступный в OS X v10.0 и позже.
-
NSRulerPboardTypeNSRulerPboardTypeИнформация о форматировании абзаца.
На OS X v10.6 и позже, использовать
NSPasteboardTypeRulerвместо этого.Доступный в OS X v10.0 и позже.
-
NSRTFPboardTypeNSRTFPboardTypeДанные Формата Rich Text Format (RTF).
На OS X v10.6 и позже, использовать
NSPasteboardTypeRTFвместо этого.Доступный в OS X v10.0 и позже.
-
NSRTFDPboardTypeNSRTFDPboardTypeRTFD отформатировал содержание файла.
На OS X v10.6 и позже, использовать
NSPasteboardTypeRTFDвместо этого.Доступный в OS X v10.0 и позже.
-
NSStringPboardTypeNSStringPboardTypeNSStringданные.В приложениях, принимающих Тестовую среду приложения, используйте
NSURLобъект, закладка или область монтажа имени файла вводят вместо этого. В непоигравшем в песочнице приложении можно также использоватьNSPasteboardTypeStringтип области монтажа.Доступный в OS X v10.0 и позже.
-
NSTabularTextPboardTypeNSTabularTextPboardTypeNSStringобъект, содержащий разделенные от вкладки поля текста.На OS X v10.6 и позже, использовать
NSPasteboardTypeTabularTextвместо этого.Доступный в OS X v10.0 и позже.
-
NSTIFFPboardTypeNSTIFFPboardTypeДанные Tag Image File Format (TIFF).
На OS X v10.6 и позже, использовать
NSPasteboardTypeTIFFвместо этого.Доступный в OS X v10.0 и позже.
-
NSURLPboardTypeNSURLPboardTypeNSURLданные для одного файла или ресурса.На OS X v10.6 и позже, использовать
writeObjects:записать URLs непосредственно в область монтажа вместо этого.На OS X v10.5 и ранее: для записи URL в область монтажа, Вы используете
writeToPasteboard:(NSURL); для получения URL от области монтажа, Вы используетеURLFromPasteboard:(NSURL).Доступный в OS X v10.0 и позже.
-
NSVCardPboardTypeNSVCardPboardTypeДанные VCard.
На OS X v10.6 и позже, использовать
(NSString *)kUTTypeVCardвместо этого.Доступный в OS X v10.2 и позже.
-
NSFilesPromisePboardTypeNSFilesPromisePboardTypeОбещанные файлы.
На OS X v10.6 и позже, использовать
(NSString *)kPasteboardTypeFileURLPromiseвместо этого.Для получения информации об обещанных файлах посмотрите Файлы Перетаскивания в одежде представителя противоположного пола и Темы Программирования Отбрасывания.
Доступный в OS X v10.2 и позже.
-
NSInkTextPboardTypeNSInkTextPboardTypeТекстовые данные чернил.
На OS X v10.6 и позже, использовать
(NSString *)kUTTypeInkTextвместо этого.Для получения информации о текстовых объектах чернил посмотрите Using Ink Services в Своем Приложении.
Доступный в OS X v10.4 и позже.
-
NSMultipleTextSelectionPboardTypeNSMultipleTextSelectionPboardTypeМногократный текстовый выбор.
На OS X v10.6 и позже, использовать
NSPasteboardTypeMultipleTextSelectionвместо этого.Доступный в OS X v10.5 и позже.
-
NSPasteboardTypeTextFinderOptionsNSPasteboardTypeTextFinderOptionsВведите для списка свойств метаданных панели 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;Константы
-
NSPasteboardURLReadingFileURLsOnlyKeyNSPasteboardURLReadingFileURLsOnlyKeyОпция для чтения URLs для ограничения результатов зарегистрировать URLs только.
Значение для этого ключа
NSNumberобъект с булевым значением.Доступный в OS X v10.6 и позже.
-
NSPasteboardURLReadingContentsConformToTypesKeyNSPasteboardURLReadingContentsConformToTypesKeyОпция для чтения URLs для ограничения результатов URLs с содержанием, соответствующим любому из предоставленных типов UTI.
Если тип контента URL не может быть определен, это, как будут полагать, не будет соответствовать. Значение для этого ключа является массивом строк типа UTI.
Доступный в OS X v10.6 и позже.
-
