GNOME UI Library Reference Manual | ||||
---|---|---|---|---|
Top | Description | Object Hierarchy | Implemented Interfaces | Properties | Signals |
Synopsis
#include <libgnomeui/libgnomeui.h> GnomeIconEntryPrivate; struct GnomeIconEntry; GtkWidget * gnome_icon_entry_new (const gchar *history_id
,const gchar *browse_dialog_title
); void gnome_icon_entry_construct (GnomeIconEntry *ientry
,const gchar *history_id
,const gchar *browse_dialog_title
); void gnome_icon_entry_set_pixmap_subdir (GnomeIconEntry *ientry
,const gchar *subdir
); gchar * gnome_icon_entry_get_filename (GnomeIconEntry *ientry
); gboolean gnome_icon_entry_set_filename (GnomeIconEntry *ientry
,const gchar *filename
); void gnome_icon_entry_set_browse_dialog_title (GnomeIconEntry *ientry
,const gchar *browse_dialog_title
); void gnome_icon_entry_set_history_id (GnomeIconEntry *ientry
,const gchar *history_id
); void gnome_icon_entry_set_max_saved (GnomeIconEntry *ientry
,guint max_saved
); GtkWidget * gnome_icon_entry_pick_dialog (GnomeIconEntry *ientry
); void gnome_icon_entry_set_icon (GnomeIconEntry *ientry
,const gchar *filename
); GtkWidget * gnome_icon_entry_gnome_file_entry (GnomeIconEntry *ientry
); GtkWidget * gnome_icon_entry_gnome_entry (GnomeIconEntry *ientry
); GtkWidget * gnome_icon_entry_gtk_entry (GnomeIconEntry *ientry
);
Object Hierarchy
GObject +----GInitiallyUnowned +----GtkObject +----GtkWidget +----GtkContainer +----GtkBox +----GtkVBox +----GnomeIconEntry
Implemented Interfaces
GnomeIconEntry implements AtkImplementorIface, GtkBuildable and GtkOrientable.
Properties
"browse-dialog-title" gchar* : Read / Write "filename" gchar* : Read / Write "history-id" gchar* : Read / Write "pick-dialog" GtkDialog* : Read "pixmap-subdir" gchar* : Read / Write
Details
gnome_icon_entry_new ()
GtkWidget * gnome_icon_entry_new (const gchar *history_id
,const gchar *browse_dialog_title
);
Creates a new icon entry widget
|
the id given to gnome_entry_new |
|
title of the browse dialog and icon selection dialog |
Returns : |
Returns the new object |
gnome_icon_entry_construct ()
void gnome_icon_entry_construct (GnomeIconEntry *ientry
,const gchar *history_id
,const gchar *browse_dialog_title
);
For language bindings and subclassing, from C use gnome_icon_entry_new
|
the GnomeIconEntry to work with |
|
the id given to gnome_entry_new in the browse dialog |
|
title of the icon selection dialog |
gnome_icon_entry_set_pixmap_subdir ()
void gnome_icon_entry_set_pixmap_subdir (GnomeIconEntry *ientry
,const gchar *subdir
);
Sets the subdirectory below gnome's default
pixmap directory to use as the default path for the file
entry. The path can also be an absolute one. If NULL
is passed
then the pixmap directory itself is used.
|
the GnomeIconEntry to work with |
|
subdirectory |
gnome_icon_entry_get_filename ()
gchar * gnome_icon_entry_get_filename (GnomeIconEntry *ientry
);
Gets the file name of the image if it was possible to load it into the preview. That is, it will only return a filename if the image exists and it was possible to load it as an image.
|
the GnomeIconEntry to work with |
Returns : |
a newly allocated string with the path or NULL if it
couldn't load the file |
gnome_icon_entry_set_filename ()
gboolean gnome_icon_entry_set_filename (GnomeIconEntry *ientry
,const gchar *filename
);
Sets the icon of GnomeIconEntry to be the one pointed to by
filename
(in the current subdirectory).
gnome_icon_entry_set_browse_dialog_title ()
void gnome_icon_entry_set_browse_dialog_title (GnomeIconEntry *ientry
,const gchar *browse_dialog_title
);
Set the title of the browse dialog. It will not effect an existing dialog.
|
the GnomeIconEntry to work with |
|
title of the icon selection dialog |
gnome_icon_entry_set_history_id ()
void gnome_icon_entry_set_history_id (GnomeIconEntry *ientry
,const gchar *history_id
);
Set the history_id of the entry in the browse dialog and reload the history
|
the GnomeIconEntry to work with |
|
the id given to gnome_entry_new in the browse dialog |
gnome_icon_entry_set_max_saved ()
void gnome_icon_entry_set_max_saved (GnomeIconEntry *ientry
,guint max_saved
);
Set the max_saved of the entry in the browse dialog
|
the GnomeIconEntry to work with |
|
the maximum number of saved entries |
Since 2.4
gnome_icon_entry_pick_dialog ()
GtkWidget * gnome_icon_entry_pick_dialog (GnomeIconEntry *ientry
);
If a pick dialog exists, return a pointer to it or return NULL. This is if you need to do something with all dialogs. You would use the browse signal with connect_after to get the pick dialog when it is displayed.
|
the GnomeIconEntry to work with |
Returns : |
The pick dialog or NULL if none exists |
gnome_icon_entry_set_icon ()
void gnome_icon_entry_set_icon (GnomeIconEntry *ientry
,const gchar *filename
);
Deprecated in favour of gnome_icon_entry_set_filename
|
the GnomeIconEntry to work with |
|
a filename |
gnome_icon_entry_gnome_file_entry ()
GtkWidget * gnome_icon_entry_gnome_file_entry (GnomeIconEntry *ientry
);
Get the GnomeFileEntry widget that's part of the entry DEPRECATED! Use the "changed" signal for getting changes
|
the GnomeIconEntry to work with |
Returns : |
Returns GnomeFileEntry widget |
gnome_icon_entry_gnome_entry ()
GtkWidget * gnome_icon_entry_gnome_entry (GnomeIconEntry *ientry
);
Get the GnomeEntry widget that's part of the entry DEPRECATED! Use the "changed" signal for getting changes
|
the GnomeIconEntry to work with |
Returns : |
Returns GnomeEntry widget |
gnome_icon_entry_gtk_entry ()
GtkWidget * gnome_icon_entry_gtk_entry (GnomeIconEntry *ientry
);
Get the GtkEntry widget that's part of the entry. DEPRECATED! Use the "changed" signal for getting changes
|
the GnomeIconEntry to work with |
Returns : |
Returns GtkEntry widget |
Property Details
The "browse-dialog-title"
property
"browse-dialog-title" gchar* : Read / Write
Title for the Browse icon dialog.
Default value: NULL
The "filename"
property
"filename" gchar* : Read / Write
Filename that should be displayed in the icon entry.
Default value: NULL
The "history-id"
property
"history-id" gchar* : Read / Write
Unique identifier for the icon entry. This will be used to save the history list.
Default value: NULL
The "pick-dialog"
property
"pick-dialog" GtkDialog* : Read
Icon picker dialog. You can use this property to get the GtkDialog if you need to modify or query any of its properties.
The "pixmap-subdir"
property
"pixmap-subdir" gchar* : Read / Write
Directory that will be searched for icons.
Default value: NULL
Signal Details
The "browse"
signal
void user_function (GnomeIconEntry *iconentry,
gpointer user_data) : Run Last
|
the object which received the signal. |
|
user data set when the signal handler was connected. |
The "changed"
signal
void user_function (GnomeIconEntry *iconentry,
gpointer user_data) : Run Last
|
the object which received the signal. |
|
user data set when the signal handler was connected. |