GtkImageNav

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

Screenshot of an active navigation window

Functions

Properties

GtkImageView * view Write / Construct Only

Types and Values

Object Hierarchy

    GObject
    ╰── GInitiallyUnowned
        ╰── GtkObject
            ╰── GtkWidget
                ╰── GtkContainer
                    ╰── GtkBin
                        ╰── GtkWindow
                            ╰── GtkImageNav

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.

Functions

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

Parameters

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.

Parameters

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


gtk_image_nav_release ()

void
gtk_image_nav_release (GtkImageNav *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.

Parameters

nav

a GtkImageNav

 

center_x

x coordinate of center position

 

center_y

y coordinate of center position

 

Types and Values

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.

Property Details

The “view” property

  “view”                     GtkImageView *

Image View to navigate.

Flags: Write / Construct Only