Классы набора изображения и протоколы для приложения браузера изображения

Приложение браузера изображения имеет много требований. В дополнение к созданию экземпляра IKImageBrowserView класс, необходимо будет обеспечить источник данных, обеспечивающий элементы для показа в браузере изображения. Необходимо будет также реализовать требуемые методы IKImageBrowserDataSource и IKImageBrowserItem протоколы.

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

• numberOfItemsInImageBrowser: возвращает число элементов в браузере изображения.

• imageBrowser:itemAtIndex:возвращает объект, расположенный в указанном индексе. Возвращенный объект должен реализовать требуемые методы IKImageBrowserItem протокол.

Методы, поддерживающие редактирование или ту информацию о группе возврата, являются дополнительными. Посмотрите Ссылку на протокол IKImageBrowserDataSource для подробных данных.

IKImageBrowserItem протокол определяет требуемые и дополнительные методы что использование представления браузера для доступа к определенному элементу от источника данных. Необходимо реализовать три метода:

• imageRepresentationType возвращает тип представления изображения. Представление браузера изображения может обработать множество представлений изображения. Необходимо указать, какой тип представления представление браузера изображения использует путем возврата надлежащей константы. Таблица 3-1 перечисляет константы.

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

• imageRepresentation возвращает представление (такое как путь к изображению) для элемента в представлении браузера изображения. Представление должно соответствовать тип представления изображения.

Можно дополнительно реализовать методы, возвращающие версию образа, заголовок, подзаголовок, и может ли быть выбран элемент. Посмотрите Ссылку на протокол IKImageBrowserItem для подробных данных.

IKImageBrowserDelegate неофициальный протокол определяет методы, реагирующие на пользовательские события, такие как выбор. Посмотрите Ссылку на протокол IKImageBrowserDelegate для описания методов делегата.

Как работает демонстрационное приложение браузера изображения

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

Нажатие кнопки Import Images вызывает действие для добавления изображений к представлению браузера изображения. Приложение использует экземпляр NSOpenPanel класс для требования выбора от пользователя. Если пользователь делает выбор, панель Open возвращает выбор как путь. Это приложение позволяет пользователям выбирать или файл или папку. Папка может содержать файлы, другие папки, или и файлы и папки. Однако файлы являются единственными элементами, добавляющимися к представлению браузера изображения, что означает, что приложение должно пересечь все пути, пока каждый не решает к единственному файлу.

Приложение создает объект источника данных — объект изображения — для каждого файла. Объект имеет одну переменную экземпляра, путь к файлу (представленный как NSString объект). Каждый объект изображения добавляется к массиву изображений импорта. После того, как все объекты добавляются к тому массиву, приложение добавляет тот массив к массиву изображений. Приложение тогда удаляет все объекты из массива изображений импорта так, чтобы массив мог быть готов импортировать больше изображений, должен пользователь принимать решение сделать так. Наконец приложение вызывает reloadData метод IKImageBrowserView класс для заполнения представления браузера изображения с изображениями, представленными импортом, отображает массив.

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

• Файл пера. Необходимо добавить представление Image Browser (IKImageBrowserView класс) к окну. Вы добавите представление прокрутки для вертикального скроллера и кнопку для импорта изображений.

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

• IKImageBrowserDataSource протокол. Необходимо реализовать требуемые методы для этого протокола: numberOfItemsInImageBrowser: и imageBrowser:itemAtIndex:.

• IKImageBrowserItem протокол. Необходимо объявить интерфейс для объекта изображения, представляющего единственный элемент в представлении браузера изображения. В реализации для объекта изображения необходимо обеспечить требуемые методы для этого протокола: imageUID, imageRepresentationType, и imageRepresentation.

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

Следующие разделы обеспечивают поэтапные инструкции для записи приложения браузера изображения.

Установка проекта, файлов проекта и интерфейса контроллера

Выполните эти шаги для установки проекта:

1. Откройте Xcode и создайте названное приложение Какао Browse Images.

2. Добавьте Кварцевую платформу.

   Для получения дополнительной информации, seeUsing Набор Изображения в XCode.

3. Выберите File> New File.

4. Выберите «Objective-C Class NSWindowController subclass» и нажмите Далее.

5. Назовите файл ImageBrowserController.m и сохраните опцию создать заголовочный файл. Тогда нажмите Finish.

6. В ImageBrowserController.h файл, импортируйте Кварцевую платформу путем добавления этого оператора:

   #import <Quartz/Quartz.h>

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

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

   @interface ImageBrowserController : NSWindowController {

   IBOutlet id mImageBrowser;

   NSMutableArray * mImages;

   NSMutableArray * mImportedImages;

   }

   @end

8. Добавьте следующую сигнатуру метода:

   - (IBAction) addImageButtonClicked:(id) sender;

9. Сохраните ImageBrowserController.h файл.

Добавление подпрограмм к файлу реализации

Выполните эти шаги для реализации основных задач приложения браузера изображения:

1. Откройтесь ImageBrowserController.m файл.

2. В файле реализации добавьте awakeFromNib метод.

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

   - (void) awakeFromNib

   {

   mImages = [[NSMutableArray alloc] init];

   mImportedImages = [[NSMutableArray alloc] init];

   [mImageBrowser setAnimates:YES];

   }

3. Добавьте метод для обновления источника данных для контроллера браузера изображения.

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

   - (void) updateDatasource

   {

   [mImages addObjectsFromArray:mImportedImages];

   [mImportedImages removeAllObjects];

   [mImageBrowser reloadData];

   }

4. Реализуйте два требуемых метода протокола источника данных браузера изображения.

   Число элементов в браузере изображения является просто числом элементов в массиве изображений. Индекс элемента является просто своим индексом в массиве изображений.

   - (int) numberOfItemsInImageBrowser:(IKImageBrowserView *) view

   {

   return [mImages count];

   }

   - (id) imageBrowser:(IKImageBrowserView *) view itemAtIndex:(int) index

   {

   return [mImages objectAtIndex:index];

   }

5. В IKImageBrowserController.m файл, сразу после оператора импорта, создает интерфейс для объекта источника данных.

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

   @interface MyImageObject : NSObject{

   NSString * mPath;

   }

   @end

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

   @implementation MyImageObject

   // Methods here

   @end

7. Запишите метод, устанавливающий объект контуров.

   - (void) setPath:(NSString *) path

   {

   if(mPath != path){

   mPath = path;

   }

   }

8. Реализуйте три требуемых метода IKImageBrowserItem протокол.

   Источник данных является представлением пути к файлу, и его уникальный идентификатор является самим путем.

   - (NSString *) imageRepresentationType

   {

   return IKImageBrowserPathRepresentationType;

   }

   - (id) imageRepresentation

   {

   return mPath;

   }

   - (NSString *) imageUID

   {

   return mPath;

   }

9. Теперь, когда Вы сделаны с реализацией MyImageObject, необходимо добавить метод к реализации ImageBrowserController. Когда пользователь нажимает кнопку Import Images, этот метод вызывается.

   Это вызовы метода подпрограмма, выводящая на экран панель Open и возвращающая путь, выбранный пользователем. Если существует путь, метод устанавливает независимый поток, вызывая addImagesWithPaths: метод, который Вы запишете затем. Вы запишете открытую подпрограмму файлов позже. Проверьте, чтобы удостовериться, что Вы добавляете следующий метод в реализации ImageBrowserController,

   - (IBAction) addImageButtonClicked:(id) sender

   {

   NSArray *path = openFiles();

   if(!path){

   NSLog(@"No path selected, return...");

   return;

   }

   [NSThread detachNewThreadSelector:@selector(addImagesWithPaths:) toTarget:self withObject:path];

   }

10. Запишите метод, добавляющий массив путей к источнику данных.

    Метод анализирует все пути в paths выстройте и добавляет их к временному массиву. (Вы запишете addImagesWithPath: метод на следующем шаге. Обратите внимание на то, что это - путь, исключительный.) Это тогда обновляет источник данных в основном потоке.

    Добавьте этот метод после addImageButtonClicked: метод.

    - (void) addImagesWithPaths:(NSArray *) paths

    {

    int i, n;

    n = [paths count];

    for(i=0; i<n; i++){

    NSString *path = [paths objectAtIndex:i];

    [self addImagesWithPath:path recursive:NO];

    }

    [self performSelectorOnMainThread:@selector(updateDatasource)

    withObject:nil

    waitUntilDone:YES];

    }

11. Запишите метод, добавляющий изображения в пути.

    Эти проверки метода, чтобы видеть, идентифицирует ли путь каталог или файл. Если путь является каталогом, код анализирует содержание каталога и вызывает addImagesAtPath: метод. Если путь к файлу, код вызывает метод, добавляющий единственное изображение к импортированному массиву изображений. Вы запишете addAnImageWithPath: метод затем.

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

    Добавьте этот метод перед addImagesWithPaths: метод.

    - (void) addImagesWithPath:(NSString *) path recursive:(BOOL) recursive

    {

    int i, n;

    BOOL dir;

    [[NSFileManager defaultManager] fileExistsAtPath:path isDirectory:&dir];

    if(dir){

    NSArray *content = [[NSFileManager defaultManager]

    directoryContentsAtPath:path];

    n = [content count];

    for(i=0; i<n; i++){

    if(recursive)

    [self addImagesWithPath:

    [path stringByAppendingPathComponent:

    [content objectAtIndex:i]]

    recursive:NO];

    else

    [self addAnImageWithPath:

    [path stringByAppendingPathComponent:

    [content objectAtIndex:i]]];

    }

    }

    else

    [self addAnImageWithPath:path];

    }

12. Запишите метод, добавляющий единственное изображение к импортированному массиву изображений.

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

    Добавьте этот метод перед addImagesWithPath:recursive: метод.

    - (void) addAnImageWithPath:(NSString *) path

    {

    MyImageObject *p;

    p = [[MyImageObject alloc] init];

    [p setPath:path];

    [mImportedImages addObject:p];

    }

13. Запишите открытую подпрограмму файлов, выводящую на экран NSOpenPanel возразите и получает путь, выбранный пользователем.

    Поместите эту подпрограмму наверху ImageBrowserController.m файл, сразу после оператора импорта.

    static NSArray *openFiles()

    {

    NSOpenPanel *panel;

    panel = [NSOpenPanel openPanel];

    [panel setFloatingPanel:YES];

    [panel setCanChooseDirectories:YES];

    [panel setCanChooseFiles:YES];

    int i = [panel runModal];

    if(i == NSOKButton){

    return [panel URLs];

    }

    return nil;

    }

14. Разработайте проект.

    Это гарантирует, что Интерфейсный Разработчик обнаруживает действие, которое Вы добавили.

15. Сохраните IKImageBrowserController.m файл.

Создание пользовательского интерфейса

Установите пользовательский интерфейс в Интерфейсном Разработчике путем выполнения этих шагов:

1. Дважды щелкните MainMenu.nib файл для открытия Interface Builder.

2. Выберите File> Synchronize With Xcode.

3. Если это не уже открыто, дважды щелкните по значку Window в окне документа пера.

4. Перетащите Представление Браузера Изображения от Библиотеки до окна и измените размеры представления так, чтобы Вы оставили пространство у основания окна для кнопки.

5. В инспекторе Размера для представления удостоверьтесь, что пружины Автокалибровки и распорки смотрят следующим образом:

   

6. Выберите Layout> Embed Objects In> Scroll View.

7. В инспекторе Атрибутов Представления Прокрутки отпуск Показывает Вертикальный выбранный Скроллер, но отмена выбора Показывает Горизонтальный Скроллер.

   Это позволит пользователям прокручивать легко через большие количества изображений.

8. В области Size, заведенной пружины Автокалибровки и распорки, таким образом, они выглядят одинаково как показанные на Шаге 5.

9. Перетащите объект (NSObject) от Библиотеки до окна документа пера.

10. В инспекторе Идентификационных данных выберите ImageBrowserController из всплывающего меню Класса.

11. Перетащите управление от значка ImageBrowserController до строки заголовка окна. Тогда подключение к window в панели соединений.

12. Перетащите управление от значка ImageBrowserController до IKImageBrowserView представление. Тогда подключение к mImageBrowser в панели соединений.

13. Перетащите управление от IKImageBrowserView просмотрите к значку ImageBrowserController. Тогда соединитесь с _dataSource в панели соединений.

14. Перетащите управление от значка окна до значка контроллера. Тогда подключение к delegate в панели соединений.

15. Перетащите Кнопку от библиотеки до нижней правой части окна и маркируйте его Изображениями Импорта.

16. В инспекторе Размера, Автокалибровка набора для имения внешних распорок слева и нижней части.

17. Перетащите управление от кнопки Import Images до значок ImageBrowserController и соединитесь с addImageButtonClicked: действие в панели соединений.

18. Сохраните файл пера.

19. В XCode нажмите Build и Go.

    Нажмите кнопку Import Images и удостоверьтесь, что работает браузер изображения.