AuroraMiddleware/gtk
1
0
Fork 1
mirror of https://gitlab.gnome.org/GNOME/gtk.git synced 2024-11-12 20:00:09 +00:00
Code Issues Projects Releases Wiki Activity

Merge branch 'mark-deprecations' into 'main'

Browse Source 
docs: Mark various deprecations

See merge request GNOME/gtk!5502
This commit is contained in:
Matthias Clasen 2023-02-12 21:44:00 +00:00
commit cef7e6b741
5 changed files with 142 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

74
gtk/deprecated/gtkassistant.c
View File

@ -60,12 +60,16 @@
*
* `GtkAssistant` has a single CSS node with the name window and style
* class .assistant.
*
* Deprecated: 4.10: This widget will be removed in GTK 5
*/
/**
* GtkAssistantPage:
*
* `GtkAssistantPage` is an auxiliary object used by `GtkAssistant.
*
* Deprecated: 4.10: This object will be removed in GTK 5
*/
#include "config.h"
@ -275,6 +279,8 @@ gtk_assistant_page_class_init (GtkAssistantPageClass *class)
* GtkAssistantPage:page-type:
*
* The type of the assistant page.
*
* Deprecated: 4.10: This object will be removed in GTK 5
*/
g_object_class_install_property (object_class,
CHILD_PROP_PAGE_TYPE,
@ -287,6 +293,8 @@ gtk_assistant_page_class_init (GtkAssistantPageClass *class)
* GtkAssistantPage:title:
*
* The title of the page.
*
* Deprecated: 4.10: This object will be removed in GTK 5
*/
g_object_class_install_property (object_class,
CHILD_PROP_PAGE_TITLE,
@ -301,6 +309,8 @@ gtk_assistant_page_class_init (GtkAssistantPageClass *class)
*
* GTK uses this information to control the sensitivity
* of the navigation buttons.
*
* Deprecated: 4.10: This object will be removed in GTK 5
*/
g_object_class_install_property (object_class,
CHILD_PROP_PAGE_COMPLETE,
@ -312,6 +322,8 @@ gtk_assistant_page_class_init (GtkAssistantPageClass *class)
* GtkAssistantPage:child:
*
* The child widget.
*
* Deprecated: 4.10: This object will be removed in GTK 5
*/
g_object_class_install_property (object_class,
CHILD_PROP_CHILD,
@ -518,6 +530,8 @@ gtk_assistant_class_init (GtkAssistantClass *class)
* @assistant: the `GtkAssistant`
*
* Emitted when then the cancel button is clicked.
*
* Deprecated: 4.10: This widget will be removed in GTK 5
*/
signals[CANCEL] =
g_signal_new (I_("cancel"),
@ -538,6 +552,8 @@ gtk_assistant_class_init (GtkAssistantClass *class)
*
* A handler for this signal can do any preparations which are
* necessary before showing @page.
*
* Deprecated: 4.10: This widget will be removed in GTK 5
*/
signals[PREPARE] =
g_signal_new (I_("prepare"),
@ -563,6 +579,8 @@ gtk_assistant_class_init (GtkAssistantClass *class)
* %GTK_ASSISTANT_PAGE_PROGRESS after the confirmation page and handle
* this operation within the [signal@Gtk.Assistant::prepare] signal of
* the progress page.
*
* Deprecated: 4.10: This widget will be removed in GTK 5
*/
signals[APPLY] =
g_signal_new (I_("apply"),
@ -580,6 +598,8 @@ gtk_assistant_class_init (GtkAssistantClass *class)
* Emitted either when the close button of a summary page is clicked,
* or when the apply button in the last page in the flow (of type
* %GTK_ASSISTANT_PAGE_CONFIRM) is clicked.
*
* Deprecated: 4.10: This widget will be removed in GTK 5
*/
signals[CLOSE] =
g_signal_new (I_("close"),
@ -595,6 +615,8 @@ gtk_assistant_class_init (GtkAssistantClass *class)
* @assistant: the `GtkAssistant`
*
* The action signal for the Escape binding.
*
* Deprecated: 4.10: This widget will be removed in GTK 5
*/
signals[ESCAPE] =
g_signal_new_class_handler (I_("escape"),
@ -618,6 +640,8 @@ gtk_assistant_class_init (GtkAssistantClass *class)
*
* For technical reasons, this property is declared as an integer
* property, but you should only set it to %TRUE or %FALSE.
*
* Deprecated: 4.10: This widget will be removed in GTK 5
*/
g_object_class_install_property (gobject_class,
PROP_USE_HEADER_BAR,
@ -1435,6 +1459,8 @@ gtk_assistant_close_request (GtkWindow *window)
* Creates a new `GtkAssistant`.
*
* Returns: a newly created `GtkAssistant`
*
* Deprecated: 4.10: This widget will be removed in GTK 5
*/
GtkWidget*
gtk_assistant_new (void)
@ -1455,6 +1481,8 @@ gtk_assistant_new (void)
* Returns: The index (starting from 0) of the current
* page in the @assistant, or -1 if the @assistant has no pages,
* or no current page
*
* Deprecated: 4.10: This widget will be removed in GTK 5
*/
int
gtk_assistant_get_current_page (GtkAssistant *assistant)
@ -1480,6 +1508,8 @@ gtk_assistant_get_current_page (GtkAssistant *assistant)
* Note that this will only be necessary in custom buttons,
* as the @assistant flow can be set with
* gtk_assistant_set_forward_page_func().
*
* Deprecated: 4.10: This widget will be removed in GTK 5
*/
void
gtk_assistant_set_current_page (GtkAssistant *assistant,
@ -1525,6 +1555,8 @@ gtk_assistant_set_current_page (GtkAssistant *assistant,
*
* This function is for use when creating pages of the
* %GTK_ASSISTANT_PAGE_CUSTOM type.
*
* Deprecated: 4.10: This widget will be removed in GTK 5
*/
void
gtk_assistant_next_page (GtkAssistant *assistant)
@ -1548,6 +1580,8 @@ gtk_assistant_next_page (GtkAssistant *assistant)
*
* This function is for use when creating pages of the
* %GTK_ASSISTANT_PAGE_CUSTOM type.
*
* Deprecated: 4.10: This widget will be removed in GTK 5
*/
void
gtk_assistant_previous_page (GtkAssistant *assistant)
@ -1581,6 +1615,8 @@ gtk_assistant_previous_page (GtkAssistant *assistant)
* Returns the number of pages in the @assistant
*
* Returns: the number of pages in the @assistant
*
* Deprecated: 4.10: This widget will be removed in GTK 5
*/
int
gtk_assistant_get_n_pages (GtkAssistant *assistant)
@ -1600,6 +1636,8 @@ gtk_assistant_get_n_pages (GtkAssistant *assistant)
*
* Returns: (nullable) (transfer none): the child widget, or %NULL
* if @page_num is out of bounds
*
* Deprecated: 4.10: This widget will be removed in GTK 5
*/
GtkWidget*
gtk_assistant_get_nth_page (GtkAssistant *assistant,
@ -1632,6 +1670,8 @@ gtk_assistant_get_nth_page (GtkAssistant *assistant,
* Prepends a page to the @assistant.
*
* Returns: the index (starting at 0) of the inserted page
*
* Deprecated: 4.10: This widget will be removed in GTK 5
*/
int
gtk_assistant_prepend_page (GtkAssistant *assistant,
@ -1651,6 +1691,8 @@ gtk_assistant_prepend_page (GtkAssistant *assistant,
* Appends a page to the @assistant.
*
* Returns: the index (starting at 0) of the inserted page
*
* Deprecated: 4.10: This widget will be removed in GTK 5
*/
int
gtk_assistant_append_page (GtkAssistant *assistant,
@ -1672,6 +1714,8 @@ gtk_assistant_append_page (GtkAssistant *assistant,
* Inserts a page in the @assistant at a given position.
*
* Returns: the index (starting from 0) of the inserted page
*
* Deprecated: 4.10: This widget will be removed in GTK 5
*/
int
gtk_assistant_insert_page (GtkAssistant *assistant,
@ -1770,6 +1814,8 @@ gtk_assistant_add_page (GtkAssistant *assistant,
* or -1 to remove the last page
*
* Removes the @page_num’s page from @assistant.
*
* Deprecated: 4.10: This widget will be removed in GTK 5
*/
void
gtk_assistant_remove_page (GtkAssistant *assistant,
@ -1805,6 +1851,8 @@ gtk_assistant_remove_page (GtkAssistant *assistant,
* Setting @page_func to %NULL will make the assistant to
* use the default forward function, which just goes to the
* next visible page.
*
* Deprecated: 4.10: This widget will be removed in GTK 5
*/
void
gtk_assistant_set_forward_page_func (GtkAssistant *assistant,
@ -1853,6 +1901,8 @@ add_to_action_area (GtkAssistant *assistant,
* @child: a `GtkWidget`
*
* Adds a widget to the action area of a `GtkAssistant`.
*
* Deprecated: 4.10: This widget will be removed in GTK 5
*/
void
gtk_assistant_add_action_widget (GtkAssistant *assistant,
@ -1881,6 +1931,8 @@ gtk_assistant_add_action_widget (GtkAssistant *assistant,
* @child: a `GtkWidget`
*
* Removes a widget from the action area of a `GtkAssistant`.
*
* Deprecated: 4.10: This widget will be removed in GTK 5
*/
void
gtk_assistant_remove_action_widget (GtkAssistant *assistant,
@ -1910,6 +1962,8 @@ gtk_assistant_remove_action_widget (GtkAssistant *assistant,
*
* The title is displayed in the header area of the assistant
* when @page is the current page.
*
* Deprecated: 4.10: This widget will be removed in GTK 5
*/
void
gtk_assistant_set_page_title (GtkAssistant *assistant,
@ -1939,6 +1993,8 @@ gtk_assistant_set_page_title (GtkAssistant *assistant,
* Gets the title for @page.
*
* Returns: the title for @page
*
* Deprecated: 4.10: This widget will be removed in GTK 5
*/
const char *
gtk_assistant_get_page_title (GtkAssistant *assistant,
@ -1968,6 +2024,8 @@ gtk_assistant_get_page_title (GtkAssistant *assistant,
* Sets the page type for @page.
*
* The page type determines the page behavior in the @assistant.
*
* Deprecated: 4.10: This widget will be removed in GTK 5
*/
void
gtk_assistant_set_page_type (GtkAssistant *assistant,
@ -1997,6 +2055,8 @@ gtk_assistant_set_page_type (GtkAssistant *assistant,
* Gets the page type of @page.
*
* Returns: the page type of @page
*
* Deprecated: 4.10: This widget will be removed in GTK 5
*/
GtkAssistantPageType
gtk_assistant_get_page_type (GtkAssistant *assistant,
@ -2027,6 +2087,8 @@ gtk_assistant_get_page_type (GtkAssistant *assistant,
*
* This will make @assistant update the buttons state
* to be able to continue the task.
*
* Deprecated: 4.10: This widget will be removed in GTK 5
*/
void
gtk_assistant_set_page_complete (GtkAssistant *assistant,
@ -2056,6 +2118,8 @@ gtk_assistant_set_page_complete (GtkAssistant *assistant,
* Gets whether @page is complete.
*
* Returns: %TRUE if @page is complete.
*
* Deprecated: 4.10: This widget will be removed in GTK 5
*/
gboolean
gtk_assistant_get_page_complete (GtkAssistant *assistant,
@ -2089,6 +2153,8 @@ gtk_assistant_get_page_complete (GtkAssistant *assistant,
* One situation where it can be necessary to call this
* function is when changing a value on the current page
* affects the future page flow of the assistant.
*
* Deprecated: 4.10: This widget will be removed in GTK 5
*/
void
gtk_assistant_update_buttons_state (GtkAssistant *assistant)
@ -2112,6 +2178,8 @@ gtk_assistant_update_buttons_state (GtkAssistant *assistant)
* or undone. For example, showing a progress page to track
* a long-running, unreversible operation after the user has
* clicked apply on a confirmation page.
*
* Deprecated: 4.10: This widget will be removed in GTK 5
*/
void
gtk_assistant_commit (GtkAssistant *assistant)
@ -2189,6 +2257,8 @@ gtk_assistant_buildable_custom_finished (GtkBuildable *buildable,
* Returns the `GtkAssistantPage` object for @child.
*
* Returns: (transfer none): the `GtkAssistantPage` for @child
*
* Deprecated: 4.10: This widget will be removed in GTK 5
*/
GtkAssistantPage *
gtk_assistant_get_page (GtkAssistant *assistant,
@ -2205,6 +2275,8 @@ gtk_assistant_get_page (GtkAssistant *assistant,
* Returns the child to which @page belongs.
*
* Returns: (transfer none): the child to which @page belongs
*
* Deprecated: 4.10: This widget will be removed in GTK 5
*/
GtkWidget *
gtk_assistant_page_get_child (GtkAssistantPage *page)
@ -2316,6 +2388,8 @@ gtk_assistant_pages_new (GtkAssistant *assistant)
* Gets a list model of the assistant pages.
*
* Returns: (transfer full) (attributes element-type=GtkAssistantPage): A list model of the pages.
*
* Deprecated: 4.10: This widget will be removed in GTK 5
*/
GListModel *
gtk_assistant_get_pages (GtkAssistant *assistant)

32
gtk/deprecated/gtkcellareacontext.c
View File

@ -34,6 +34,8 @@
* same context which was used to request sizes for a given `GtkTreeModel`
* row also be used for the same row when calling other `GtkCellArea` APIs
* such as gtk_cell_area_render() and gtk_cell_area_event().
*
* Deprecated: 4.10: This object will be removed in GTK 5
*/
#include "config.h"
@ -107,6 +109,8 @@ gtk_cell_area_context_class_init (GtkCellAreaContextClass *class)
* GtkCellAreaContext:area:
*
* The `GtkCellArea` this context was created by
*
* Deprecated: 4.10: This object will be removed in GTK 5
*/
g_object_class_install_property (object_class,
PROP_CELL_AREA,
@ -120,6 +124,8 @@ gtk_cell_area_context_class_init (GtkCellAreaContextClass *class)
* The minimum width for the `GtkCellArea` in this context
* for all `GtkTreeModel` rows that this context was requested
* for using gtk_cell_area_get_preferred_width().
*
* Deprecated: 4.10: This object will be removed in GTK 5
*/
g_object_class_install_property (object_class,
PROP_MIN_WIDTH,
@ -133,6 +139,8 @@ gtk_cell_area_context_class_init (GtkCellAreaContextClass *class)
* The natural width for the `GtkCellArea` in this context
* for all `GtkTreeModel` rows that this context was requested
* for using gtk_cell_area_get_preferred_width().
*
* Deprecated: 4.10: This object will be removed in GTK 5
*/
g_object_class_install_property (object_class,
PROP_NAT_WIDTH,
@ -146,6 +154,8 @@ gtk_cell_area_context_class_init (GtkCellAreaContextClass *class)
* The minimum height for the `GtkCellArea` in this context
* for all `GtkTreeModel` rows that this context was requested
* for using gtk_cell_area_get_preferred_height().
*
* Deprecated: 4.10: This object will be removed in GTK 5
*/
g_object_class_install_property (object_class,
PROP_MIN_HEIGHT,
@ -159,6 +169,8 @@ gtk_cell_area_context_class_init (GtkCellAreaContextClass *class)
* The natural height for the `GtkCellArea` in this context
* for all `GtkTreeModel` rows that this context was requested
* for using gtk_cell_area_get_preferred_height().
*
* Deprecated: 4.10: This object will be removed in GTK 5
*/
g_object_class_install_property (object_class,
PROP_NAT_HEIGHT,
@ -309,7 +321,7 @@ gtk_cell_area_context_real_allocate (GtkCellAreaContext *context,
*
* Returns: (transfer none): the `GtkCellArea` this context was created by.
*
* Deprecated: 4.10
* Deprecated: 4.10: This object will be removed in GTK 5
*/
GtkCellArea *
gtk_cell_area_context_get_area (GtkCellAreaContext *context)
@ -348,7 +360,7 @@ gtk_cell_area_context_get_area (GtkCellAreaContext *context)
* of all the displayed row heights using
* gtk_cell_area_get_preferred_height_for_width().
*
* Deprecated: 4.10
* Deprecated: 4.10: This object will be removed in GTK 5
*/
void
gtk_cell_area_context_reset (GtkCellAreaContext *context)
@ -377,7 +389,7 @@ gtk_cell_area_context_reset (GtkCellAreaContext *context)
* rows. This is generally the case for `GtkTreeView` when
* `GtkTreeView:fixed-height-mode` is enabled.
*
* Deprecated: 4.10
* Deprecated: 4.10: This object will be removed in GTK 5
*/
void
gtk_cell_area_context_allocate (GtkCellAreaContext *context,
@ -401,7 +413,7 @@ gtk_cell_area_context_allocate (GtkCellAreaContext *context,
* After gtk_cell_area_context_reset() is called and/or before ever
* requesting the size of a `GtkCellArea`, the returned values are 0.
*
* Deprecated: 4.10
* Deprecated: 4.10: This object will be removed in GTK 5
*/
void
gtk_cell_area_context_get_preferred_width (GtkCellAreaContext *context,
@ -431,7 +443,7 @@ gtk_cell_area_context_get_preferred_width (GtkCellAreaContext *context,
* After gtk_cell_area_context_reset() is called and/or before ever
* requesting the size of a `GtkCellArea`, the returned values are 0.
*
* Deprecated: 4.10
* Deprecated: 4.10: This object will be removed in GTK 5
*/
void
gtk_cell_area_context_get_preferred_height (GtkCellAreaContext *context,
@ -462,7 +474,7 @@ gtk_cell_area_context_get_preferred_height (GtkCellAreaContext *context,
* After gtk_cell_area_context_reset() is called and/or before ever
* requesting the size of a `GtkCellArea`, the returned values are -1.
*
* Deprecated: 4.10
* Deprecated: 4.10: This object will be removed in GTK 5
*/
void
gtk_cell_area_context_get_preferred_height_for_width (GtkCellAreaContext *context,
@ -492,7 +504,7 @@ gtk_cell_area_context_get_preferred_height_for_width (GtkCellAreaContext *contex
* After gtk_cell_area_context_reset() is called and/or before ever
* requesting the size of a `GtkCellArea`, the returned values are -1.
*
* Deprecated: 4.10
* Deprecated: 4.10: This object will be removed in GTK 5
*/
void
gtk_cell_area_context_get_preferred_width_for_height (GtkCellAreaContext *context,
@ -521,7 +533,7 @@ gtk_cell_area_context_get_preferred_width_for_height (GtkCellAreaContext *contex
* context was recently reset with gtk_cell_area_context_reset(),
* the returned value will be -1.
*
* Deprecated: 4.10
* Deprecated: 4.10: This object will be removed in GTK 5
*/
void
gtk_cell_area_context_get_allocation (GtkCellAreaContext *context,
@ -553,7 +565,7 @@ gtk_cell_area_context_get_allocation (GtkCellAreaContext *context,
* progressively push the requested width over a series of
* gtk_cell_area_get_preferred_width() requests.
*
* Deprecated: 4.10
* Deprecated: 4.10: This object will be removed in GTK 5
*/
void
gtk_cell_area_context_push_preferred_width (GtkCellAreaContext *context,
@ -597,7 +609,7 @@ gtk_cell_area_context_push_preferred_width (GtkCellAreaContext *context,
* progressively push the requested height over a series of
* gtk_cell_area_get_preferred_height() requests.
*
* Deprecated: 4.10
* Deprecated: 4.10: This object will be removed in GTK 5
*/
void
gtk_cell_area_context_push_preferred_height (GtkCellAreaContext *context,

20
gtk/deprecated/gtklockbutton.c
View File

@ -70,6 +70,8 @@ G_GNUC_BEGIN_IGNORE_DEPRECATIONS
* [property@Gtk.LockButton:tooltip-lock],
* [property@Gtk.LockButton:tooltip-unlock] and
* [property@Gtk.LockButton:tooltip-not-authorized] properties.
*
* Deprecated: 4.10: This widget will be removed in GTK 5
*/
struct _GtkLockButton
@ -271,6 +273,8 @@ gtk_lock_button_class_init (GtkLockButtonClass *klass)
* GtkLockButton:permission: (attributes org.gtk.Property.get=gtk_lock_button_get_permission org.gtk.Property.set=gtk_lock_button_set_permission)
*
* The `GPermission object controlling this button.
*
* Deprecated: 4.10: This widget will be removed in GTK 5
*/
g_object_class_install_property (gobject_class, PROP_PERMISSION,
g_param_spec_object ("permission", NULL, NULL,
@ -282,6 +286,8 @@ gtk_lock_button_class_init (GtkLockButtonClass *klass)
* GtkLockButton:text-lock:
*
* The text to display when prompting the user to lock.
*
* Deprecated: 4.10: This widget will be removed in GTK 5
*/
g_object_class_install_property (gobject_class, PROP_TEXT_LOCK,
g_param_spec_string ("text-lock", NULL, NULL,
@ -294,6 +300,8 @@ gtk_lock_button_class_init (GtkLockButtonClass *klass)
* GtkLockButton:text-unlock:
*
* The text to display when prompting the user to unlock.
*
* Deprecated: 4.10: This widget will be removed in GTK 5
*/
g_object_class_install_property (gobject_class, PROP_TEXT_UNLOCK,
g_param_spec_string ("text-unlock", NULL, NULL,
@ -306,6 +314,8 @@ gtk_lock_button_class_init (GtkLockButtonClass *klass)
* GtkLockButton:tooltip-lock:
*
* The tooltip to display when prompting the user to lock.
*
* Deprecated: 4.10: This widget will be removed in GTK 5
*/
g_object_class_install_property (gobject_class, PROP_TOOLTIP_LOCK,
g_param_spec_string ("tooltip-lock", NULL, NULL,
@ -318,6 +328,8 @@ gtk_lock_button_class_init (GtkLockButtonClass *klass)
* GtkLockButton:tooltip-unlock:
*
* The tooltip to display when prompting the user to unlock.
*
* Deprecated: 4.10: This widget will be removed in GTK 5
*/
g_object_class_install_property (gobject_class, PROP_TOOLTIP_UNLOCK,
g_param_spec_string ("tooltip-unlock", NULL, NULL,
@ -330,6 +342,8 @@ gtk_lock_button_class_init (GtkLockButtonClass *klass)
* GtkLockButton:tooltip-not-authorized:
*
* The tooltip to display when the user cannot obtain authorization.
*
* Deprecated: 4.10: This widget will be removed in GTK 5
*/
g_object_class_install_property (gobject_class, PROP_TOOLTIP_NOT_AUTHORIZED,
g_param_spec_string ("tooltip-not-authorized", NULL, NULL,
@ -511,6 +525,8 @@ gtk_lock_button_clicked (GtkButton *widget)
* Creates a new lock button which reflects the @permission.
*
* Returns: a new `GtkLockButton`
*
* Deprecated: 4.10: This widget will be removed in GTK 5
*/
GtkWidget *
gtk_lock_button_new (GPermission *permission)
@ -527,6 +543,8 @@ gtk_lock_button_new (GPermission *permission)
* Obtains the `GPermission` object that controls @button.
*
* Returns: (transfer none) (nullable): the `GPermission` of @button
*
* Deprecated: 4.10: This widget will be removed in GTK 5
*/
GPermission *
gtk_lock_button_get_permission (GtkLockButton *button)
@ -542,6 +560,8 @@ gtk_lock_button_get_permission (GtkLockButton *button)
* @permission: (nullable): a `GPermission` object
*
* Sets the `GPermission` object that controls @button.
*
* Deprecated: 4.10: This widget will be removed in GTK 5
*/
void
gtk_lock_button_set_permission (GtkLockButton *button,

20
gtk/deprecated/gtkstatusbar.c
View File

@ -77,6 +77,8 @@ G_GNUC_BEGIN_IGNORE_DEPRECATIONS
* ## CSS node
*
* `GtkStatusbar` has a single CSS node with name `statusbar`.
*
* Deprecated: 4.10: This widget will be removed in GTK 5
*/
typedef struct _GtkStatusbarMsg GtkStatusbarMsg;
@ -167,6 +169,8 @@ gtk_statusbar_class_init (GtkStatusbarClass *class)
* @text: the message that was pushed
*
* Emitted whenever a new message gets pushed onto a statusbar's stack.
*
* Deprecated: 4.10: This widget will be removed in GTK 5
*/
statusbar_signals[SIGNAL_TEXT_PUSHED] =
g_signal_new (I_("text-pushed"),
@ -186,6 +190,8 @@ gtk_statusbar_class_init (GtkStatusbarClass *class)
* @text: the message that was just popped
*
* Emitted whenever a new message is popped off a statusbar's stack.
*
* Deprecated: 4.10: This widget will be removed in GTK 5
*/
statusbar_signals[SIGNAL_TEXT_POPPED] =
g_signal_new (I_("text-popped"),
@ -225,6 +231,8 @@ gtk_statusbar_init (GtkStatusbar *statusbar)
* Creates a new `GtkStatusbar` ready for messages.
*
* Returns: the new `GtkStatusbar`
*
* Deprecated: 4.10: This widget will be removed in GTK 5
*/
GtkWidget*
gtk_statusbar_new (void)
@ -257,6 +265,8 @@ gtk_statusbar_update (GtkStatusbar *statusbar,
* Note that the description is not shown in the UI.
*
* Returns: an integer id
*
* Deprecated: 4.10: This widget will be removed in GTK 5
*/
guint
gtk_statusbar_get_context_id (GtkStatusbar *statusbar,
@ -317,6 +327,8 @@ gtk_statusbar_msg_free (GtkStatusbarMsg *msg)
*
* Returns: a message id that can be used with
* [method@Gtk.Statusbar.remove].
*
* Deprecated: 4.10: This widget will be removed in GTK 5
*/
guint
gtk_statusbar_push (GtkStatusbar *statusbar,
@ -351,6 +363,8 @@ gtk_statusbar_push (GtkStatusbar *statusbar,
* Note that this may not change the displayed message,
* if the message at the top of the stack has a different
* context id.
*
* Deprecated: 4.10: This widget will be removed in GTK 5
*/
void
gtk_statusbar_pop (GtkStatusbar *statusbar,
@ -395,6 +409,8 @@ gtk_statusbar_pop (GtkStatusbar *statusbar,
*
* Forces the removal of a message from a statusbar’s stack.
* The exact @context_id and @message_id must be specified.
*
* Deprecated: 4.10: This widget will be removed in GTK 5
*/
void
gtk_statusbar_remove (GtkStatusbar *statusbar,
@ -443,6 +459,8 @@ gtk_statusbar_remove (GtkStatusbar *statusbar,
*
* Forces the removal of all messages from a statusbar's
* stack with the exact @context_id.
*
* Deprecated: 4.10: This widget will be removed in GTK 5
*/
void
gtk_statusbar_remove_all (GtkStatusbar *statusbar,
@ -499,6 +517,8 @@ gtk_statusbar_remove_all (GtkStatusbar *statusbar,
* Retrieves the contents of the label in `GtkStatusbar`.
*
* Returns: (transfer none): the contents of the statusbar
*
* Deprecated: 4.10: This widget will be removed in GTK 5
*/
const char *
gtk_statusbar_get_message (GtkStatusbar *statusbar)

6
gtk/deprecated/gtkvolumebutton.c
View File

@ -44,6 +44,8 @@ G_GNUC_BEGIN_IGNORE_DEPRECATIONS
* volume control.
*
* ![An example GtkVolumeButton](volumebutton.png)
*
* Deprecated: 4.10: This widget will be removed in GTK 5
*/
typedef struct _GtkVolumeButtonClass GtkVolumeButtonClass;
@ -168,6 +170,8 @@ gtk_volume_button_class_init (GtkVolumeButtonClass *klass)
*
* Note that if the symbolic icons are not available in your installed
* theme, then the normal (potentially colorful) icons will be used.
*
* Deprecated: 4.10: This widget will be removed in GTK 5
*/
g_object_class_install_property (gobject_class,
PROP_SYMBOLIC,
@ -200,6 +204,8 @@ gtk_volume_button_init (GtkVolumeButton *button)
* [class@Gtk.ScaleButton].
*
* Returns: a new `GtkVolumeButton`
*
* Deprecated: 4.10: This widget will be removed in GTK 5
*/
GtkWidget *
gtk_volume_button_new (void)