Установление привязки с привязкой значения ключа

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

В большинстве случаев необходимо использовать bind:toObject:withKeyPath:options:, и затем только, когда Вы устанавливаете привязку программно. Использование unbind: обсужден в Развязывании. Другие методы — метод класса exposeBinding: и методы экземпляра exposedBindings и valueClassForBinding:— полезны только в палитре Interface Builder.

NSEditor/NSEditorRegistration

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

Неофициальный протокол NSEditorRegistration реализован контроллерами для обеспечения интерфейса для представления — редактора — для информирования контроллера, когда это отменило фиксацию изменений. Когда редактирование инициируется, представление отправляет контроллер objectDidBeginEditing: сообщение. Когда редактирование завершено (например, когда пользователь нажимает Return), представление отправляет objectDidEndEditing: сообщение.

Контроллер ответственен за отслеживание, какие редакторы отменили фиксацию изменений и запросив, чтобы они фиксировали или отбросили любые незаконченные редактирования, когда надлежащий — например, если пользователь закрывает окно или выходит из приложения. Запрос принимает форму a commitEditing или discardEditing сообщение, определенное неофициальным протоколом NSEditor. NSController обеспечивает реализацию этого протокола, также, как и элементы пользовательского интерфейса Набора Приложения та привязка поддержки.

Кодирование значения ключа

Кодирование значения ключа (KVC) обеспечивает объединенный способ получить доступ к свойствам объекта по имени (ключ), не требуя использования пользовательских методов доступа. Протокол NSKeyValueCoding указывает среди других два метода, valueForKey: и setValue:forKey:, это предоставляет доступ к свойству объекта с указанным именем. Кроме того, методы setValue:forKeyPath: и valueForKeyPath: предоставьте доступ к свойствам через ключевые пути использования отношений формы relationship.property, например, content.lastName.

Привязка для данного свойства указывает объект и ключевой путь к свойству того объекта. Учитывая эту информацию, связанный объект может использовать кодирование значения ключа — в частности setValue:forKeyPath:— обновить объект, к которому это связывается, не имея необходимость с твердым кодом метод доступа, как проиллюстрировано на рисунке 4.

Так как привязка Какао полагается на KVC, Ваша модель и объекты контроллера должны быть KVC-совместимыми для других объектов быть в состоянии связать с ними. Для поддержки KVC, просто необходимо следовать за рядом соглашений для именования методов доступа, кратко полученных в итоге здесь:

• Для атрибута или к - называют одно отношение <key>, методы реализации называют <key> и, если атрибут является чтением-записью, set<Key>: — случай важен.

• Для к - многие реализация отношения любой называют метод <key> или оба countOf<Key> и objectIn<Key>AtIndex:. Если связанные объекты не хранятся в массиве, последняя пара полезна. Вам решать для получения надлежащего значения для указанного индекса — не имеет значения, как получено значение. Для непостоянного к - многие отношение, необходимо также реализовать также set<Key> (если Вы реализовали <key>) или insertObject:in<Key>AtIndex: и removeObjectFrom<Key>AtIndex:.

Для полного изложения всех методов, объявленных протоколом NSKeyValueCoding, посмотрите, что Значение ключа Кодирует Руководство по программированию.

Наблюдение значения ключа

KVO является механизмом, позволяющим объекту зарегистрироваться для получения уведомлений об изменениях в значениях в других объектах. Для регистрации наблюдатель отправляет объект, который это хочет наблюдать addObserver:forKeyPath:options:context: сообщение, указывающее:

• Объект, наблюдающий (очень часто self)

• Ключевой путь для наблюдения (например, selection.name)

• Какая информация будет отправлена на уведомлении (например, старое значение и новое значение)

• Дополнительно, контекстная информация, которую передадут обратно на уведомлении (например, флаг для указания, какая привязка затрагивается),

Наблюдаемый объект передает изменения непосредственно в наблюдателях путем отправки им observeValueForKeyPath:ofObject:change:context: сообщение (определенный NSKeyValueObserving неофициальный протокол) — нет никакого независимого объекта notifier, сродни NSNotificationCenter. Рисунок 5 иллюстрирует, как изменение в значении модели (теневой угол) передается к представлениям с помощью KVO.

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

Один другой важный аспект KVO - то, что можно зарегистрировать значение ключа, как являющегося зависящим от значения одного или более других. Изменение в значении, связанном с одним из «основных» ключей, инициировало уведомление изменения для значения зависимого ключа. Например, границы получения графического объекта могут зависеть от смещения и угла связанной тени. Если должно быть уведомлено любое из тех изменений значений, какие-либо объекты, наблюдая границы получения.

Основное требование для использования KVO - то, что объекты модели KVO-совместимы. В большинстве случаев это фактически не требует никакого усилия — система во время выполнения добавляет поддержку автоматически. По умолчанию все вызовы методов KVC приводят к уведомлениям наблюдателя. Можно также реализовать ручную поддержку — дополнительную информацию см. в Значении ключа, Наблюдая Руководство по программированию.

Развязывание

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

При реализации пользовательского представления или контроллера с пользовательской привязкой необходимо гарантировать, что он очищает любую привязку, прежде чем он будет освобожден — в частности он должен выпустить любые объекты, сохраненные для указанной привязки в bind:toObject:withKeyPath:options: метод и должен вычеркнуть из списка как наблюдатель любых объектов, для которых он зарегистрировался как наблюдатель. Может быть удобно реализовать эту логику в unbind: метод, в котором Вы тогда вызываете как первый шаг dealloc.

Инициируемые в представление обновления

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

[joystick bind:@"angle" toObject:GraphicController withKeyPath:@"selection.shadowAngle" options:options];

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

bind: @"angle"

Если независимо от того, что связано с angle изменения,

toObject: GraphicController

скажите указанный объект (GraphicController) это

withKeyPath: @"selection.shadowAngle"

значение (GraphicController) selection.shadowAngle изменился

options: options

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

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

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

• Обновите его собственный дисплей как надлежащий

• Передайте новые значения к контроллеру, с которым это связывается

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

  Метод Обновления перечисления 3 для класса Джойстика

-(void)updateForMouseEvent:(NSEvent *)event

{

    float newAngleDegrees;

    // calculate newAngleDegrees...

    [self setAngle:newAngleDegrees];

    if (observedObjectForAngle != nil)

    {

        NSNumber *newControllerAngle = nil;

        if (angleValueTransformer != nil)

        {

            newControllerAngle =

                [angleValueTransformer reverseTransformedValue:

                    [NSNumber numberWithFloat:newAngleDegrees]];

        }

        else

        {

            newControllerAngle = [NSNumber numberWithFloat:newAngleDegrees];

        }

        [observedObjectForAngle setValue: newControllerAngle

                  forKeyPath: observedKeyPathForAngle];

    }

    // ...

}

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

Инициируемые в модель обновления

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

[joystick bind:@"angle" toObject:GraphicController withKeyPath:@"selection.shadowAngle" options:options];

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

toObject: GraphicController

Если GraphicController

withKeyPath:@"selection.shadowAngle"

selection.shadowAngle изменения

bind:@"angle"

обновите то, что связано с представленным angle ключ

options:options

использование указанных опций (например, использование преобразователя значения).

Получатель поэтому зарегистрировался как наблюдатель ключевого пути указанного объекта (selection.shadowAngle) в bind:toObject:withKeyPath:options: метод, как был показан в Перечислении 2. Наблюдаемые объекты уведомляют своих наблюдателей путем отправки им observeValueForKeyPath:ofObject:change:context: сообщение. Перечисление 4 показывает частичную реализацию для класса Джойстика для обработки уведомлений наблюдателя тот результат.

Фундаментальное требование observeValueForKeyPath:ofObject:change:context: метод - то, что обновляется значение, связанное с соответствующим атрибутом. Эта выборка также показывает, как она может получить информацию о заполнителе, которая могла бы использоваться в методе дисплея, чтобы дать визуальную обратную связь пользователю в этом случае с помощью переменной экземпляра, указывающей, что по некоторым причинам угол «плох».

  Метод Наблюдения перечисления 4 для класса Джойстика

- (void)observeValueForKeyPath:(NSString *)keyPath

              ofObject:(id)object

            change:(NSDictionary *)change

               context:(void *)context

{

    // You passed the binding identifier as the context when registering

    // as an observer--use that to decide what to update...

    if (context == AngleObservationContext)

    {

        id newAngle = [observedObjectForAngle

            valueForKeyPath:observedKeyPathForAngle];

        if ((newAngle == NSNoSelectionMarker) ||

            (newAngle == NSNotApplicableMarker) ||

            (newAngle == NSMultipleValuesMarker))

        {

            badSelectionForAngle = YES;

        }

        else

        {

            badSelectionForAngle = NO;

            if (angleValueTransformer != nil)

            {

                newAngle = [angleValueTransformer

                    transformedValue:newAngle];

            }

            [self setValue:newAngle forKey:@"angle"];

        }

    }

    // ...

    [self setNeedsDisplay:YES];

}

В большинстве средств управления метод дисплея изменяет визуальное представление в зависимости от текущего выбора.