CIFilter

Это дополнение Имэджа Кита к CIFilter класс, представленный в OS X v10.5, состоит из одного метода и ряда констант, генерирующих представление с входными средствами управления параметром для Базового фильтра Изображения. Используя этот метод, для приложений проще представить пользовательский интерфейс для фильтра, чем это было в OS X v10.4. Затем приложения могли создать пользовательский интерфейс фильтра только путем анализа ключей и ключевых атрибутов фильтра и затем записи кода для реализации пользовательского интерфейса.

Вы используете viewForUIConfiguration:excludedKeys: метод для запроса представления от Базового Изображения. Представление является подклассом NSView класс так, чтобы можно было вставить его легко в любое другое представление как подпредставление или в NSWindow возразите как довольное представление. Базовое Изображение автоматически генерирует представление для Вас, если Вы не реализуете IKFilterCustomUIProvider протокол, когда вызов viewForUIConfiguration:excludedKeys: Изображение Ядра причин для обеспечения пользовательского представления.

Наследование

Не применимый

Соответствует

Не применимый

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

Swift

import Quartz

Objective C

@import Quartz;

Доступность

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

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


    
    viewForUIConfiguration (_: excludedKeys:)
    - viewForUIConfiguration:excludedKeys:

Возвращает представление фильтра для фильтра.

Объявление

Swift

func viewForUIConfiguration(_ inUIConfiguration: [NSObject : AnyObject]!, excludedKeys inKeys: [AnyObject]!) -> IKFilterUIView!

Objective C

- (IKFilterUIView *)viewForUIConfiguration:(NSDictionary *)inUIConfiguration excludedKeys:(NSArray *)inKeys

Параметры


      inUIConfiguration

Словарь, содержащий значения для IKUISizeFlavor и kCIUIParameterSet ключи. Посмотрите “User Interface Options” для констант, для которых можно обеспечить как значения IKUISizeFlavor. Для kCIUIParameterSet можно обеспечить одно из следующих значений: kCIUISetBasic, kCIUISetIntermediate, kCIUISetAdvanced, или kCIUISetDevelopment. Когда Вы запрашиваете пользовательский интерфейс на набор параметра, все ключи для того набора и ниже включены. Например, усовершенствованный набор состоит из всех параметров в основных, промежуточных и усовершенствованных наборах. Набор разработки должен содержать параметры, которые или экспериментальны или для отладки целей. Необходимо использовать их только во время разработки фильтров и клиентских приложений, а не в поставляющем продукте.


      inKeys

Массив входных ключей, для которых Вы не хотите обеспечивать пользовательский интерфейс. Передача nil если Вы хотите, чтобы все входные ключи были представлены в пользовательском интерфейсе.

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

IKFilterUIView объект.

Обсуждение

Вызов этого метода для получения представления для фильтра вызывает CIFilter класс для вызова provideViewForUIConfiguration:excludedKeys: метод. Если Вы переопределяете provideViewForUIConfiguration:excludedKeys: пользовательский интерфейс создается Вашим подклассом фильтра. Иначе, Базовое Изображение автоматически генерирует пользовательский интерфейс на основе ключей фильтра и атрибутов.

Алгоритм, используемый для разметки средств управления для фильтра, работает способом, подобным Базовому приложению Дома Забавы Изображения (/Developer/Applications/Graphics Tools/). Приложения могут получить представление, размеры элемента управления которого дополняют размер элементов пользовательского интерфейса, уже используемых в приложении. Также возможно выбрать, какие входные параметры фильтра появляются в представлении. Пользовательские приложения, например, могут хотеть показать маленький, основной набор входных параметров, тогда как профессиональные приложения могут хотеть обеспечить доступ ко всем входным параметрам.

Средства управления в представлении используют привязку для установки значений фильтра. Посмотрите, что Привязка Какао Программирует Темы, если Вы незнакомы с привязкой.

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

Objective C

@import Quartz;

Swift

import Quartz

Доступность

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

Константы

Опции пользовательского интерфейса
Ключи или значения для размера входного параметра управляют для представления фильтра.

Объявление

Swift

var IKUISizeFlavor: NSString! var IKUISizeMini: NSString! var IKUISizeSmall: NSString! var IKUISizeRegular: NSString! var IKUImaxSize: NSString! var IKUIFlavorAllowFallback: NSString!

Objective C

NSString *IKUISizeFlavor; NSString *IKUISizeMini; NSString *IKUISizeSmall; NSString *IKUISizeRegular; NSString *IKUImaxSize; NSString *IKUIFlavorAllowFallback;

Константы
- IKUISizeFlavor
  
  IKUISizeFlavor
  
  Ключ для размера средств управления в представлении фильтра. Присваиваемое значение может быть IKUISizeMini, IKUISizeSmall, или IKUISizeRegular.
  
  Доступный в OS X v10.5 и позже.
- IKUISizeMini
  
  IKUISizeMini
  
  Средства управления, размер которых мини-, как определено Интерфейсным Разработчиком 2.5.
  
  Доступный в OS X v10.5 и позже.
- IKUISizeSmall
  
  IKUISizeSmall
  
  Средства управления, размер которых является маленьким, как определено Интерфейсным Разработчиком 2.5.
  
  Доступный в OS X v10.5 и позже.
- IKUISizeRegular
  
  IKUISizeRegular
  
  Средства управления, размер которых является регулярным или нормальным, как определено Интерфейсным Разработчиком 2.5.
  
  Доступный в OS X v10.5 и позже.
- IKUImaxSize
  
  IKUImaxSize
  
  Средства управления, размерности которых являются максимумом, допустимым для представления фильтра. Ширина или высота 0 указывает, что не ограничивается та размерность представления. Если размер, который требуют, будет слишком маленьким, то фильтр, как ожидают, возвратит представление как можно меньше. Это до клиента, чтобы проверить, что возвращенное представление вписывается в контекст.
  
  Доступный в OS X v10.5 и позже.
- IKUIFlavorAllowFallback
  
  IKUIFlavorAllowFallback
  
  Средства управления заменой другого размера. Присваиваемое значение является булевым значением. Если фильтр не может обеспечить представление для требуемого размера, и нейтрализация позволяется, фильтр может использовать средства управления различного размера.
  
  Доступный в OS X v10.5 и позже.