[gtk+] Frame—Note set_label always destroys :label-widget



commit e0b70f3629dc0b9fa82888b341fafb9b775dfef5
Author: Daniel Boles <dboles src gnome org>
Date:   Tue Feb 21 21:18:01 2017 +0000

    Frame—Note set_label always destroys :label-widget
    
    The fact that it doesn’t reuse the existing GtkLabel if present is not
    immediately obvious to users (or is it just me?), so clarify that the
    pre-existing :label-widget, if any, is always removed and replaced.

 gtk/gtkframe.c |    9 ++++-----
 1 files changed, 4 insertions(+), 5 deletions(-)
---
diff --git a/gtk/gtkframe.c b/gtk/gtkframe.c
index 7095c57..8489730 100644
--- a/gtk/gtkframe.c
+++ b/gtk/gtkframe.c
@@ -420,8 +420,8 @@ gtk_frame_forall (GtkContainer *container,
  * @frame: a #GtkFrame
  * @label: (allow-none): the text to use as the label of the frame
  *
- * Sets the text of the label. If @label is %NULL,
- * the current label is removed.
+ * Removes the current #GtkFrame:label-widget. If @label is not %NULL, creates a
+ * new #GtkLabel with that text and adds it as the #GtkFrame:label-widget.
  **/
 void
 gtk_frame_set_label (GtkFrame *frame,
@@ -476,9 +476,8 @@ gtk_frame_get_label (GtkFrame *frame)
  * @frame: a #GtkFrame
  * @label_widget: (nullable): the new label widget
  * 
- * Sets the label widget for the frame. This is the widget that
- * will appear embedded in the top edge of the frame as a
- * title.
+ * Sets the #GtkFrame:label-widget for the frame. This is the widget that
+ * will appear embedded in the top edge of the frame as a title.
  **/
 void
 gtk_frame_set_label_widget (GtkFrame  *frame,


[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]