label: Add property annotations

Connect properties, getters, and setters with annotations.
This commit is contained in:
Matthias Clasen
2021-02-23 22:44:25 -05:00
committed by Emmanuele Bassi
parent 6bc69a12cc
commit a8a15d48ad

View File

@@ -2166,7 +2166,7 @@ gtk_label_class_init (GtkLabelClass *class)
G_TYPE_BOOLEAN, 1, G_TYPE_STRING);
/**
* GtkLabel:label:
* GtkLabel:label: (attributes org.gtk.Property.get=gtk_label_get_label org.gtk.Property.set=gtk_label_set_label)
*
* The contents of the label.
*
@@ -2189,7 +2189,7 @@ gtk_label_class_init (GtkLabelClass *class)
GTK_PARAM_READWRITE);
/**
* GtkLabel:attributes:
* GtkLabel:attributes: (attributes org.gtk.Property.get=gtk_label_get_attributes org.gtk.Property.set=gtk_label_set_attributes)
*
* A list of style attributes to apply to the text of the label.
*/
@@ -2201,7 +2201,7 @@ gtk_label_class_init (GtkLabelClass *class)
GTK_PARAM_READWRITE);
/**
* GtkLabel:use-markup:
* GtkLabel:use-markup: (attributes org.gtk.Property.get=gtk_label_get_use_markup org.gtk.Property.set=gtk_label_set_use_markup)
*
* %TRUE if the text of the label includes Pango markup.
*
@@ -2215,7 +2215,7 @@ gtk_label_class_init (GtkLabelClass *class)
GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY);
/**
* GtkLabel:use-underline:
* GtkLabel:use-underline: (attributes org.gtk.Property.get=gtk_label_get_use_underline org.gtk.Property.set=gtk_label_set_use_underline)
*
* %TRUE if the text of the label indicates a mnemonic with _.
*/
@@ -2227,7 +2227,7 @@ gtk_label_class_init (GtkLabelClass *class)
GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY);
/**
* GtkLabel:justify:
* GtkLabel:justify: (attributes org.gtk.Property.get=gtk_label_get_justify org.gtk.Property.set=gtk_label_set_justify)
*
* The alignment of the lines in the text of the label, relative to each other.
*
@@ -2243,7 +2243,7 @@ gtk_label_class_init (GtkLabelClass *class)
GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY);
/**
* GtkLabel:xalign:
* GtkLabel:xalign: (attributes org.gtk.Property.get=gtk_label_get_xalign org.gtk.Property.set=gtk_label_set_xalign)
*
* The horizontal alignment of the label text inside its size allocation.
*
@@ -2259,7 +2259,7 @@ gtk_label_class_init (GtkLabelClass *class)
GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY);
/**
* GtkLabel:yalign:
* GtkLabel:yalign: (attributes org.gtk.Property.get=gtk_label_get_yalign org.gtk.Property.set=gtk_label_set_yalign)
*
* The vertical alignment of the label text inside its size allocation.
*
@@ -2275,7 +2275,7 @@ gtk_label_class_init (GtkLabelClass *class)
GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY);
/**
* GtkLabel:wrap:
* GtkLabel:wrap: (attributes org.gtk.Property.get=gtk_label_get_wrap org.gtk.Property.set=gtk_label_set_wrap)
*
* %TRUE if the label text will wrap if it gets too wide.
*/
@@ -2287,7 +2287,7 @@ gtk_label_class_init (GtkLabelClass *class)
GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY);
/**
* GtkLabel:wrap-mode:
* GtkLabel:wrap-mode: (attributes org.gtk.Property.get=gtk_label_get_wrap_mode org.gtk.Property.set=gtk_label_set_wrap_mode)
*
* Controls how the line wrapping is done.
*
@@ -2304,7 +2304,7 @@ gtk_label_class_init (GtkLabelClass *class)
GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY);
/**
* GtkLabel:selectable:
* GtkLabel:selectable: (attributes org.gtk.Property.get=gtk_label_get_selectable og.gtk.Property.set=gtk_label_set_selectable)
*
* Whether the label text can be selected with the mouse.
*/
@@ -2316,7 +2316,7 @@ gtk_label_class_init (GtkLabelClass *class)
GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY);
/**
* GtkLabel:mnemonic-keyval:
* GtkLabel:mnemonic-keyval: (attributes org.gtk.Property.get=gtk_label_get_mnemonic_keyval)
*
* The mnemonic accelerator key for the label.
*/
@@ -2329,7 +2329,7 @@ gtk_label_class_init (GtkLabelClass *class)
GTK_PARAM_READABLE);
/**
* GtkLabel:mnemonic-widget:
* GtkLabel:mnemonic-widget: (attributes org.gtk.Property.get=gtk_label_get_mnemonic_widget org.gtk.Property.set=gtk_label_set_mnemonic_widget)
*
* The widget to be activated when the labels mnemonic key is pressed.
*/
@@ -2341,7 +2341,7 @@ gtk_label_class_init (GtkLabelClass *class)
GTK_PARAM_READWRITE);
/**
* GtkLabel:ellipsize:
* GtkLabel:ellipsize: (attributes org.gtk.Property.get=gtk_label_get_ellipsize org.gtk.Property.set=gtk_label_set_ellipsize)
*
* The preferred place to ellipsize the string, if the label does
* not have enough room to display the entire string.
@@ -2363,7 +2363,7 @@ gtk_label_class_init (GtkLabelClass *class)
GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY);
/**
* GtkLabel:width-chars:
* GtkLabel:width-chars: (attributes org.gtk.Property.get=gtk_label_get_width_chars org.gtk.Property.set=gtk_label_set_width_chars)
*
* The desired width of the label, in characters.
*
@@ -2382,7 +2382,7 @@ gtk_label_class_init (GtkLabelClass *class)
GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY);
/**
* GtkLabel:single-line-mode:
* GtkLabel:single-line-mode: (attributes org.gtk.Property.get=gtk_label_get_single_line_mode org.gtk.Property.set=gtk_label_set_single_line_mode)
*
* Whether the label is in single line mode.
*
@@ -2399,7 +2399,7 @@ gtk_label_class_init (GtkLabelClass *class)
GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY);
/**
* GtkLabel:max-width-chars:
* GtkLabel:max-width-chars: (attributes org.gtk.Property.get=gtk_label_set_max_width_chars org.gtk.Property.set=gtk_label_set_max_width_chars)
*
* The desired maximum width of the label, in characters.
*
@@ -2418,7 +2418,7 @@ gtk_label_class_init (GtkLabelClass *class)
GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY);
/**
* GtkLabel:lines:
* GtkLabel:lines: (attributes org.gtk.Property.get=gtk_label_get_lines org.gtk.Property.set=gtk_label_set_lines)
*
* The number of lines to which an ellipsized, wrapping label
* should be limited.
@@ -2435,7 +2435,7 @@ gtk_label_class_init (GtkLabelClass *class)
GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY);
/**
* GtkLabel:extra-menu:
* GtkLabel:extra-menu: (attributes org.gtk.Property.get=gtk_label_get_extra_menu org.gtk.Property.set=gtk_label_set_extra_menu)
*
* A menu model whose contents will be appended to the context menu.
*/
@@ -2802,7 +2802,7 @@ label_mnemonic_widget_weak_notify (gpointer data,
}
/**
* gtk_label_set_mnemonic_widget:
* gtk_label_set_mnemonic_widget: (attributes org.gtk.Method.set_property=mnemonic-widget)
* @self: a `GtkLabel`
* @widget: (nullable): the target #GtkWidget, or %NULL to unset
*
@@ -2853,7 +2853,7 @@ gtk_label_set_mnemonic_widget (GtkLabel *self,
}
/**
* gtk_label_get_mnemonic_widget:
* gtk_label_get_mnemonic_widget: (attributes org.gtk.Method.get_property=mnemonic-widget)
* @self: a `GtkLabel`
*
* Retrieves the target of the mnemonic (keyboard shortcut) of this
@@ -2873,7 +2873,7 @@ gtk_label_get_mnemonic_widget (GtkLabel *self)
}
/**
* gtk_label_get_mnemonic_keyval:
* gtk_label_get_mnemonic_keyval: (attributes org.gtk.Method.get_property=mnemonic-keyval)
* @self: a `GtkLabel`
*
* Return the mnemonic accelerator.
@@ -3031,7 +3031,7 @@ gtk_label_set_text (GtkLabel *self,
}
/**
* gtk_label_set_attributes:
* gtk_label_set_attributes: (attributes org.gtk.Method.set_property=attributes)
* @self: a `GtkLabel`
* @attrs: (nullable): a [class@Pango.AttrList], or %NULL
*
@@ -3067,7 +3067,7 @@ gtk_label_set_attributes (GtkLabel *self,
}
/**
* gtk_label_get_attributes:
* gtk_label_get_attributes: (attributes org.gtk.Method.get_property=attributes)
* @self: a `GtkLabel`
*
* Gets the labels attribute list.
@@ -3091,7 +3091,7 @@ gtk_label_get_attributes (GtkLabel *self)
}
/**
* gtk_label_set_label:
* gtk_label_set_label: (attributes org.gtk.Method.set_property=label)
* @self: a `GtkLabel`
* @str: the new text to set for the label
*
@@ -3116,7 +3116,7 @@ gtk_label_set_label (GtkLabel *self,
}
/**
* gtk_label_get_label:
* gtk_label_get_label: (attributes org.gtk.Method.get_property=label)
* @self: a `GtkLabel`
*
* Fetches the text from a label.
@@ -3658,7 +3658,7 @@ gtk_label_get_text (GtkLabel *self)
}
/**
* gtk_label_set_justify:
* gtk_label_set_justify: (attributes org.gtk.Method.set_property=justify)
* @self: a `GtkLabel`
* @jtype: a `GtkJustification`
*
@@ -3691,7 +3691,7 @@ gtk_label_set_justify (GtkLabel *self,
}
/**
* gtk_label_get_justify:
* gtk_label_get_justify: (attributes org.gtk.Method.get_property=justify)
* @self: a `GtkLabel`
*
* Returns the justification of the label.
@@ -3709,7 +3709,7 @@ gtk_label_get_justify (GtkLabel *self)
}
/**
* gtk_label_set_ellipsize:
* gtk_label_set_ellipsize: (attributes org.gtk.Method.set_property=ellipsize)
* @self: a `GtkLabel`
* @mode: a `PangoEllipsizeMode`
*
@@ -3738,7 +3738,7 @@ gtk_label_set_ellipsize (GtkLabel *self,
}
/**
* gtk_label_get_ellipsize:
* gtk_label_get_ellipsize: (attributes org.gtk.Method.get_property=ellipsize)
* @self: a `GtkLabel`
*
* Returns the ellipsizing position of the label.
@@ -3756,7 +3756,7 @@ gtk_label_get_ellipsize (GtkLabel *self)
}
/**
* gtk_label_set_width_chars:
* gtk_label_set_width_chars: (attributes org.gtk.Method.set_property=width-chars)
* @self: a `GtkLabel`
* @n_chars: the new desired width, in characters.
*
@@ -3777,7 +3777,7 @@ gtk_label_set_width_chars (GtkLabel *self,
}
/**
* gtk_label_get_width_chars:
* gtk_label_get_width_chars: (attributes org.gtk.Method.get_property=width-chars)
* @self: a `GtkLabel`
*
* Retrieves the desired width of @label, in characters.
@@ -3795,7 +3795,7 @@ gtk_label_get_width_chars (GtkLabel *self)
}
/**
* gtk_label_set_max_width_chars:
* gtk_label_set_max_width_chars: (attributes org.gtk.Method.set_property=max-width-chars)
* @self: a `GtkLabel`
* @n_chars: the new desired maximum width, in characters.
*
@@ -3817,7 +3817,7 @@ gtk_label_set_max_width_chars (GtkLabel *self,
}
/**
* gtk_label_get_max_width_chars:
* gtk_label_get_max_width_chars: (attributes org.gtk.Method.get_property=max-width-chars)
* @self: a `GtkLabel`
*
* Retrieves the desired maximum width of @label, in characters.
@@ -3835,7 +3835,7 @@ gtk_label_get_max_width_chars (GtkLabel *self)
}
/**
* gtk_label_set_wrap:
* gtk_label_set_wrap: (attributes org.gtk.Method.set_property=wrap)
* @self: a `GtkLabel`
* @wrap: the setting
*
@@ -3870,7 +3870,7 @@ gtk_label_set_wrap (GtkLabel *self,
}
/**
* gtk_label_get_wrap:
* gtk_label_get_wrap: (attributes org.gtk.Method.get_property=wrap)
* @self: a `GtkLabel`
*
* Returns whether lines in the label are automatically wrapped.
@@ -3888,7 +3888,7 @@ gtk_label_get_wrap (GtkLabel *self)
}
/**
* gtk_label_set_wrap_mode:
* gtk_label_set_wrap_mode: (attributes org.gtk.Method.set_property=wrap-mode)
* @self: a `GtkLabel`
* @wrap_mode: the line wrapping mode
*
@@ -3914,7 +3914,7 @@ gtk_label_set_wrap_mode (GtkLabel *self,
}
/**
* gtk_label_get_wrap_mode:
* gtk_label_get_wrap_mode: (attributes org.gtk.Method.get_property=wrap-mode)
* @self: a `GtkLabel`
*
* Returns line wrap mode used by the label.
@@ -4688,7 +4688,7 @@ gtk_label_clear_select_info (GtkLabel *self)
}
/**
* gtk_label_set_selectable:
* gtk_label_set_selectable: (attributes org.gtk.Method.set_property=selectable)
* @self: a `GtkLabel`
* @setting: %TRUE to allow selecting text in the label
*
@@ -4735,7 +4735,7 @@ gtk_label_set_selectable (GtkLabel *self,
}
/**
* gtk_label_get_selectable:
* gtk_label_get_selectable: (attributes org.gtk.Method.get_property=selectable)
* @self: a `GtkLabel`
*
* Returns whether the label is selectable.
@@ -5020,7 +5020,7 @@ gtk_label_get_layout_offsets (GtkLabel *self,
}
/**
* gtk_label_set_use_markup:
* gtk_label_set_use_markup: (attributes org.gtk.Method.set_property=use-markup)
* @self: a `GtkLabel`
* @setting: %TRUE if the labels text should be parsed for markup.
*
@@ -5043,7 +5043,7 @@ gtk_label_set_use_markup (GtkLabel *self,
}
/**
* gtk_label_get_use_markup:
* gtk_label_get_use_markup: (attributes org.gtk.Method.get_property=use-markup)
* @self: a `GtkLabel`
*
* Returns whether the labels text is interpreted as Pango markup.
@@ -5061,7 +5061,7 @@ gtk_label_get_use_markup (GtkLabel *self)
}
/**
* gtk_label_set_use_underline:
* gtk_label_set_use_underline: (attributes org.gtk.Method.set_property=use-underline)
* @self: a `GtkLabel`
* @setting: %TRUE if underlines in the text indicate mnemonics
*
@@ -5082,7 +5082,7 @@ gtk_label_set_use_underline (GtkLabel *self,
}
/**
* gtk_label_get_use_underline:
* gtk_label_get_use_underline: (attributes org.gtk.Method.get_property=use-underline)
* @self: a `GtkLabel`
*
* Returns whether an embedded underlines in the label indicate mnemonics.
@@ -5101,7 +5101,7 @@ gtk_label_get_use_underline (GtkLabel *self)
}
/**
* gtk_label_set_single_line_mode:
* gtk_label_set_single_line_mode: (attributes org.gtk.Method.set_property=single-line-mode)
* @self: a `GtkLabel`
* @single_line_mode: %TRUE if the label should be in single line mode
*
@@ -5127,7 +5127,7 @@ gtk_label_set_single_line_mode (GtkLabel *self,
}
/**
* gtk_label_get_single_line_mode:
* gtk_label_get_single_line_mode: (attributes org.gtk.Method.get_property=single-line-mode)
* @self: a `GtkLabel`
*
* Returns whether the label is in single line mode.
@@ -5573,7 +5573,7 @@ _gtk_label_get_selection_bound (GtkLabel *self)
}
/**
* gtk_label_set_lines:
* gtk_label_set_lines: (attributes org.gtk.Method.set_property=lines)
* @self: a `GtkLabel`
* @lines: the desired number of lines, or -1
*
@@ -5599,7 +5599,7 @@ gtk_label_set_lines (GtkLabel *self,
}
/**
* gtk_label_get_lines:
* gtk_label_get_lines: (attributes org.gtk.Method.get_property=lines)
* @self: a `GtkLabel`
*
* Gets the number of lines to which an ellipsized, wrapping
@@ -5618,7 +5618,7 @@ gtk_label_get_lines (GtkLabel *self)
}
/**
* gtk_label_set_xalign:
* gtk_label_set_xalign: (attributes org.gtk.Method.set_property=xalign)
* @self: a `GtkLabel`
* @xalign: the new xalign value, between 0 and 1
*
@@ -5644,7 +5644,7 @@ gtk_label_set_xalign (GtkLabel *self,
}
/**
* gtk_label_get_xalign:
* gtk_label_get_xalign: (attributes org.gtk.Method.get_property=xalign)
* @self: a `GtkLabel`
*
* Gets the `xalign` of the label.
@@ -5662,7 +5662,7 @@ gtk_label_get_xalign (GtkLabel *self)
}
/**
* gtk_label_set_yalign:
* gtk_label_set_yalign: (attributes org.gtk.Method.get_property=yalign)
* @self: a `GtkLabel`
* @yalign: the new yalign value, between 0 and 1
*
@@ -5688,7 +5688,7 @@ gtk_label_set_yalign (GtkLabel *self,
}
/**
* gtk_label_get_yalign:
* gtk_label_get_yalign: (attributes org.gtk.Method.set_property=yalign)
* @self: a `GtkLabel`
*
* Gets the `yalign` of the label.
@@ -5706,7 +5706,7 @@ gtk_label_get_yalign (GtkLabel *self)
}
/**
* gtk_label_set_extra_menu:
* gtk_label_set_extra_menu: (attributes org.gtk.Method.set_property=extra-menu)
* @self: a `GtkLabel`
* @model: (allow-none): a `GMenuModel`
*
@@ -5727,7 +5727,7 @@ gtk_label_set_extra_menu (GtkLabel *self,
}
/**
* gtk_label_get_extra_menu:
* gtk_label_get_extra_menu: (attributes org.gtk.Method.get_property=extra-menu)
* @self: a `GtkLabel`
*
* Gets the extra menu model of @label.