anonymous_namespace{MacIME.mm} Namespace Reference

Functions
id	get (id object, const void *key)
void	set (id object, const void *key, id value)
bool	is_active (id view)
NSString *	marked_text (id view)
void	set_marked_text (id view, NSString *text, NSRange selected)
void	claim_current_key (id view)
NSString *	plain_string (id text)
void	send_text (id view, NSString *text)
NSTextInputContext *	ime_input_context (id self, SEL)
void	ime_insert_text (id self, SEL, id text, NSRange)
void	ime_set_marked_text (id self, SEL, id text, NSRange selected, NSRange)
void	ime_unmark_text (id self, SEL)
BOOL	ime_has_marked_text (id self, SEL)
NSRange	ime_marked_range (id self, SEL)
NSRange	ime_selected_range (id self, SEL)
NSRect	ime_first_rect (id self, SEL, NSRange range, NSRangePointer actual_range)
NSAttributedString *	ime_attributed_substring (id self, SEL, NSRange range, NSRangePointer actual_range)
NSArray *	ime_valid_attributes (id, SEL)
NSUInteger	ime_character_index (id, SEL, NSPoint)
void	install (Class cls)

Variables
char	key_installed
char	key_context
char	key_active
char	key_marked
char	key_selected
char	key_caret
char	key_ime_event

Function Documentation

claim_current_key()

void anonymous_namespace{MacIME.mm}::claim_current_key

(

id

view

)

{
    NSEvent* event = [NSApp currentEvent];
    if (event.type == NSEventTypeKeyDown)
        set(view, &key_ime_event, event);
}

References key_ime_event, and set().

Referenced by ime_insert_text(), ime_set_marked_text(), and ime_unmark_text().

Here is the call graph for this function:

Here is the caller graph for this function:

get()

id anonymous_namespace{MacIME.mm}::get	(	id	object,
		const void *	key )

{ return objc_getAssociatedObject(object, key); }

Referenced by ime_first_rect(), ime_input_context(), ime_selected_range(), install(), is_active(), and marked_text().

Here is the caller graph for this function:

ime_attributed_substring()

NSAttributedString * anonymous_namespace{MacIME.mm}::ime_attributed_substring	(	id	self,
		SEL	,
		NSRange	range,
		NSRangePointer	actual_range )

{
    NSString* text = marked_text(self);
    const NSRange clamped = text != nil ? NSIntersectionRange(range, NSMakeRange(0, text.length)) : NSMakeRange(0, 0);
    if (clamped.length == 0)
        return nil;
    if (actual_range != nullptr)
        *actual_range = clamped;
    return [[[NSAttributedString alloc] initWithString:[text substringWithRange:clamped]] autorelease];
}

References marked_text().

Referenced by install().

Here is the call graph for this function:

Here is the caller graph for this function:

ime_character_index()

NSUInteger anonymous_namespace{MacIME.mm}::ime_character_index	(	id	,
		SEL	,
		NSPoint	)

{ return NSNotFound; }

Referenced by install().

Here is the caller graph for this function:

ime_first_rect()

NSRect anonymous_namespace{MacIME.mm}::ime_first_rect	(	id	self,
		SEL	,
		NSRange	range,
		NSRangePointer	actual_range )

{
    if (actual_range != nullptr)
        *actual_range = range;
    NSView* view  = self;
    NSValue* caret = get(self, &key_caret);
    // Without a reported cursor, the top-left corner of the canvas.
    const NSRect rect = caret != nil ? caret.rectValue : NSMakeRect(0, 0, 1, 16);
    return view.window != nil ? [view.window convertRectToScreen:[view convertRect:rect toView:nil]] : NSZeroRect;
}

References get(), and key_caret.

Referenced by install().

Here is the call graph for this function:

Here is the caller graph for this function:

ime_has_marked_text()

BOOL anonymous_namespace{MacIME.mm}::ime_has_marked_text	(	id	self,
		SEL	)

{ return marked_text(self) != nil; }

References marked_text().

Referenced by install().

Here is the call graph for this function:

Here is the caller graph for this function:

ime_input_context()

NSTextInputContext * anonymous_namespace{MacIME.mm}::ime_input_context	(	id	self,
		SEL	)

{ return is_active(self) ? get(self, &key_context) : nil; }

References get(), is_active(), and key_context.

Referenced by install().

Here is the call graph for this function:

Here is the caller graph for this function:

ime_insert_text()

void anonymous_namespace{MacIME.mm}::ime_insert_text	(	id	self,
		SEL	,
		id	text,
		NSRange	)

{
    if (marked_text(self) != nil) {
        claim_current_key(self);
        set_marked_text(self, nil, {});
    }
    send_text(self, plain_string(text));
}

References claim_current_key(), marked_text(), plain_string(), send_text(), and set_marked_text().

Referenced by install().

Here is the call graph for this function:

Here is the caller graph for this function:

ime_marked_range()

NSRange anonymous_namespace{MacIME.mm}::ime_marked_range	(	id	self,
		SEL	)

{
    NSString* text = marked_text(self);
    return text != nil ? NSMakeRange(0, text.length) : NSMakeRange(NSNotFound, 0);
}

References marked_text().

Referenced by install().

Here is the call graph for this function:

Here is the caller graph for this function:

ime_selected_range()

NSRange anonymous_namespace{MacIME.mm}::ime_selected_range	(	id	self,
		SEL	)

{
    NSValue* selected = get(self, &key_selected);
    return selected != nil ? selected.rangeValue : NSMakeRange(NSNotFound, 0);
}

References get(), and key_selected.

Referenced by install().

Here is the call graph for this function:

Here is the caller graph for this function:

ime_set_marked_text()

void anonymous_namespace{MacIME.mm}::ime_set_marked_text	(	id	self,
		SEL	,
		id	text,
		NSRange	selected,
		NSRange	)

{
    claim_current_key(self);
    set_marked_text(self, plain_string(text), selected);
}

References claim_current_key(), plain_string(), and set_marked_text().

Referenced by install().

Here is the call graph for this function:

Here is the caller graph for this function:

ime_unmark_text()

void anonymous_namespace{MacIME.mm}::ime_unmark_text	(	id	self,
		SEL	)

{
    NSString* text = [[marked_text(self) retain] autorelease];
    if (text == nil)
        return;
    claim_current_key(self);
    set_marked_text(self, nil, {});
    send_text(self, text);
}

References claim_current_key(), marked_text(), send_text(), and set_marked_text().

Referenced by install().

Here is the call graph for this function:

Here is the caller graph for this function:

ime_valid_attributes()

NSArray * anonymous_namespace{MacIME.mm}::ime_valid_attributes	(	id	,
		SEL	)

{ return @[]; }

Referenced by install().

Here is the caller graph for this function:

install()

void anonymous_namespace{MacIME.mm}::install

(

Class

cls

)

{
    if (get(cls, &key_installed) != nil)
        return;
    set(cls, &key_installed, @YES);
 
    Protocol* protocol = @protocol(NSTextInputClient);
    class_addProtocol(cls, protocol);
    const struct { SEL sel; IMP imp; } methods[] = {
        { @selector(insertText:replacementRange:), (IMP) ime_insert_text },
        { @selector(setMarkedText:selectedRange:replacementRange:), (IMP) ime_set_marked_text },
        { @selector(unmarkText), (IMP) ime_unmark_text },
        { @selector(hasMarkedText), (IMP) ime_has_marked_text },
        { @selector(markedRange), (IMP) ime_marked_range },
        { @selector(selectedRange), (IMP) ime_selected_range },
        { @selector(firstRectForCharacterRange:actualRange:), (IMP) ime_first_rect },
        { @selector(attributedSubstringForProposedRange:actualRange:), (IMP) ime_attributed_substring },
        { @selector(validAttributesForMarkedText), (IMP) ime_valid_attributes },
        { @selector(characterIndexForPoint:), (IMP) ime_character_index },
    };
    for (const auto& method : methods)
        class_addMethod(cls, method.sel, method.imp, protocol_getMethodDescription(protocol, method.sel, YES, YES).types);
    // The view's own doCommandBySelector: (from wx) stays: keys the input method passes on reach wx unchanged.
    class_addMethod(cls, @selector(inputContext), (IMP) ime_input_context,
                    method_getTypeEncoding(class_getInstanceMethod([NSView class], @selector(inputContext))));
}

References get(), ime_attributed_substring(), ime_character_index(), ime_first_rect(), ime_has_marked_text(), ime_input_context(), ime_insert_text(), ime_marked_range(), ime_selected_range(), ime_set_marked_text(), ime_unmark_text(), ime_valid_attributes(), key_installed, and set().

Here is the call graph for this function:

is_active()

bool anonymous_namespace{MacIME.mm}::is_active

(

id

view

)

{ return [get(view, &key_active) boolValue]; }

References get(), and key_active.

Referenced by ime_input_context().

Here is the call graph for this function:

Here is the caller graph for this function:

marked_text()

NSString * anonymous_namespace{MacIME.mm}::marked_text

(

id

view

)

{ return get(view, &key_marked); }

References get(), and key_marked.

Referenced by ime_attributed_substring(), ime_has_marked_text(), ime_insert_text(), ime_marked_range(), and ime_unmark_text().

Here is the call graph for this function:

Here is the caller graph for this function:

plain_string()

NSString * anonymous_namespace{MacIME.mm}::plain_string

(

id

text

)

{ return [text isKindOfClass:[NSAttributedString class]] ? [text string] : text; }

Referenced by ime_insert_text(), and ime_set_marked_text().

Here is the caller graph for this function:

send_text()

void anonymous_namespace{MacIME.mm}::send_text	(	id	view,
		NSString *	text )

{
    if (text.length > 0)
        [view performSelector:@selector(insertText:) withObject:text];
}

Referenced by ime_insert_text(), and ime_unmark_text().

Here is the caller graph for this function:

set()

void anonymous_namespace{MacIME.mm}::set	(	id	object,
		const void *	key,
		id	value )

{ objc_setAssociatedObject(object, key, value, OBJC_ASSOCIATION_RETAIN_NONATOMIC); }

Referenced by claim_current_key(), install(), and set_marked_text().

Here is the caller graph for this function:

set_marked_text()

void anonymous_namespace{MacIME.mm}::set_marked_text	(	id	view,
		NSString *	text,
		NSRange	selected )

{
    const bool composing = text.length > 0;
    set(view, &key_marked, composing ? text : nil);
    set(view, &key_selected, composing ? [NSValue valueWithRange:selected] : nil);
}

References key_marked, key_selected, and set().

Referenced by ime_insert_text(), ime_set_marked_text(), and ime_unmark_text().

Here is the call graph for this function:

Here is the caller graph for this function:

Variable Documentation

key_active

char anonymous_namespace{MacIME.mm}::key_active

Referenced by is_active().

key_caret

char anonymous_namespace{MacIME.mm}::key_caret

Referenced by ime_first_rect().

key_context

char anonymous_namespace{MacIME.mm}::key_context

Referenced by ime_input_context().

key_ime_event

char anonymous_namespace{MacIME.mm}::key_ime_event

Referenced by claim_current_key().

key_installed

char anonymous_namespace{MacIME.mm}::key_installed

Referenced by install().

key_marked

char anonymous_namespace{MacIME.mm}::key_marked

Referenced by marked_text(), and set_marked_text().

key_selected

char anonymous_namespace{MacIME.mm}::key_selected

Referenced by ime_selected_range(), and set_marked_text().