Операции вставки копии в UIKit

Несколько классов и неофициальный протокол платформы UIKit дают Вам методы и механизмы, необходимо реализовать копию, сократить, и операции вставки в приложении:

• UIPasteboard класс обеспечивает области монтажа: защищенные области для совместного использования данных в приложении или между приложениями. Класс предлагает методы для записи и чтения элементов данных к и от области монтажа.

• UIMenuController класс выводит на экран меню редактирования выше или ниже выбора, который будет скопирован, сокращен или вставлен в. Команды по умолчанию меню редактирования являются (потенциально) Копией, Сокращением, Вставкой, Выбором, и Выбирают All. Можно также добавить пользовательские элементы меню к меню редактирования (см. Добавляющие Пользовательские Элементы к Меню Редактирования).

• UIResponder класс объявляет метод canPerformAction:withSender:. Классы респондента могут реализовать этот метод, чтобы показать и удалить команды меню редактирования на основе текущего контекста.

• UIResponderStandardEditActions неофициальный протокол объявляет интерфейс для обработки копии, сокращения, вставки, выберите, и выбор - все команды. Когда пользователи касаются одной из команд в меню редактирования, соответствия UIResponderStandardEditActions метод вызывается.

Понятия области монтажа

Область монтажа является стандартизированным механизмом для обмена данными в приложениях или между приложениями. Самое знакомое использование для областей монтажа обрабатывает копию, сокращение и операции вставки:

• Когда пользователь выбирает данные в приложении и выбирает Copy (или Cut) команда меню, выбранные данные помещаются на область монтажа.

• Когда пользователь выбирает команду меню Paste (или в том же или в различном приложении), данные по области монтажа копируются в текущее приложение от области монтажа.

В iOS область монтажа также используется для поддержки операций Find. Кроме того, можно использовать области монтажа для передачи данных между приложениями с помощью пользовательских схем URL вместо копии, сократить и вставить команды; посмотрите Обновление Ваших Настроек Info.plist для получения информации об этом методе.

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

Представления и UTIs

Операции области монтажа часто выполняются между двумя различными приложениями. Никакое приложение не требуется, чтобы знать о другом, включая виды данных, которые оно может обработать. Для максимизации потенциала для совместного использования область монтажа может содержать многократные представления того же элемента области монтажа. Например, визуальный редактор мог бы обеспечить HTML, PDF и представления простого текста скопированных данных. Элемент на области монтажа включает все представления того элемента данных, который может обеспечить приложение.

Каждое представление элемента области монтажа обычно идентифицируется Unique Type Identifier (UTI). (UTI является просто строкой, однозначно определяющей определенный тип данных.) UTI обеспечивает общие средние значения для идентификации типов данных. Если у Вас есть пользовательский тип данных, Вы хотите поддерживать, необходимо создать уникальный идентификатор для него. Для этого Вы могли использовать нотацию обратного DNS для своей строки типа представления для обеспечения уникальности; например, пользовательский тип представления мог быть com.myCompany.myApp.myType. Для получения дополнительной информации о UTIs см. Универсальный Обзор Идентификаторов типов.

Например, предположите, что приложение поддерживало выбор обогащенного текста и изображений. Это может хотеть поместить в область монтажа и обогащенный текст и версии Unicode текстового выбора и различные представления выбора изображения. Каждое представление каждого элемента сохранено его собственными данными, как показано на рисунке 6-1.

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

Читатель области монтажа должен найти тип данных что лучшие иски его возможности (если таковые имеются). Как правило, это означает выбирать самый богатый доступный тип. Например, текстовый редактор мог бы обеспечить HTML (обогащенный текст) и представления простого текста данных скопированного текста. Приложение, поддерживающее обогащенный текст, должно получить представление HTML и приложение, только поддерживающее простой текст, должен получить версию простого текста.

Первые шаги: идентифицируйте выбор и выведите на экран меню редактирования

Если Вы собираетесь скопировать, сократить или вставить что-то, сначала необходимо выбрать его. (Операция вставки часто управляет на пустом выборе таким каре, указывая позицию в наборе элементов.) После выбора элемента — и визуально указания выбора — необходимо вывести на экран меню редактирования. Меню редактирования является системным меню, которое может потенциально иметь следующие команды в нем: Копия, Сокращение, Вставка, Выбор и Выбор Все. Меню редактирования указывает на выбор. Когда пользователь касается пункта меню, надлежащего UIResponderStandardEditActions реализация метода (такой как cut: или paste:) вызывается.

Для больше о выборах и изучить, как вывести на экран и управлять меню редактирования, посмотрите Управление Выбором и Меню Редактирования.

Копирование и сокращение выбора

Когда пользователи касаются команды Copy или Cut меню редактирования, система вызывает copy: или cut: метод (соответственно) респондента возражает, что реализует его. Обычно первый респондент — Ваше пользовательское представление — реализует эти методы, но если первый респондент не реализует их, перемещения сообщения цепочка респондента обычным способом. Обратите внимание на то, что UIResponderStandardEditActions неофициальный протокол объявляет эти методы.

В ответ на a copy: или cut: сообщение, Вы пишете объект или данные, представленные выбором области монтажа в стольких различных представлениях, сколько Вы можете. Эта работа включает следующие шаги (которые принимают единственный элемент области монтажа):

1. От выбора идентифицируйте или получите объект или двоичных данных, соответствующих объекту.

   Двоичные данные должны инкапсулироваться в NSData объект. Если Вы собираетесь записать другой тип объекта к области монтажа, это должен быть объект списка свойств — т.е. объект одного из следующих классов: NSString, NSArray, NSDictionary, NSDate, NSNumber, или NSURL. (Для больше на объектах списка свойств, см. Руководство по программированию Списка свойств.)

2. Если возможно, генерируйте одно или более других представлений объекта или данных.

   Например, если на предыдущем шаге Вы создали a UIImage объект, представляющий выбранное изображение, Вы могли использовать UIImageJPEGRepresentation и UIImagePNGRepresentation функции для преобразования изображения в различное представление.

3. Получите объект области монтажа.

   Во многих случаях это - общая область монтажа, через которую можно пройти generalPasteboard метод класса.

4. Присвойте подходящий UTI для каждого представления данных, записанных в элемент области монтажа.

   Посмотрите Понятия Области монтажа для обсуждения этого предмета.

5. Запишите данные в первый элемент области монтажа для каждого типа представления:

   • Для записи объекта данных отправьте a setData:forPasteboardType: обменивайтесь сообщениями к объекту области монтажа.

   • Для записи объекта списка свойств отправьте a setValue:forPasteboardType: обменивайтесь сообщениями к объекту области монтажа.

6. Если команда Сокращается (cut: метод), удалите объект, представленный выбором от модели данных приложения, и обновите свое представление.

Перечисление 6-1 показывает реализации copy: и cut: методы. cut: метод вызывает copy: метод и затем удаляет выбранный объект из представления и модели данных. Обратите внимание на то, что copy: метод архивирует пользовательский объект для получения NSData возразите, что это может передать области монтажа в setData:forPasteboardType:.

Перечисление 6-1  , Копирующее и сокращающее операции

- (void)copy:(id)sender {

    UIPasteboard *gpBoard = [UIPasteboard generalPasteboard];

    ColorTile *theTile = [self colorTileForOrigin:currentSelection];

    if (theTile) {

        NSData *tileData = [NSKeyedArchiver archivedDataWithRootObject:theTile];

        if (tileData)

            [gpBoard setData:tileData forPasteboardType:ColorTileUTI];

    }

}

- (void)cut:(id)sender {

    [self copy:sender];

    ColorTile *theTile = [self colorTileForOrigin:currentSelection];

    if (theTile) {

        CGPoint tilePoint = theTile.tileOrigin;

        [tiles removeObject:theTile];

        CGRect tileRect = [self rectFromOrigin:tilePoint inset:TILE_INSET];

        [self setNeedsDisplayInRect:tileRect];

     }

}

Вставка выбора

Когда пользователи касаются команды Paste меню редактирования, система вызывает paste: метод респондента возражает, что реализует его. Обычно первый респондент — Ваше пользовательское представление — реализует этот метод, но если первый респондент не реализует его, перемещение сообщения респондент обычным способом. paste: метод объявляется UIResponderStandardEditActions неофициальный протокол.

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

1. Получите объект области монтажа.

   Во многих случаях это - общая область монтажа, через которую можно пройти generalPasteboard метод класса.

2. Проверьте, что первый элемент области монтажа содержит данные в представлении, которое Ваше приложение может обработать путем вызова containsPasteboardTypes: метод или pasteboardTypes метод и затем исследование возвращенного массива типов.

   Обратите внимание на то, что необходимо было уже выполнить этот шаг в реализации canPerformAction:withSender:.

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

   • dataForPasteboardType: если данные в, которые будут считаны инкапсулируются NSData объект.

   • valueForPasteboardType: если данные, которые будут считаны, инкапсулируются в объекте списка свойств (см. Копирование и Сокращение Выбора).

4. Добавьте объект к модели данных приложения.

5. Выведите на экран представление объекта в пользовательском интерфейсе в расположении, указанном пользователем.

Перечисление 6-2 является примером реализации paste: метод. Это делает реверс объединенного cut: и copy: методы. Пользовательское представление увидело в первый раз, содержит ли общая область монтажа свое пользовательское представление данных; если это делает, это тогда считывает данные из области монтажа, добавляет это к модели данных приложения и отмечает часть себя — текущего выбора — для перерисовки.

Перечисление 6-2  , Вставляющее данные к выбору

- (void)paste:(id)sender {

    UIPasteboard *gpBoard = [UIPasteboard generalPasteboard];

    NSArray *pbType = [NSArray arrayWithObject:ColorTileUTI];

    ColorTile *theTile = [self colorTileForOrigin:currentSelection];

    if (theTile == nil && [gpBoard containsPasteboardTypes:pbType]) {

        NSData *tileData = [gpBoard dataForPasteboardType:ColorTileUTI];

        ColorTile *theTile = (ColorTile *)[NSKeyedUnarchiver unarchiveObjectWithData:tileData];

        if (theTile) {

            theTile.tileOrigin = self.currentSelection;

            [tiles addObject:theTile];

            CGRect tileRect = [self rectFromOrigin:currentSelection inset:TILE_INSET];

            [self setNeedsDisplayInRect:tileRect];

        }

    }

}

Окончание работы

Когда Ваша реализация cut:, copy: или paste: возвраты команды, меню редактирования автоматически скрыто. Если Вы хотите, можно программно сохранить его видимым. Для получения дополнительной информации посмотрите Отклонение Меню Редактирования