![]() |
![]() |
![]() |
IBus Reference Manual | ![]() |
---|---|---|---|---|
Top | Description | Object Hierarchy |
enum IBusPropType; enum IBusPropState; IBusPropList; IBusPropListClass; IBusProperty; IBusProperty * ibus_property_new (const gchar *key, IBusPropType type, IBusText *label, const gchar *icon, IBusText *tooltip, gboolean sensitive, gboolean visible, IBusPropState state, IBusPropList *prop_list); void ibus_property_set_label (IBusProperty *prop, IBusText *label); void ibus_property_set_icon (IBusProperty *prop, const gchar *icon); void ibus_property_set_tooltip (IBusProperty *prop, IBusText *tooltip); void ibus_property_set_sensitive (IBusProperty *prop, gboolean sensitive); void ibus_property_set_visible (IBusProperty *prop, gboolean visible); void ibus_property_set_state (IBusProperty *prop, IBusPropState state); void ibus_property_set_sub_props (IBusProperty *prop, IBusPropList *prop_list); gboolean ibus_property_update (IBusProperty *prop, IBusProperty *prop_update);
GObject +----GInitiallyUnowned +----IBusObject +----IBusSerializable +----IBusPropList
GObject +----GInitiallyUnowned +----IBusObject +----IBusSerializable +----IBusProperty
An IBusProperty is an UI component like a button or a menu item which shows the status of corresponding input method engine property. End user can operate and see the current status of IME through these components. For example, ibus-chewing users change the English/Chinese input mode by pressing ctrl-space or click on the Eng/Chi switch button. And the IBusProperty shows the change correspondingly.
see_also
: IBusPropList, IBusEngine
typedef enum { PROP_TYPE_NORMAL = 0, PROP_TYPE_TOGGLE = 1, PROP_TYPE_RADIO = 2, PROP_TYPE_MENU = 3, PROP_TYPE_SEPARATOR = 4, } IBusPropType;
Type enumeration of IBusProperty.
typedef enum { PROP_STATE_UNCHECKED = 0, PROP_STATE_CHECKED = 1, PROP_STATE_INCONSISTENT = 2, } IBusPropState;
State of IBusProperty. The actual effect depends on IBusPropType of the IBusProperty.
PROP_TYPE_TOGGLE |
Emphasized if PROP_STATE_CHECKED, normal otherwise. |
PROP_TYPE_RADIO |
Option checked if PROP_STATE_CHECKED, unchecked otherwise. |
No effect on other types.
typedef struct { GArray *properties; } IBusPropList;
An array of IBusProperties.
GArray * |
GArray that holds IBusProperties. |
typedef struct { gchar *key; gchar *icon; IBusText *label; IBusText *tooltip; gboolean sensitive; gboolean visible; guint type; guint state; IBusPropList *sub_props; } IBusProperty;
UI component for input method engine property.
gchar * |
Unique Identity for the IBusProperty. |
gchar * |
Icon file for the IBusProperty. |
IBusText * |
Text shown in UI. |
IBusText * |
Message shown if mouse hovered the IBusProperty. |
gboolean |
Whether the IBusProperty is sensitive to keyboard and mouse event. |
gboolean |
Whether the IBusProperty is visible. |
guint |
IBusPropType of IBusProperty. |
guint |
IBusPropState of IBusProperty. |
IBusPropList * |
IBusPropList that contains sub IBusProperties. These IBusProperties are usually shown as sub menu item. |
IBusProperty * ibus_property_new (const gchar *key, IBusPropType type, IBusText *label, const gchar *icon, IBusText *tooltip, gboolean sensitive, gboolean visible, IBusPropState state, IBusPropList *prop_list);
New a IBusProperty.
|
Unique Identity for the IBusProperty. |
|
IBusPropType of IBusProperty. |
|
Text shown in UI. |
|
Icon file for the IBusProperty. |
|
Message shown if mouse hovered the IBusProperty. |
|
Whether the IBusProperty is sensitive to keyboard and mouse event. |
|
Whether the IBusProperty is visible. |
|
IBusPropState of IBusProperty. |
|
IBusPropList that contains sub IBusProperties. |
Returns : |
A newly allocated IBusProperty. |
void ibus_property_set_label (IBusProperty *prop, IBusText *label);
Set the label of IBusProperty.
|
An IBusProperty. |
|
Text shown in UI. |
void ibus_property_set_icon (IBusProperty *prop, const gchar *icon);
Set the icon of IBusProperty.
|
An IBusProperty. |
|
Icon shown in UI. It could be a full path of an icon file or an icon name. |
void ibus_property_set_tooltip (IBusProperty *prop, IBusText *tooltip);
Set the tooltip of IBusProperty.
|
An IBusProperty. |
|
Text of the tooltip. |
void ibus_property_set_sensitive (IBusProperty *prop, gboolean sensitive);
Set whether the IBusProperty is sensitive.
|
An IBusProperty. |
|
Whether the IBusProperty is sensitive. |
void ibus_property_set_visible (IBusProperty *prop, gboolean visible);
Set whether the IBusProperty is visible.
|
An IBusProperty. |
|
Whether the IBusProperty is visible. |
void ibus_property_set_state (IBusProperty *prop, IBusPropState state);
Set the state of the IBusProperty.
|
An IBusProperty. |
|
The state of the IBusProperty. |
void ibus_property_set_sub_props (IBusProperty *prop, IBusPropList *prop_list);
Set the sub IBusProperties.
|
An IBusProperty. |
|
IBusPropList that contains sub IBusProperties. |
gboolean ibus_property_update (IBusProperty *prop, IBusProperty *prop_update);
Update the content of an IBusProperty.
IBusProperty prop_update
can either be sub-property of prop
,
or holds new values for prop
.
|
An IBusProperty. |
|
IBusPropList that contains sub IBusProperties. |
Returns : |
TRUE for update suceeded; FALSE otherwise. |