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);
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.

Description

GtkImageNav is a popup window that shows a downscaled preview of the pixbuf that GtkImageView is showing. The user can drag around an 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			  192

The maximum width of the drawing area in the widget.


GTK_IMAGE_NAV_MAX_HEIGHT

#define GTK_IMAGE_NAV_MAX_HEIGHT          128

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.

view : A GtkImageView.
Returns : A new GtkImageNav showing the view.

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 : A GtkImageNav.
center_x : X coordinate of center position.
center_y : Y coordinate of center position.