PDF de programación - Tutorial de PyGTK 2.0 versión 2.3

Tutorial de PyGTK 2.0 versión 2.3

John Finlay, Rafael Villar Burke, Lorenzo Gil Sánchez,

Iñigo Serna, y Fernando San Martín Woerner

7 de octubre de 2012

Tutorial de PyGTK 2.0 versión 2.3
by John Finlay, Rafael Villar Burke, Lorenzo Gil Sánchez, Iñigo Serna, y Fernando San Martín Woerner

II

Índice general

1. Introducción

1.1. Exploración de PyGTK .

.

.

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

2. Primeros Pasos

2.1. Hola Mundo en PyGTK .
2.2. Teoría de Señales y Retrollamadas
2.3. Eventos .
.
2.4. Hola Mundo Paso a Paso .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

.
.

.

.

.

.

.

.

.

.

.

.

3. Avanzando

3.1. Más sobre manejadores de señales . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
3.2. Un Hola Mundo Mejorado .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

4. Empaquetado de Controles

4.1. Teoría de Cajas Empaquetadoras . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4.2. Las Cajas en detalle .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4.3. Programa de Ejemplo de Empaquetado . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4.4. Uso de Tablas para el Empaquetado . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4.5. Ejemplo de Empaquetado con Tablas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

.

.

.

.

5. Perspectiva General de Controles
.
.

5.1.
5.2. Controles sin Ventana .

Jerarquía de Controles .
.

.
.

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

6. El Control de Botón

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
6.1. Botones Normales .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
6.2. Botones Biestado (Toggle Buttons)
6.3. Botones de Activación (Check Buttons)
. . . . . . . . . . . . . . . . . . . . . . . . . . . . .
6.4. Botones de Exclusión Mútua (Radio Buttons) . . . . . . . . . . . . . . . . . . . . . . . . . .

.

.

.

.

.

7. Ajustes

7.1. Creación de un Ajuste .
7.2. Utilización de Ajustes de la Forma Fácil
7.3.

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Interioridades de un Ajuste . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

.

.

8. Controles de Rango

.

.

.

8.1. Barras de Desplazamiento .
8.2. Controles de Escala .
.

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
8.2.1. Creación de un Control de Escala . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
8.2.2. Métodos y Señales (bueno, al menos métodos) . . . . . . . . . . . . . . . . . . . . .
8.3. Métodos Comunes de los Rangos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
8.3.1. Establecimiento de la Política de Actualización . . . . . . . . . . . . . . . . . . . . .
8.3.2. Obtención y Cambio de Ajustes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
8.4. Atajos de Teclas y Ratón .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
8.5. Ejemplo de Control de Rango . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

.

9. Miscelánea de Controles
.
.

.

.

.

.
.

.
.

.
.

.
.
.

.
9.1. Etiquetas .
.
9.2. Flechas (Arrow) .
.
9.3. El Objeto Pistas (Tooltip) .
9.4. Barras de Progreso (ProgressBar)
.
9.5. Diálogos .
Imágenes .
.
9.6.
9.6.1. Pixmaps .
.

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
.
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

9.7. Reglas .

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.

.
.

.
.

.

.

.

.

.

III

1
2

5
7
9
10
12

15
15
15

19
19
19
21
26
27

31
31
34

35
35
38
40
42

45
45
46
46

49
49
49
49
50
50
50
51
51
51

57
57
60
62
63
67
68
70
76

ÍNDICE GENERAL

.

.

.

.

.
.

.
.

.
.
9.8. Barras de Estado .
9.9. Entradas de Texto (Entry)
.
9.10. Botones Aumentar/Disminuir
.
.
9.11. Lista Desplegable (Combo)
.
.
.
9.12. Calendario .
.
.
.
.
.
9.13. Selección de Color .
.
9.14. Selectores de Fichero .
.
.
.
9.15. Diálogo de Selección de Fuentes

.
.
.

.
.
.

.
.

.

.

.

.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

79
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
81
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
84
.
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
89
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
90
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
96
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102

10. Controles Contenedores

.

.

.

.

.

.

.

.

.

.

.

.

.
.

.
.

.
.

.
.
.

.
.
.

105
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105
10.1. La Caja de Eventos (EventBox)
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106
.
10.2. El control Alineador
.
10.3. Contenedor Fijo (Fixed)
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
.
10.4. Contenedor de Disposición (Layout) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109
10.5. Marcos (Frame)
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
10.6. Marcos Proporcionales (AspectFrame) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115
10.7. Controles de Panel (HPaned y VPaned)
10.8. Vistas (Viewport)
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118
10.9. Ventanas de Desplazamiento (ScrolledWindow)
. . . . . . . . . . . . . . . . . . . . . . . . 118
.
10.10.Cajas de Botones (ButtonBoxes) .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
10.11.Barra de Herramientas (Toolbar)
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124
10.12.Fichas (Notebook) .
.
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129
10.13.Elementos incrustables y puntos de conexión (Plugs y Sockets) . . . . . . . . . . . . . . . . 133
10.13.1.Elementos incrustables (Plugs)
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133
10.13.2.Puntos de Conexión (Sockets) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134

.
.
.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

11. Control Menú

137
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137
.
11.1. Creación Manual de Menús .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139
11.2. Ejemplo de Menú Manual
.
.
.
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141
11.3. Uso de la Factoria de Elementos .
11.4. Ejemplo de Factoria de Elementos - ItemFactory . . . . . . . . . . . . . . . . . . . . . . . . 141

.
.
.

.
.

.

12. Área de Dibujo

12.1. Contexto Gráfico .
.
12.2. Métodos de Dibujo .

.
.

.
.

.
.

.
.

.
.

.
.

.
.

.
.

145
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149

13. Control de Vista de Texto

.
.

.
.

.
.

.
.

.
.

.
.

.
.

.
.

.
.

.
.

13.4. Iteradores de Texto .

157
13.1. Perspectiva general de la Vista de Texto . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157
13.2. Vistas de Texto .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157
.
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163
13.3. Buffers de Texto .
13.3.1. Información de estado de un Buffer de Texto . . . . . . . . . . . . . . . . . . . . . . 163
13.3.2. Creación de Iteradores de Texto . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164
13.3.3. Inserción, Obtención y Eliminación de Texto . . . . . . . . . . . . . . . . . . . . . . 164
13.3.4. Marcas de Texto (TextMark) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165
13.3.5. Creación y Uso de Etiquetas de Texto . . . . . . . . . . . . . . . . . . . . . . . . . . 166
13.3.6. Inserción de Imágenes y Controles . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168
13.4.1. Atributos de los Iteradores de Texto . . . . . . . . . . . . . . . . . . . . . . . . . . . 168
13.4.2. Atributos de Texto de un Iterador de Texto . . . . . . . . . . . . . . . . . . . . . . . 168
13.4.3. Copiar un Iterador de Texto . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169
13.4.4. Recuperar Texto y Objetos .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169
13.4.5. Comprobar Condiciones en un Iterador de Texto . . . . . . . . . . . . . . . . . . . . 169
13.4.6. Comprobar la posición en un Texto . . . . . . . . . . . . . . . . . . . . . . . . . . . 170
13.4.7. Movimiento a través del Texto . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171
13.4.8. Moverse a una Posición Determinada . . . . . . . . . . . . . . . . . . . . . . . . . . 172
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172
13.4.9. Búsqueda en el Texto .
13.5. Marcas de Texto .
.
. . . . . . .