<page xmlns="http://projectmallard.org/1.0/" xmlns:its="http://www.w3.org/2005/11/its" xmlns:xi="http://www.w3.org/2001/XInclude" type="guide" style="task" id="scrolledwindow.py" xml:lang="fr">

  <info>

    <title type="text">ScrolledWindow (Python)</title>

    <link type="guide" xref="beginner.py#scrolling"/>

    <link type="next" xref="paned.py"/>

    <revision version="0.1" date="2012-05-26" status="draft"/>

    <credit type="author copyright">

      <name>Marta Maria Casetti</name>

      <email its:translate="no">mmcasetti@gmail.com</email>

      <years>2012</years>

    </credit>

    <desc>Ajoute des barres de défilement à son élément graphique enfant</desc>

    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">

      <mal:name>Luc Rebert,</mal:name>

      <mal:email>traduc@rebert.name</mal:email>

      <mal:years>2011</mal:years>

    </mal:credit>

    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">

      <mal:name>Alain Lojewski,</mal:name>

      <mal:email>allomervan@gmail.com</mal:email>

      <mal:years>2011-2012</mal:years>

    </mal:credit>

    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">

      <mal:name>Luc Pionchon</mal:name>

      <mal:email>pionchon.luc@gmail.com</mal:email>

      <mal:years>2011</mal:years>

    </mal:credit>

    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">

      <mal:name>Bruno Brouard</mal:name>

      <mal:email>annoa.b@gmail.com</mal:email>

      <mal:years>2011-12</mal:years>

    </mal:credit>

    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">

      <mal:name>Luis Menina</mal:name>

      <mal:email>liberforce@freeside.fr</mal:email>

      <mal:years>2014</mal:years>

    </mal:credit>

  </info>

  <title>ScrolledWindow</title>

  <media type="image" mime="image/png" src="media/scrolledwindow.png"/>

  
Une image dans une fenêtre avec barres de défilement.

  <links type="section"/>

  <section id="code">

    <title>Code utilisé pour générer cet exemple</title>

    from gi.repository import Gtk

import sys

class MyWindow(Gtk.ApplicationWindow):

    def __init__(self, app):

        Gtk.Window.__init__(

            self, title="ScrolledWindow Example", application=app)

        self.set_default_size(200, 200)

        # the scrolledwindow

        scrolled_window = Gtk.ScrolledWindow()

        scrolled_window.set_border_width(10)

        # there is always the scrollbar (otherwise: AUTOMATIC - only if needed

        # - or NEVER)

        scrolled_window.set_policy(

            Gtk.PolicyType.ALWAYS, Gtk.PolicyType.ALWAYS)

        # an image - slightly larger than the window...

        image = Gtk.Image()

        image.set_from_file("gnome-image.png")

        # add the image to the scrolledwindow

        scrolled_window.add_with_viewport(image)

        # add the scrolledwindow to the window

        self.add(scrolled_window)

class MyApplication(Gtk.Application):

    def __init__(self):

        Gtk.Application.__init__(self)

    def do_activate(self):

        win = MyWindow(self)

        win.show_all()

    def do_startup(self):

        Gtk.Application.do_startup(self)

app = MyApplication()

exit_status = app.run(sys.argv)

sys.exit(exit_status)

  </section>

  <section id="methods">

    <title>Méthodes utiles pour un élément graphique ScrolledWindow</title>

    <list>

      <item>
La méthode set_policy(hscrollbar_policy, vscrollbar_policy), où chaque argument est l'un des Gtk.Policy.AUTOMATIC, Gtk.Policy.ALWAYS, Gtk.Policy.NEVER, définit laquelle des barres de défilement verticale ou horizontale doit s'afficher. AUTOMATIC les affiche seulement si nécessaire, ALWAYS et NEVER les affichent respectivement toujours ou jamais.
</item>

      <item>
La méthode add_with_viewport(widget) est utilisé pour ajouter l'élément graphique Gtk.Widget widget, sans possibilité de défilement à l'intérieur de la fenêtre.
</item>

      <item>
La méthode set_placement(window_placement) organise le cadrage du contenu de la fenêtre en fonction de ses barres de défilement. Les options possibles des arguments sont : Gtk.CornerType.TOP_LEFT (par défaut, les barres de défilement sont en bas et à droite de la fenêtre), Gtk.CornerType.TOP_RIGHT, Gtk.CornerType.BOTTOM_LEFT, Gtk.CornerType.BOTTOM_RIGHT.
</item>

      <item>
Les méthodes set_hadjustment(ajustement) et set_vadjustment(ajustement) définissent l'ajustement Gtk.Adjustment. C'est la représentation d'une valeur avec une limite inférieure et supérieure, des incréments d'étape et de page, d'une taille de page et est construite sous la forme Gtk.Adjustment(valeur, inferieure, superieure, step_increment, page_increment, page_size) où les champs sont du type float. (Notez que step_increment n'est pas utilisé dans notre exemple et qu'il peut être défini à 0).
</item>

    </list>

  </section>

  <section id="references">

    <title>Références API</title>

    
Dans cet exemple, les éléments suivants sont utilisés :

    <list>

      <item>
<link href="http://developer.gnome.org/gtk3/unstable/GtkScrolledWindow.html">GtkScrolledWindow</link>
</item>

      <item>
<link href="http://developer.gnome.org/gtk3/unstable/gtk3-Standard-Enumerations.html">Standard Enumerations</link>
</item>

      <item>
<link href="http://developer.gnome.org/gtk3/unstable/GtkImage.html">GtkImage</link>
</item>

    </list>

  </section>

</page>