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

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

Разработчик

Ссылка платформы AppKit ссылка класса NSPasteboard

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

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

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

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

    Объявление

    Swift

    init(byFilteringData data: NSData, ofType type: String) -> NSPasteboard

    Objective C

    + (NSPasteboard *)pasteboardByFilteringData:(NSData *)data ofType:(NSString *)type

    Параметры

    data

    Данные, которые будут помещены в область монтажа.

    type

    Тип данных в data параметр.

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

    Новый объект области монтажа.

    Обсуждение

    Возвращенная область монтажа также объявляет данные предоставленного type.

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

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

    Объявление

    Swift

    init(byFilteringFile filename: String) -> NSPasteboard

    Objective C

    + (NSPasteboard *)pasteboardByFilteringFile:(NSString *)filename

    Параметры

    filename

    Имя файла, чтобы поставить область монтажа.

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

    Новый объект области монтажа.

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

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

    Объявление

    Swift

    init(byFilteringTypesInPasteboard pasteboard: NSPasteboard) -> NSPasteboard

    Objective 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) -> NSPasteboard

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

  • Очищает существующее содержание области монтажа

    Объявление

    Swift

    func clearContents() -> Int

    Objective C

    - (NSInteger)clearContents

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

    Количество изменения получателя.

    Обсуждение

    Очищает существующее содержание области монтажа, подготавливая его к новому содержанию. Это - первый шаг в предоставлении данных на области монтажа.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • Пишет массив объектов к получателю.

    Объявление

    Swift

    func writeObjects(_ objects: [AnyObject]) -> Bool

    Objective C

    - (BOOL)writeObjects:(NSArray *)objects

    Параметры

    objects

    Массив объектов, реализующих NSPasteboardWriting протокол (включая экземпляры NSPasteboardItem).

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

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

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

    Объявление

    Swift

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

    Objective C

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

    Параметры

    data

    Данные для записи в область монтажа.

    dataType

    Тип данных в data параметр. Тип, должно быть, был объявлен предыдущим declareTypes:owner: сообщение.

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

    YEStrue если данные были записаны успешно, иначе NOfalse если изменилось владение области монтажа. Любая другая ошибка повышает NSPasteboardCommunicationException.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

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

    Объявление

    Swift

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

    Objective C

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

    Параметры

    propertyList

    Данные списка свойств для записи в область монтажа.

    dataType

    Тип данных списка свойств в propertyList параметр. Тип, должно быть, был объявлен предыдущим declareTypes:owner: сообщение.

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

    YEStrue если данные были записаны успешно, иначе NOfalse если изменилось владение области монтажа. Любая другая ошибка повышает NSPasteboardCommunicationException.

    Обсуждение

    Этот метод вызывает setData:forType: с сериализированным параметром списка свойств.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

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

    Объявление

    Swift

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

    Objective C

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

    Параметры

    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], options options: [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) -> Int

    Objective C

    - (NSUInteger)indexOfPasteboardItem:(NSPasteboardItem *)pasteboardItem

    Параметры

    pasteboardItem

    Элемент области монтажа.

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

    Индекс указанного элемента области монтажа. Если pasteboardItem не был добавлен ни к какой области монтажа или принадлежит другой области монтажа, возвратам NSNotFound.

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

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

    Объявление

    Swift

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

    Objective C

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

    Параметры

    dataType

    Тип данных Вы хотите читать из области монтажа. Это значение должно быть одним из типов, возвращенных types или availableTypeFromArray:.

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

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

    Этот метод может также возвратиться nil если владелец области монтажа является медленным в ответе к a, если сервер области монтажа не может снабдить данными своевременно — например, pasteboard:provideDataForType: обменивайтесь сообщениями и межпроцессное взаимодействие испытывает таймаут.

    Обсуждение

    Ошибки кроме тайм-аута повышают NSPasteboardCommunicationException.

    Если nil возвращается, приложение должно поднять панель, сообщающую пользователю, что это было неспособно выполнить операцию вставки. Обратите внимание на то, что отправка types или availableTypeFromArray: перед вызовом dataForType: может помочь Вам определить ли a nil следуйте из метода чтения, вследствие чего-то как тайм-аут области монтажа.

    Специальные замечания

    Для стандартных типов данных text, таких как строка, RTF и RTFD, текстовые данные от каждого элемента возвращаются как один объединенный результат, разделенный новыми строками.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – setData:forType:

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

    Объявление

    Swift

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

    Objective C

    - (id)propertyListForType:(NSString *)dataType

    Параметры

    dataType

    Тип данных области монтажа, содержащий данные списка свойств.

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

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

    Обсуждение

    Этот метод вызывает dataForType: метод.

    Специальные замечания

    Это - хорошая идея проверить types или вызовите availableTypeFromArray: перед вызовом propertyListForType:. Несмотря на то, что выполнение этой проверки не требуется, делание так может помочь Вам определить если a nil следуйте из метода чтения, вследствие чего-то как тайм-аут области монтажа.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

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

    Объявление

    Swift

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

    Objective C

    - (NSString *)stringForType:(NSString *)dataType

    Параметры

    dataType

    Тип данных области монтажа для чтения.

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

    Связь строк для указанного типа от всех элементов в получателе, содержащих тип, или nil если ни один из элементов не содержит строки указанного типа.

    Обсуждение

    Этот метод вызывает dataForType: получить строку. Если строка не может быть получена, stringForType: возвраты nil. Посмотрите dataForType: для описания того, что вызовет nil быть возвращенным.

    В OS X v10.6 и позже, если получатель содержит многократные элементы, которые могут обеспечить строку, RTF или данные RTFD, текстовые данные от каждого элемента возвращаются как объединенный результат, разделенный новыми строками.

    Специальные замечания

    Это - хорошая идея проверить types или вызовите availableTypeFromArray: перед вызовом stringForType:. Несмотря на то, что выполнение этой проверки не требуется, делание так может помочь Вам определить если a nil следуйте из метода чтения, вследствие чего-то как тайм-аут области монтажа.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – setString:forType:

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

    Объявление

    Swift

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

    Objective C

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

    Параметры

    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]) -> Bool

    Objective 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], options options: [NSObject : AnyObject]?) -> Bool

    Objective C

    - (BOOL)canReadObjectForClasses:(NSArray *)classArray options:(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]

    Objective C

    + (NSArray *)typesFilterableTo:(NSString *)type

    Параметры

    type

    Целевой тип данных.

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

    Массив NSString объекты, содержащие типы, которые могут быть преобразованы в целевой тип данных.

    Обсуждение

    Массив также содержит исходный тип.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • имя имя Свойство

    Имя получателя. (только для чтения)

    Объявление

    Swift

    var name: String { get }

    Objective C

    @property(readonly, copy) NSString *name

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    + pasteboardWithName:

  • changeCount changeCount Свойство

    Количество изменения получателя. (только для чтения)

    Объявление

    Swift

    var changeCount: Int { get }

    Objective C

    @property(readonly) NSInteger changeCount

    Обсуждение

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

    Количество изменения также возвращается из clearContents и declareTypes:owner:. Можно поэтому записать значение changeCount в то время, когда Вы берете владение области монтажа и сравниваете его с более поздним значением, чтобы определить, есть ли у Вас все еще владение.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

Эти методы, которыми все управляют на том, что является концептуально первым элементом на области монтажа. Они принимают UTIs и строки типа pboard. В будущем выпуске они могут взять только UTIs.

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

    Объявление

    Swift

    func declareTypes(_ newTypes: [AnyObject], owner newOwner: AnyObject?) -> Int

    Objective C

    - (NSInteger)declareTypes:(NSArray *)newTypes owner:(id)newOwner

    Параметры

    newTypes

    Массив NSString объекты, указывающие типы данных, которые могут быть добавлены к новой области монтажа. Типы должны быть упорядочены согласно предпочтению исходного приложения, с самым предпочтительным бывшим на первом месте типом (обычно, самое богатое представление).

    newOwner

    Объект, ответственный за запись данных к области монтажа, или nil если Вы предоставляете данные для всех типов сразу. Если Вы указываете a newOwner объект, это должно поддерживать все типы, объявленные в 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], owner newOwner: AnyObject?) -> Int

    Objective C

    - (NSInteger)addTypes:(NSArray *)newTypes owner:(id)newOwner

    Параметры

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

    См. также

    – changeCount

  • Пишет содержание указанного файла к области монтажа.

    Объявление

    Swift

    func writeFileContents(_ filename: String) -> Bool

    Objective 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) -> Bool

    Objective 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.

  • Данные чтений, представляющие содержание файла от получателя и записей это к указанному файлу.

    Объявление

    Swift

    func readFileContentsType(_ type: String?, toFile filename: String) -> String?

    Objective C

    - (NSString *)readFileContentsType:(NSString *)type toFile:(NSString *)filename

    Параметры

    type

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

    filename

    Файл для получения данных области монтажа.

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

    Имя файла, в который были фактически записаны данные.

    Обсуждение

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

    Специальные замечания

    Необходимо отправить availableTypeFromArray: или types сообщение перед вызовом readFileContentsType:toFile:.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – writeFileContents:

  • Данные чтений, представляющие содержание файла от получателя и возвратов это как обертка файла.

    Объявление

    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, и его эквивалент UTI kUTTypePICT, появится в массиве типа области монтажа, полученном от существующего 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 и позже.