## 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 and GtkBuildable.

## Properties

      "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			  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. The default values are:

- pixbuf : `NULL`

`view` : | a GtkImageView.
Returns : | a new GtkImageNav showing the view.

### 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` : | a GtkImageNav.
Returns : | the pixbuf in the navigation area this image navigator shows, or `NULL` if none exist.

### 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

## Property Details

### The `"view"` property

      "view"                     GtkImageView*         : Write / Construct Only

Image View to navigate.