GDK Reference Manual

　　Returns : a bit-mask of all the styles allowed.

gdk_im_begin ()
voidgdk_im_begin(GdkIC *ic,GdkWindow *window); 

　　Starts editing, using the given input context and GdkWindow. This should be called when the widget receives the input focus, typically in the widget's focus_in_event method.

　　ic : a GdkIC.

　　window : the GdkWindow which will be receiving the key press events.

gdk_im_end ()
voidgdk_im_end(void); 

　　Stops editing using the input method. This should be called when the widget loses the input focus, typically in the widget's focus_out_event method.

　　See Also

Input Contexts

　　Used for each widget that handles internationalized text input using the global input method.

Input Contexts

Name

　　Input Contexts -- internationalized text input properties.

Synopsis

#include <gdk/gdk.h>
structGdkIC;
GdkIC*gdk_ic_new(GdkICAttr *attr,GdkICAttributesType mask);
voidgdk_ic_destroy(GdkIC *ic);
GdkEventMask gdk_ic_get_events(GdkIC *ic);
GdkIMStylegdk_ic_get_style(GdkIC *ic);
GdkICAttributesType gdk_ic_get_attr (GdkIC *ic,
GdkICAttr *attr,GdkICAttributesType mask);
GdkICAttributesType gdk_ic_set_attr (GdkIC *ic,
GdkICAttr *attr,GdkICAttributesType mask);
structGdkICAttr;
enumGdkICAttributesType;
GdkICAttr*gdk_ic_attr_new (void);
voidgdk_ic_attr_destroy (GdkICAttr *attr); 

Description

　　A GdkIC input context is used for each user interface element which supports internationalized text input. See the Input Methods section for an overview of how internationalized text input works in GTK+.

　　Details

　　struct GdkIC

　　struct GdkIC;

　　The GdkIC struct is an opaque structure representing an input context for use with the global Input Method.

gdk_ic_new ()
GdkIC*gdk_ic_new(GdkICAttr *attr,GdkICAttributesType mask); 

　　Creates a new GdkIC using the given attributes.

　　attr : a GdkICAttr struct containing attributes to use for the input context.

　　mask : a GdkICAttributesType mask specifying which of the attributes in attr are set.

　　Returns : a new GdkIC.

gdk_ic_destroy ()
voidgdk_ic_destroy(GdkIC *ic); 

　　Destroys the input context.

　　ic : a GdkIC.

gdk_ic_get_events ()
GdkEventMask gdk_ic_get_events(GdkIC *ic); 

　　Returns the mask of events that the input method needs to function properly. This is typically called in a widget's realize method after creating the GdkIC. The returned event mask is then combined with the widget's own event mask and applied using gdk_window_set_events().

　　ic : a GdkIC.

　　Returns : the mask of events that the input method needs to function properly.

gdk_ic_get_style ()
GdkIMStylegdk_ic_get_style(GdkIC *ic); 

　　Returns the pre-edit and status style of the GdkIC.

　　ic : a GdkIC.

　　Returns : the pre-edit and status style of the GdkIC.

gdk_ic_get_attr ()
GdkICAttributesType gdk_ic_get_attr (GdkIC *ic,
GdkICAttr *attr,GdkICAttributesType mask); 

　　Gets attributes of a GdkIC.

　　ic : a GdkIC.

　　attr : a GdkICAttr struct to contain the returned attributes.

　　mask : a GdkICAttributesType mask specifying which attributes to get.

　　Returns : a GdkICAttributesType mask specifying which of the attributes were not retrieved succesfully.

gdk_ic_set_attr ()
GdkICAttributesType gdk_ic_set_attr (GdkIC *ic,
GdkICAttr *attr,GdkICAttributesType mask); 

　　Sets attributes of the GdkIC.

　　Note that the GDK_IC_STYLE and GDK_IC_CLIENT_WINDOW attributes can only be set when creating the GdkIC, and the GDK_IC_FILTER_EVENTS attribute is read-only.

　　ic : a GdkIC.

　　attr : a GdkICAttr struct containing attributes to use for the input context.