A [GtkAllocation-struct|GtkAllocation-struct] of a widget represents region which has been allocated to the widget by its parent. It is a subregion of its parents allocation. See [GtkWidget’s geometry management section][geometry-management] for more information.
A function used by gtk_assistant_set_forward_page_func() to know which is the next page given a current one. It’s called both for computing the next page when the user presses the “forward” button and for handling the behavior of the “last” button.
This is the signature of a function used to connect signals. It is used by the gtk_builder_connect_signals() and gtk_builder_connect_signals_full() methods. It is mainly intended for interpreted language bindings, but could be useful where the programmer wants more control over the signal connection process. Note that this function can only be called once, subsequent calls will do nothing.
This kind of functions provide Pango markup with detail information for the specified day. Examples for such details are holidays or appointments. The function returns NULL when no information is available.
The type of the callback functions used for e.g. iterating over the children of a container, see gtk_container_foreach().
The type of the callback functions used for iterating over the cell renderers and their allocated areas inside a GtkCellArea, see gtk_cell_area_foreach_alloc().
The type of the callback functions used for iterating over the cell renderers of a GtkCellArea, see gtk_cell_area_foreach().
A function which should set the value of cell_layout’s cell renderer(s) as appropriate.
A function that will be called when the contents of the clipboard are changed or cleared. Once this has called, the user_data_or_owner argument will not be used again.
A function that will be called to provide the contents of the selection. If multiple types of data were advertised, the requested type can be determined from the info parameter or by checking the target field of selection_data. If the data could successfully be converted into then it should be stored into the selection_data object by calling gtk_selection_data_set() (or related functions such as gtk_selection_data_set_text()). If no data is set, the requestor will be informed that the attempt to get the data failed.
A function to be called when the results of gtk_clipboard_request_image() are received, or when the request fails.
A function to be called when the results of gtk_clipboard_request_contents() are received, or when the request fails.
A function to be called when the results of gtk_clipboard_request_rich_text() are received, or when the request fails.
A function to be called when the results of gtk_clipboard_request_targets() are received, or when the request fails.
A function to be called when the results of gtk_clipboard_request_text() are received, or when the request fails.
A function to be called when the results of gtk_clipboard_request_uris() are received, or when the request fails.
A function which decides whether the row indicated by iter matches a given key, and should be displayed as a possible completion for key. Note that key is normalized and case-folded (see g_utf8_normalize() and g_utf8_casefold()). If this is not appropriate, match functions have access to the unmodified key via gtk_entry_get_text (GTK_ENTRY (gtk_entry_completion_get_entry ())).
The type of function that is used with custom filters, see gtk_file_filter_add_custom().
Called for flow boxes that are bound to a GListModel with gtk_flow_box_bind_model() for each item that gets added to the model.
A function that will be called whenrever a child changes or is added. It lets you control if the child should be visible or not.
A function used by gtk_flow_box_selected_foreach(). It will be called on every selected child of the box.
A function to compare two children to determine which should come first.
The type of function that is used for deciding what fonts get shown in a GtkFontChooser See gtk_font_chooser_set_filter_func().
A function used by gtk_icon_view_selected_foreach() to map all selected rows. It will be called on every selected row in the view.
Key snooper functions are called before normal event delivery. They can be used to implement custom key event handling.
Called for list boxes that are bound to a GListModel with gtk_list_box_bind_model() for each item that gets added to the model.
Will be called whenever the row changes or is added and lets you control if the row should be visible or not.
A function used by gtk_list_box_selected_foreach(). It will be called on every selected child of the box.
Compare two rows to determine which should be first.
Whenever row changes or which row is before row changes this is called, which lets you update the header on row. You may remove or set a new one via gtk_list_box_row_set_header() or just change the state of the current header widget.
A user function supplied when calling gtk_menu_attach_to_widget() which will be called when the menu is later detached from the widget.
A user function supplied when calling gtk_menu_popup() which controls the positioning of the menu when it is displayed. The function sets the x and y parameters to the coordinates where the menu is to be drawn. To make the menu appear on a different monitor than the mouse pointer, gtk_menu_set_monitor() must be called.
A multihead-aware GTK+ module may have a gtk_module_display_init() function with this prototype. GTK+ calls this function for each opened display.
Each GTK+ module must have a function gtk_module_init() with this prototype. This function is called after loading the module.
The type of function that is passed to gtk_print_run_page_setup_dialog_async().
The type of function that is used with custom filters, see gtk_recent_filter_add_custom().
A function that is called to deserialize rich text that has been serialized with gtk_text_buffer_serialize(), and insert it at iter.
A function that is called to serialize the content of a text buffer. It must return the serialized form of the content.
Callback type for adding a function to update animations. See gtk_widget_add_tick_callback().
A function to set the properties of a cell instead of just using the straight mapping between the cell and the model. This is useful for customizing the cell renderer. For example, a function might get an integer from the tree_model, and render it to the “text” attribute of “cell” by converting it to its written equivalent. This is set by calling gtk_tree_view_column_set_cell_data_func()
A GtkTreeIterCompareFunc should return a negative integer, zero, or a positive integer if a sorts before b, a sorts with b, or a sorts after b respectively. If two iters compare as equal, their order in the sorted model is undefined. In order to ensure that the GtkTreeSortable behaves as expected, the GtkTreeIterCompareFunc must define a partial order on the model, i.e. it must be reflexive, antisymmetric and transitive.
A function which calculates display values from raw values in the model. It must fill value with the display value for the column column in the row indicated by iter.
A function which decides whether the row indicated by iter is visible.
Type of the callback passed to gtk_tree_model_foreach() to iterate over the rows in a tree model.
A function used by gtk_tree_selection_selected_foreach() to map all selected rows. It will be called on every selected row in the view.
A function used by gtk_tree_selection_set_select_function() to filter whether or not a row may be selected. It is called whenever a row's state might change. A return value of TRUE indicates to selection that it is okay to change the selection.
Function type for determining whether column can be dropped in a particular spot (as determined by prev_column and next_column). In left to right locales, prev_column is on the left of the potential drop spot, and next_column is on the right. In right to left mode, this is reversed. This function should return TRUE if the spot is a valid drop spot. Please note that returning TRUE does not actually indicate that the column drop was made, but is meant only to indicate a possible drop spot to the user.
Function used for gtk_tree_view_map_expanded_rows().
Function type for determining whether the row pointed to by iter should be rendered as a separator. A common way to implement this is to have a boolean column in the model, whose values the GtkTreeViewRowSeparatorFunc returns.
A function used for checking whether a row in model matches a search key string entered by the user. Note the return value is reversed from what you would normally expect, though it has some similarity to strcmp() returning 0 for equal strings.
Accelerator flags used with gtk_accel_group_connect().
Controls how a widget deals with extra space in a single (x or y) dimension.
Types of user actions that may be blocked by gtk_application_inhibit().
Used to specify the placement of scroll arrows in scrolling menus.
Used to indicate the direction in which an arrow should point.
An enum for determining the page role inside the GtkAssistant It's used to handle buttons sensitivity and visibility.
Denotes the expansion properties that a widget will have when it (or its parent) is resized.
Whenever a container has some form of natural row it may align children in that row along a common typographical baseline. If the amount of verical space in the row is taller than the total requested height of the baseline-aligned children then it can use a GtkBaselinePosition to select where to put the baseline inside the extra availible space.
Describes how the border of a UI element should be rendered.
Error codes that identify various errors that can occur while using GtkBuilder
Used to dictate the style that a GtkButtonBox uses to layout the buttons it contains.
The role specifies the desired appearance of a GtkModelButton
Prebuilt sets of buttons for the dialog. If none of these choices are appropriate, simply use GTK_BUTTONS_NONE then call gtk_dialog_add_buttons().
These options can be used to influence the display and behaviour of a GtkCalendar
Determines if the edited accelerators are GTK+ accelerators. If they are, consumed modifiers are suppressed, only accelerators accepted by GTK+ are allowed, and the accelerators are rendered in the same way as they are in menus.
Identifies how the user can interact with a particular cell.
Tells how a cell is to be rendered.
Specifies which corner a child widget should be placed in when packed into a GtkScrolledWindow This is effectively the opposite of where the scroll bars are placed.
Error codes for GTK_CSS_PROVIDER_ERROR.
The different types of sections indicate parts of a CSS document as parsed by GTK’s CSS parser. They are oriented towards the CSS Grammar, but may contain extensions.
See also: delete-from-cursor.
The GtkDestDefaults enumeration specifies the various types of action that will be taken on behalf of the user for a drag destination site.
Flags used to influence dialog construction.
Focus movement types.
Gives an indication why a drag operation failed. The value can by obtained by connecting to the drag-failed signal.
Specifies the side of the entry at which an icon is placed.
Describes the behavior of a GtkEventControllerScroll
Used to specify the style of the expanders drawn by a GtkTreeView
Describes whether a GtkFileChooser is being used to open existing files or to save to a possibly new file.
These identify the various errors that can occur while calling GtkFileChooser functions.
These flags indicate what parts of a GtkFileFilterInfo struct are filled or need to be filled.
This enumeration specifies the granularity of font selection that is desired in a font chooser.
Style for input method preedit. See also gtk-im-preedit-style
Style for input method status. See also gtk-im-status-style
Used to specify options for gtk_icon_theme_lookup_icon()
Built-in stock icon sizes.
Error codes for GtkIconTheme operations.
An enum for determining where a dropped item goes.
Describes the image data representation used by a GtkImage If you want to get the image from the widget, you can only get the currently-stored representation. e.g. if the gtk_image_get_storage_type() returns GTK_IMAGE_PIXBUF, then you can call gtk_image_get_pixbuf() but not gtk_image_get_stock(). For empty images, you can request any storage type (call any of the "get" functions), but they will all return NULL values.
Describes hints that might be taken into account by input methods or applications. Note that input methods may already tailor their behaviour according to the GtkInputPurpose of the entry.
Describes primary purpose of the input widget. This information is useful for on-screen keyboards and similar input methods to decide which keys should be presented to the user.
Describes how a rendered element connects to adjacent elements.
Describes how GtkLevelBar contents should be rendered. Note that this enumeration could be extended with additional modes in the future.
The type of license for an application.
An enumeration representing directional movements within a menu.
The type of message being displayed in the dialog.
Used to determine the layout of pages on a sheet when printing multiple pages per sheet.
Determines how widgets should be packed inside menubars and menuitems contained in menubars.
The type of a pad action.
See also gtk_print_settings_set_orientation().
See also gtk_print_job_set_page_set().
Describes the panning direction of a GtkGesturePan
Priorities for path lookups. See also gtk_binding_set_add_path().
Widget path types. See also gtk_binding_set_add_path().
These flags serve two purposes. First, the application can call gtk_places_sidebar_set_open_flags() using these flags as a bitmask. This tells the sidebar that the application is able to open folders selected from the sidebar in various ways, for example, in new tabs or in new windows in addition to the normal mode.
Determines how the size should be computed to achieve the one of the visibility mode for the scrollbars.
Describes constraints to positioning of popovers. More values may be added to this enumeration in the future.
See also gtk_print_settings_set_duplex().
Error codes that identify various errors that can occur while using the GTK+ printing support.
The action parameter to gtk_print_operation_run() determines what action the print operation should perform.
A value of this type is returned by gtk_print_operation_run().
See also gtk_print_job_set_pages()
See also gtk_print_settings_set_quality().
The status gives a rough indication of the completion of a running print operation.
Describes the stage at which events are fed into a GtkEventController
The GtkRcTokenType enumeration represents the tokens in the RC file. It is exposed so that theme engines can reuse these tokens when parsing the theme-engine specific portions of a RC file.
These identify the various errors that can occur while calling GtkRecentChooser functions.
These flags indicate what parts of a GtkRecentFilterInfo struct are filled or need to be filled.
Error codes for GtkRecentManager operations
Used to specify the sorting method to be applyed to the recently used resource list.
Describes a region within a widget.
Indicated the relief to be drawn around a GtkButton
Predefined values for use as response ids in gtk_dialog_add_button(). All predefined values are negative; GTK+ leaves values of 0 or greater for application-defined response ids.
These enumeration values describe the possible transitions when the child of a GtkRevealer widget is shown or hidden.
Defines the policy to be used in a scrollable widget when updating the scrolled window adjustments in a given orientation.
Used to control what selections users are allowed to make.
Determines how GTK+ handles the sensitivity of stepper arrows at the end of range widgets.
Used to change the appearance of an outline typically provided by a GtkFrame
GtkShortcutType specifies the kind of shortcut that is being described. More values may be added to this enumeration over time.
The mode of the size group determines the directions in which the size group affects the requested sizes of its component widgets.
Specifies a preference for height-for-width or width-for-height geometry management.
Determines the direction of a sort.
The spin button update policy determines whether the spin button displays values even if they are outside the bounds of its adjustment. See gtk_spin_button_set_update_policy().
The values of the GtkSpinType enumeration are used to specify the change to make in gtk_spin_button_spin().
These enumeration values describe the possible transitions between pages in a GtkStack widget.
Describes a widget state. Widget states are used to match the widget against CSS pseudo-classes. Note that GTK extends the regular CSS classes and sometimes uses different names.
Flags that modify the behavior of gtk_style_context_to_string(). New values may be added to this enumeration.
These values are used as “info” for the targets contained in the lists returned by gtk_text_buffer_get_copy_target_list() and gtk_text_buffer_get_paste_target_list().
Reading directions for text.
Granularity types that extend the text selection. Use the extend-selection signal to customize the selection.
Flags affecting how a search is done.
Used to reference the layers of GtkTextView for the purpose of customized drawing with the ::draw_layer vfunc.
Used to reference the parts of GtkTextView
Flags used to specify the supported drag targets.
Whether spacers are vertical lines or just blank.
Used to customize the appearance of a GtkToolbar Note that setting the toolbar style overrides the user’s preferences for the default toolbar style. Note that if the button has only a label set and GTK_TOOLBAR_ICONS is used, the label will be visible, and vice versa.
These flags indicate various properties of a GtkTreeModel
The sizing method the column uses to determine its width. Please note that GTK_TREE_VIEW_COLUMN_AUTOSIZE are inefficient for large views, and can make columns appear choppy.
An enum for determining where a dropped row goes.
Used to indicate which grid lines to draw in a tree view.
These enumeration values are used by gtk_ui_manager_add_ui() to determine what UI element to create.
See also gtk_print_settings_set_paper_width().
Kinds of widget-specific help. Used by the ::show-help signal.
Window placement can be influenced using this enumeration. Note that using GTK_WIN_POS_CENTER_ALWAYS is almost always a bad idea. It won’t necessarily work well with all window managers or on all windowing systems.
A GtkWindow can be one of these types. Most things you’d consider a “window” should have type GTK_WINDOW_TOPLEVEL; windows with this type are managed by the window manager and have a frame by default (call gtk_window_set_decorated() to toggle the frame). Windows with type GTK_WINDOW_POPUP are ignored by the window manager; window manager keybindings won’t work on them, the window manager won’t decorate the window with a frame, many GTK+ features that rely on the window manager will not work (e.g. resize grips and maximization/minimization). GTK_WINDOW_POPUP is used to implement widgets such as GtkMenu or tooltips that you normally don’t think of as windows per se. Nearly all windows should be GTK_WINDOW_TOPLEVEL In particular, do not use GTK_WINDOW_POPUP just to turn off the window borders; use gtk_window_set_decorated() for that.
Describes a type of line wrapping.
Like gtk_get_binary_age(), but from the headers used at application compile time, rather than from the library linked against at application run time.
Constant to return from a signal handler for the input signal in case of conversion failure.
Like gtk_get_interface_age(), but from the headers used at application compile time, rather than from the library linked against at application run time.
The name used for the stock full offset included by GtkLevelBar
The name used for the stock high offset included by GtkLevelBar
The name used for the stock low offset included by GtkLevelBar
Like gtk_get_major_version(), but from the headers used at application compile time, rather than from the library linked against at application run time.
The maximum length of sequences in compose tables.
Like gtk_get_micro_version(), but from the headers used at application compile time, rather than from the library linked against at application run time.
Like gtk_get_minor_version(), but from the headers used at application compile time, rather than from the library linked against at application run time.
Name for the A3 paper size.
Name for the A4 paper size.
Name for the A5 paper size.
Name for the B5 paper size.
Name for the Executive paper size.
Name for the Legal paper size.
Name for the Letter paper size.
The key used by the “Print to file” printer to store the file name of the output without the path to the directory and the file extension.
The key used by the “Print to file” printer to store the directory to which the output should be written.
The key used by the “Print to file” printer to store the format of the output. The supported values are “PS” and “PDF”.
The key used by the “Print to file” printer to store the URI to which the output should be written. GTK+ itself supports only “file://” URIs.
Use this priority for functionality related to size allocation.
A CSS class to match an accelerator.
A CSS class used when rendering an arrow element.
A CSS class to match the window background.
A CSS class to indicate an area at the bottom of a widget.
A CSS class to match buttons.
A CSS class to match calendars.
A CSS class to match content rendered in cell views.
A CSS class to match check boxes.
A CSS class to match combobox entries.
A CSS class to match context menus.
A CSS class that gets added to windows which have client-side decorations.
A CSS class used when rendering a drag handle for text selection.
A CSS class to match the default widget.
A CSS class used when an action (usually a button) is one that is expected to remove or destroy something visible to the user.
A CSS class to match dimmed labels.
A CSS class for a drag-and-drop indicator.
A CSS class defining a dock area.
A CSS class to match text entries.
A CSS class for an area displaying an error message, such as those in infobars.
A CSS class defining an expander, such as those in treeviews.
A CSS class that is added when widgets that usually have a frame or border (like buttons or entries) should appear without it.
A CSS class defining a frame delimiting content, such as GtkFrame or the scrolled window frame around the scrollable area.
A CSS class defining a resize grip.
A CSS class to match a header element.
A CSS class defining a highlighted area, such as headings in assistants and calendars.
A CSS class for horizontally layered widgets.
A CSS class defining an image, such as the icon in an entry.
A CSS class for an area displaying an informational message, such as those in infobars.
A CSS class to match inline toolbars.
A CSS class used when rendering a drag handle for the insertion cursor position.
A CSS class to match labels.
A CSS class to indicate an area at the left of a widget.
A CSS class used when rendering a level indicator, such as a battery charge level, or a password strength.
A CSS class to match a linked area, such as a box containing buttons belonging to the same control.
A CSS class to match lists.
A CSS class to match list rows.
A CSS class defining marks in a widget, such as in scales.
A CSS class to match menus.
A CSS class to menubars.
A CSS class to match menu items.
A CSS class that is added to message dialogs.
A CSS class that is added to text view that should use a monospace font.
A CSS class used when an element needs the user attention, for instance a button in a stack switcher corresponding to a hidden page that changed state.
A CSS class defining a notebook.
A CSS class used when rendering an OSD (On Screen Display) element, on top of another container.
A CSS class that is added on the visual hints that happen when scrolling is attempted past the limits of a scrollable area.
A CSS class for a pane separator, such as those in GtkPaned
A CSS class that is added to areas that should look like paper.
A CSS class that matches popovers.
A CSS class that is added to the toplevel windows used for menus.
A CSS class to match primary toolbars.
A CSS class to use when rendering activity as a progressbar.
A CSS class to use when rendering a pulse in an indeterminate progress bar.
A CSS class for an area displaying a question to the user, such as those in infobars.
A CSS class to match radio buttons.
A CSS class to match a raised control, such as a raised button on a toolbar.
A CSS class used to indicate a read-only state.
A CSS class to indicate an area at the right of a widget.
A CSS class to match the rubberband selection rectangle.
A CSS class to match scale widgets.
A CSS class to match scrollbars.
A CSS class to match the junction area between an horizontal and vertical scrollbar, when they’re both shown.
A CSS class for a separator.
A CSS class defining a sidebar, such as the left side in a file chooser.
A CSS class to match sliders.
A CSS class defining an spinbutton.
A CSS class to use when rendering activity as a “spinner”.
A CSS class to match statusbars.
A CSS class used for the subtitle label in a titlebar in a toplevel window.
A CSS class used when an action (usually a button) is the primary suggested action in a specific context.
A CSS class used for the title label in a titlebar in a toplevel window.
A CSS class used when rendering a titlebar in a toplevel window.
A CSS class to match toolbars.
A CSS class to match tooltip windows.
A CSS class to indicate an area at the top of a widget.
A CSS class for touch selection popups on entries and text views.
A CSS class to match troughs, as in scrollbars and progressbars.
A CSS class that is added on the visual hints that happen where content is 'scrolled off' and can be made visible by scrolling.
A CSS class for vertically layered widgets.
A CSS class defining a view, such as iconviews or treeviews.
A CSS class for an area displaying a warning message, such as those in infobars.
A CSS class to indicate that a UI element should be 'wide'. Used by GtkPaned
A property holding the background color of rendered elements as a GdkRGBA
A property holding the element’s background as a cairo_pattern_t
A property holding the element’s border color as a GdkRGBA
A property holding the rendered element’s border radius in pixels as a gint
A property holding the element’s border style as a GtkBorderStyle
A property holding the rendered element’s border width in pixels as a GtkBorder The border is the intermediary spacing property of the padding/border/margin series.
A property holding the foreground color of rendered elements as a GdkRGBA
A property holding the font properties used when rendering text as a PangoFontDescription
A property holding the rendered element’s padding as a GtkBorder The padding is defined as the spacing between the inner part of the element border and its child. It’s the innermost spacing property of the padding/border/margin series.
A priority that can be used when adding a GtkStyleProvider for application-specific style information.
The priority used for default style information that is used in the absence of themes.
The priority used for style information provided via GtkSettings
The priority used for style information provided by themes.
The priority used for the style information from XDG_CONFIG_HOME/gtk-3.0/gtk.css.
A widget region name to define a treeview column.
A widget region name to define a treeview column header.
A widget region name to define a treeview row.
A widget region name to define a notebook tab.
The priority at which the text view validates onscreen lines in an idle job in the background.
The GTK_TREE_SORTABLE_DEFAULT_SORT_COLUMN_ID can be used to make a GtkTreeSortable use the default sort function.
The GTK_TREE_SORTABLE_DEFAULT_SORT_COLUMN_ID can be used to make a GtkTreeSortable use no sorting.
GtkActionEntry structs are used with gtk_action_group_add_actions() to construct actions.
The interface vtable for GtkActionable
> This method can be called with a NULL action at times.
Each key binding element of a binding sets binding list is represented by a GtkBindingEntry.
A GtkBindingSignal stores the necessary information to activate a widget in response to a key press via a signal emission.
Class structure for GtkEntry All virtual functions have a default implementation. Derived classes may set the virtual function pointers for the signal handlers to NULL, but must keep get_text_area_size and get_frame_size non-NULL; either use the default implementation, or provide a custom one.
A [GtkFileFilterInfo-struct|GtkFileFilterInfo-struct] is used to pass information about the tested file to gtk_file_filter_filter().
The GtkGLAreaClass structure contains only private data.
Bookkeeping information about a loadable input method.
The GtkLinkButtonClass contains only private data.
Struct defining a pad action entry.
See also gtk_print_settings_set_page_ranges().
GtkRadioActionEntry structs are used with gtk_action_group_add_radio_actions() to construct groups of radio actions.
Meta-data to be passed to gtk_recent_manager_add_full() when registering a recently used resource.
A GtkRecentFilterInfo struct is used to pass information about the tested file to gtk_recent_filter_filter().
GtkRecentManagerClass contains only private data.
Represents a request of a screen object in a given orientation. These are primarily used in container implementations when allocating a natural size for children calling. See gtk_distribute_natural_allocation().
Base class for theming engines.
GtkToggleActionEntry structs are used with gtk_action_group_add_toggle_actions() to construct toggle actions.
Virtual function table for the GtkToolShell interface.