GnomePixmapEntry

Name

GnomePixmapEntry — Entry widget for selection of large images.

Synopsis


#include <gnome.h>


struct      GnomePixmapEntry;
GtkWidget*  gnome_pixmap_entry_new          (char *history_id,
                                             char *browse_dialog_title,
                                             int do_preview);
void        gnome_pixmap_entry_set_pixmap_subdir
                                            (GnomePixmapEntry *pentry,
                                             const char *subdir);
GtkWidget*  gnome_pixmap_entry_gnome_file_entry
                                            (GnomePixmapEntry *pentry);
GtkWidget*  gnome_pixmap_entry_gnome_entry  (GnomePixmapEntry *pentry);
GtkWidget*  gnome_pixmap_entry_gtk_entry    (GnomePixmapEntry *pentry);
void        gnome_pixmap_entry_set_preview  (GnomePixmapEntry *pentry,
                                             int do_preview);
void        gnome_pixmap_entry_set_preview_size
                                            (GnomePixmapEntry *pentry,
                                             int preview_w,
                                             int preview_h);
char*       gnome_pixmap_entry_get_filename (GnomePixmapEntry *pentry);

Object Hierarchy


  GtkObject
   +----GtkWidget
         +----GtkContainer
               +----GtkBox
                     +----GtkVBox
                           +----GnomePixmapEntry

Description

Entry for large images with a preview. Unlike GnomeIconEntry, it does not scale the images to a specific size and shows them 1:1. This is perfect for selection of backgrounds and such. It also allows DND to be performed on the preview box. It also provides all the GnomeEntry functionality as well.

Details

struct GnomePixmapEntry

struct GnomePixmapEntry;


gnome_pixmap_entry_new ()

GtkWidget*  gnome_pixmap_entry_new          (char *history_id,
                                             char *browse_dialog_title,
                                             int do_preview);

Creates a new pixmap entry widget, if do_preview is false, the preview is hidden but the files are still loaded so that it's easy to show it. If you need a pixmap entry without the preview you just use the GnomeFileEntry

history_id : the id given to gnome_entry_new
browse_dialog_title : title of the browse dialog
do_preview : boolean
Returns : Returns the new object


gnome_pixmap_entry_set_pixmap_subdir ()

void        gnome_pixmap_entry_set_pixmap_subdir
                                            (GnomePixmapEntry *pentry,
                                             const char *subdir);

Sets the subdirectory below gnome's default pixmap directory to use as the default path for the file entry

pentry : the GnomePixmapEntry to work with
subdir : sbudirectory


gnome_pixmap_entry_gnome_file_entry ()

GtkWidget*  gnome_pixmap_entry_gnome_file_entry
                                            (GnomePixmapEntry *pentry);

Get the GnomeFileEntry widget that's part of the entry

pentry : the GnomePixmapEntry to work with
Returns : Returns GnomeFileEntry widget


gnome_pixmap_entry_gnome_entry ()

GtkWidget*  gnome_pixmap_entry_gnome_entry  (GnomePixmapEntry *pentry);

Get the GnomeEntry widget that's part of the entry

pentry : the GnomePixmapEntry to work with
Returns : Returns GnomeEntry widget


gnome_pixmap_entry_gtk_entry ()

GtkWidget*  gnome_pixmap_entry_gtk_entry    (GnomePixmapEntry *pentry);

Get the GtkEntry widget that's part of the entry

pentry : the GnomePixmapEntry to work with
Returns : Returns GtkEntry widget


gnome_pixmap_entry_set_preview ()

void        gnome_pixmap_entry_set_preview  (GnomePixmapEntry *pentry,
                                             int do_preview);

Sets if the preview should be shown or hidden, the files will be loaded anyhow, so it doesn't make the thing any more faster

pentry : the GnomePixmapEntry to work with
do_preview : bool


gnome_pixmap_entry_set_preview_size ()

void        gnome_pixmap_entry_set_preview_size
                                            (GnomePixmapEntry *pentry,
                                             int preview_w,
                                             int preview_h);

Sets the minimum size of the preview frame

pentry : the GnomePixmapEntry to work with
preview_w : preview width
preview_h : preview height


gnome_pixmap_entry_get_filename ()

char*       gnome_pixmap_entry_get_filename (GnomePixmapEntry *pentry);

Gets the file name of the image if it was possible to load it into the preview

pentry : the GnomePixmapEntry to work with
Returns : a newly allocated string with the path or NULL if it couldn't load the file

See Also

GnomeEntry, GnomeFileEntry, GnomeIconEntry, GnomeNumberEntry