# ScrolledWindow (Python)

Marta Maria Casetti
mmcasetti@gmail.com 2012
Añade barras de desplazamiento a su widget hijo
Daniel Mustieles
daniel.mustieles@gmail.com 2011 - 2020
Nicolás Satragno
nsatragno@gmail.com 2012 - 2013
Jorge González
jorgegonz@svn.gnome.org 2011

# ScrolledWindow

Una imagen en una ventana con barras de desplazamiento.

# Código usado para generar este ejemplo

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)

# Métodos útiles para un widget «ScrolledWindow»

`set_policy(norma_barra_despl_h, norma_barra_despl_v)` donde cada uno de los argumentos puede ser `Gtk.Policy.AUTOMATIC, Gtk.Policy.ALWAYS, Gtk.Policy.NEVER`. Regulan si deben las aparecer barras de desplazamiento horizontal y vertical: con `AUTOMATIC` sólo aparecen si se necesitan, con `ALWAYS` aparecen siempre, y con `NEVER` no aparecen nunca.

`add_with_viewport(widget)` se usa para añadir el `widget` «Gtk.Widget» sin capacidad de desplazamiento nativo dentro de la ventana.

`set_placement(lugar_de_ventana)` establece la ubicación del contenido con respecto a las barras de desplazamiento de la ventana. Las opciones para el argumento son `Gtk.CornerType.TOP_LEFT` (predeterminada: las barras de desplazamiento están en la parte inferior y derecha de la ventana), `Gtk.CornerType.TOP_RIGHT, Gtk.CornerType.BOTTOM_LEFT, Gtk.CornerType.BOTTOM_RIGHT`.

`set_hadjustment(ajuste)` y `set_vadjustment(ajuste)` establecen el `ajuste` «Gtk.Adjustment». Este es la representación de un valor con un límite superior e inferior, junto con pasos y páginas de incrementos, y un tamaño de página, y se construye como `Gtk.Adjustment(valor, mínimo, ,máximo, paso, página, tamaño_de_página)` donde los campos son del tipo `float`. Tenga en cuenta que `paso` no se usa en este caso, y puede establecerse a `0`.

# Referencias de la API

En este ejemplo se usa lo siguiente:

GtkScrolledWindow

Enumeraciones estándar

GtkImage