AuroraMiddleware/gtk
1
0
Fork 1
mirror of https://gitlab.gnome.org/GNOME/gtk.git synced 2025-01-13 22:10:08 +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 * `GtkAssistant` has a single CSS node with the name window and style
* class .assistant. * class .assistant.
*
* Deprecated: 4.10: This widget will be removed in GTK 5
*/ */
/** /**
* GtkAssistantPage: * GtkAssistantPage:
* *
* `GtkAssistantPage` is an auxiliary object used by `GtkAssistant. * `GtkAssistantPage` is an auxiliary object used by `GtkAssistant.
*
* Deprecated: 4.10: This object will be removed in GTK 5
*/ */
#include "config.h" #include "config.h"
@ -275,6 +279,8 @@ gtk_assistant_page_class_init (GtkAssistantPageClass *class)
* GtkAssistantPage:page-type: * GtkAssistantPage:page-type:
* *
* The type of the assistant page. * The type of the assistant page.
*
* Deprecated: 4.10: This object will be removed in GTK 5
*/ */
g_object_class_install_property (object_class, g_object_class_install_property (object_class,
CHILD_PROP_PAGE_TYPE, CHILD_PROP_PAGE_TYPE,
@ -287,6 +293,8 @@ gtk_assistant_page_class_init (GtkAssistantPageClass *class)
* GtkAssistantPage:title: * GtkAssistantPage:title:
* *
* The title of the page. * The title of the page.
*
* Deprecated: 4.10: This object will be removed in GTK 5
*/ */
g_object_class_install_property (object_class, g_object_class_install_property (object_class,
CHILD_PROP_PAGE_TITLE, CHILD_PROP_PAGE_TITLE,
@ -301,6 +309,8 @@ gtk_assistant_page_class_init (GtkAssistantPageClass *class)
* *
* GTK uses this information to control the sensitivity * GTK uses this information to control the sensitivity
* of the navigation buttons. * of the navigation buttons.
*
* Deprecated: 4.10: This object will be removed in GTK 5
*/ */
g_object_class_install_property (object_class, g_object_class_install_property (object_class,
CHILD_PROP_PAGE_COMPLETE, CHILD_PROP_PAGE_COMPLETE,
@ -312,6 +322,8 @@ gtk_assistant_page_class_init (GtkAssistantPageClass *class)
* GtkAssistantPage:child: * GtkAssistantPage:child:
* *
* The child widget. * The child widget.
*
* Deprecated: 4.10: This object will be removed in GTK 5
*/ */
g_object_class_install_property (object_class, g_object_class_install_property (object_class,
CHILD_PROP_CHILD, CHILD_PROP_CHILD,
@ -518,6 +530,8 @@ gtk_assistant_class_init (GtkAssistantClass *class)
* @assistant: the `GtkAssistant` * @assistant: the `GtkAssistant`
* *
* Emitted when then the cancel button is clicked. * Emitted when then the cancel button is clicked.
*
* Deprecated: 4.10: This widget will be removed in GTK 5
*/ */
signals[CANCEL] = signals[CANCEL] =
g_signal_new (I_("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 * A handler for this signal can do any preparations which are
* necessary before showing @page. * necessary before showing @page.
*
* Deprecated: 4.10: This widget will be removed in GTK 5
*/ */
signals[PREPARE] = signals[PREPARE] =
g_signal_new (I_("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 * %GTK_ASSISTANT_PAGE_PROGRESS after the confirmation page and handle
* this operation within the [signal@Gtk.Assistant::prepare] signal of * this operation within the [signal@Gtk.Assistant::prepare] signal of
* the progress page. * the progress page.
*
* Deprecated: 4.10: This widget will be removed in GTK 5
*/ */
signals[APPLY] = signals[APPLY] =
g_signal_new (I_("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, * 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 * or when the apply button in the last page in the flow (of type
* %GTK_ASSISTANT_PAGE_CONFIRM) is clicked. * %GTK_ASSISTANT_PAGE_CONFIRM) is clicked.
*
* Deprecated: 4.10: This widget will be removed in GTK 5
*/ */
signals[CLOSE] = signals[CLOSE] =
g_signal_new (I_("close"), g_signal_new (I_("close"),
@ -595,6 +615,8 @@ gtk_assistant_class_init (GtkAssistantClass *class)
* @assistant: the `GtkAssistant` * @assistant: the `GtkAssistant`
* *
* The action signal for the Escape binding. * The action signal for the Escape binding.
*
* Deprecated: 4.10: This widget will be removed in GTK 5
*/ */
signals[ESCAPE] = signals[ESCAPE] =
g_signal_new_class_handler (I_("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 * For technical reasons, this property is declared as an integer
* property, but you should only set it to %TRUE or %FALSE. * 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, g_object_class_install_property (gobject_class,
PROP_USE_HEADER_BAR, PROP_USE_HEADER_BAR,
@ -1435,6 +1459,8 @@ gtk_assistant_close_request (GtkWindow *window)
* Creates a new `GtkAssistant`. * Creates a new `GtkAssistant`.
* *
* Returns: a newly created `GtkAssistant` * Returns: a newly created `GtkAssistant`
*
* Deprecated: 4.10: This widget will be removed in GTK 5
*/ */
GtkWidget* GtkWidget*
gtk_assistant_new (void) gtk_assistant_new (void)
@ -1455,6 +1481,8 @@ gtk_assistant_new (void)
* Returns: The index (starting from 0) of the current * Returns: The index (starting from 0) of the current
* page in the @assistant, or -1 if the @assistant has no pages, * page in the @assistant, or -1 if the @assistant has no pages,
* or no current page * or no current page
*
* Deprecated: 4.10: This widget will be removed in GTK 5
*/ */
int int
gtk_assistant_get_current_page (GtkAssistant *assistant) 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, * Note that this will only be necessary in custom buttons,
* as the @assistant flow can be set with * as the @assistant flow can be set with
* gtk_assistant_set_forward_page_func(). * gtk_assistant_set_forward_page_func().
*
* Deprecated: 4.10: This widget will be removed in GTK 5
*/ */
void void
gtk_assistant_set_current_page (GtkAssistant *assistant, 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 * This function is for use when creating pages of the
* %GTK_ASSISTANT_PAGE_CUSTOM type. * %GTK_ASSISTANT_PAGE_CUSTOM type.
*
* Deprecated: 4.10: This widget will be removed in GTK 5
*/ */
void void
gtk_assistant_next_page (GtkAssistant *assistant) 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 * This function is for use when creating pages of the
* %GTK_ASSISTANT_PAGE_CUSTOM type. * %GTK_ASSISTANT_PAGE_CUSTOM type.
*
* Deprecated: 4.10: This widget will be removed in GTK 5
*/ */
void void
gtk_assistant_previous_page (GtkAssistant *assistant) 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
* *
* 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 int
gtk_assistant_get_n_pages (GtkAssistant *assistant) 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 * Returns: (nullable) (transfer none): the child widget, or %NULL
* if @page_num is out of bounds * if @page_num is out of bounds
*
* Deprecated: 4.10: This widget will be removed in GTK 5
*/ */
GtkWidget* GtkWidget*
gtk_assistant_get_nth_page (GtkAssistant *assistant, gtk_assistant_get_nth_page (GtkAssistant *assistant,
@ -1632,6 +1670,8 @@ gtk_assistant_get_nth_page (GtkAssistant *assistant,
* Prepends a page to the @assistant. * Prepends a page to the @assistant.
* *
* Returns: the index (starting at 0) of the inserted page * Returns: the index (starting at 0) of the inserted page
*
* Deprecated: 4.10: This widget will be removed in GTK 5
*/ */
int int
gtk_assistant_prepend_page (GtkAssistant *assistant, gtk_assistant_prepend_page (GtkAssistant *assistant,
@ -1651,6 +1691,8 @@ gtk_assistant_prepend_page (GtkAssistant *assistant,
* Appends a page to the @assistant. * Appends a page to the @assistant.
* *
* Returns: the index (starting at 0) of the inserted page * Returns: the index (starting at 0) of the inserted page
*
* Deprecated: 4.10: This widget will be removed in GTK 5
*/ */
int int
gtk_assistant_append_page (GtkAssistant *assistant, 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. * Inserts a page in the @assistant at a given position.
* *
* Returns: the index (starting from 0) of the inserted page * Returns: the index (starting from 0) of the inserted page
*
* Deprecated: 4.10: This widget will be removed in GTK 5
*/ */
int int
gtk_assistant_insert_page (GtkAssistant *assistant, gtk_assistant_insert_page (GtkAssistant *assistant,
@ -1770,6 +1814,8 @@ gtk_assistant_add_page (GtkAssistant *assistant,
* or -1 to remove the last page * or -1 to remove the last page
* *
* Removes the @page_num’s page from @assistant. * Removes the @page_num’s page from @assistant.
*
* Deprecated: 4.10: This widget will be removed in GTK 5
*/ */
void void
gtk_assistant_remove_page (GtkAssistant *assistant, 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 * Setting @page_func to %NULL will make the assistant to
* use the default forward function, which just goes to the * use the default forward function, which just goes to the
* next visible page. * next visible page.
*
* Deprecated: 4.10: This widget will be removed in GTK 5
*/ */
void void
gtk_assistant_set_forward_page_func (GtkAssistant *assistant, gtk_assistant_set_forward_page_func (GtkAssistant *assistant,
@ -1853,6 +1901,8 @@ add_to_action_area (GtkAssistant *assistant,
* @child: a `GtkWidget` * @child: a `GtkWidget`
* *
* Adds a widget to the action area of a `GtkAssistant`. * Adds a widget to the action area of a `GtkAssistant`.
*
* Deprecated: 4.10: This widget will be removed in GTK 5
*/ */
void void
gtk_assistant_add_action_widget (GtkAssistant *assistant, gtk_assistant_add_action_widget (GtkAssistant *assistant,
@ -1881,6 +1931,8 @@ gtk_assistant_add_action_widget (GtkAssistant *assistant,
* @child: a `GtkWidget` * @child: a `GtkWidget`
* *
* Removes a widget from the action area of a `GtkAssistant`. * Removes a widget from the action area of a `GtkAssistant`.
*
* Deprecated: 4.10: This widget will be removed in GTK 5
*/ */
void void
gtk_assistant_remove_action_widget (GtkAssistant *assistant, 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 * The title is displayed in the header area of the assistant
* when @page is the current page. * when @page is the current page.
*
* Deprecated: 4.10: This widget will be removed in GTK 5
*/ */
void void
gtk_assistant_set_page_title (GtkAssistant *assistant, gtk_assistant_set_page_title (GtkAssistant *assistant,
@ -1939,6 +1993,8 @@ gtk_assistant_set_page_title (GtkAssistant *assistant,
* Gets the title for @page. * Gets the title for @page.
* *
* Returns: the title for @page * Returns: the title for @page
*
* Deprecated: 4.10: This widget will be removed in GTK 5
*/ */
const char * const char *
gtk_assistant_get_page_title (GtkAssistant *assistant, gtk_assistant_get_page_title (GtkAssistant *assistant,
@ -1968,6 +2024,8 @@ gtk_assistant_get_page_title (GtkAssistant *assistant,
* Sets the page type for @page. * Sets the page type for @page.
* *
* The page type determines the page behavior in the @assistant. * The page type determines the page behavior in the @assistant.
*
* Deprecated: 4.10: This widget will be removed in GTK 5
*/ */
void void
gtk_assistant_set_page_type (GtkAssistant *assistant, gtk_assistant_set_page_type (GtkAssistant *assistant,
@ -1997,6 +2055,8 @@ gtk_assistant_set_page_type (GtkAssistant *assistant,
* Gets the page type of @page. * Gets the page type of @page.
* *
* Returns: the page type of @page * Returns: the page type of @page
*
* Deprecated: 4.10: This widget will be removed in GTK 5
*/ */
GtkAssistantPageType GtkAssistantPageType
gtk_assistant_get_page_type (GtkAssistant *assistant, 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 * This will make @assistant update the buttons state
* to be able to continue the task. * to be able to continue the task.
*
* Deprecated: 4.10: This widget will be removed in GTK 5
*/ */
void void
gtk_assistant_set_page_complete (GtkAssistant *assistant, gtk_assistant_set_page_complete (GtkAssistant *assistant,
@ -2056,6 +2118,8 @@ gtk_assistant_set_page_complete (GtkAssistant *assistant,
* Gets whether @page is complete. * Gets whether @page is complete.
* *
* Returns: %TRUE if @page is complete. * Returns: %TRUE if @page is complete.
*
* Deprecated: 4.10: This widget will be removed in GTK 5
*/ */
gboolean gboolean
gtk_assistant_get_page_complete (GtkAssistant *assistant, 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 * One situation where it can be necessary to call this
* function is when changing a value on the current page * function is when changing a value on the current page
* affects the future page flow of the assistant. * affects the future page flow of the assistant.
*
* Deprecated: 4.10: This widget will be removed in GTK 5
*/ */
void void
gtk_assistant_update_buttons_state (GtkAssistant *assistant) 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 * or undone. For example, showing a progress page to track
* a long-running, unreversible operation after the user has * a long-running, unreversible operation after the user has
* clicked apply on a confirmation page. * clicked apply on a confirmation page.
*
* Deprecated: 4.10: This widget will be removed in GTK 5
*/ */
void void
gtk_assistant_commit (GtkAssistant *assistant) gtk_assistant_commit (GtkAssistant *assistant)
@ -2189,6 +2257,8 @@ gtk_assistant_buildable_custom_finished (GtkBuildable *buildable,
* Returns the `GtkAssistantPage` object for @child. * Returns the `GtkAssistantPage` object for @child.
* *
* Returns: (transfer none): the `GtkAssistantPage` for @child * Returns: (transfer none): the `GtkAssistantPage` for @child
*
* Deprecated: 4.10: This widget will be removed in GTK 5
*/ */
GtkAssistantPage * GtkAssistantPage *
gtk_assistant_get_page (GtkAssistant *assistant, gtk_assistant_get_page (GtkAssistant *assistant,
@ -2205,6 +2275,8 @@ gtk_assistant_get_page (GtkAssistant *assistant,
* Returns the child to which @page belongs. * Returns the child to which @page belongs.
* *
* Returns: (transfer none): 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 * GtkWidget *
gtk_assistant_page_get_child (GtkAssistantPage *page) 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. * Gets a list model of the assistant pages.
* *
* Returns: (transfer full) (attributes element-type=GtkAssistantPage): A list model of the 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 * GListModel *
gtk_assistant_get_pages (GtkAssistant *assistant) 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` * 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 * row also be used for the same row when calling other `GtkCellArea` APIs
* such as gtk_cell_area_render() and gtk_cell_area_event(). * 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" #include "config.h"
@ -107,6 +109,8 @@ gtk_cell_area_context_class_init (GtkCellAreaContextClass *class)
* GtkCellAreaContext:area: * GtkCellAreaContext:area:
* *
* The `GtkCellArea` this context was created by * 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, g_object_class_install_property (object_class,
PROP_CELL_AREA, PROP_CELL_AREA,
@ -120,6 +124,8 @@ gtk_cell_area_context_class_init (GtkCellAreaContextClass *class)
* The minimum width for the `GtkCellArea` in this context * The minimum width for the `GtkCellArea` in this context
* for all `GtkTreeModel` rows that this context was requested * for all `GtkTreeModel` rows that this context was requested
* for using gtk_cell_area_get_preferred_width(). * 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, g_object_class_install_property (object_class,
PROP_MIN_WIDTH, PROP_MIN_WIDTH,
@ -133,6 +139,8 @@ gtk_cell_area_context_class_init (GtkCellAreaContextClass *class)
* The natural width for the `GtkCellArea` in this context * The natural width for the `GtkCellArea` in this context
* for all `GtkTreeModel` rows that this context was requested * for all `GtkTreeModel` rows that this context was requested
* for using gtk_cell_area_get_preferred_width(). * 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, g_object_class_install_property (object_class,
PROP_NAT_WIDTH, PROP_NAT_WIDTH,
@ -146,6 +154,8 @@ gtk_cell_area_context_class_init (GtkCellAreaContextClass *class)
* The minimum height for the `GtkCellArea` in this context * The minimum height for the `GtkCellArea` in this context
* for all `GtkTreeModel` rows that this context was requested * for all `GtkTreeModel` rows that this context was requested
* for using gtk_cell_area_get_preferred_height(). * 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, g_object_class_install_property (object_class,
PROP_MIN_HEIGHT, PROP_MIN_HEIGHT,
@ -159,6 +169,8 @@ gtk_cell_area_context_class_init (GtkCellAreaContextClass *class)
* The natural height for the `GtkCellArea` in this context * The natural height for the `GtkCellArea` in this context
* for all `GtkTreeModel` rows that this context was requested * for all `GtkTreeModel` rows that this context was requested
* for using gtk_cell_area_get_preferred_height(). * 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, g_object_class_install_property (object_class,
PROP_NAT_HEIGHT, 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. * 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 * GtkCellArea *
gtk_cell_area_context_get_area (GtkCellAreaContext *context) 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 * of all the displayed row heights using
* gtk_cell_area_get_preferred_height_for_width(). * gtk_cell_area_get_preferred_height_for_width().
* *
* Deprecated: 4.10 * Deprecated: 4.10: This object will be removed in GTK 5
*/ */
void void
gtk_cell_area_context_reset (GtkCellAreaContext *context) 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 * rows. This is generally the case for `GtkTreeView` when
* `GtkTreeView:fixed-height-mode` is enabled. * `GtkTreeView:fixed-height-mode` is enabled.
* *
* Deprecated: 4.10 * Deprecated: 4.10: This object will be removed in GTK 5
*/ */
void void
gtk_cell_area_context_allocate (GtkCellAreaContext *context, 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 * After gtk_cell_area_context_reset() is called and/or before ever
* requesting the size of a `GtkCellArea`, the returned values are 0. * 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 void
gtk_cell_area_context_get_preferred_width (GtkCellAreaContext *context, 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 * After gtk_cell_area_context_reset() is called and/or before ever
* requesting the size of a `GtkCellArea`, the returned values are 0. * 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 void
gtk_cell_area_context_get_preferred_height (GtkCellAreaContext *context, 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 * After gtk_cell_area_context_reset() is called and/or before ever
* requesting the size of a `GtkCellArea`, the returned values are -1. * 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 void
gtk_cell_area_context_get_preferred_height_for_width (GtkCellAreaContext *context, 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 * After gtk_cell_area_context_reset() is called and/or before ever
* requesting the size of a `GtkCellArea`, the returned values are -1. * 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 void
gtk_cell_area_context_get_preferred_width_for_height (GtkCellAreaContext *context, 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(), * context was recently reset with gtk_cell_area_context_reset(),
* the returned value will be -1. * the returned value will be -1.
* *
* Deprecated: 4.10 * Deprecated: 4.10: This object will be removed in GTK 5
*/ */
void void
gtk_cell_area_context_get_allocation (GtkCellAreaContext *context, 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 * progressively push the requested width over a series of
* gtk_cell_area_get_preferred_width() requests. * gtk_cell_area_get_preferred_width() requests.
* *
* Deprecated: 4.10 * Deprecated: 4.10: This object will be removed in GTK 5
*/ */
void void
gtk_cell_area_context_push_preferred_width (GtkCellAreaContext *context, 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 * progressively push the requested height over a series of
* gtk_cell_area_get_preferred_height() requests. * gtk_cell_area_get_preferred_height() requests.
* *
* Deprecated: 4.10 * Deprecated: 4.10: This object will be removed in GTK 5
*/ */
void void
gtk_cell_area_context_push_preferred_height (GtkCellAreaContext *context, 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-lock],
* [property@Gtk.LockButton:tooltip-unlock] and * [property@Gtk.LockButton:tooltip-unlock] and
* [property@Gtk.LockButton:tooltip-not-authorized] properties. * [property@Gtk.LockButton:tooltip-not-authorized] properties.
*
* Deprecated: 4.10: This widget will be removed in GTK 5
*/ */
struct _GtkLockButton 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) * 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. * 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_object_class_install_property (gobject_class, PROP_PERMISSION,
g_param_spec_object ("permission", NULL, NULL, g_param_spec_object ("permission", NULL, NULL,
@ -282,6 +286,8 @@ gtk_lock_button_class_init (GtkLockButtonClass *klass)
* GtkLockButton:text-lock: * GtkLockButton:text-lock:
* *
* The text to display when prompting the user to 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_object_class_install_property (gobject_class, PROP_TEXT_LOCK,
g_param_spec_string ("text-lock", NULL, NULL, g_param_spec_string ("text-lock", NULL, NULL,
@ -294,6 +300,8 @@ gtk_lock_button_class_init (GtkLockButtonClass *klass)
* GtkLockButton:text-unlock: * GtkLockButton:text-unlock:
* *
* The text to display when prompting the user to 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_object_class_install_property (gobject_class, PROP_TEXT_UNLOCK,
g_param_spec_string ("text-unlock", NULL, NULL, g_param_spec_string ("text-unlock", NULL, NULL,
@ -306,6 +314,8 @@ gtk_lock_button_class_init (GtkLockButtonClass *klass)
* GtkLockButton:tooltip-lock: * GtkLockButton:tooltip-lock:
* *
* The tooltip to display when prompting the user to 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_object_class_install_property (gobject_class, PROP_TOOLTIP_LOCK,
g_param_spec_string ("tooltip-lock", NULL, NULL, g_param_spec_string ("tooltip-lock", NULL, NULL,
@ -318,6 +328,8 @@ gtk_lock_button_class_init (GtkLockButtonClass *klass)
* GtkLockButton:tooltip-unlock: * GtkLockButton:tooltip-unlock:
* *
* The tooltip to display when prompting the user to 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_object_class_install_property (gobject_class, PROP_TOOLTIP_UNLOCK,
g_param_spec_string ("tooltip-unlock", NULL, NULL, g_param_spec_string ("tooltip-unlock", NULL, NULL,
@ -330,6 +342,8 @@ gtk_lock_button_class_init (GtkLockButtonClass *klass)
* GtkLockButton:tooltip-not-authorized: * GtkLockButton:tooltip-not-authorized:
* *
* The tooltip to display when the user cannot obtain authorization. * 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_object_class_install_property (gobject_class, PROP_TOOLTIP_NOT_AUTHORIZED,
g_param_spec_string ("tooltip-not-authorized", NULL, NULL, 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. * Creates a new lock button which reflects the @permission.
* *
* Returns: a new `GtkLockButton` * Returns: a new `GtkLockButton`
*
* Deprecated: 4.10: This widget will be removed in GTK 5
*/ */
GtkWidget * GtkWidget *
gtk_lock_button_new (GPermission *permission) gtk_lock_button_new (GPermission *permission)
@ -527,6 +543,8 @@ gtk_lock_button_new (GPermission *permission)
* Obtains the `GPermission` object that controls @button. * Obtains the `GPermission` object that controls @button.
* *
* Returns: (transfer none) (nullable): the `GPermission` of @button * Returns: (transfer none) (nullable): the `GPermission` of @button
*
* Deprecated: 4.10: This widget will be removed in GTK 5
*/ */
GPermission * GPermission *
gtk_lock_button_get_permission (GtkLockButton *button) gtk_lock_button_get_permission (GtkLockButton *button)
@ -542,6 +560,8 @@ gtk_lock_button_get_permission (GtkLockButton *button)
* @permission: (nullable): a `GPermission` object * @permission: (nullable): a `GPermission` object
* *
* Sets the `GPermission` object that controls @button. * Sets the `GPermission` object that controls @button.
*
* Deprecated: 4.10: This widget will be removed in GTK 5
*/ */
void void
gtk_lock_button_set_permission (GtkLockButton *button, 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 * ## CSS node
* *
* `GtkStatusbar` has a single CSS node with name `statusbar`. * `GtkStatusbar` has a single CSS node with name `statusbar`.
*
* Deprecated: 4.10: This widget will be removed in GTK 5
*/ */
typedef struct _GtkStatusbarMsg GtkStatusbarMsg; typedef struct _GtkStatusbarMsg GtkStatusbarMsg;
@ -167,6 +169,8 @@ gtk_statusbar_class_init (GtkStatusbarClass *class)
* @text: the message that was pushed * @text: the message that was pushed
* *
* Emitted whenever a new message gets pushed onto a statusbar's stack. * 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] = statusbar_signals[SIGNAL_TEXT_PUSHED] =
g_signal_new (I_("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 * @text: the message that was just popped
* *
* Emitted whenever a new message is popped off a statusbar's stack. * 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] = statusbar_signals[SIGNAL_TEXT_POPPED] =
g_signal_new (I_("text-popped"), g_signal_new (I_("text-popped"),
@ -225,6 +231,8 @@ gtk_statusbar_init (GtkStatusbar *statusbar)
* Creates a new `GtkStatusbar` ready for messages. * Creates a new `GtkStatusbar` ready for messages.
* *
* Returns: the new `GtkStatusbar` * Returns: the new `GtkStatusbar`
*
* Deprecated: 4.10: This widget will be removed in GTK 5
*/ */
GtkWidget* GtkWidget*
gtk_statusbar_new (void) gtk_statusbar_new (void)
@ -257,6 +265,8 @@ gtk_statusbar_update (GtkStatusbar *statusbar,
* Note that the description is not shown in the UI. * Note that the description is not shown in the UI.
* *
* Returns: an integer id * Returns: an integer id
*
* Deprecated: 4.10: This widget will be removed in GTK 5
*/ */
guint guint
gtk_statusbar_get_context_id (GtkStatusbar *statusbar, 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 * Returns: a message id that can be used with
* [method@Gtk.Statusbar.remove]. * [method@Gtk.Statusbar.remove].
*
* Deprecated: 4.10: This widget will be removed in GTK 5
*/ */
guint guint
gtk_statusbar_push (GtkStatusbar *statusbar, gtk_statusbar_push (GtkStatusbar *statusbar,
@ -351,6 +363,8 @@ gtk_statusbar_push (GtkStatusbar *statusbar,
* Note that this may not change the displayed message, * Note that this may not change the displayed message,
* if the message at the top of the stack has a different * if the message at the top of the stack has a different
* context id. * context id.
*
* Deprecated: 4.10: This widget will be removed in GTK 5
*/ */
void void
gtk_statusbar_pop (GtkStatusbar *statusbar, 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. * Forces the removal of a message from a statusbar’s stack.
* The exact @context_id and @message_id must be specified. * The exact @context_id and @message_id must be specified.
*
* Deprecated: 4.10: This widget will be removed in GTK 5
*/ */
void void
gtk_statusbar_remove (GtkStatusbar *statusbar, gtk_statusbar_remove (GtkStatusbar *statusbar,
@ -443,6 +459,8 @@ gtk_statusbar_remove (GtkStatusbar *statusbar,
* *
* Forces the removal of all messages from a statusbar's * Forces the removal of all messages from a statusbar's
* stack with the exact @context_id. * stack with the exact @context_id.
*
* Deprecated: 4.10: This widget will be removed in GTK 5
*/ */
void void
gtk_statusbar_remove_all (GtkStatusbar *statusbar, gtk_statusbar_remove_all (GtkStatusbar *statusbar,
@ -499,6 +517,8 @@ gtk_statusbar_remove_all (GtkStatusbar *statusbar,
* Retrieves the contents of the label in `GtkStatusbar`. * Retrieves the contents of the label in `GtkStatusbar`.
* *
* Returns: (transfer none): the contents of the statusbar * Returns: (transfer none): the contents of the statusbar
*
* Deprecated: 4.10: This widget will be removed in GTK 5
*/ */
const char * const char *
gtk_statusbar_get_message (GtkStatusbar *statusbar) gtk_statusbar_get_message (GtkStatusbar *statusbar)

6
gtk/deprecated/gtkvolumebutton.c
View File

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