Il y a peu de chances que vous ayez besoin d'utiliser directement le widget Viewport. Plus problablement, vous utiliserez le widget ScrolledWindow (voir Section 10.9, « Fenêtre avec barres de défilement (Scrolled Window) ») qui lui, utilise Viewport.

Un widget Viewport permet de placer un widget plus grand à l'intérieur de lui-même de sorte qu'il n'est possible de voir qu'une partie de celui-ci à la fois. Il utilise l'objet Adjustment (voir Chapitre 7, Adjustments) pour définir la partie actuellement visible.

On crée un Viewport par la fonction :

  viewport = gtk.Viewport(hadjustment=None, vadjustment=None)

Comme on peut le constater, on peut préciser lors de la création du widget les objets Adjustment verticaux et horizontaux qu'il devra utiliser. Le widget créera ses propres ajustements si on attribue la valeur None aux arguments ou si on n'utilise pas d'arguments.

Il est possible de retrouver et de définir les ajustements après la création du widget grâce aux quatre méthodes suivantes :

  viewport.get_hadjustment()

  viewport.get_vadjustment()

  viewport.set_hadjustment(adjustment)

  viewport.set_vadjustment(adjustment)

La seule autre méthode de viewport sert à modifier son apparence :

  viewport.set_shadow_type(type)

Voici les valeurs possibles pour le paramètre type :

  SHADOW_NONE           # pas d'ombrage
  SHADOW_IN             # ombrage interieur
  SHADOW_OUT            # ombrage exterieur
  SHADOW_ETCHED_IN      # ombrage gravé en creux
  SHADOW_ETCHED_OUT     # ombrage gravé en relief