<!-- ##### SECTION Title ##### --> GnomeIconTextItem <!-- ##### SECTION Short_Description ##### --> Canvas item for editable text captions in icon lists. <!-- ##### SECTION Long_Description ##### --> <para> The <structname>GnomeIconTextItem</structname> canvas item provides a specialized, editable text item to be used for the text captions of icons. This item is used by the <structname>GnomeIconList</structname> widget and by the GNOME file manager. </para> <!-- ##### SECTION See_Also ##### --> <para> #GnomeIconList, #GnomeCanvas. #GnomeIconTextInfo. </para> <!-- ##### STRUCT GnomeIconTextItem ##### --> <para> All the fields in the <structname>GnomeIconTextItem</structname> structure should be considered private. When the application needs to know the size and bounds of an icon text item, it should use the <function>gnome_canvas_item_get_bounds()</function> function. </para> <!-- ##### FUNCTION gnome_icon_text_item_configure ##### --> <para> </para> @iti: @x: @y: @width: @fontname: @text: @is_editable: @is_static: <!-- ##### FUNCTION gnome_icon_text_item_setxy ##### --> <para> </para> @iti: @x: @y: <!-- ##### FUNCTION gnome_icon_text_item_select ##### --> <para> </para> @iti: @sel: <!-- ##### FUNCTION gnome_icon_text_item_get_text ##### --> <para> </para> @iti: @Returns: <!-- ##### FUNCTION gnome_icon_text_item_stop_editing ##### --> <para> </para> @iti: @accept: <!-- ##### SIGNAL GnomeIconTextItem::text-changed ##### --> <para> This signal is emitted when the user has finished editing the text in an icon text item. Typically this happens when the user presses <keycap>Enter</keycap>. The application has to decide whether the entered text is valid or not; for example, a file manager may want to test whether it is legal to rename a file to the proposed name or not. </para> <para> Upon receiving this signal, the application should use <function>gnome_icon_text_item_get_text()</function> to get the text for validation. The return value of this signal indicates whether the proposed text is accepted by the application. If the proposed text is valid, then a signal handler should return <symbol>TRUE</symbol>, otherwise it should return <symbol>FALSE</symbol>. If the change is not accepted, the text is automatically reset to its original state. </para> @icontextitem: Icon text item which emitted the signal. @Returns: %TRUE if the change is accepted, %FALSE otherwise. <!-- ##### SIGNAL GnomeIconTextItem::height-changed ##### --> <para> This signal is emitted when the height of an icon text item changes, usually due to the user changing the text or the application selecting a different font. Applications can change their layout accordingly. </para> @icontextitem: Icon text item which emitted the signal. <!-- ##### SIGNAL GnomeIconTextItem::width-changed ##### --> <para> This signal is emitted when the width of an icon text item changes, usually due to the user changing the text or the application selecting a different font. Applications can change their layout accordingly. </para> @icontextitem: Icon text item which emitted the signal. <!-- ##### SIGNAL GnomeIconTextItem::editing-started ##### --> <para> This signal is emitted when the user begins editing the text in an icon text item, usually by clicking on it while it is selected. Applications can use this information to disable drag and drop signals and update their state accordingly. </para> @icontextitem: Icon text item which emitted the signal. <!-- ##### SIGNAL GnomeIconTextItem::editing-stopped ##### --> <para> This signal is emitted when the user terminates editing the text in an icon text item, usually by pressing <keycap>Enter</keycap> or <keycap>Esc</keycap>. Applications can use this information to enable drag and drop signals and update their state accordingly. </para> @icontextitem: Icon text item which emitted the signal. <!-- ##### SIGNAL GnomeIconTextItem::selection-started ##### --> <para> This signal is emitted when the user begins a rubberband selection of text with the mouse in an icon text item. Applications can use this information to disable drag and drop signals and update their state accordingly. </para> @icontextitem: Icon text item which emitted the signal. <!-- ##### SIGNAL GnomeIconTextItem::selection-stopped ##### --> <para> This signal is emitted when the user terminates a rubberband selection of text with the mouse in an icon text item. Applications can use this information to disable drag and drop signals and update their state accordingly. </para> @icontextitem: Icon text item which emitted the signal. <!-- Local variables: mode: sgml sgml-parent-document: ("../gnomeui-docs.sgml" "book" "sect1" "") End: -->