MatePixmapEntry

MatePixmapEntry

Synopsis

#include <libmateui/libmateui.h>

struct              MatePixmapEntry;
GtkWidget *         mate_pixmap_entry_new              (const gchar *history_id,
                                                         const gchar *browse_dialog_title,
                                                         gboolean do_preview);
void                mate_pixmap_entry_construct        (MatePixmapEntry *pentry,
                                                         const gchar *history_id,
                                                         const gchar *browse_dialog_title,
                                                         gboolean do_preview);
void                mate_pixmap_entry_set_pixmap_subdir
                                                        (MatePixmapEntry *pentry,
                                                         const gchar *subdir);
GtkWidget *         mate_pixmap_entry_mate_file_entry (MatePixmapEntry *pentry);
GtkWidget *         mate_pixmap_entry_mate_entry      (MatePixmapEntry *pentry);
GtkWidget *         mate_pixmap_entry_gtk_entry        (MatePixmapEntry *pentry);
GtkWidget *         mate_pixmap_entry_scrolled_window  (MatePixmapEntry *pentry);
GtkWidget *         mate_pixmap_entry_preview_widget   (MatePixmapEntry *pentry);
void                mate_pixmap_entry_set_preview      (MatePixmapEntry *pentry,
                                                         gboolean do_preview);
void                mate_pixmap_entry_set_preview_size (MatePixmapEntry *pentry,
                                                         gint preview_w,
                                                         gint preview_h);
gchar *             mate_pixmap_entry_get_filename     (MatePixmapEntry *pentry);

Object Hierarchy

  GObject
   +----GInitiallyUnowned
         +----GtkObject
               +----GtkWidget
                     +----GtkContainer
                           +----GtkBox
                                 +----GtkVBox
                                       +----MateFileEntry
                                             +----MatePixmapEntry

Implemented Interfaces

MatePixmapEntry implements AtkImplementorIface, GtkBuildable, GtkOrientable and GtkEditable.

Properties

  "do-preview"               gboolean              : Read / Write

Description

Details

struct MatePixmapEntry

struct MatePixmapEntry;

Warning

MatePixmapEntry is deprecated and should not be used in newly-written code.


mate_pixmap_entry_new ()

GtkWidget *         mate_pixmap_entry_new              (const gchar *history_id,
                                                         const gchar *browse_dialog_title,
                                                         gboolean do_preview);

Warning

mate_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.

history_id :

The id given to mate_entry_new

browse_dialog_title :

Title of the browse dialog

do_preview :

boolean

Returns :

New MatePixmapEntry object.

mate_pixmap_entry_construct ()

void                mate_pixmap_entry_construct        (MatePixmapEntry *pentry,
                                                         const gchar *history_id,
                                                         const gchar *browse_dialog_title,
                                                         gboolean do_preview);

Warning

mate_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.

pentry :

A MatePixmapEntry object to construct

history_id :

The id given to mate_entry_new

browse_dialog_title :

Title of the browse dialog

do_preview :

TRUE if preview is desired, FALSE if not.

mate_pixmap_entry_set_pixmap_subdir ()

void                mate_pixmap_entry_set_pixmap_subdir
                                                        (MatePixmapEntry *pentry,
                                                         const gchar *subdir);

Warning

mate_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 MATE pixmap directory.

pentry :

Pointer to MatePixmapEntry widget

subdir :

Subdirectory

mate_pixmap_entry_mate_file_entry ()

GtkWidget *         mate_pixmap_entry_mate_file_entry (MatePixmapEntry *pentry);

Warning

mate_pixmap_entry_mate_file_entry is deprecated and should not be used in newly-written code.

Get the MateFileEntry component of the MatePixmapEntry widget for lower-level manipulation.

pentry :

Pointer to MatePixmapEntry widget

Returns :

MateFileEntry widget

mate_pixmap_entry_mate_entry ()

GtkWidget *         mate_pixmap_entry_mate_entry      (MatePixmapEntry *pentry);

Warning

mate_pixmap_entry_mate_entry is deprecated and should not be used in newly-written code.

Get the MateEntry component of the MatePixmapEntry widget for lower-level manipulation.

pentry :

Pointer to MatePixmapEntry widget

Returns :

MateEntry widget

mate_pixmap_entry_gtk_entry ()

GtkWidget *         mate_pixmap_entry_gtk_entry        (MatePixmapEntry *pentry);

Warning

mate_pixmap_entry_gtk_entry is deprecated and should not be used in newly-written code.

Get the GtkEntry component of the MatePixmapEntry for Gtk+-level manipulation.

pentry :

Pointer to MatePixmapEntry widget

Returns :

GtkEntry widget

mate_pixmap_entry_scrolled_window ()

GtkWidget *         mate_pixmap_entry_scrolled_window  (MatePixmapEntry *pentry);

Warning

mate_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

pentry :

Pointer to MatePixmapEntry widget

Returns :

GtkScrolledWindow widget or NULL

mate_pixmap_entry_preview_widget ()

GtkWidget *         mate_pixmap_entry_preview_widget   (MatePixmapEntry *pentry);

Warning

mate_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 MatePixmap or GtkLabel, but it could change in the future. Could be NULL

pentry :

Pointer to MatePixmapEntry widget

Returns :

the preview widget pointer or NULL

mate_pixmap_entry_set_preview ()

void                mate_pixmap_entry_set_preview      (MatePixmapEntry *pentry,
                                                         gboolean do_preview);

Warning

mate_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.

pentry :

Pointer to MatePixmapEntry widget

do_preview :

TRUE to show previews, FALSE to not show them.

mate_pixmap_entry_set_preview_size ()

void                mate_pixmap_entry_set_preview_size (MatePixmapEntry *pentry,
                                                         gint preview_w,
                                                         gint preview_h);

Warning

mate_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.

pentry :

Pointer to MatePixmapEntry widget

preview_w :

Preview width in pixels

preview_h :

Preview height in pixels

mate_pixmap_entry_get_filename ()

gchar *             mate_pixmap_entry_get_filename     (MatePixmapEntry *pentry);

Warning

mate_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.

pentry :

Pointer to MatePixmapEntry 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