UnicodeResponder : Object

Extension

Description

This can be used to replace a function in a view's keydownAction. It matches modifier/unicode combinations and then evaluates the matched handler.

This is one of the simplest ways to accurately match the exact modifier combination you want.

If you merely check the modifier like so: (modifer & optionModifier ) == optionModifier or modifier.isAlt

then you will detect the presence of the options key, but not if ONLY the option key is present ( ie. it will match for shift-option as well )

see KeyCodeResponder

true: must be pressed false: must not be pressed nil: can be either pressed or not pressed( k = UnicodeResponder.new; // option down arrow k.register( 63233, false,false,true,false, { "option down".postln; }); // shift-option down arrow k.register( 63233 , true,false,true,false, { "shift option down".debug; }); w = GUI.window.new.front; v = GUI.slider.new(w,Rect(10,10,100,100)); v.keyDownAction = k; v.focus; )

Use this to post the codes:( UnicodeResponder.tester ) //it prints a code template for you: // shift : k.register( 41 , true, false, false, false, { });

Class Methods

UnicodeResponder.new

UnicodeResponder.register(unicode, shift, caps, opt, cntl, function)

UnicodeResponder.clear

UnicodeResponder.remove

UnicodeResponder.registerUnicode(modifier, unicode, function)

UnicodeResponder.registerUnicodeAll( ... sets)

UnicodeResponder.registerAll( ... sets)

UnicodeResponder.tester

UnicodeResponder.at(address)

UnicodeResponder.put(address, val)

UnicodeResponder.pushForUnicode(unicode, requireMask, denyMask, function, description)

UnicodeResponder.resetUnicode(unicode)

UnicodeResponder.value(view, char, modifiers, unicode, keycode)

UnicodeResponder.global

Inherited class methods

Instance Methods

.dict

.dict = value

.value(view, char, modifier, unicode, keycode)

.normal( ... assns)

.shift( ... assns)

.control( ... assns)

.option( ... assns)

.register(unicode, shift, caps, opt, cntl, function, description)

++(that)

.registerUnicode(modifier, unicode, function)

.registerUnicodeAll( ... sets)

.clear

.remove

.at(key)

.put(key, value)

.pushForUnicode(unicode, requireMask, denyMask, function, description)

.guiClass

.report

Inherited instance methods

Examples

The view in this example is merely to have something to focus on, it does nothing else.( var w, l; w= GUI.window.new("test").front; l= GUI.listView.new(w, Rect(10, 10, 350, 350)) .items_({"eggs".scramble}.dup(12)) .focus .keyDownAction_( UnicodeResponder.new .normal(63232 -> { "normal arrow".postln; }) .shift(63232 -> { "shift arrow".postln; }) .register( 63232, true, nil, false, true, { "shift control, with or without CAPS".postln; }) .normal( 97 -> { "normal a".postln }) .shift( $A -> { "shift a".postln }) ) )

Note that to match shift-a you have to specify "A", not "a"

You can also specify with ascii characters( var w, l; w= GUI.window.new("test").front; l= GUI.listView.new(w, Rect(10, 10, 350, 350)) .items_({"eggs".scramble}.dup(12)) .focus .keyDownAction_( UnicodeResponder.new .normal( $a -> { "a ".postln; }, $b -> { "b".postln; }, $; -> { ";".postln; }, $' -> { "'".postln; } ) .shift( $A -> { "shift a".postln; }, $B -> { "shift b".postln; }, $: -> { "shift ;".postln; }, $" -> { "shift '".postln; } ); ) )