
@c %start of fragment

@deftp Class <gnome-icon-selection>
This @code{<gobject>} class defines no properties, other than those defined by
its superclasses.

@end deftp

@deffn Function gnome-icon-selection-new  @result{}@tie{} (ret@tie{}@code{<gtk-widget>})
Creates a new icon selection widget, it uses GnomeIconList for the listing of
icons

@table @var
@item ret
Returns the new object

@end table

@end deffn

@deffn Function gnome-icon-selection-add-defaults  (self@tie{}@code{<gnome-icon-selection>})
@deffnx Method add-defaults
Adds the default pixmap directory into the selection widget. It doesn't show the
icons in the selection until you do @code{<gnome-icon-selection-show-icons>}.

@table @var
@item gis
GnomeIconSelection to work with

@end table

@end deffn

@deffn Function gnome-icon-selection-add-directory  (self@tie{}@code{<gnome-icon-selection>}) (dir@tie{}@code{mchars})
@deffnx Method add-directory
Adds the icons from the directory @var{dir} to the selection widget. It doesn't
show the icons in the selection until you do
@code{<gnome-icon-selection-show-icons>}.

@table @var
@item gis
GnomeIconSelection to work with

@item dir
directory with pixmaps

@end table

@end deffn

@deffn Function gnome-icon-selection-show-icons  (self@tie{}@code{<gnome-icon-selection>})
@deffnx Method show-icons
Shows the icons inside the widget that were added with
@code{<gnome-icon-selection-add-defaults>} and
@code{<gnome-icon-selection-add-directory>}. Before this function is called the
icons aren't actually added to the listing and can't be picked by the user.

@table @var
@item gis
GnomeIconSelection to work with

@end table

@end deffn

@deffn Function gnome-icon-selection-clear  (self@tie{}@code{<gnome-icon-selection>}) (not_shown@tie{}@code{bool})
@deffnx Method clear
Clear the currently shown icons, the ones that weren't shown yet are not cleared
unless the not_shown parameter is given, in which case even those are cleared.

@table @var
@item gis
GnomeIconSelection to work with

@item not-shown
boolean

@end table

@end deffn

@deffn Function gnome-icon-selection-get-icon  (self@tie{}@code{<gnome-icon-selection>}) (full_path@tie{}@code{bool}) @result{}@tie{} (ret@tie{}@code{mchars})
@deffnx Method get-icon
Gets the currently selected icon name, if full_path is true, it returns the full
path to the icon, if none is selected it returns NULL

@table @var
@item gis
GnomeIconSelection to work with

@item full-path
boolean

@item ret
internal string, it must not be changed or freed or NULL

@end table

@end deffn

@deffn Function gnome-icon-selection-select-icon  (self@tie{}@code{<gnome-icon-selection>}) (filename@tie{}@code{mchars})
@deffnx Method select-icon
Selects the icon @var{filename}. This icon must have already been added and
shown * (see @var{gnome-icon-selection-show-icons})

@table @var
@item gis
GnomeIconSelection to work with

@item filename
icon filename

@end table

@end deffn

@deffn Function gnome-icon-selection-stop-loading  (self@tie{}@code{<gnome-icon-selection>})
@deffnx Method stop-loading
Stop the loading of images when we are in the loop in show_icons, otherwise it
does nothing and is harmless, it should be used say if the dialog was hidden or
when we want to quickly stop loading the images to do something else without
destroying the icon selection object. The remaining icons can be shown by
@code{<gnome-icon-selection-show-icons>}.

@table @var
@item gis
GnomeIconSelection to work with

@end table

@end deffn

@deffn Function gnome-icon-selection-get-gil  (self@tie{}@code{<gnome-icon-selection>}) @result{}@tie{} (ret@tie{}@code{<gtk-widget>})
@deffnx Method get-gil
Gets the @code{<gnome-icon-list>} widget that is used for the display of icons

@table @var
@item gis
GnomeIconSelection to work with

@item ret
a @code{<gtk-widget>} pointer to the interal widget

@end table

@end deffn

@deffn Function gnome-icon-selection-get-box  (self@tie{}@code{<gnome-icon-selection>}) @result{}@tie{} (ret@tie{}@code{<gtk-widget>})
@deffnx Method get-box
Gets the @code{<gtk-vbox>} widget that is used to pack the different elements of
the selection into.

@table @var
@item gis
GnomeIconSelection to work with

@item ret
a @code{<gtk-widget>} pointer to the interal widget

@end table

@end deffn


@c %end of fragment
