manpagez: man pages & more
html files: gtkimageview
Home | html | info | man

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:

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.

© manpagez.com 2000-2024
Individual documents may contain additional copyright information.