Se agrega un limite mas claro al nombre y se corrige falta de un include.

[z.facultad/75.42/figuras.git] / callbacks.h

diff --git a/callbacks.h b/callbacks.h
index e7cb716886cacc3cdc1e6be30ed1f11caa1b2dbc..e2d27c93ba93dc2c99d617cb7745a97cbd80fc01 100644 (file)
--- a/callbacks.h
+++ b/callbacks.h
@@ -16,28 +16,98 @@
 
 #include <gtk/gtk.h>
 
 
 #include <gtk/gtk.h>
 

+/**
+ * Función llamada cuando hay que redibujar una porción del área de dibujo.
+ * 
+ * \param widget Área de dibujo que recibió el evento.
+ * \param event Evento (tiene información del área que necesita ser repintada).
+ * \param user_data Dibujo con las figuras a redibujar.
+ */

 gboolean on_drawingarea_expose_event(GtkWidget *widget, GdkEventExpose *event,
         gpointer user_data);
 
 gboolean on_drawingarea_expose_event(GtkWidget *widget, GdkEventExpose *event,
         gpointer user_data);
 

+/**
+ * Función llamada cuando se presiona el botón de Limpiar.
+ *
+ * \param button Botón presionado.
+ * \param user_data Dibujo con las figuras a borrar.
+ */

 void on_button_borrar_clicked(GtkButton *button, gpointer user_data);
 
 void on_button_borrar_clicked(GtkButton *button, gpointer user_data);
 

+/**
+ * Función llamada cuando se presiona el botón de Actualizar.
+ *
+ * \param button Botón presionado.
+ * \param user_data Área de dibujo a actualizar.
+ */

 void on_button_graficar_clicked(GtkButton *button, gpointer user_data);
 
 void on_button_graficar_clicked(GtkButton *button, gpointer user_data);
 

+/**
+ * Función llamada cuando se presiona el botón de Salir.
+ *
+ * \param button Botón presionado.
+ * \param user_data No utilizado.
+ */

 void on_button_salir_clicked(GtkButton *button, gpointer user_data);
 
 void on_button_salir_clicked(GtkButton *button, gpointer user_data);
 

+/**
+ * Función llamada cuando se presiona el botón de Agregar.
+ *
+ * \param button Botón presionado.
+ * \param user_data TP5Window con todos los widget necesarios para tomar la
+ * entrada del usuario y crear la nueva figura.
+ */

 void on_button_agregar_clicked(GtkButton *button, gpointer user_data);
 
 void on_button_agregar_clicked(GtkButton *button, gpointer user_data);
 

+/**
+ * Función llamada cuando el manejador de ventanas manda el evento Delete.
+ * Típicamente esto sucede cuando se presiona la X en la decoración de la
+ * ventana).
+ * 
+ * \param widget Ventana que recibió el evento.
+ * \param event Evento.
+ * \param user_data No utilizado.
+ */

 gboolean on_window_delete_event(GtkWidget *widget, GdkEvent *event,
         gpointer user_data);
 
 gboolean on_window_delete_event(GtkWidget *widget, GdkEvent *event,
         gpointer user_data);
 

+/**
+ * Función llamada cuando se presiona el botón de selección Línea.
+ *
+ * \param button Botón presionado.
+ * \param user_data TP5Window con los widgets que hay que activar y desactivar
+ * para que el usuario sólo pueda ingresar los datos que tengan sentido.
+ */

 void on_radiobutton_linea_toggled(GtkToggleButton *togglebutton,
         gpointer user_data);
 
 void on_radiobutton_linea_toggled(GtkToggleButton *togglebutton,
         gpointer user_data);
 

+/**
+ * Función llamada cuando se presiona el botón de selección Cuadrado.
+ *
+ * \param button Botón presionado.
+ * \param user_data TP5Window con los widgets que hay que activar y desactivar
+ * para que el usuario sólo pueda ingresar los datos que tengan sentido.
+ */

 void on_radiobutton_cuadrado_toggled(GtkToggleButton *togglebutton,
         gpointer user_data);
 
 void on_radiobutton_cuadrado_toggled(GtkToggleButton *togglebutton,
         gpointer user_data);
 

+/**
+ * Función llamada cuando se presiona el botón de selección Rectángulo.
+ *
+ * \param button Botón presionado.
+ * \param user_data TP5Window con los widgets que hay que activar y desactivar
+ * para que el usuario sólo pueda ingresar los datos que tengan sentido.
+ */

 void on_radiobutton_rectangulo_toggled(GtkToggleButton *togglebutton,
         gpointer user_data);
 
 void on_radiobutton_rectangulo_toggled(GtkToggleButton *togglebutton,
         gpointer user_data);
 

+/**
+ * Función llamada cuando se presiona el botón de selección Círculo.
+ *
+ * \param button Botón presionado.
+ * \param user_data TP5Window con los widgets que hay que activar y desactivar
+ * para que el usuario sólo pueda ingresar los datos que tengan sentido.
+ */

 void on_radiobutton_circulo_toggled(GtkToggleButton *togglebutton,
         gpointer user_data);
 void on_radiobutton_circulo_toggled(GtkToggleButton *togglebutton,
         gpointer user_data);

+