summaryrefslogtreecommitdiff
path: root/docs/refcounting.txt
diff options
context:
space:
mode:
authorTim Janik <timj@gimp.org>1998-02-11 00:40:20 +0000
committerTim Janik <timj@src.gnome.org>1998-02-11 00:40:20 +0000
commited848ac41e726b2ca27ccdf474f66def61a7f9e5 (patch)
treef764a207c04e6db43c723b94319a50ce6c07db23 /docs/refcounting.txt
parent2090cc650c7d1c391f1d78d85469b5589982f790 (diff)
downloadgtk+-ed848ac41e726b2ca27ccdf474f66def61a7f9e5.tar.gz
backed out the section "Gnits to care about". new file, kinda developers
Wed Feb 11 00:18:31 1998 Tim Janik <timj@gimp.org> * docs/refcounting.txt: backed out the section "Gnits to care about". * docs/developers.txt: new file, kinda developers FAQ.
Diffstat (limited to 'docs/refcounting.txt')
-rw-r--r--docs/refcounting.txt26
1 files changed, 6 insertions, 20 deletions
diff --git a/docs/refcounting.txt b/docs/refcounting.txt
index aa8823e225..82817d5c41 100644
--- a/docs/refcounting.txt
+++ b/docs/refcounting.txt
@@ -35,6 +35,10 @@ ref_count is updated accordingly.
You can call gdk_window_destroy more than once on a particular
GdkWindow, it will only be destroyed when it hasn't been yet. The
ref_count is *always* decremented, tho. Be careful.
+
+Remark: When writing NO_WINDOW widgets, care should be taken about
+ proper referencing/unreferencing of the parent's GdkWindow
+ that is used by the widget.
GdkPixmap
---------
@@ -301,28 +305,10 @@ void gtk_menu_item_remove_submenu (GtkMenuItem *menu_item);
void gtk_option_menu_remove_menu (GtkOptionMenu *option_menu);
-Gnits to care about
--------------------
-
-On another note, though somewhat unrelated, the notification nature
-of the signal mechanism might cause events to be emitted that have their
-GdkWindow pointer set to NULL. This is due to the fact that certain
-events need to be emitted after the real GdkWindow of a widget is not
-any longer pertinent. It's up to the application to check for the window
-field of the event structure to be != NULL, if it is going to perform
-any operations through Gdk calls on it.
-Events that a likely to trigger a missing check for the window pointer
-currently are (and correspond to the trailing signals):
-
-GDK_SELECTION_CLEAR GtkWidget::selection_clear_event
-GDK_FOCUS_CHANGE GtkWidget::focus_in_event
- GtkWidget::focus_out_event
-
-
Initial proposal:
- Marius Vollmer <mvo@zagadka.ping.de>
-Small fixups, "Taking care of proper referencing" and reference
-counting solution for GtkMenus:
+Some modifications/additions, "Taking care of proper referencing" and
+reference counting solution for GtkMenus:
- Tim Janik <timj@gimp.org>