X-Git-Url: https://git.llucax.com/z.facultad/75.42/figuras.git/blobdiff_plain/63ef0f452aeb53c1f9a3492c0c0e4a4f59ba1f1e..074cfd6ced0df4c6a74cc6193194fa2489c05887:/callbacks.h?ds=sidebyside

diff --git a/callbacks.h b/callbacks.h
index e7cb716..d6b9899 100644
--- a/callbacks.h
+++ b/callbacks.h
@@ -16,28 +16,98 @@
 
 #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);
 
+/**
+ * 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);
 
+/**
+ * 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);
 
+/**
+ * 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);
 
+/**
+ * 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);
 
+/**
+ * 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);
 
+/**
+ * Función llamada cuando se presiona el botón de selección Línea.
+ *
+ * \param togglebutton 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);
 
+/**
+ * Función llamada cuando se presiona el botón de selección Cuadrado.
+ *
+ * \param togglebutton 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);
 
+/**
+ * Función llamada cuando se presiona el botón de selección Rectángulo.
+ *
+ * \param togglebutton 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);
 
+/**
+ * Función llamada cuando se presiona el botón de selección Círculo.
+ *
+ * \param togglebutton 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);
+