From 592570d168ee918bdf7a090e4aca9a921caf9fde Mon Sep 17 00:00:00 2001 From: Miguel de Icaza Date: Tue, 15 Jun 2004 03:46:45 +0000 Subject: [PATCH] My contribs svn path=/trunk/gtk-sharp/; revision=29564 --- doc/en/Gdk/Pixbuf.xml | 10 +++++----- doc/en/Gtk/Main.xml | 43 ++++++++++++++++++++++++++----------------- doc/en/Gtk/Object.xml | 37 +++++++++++++++++++++++-------------- 3 files changed, 54 insertions(+), 36 deletions(-) diff --git a/doc/en/Gdk/Pixbuf.xml b/doc/en/Gdk/Pixbuf.xml index 7d92f99d8..102a566a0 100644 --- a/doc/en/Gdk/Pixbuf.xml +++ b/doc/en/Gdk/Pixbuf.xml @@ -1374,11 +1374,11 @@ To be added - a - a - a - a - a + Name of the file where the image will be saved + The file type to save (one of "ani", "bmp", "gif", "ico", "jpeg", "pcx", "png", "pnm", "ras", "tga", "tiff" "wbmp", "xpm" or "xbm") + Options that are passed to the save module. + Values for each key + To be added: an object of type 'bool' To be added diff --git a/doc/en/Gtk/Main.xml b/doc/en/Gtk/Main.xml index ce14424d8..dbb34b35b 100644 --- a/doc/en/Gtk/Main.xml +++ b/doc/en/Gtk/Main.xml @@ -10,8 +10,15 @@ Gtk# is thread aware, but not thread safe; See the Gtk# Thread Programming for details. - To be added - To be added + Main loop event processing class. + + +Like all GUI toolkits, GTK+ uses an event-driven programming model. When the user is doing nothing, GTK+ sits in the main loop and waits for input. If the user performs some action - say, a mouse click - then the main loop "wakes up" and delivers an event to GTK+. GTK+ forwards the event to one or more widgets. + +When widgets receive an event, they frequently emit one or more signals. Signals notify your program that "something interesting happened" by invoking functions you've connected to the signal with g_signal_connect(). Functions connected to a signal are often termed callbacks. + +When your callbacks are invoked, you would typically take some action - for example, when an Open button is clicked you might display a GtkFileSelectionDialog. After a callback finishes, GTK+ will return to the main loop and await more user input. + System.Object @@ -29,10 +36,11 @@ - To be added - a - a - To be added + Runs one iteration of the main loop. + + if you want Gtk# to block if no events are pending. + Returns if the method was invoked to terminate the innermost loop. + Runs a single iteration of the mainloop. If no events are available either return or block dependent on the value of blocking. @@ -43,9 +51,9 @@ - To be added - a - To be added + Returns the current main loop level. + The nesting level of the current main loop. + Asks for the current nesting level of the main loop. This can be useful when calling the method. @@ -56,9 +64,10 @@ - To be added - a - To be added + Runs an iteration of the main loop: blocks until an event is received. + + if the method was called to terminate the innermost main loop. + Runs a single iteration of the main loop. If no events are waiting to be processed Gtk# will block until the next event is noticed. If you don't want to block look at or check if any events are pending with first. @@ -71,9 +80,9 @@ - To be added - a - To be added + Processes a single Gdk Event. + An event to process (normally) passed by GDK. + Processes a single GDK event. This is public only to allow filtering of events between GDK and GTK+. You will not usually need to call this function directly. @@ -84,8 +93,8 @@ - To be added - To be added + Terminates the innermost main loop. + This terminates the innermost main loop. diff --git a/doc/en/Gtk/Object.xml b/doc/en/Gtk/Object.xml index d4f177061..76f960a20 100644 --- a/doc/en/Gtk/Object.xml +++ b/doc/en/Gtk/Object.xml @@ -10,8 +10,12 @@ Gtk# is thread aware, but not thread safe; See the Gtk# Thread Programming for details. - To be added - To be added + Base class for the Gtk object hierarchy. + Base object for the Gtk object hierarchy. + + +The differences between Gtk.Object and GLib. is a historical one, and it matters little in Gtk#. + GLib.Object @@ -34,8 +38,13 @@ - To be added - To be added + Request all holders to the object to release the reference. + This method is used to notify objects that might hold a reference to this object to release the reference. + +This invokes the method and triggers the event. + +The object is only destroyed if all the references to the object are released, this is just a mechanism to request that references be released. + @@ -87,10 +96,10 @@ - To be added - To be added: an object of type 'IntPtr' - To be added: an object of type 'IntPtr' - To be added + Helper property to associate information with an object. + The value to store/retrieve + + This is not very useful with the Gtk# binding as it is with the C binding. @@ -101,8 +110,8 @@ - To be added - To be added + Raised to signal that all references to this object should be removed. + This event is triggered if someone has invoked the 's method. It is used to inform that all references to the object must be discarded at this point. @@ -126,8 +135,8 @@ - To be added - To be added + Invoked to request that references to the object be released. + This method is invoked when someone has called the 's method. Any references to the object held should be released at this point. @@ -163,9 +172,9 @@ - To be added + Internal. a - To be added + Internal constructor.