CtkIMMulticontext: CTK+ 3 Reference Manual

## CtkIMMulticontext CtkIMMulticontext — An input method context supporting multiple, loadable input methods |

## Functions

CtkIMContext * | ctk_im_multicontext_new ()
void | ctk_im_multicontext_append_menuitems ()
const char * | ctk_im_multicontext_get_context_id ()
void | ctk_im_multicontext_set_context_id ()

## Types and Values

struct | CtkIMMulticontext

## Object Hierarchy

        GObject
        ╰── CtkIMContext
            ╰── CtkIMMulticontext

## Includes

    #include <ctk/ctk.h>

## Description

## Functions

### ctk_im_multicontext_new ()

    CtkIMContext *
    ctk_im_multicontext_new (void);

Creates a new CtkIMMulticontext.

#### Returns

a new CtkIMMulticontext.

### ctk_im_multicontext_append_menuitems ()

    void
    ctk_im_multicontext_append_menuitems (CtkIMMulticontext *context,
                                          CtkMenuShell *menushell);

`ctk_im_multicontext_append_menuitems` has been deprecated since version 3.10 and should not be used in newly-written code.

It is better to use the system-wide input method framework for changing input methods. Modern desktop shells offer on-screen displays for this that can triggered with a keyboard shortcut, e.g. Super-Space.

Add menuitems for various available input methods to a menu; the menuitems, when selected, will switch the input method for the context and the global default input method.

#### Parameters

context | a CtkIMMulticontext |
menushell | a CtkMenuShell |

### ctk_im_multicontext_get_context_id ()

    const char *
    ctk_im_multicontext_get_context_id (CtkIMMulticontext *context);

Gets the id of the currently active slave of the `context` .

#### Parameters

context | a CtkIMMulticontext |

#### Returns

the id of the currently active slave

Since: 2.16

### ctk_im_multicontext_set_context_id ()

    void
    ctk_im_multicontext_set_context_id (CtkIMMulticontext *context,
                                        const char *context_id);

Sets the context id for `context` .

This causes the currently active slave of `context` to be replaced by the slave corresponding to the new context id.

#### Parameters

context | a CtkIMMulticontext |
context_id | the id to use |

Since: 2.16

## Types and Values

### struct CtkIMMulticontext

    struct CtkIMMulticontext;