Контакт с многократными элементами

На OS X v10.6, NSPasteboard позволяет Вам писать многократные элементы в область монтажа. При использовании в своих интересах этой возможности Вы, возможно, должны рассмотреть, как Ваше приложение будет взаимодействовать с другими, еще не принявшими эту функцию.

При размещении многократных элементов в область монтажа приложение, использующее OS X v10.5, и более ранний API будет обычно получать просто лучшее представление первого элемента на области монтажа (использование dataForType:, -stringForType:, или propertyListForType:). Необходимо поэтому обычно гарантировать, что первый элемент, который Вы помещаете в область монтажа, - то, что, вероятно, чтобы быть «самым интересным» клиентам, использующим 10.5 и более ранний API.

Исключение к этому образцу является текстом. Если приложение на основе 10.6 пишет в область монтажа многократные элементы, обеспечивающие текст (строки и приписанные строки), то, если приложение на основе 10.5 читает текст из области монтажа, текст от элементов объединен с помощью символов возврата. (Можно думать об этом как сродни области монтажа, помещая отдельные строки от элементов в массив, тогда присоединяющийся к ним с componentsJoinedByString:"@\r".)

Методы

Можно обычно использовать API от OS X v10.5 и ранее с APIs, представленным в OS X v10.6 вместе в том же приложении. Это позволяет Вам перемещать свой код на новый API постепенным способом. С любой данной последовательностью взаимодействия, однако, необходимо быть непротиворечивыми в использовании или API от OS X v10.5 и ранее или APIs, представленный в OS X v10.6. Например, следующая комбинация не будет работать:

NSArray *fileURLs = <#An array of file URLs#>;

NSPasteboard *pboard = [NSPasteboard generalPasteboard];

NSArray *typeArray = [NSArray arrayWithObject:NSURLPboardType];

[pboard declareTypes:typeArray owner:nil]; // 10.5

[pboard writeObjects:fileURLs]; // 10.6

Назад совместимость

Если Ваше приложение в настоящее время определяет общедоступный тип области монтажа, на который полагаются другие приложения, необходимо выполнить следующие шаги, чтобы гарантировать, что существующие приложения будут продолжать видеть тип области монтажа даже после того, как приложение переместилось от типов pboard до UTIs:

1. Формально объявите, что новая область монтажа вводит UTI как экспортируемое описание типа.

2. Гарантируйте, что заявленный UTI соответствует public.data ввести.

3. Добавьте спецификацию тега для com.apple.nspboard-type тегируйте к описанию типа. Значение, которое Вы обеспечиваете, должно быть значением литеральной строки типа pboard, не именем константы. Следующий пример показывает, как создать спецификацию тега для соединения UTI с типом pboard:

   <key>UTTypeTagSpecification</key>

   <dict>

   <key>com.apple.nspboard-type</key>

   <string>MyCustomPboardType</string>

   </dict>

Типы области монтажа и UTIs

NSPasteboardItem, NSPasteboardReading, и NSPasteboardWriting APIs, представленный в OS X v10.6, использует UTIs для указания типов представления. В течение долгого времени Какао будет переезжать от старых типов pboard, и к использованию UTIs исключительно на области монтажа.

На OS X v10.6 и позже, необходимо использовать UTIs для идентификации типов области монтажа. Большинство существующих констант типа области монтажа не осуждается в OS X v10.6 (исключениями является PICT и типы контента файла), однако они будут осуждаться в будущем.