From 284def64a77c05b341a46a2dab6b7db4bf784824 Mon Sep 17 00:00:00 2001 From: Owen Taylor Date: Tue, 5 Jun 2001 14:55:53 +0000 Subject: [PATCH] Improve docs for GtkStateType. (Fixes #55751, among other things.) Tue Jun 5 10:54:48 2001 Owen Taylor * gtk/tmpl/gtkenums.sgml: Improve docs for GtkStateType. (Fixes #55751, among other things.) --- docs/reference/ChangeLog | 5 +++++ docs/reference/gtk/tmpl/gtkenums.sgml | 18 +++++++++++------- 2 files changed, 16 insertions(+), 7 deletions(-) diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog index 7c0af55c48..8d4e86042c 100644 --- a/docs/reference/ChangeLog +++ b/docs/reference/ChangeLog @@ -1,3 +1,8 @@ +Tue Jun 5 10:54:48 2001 Owen Taylor + + * gtk/tmpl/gtkenums.sgml: Improve docs for GtkStateType. + (Fixes #55751, among other things.) + Mon Jun 4 15:08:21 2001 Owen Taylor * gtk/gtk-overrides.txt: Remove GtkArgSetFunc, GtkArgGetFunc. diff --git a/docs/reference/gtk/tmpl/gtkenums.sgml b/docs/reference/gtk/tmpl/gtkenums.sgml index 7fbd1e25d1..0b086b36c0 100644 --- a/docs/reference/gtk/tmpl/gtkenums.sgml +++ b/docs/reference/gtk/tmpl/gtkenums.sgml @@ -288,15 +288,19 @@ does -This type indicates the current state of a widget. +This type indicates the current state of a widget; the state determines how +the widget is drawn. The #GtkStateType enumeration is also used to +identify different colors in a #GtkStyle for drawing, so states can be +used for subparts of a widget as well as entire widgets. -@GTK_STATE_NORMAL: The state during normal operation. -@GTK_STATE_ACTIVE: The widget is currently active, such as a -@GTK_STATE_PRELIGHT: The mouse pointer is over the widget. -@GTK_STATE_SELECTED: -@GTK_STATE_INSENSITIVE: The state of the widget can not be altered by the -user. Its appearance will usually indicate this. +@GTK_STATE_NORMAL: State during normal operation. +@GTK_STATE_ACTIVE: State of a currently active widget, such as a depressed button. +@GTK_STATE_PRELIGHT: State indicating that the mouse pointer is over +the widget and the widget will respond to mouse clicks. +@GTK_STATE_SELECTED: State of a selected item, such the selected row in a list. +@GTK_STATE_INSENSITIVE: State indicating that the widget is +unresponsive to user actions.