Conforms to NSObject
Declared in MIKMIDIMappingGenerator.h

Overview

Defines methods to be implemented by the delegate of an MIKMIDIMappingGenerator in order to customize mapping generation behavior.

Tasks

Instance Methods

mappingGenerator:behaviorForRemappingControlMappedWithItems:toNewResponder:commandIdentifier:

- (MIKMIDIMappingGeneratorRemapBehavior)mappingGenerator:(MIKMIDIMappingGenerator *)generator behaviorForRemappingControlMappedWithItems:(NSSet *)mappingItems toNewResponder:(id<MIKMIDIMappableResponder>)newResponder commandIdentifier:(NSString *)commandIdentifier
Discussion

Used to determine behavior when attempting to map a physical control that has been previously mapped to a new responder.

When MIKMIDIMappingGenerator receives mappable messages from a physical control and finds that that control has already been mapped to one or more other virtual controls (responder/command combinations), it will call this method to ask what to do. One of the options specified in MIKMIDIMappingGeneratorRemapBehavior should be returned.

To use the default behavior, (currently MIKMIDIMappingGeneratorRemapDisallow) return MIKMIDIMappingGeneratorRemapDefault. If the delegate does not respond to this method, the default behavior is used.

Parameters

generator

The mapping generator performing the mapping.

mappingItems

The mapping items for commands previously mapped to the physical control in question.

newResponder

The responder for which a mapping is currently being generated.

commandIdentifier

The command identifier of newResponder that is being mapped.

Return Value

The behavior to use when mapping the newResponder. See MIKMIDIMappingGeneratorRemapBehavior for a list of possible values.

Declared In

MIKMIDIMappingGenerator.h

mappingGenerator:shouldRemoveExistingMappingItems:forResponderBeingMapped:

- (BOOL)mappingGenerator:(MIKMIDIMappingGenerator *)generator shouldRemoveExistingMappingItems:(NSSet *)mappingItems forResponderBeingMapped:(id<MIKMIDIMappableResponder>)responder
Discussion

Used to determine whether the existing mapping item for a responder should be superceded by a new mapping item.

The default behavior is to remove existing mapping items (return value of YES). If the delegate does not respond to this method, the default behavior is used.

Parameters

generator

The mapping generator performing the mapping.

mappingItems

The set of existing MIKMIDIMappingItems associated with responder.

responder

The reponsder for which a mapping is currently being generated.

Return Value

YES to remove the existing mapping items. NO to keep the existing mapping items in addition to the new mapping item being generated.

Declared In

MIKMIDIMappingGenerator.h