![]() |
![]() |
![]() |
IBus Reference Manual | ![]() |
---|---|---|---|---|
Top | Description | Object Hierarchy |
IBusText; IBusTextClass; IBusText * ibus_text_new_from_string (const gchar *str
); IBusText * ibus_text_new_from_ucs4 (const gunichar *str
); IBusText * ibus_text_new_from_static_string (const gchar *str
); IBusText * ibus_text_new_from_printf (const gchar *fmt
,...
); IBusText * ibus_text_new_from_unichar (gunichar c
); void ibus_text_append_attribute (IBusText *text
,guint type
,guint value
,guint start_index
,gint end_index
); guint ibus_text_get_length (IBusText *text
);
An IBusText is the main text object in IBus. The text is decorated according to associated IBusAttribute, e.g. the foreground/background color, underline, and applied scope.
typedef struct { gboolean is_static; gchar *text; IBusAttrList *attrs; } IBusText;
A text object in IBus.
gboolean |
Whether text is static, i.e., no need and will not be freed. Only TRUE if IBusText is newed from ibus_text_new_from_static_string() .
|
gchar * |
The string content of IBusText in UTF-8. |
IBusAttrList * |
Associated IBusAttributes. |
IBusText * ibus_text_new_from_string (const gchar *str
);
New an IBusText from a string.
str
will be duplicated in IBusText, so feel free to free str
after this function.
|
An text string to be set. |
Returns : |
A newly allocated IBusText. |
IBusText * ibus_text_new_from_ucs4 (const gunichar *str
);
New an IBusText from an UCS-4 encoded string.
str
will be duplicated in IBusText, so feel free to free str
after this function.
|
An text string to be set. |
Returns : |
A newly allocated IBusText. |
IBusText * ibus_text_new_from_static_string (const gchar *str
);
New an IBusText from a static string.
Since str
is a static string which won't be freed.
This function will NOT duplicate str
.
|
An text string to be set. |
Returns : |
A newly allocated IBusText. |
IBusText * ibus_text_new_from_printf (const gchar *fmt
,...
);
New an IBusText from a printf expression.
The result of printf expression is stored in the new IBusText instance.
|
printf format string. |
|
arguments for fmt .
|
Returns : |
A newly allocated IBusText. |
IBusText * ibus_text_new_from_unichar (gunichar c
);
New an IBusText from a single UCS4-encoded character.
|
A single UCS4-encoded character. |
Returns : |
A newly allocated IBusText. |
void ibus_text_append_attribute (IBusText *text
,guint type
,guint value
,guint start_index
,gint end_index
);
Append an IBusAttribute for IBusText.
|
an IBusText |
|
IBusAttributeType for text .
|
|
Value for the type. |
|
The starting index, inclusive. |
|
The ending index, exclusive. |
guint ibus_text_get_length (IBusText *text
);
Return number of characters in an IBusText.
This function is based on g_utf8_strlen()
, so unlike strlen()
,
it does not count by bytes but characters instead.
|
An IBusText. |
Returns : |
Number of character in text , not counted by bytes.
|