summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorDaniel Boles <dboles@src.gnome.org>2017-02-21 21:18:01 +0000
committerDaniel Boles <dboles@src.gnome.org>2017-02-21 21:26:43 +0000
commite0b70f3629dc0b9fa82888b341fafb9b775dfef5 (patch)
tree51300d58fee40adc0d26b2163dbe7caf0a6fe003
parentb106c5e4d56c88c32ba3d2940171e71cbfc77627 (diff)
downloadgtk+-e0b70f3629dc0b9fa82888b341fafb9b775dfef5.tar.gz
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.
-rw-r--r--gtk/gtkframe.c9
1 files changed, 4 insertions, 5 deletions
diff --git a/gtk/gtkframe.c b/gtk/gtkframe.c
index 7095c570ad..8489730e39 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,