GNOME UI Library Reference Manual | ||||
---|---|---|---|---|
Top | Description | Object Hierarchy | Implemented Interfaces | Properties |
Synopsis
#include <libgnomeui/libgnomeui.h> struct GnomePixmapEntry; GtkWidget * gnome_pixmap_entry_new (const gchar *history_id
,const gchar *browse_dialog_title
,gboolean do_preview
); void gnome_pixmap_entry_construct (GnomePixmapEntry *pentry
,const gchar *history_id
,const gchar *browse_dialog_title
,gboolean do_preview
); void gnome_pixmap_entry_set_pixmap_subdir (GnomePixmapEntry *pentry
,const gchar *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
); GtkWidget * gnome_pixmap_entry_scrolled_window (GnomePixmapEntry *pentry
); GtkWidget * gnome_pixmap_entry_preview_widget (GnomePixmapEntry *pentry
); void gnome_pixmap_entry_set_preview (GnomePixmapEntry *pentry
,gboolean do_preview
); void gnome_pixmap_entry_set_preview_size (GnomePixmapEntry *pentry
,gint preview_w
,gint preview_h
); gchar * gnome_pixmap_entry_get_filename (GnomePixmapEntry *pentry
);
Object Hierarchy
GObject +----GInitiallyUnowned +----GtkObject +----GtkWidget +----GtkContainer +----GtkBox +----GtkVBox +----GnomeFileEntry +----GnomePixmapEntry
Implemented Interfaces
GnomePixmapEntry implements AtkImplementorIface, GtkBuildable, GtkOrientable and GtkEditable.
Details
struct GnomePixmapEntry
struct GnomePixmapEntry;
Warning
GnomePixmapEntry
is deprecated and should not be used in newly-written code.
gnome_pixmap_entry_new ()
GtkWidget * gnome_pixmap_entry_new (const gchar *history_id
,const gchar *browse_dialog_title
,gboolean do_preview
);
Warning
gnome_pixmap_entry_new
is deprecated and should not be used in newly-written code.
Creates a new pixmap entry widget, if do_preview is false, there is no preview, the files are not loaded and thus are not checked to be real image files.
|
The id given to gnome_entry_new |
|
Title of the browse dialog |
|
boolean |
Returns : |
New GnomePixmapEntry object. |
gnome_pixmap_entry_construct ()
void gnome_pixmap_entry_construct (GnomePixmapEntry *pentry
,const gchar *history_id
,const gchar *browse_dialog_title
,gboolean do_preview
);
Warning
gnome_pixmap_entry_construct
is deprecated and should not be used in newly-written code.
Constructs the pentry
object. If do_preview is FALSE
,
there is no preview, the files are not loaded and thus are not
checked to be real image files.
|
A GnomePixmapEntry object to construct |
|
The id given to gnome_entry_new |
|
Title of the browse dialog |
|
TRUE if preview is desired, FALSE if not. |
gnome_pixmap_entry_set_pixmap_subdir ()
void gnome_pixmap_entry_set_pixmap_subdir (GnomePixmapEntry *pentry
,const gchar *subdir
);
Warning
gnome_pixmap_entry_set_pixmap_subdir
is deprecated and should not be used in newly-written code.
Sets the default path for the file entry. The new subdirectory should be specified relative to the default GNOME pixmap directory.
|
Pointer to GnomePixmapEntry widget |
|
Subdirectory |
gnome_pixmap_entry_gnome_file_entry ()
GtkWidget * gnome_pixmap_entry_gnome_file_entry (GnomePixmapEntry *pentry
);
Warning
gnome_pixmap_entry_gnome_file_entry
is deprecated and should not be used in newly-written code.
Get the GnomeFileEntry component of the GnomePixmapEntry widget for lower-level manipulation.
|
Pointer to GnomePixmapEntry widget |
Returns : |
GnomeFileEntry widget |
gnome_pixmap_entry_gnome_entry ()
GtkWidget * gnome_pixmap_entry_gnome_entry (GnomePixmapEntry *pentry
);
Warning
gnome_pixmap_entry_gnome_entry
is deprecated and should not be used in newly-written code.
Get the GnomeEntry component of the GnomePixmapEntry widget for lower-level manipulation.
|
Pointer to GnomePixmapEntry widget |
Returns : |
GnomeEntry widget |
gnome_pixmap_entry_gtk_entry ()
GtkWidget * gnome_pixmap_entry_gtk_entry (GnomePixmapEntry *pentry
);
Warning
gnome_pixmap_entry_gtk_entry
is deprecated and should not be used in newly-written code.
Get the GtkEntry component of the GnomePixmapEntry for Gtk+-level manipulation.
|
Pointer to GnomePixmapEntry widget |
Returns : |
GtkEntry widget |
gnome_pixmap_entry_scrolled_window ()
GtkWidget * gnome_pixmap_entry_scrolled_window (GnomePixmapEntry *pentry
);
Warning
gnome_pixmap_entry_scrolled_window
is deprecated and should not be used in newly-written code.
Get the GtkScrolledWindow widget that the preview
is contained in. Could be NULL
|
Pointer to GnomePixmapEntry widget |
Returns : |
GtkScrolledWindow widget or NULL
|
gnome_pixmap_entry_preview_widget ()
GtkWidget * gnome_pixmap_entry_preview_widget (GnomePixmapEntry *pentry
);
Warning
gnome_pixmap_entry_preview_widget
is deprecated and should not be used in newly-written code.
Get the widget that is the preview. Don't assume any
type of widget. Currently either GnomePixmap or GtkLabel, but it
could change in the future. Could be NULL
|
Pointer to GnomePixmapEntry widget |
Returns : |
the preview widget pointer or NULL
|
gnome_pixmap_entry_set_preview ()
void gnome_pixmap_entry_set_preview (GnomePixmapEntry *pentry
,gboolean do_preview
);
Warning
gnome_pixmap_entry_set_preview
is deprecated and should not be used in newly-written code.
Sets whether or not the preview box is shown above the entry. If the preview is on, we also load the files and check for them being real images. If it is off, we don't check files to be real image files.
gnome_pixmap_entry_set_preview_size ()
void gnome_pixmap_entry_set_preview_size (GnomePixmapEntry *pentry
,gint preview_w
,gint preview_h
);
Warning
gnome_pixmap_entry_set_preview_size
is deprecated and should not be used in newly-written code.
Sets the minimum size of the preview frame in pixels. This works only if the preview is enabled.
|
Pointer to GnomePixmapEntry widget |
|
Preview width in pixels |
|
Preview height in pixels |
gnome_pixmap_entry_get_filename ()
gchar * gnome_pixmap_entry_get_filename (GnomePixmapEntry *pentry
);
Warning
gnome_pixmap_entry_get_filename
is deprecated and should not be used in newly-written code.
Gets the filename of the image if the preview successfully loaded if preview is disabled. If the preview is disabled, the file is only checked if it exists or not.
|
Pointer to GnomePixmapEntry widget |
Returns : |
Newly allocated string containing path, or NULL on error. |
Property Details
The "do-preview"
property
"do-preview" gboolean : Read / Write
Whether the pixmap entry should have a preview.
Default value: FALSE