GtkImageNav

GtkImageNav — Navigation window showing a thumbnailed overview of a GtkImageView.

Screenshot of an active navigation window

Synopsis




#define             GTK_IMAGE_NAV_MAX_WIDTH
#define             GTK_IMAGE_NAV_MAX_HEIGHT
                    GtkImageNav;
GtkWidget*          gtk_image_nav_new                   (GtkImageView *view);
GdkPixbuf*          gtk_image_nav_get_pixbuf            (GtkImageNav *nav);
void                gtk_image_nav_grab                  (GtkImageNav *nav);
void                gtk_image_nav_release               (GtkImageNav *nav);
void                gtk_image_nav_show_and_grab         (GtkImageNav *nav,
                                                         int center_x,
                                                         int center_y);

Object Hierarchy


  GObject
   +----GInitiallyUnowned
         +----GtkObject
               +----GtkWidget
                     +----GtkContainer
                           +----GtkBin
                                 +----GtkWindow
                                       +----GtkImageNav

Implemented Interfaces

GtkImageNav implements AtkImplementorIface.

Properties


  "view"                     GtkImageView          : Write / Construct Only
  "view"                     GtkImageView          : Write / Construct Only

Description

GtkImageNav is a popup window that shows a downscaled preview of the pixbuf that GtkImageView is showing. The user can drag around a rectangle which indicates the current view of the image.

This class is used by GtkImageScrollWin itself. It is probably not very useful for clients of this library.

GtkImageNav has the same keybindings that GtkImageView has. All keypresses that it receives are passed along to the view.

Details

GTK_IMAGE_NAV_MAX_WIDTH

#define             GTK_IMAGE_NAV_MAX_WIDTH

The maximum width of the drawing area in the widget.


GTK_IMAGE_NAV_MAX_HEIGHT

#define             GTK_IMAGE_NAV_MAX_HEIGHT

The maximum height of the drawing area in the widget.


GtkImageNav

typedef struct _GtkImageNav GtkImageNav;


gtk_image_nav_new ()

GtkWidget*          gtk_image_nav_new                   (GtkImageView *view);

Creates a new GtkImageNav for showing thumbnails of the view. The default values are:

  • pixbuf : NULL

view :
Returns :

gtk_image_nav_get_pixbuf ()

GdkPixbuf*          gtk_image_nav_get_pixbuf            (GtkImageNav *nav);

Returns the downscaled pixbuf of the views pixbuf that this GtkImageNav shows, or NULL if that pixbuf has not been created yet.

The pixbuf is by default NULL.

nav :
Returns :

gtk_image_nav_grab ()

void                gtk_image_nav_grab                  (GtkImageNav *nav);

nav :

gtk_image_nav_release ()

void                gtk_image_nav_release               (GtkImageNav *nav);

nav :

gtk_image_nav_show_and_grab ()

void                gtk_image_nav_show_and_grab         (GtkImageNav *nav,
                                                         int center_x,
                                                         int center_y);

Show the GtkImageNav centered around the point (center_x, center_y) and grab mouse and keyboard events. The grab continues until a button release event is received which causes the widget to hide.

nav :
center_x :
center_y :

Property Details

The "view" property

  "view"                     GtkImageView          : Write / Construct Only

Image View to navigate.


The "view" property

  "view"                     GtkImageView          : Write / Construct Only

Image View to navigate.