Description
Provides a specialized canvas item for displaying icon captions which
can be interactively changed by the user.
This Canvas item is used by the GnomeIconList and
by the desktop icons provided by the GNOME file manager.
Details
struct GnomeIconTextItem
struct GnomeIconTextItem; |
gnome_icon_text_item_configure ()
void gnome_icon_text_item_configure (GnomeIconTextItem *iti,
int x,
int y,
int width,
const char *fontname,
const char *text,
gboolean is_editable,
gboolean is_static); |
This routine is used to configure a GnomeIconTextItem.
x,y specify the cordinates where the item is placed inside the canvas
width is the maximum allowed width for this icon.
if is_static is true, it means that there is no need for the item
to allocate memory for the string (it is a guarantee that the text is
allocated in the parent and it wont be deallocated during the life
time of this item). This is an optimization to reduce memory usage for
large icon-lists.
gnome_icon_text_item_setxy ()
Puts the GnomeIconTextItem in the canvas location specified by
the x and y parameters
gnome_icon_text_item_select ()
This is used to control the way the selection is displayed for a
GnomeIconTextItem object
gnome_icon_text_item_get_text ()
gnome_icon_text_item_stop_editing ()
Signals
The "text-changed" signal
This signal is emited when the text has been changed by the user. The
signal handler should return FALSE if it does not accept the changes
made to the text (for example, if it was unable to change the actual
backing store name that this text represents).
If the signal handler returns FALSE, then the text is reset to its
previous value.
The "height-changed" signal
This signals is emited when the height of this item has changed (due
to the user changing the name).
The "width-changed" signal
This signals is emited when the width of this item has changed (due
to the user changing the name).
The "editing-started" signal
This signals is emited when the user has started editing the text on
the item.
The "editing-stopped" signal
This signals is emited when the user has stopped editing the text on
the item.
The "selection-started" signal
This signals is emited when the user has started selecting a region of
the text.
The "selection-stopped" signal
This signals is emited when the user has stopped selecting a region of
the text.