Commit ec280c7b authored by Matthias Clasen's avatar Matthias Clasen Committed by Matthias Clasen

Document new properties as 2.4 additions.

2003-06-15  Matthias Clasen  <maclas@gmx.de>

	* gtk/gtkcalendar.c (gtk_calendar_class_init):
	* gtk/gtknotebook.c (gtk_notebook_class_init):
	* gtk/gtkalignment.c (gtk_alignment_class_init):
	* gtk/gtkpaned.c (gtk_paned_class_init): Document new properties
	as 2.4 additions.

	* gtk/gtkwidget.c (gtk_widget_class_init): Move inline signal docs
	to the proper place, immediately before the g_signal_new() call.

	* gtk/gtktextiter.h: Make the flags-nature of GtkTextSearchFlags
	more obvious.  (#115122, Jeff Franks)
parent ee9683ce
2003-06-15 Matthias Clasen <maclas@gmx.de>
* gtk/gtkcalendar.c (gtk_calendar_class_init):
* gtk/gtknotebook.c (gtk_notebook_class_init):
* gtk/gtkalignment.c (gtk_alignment_class_init):
* gtk/gtkpaned.c (gtk_paned_class_init): Document new properties
as 2.4 additions.
* gtk/gtkwidget.c (gtk_widget_class_init): Move inline signal docs
to the proper place, immediately before the g_signal_new() call.
* gtk/gtktextiter.h: Make the flags-nature of GtkTextSearchFlags
more obvious. (#115122, Jeff Franks)
2003-06-12 Anders Carlsson <andersca@codefactory.se>
* gtk/gtkwidget.c: (event_window_is_still_viewable):
......
2003-06-15 Matthias Clasen <maclas@gmx.de>
* gtk/gtkcalendar.c (gtk_calendar_class_init):
* gtk/gtknotebook.c (gtk_notebook_class_init):
* gtk/gtkalignment.c (gtk_alignment_class_init):
* gtk/gtkpaned.c (gtk_paned_class_init): Document new properties
as 2.4 additions.
* gtk/gtkwidget.c (gtk_widget_class_init): Move inline signal docs
to the proper place, immediately before the g_signal_new() call.
* gtk/gtktextiter.h: Make the flags-nature of GtkTextSearchFlags
more obvious. (#115122, Jeff Franks)
2003-06-12 Anders Carlsson <andersca@codefactory.se>
* gtk/gtkwidget.c: (event_window_is_still_viewable):
......
2003-06-15 Matthias Clasen <maclas@gmx.de>
* gtk/gtkcalendar.c (gtk_calendar_class_init):
* gtk/gtknotebook.c (gtk_notebook_class_init):
* gtk/gtkalignment.c (gtk_alignment_class_init):
* gtk/gtkpaned.c (gtk_paned_class_init): Document new properties
as 2.4 additions.
* gtk/gtkwidget.c (gtk_widget_class_init): Move inline signal docs
to the proper place, immediately before the g_signal_new() call.
* gtk/gtktextiter.h: Make the flags-nature of GtkTextSearchFlags
more obvious. (#115122, Jeff Franks)
2003-06-12 Anders Carlsson <andersca@codefactory.se>
* gtk/gtkwidget.c: (event_window_is_still_viewable):
......
2003-06-15 Matthias Clasen <maclas@gmx.de>
* gtk/gtkcalendar.c (gtk_calendar_class_init):
* gtk/gtknotebook.c (gtk_notebook_class_init):
* gtk/gtkalignment.c (gtk_alignment_class_init):
* gtk/gtkpaned.c (gtk_paned_class_init): Document new properties
as 2.4 additions.
* gtk/gtkwidget.c (gtk_widget_class_init): Move inline signal docs
to the proper place, immediately before the g_signal_new() call.
* gtk/gtktextiter.h: Make the flags-nature of GtkTextSearchFlags
more obvious. (#115122, Jeff Franks)
2003-06-12 Anders Carlsson <andersca@codefactory.se>
* gtk/gtkwidget.c: (event_window_is_still_viewable):
......
2003-06-15 Matthias Clasen <maclas@gmx.de>
* gtk/gtkcalendar.c (gtk_calendar_class_init):
* gtk/gtknotebook.c (gtk_notebook_class_init):
* gtk/gtkalignment.c (gtk_alignment_class_init):
* gtk/gtkpaned.c (gtk_paned_class_init): Document new properties
as 2.4 additions.
* gtk/gtkwidget.c (gtk_widget_class_init): Move inline signal docs
to the proper place, immediately before the g_signal_new() call.
* gtk/gtktextiter.h: Make the flags-nature of GtkTextSearchFlags
more obvious. (#115122, Jeff Franks)
2003-06-12 Anders Carlsson <andersca@codefactory.se>
* gtk/gtkwidget.c: (event_window_is_still_viewable):
......
......@@ -107,7 +107,7 @@ gtk_alignment_class_init (GtkAlignmentClass *class)
widget_class->size_request = gtk_alignment_size_request;
widget_class->size_allocate = gtk_alignment_size_allocate;
g_object_class_install_property (gobject_class,
PROP_XALIGN,
g_param_spec_float("xalign",
......@@ -147,7 +147,13 @@ gtk_alignment_class_init (GtkAlignmentClass *class)
G_PARAM_READABLE | G_PARAM_WRITABLE));
/* Padding properties: */
/**
* GtkAlignment:top-padding:
*
* The padding to insert at the top of the widget.
*
* Since: 2.4
*/
g_object_class_install_property (gobject_class,
PROP_PADDING_TOP,
g_param_spec_uint("top_padding",
......@@ -158,6 +164,13 @@ gtk_alignment_class_init (GtkAlignmentClass *class)
0,
G_PARAM_READABLE | G_PARAM_WRITABLE));
/**
* GtkAlignment:top-padding:
*
* The padding to insert at the bottom of the widget.
*
* Since: 2.4
*/
g_object_class_install_property (gobject_class,
PROP_PADDING_BOTTOM,
g_param_spec_uint("bottom_padding",
......@@ -168,6 +181,13 @@ gtk_alignment_class_init (GtkAlignmentClass *class)
0,
G_PARAM_READABLE | G_PARAM_WRITABLE));
/**
* GtkAlignment:top-padding:
*
* The padding to insert at the left of the widget.
*
* Since: 2.4
*/
g_object_class_install_property (gobject_class,
PROP_PADDING_LEFT,
g_param_spec_uint("left_padding",
......@@ -178,6 +198,13 @@ gtk_alignment_class_init (GtkAlignmentClass *class)
0,
G_PARAM_READABLE | G_PARAM_WRITABLE));
/**
* GtkAlignment:top-padding:
*
* The padding to insert at the right of the widget.
*
* Since: 2.4
*/
g_object_class_install_property (gobject_class,
PROP_PADDING_RIGHT,
g_param_spec_uint("right_padding",
......
......@@ -433,6 +433,14 @@ gtk_calendar_class_init (GtkCalendarClass *class)
_("The selected day (as a number between 1 and 31, or 0 to unselect the currently selected day)"),
0, 31, 0,
G_PARAM_READWRITE));
/**
* GtkCalendar:show-heading:
*
* Determines whether a heading is displayed.
*
* Since: 2.4
*/
g_object_class_install_property (gobject_class,
PROP_SHOW_HEADING,
g_param_spec_boolean ("show_heading",
......@@ -440,6 +448,14 @@ gtk_calendar_class_init (GtkCalendarClass *class)
_("If TRUE, a heading is displayed"),
TRUE,
G_PARAM_READWRITE));
/**
* GtkCalendar:show-day-names:
*
* Determines whether day names are displayed.
*
* Since: 2.4
*/
g_object_class_install_property (gobject_class,
PROP_SHOW_DAY_NAMES,
g_param_spec_boolean ("show_day_names",
......@@ -447,6 +463,13 @@ gtk_calendar_class_init (GtkCalendarClass *class)
_("If TRUE, day names are displayed"),
TRUE,
G_PARAM_READWRITE));
/**
* GtkCalendar:no-month-change:
*
* Determines whether the selected month can be changed.
*
* Since: 2.4
*/
g_object_class_install_property (gobject_class,
PROP_NO_MONTH_CHANGE,
g_param_spec_boolean ("no_month_change",
......@@ -454,6 +477,14 @@ gtk_calendar_class_init (GtkCalendarClass *class)
_("If TRUE, the selected month can not be changed"),
FALSE,
G_PARAM_READWRITE));
/**
* GtkCalendar:show-week-numbers:
*
* Determines whether week numbers are displayed.
*
* Since: 2.4
*/
g_object_class_install_property (gobject_class,
PROP_SHOW_WEEK_NUMBERS,
g_param_spec_boolean ("show_week_numbers",
......@@ -461,6 +492,14 @@ gtk_calendar_class_init (GtkCalendarClass *class)
_("If TRUE, week numbers are displayed"),
FALSE,
G_PARAM_READWRITE));
/**
* GtkCalendar:week-start-monday:
*
* If this is %TRUE, Monday is displayed as the first day of the week.
*
* Since: 2.4
*/
g_object_class_install_property (gobject_class,
PROP_WEEK_START_MONDAY,
g_param_spec_boolean ("week_start_monday",
......
......@@ -509,7 +509,16 @@ gtk_notebook_class_init (GtkNotebookClass *class)
_("A GtkPackType indicating whether the child is packed with reference to the start or end of the parent"),
GTK_TYPE_PACK_TYPE, GTK_PACK_START,
G_PARAM_READWRITE));
/**
* GtkNotebook:has-secondary-backward-stepper:
*
* The "has-secondary-backward-stepper" property determines whether
* a second backward arrow button is displayed on the opposite end
* of the tab area.
*
* Since: 2.4
*/
gtk_widget_class_install_style_property (widget_class,
g_param_spec_boolean ("has_secondary backward_stepper",
_("Secondary backward stepper"),
......@@ -518,6 +527,15 @@ gtk_notebook_class_init (GtkNotebookClass *class)
G_PARAM_READABLE));
/**
* GtkNotebook:has-secondary-forward-stepper:
*
* The "has-secondary-forward-stepper" property determines whether
* a second forward arrow button is displayed on the opposite end
* of the tab area.
*
* Since: 2.4
*/
gtk_widget_class_install_style_property (widget_class,
g_param_spec_boolean ("has_secondary_forward_stepper",
_("Secondary forward stepper"),
......@@ -526,6 +544,14 @@ gtk_notebook_class_init (GtkNotebookClass *class)
G_PARAM_READABLE));
/**
* GtkNotebook:has-backward-stepper:
*
* The "has-backward-stepper" property determines whether
* the standard backward arrow button is displayed.
*
* Since: 2.4
*/
gtk_widget_class_install_style_property (widget_class,
g_param_spec_boolean ("has_backward_stepper",
_("Backward stepper"),
......@@ -534,6 +560,14 @@ gtk_notebook_class_init (GtkNotebookClass *class)
G_PARAM_READABLE));
/**
* GtkNotebook:has-forward-stepper:
*
* The "has-forward-stepper" property determines whether
* the standard forward arrow button is displayed.
*
* Since: 2.4
*/
gtk_widget_class_install_style_property (widget_class,
g_param_spec_boolean ("has_forward_stepper",
_("Forward stepper"),
......
......@@ -256,6 +256,14 @@ gtk_paned_class_init (GtkPanedClass *class)
5,
G_PARAM_READABLE));
/**
* GtkPaned:resize:
*
* The "resize" child property determines whether the child expands and
* shrinks along with the paned widget.
*
* Since: 2.4
*/
gtk_container_class_install_child_property (container_class,
CHILD_PROP_RESIZE,
g_param_spec_boolean ("resize",
......@@ -264,6 +272,14 @@ gtk_paned_class_init (GtkPanedClass *class)
TRUE,
G_PARAM_READWRITE));
/**
* GtkPaned:shrink:
*
* The "shrink" child property determines whether the child can be made
* smaller than its requisition.
*
* Since: 2.4
*/
gtk_container_class_install_child_property (container_class,
CHILD_PROP_SHRINK,
g_param_spec_boolean ("shrink",
......
......@@ -35,8 +35,8 @@ extern "C" {
#endif /* __cplusplus */
typedef enum {
GTK_TEXT_SEARCH_VISIBLE_ONLY,
GTK_TEXT_SEARCH_TEXT_ONLY
GTK_TEXT_SEARCH_VISIBLE_ONLY = 1 << 0,
GTK_TEXT_SEARCH_TEXT_ONLY = 1 << 1
/* Possible future plans: SEARCH_CASE_INSENSITIVE, SEARCH_REGEXP */
} GtkTextSearchFlags;
......
......@@ -55,77 +55,6 @@
#define WIDGET_CLASS(w) GTK_WIDGET_GET_CLASS (w)
#define INIT_PATH_SIZE (512)
/**
* GtkWidget::child-notify:
* @widget: the object which received the signal.
* @pspec: the #GParamSpec of the changed child property.
* @user_data: user data set when the signal handler was connected.
*
* The ::child-notify signal is emitted for each child property that has
* changed on an object. The signal's detail holds the property name.
*/
/**
* GtkWidget::drag-data-received:
* @widget: the object which received the signal.
* @drag_context: the drag context
* @x: where the drop happened
* @y: where the drop happened
* @data: the received data
* @info: the info that has been registered with the target in the
* #GtkTargetList.
* @time: the timestamp at which the data was received
* @user_data: user data set when the signal handler was connected.
*
* The ::drag-data-received signal is emitted on the drop site when the drop
* happens and the data has been received. A handler for this signal is
* expected to process the received data and then call gtk_drag_finish(),
* setting the <literal>success</literal> parameter depending on whether the
* data was processed successfully.
*
* The handler may inspect and modify <literal>context-&gt;action</literal>
* before calling gtk_drag_finish(), e.g. to implement %GTK_ACTION_ASK as
* shown in the following example:
* <informalexample><programlisting>
* void
* drag_data_received (GtkWidget *widget,
* GdkDragContext *context,
* gint x,
* gint y,
* GtkSelectionData *data,
* guint info,
* guint time)
* {
* if ((data->length >= 0) && (data->format == 8))
* {
* if (context->action == GDK_ACTION_ASK)
* {
* GtkWidget *dialog;
* gint response;
*
* dialog = gtk_message_dialog_new (NULL,
* GTK_DIALOG_MODAL |
* GTK_DIALOG_DESTROY_WITH_PARENT,
* GTK_MESSAGE_INFO,
* GTK_BUTTONS_YES_NO,
* "Move the data ?\n");
* response = gtk_dialog_run (GTK_DIALOG (dialog));
* gtk_widget_destroy (dialog);
*
* if (response == GTK_RESPONSE_YES)
* context->action = GDK_ACTION_MOVE;
* else
* context->action = GDK_ACTION_COPY;
* }
*
* gtk_drag_finish (context, TRUE, FALSE, time);
* return;
* }
*
* gtk_drag_finish (context, FALSE, FALSE, time);
* }
* </programlisting></informalexample>
*/
enum {
SHOW,
......@@ -711,6 +640,16 @@ gtk_widget_class_init (GtkWidgetClass *klass)
_gtk_marshal_VOID__BOOLEAN,
G_TYPE_NONE, 1,
G_TYPE_BOOLEAN);
/**
* GtkWidget::child-notify:
* @widget: the object which received the signal.
* @pspec: the #GParamSpec of the changed child property.
* @user_data: user data set when the signal handler was connected.
*
* The ::child-notify signal is emitted for each child property that has
* changed on an object. The signal's detail holds the property name.
*/
widget_signals[CHILD_NOTIFY] =
g_signal_new ("child_notify",
G_TYPE_FROM_CLASS (gobject_class),
......@@ -1056,6 +995,68 @@ gtk_widget_class_init (GtkWidgetClass *klass)
GTK_TYPE_SELECTION_DATA | G_SIGNAL_TYPE_STATIC_SCOPE,
G_TYPE_UINT,
G_TYPE_UINT);
/**
* GtkWidget::drag-data-received:
* @widget: the object which received the signal.
* @drag_context: the drag context
* @x: where the drop happened
* @y: where the drop happened
* @data: the received data
* @info: the info that has been registered with the target in the
* #GtkTargetList.
* @time: the timestamp at which the data was received
* @user_data: user data set when the signal handler was connected.
*
* The ::drag-data-received signal is emitted on the drop site when the drop
* happens and the data has been received. A handler for this signal is
* expected to process the received data and then call gtk_drag_finish(),
* setting the <literal>success</literal> parameter depending on whether the
* data was processed successfully.
*
* The handler may inspect and modify <literal>context-&gt;action</literal>
* before calling gtk_drag_finish(), e.g. to implement %GTK_ACTION_ASK as
* shown in the following example:
* <informalexample><programlisting>
* void
* drag_data_received (GtkWidget *widget,
* GdkDragContext *context,
* gint x,
* gint y,
* GtkSelectionData *data,
* guint info,
* guint time)
* {
* if ((data->length >= 0) && (data->format == 8))
* {
* if (context->action == GDK_ACTION_ASK)
* {
* GtkWidget *dialog;
* gint response;
*
* dialog = gtk_message_dialog_new (NULL,
* GTK_DIALOG_MODAL |
* GTK_DIALOG_DESTROY_WITH_PARENT,
* GTK_MESSAGE_INFO,
* GTK_BUTTONS_YES_NO,
* "Move the data ?\n");
* response = gtk_dialog_run (GTK_DIALOG (dialog));
* gtk_widget_destroy (dialog);
*
* if (response == GTK_RESPONSE_YES)
* context->action = GDK_ACTION_MOVE;
* else
* context->action = GDK_ACTION_COPY;
* }
*
* gtk_drag_finish (context, TRUE, FALSE, time);
* return;
* }
*
* gtk_drag_finish (context, FALSE, FALSE, time);
* }
* </programlisting></informalexample>
*/
widget_signals[DRAG_DATA_RECEIVED] =
g_signal_new ("drag_data_received",
G_TYPE_FROM_CLASS (gobject_class),
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment