| IBus Reference Manual | ||||
|---|---|---|---|---|
| Top | Description | Object Hierarchy | ||||
IBusText; 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.
|