The GtkAboutDialog offers a simple way to display information abouta program like its logo, name, copyright, website and license. It isalso possible to give credits to the authors, documenters, translatorsand artists who have worked on the program. An about dialog is typicallyopened when the user selects theAbout option from theHelp menu.All parts of the dialog are optional.

AGtkAccelGroup represents a group of keyboard accelerators,typically attached to a toplevelGtkWindow (withgtk_window_add_accel_group()). Usually you won’t need to create aGtkAccelGroup directly; instead, when usingGtkUIManager,GTK+automatically sets up the accelerators for your menus in the uimanager’sGtkAccelGroup.

TheGtkAccelLabel widget is a subclass ofGtkLabel that also displays anaccelerator key on the right of the label text, e.g. “Ctrl+S”.It is commonly used in menus to show the keyboard short-cuts for commands.

Accelerator maps are used to define runtime configurable accelerators.Functions for manipulating them are are usually used by higher levelconvenience mechanisms likeGtkUIManager and are thus considered“low-level”. You’ll want to use them if you’re manually creating menus thatshould have user-configurable accelerators.

TheGtkAccessible class is the base class for accessibleimplementations forGtkWidget subclasses. It is a thinwrapper aroundAtkObject, which adds facilities for associatinga widget with its accessible object.

InGTK+ 3.10, GtkAction has been deprecated. UseGActioninstead, and associate actions withGtkActionable widgets. UseGMenuModel for creating menus with gtk_menu_new_from_model().

GtkActionBar is designed to present contextual actions. It isexpected to be displayed below the content and expand horizontallyto fill the area.

Actions are organised into groups. An action group is essentially amap from names toGtkAction objects.

TheGtkAdjustment object represents a value which has an associated lowerand upper bound, together with step and page increments, and a page size.It is used within severalGTK+ widgets, includingGtkSpinButton,GtkViewport,andGtkRange (which is a base class forGtkScrollbar andGtkScale).

TheGtkAlignment widget controls the alignment and size of its child widget.It has four settings: xscale, yscale, xalign, and yalign.

TheGtkAppChooserButton is a widget that lets the user selectan application. It implements theGtkAppChooser interface.

GtkAppChooserDialog shows aGtkAppChooserWidget inside aGtkDialog.

GtkAppChooserWidget is a widget for selecting applications.It is the main building block forGtkAppChooserDialog. Mostapplications only need to use the latter; but you can usethis widget as part of a larger widget if you have special needs.

GtkApplication is a class that handles many important aspectsof aGTK+ application in a convenient fashion, without enforcinga one-size-fits-all application model.

GtkApplicationWindow is aGtkWindow subclass that offers someextra functionality for better integration withGtkApplicationfeatures. Notably, it can handle both the application menu as wellas the menubar. Seegtk_application_set_app_menu() and gtk_application_set_menubar().

GtkArrow should be used to draw simple arrows that need to point inone of the four cardinal directions (up, down, left, or right). Thestyle of the arrow can be one of shadow in, shadow out, etched in, oretched out. Note that these directions and style types may beamended in versions ofGTK+ to come.

TheGtkAspectFrame is useful when you wantpack a widget so that it can resize but always retainsthe same aspect ratio. For instance, one might bedrawing a small preview of a larger image.GtkAspectFramederives fromGtkFrame, so it can draw a label anda frame around the child. The frame will be“shrink-wrapped” to the size of the child.

AGtkAssistant is a widget used to represent a generally complexoperation splitted in several steps, guiding the user through itspages and controlling the page flow to collect the necessary data.

TheGtkBin widget is a container with just one child.It is not very useful itself, but it is useful for deriving subclasses,since it provides common code needed for handling a single child widget.

The GtkBox widget arranges child widgets into a single row or column,depending upon the value of itsGtkOrientable:orientation property. Withinthe other dimension, all children are allocated the same size. Of course,theGtkWidget:halign andGtkWidget:valign properties can be used onthe children to influence their allocation.

A GtkBuilder is an auxiliary object that reads textual descriptionsof a user interface and instantiates the described objects. To createa GtkBuilder from a user interface description, callgtk_builder_new_from_file(),gtk_builder_new_from_resource() or gtk_builder_new_from_string().

TheGtkButton widget is generally used to trigger a callback function that iscalled when the button is pressed. The various signals and how to use themare outlined below.

GtkCalendar is a widget that displays a Gregorian calendar, one monthat a time. It can be created with gtk_calendar_new().

TheGtkCellArea is an abstract class forGtkCellLayout widgets(also referred to as “layouting widgets”) to interface with anarbitrary number ofGtkCellRenderers and interact with the userfor a givenGtkTreeModel row.

TheGtkCellAreaBox renders cell renderers into a row or a columndepending on itsGtkOrientation.

TheGtkCellAreaContext object is created by a givenGtkCellAreaimplementation via itsGtkCellAreaClass.create_context() virtualmethod and is used to store cell sizes and alignments for a series ofGtkTreeModel rows that are requested and rendered in the same context.

TheGtkCellRenderer is a base class of a set of objects used forrendering a cell to a #cairo_t. These objects are used primarily bytheGtkTreeView widget, though they aren’t tied to them in anyspecific way. It is worth noting thatGtkCellRenderer is not aGtkWidget and cannot be treated as such.

GtkCellRendererAccel displays a keyboard accelerator (i.e. a keycombination likeControl + a). If the cell renderer is editable,the accelerator can be changed by simply typing the new combination.

GtkCellRendererCombo renders text in a cell likeGtkCellRendererText fromwhich it is derived. But whileGtkCellRendererText offers a simple entry toedit the text,GtkCellRendererCombo offers aGtkComboBoxwidget to edit the text. The values to display in the combo box are taken fromthe tree model specified in theGtkCellRendererCombo:model property.

AGtkCellRendererPixbuf can be used to render an image in a cell. It allowsto render either a givenGdkPixbuf (set via theGtkCellRendererPixbuf:pixbuf property) or a named icon (set via theGtkCellRendererPixbuf:icon-name property).

GtkCellRendererProgress renders a numeric value as a progress par in a cell.Additionally, it can display a text on top of the progress bar.

GtkCellRendererSpin renders text in a cell likeGtkCellRendererText fromwhich it is derived. But whileGtkCellRendererText offers a simple entry toedit the text,GtkCellRendererSpin offers aGtkSpinButton widget. Of course,that means that the text has to be parseable as a floating point number.

GtkCellRendererSpinner renders a spinning animation in a cell, verysimilar toGtkSpinner. It can often be used as an alternativeto aGtkCellRendererProgress for displaying indefinite activity,instead of actual progress.

AGtkCellRendererText renders a given text in its cell, using the font, color andstyle information provided by its properties. The text will be ellipsized if it istoo long and theGtkCellRendererText:ellipsize property allows it.

GtkCellRendererToggle renders a toggle button in a cell. Thebutton is drawn as a radio or a checkbutton, depending on theGtkCellRendererToggle:radio property.When activated, it emits theGtkCellRendererToggle::toggled signal.

AGtkCellView displays a single row of aGtkTreeModel using aGtkCellAreaandGtkCellAreaContext. AGtkCellAreaContext can be provided to theGtkCellView at construction time in order to keep the cellview in contextof a group of cell views, this ensures that the renderers displayed willbe properly aligned with eachother (like the aligned cells in the menusofGtkComboBox).

AGtkCheckButton places a discreteGtkToggleButton next to a widget,(usually aGtkLabel). See the section onGtkToggleButton widgets formore information about toggle/check buttons.

AGtkCheckMenuItem is a menu item that maintains the state of a booleanvalue in addition to aGtkMenuItem usual role in activating application code.

TheGtkClipboard object represents a clipboard of data sharedbetween different processes or between different widgets inthe same process. Each clipboard is identified by a name encoded as aGdkAtom. (Conversion to and from strings can be done withgdk_atom_intern() and gdk_atom_name().) The default clipboardcorresponds to the “CLIPBOARD” atom; another commonly used clipboardis the “PRIMARY” clipboard, which, in X, traditionally containsthe currently selected text.

TheGtkColorButton is a button which displays the currently selectedcolor and allows to open a color selection dialog to change the color.It is suitable widget for selecting a color in a preference dialog.

TheGtkColorChooserDialog widget is a dialog for choosinga color. It implements theGtkColorChooser interface.

since: 3.4

TheGtkColorChooserWidget widget lets the user select acolor. By default, the chooser presents a predefined paletteof colors, plus a small number of settable custom colors.It is also possible to select a different color with thesingle-color editor. To enter the single-color editing mode,use the context menu of any color of the palette, or use the‘+’ button to add a new custom color.

since: 3.4

A GtkComboBox is a widget that allows the user to choose from a list ofvalid choices. The GtkComboBox displays the selected choice. Whenactivated, the GtkComboBox displays a popup which allows the user tomake a new choice. The style in which the selected value is displayed,and the style of the popup is determined by the current theme. It maybe similar to a Windows-style combo box.

A GtkComboBoxText is a simple variant ofGtkComboBox that hidesthe model-view complexity for simple text-only use cases.

AGTK+ user interface is constructed by nesting widgets inside widgets.Container widgets are the inner nodes in the resulting tree of widgets:they contain other widgets. So, for example, you might have aGtkWindowcontaining aGtkFrame containing aGtkLabel. If you wanted an image insteadof a textual label inside the frame, you might replace theGtkLabel widgetwith aGtkImage widget.

GtkCssProvider is an object implementing theGtkStyleProvider interface.It is able to parse [CSS-like][css-overview] input in order to style widgets.

Dialog boxes are a convenient way to prompt the user for a small amountof input, e.g. to display a message, ask a question, or anything elsethat does not require extensive effort on the user’s part.

TheGtkDrawingArea widget is used for creating custom user interfaceelements. It’s essentially a blank widget; you can draw on it. Aftercreating a drawing area, the application may want to connect to:.

TheGtkEntry widget is a single line text entrywidget. A fairly large set of key bindings are supportedby default. If the entered text is longer than the allocationof the widget, the widget will scroll so that the cursorposition is visible.

TheGtkEntryBuffer class contains the actual text displayed in aGtkEntry widget.

since: 2.18

GtkEntryCompletion is an auxiliary object to be used in conjunction withGtkEntry to provide the completion functionality. It implements theGtkCellLayout interface, to allow the user to add extra cells to theGtkTreeView with completion matches.

TheGtkEventBox widget is a subclass ofGtkBin which also has itsown window. It is useful since it allows you to catch events for widgetswhich do not have their own window.

GtkEventController is a base, low-level implementation for eventcontrollers. Those react to a series ofGdkEvents, and possibly triggeractions as a consequence of those.

GtkEventControllerKey is an event controller meant for situationswhere you need access to key events.

GtkEventControllerMotion is an event controller meant for situationswhere you need to track the position of the pointer.

GtkEventControllerScroll is an event controller meant to handlescroll events from mice and touchpads. It is capable of handlingboth discrete and continuous scroll events, abstracting them bothon theGtkEventControllerScroll::scroll signal (deltas in thediscrete case are multiples of 1).

AGtkExpander allows the user to hide or show its child by clickingon an expander triangle similar to the triangles used in aGtkTreeView.

TheGtkFileChooserButton is a widget that lets the user select afile. It implements theGtkFileChooser interface. Visually, it is afile name with a button to bring up aGtkFileChooserDialog.The user can then use that dialog to change the file associated withthat button. This widget does not support setting theGtkFileChooser:select-multiple property toTRUE.

GtkFileChooserDialog is a dialog box suitable for use with“File/Open” or “File/Save as” commands. This widget works byputting aGtkFileChooserWidget inside aGtkDialog. It exposestheGtkFileChooser interface, so you can use all of theGtkFileChooser functions on the file chooser dialog as well asthose forGtkDialog.

GtkFileChooserNative is an abstraction of a dialog box suitablefor use with “File/Open” or “File/Save as” commands. By default, thisjust uses aGtkFileChooserDialog to implement the actual dialog.However, on certain platforms, such as Windows and macOS, the native platformfile chooser is used instead. When the application is running in asandboxed environment without direct filesystem access (such as Flatpak),GtkFileChooserNative may call the proper APIs (portals) to let the userchoose a file and make it available to the application.

GtkFileChooserWidget is a widget for choosing files.It exposes theGtkFileChooser interface, and you shoulduse the methods of this interface to interact with the widget.

unstable since: 3.24.30

A GtkFileFilter can be used to restrict the files being shown in aGtkFileChooser. Files can be filtered based on their name (withgtk_file_filter_add_pattern()), on their mime type (withgtk_file_filter_add_mime_type()), or by a custom filter function(with gtk_file_filter_add_custom()).

TheGtkFixed widget is a container which can place child widgetsat fixed positions and with fixed sizes, given in pixels.GtkFixedperforms no automatic layout management.

A GtkFlowBox positions child widgets in sequence according to its orientation.

TheGtkFontButton is a button which displays the currently selectedfont an allows to open a font chooser dialog to change the font.It is suitable widget for selecting a font in a preference dialog.

TheGtkFontChooserDialog widget is a dialog for selecting a font.It implements theGtkFontChooser interface.

since: 3.2

TheGtkFontChooserWidget widget lists the available fonts,styles and sizes, allowing the user to select a font. It isused in theGtkFontChooserDialog widget to provide adialog box for selecting fonts.

since: 3.2

The frame widget is a bin that surrounds its child with a decorativeframe and an optional label. If present, the label is drawn in a gapin the top side of the frame. The position of the label can becontrolled with gtk_frame_set_label_align().

GtkGesture is the base object for gesture recognition, although thisobject is quite generalized to serve as a base for multi-touch gestures,it is suitable to implement single-touch and pointer-based gestures (usingthe specialNULLGdkEventSequence value for these).

GtkGestureDrag is aGtkGesture implementation that recognizes dragoperations. The drag operation itself can be tracked throught theGtkGestureDrag::drag-begin,GtkGestureDrag::drag-update andGtkGestureDrag::drag-end signals, or the relevant coordinates beextracted throughgtk_gesture_drag_get_offset() and gtk_gesture_drag_get_start_point().

GtkGestureLongPress is aGtkGesture implementation able to recognizelong presses, triggering theGtkGestureLongPress::pressed after thetimeout is exceeded.

GtkGestureMultiPress is aGtkGesture implementation able to recognizemultiple clicks on a nearby zone, which can be listened for through theGtkGestureMultiPress::pressed signal. Whenever time or distance betweenclicks exceed theGTK+ defaults,GtkGestureMultiPress::stopped is emitted,and the click counter is reset.

GtkGesturePan is aGtkGesture implementation able to recognizepan gestures, those are drags that are locked to happen along oneaxis. The axis that aGtkGesturePan handles is defined atconstruct time, and can be changed through gtk_gesture_pan_set_orientation().

GtkGestureRotate is aGtkGesture implementation able to recognize2-finger rotations, whenever the angle between both handled sequenceschanges, theGtkGestureRotate::angle-changed signal is emitted.

GtkGestureSingle is a subclass ofGtkGesture, optimized (althoughnot restricted) for dealing with mouse and single-touch gestures. Underinteraction, these gestures stick to the first interacting sequence, whichis accessible throughgtk_gesture_single_get_current_sequence() while thegesture is being interacted with.

GtkGestureStylus is aGtkGesture implementation specific to stylusinput. The provided signals just provide the basic information.

GtkGestureSwipe is aGtkGesture implementation able to recognizeswipes, after a press/move/…/move/release sequence happens, theGtkGestureSwipe::swipe signal will be emitted, providing the velocityand directionality of the sequence at the time it was lifted.

GtkGestureZoom is aGtkGesture implementation able to recognizepinch/zoom gestures, whenever the distance between both trackedsequences changes, theGtkGestureZoom::scale-changed signal isemitted to report the scale factor.

GtkGLArea is a widget that allows drawing with OpenGL.

since: 3.16

GtkGrid is a container which arranges its child widgets inrows and columns, with arbitrary positions and horizontal/vertical spans.

TheGtkHandleBox widget allows a portion of a window to be “tornoff”. It is a bin widget which displays its child and a handle thatthe user can drag to tear off a separate window (the “floatwindow”) containing the child widget. A thin“ghost” is drawn in the original location of thehandlebox. By dragging the separate window back to its originallocation, it can be reattached.

GtkHBox is a container that organizes child widgets into a single row.

GtkHeaderBar is similar to a horizontalGtkBox. It allows children tobe placed at the start or the end. In addition, it allows a title andsubtitle to be displayed. The title will be centered with respect tothe width of the box, even if the children at either side take updifferent amounts of space. The height of the titlebar will beset to provide sufficient space for the subtitle, even if none iscurrently set. If a subtitle is not needed, the space reservationcan be turned off with gtk_header_bar_set_has_subtitle().

unstable since: 3.24.11

The HPaned widget is a container widget with twochildren arranged horizontally. The division betweenthe two panes is adjustable by the user by dragginga handle. SeeGtkPaned for details.

TheGtkHScale widget is used to allow the user to select a value usinga horizontal slider. To create one, use gtk_hscale_new_with_range().

TheGtkHScrollbar widget is a widget arranged horizontally creating ascrollbar. SeeGtkScrollbar for details onscrollbars.GtkAdjustment pointers may be added to handle theadjustment of the scrollbar or it may be leftNULL in which case onewill be created for you. SeeGtkScrollbar for a description of what thefields in an adjustment represent for a scrollbar.

TheGtkHSeparator widget is a horizontal separator, used to group thewidgets within a window. It displays a horizontal line with a shadow tomake it appear sunken into the interface.

GtkHSV is the “color wheel” part of a complete color selector widget.It allows to select a color by determining itsHSV components in anintuitive way. Moving the selection around the outer ring changes the hue,and moving the selection point inside the inner triangle changes value and saturation.

An icon factory manages a collection ofGtkIconSet; aGtkIconSet manages aset of variants of a particular icon (i.e. aGtkIconSet contains variants fordifferent sizes and widget states). Icons in an icon factory are named by astockID, which is a simple string identifying the icon. EachGtkStyle has alist ofGtkIconFactory derived from the current theme; those icon factoriesare consulted first when searching for an icon. If the theme doesn’t set aparticular icon,GTK+ looks for the icon in a list of default icon factories,maintained bygtk_icon_factory_add_default() andgtk_icon_factory_remove_default(). Applications with icons should add a defaulticon factory with their icons, which will allow themes to override the iconsfor the application.

Contains information found when looking up an icon inan icon theme.

GtkIconTheme provides a facility for looking up icons by nameand size. The main reason for using a name rather than simplyproviding a filename is to allow different icons to be useddepending on what “icon theme” is selectedby the user. The operation of icon themes on Linux and Unixfollows theIcon Theme SpecificationThere is a fallback icon theme, namedhicolor, where applicationsshould install their icons, but additional icon themes can be installedas operating system vendors and users choose.

GtkIconView provides an alternative view on aGtkTreeModel.It displays the model as a grid of icons with labels. LikeGtkTreeView, it allows to select one or multiple items(depending on the selection mode, see gtk_icon_view_set_selection_mode()).In addition to selection with the arrow keys,GtkIconView supportsrubberband selection, which is controlled by dragging the pointer.

TheGtkImage widget displays an image. Various kinds of objectcan be displayed as an image; most typically, you would load aGdkPixbuf (“pixel buffer”) from a file, and then display that.There’s a convenience function to do this, gtk_image_new_from_file(),used as follows:

GtkWidget*image;image=gtk_image_new_from_file("myfile.png");

If the file isn’t loaded successfully, the image will contain a“broken image” icon similar to that used in many web browsers.If you want to handle errors in loading the file yourself,for example by displaying an error message, then load the image withgdk_pixbuf_new_from_file(), then create theGtkImage with gtk_image_new_from_pixbuf().

A GtkImageMenuItem is a menu item which has an icon next to the text label.

GtkIMContext defines the interface forGTK+ input methods. An input methodis used byGTK+ text input widgets likeGtkEntry to map from key events toUnicode character strings.

GtkIMContextSimple is a simple input method context supporting table-basedinput methods. It has a built-in table of compose sequences that is derivedfrom the X11 Compose files.

GtkInfoBar is a widget that can be used to show messages tothe user without showing a dialog. It is often temporarily shownat the top or bottom of a document. In contrast toGtkDialog, whichhas a action area at the bottom,GtkInfoBar has an action areaat the side.

TheGtkInvisible widget is used internally inGTK+, and is probably notvery useful for application developers.

TheGtkLabel widget displays a small amount of text. As the nameimplies, most labels are used to label another widget such as aGtkButton, aGtkMenuItem, or aGtkComboBox.

GtkLayout is similar toGtkDrawingArea in that it’s a “blank slate” anddoesn’t do anything except paint a blank background by default. It’sdifferent in that it supports scrolling natively due to implementingGtkScrollable, and can contain child widgets since it’s aGtkContainer.

TheGtkLevelBar is a bar widget that can be usedas a level indicator. Typical use cases are displaying the strengthof a password, or showing the charge level of a battery.

A GtkLinkButton is aGtkButton with a hyperlink, similar to the oneused by web browsers, which triggers an action when clicked. It is usefulto show quick links to resources.

A GtkListBox is a vertical container that contains GtkListBoxRowchildren. These rows can be dynamically sorted and filtered, andheaders can be added dynamically depending on the row content.It also allows keyboard and mouse navigation and selection likea typical list.

TheGtkListStore object is a list model for use with aGtkTreeViewwidget. It implements theGtkTreeModel interface, and consequentialy,can use all of the methods available there. It also implements theGtkTreeSortable interface so it can be sorted by the view.Finally, it also implements the tree[drag and drop][gtk3-GtkTreeView-drag-and-drop] interfaces.

GtkLockButton is a widget that can be used in control panels orpreference dialogs to allow users to obtain and revoke authorizationsneeded to operate the controls. The required authorization is representedby aGPermission object. Concrete implementations ofGPermission may usePolicyKit or some other authorization framework. To obtain a PolicyKit-basedGPermission, use polkit_permission_new().

AGtkMenu is aGtkMenuShell that implements a drop down menuconsisting of a list ofGtkMenuItem objects which can be navigatedand activated by the user to perform application functions.

TheGtkMenuBar is a subclass ofGtkMenuShell which contains one ormoreGtkMenuItems. The result is a standard menu bar which can holdmany menu items.

TheGtkMenuButton widget is used to display a popup when clicked on.This popup can be provided either as aGtkMenu, aGtkPopover or anabstractGMenuModel.

TheGtkMenuItem widget and the derived widgets are the only validchildren for menus. Their function is to correctly handle highlighting,alignment, events and submenus.

AGtkMenuShell is the abstract base class used to derive theGtkMenu andGtkMenuBar subclasses.

AGtkMenuToolButton is aGtkToolItem that contains a button anda small additional button with an arrow. When clicked, the arrowbutton pops up a dropdown menu.

GtkMessageDialog presents a dialog with some message text. It’s simply aconvenience widget; you could construct the equivalent ofGtkMessageDialogfromGtkDialog without too much effort, butGtkMessageDialog saves typing.

TheGtkMisc widget is an abstract widget which is not useful itself, butis used to derive subclasses which have alignment and padding attributes.

GtkModelButton is a button class that can use aGAction as its model.In contrast toGtkToggleButton orGtkRadioButton, which can alsobe backed by aGAction via theGtkActionable:action-name property,GtkModelButton will adapt its appearance according to the kind ofaction it is backed by, and appear either as a plain, check orradio button.

This should not be accessed directly. Use the accessor functions below.

Native dialogs are platform dialogs that don’t useGtkDialog orGtkWindow. They are used in order to integrate better with aplatform, by looking the same as other native applications andsupporting platform specific features.

TheGtkNotebook widget is aGtkContainer whose children are pages thatcan be switched between using tab labels along one edge.

GtkNumerableIcon is a subclass ofGEmblemedIcon that canshow a number or short string as an emblem. The number canbe overlayed on top of another emblem, if desired.

GtkOffscreenWindow is strictly intended to be used for obtainingsnapshots of widgets that are not part of a normal widget hierarchy.SinceGtkOffscreenWindow is a toplevel widget you cannot obtainsnapshots of a full window with it since you cannot pack a toplevelwidget in another toplevel.

GtkOverlay is a container which contains a single main child, on topof which it can place “overlay” widgets. The position of each overlaywidget is determined by itsGtkWidget:halign andGtkWidget:valignproperties. E.g. a widget with both alignments set toGTK_ALIGN_STARTwill be placed at the top left corner of the GtkOverlay container,whereas an overlay with halign set toGTK_ALIGN_CENTER and valign settoGTK_ALIGN_END will be placed a the bottom edge of the GtkOverlay,horizontally centered. The position can be adjusted by setting the marginproperties of the child to non-zero values.

GtkPadController is an event controller for the pads found in drawingtablets (The collection of buttons and tactile sensors often found aroundthe stylus-sensitive area).

A GtkPageSetup object stores the page size, orientation and margins.The idea is that you can get one of these from the page setup dialogand then pass it to theGtkPrintOperation when printing.The benefit of splitting this out of theGtkPrintSettings is thatthese affect the actual layout of the page, and thus need to be setlong before user prints.

GtkPaned has two panes, arranged eitherhorizontally or vertically. The division betweenthe two panes is adjustable by the user by dragginga handle.

GtkPlacesSidebar is a widget that displays a list of frequently-used places in thefile system: the user’s home directory, the user’s bookmarks, and volumes and drives.This widget is used as a sidebar inGtkFileChooser and may be used by file managersand similar programs.

Together withGtkSocket,GtkPlug provides the ability to embedwidgets from one process into another process in a fashion that istransparent to the user. One process creates aGtkSocket widgetand passes theID of that widget’s window to the other process,which then creates aGtkPlug with that windowID. Any widgetscontained in theGtkPlug then will appear inside the firstapplication’s window.

unstable since: 3.24.30

GtkPopover is a bubble-like context window, primarily meant toprovide context-dependent information or options. Popovers areattached to a widget, passed at construction time on gtk_popover_new(),or updated afterwards through gtk_popover_set_relative_to(), bydefault they will point to the whole widget area, although thisbehavior can be changed through gtk_popover_set_pointing_to().

since: 3.12

GtkPopoverMenu is a subclass ofGtkPopover that treats itschildren like menus and allows switching between them. It ismeant to be used primarily together withGtkModelButton, butany widget can be used, such asGtkSpinButton orGtkScale.In this respect, GtkPopoverMenu is more flexible than popoversthat are created from aGMenuModel with gtk_popover_new_from_model().

A GtkPrintContext encapsulates context information that is required whendrawing pages for printing, such as the cairo context and importantparameters like page size and resolution. It also lets you easilycreatePangoLayout andPangoContext objects that match the font metricsof the cairo surface.

GtkPrintOperation is the high-level, portable printingAPI.It looks a bit different than otherGTK+ dialogs such as theGtkFileChooser, since some platforms don’t expose enoughinfrastructure to implement a good print dialog. On suchplatforms, GtkPrintOperation uses the native print dialog.On platforms which do not provide a native print dialog,GTK+uses its own, seeGtkPrintUnixDialog.

A GtkPrintSettings object represents the settings of a print dialog ina system-independent way. The main use for this object is that onceyou’ve printed you can get a settings object that represents the settingsthe user chose, and the next time you print you can pass that object in sothat the user doesn’t have to re-set all his settings.

TheGtkProgressBar is typically used to display the progress of a longrunning operation. It provides a visual clue that processing is underway.The GtkProgressBar can be used in two different modes: percentage modeand activity mode.

AGtkRadioAction is similar toGtkRadioMenuItem. A number of radioactions can be linked together so that only one may be active at anyone time.

A single radio button performs the same basic function as aGtkCheckButton,as its position in the object hierarchy reflects. It is only when multipleradio buttons are grouped together that they become a different userinterface component in their own right.

A radio menu item is a check menu item that belongs to a group. At eachinstant exactly one of the radio menu items from a group is selected.

AGtkRadioToolButton is aGtkToolItem that contains a radio button,that is, a button that is part of a group of toggle buttons where onlyone button can be active at a time.

GtkRange is the common base class for widgets which visualize anadjustment, e.gGtkScale orGtkScrollbar.

TheGtkRcStyle-struct is used to represent a setof information about the appearance of a widget.This can later be composited together with otherGtkRcStyle-structs to form aGtkStyle.

AGtkRecentAction represents a list of recently used files, whichcan be shown by widgets such asGtkRecentChooserDialog orGtkRecentChooserMenu.

GtkRecentChooserDialog is a dialog box suitable for displaying the recentlyused documents. This widgets works by putting aGtkRecentChooserWidget insideaGtkDialog. It exposes theGtkRecentChooserIface interface, so you can useall theGtkRecentChooser functions on the recent chooser dialog as well asthose forGtkDialog.

GtkRecentChooserMenu is a widget suitable for displaying recently used filesinside a menu. It can be used to set a sub-menu of aGtkMenuItem usinggtk_menu_item_set_submenu(), or as the menu of aGtkMenuToolButton.

GtkRecentChooserWidget is a widget suitable for selecting recently usedfiles. It is the main building block of aGtkRecentChooserDialog. Mostapplications will only need to use the latter; you can useGtkRecentChooserWidget as part of a larger window if you have special needs.

AGtkRecentFilter can be used to restrict the files being shownin aGtkRecentChooser. Files can be filtered based on their name(with gtk_recent_filter_add_pattern()), on their mime type (withgtk_file_filter_add_mime_type()), on the application that hasregistered them (with gtk_recent_filter_add_application()), or bya custom filter function (with gtk_recent_filter_add_custom()).

GtkRecentManager provides a facility for adding, removing andlooking up recently used files. Each recently used file isidentified by itsURI, and has meta-data associated to it, likethe names and command lines of the applications that haveregistered it, the number of time each application has registeredthe same file, the mime type of the file and whether the fileshould be displayed only by the applications that haveregistered it.

since: 2.10

The GtkRevealer widget is a container which animatesthe transition of its child from invisible to visible.

A GtkScale is a slider control used to select a numeric value.To use it, you’ll probably want to investigate the methods onits base class,GtkRange, in addition to the methods for GtkScale itself.To set the value of a scale, you would normally use gtk_range_set_value().To detect changes to the value, you would normally use theGtkRange::value-changed signal.

GtkScaleButton provides a button which pops up a scale widget.This kind of widget is commonly used for volume controls in multimediaapplications, andGTK+ provides aGtkVolumeButton subclass thatis tailored for this use case.

TheGtkScrollbar widget is a horizontal or vertical scrollbar,depending on the value of theGtkOrientable:orientation property.

GtkScrolledWindow is a container that accepts a single child widget and makesthat child scrollable using either internally added scrollbars or externallyassociated adjustments.

GtkSearchBar is a container made to have a search entry (possiblywith additional connex widgets, such as drop-down menus, or buttons)built-in. The search bar would appear when a search is started throughtyping on the keyboard, or the application’s search mode is toggled on.

since: 3.10

GtkSearchEntry is a subclass ofGtkEntry that has beentailored for use as a search entry.

since: 3.6

GtkSeparator is a horizontal or vertical separator widget, depending on thevalue of theGtkOrientable:orientation property, used to group the widgetswithin a window. It displays a line with a shadow to make it appear sunkeninto the interface.

TheGtkSeparatorMenuItem is a separator used to groupitems within a menu. It displays a horizontal line with a shadow tomake it appear sunken into the interface.

AGtkSeparatorToolItem is aGtkToolItem that separates groups of otherGtkToolItems. Depending on the theme, aGtkSeparatorToolItem willoften look like a vertical line on horizontally docked toolbars.

GtkSettings provide a mechanism to share global settings between applications.

GtkShortcutLabel is a widget that represents a single keyboard shortcut or gesturein the user interface.

A GtkShortcutsGroup represents a group of related keyboard shortcutsor gestures. The group has a title. It may optionally be associated witha view of the application, which can be used to show only relevant shortcutsdepending on the application context.

A GtkShortcutsSection collects all the keyboard shortcuts and gesturesfor a major application mode. If your application needs multiple sections,you should give each section a uniqueGtkShortcutsSection:section-name andaGtkShortcutsSection:title that can be shown in the section selector ofthe GtkShortcutsWindow.

A GtkShortcutsShortcut represents a single keyboard shortcut or gesturewith a short text. This widget is only meant to be used withGtkShortcutsWindow.

A GtkShortcutsWindow shows brief information about the keyboard shortcutsand gestures of an application. The shortcuts can be grouped, and you canhave multiple sections in this window, corresponding to the major modes ofyour application.

GtkSizeGroup provides a mechanism for grouping a number of widgetstogether so they all request the same amount of space. This istypically useful when you want a column of widgets to have the samesize, but you can’t use aGtkGrid widget.

Together withGtkPlug,GtkSocket provides the ability to embedwidgets from one process into another process in a fashion thatis transparent to the user. One process creates aGtkSocket widgetand passes that widget’s windowID to the other process, which thencreates aGtkPlug with that windowID. Any widgets contained in theGtkPlug then will appear inside the first application’s window.

unstable since: 3.24.30

AGtkSpinButton is an ideal way to allow the user to set the value ofsome attribute. Rather than having to directly type a number into aGtkEntry, GtkSpinButton allows the user to click on one of two arrowsto increment or decrement the displayed value. A value can still betyped in, with the bonus that it can be checked to ensure it is in agiven range.

A GtkSpinner widget displays an icon-size spinning animation.It is often used as an alternative to aGtkProgressBar fordisplaying indefinite activity, instead of actual progress.

The GtkStack widget is a container which only showsone of its children at a time. In contrast to GtkNotebook,GtkStack does not provide a means for users to change thevisible child. Instead, theGtkStackSwitcher widget can beused with GtkStack to provide this functionality.

A GtkStackSidebar enables you to quickly and easily provide aconsistent “sidebar” object for your user interface.

since: 3.16

The GtkStackSwitcher widget acts as a controller for aGtkStack; it shows a row of buttons to switch betweenthe various pages of the associated stack widget.

AGtkStatusbar is usually placed along the bottom of an application’smainGtkWindow. It may provide a regular commentary of the application’sstatus (as is usually the case in a web browser, for example), or may beused to simply output a message when the status changes, (when an uploadis complete in anFTP client, for example).

The “system tray” or notification area is normally used for transient iconsthat indicate some special state. For example, a system tray icon mightappear to tell the user that they have new mail, or have an incoming instantmessage, or something along those lines. The basic idea is that creating anicon in the notification area is less annoying than popping up a dialog.

AGtkStyle object encapsulates the information that provides the look andfeel for a widget.

GtkStyleContext is an object that stores styling information affectinga widget defined byGtkWidgetPath.

GtkStyleProperties provides the storage for style informationthat is used byGtkStyleContext and otherGtkStyleProviderimplementations.

GtkSwitch is a widget that has two states: on or off. The user can controlwhich state should be active by clicking the empty area, or by dragging the handle.

TheGtkTable functions allow the programmer to arrange widgets in rows andcolumns, making it easy to align many widgets next to each other,horizontally and vertically.

AGtkTearoffMenuItem is a specialGtkMenuItem which is used totear off and reattach its menu.

You may wish to begin by reading thetext widget conceptual overviewwhich gives an overview of all the objects and datatypes related to the text widget and how they work together.

AGtkTextChildAnchor is a spot in the buffer where child widgets canbe “anchored” (inserted inline, as if they were characters). The anchorcan have multiple widgets anchored, to allow for multiple views.

You may wish to begin by reading thetext widget conceptual overviewwhich gives an overview of all the objects and datatypes related to the text widget and how they work together.

You may wish to begin by reading thetext widget conceptual overviewwhich gives an overview of all the objects anddata types related to the text widget and how they work together.

You may wish to begin by reading thetext widget conceptual overviewwhich gives an overview of all the objects anddata types related to the text widget and how they work together.

You may wish to begin by reading thetext widget conceptual overviewwhich gives an overview of all the objects and datatypes related to the text widget and how they work together.

GtkThemingEngine was the object used for rendering themed contentinGTK+ widgets. It used to allow overridingGTK+’s defaultimplementation of rendering functions by allowing engines to beloaded as modules.

AGtkToggleAction corresponds roughly to aGtkCheckMenuItem. It has an“active” state specifying whether the action has been checked or not.

AGtkToggleButton is aGtkButton which will remain “pressed-in” whenclicked. Clicking again will cause the toggle button to return to itsnormal state.

AGtkToggleToolButton is aGtkToolItem that contains a toggle button.

A toolbar is created with a call to gtk_toolbar_new().

GtkToolButtons areGtkToolItems containing buttons.

GtkToolItems are widgets that can appear on a toolbar. Tocreate a toolbar item that contain something else than a button, usegtk_tool_item_new(). Usegtk_container_add() to add a childwidget to the tool item.

AGtkToolItemGroup is used together withGtkToolPalette to addGtkToolItems to a palette like container with differentcategories and drag and drop support.

since: 2.20

AGtkToolPalette allows you to addGtkToolItems to a palette-likecontainer with different categories and drag and drop support.

since: 2.20

Basic tooltips can be realized simply by usinggtk_widget_set_tooltip_text()orgtk_widget_set_tooltip_markup() without any explicit tooltip object.

AGtkTreeModelFilter is a tree model which wraps another tree model,and can do the following things:.

TheGtkTreeModelSort is a model which implements theGtkTreeSortableinterface. It does not hold any data itself, but rather is created witha child model and proxies its data. It has identical column types tothis child model, and the changes in the child are propagated. Theprimary purpose of this model is to provide a way to sort a differentmodel without modifying it. Note that the sort function used byGtkTreeModelSort is not guaranteed to be stable.

TheGtkTreeSelection object is a helper object to manage the selectionfor aGtkTreeView widget. TheGtkTreeSelection object isautomatically created when a newGtkTreeView widget is created, andcannot exist independently of this widget. The primary reason theGtkTreeSelection objects exists is for cleanliness of code andAPI.That is, there is no conceptual reason all these functions could not bemethods on theGtkTreeView widget instead of a separate function.

TheGtkTreeStore object is a list model for use with aGtkTreeViewwidget. It implements theGtkTreeModel interface, and consequentially,can use all of the methods available there. It also implements theGtkTreeSortable interface so it can be sorted by the view. Finally,it also implements the tree[drag and drop][gtk3-GtkTreeView-drag-and-drop] interfaces.

Widget that displays any object that implements theGtkTreeModel interface.

The GtkTreeViewColumn object represents a visible column in aGtkTreeView widget.It allows to set properties of the column header, and functions as a holding pen forthe cell renderers which determine how the data in the column is displayed.

AGtkUIManager constructs a user interface (menus and toolbars) fromone or moreUI definitions, which reference actions from one or moreaction groups.

AGtkVBox is a container that organizes child widgets into a single column.

TheGtkViewport widget acts as an adaptor class, implementingscrollability for child widgets that lack their own scrollingcapabilities. Use GtkViewport to scroll child widgets such asGtkGrid,GtkBox, and so on.

GtkVolumeButton is a subclass ofGtkScaleButton that hasbeen tailored for use as a volume control widget with suitableicons, tooltips and accessible labels.

The VPaned widget is a container widget with twochildren arranged vertically. The division betweenthe two panes is adjustable by the user by dragginga handle. SeeGtkPaned for details.

TheGtkVScale widget is used to allow the user to select a value usinga vertical slider. To create one, use gtk_hscale_new_with_range().

TheGtkVScrollbar widget is a widget arranged vertically creating ascrollbar. SeeGtkScrollbar for details onscrollbars.GtkAdjustment pointers may be added to handle theadjustment of the scrollbar or it may be leftNULL in which case onewill be created for you. SeeGtkScrollbar for a description of what thefields in an adjustment represent for a scrollbar.

TheGtkVSeparator widget is a vertical separator, used to group thewidgets within a window. It displays a vertical line with a shadow tomake it appear sunken into the interface.

GtkWidget is the base class all widgets inGTK+ derive from. It manages thewidget lifecycle, states and style.

A GtkWindow is a toplevel window which can contain other widgets.Windows normally have decorations that are under the controlof the windowing system and allow the user to manipulate the window(resize it, move it, close it,…).

AGtkWindowGroup restricts the effect of grabs to windowsin the same group, thereby making window groups almost behavelike separate applications.

This interface provides a convenient way of associating widgets withactions on aGtkApplicationWindow orGtkApplication.

since: 3.4

Activatable widgets can be connected to aGtkAction and reflectsthe state of its action. AGtkActivatable can also provide feedbackthrough its action, as they are responsible for activating theirrelated actions.

GtkAppChooser is an interface that can be implemented by widgets whichallow the user to choose an application (typically for the purpose ofopening a file). The main objects that implement this interface areGtkAppChooserWidget,GtkAppChooserDialog andGtkAppChooserButton.

GtkBuildable allows objects to extend and customize their deserializationfrom [GtkBuilderUI descriptions][BUILDER-UI].The interface includes methods for setting names and properties of objects,parsing custom tags and constructing child objects.

TheGtkCellEditable interface must be implemented for widgets to be usableto edit the contents of aGtkTreeView cell. It provides a way to specify howtemporary widgets should be configured for editing, get the new value, etc.

GtkCellLayout is an interface to be implemented by all objects whichwant to provide aGtkTreeViewColumn likeAPI for packing cells,setting attributes and data funcs.

GtkColorChooser is an interface that is implemented by widgetsfor choosing colors. Depending on the situation, colors may beallowed to have alpha (translucency).

since: 3.4

TheGtkEditable interface is an interface which should be implemented bytext editing widgets, such asGtkEntry andGtkSpinButton. It contains functionsfor generically manipulating an editable widget, a large number of actionsignals used for key bindings, and several signals that an application canconnect to to modify the behavior of a widget.

GtkFileChooser is an interface that can be implemented by fileselection widgets. InGTK+, the main objects that implement thisinterface areGtkFileChooserWidget,GtkFileChooserDialog, andGtkFileChooserButton. You do not need to write an object thatimplements theGtkFileChooser interface unless you are trying toadapt an existing file selector to expose a standard programming interface.

GtkFontChooser is an interface that can be implemented by widgetsdisplaying the list of fonts. InGTK+, the main objectsthat implement this interface areGtkFontChooserWidget,GtkFontChooserDialog andGtkFontButton. The GtkFontChooser interfacehas been introducted inGTK+ 3.2.

TheGtkOrientable interface is implemented by all widgets that can beoriented horizontally or vertically. Historically, such widgets have beenrealized as subclasses of a common base class (e.gGtkBox/GtkHBox/GtkVBoxorGtkScale/GtkHScale/GtkVScale).GtkOrientable is more flexible in thatit allows the orientation to be changed at runtime, allowing the widgetsto “flip”.

GtkRecentChooser is an interface that can be implemented by widgetsdisplaying the list of recently used files. InGTK+, the main objectsthat implement this interface areGtkRecentChooserWidget,GtkRecentChooserDialog andGtkRecentChooserMenu.

GtkScrollable is an interface that is implemented by widgets with nativescrolling ability.

GtkStyleProvider is an interface used to provide style information to aGtkStyleContext.Seegtk_style_context_add_provider() and gtk_style_context_add_provider_for_screen().

TheGtkToolShell interface allows container widgets to provide additionalinformation when embeddingGtkToolItem widgets.

TheGtkTreeModel interface defines a generic tree interface foruse by theGtkTreeView widget. It is an abstract interface, andis designed to be usable with any appropriate data structure. Theprogrammer just has to implement this interface on their own datatype for it to be viewable by aGtkTreeView widget.

GtkTreeSortable is an interface to be implemented by tree models whichsupport sorting. TheGtkTreeView uses the methods provided by this interfaceto sort the model.

Abstract interface type for the D-Bus interfaceorg.Gtk.MountOperationHandler.

Virtual table for the D-Bus interfaceorg.Gtk.MountOperationHandler.

The #_GtkMountOperationHandlerProxy structure contains only private data and should only be accessed using the providedAPI.

Class structure for #_GtkMountOperationHandlerProxy.

The #_GtkMountOperationHandlerSkeleton structure contains only private data and should only be accessed using the providedAPI.

Class structure for #_GtkMountOperationHandlerSkeleton.

GtkActionEntry structs are used withgtk_action_group_add_actions() toconstruct actions.

deprecated: 3.10 

AGtkBindingArg holds the data associated withan argument for a key binding signal emission asstored inGtkBindingSignal.

Each key binding element of a binding sets binding list isrepresented by a GtkBindingEntry.

A binding set maintains a list of activatable key bindings.A single binding set can match multiple types of widgets.Similar to style contexts, can be matched by any information containedin a widgetsGtkWidgetPath. When a binding within a set is matched uponactivation, an action signal is emitted on the target widget to carry outthe actual activation.

A GtkBindingSignal stores the necessary information toactivate a widget in response to a key press via a signal emission.

A struct that specifies a border around a rectangular areathat can be of different width on each side.

Defines a part of aCSS document. Because sections are nested intoone another, you can usegtk_css_section_get_parent() to get thecontaining region.

since: 3.2

AGtkFileFilterInfo-struct is used to pass information about thetested file to gtk_file_filter_filter().

GtkGradient is a boxed type that represents a gradient.It is the result of parsing a[gradient expression][gtkcssprovider-gradients].To obtain the gradient represented by a GtkGradient, it has tobe resolved with gtk_gradient_resolve(), which replaces allsymbolic color references by the colors they refer to (in a givencontext) and constructs a #cairo_pattern_t value.

Bookkeeping information about a loadable input method.

Struct defining a pad action entry.

See also gtk_print_settings_set_page_ranges().

GtkPaperSize handles paper sizes. It uses the standard calledPWG 5101.1-2002PWG: Standard for Media Standardized Namesto name the paper sizes (and to get the data for the page sizes).In addition to standard paper sizes, GtkPaperSize allows toconstruct custom paper sizes with arbitrary dimensions.

GtkRadioActionEntry structs are used withgtk_action_group_add_radio_actions() to construct groups of radio actions.

deprecated: 3.10 

Deprecated.

Meta-data to be passed togtk_recent_manager_add_full() whenregistering a recently used resource.

A GtkRecentFilterInfo struct is usedto pass information about the tested file to gtk_recent_filter_filter().

GtkRecentInfo-struct contains private data only, and shouldbe accessed using the providedAPI.

since: 2.10

Represents a request of a screen object in a given orientation. Theseare primarily used in container implementations when allocating a naturalsize for children calling. See gtk_distribute_natural_allocation().

AGtkRequisition-struct represents the desired size of a widget. See[GtkWidget’s geometry management section][geometry-management] formore information.

deprecated: 3.10 

GtkSymbolicColor is a boxed type that represents a symbolic color.It is the result of parsing a[color expression][gtkcssprovider-symbolic-colors].To obtain the color represented by a GtkSymbolicColor, it has tobe resolved with gtk_symbolic_color_resolve(), which replaces allsymbolic color references by the colors they refer to (in a givencontext) and evaluates mix, shade and other expressions, resultingin aGdkRGBA value.

AGtkTargetEntry represents a single type ofdata than can be supplied for by a widget for a selectionor for supplied or received during drag-and-drop.

AGtkTargetList-struct is a reference counted listofGtkTargetPair and should be treated as opaque.

AGtkTargetPair is used to represent the sameinformation as a table ofGtkTargetEntry, but inan efficient form.

UsingGtkTextAttributes directly should rarely be necessary.It’s primarily useful with gtk_text_iter_get_attributes().As with mostGTK+ structs, the fields in this struct should onlybe read, never modified directly.

You may wish to begin by reading thetext widget conceptual overviewwhich gives an overview of all the objects and datatypes related to the text widget and how they work together.

GtkToggleActionEntry structs are used withgtk_action_group_add_toggle_actions() to construct toggle actions.

deprecated: 3.10 

TheGtkTreeIter is the primary structurefor accessing aGtkTreeModel. Models are expected to put a uniqueinteger in thestamp member, and putmodel-specific data in the threeuser_datamembers.

A GtkTreeRowReference tracks model changes so that it always refers to thesame row (aGtkTreePath refers to a position, not a fixed row). Create anew GtkTreeRowReference with gtk_tree_row_reference_new().

GtkWidgetPath is a boxed type that represents a widget hierarchy fromthe topmost widget, typically a toplevel, to any child. This widgetpath abstraction is used inGtkStyleContext on behalf of the realwidget in order to query style information.

AGtkAllocation-struct of a widget represents regionwhich has been allocated to the widget by its parent. It is a subregionof its parents allocation. See[GtkWidget’s geometry management section][geometry-management] formore information.

Controls how a widget deals with extra space in a single (x or y) dimension.

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 theGtkAssistant. It’sused to handle buttons sensitivity and visibility.

Whenever a container has some form of natural row it may alignchildren in that row along a common typographical baseline. Ifthe amount of verical space in the row is taller than the totalrequested height of the baseline-aligned children then it can use aGtkBaselinePosition to select where to put the baseline inside theextra availible space.

since: 3.10

Describes how the border of aUI element should be rendered.

Used to dictate the style that aGtkButtonBox uses to layout the buttons it contains.

The role specifies the desired appearance of aGtkModelButton.

Prebuilt sets of buttons for the dialog. Ifnone of these choices are appropriate, simply useGTK_BUTTONS_NONEthen call gtk_dialog_add_buttons().

Determines if the edited accelerators areGTK+ accelerators. Ifthey are, consumed modifiers are suppressed, only acceleratorsaccepted byGTK+ are allowed, and the accelerators are renderedin the same way as they are in menus.

Identifies how the user can interact with a particular cell.

Specifies which corner a child widget should be placed in when packed intoaGtkScrolledWindow. This is effectively the opposite of where the scrollbars are placed.

The different types of sections indicate parts of aCSS document asparsed byGTK’sCSS parser. They are oriented towards theCSS Grammar,but may contain extensions.

since: 3.2

See also:GtkEntry::delete-from-cursor.

Focus movement types.

Gives an indication why a drag operation failed.The value can by obtained by connecting to theGtkWidget::drag-failed signal.

Specifies the side of the entry at which an icon is placed.

since: 2.16

Describes the state of aGdkEventSequence in aGtkGesture.

since: 3.14

Used to specify the style of the expanders drawn by aGtkTreeView.

Describes whether aGtkFileChooser is being used to open existing filesor to save to a possibly new file.

Used as a return value of handlers for theGtkFileChooser::confirm-overwrite signal of aGtkFileChooser. Thisvalue determines whether the file chooser will present the stockconfirmation dialog, accept the user’s choice of a filename, orlet the user choose another filename.

since: 2.8

Built-in stock icon sizes.

An enum for determining where a dropped item goes.

Describes the image data representation used by aGtkImage. If youwant to get the image from the widget, you can only get thecurrently-stored representation. e.g. if thegtk_image_get_storage_type() returns #GTK_IMAGE_PIXBUF, then you cancallgtk_image_get_pixbuf() but not gtk_image_get_stock(). For emptyimages, you can request any storage type (call any of the “get”functions), but they will all returnNULL values.

Style for input method preedit. See alsoGtkSettings:gtk-im-preedit-style.

deprecated: 3.10 

Style for input method status. See alsoGtkSettings:gtk-im-status-style.

deprecated: 3.10 

Describes primary purpose of the input widget. This information isuseful for on-screen keyboards and similar input methods to decidewhich keys should be presented to the user.

since: 3.6

Used for justifying the text inside aGtkLabel widget. (See alsoGtkAlignment).

Describes howGtkLevelBar contents should be rendered.Note that this enumeration could be extended with additional modesin the future.

since: 3.6

The type of license for an application.

since: 3.0

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 printingmultiple pages per sheet.

Represents the orientation of widgets and other objects which can be switchedbetween horizontal and vertical orientation on the fly, likeGtkToolbar orGtkGesturePan.

Determines how widgets should be packed inside menubarsand menuitems contained in menubars.

Represents the packing locationGtkBox children. (See:GtkVBox,GtkHBox, andGtkButtonBox).

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 aGtkGesturePan.

since: 3.14

Priorities for path lookups.See also gtk_binding_set_add_path().

deprecated: 3.0 

Widget path types.See also gtk_binding_set_add_path().

deprecated: 3.0 

Determines how the size should be computed to achieve the one of thevisibility mode for the scrollbars.

Describes constraints to positioning of popovers. More valuesmay be added to this enumeration in the future.

since: 3.20

Describes which edge of a widget a certain feature is positioned at, e.g. thetabs of aGtkNotebook, the handle of aGtkHandleBox or the label of aGtkScale.

See also gtk_print_settings_set_duplex().

Theaction parameter togtk_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 runningprint operation.

Describes the stage at which events are fed into aGtkEventController.

since: 3.14

TheGtkRcTokenType enumeration represents the tokensin theRC file. It is exposed so that theme enginescan reuse these tokens when parsing the theme-enginespecific portions of aRC file.

deprecated: 3.0 

Used to specify the sorting method to be applyed to the recentlyused resource list.

since: 2.10

Indicated the relief to be drawn around aGtkButton.

Predefined values for use as response ids in gtk_dialog_add_button().All predefined values are negative;GTK+ leaves values of 0 or greater forapplication-defined response ids.

These enumeration values describe the possible transitionswhen the child of aGtkRevealer widget is shown or hidden.

Defines the policy to be used in a scrollable widget when updatingthe scrolled window adjustments in a given orientation.

Scrolling types.

Used to control what selections users are allowed to make.

Determines howGTK+ handles the sensitivity of stepper arrowsat the end of range widgets.

Used to change the appearance of an outline typically provided by aGtkFrame.

GtkShortcutType specifies the kind of shortcut that is being described.More values may be added to this enumeration over time.

since: 3.20

The mode of the size group determines the directions in which the sizegroup affects the requested sizes of its component widgets.

Specifies a preference for height-for-width orwidth-for-height geometry management.

Determines the direction of a sort.

The spin button update policy determines whether the spin button displaysvalues 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 thechange to make in gtk_spin_button_spin().

These enumeration values describe the possible transitionsbetween pages in aGtkStack widget.

This type indicates the current state of a widget; the state determines howthe widget is drawn. TheGtkStateType enumeration is also used toidentify different colors in aGtkStyle for drawing, so states can beused for subparts of a widget as well as entire widgets.

deprecated: 3.14 

These values are used as “info” for the targets contained in thelists returned bygtk_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 theGtkTextView::extend-selection signal to customize the selection.

since: 3.16

Used to reference the layers ofGtkTextView for the purpose of customizeddrawing with the ::draw_layer vfunc.

Used to reference the parts ofGtkTextView.

Whether spacers are vertical lines or just blank.

deprecated: 3.20 

Used to customize the appearance of aGtkToolbar. Note thatsetting the toolbar style overrides the user’s preferencesfor the default toolbar style. Note that if the button has onlya label set and GTK_TOOLBAR_ICONS is used, the label will bevisible, and vice versa.

The sizing method the column uses to determine its width. Please notethatGTK_TREE_VIEW_COLUMN_AUTOSIZE are inefficient for large views, andcan 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.

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 thatusing #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.

AGtkWindow can be one of these types. Most things you’d consider a“window” should have type #GTK_WINDOW_TOPLEVEL; windows with this typeare managed by the window manager and have a frame by default (callgtk_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 thewindow with a frame, manyGTK+ features that rely on the windowmanager will not work (e.g. resize grips andmaximization/minimization). #GTK_WINDOW_POPUP is used to implementwidgets such asGtkMenu or tooltips that you normally don’t think ofas windows per se. Nearly all windows should be #GTK_WINDOW_TOPLEVEL.In particular, do not use #GTK_WINDOW_POPUP just to turn offthe window borders; usegtk_window_set_decorated() for that.

Describes a type of line wrapping.

Accelerator flags used with gtk_accel_group_connect().

Types of user actions that may be blocked by gtk_application_inhibit().

since: 3.4

Denotes the expansion properties that a widget will have when it (or itsparent) is resized.

These options can be used to influence the display and behaviour of aGtkCalendar.

Tells how a cell is to be rendered.

TheGtkDestDefaults enumeration specifies the varioustypes of action that will be taken on behalfof the user for a drag destination site.

Flags used to influence dialog construction.

Describes the behavior of aGtkEventControllerScroll.

since: 3.24

These flags indicate what parts of aGtkFileFilterInfo structare filled or need to be filled.

This enumeration specifies the granularity of font selectionthat is desired in a font chooser.

Used to specify options for gtk_icon_theme_lookup_icon().

Describes hints that might be taken into account by input methodsor applications. Note that input methods may already tailor theirbehaviour according to theGtkInputPurpose of the entry.

since: 3.6

Describes how a rendered element connects to adjacent elements.

These flags serve two purposes. First, the application can callgtk_places_sidebar_set_open_flags()using these flags as a bitmask. This tells the sidebar that the application is able to openfolders selected from the sidebar in various ways, for example, in new tabs or in new windows inaddition to the normal mode.

Deprecated.

These flags indicate what parts of aGtkRecentFilterInfo structare filled or need to be filled.

Describes a region within a widget.

Describes a widget state. Widget states are used to match the widgetagainstCSS pseudo-classes. Note thatGTK extends the regularCSSclasses and sometimes uses different names.

Flags that modify the behavior of gtk_style_context_to_string().New values may be added to this enumeration.

TheGtkTargetFlags enumeration is used to specifyconstraints on aGtkTargetEntry.

Flags affecting how a search is done.

Flags used to specify the supported drag targets.

These flags indicate various properties of aGtkTreeModel.

These enumeration values are used bygtk_ui_manager_add_ui() to determinewhatUI element to create.

deprecated: 3.10 

Error codes that identify various errors that can occur while usingGtkBuilder.

Error codes forGTK_CSS_PROVIDER_ERROR.

These identify the various errors that can occur while callingGtkFileChooser functions.

Error codes for GtkIconTheme operations.

Error codes that identify various errors that can occur whileusing theGTK+ printing support.

These identify the various errors that can occur while callingGtkRecentChooser functions.

since: 2.10

Error codes forGtkRecentManager operations.

since: 2.10

since: 2.2

A function used bygtk_assistant_set_forward_page_func() to know whichis the next page given a current one. It’s called both for computing thenext page when the user presses the “forward” button and for handlingthe behavior of the “last” button.

This is the signature of a function used to connect signals. It is usedby thegtk_builder_connect_signals() andgtk_builder_connect_signals_full()methods. It is mainly intended for interpreted language bindings, butcould be useful where the programmer wants more control over the signalconnection process. Note that this function can only be called once,subsequent calls will do nothing.

since: 2.12

This kind of functions provide Pango markup with detail information for thespecified day. Examples for such details are holidays or appointments. Thefunction returnsNULL when no information is available.

since: 2.14

The type of the callback functions used for e.g. iterating overthe children of a container, see gtk_container_foreach().

The type of the callback functions used for iterating over thecell renderers and their allocated areas inside aGtkCellArea,see gtk_cell_area_foreach_alloc().

The type of the callback functions used for iterating overthe cell renderers of aGtkCellArea, see gtk_cell_area_foreach().

A function which should set the value ofcell_layout’s cell renderer(s)as appropriate.

A function that will be called when the contents of the clipboard are changedor cleared. Once this has called, theuser_data_or_owner argumentwill 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 canbe determined from theinfo parameter or by checking the target fieldofselection_data. If the data could successfully be converted intothen it should be stored into theselection_data object bycallinggtk_selection_data_set() (or related functions suchas gtk_selection_data_set_text()). If no data is set, the requestorwill be informed that the attempt to get the data failed.

A function to be called when the results ofgtk_clipboard_request_image()are received, or when the request fails.

since: 2.6

A function to be called when the results ofgtk_clipboard_request_contents()are received, or when the request fails.

A function to be called when the results ofgtk_clipboard_request_rich_text() are received, or when the request fails.

since: 2.10

A function to be called when the results ofgtk_clipboard_request_targets()are received, or when the request fails.

since: 2.4

A function to be called when the results ofgtk_clipboard_request_text()are received, or when the request fails.

A function to be called when the results ofgtk_clipboard_request_uris() are received, or when the request fails.

since: 2.14

deprecated: 3.4 

deprecated: 3.4 since: 2.2

A function which decides whether the row indicated byiter matchesa givenkey, and should be displayed as a possible completion forkey.Note thatkey is normalized and case-folded (seeg_utf8_normalize()and g_utf8_casefold()). If this is not appropriate, match functionshave access to the unmodified key viagtk_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 aGListModel withgtk_flow_box_bind_model() for each item that gets added to the model.

since: 3.18

A function that will be called whenrever a child changesor is added. It lets you control if the child should bevisible or not.

since: 3.12

A function used by gtk_flow_box_selected_foreach().It will be called on every selected child of thebox.

since: 3.12

A function to compare two children to determine whichshould come first.

since: 3.12

The type of function that is used for deciding what fonts getshown in aGtkFontChooser. See gtk_font_chooser_set_filter_func().

A function used bygtk_icon_view_selected_foreach() to map allselected 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 aGListModel withgtk_list_box_bind_model() for each item that gets added to the model.

since: 3.16

Will be called whenever the row changes or is added and lets you controlif the row should be visible or not.

since: 3.10

A function used by gtk_list_box_selected_foreach().It will be called on every selected child of thebox.

since: 3.14

Compare two rows to determine which should be first.

since: 3.10

Wheneverrow changes or which row is beforerow changes thisis called, which lets you update the header onrow. You mayremove or set a new one viagtk_list_box_row_set_header() orjust change the state of the current header widget.

since: 3.10

A user function supplied when callinggtk_menu_attach_to_widget() whichwill be called when the menu is later detached from the widget.

A user function supplied when callinggtk_menu_popup() whichcontrols the positioning of the menu when it is displayed. Thefunction sets thex andy parameters to the coordinates where themenu is to be drawn. To make the menu appear on a differentmonitor than the mouse pointer,gtk_menu_set_monitor() must be called.

A multihead-awareGTK+ module may have agtk_module_display_init() functionwith this prototype.GTK+ calls this function for each opened display.

since: 2.2

EachGTK+ module must have a functiongtk_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 beenserialized with gtk_text_buffer_serialize(), and insert it atiter.

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().

since: 3.8

The function used to translate messages in e.g.GtkIconFactoryandGtkActionGroup.

deprecated: 3.10 

A function to set the properties of a cell instead of just using thestraight mapping between the cell and the model. This is useful forcustomizing the cell renderer. For example, a function might get aninteger from thetree_model, and render it to the “text” attribute of“cell” by converting it to its written equivalent. This is set bycalling gtk_tree_view_column_set_cell_data_func().

A GtkTreeIterCompareFunc should return a negative integer, zero, or a positiveinteger ifa sorts beforeb,a sorts withb, ora sorts afterbrespectively. If two iters compare as equal, their order in the sorted modelis undefined. In order to ensure that theGtkTreeSortable behaves asexpected, the GtkTreeIterCompareFunc must define a partial order onthe model, i.e. it must be reflexive, antisymmetric and transitive.

A function which calculates display values from raw values in the model.It must fillvalue with the display value for the columncolumn in therow indicated byiter.

A function which decides whether the row indicated byiter is visible.

Type of the callback passed togtk_tree_model_foreach() toiterate over the rows in a tree model.

A function used bygtk_tree_selection_selected_foreach() to map allselected rows. It will be called on every selected row in the view.

A function used bygtk_tree_selection_set_select_function() to filterwhether or not a row may be selected. It is called whenever a row’sstate might change. A return value ofTRUE indicates toselectionthat it is okay to change the selection.

Function type for determining whethercolumn can be dropped in aparticular spot (as determined byprev_column andnext_column). Inleft to right locales,prev_column is on the left of the potential dropspot, andnext_column is on the right. In right to left mode, this isreversed. This function should returnTRUE if the spot is a valid dropspot. Please note that returningTRUE does not actually indicate thatthe column drop was made, but is meant only to indicate a possible dropspot to the user.

Function used for gtk_tree_view_map_expanded_rows().

Function type for determining whether the row pointed to byiter shouldbe rendered as a separator. A common way to implement this is to have aboolean column in the model, whose values theGtkTreeViewRowSeparatorFuncreturns.

A function used for checking whether a row inmodel matchesa search key string entered by the user. Note the return valueis reversed from what you would normally expect, though ithas some similarity tostrcmp() returning 0 for equal strings.

Finds the first accelerator in anyGtkAccelGroup attachedtoobject that matchesaccel_key andaccel_mods, andactivates that accelerator.

Gets a list of all accel groups which are attached toobject.

Gets the modifier mask.

Converts an accelerator keyval and modifier mask into a stringwhich can be used to represent the accelerator to the user.

since: 2.6

Converts an accelerator keyval and modifier maskinto a (possibly translated) string that can be displayed toa user, similarly to gtk_accelerator_get_label(), but handling keycodes.

since: 3.4

Converts an accelerator keyval and modifier mask into a stringparseable by gtk_accelerator_parse(). For example, if you pass in

GDK_KEY_q and #GDK_CONTROL_MASK, this function returns “q”.

Converts an accelerator keyval and modifier maskinto a string parseable by gtk_accelerator_parse_with_keycode(),similarly togtk_accelerator_name() but handling keycodes.This is only useful for system-level components, applicationsshould usegtk_accelerator_parse() instead.

since: 3.4

Parses a string representing an accelerator. The format looks like<Control>a or<Shift><Alt>F1 or<Release>z (the last one isfor key release).

Parses a string representing an accelerator, similarly togtk_accelerator_parse() but handles keycodes as well. This is onlyuseful for system-level components, applications should usegtk_accelerator_parse() instead.

since: 3.4

Sets the modifiers that will be considered significant for keyboardaccelerators. The default mod mask depends on theGDK backend in use,but will typically include #GDK_CONTROL_MASK | #GDK_SHIFT_MASK |

GDK_MOD1_MASK | #GDK_SUPER_MASK | #GDK_HYPER_MASK | #GDK_META_MASK.

In other words, Control, Shift, Alt, Super, Hyper and Meta. Othermodifiers will by default be ignored byGtkAccelGroup.

Determines whether a given keyval and modifier mask constitutea valid keyboard accelerator. For example, the #GDK_KEY_a keyvalplus #GDK_CONTROL_MASK is valid - this is a “Ctrl+a” accelerator.But, you can’t, for instance, use the #GDK_KEY_Control_L keyvalas an accelerator.

ReturnsTRUE if dialogs are expected to use an alternativebutton order on the screenscreen. Seegtk_dialog_set_alternative_button_order() for more detailsabout alternative button order.

deprecated: 3.10 since: 2.6

Find a key binding matchingkeyval andmodifiers and activate thebinding onobject.

Looks up key bindings forobject to find one matchingevent, and if one was found, activate it.

since: 2.4

This function is supposed to be called inGtkWidget::drawimplementations for widgets that support multiple windows.cr must be untransformed from invoking of the draw function.This function will returnTRUE if the contents of the givenwindow are supposed to be drawn andFALSE otherwise. Notethat when the drawing was not initiated by the windowingsystem this function will returnTRUE for all windows, soyou need to draw the bottommost window first. Also, do notuse “else if” statements to check which window should be drawn.

since: 3.0

Transforms the given cairo contextcr that fromwidget-relativecoordinates towindow-relative coordinates.If thewidget’s window is not an ancestor ofwindow, nomodification will be applied.

since: 3.0

Checks that theGTK+ library in use is compatible with thegiven version. Generally you would pass in the constants

GTK_MAJOR_VERSION, #GTK_MINOR_VERSION, #GTK_MICRO_VERSION

as the three arguments to this function; that producesa check that the library in use is compatible withthe version ofGTK+ the application or module was compiled against.

Adds aGTK+ grab ondevice, so all the events ondevice and itsassociated pointer or keyboard (if any) are delivered towidget.If theblock_others parameter isTRUE, any other devices will beunable to interact withwidget during the grab.

since: 3.0

Removes a device grab from the given widget.

since: 3.0

Prevents gtk_init(), gtk_init_check(),gtk_init_with_args() andgtk_parse_args() from automaticallycallingsetlocale (LC_ALL, ""). You wouldwant to use this function if you wanted to set the locale foryour program to something other than the user’s locale, or ifyou wanted to set different values for different locale categories.

Distributesextra_space to childsizes by bringing smallerchildren up to natural size first.

Cancels an ongoing drag operation on the source side.

since: 3.16

Informs the drag source that the drop is finished, andthat the data of the drag will no longer be required.

Determines the source widget for a drag.

Sets the icon for a particular drag to the default icon.

Sets the icon for a given drag from the givenicon.See the documentation forgtk_drag_set_icon_name()for more details about using icons in drag and drop.

since: 3.2

Sets the icon for a given drag from a named themed icon. Seethe docs forGtkIconTheme for more details. Note that thesize of the icon depends on the icon theme (the icon isloaded at the symbolic size #GTK_ICON_SIZE_DND), thushot_x andhot_y have to be used with care.

since: 2.8

Setspixbuf as the icon for a given drag.

Sets the icon for a given drag from a stockID.

deprecated: 3.10 

Setssurface as the icon for a given drag.GTK+ retainsreferences for the arguments, and will release them whenthey are no longer needed.

Changes the icon for drag operation to a given widget.GTK+ will not destroy the widget, so if you don’t wantit to persist, you should connect to the “drag-end”signal and destroy it yourself.

Draws a text caret oncr atlocation. This is not a style functionbut merely a convenience function for drawing the standard cursor shape.

deprecated: 3.4 since: 3.0

Checks if any events are pending.

Analogical to gtk_true(), this function does nothingbut always returnsFALSE.

Returns the binary age as passed tolibtoolwhen building theGTK+ library the process is running against.Iflibtool means nothing to you, don’tworry about it.

since: 3.0

Obtains a copy of the event currently being processed byGTK+.

If there is a current event and it has a device, return thatdevice, otherwise returnNULL.

If there is a current event and it has a state field, placethat state field instate and returnTRUE, otherwise returnFALSE.

If there is a current event and it has a timestamp,return that timestamp, otherwise returnGDK_CURRENT_TIME.

Returns theGTK+ debug flags.

Returns thePangoLanguage for the default language currently ineffect. (Note that this can change over the life of anapplication.) The default language is derived from the currentlocale. It determines, for example, whetherGTK+ uses theright-to-left or left-to-right text direction.

Ifevent isNULL or the event was not associated with any widget,returnsNULL, otherwise returns the widget that received the event originally.

Returns the interface age as passed tolibtoolwhen building theGTK+ library the process is running against.Iflibtool means nothing to you, don’tworry about it.

since: 3.0

Get the direction of the current locale. This is the expectedreading direction for text andUI.

since: 3.12

Returns the major version number of theGTK+ library.(e.g. inGTK+ version 3.1.5 this is 3.).

since: 3.0

Returns the micro version number of theGTK+ library.(e.g. inGTK+ version 3.1.5 this is 5.).

since: 3.0

Returns the minor version number of theGTK+ library.(e.g. inGTK+ version 3.1.5 this is 1.).

since: 3.0

Returns aGOptionGroup for the commandline arguments recognizedbyGTK+ andGDK.

since: 2.6

Queries the current grab of the default window group.

Call this function before using any otherGTK+ functions in yourGUIapplications. It will initialize everything needed to operate thetoolkit and parses some standard command line options.

This function does the same work asgtk_init() with only a singlechange: It does not terminate the program if the commandlinearguments couldn’t be parsed or the windowing system can’t beinitialized. Instead it returnsFALSE on failure.

This function does the same work as gtk_init_check().Additionally, it allows you to add your own commandline options,and it automatically generates nicely formatted--help output. Note that your program willbe terminated after writing out the help output.

since: 2.6

Installs a key snooper function, which will get called on allkey events before delivering them normally.

deprecated: 3.4 

Removes the key snooper function with the given id.

deprecated: 3.4 

Runs the main loop untilgtk_main_quit() is called.

Processes a singleGDK event.

Runs a single iteration of the mainloop.

Runs a single iteration of the mainloop.If no events are available either return or block depending onthe value ofblocking.

Asks for the current nesting level of the main loop.

Makes the innermost invocation of the main loop returnwhen it regains control.

Draws an arrow in the given rectangle oncr using the givenparameters.arrow_type determines the direction of the arrow.

deprecated: 3.0 

Draws a box oncr with the given parameters.

deprecated: 3.0 

Draws a box incr using the given style and state and shadow type,leaving a gap in one side.

deprecated: 3.0 

Draws a check button indicator in the given rectangle oncr withthe given parameters.

deprecated: 3.0 

Draws a diamond in the given rectangle onwindow using the given parameters.

deprecated: 3.0 

Draws an expander as used inGtkTreeView.x andy specify thecenter the expander. The size of the expander is determined by the“expander-size” style property ofwidget. (If widget is notspecified or doesn’t have an “expander-size” property, anunspecified default size will be used, since the caller doesn’thave sufficient information to position the expander, this islikely not useful.) The expander is expander_size pixels tallin the collapsed position and expander_size pixels wide in theexpanded position.

deprecated: 3.0 

Draws an extension, i.e. a notebook tab.

deprecated: 3.0 

Draws a flat box oncr with the given parameters.

deprecated: 3.0 

Draws a focus indicator around the given rectangle oncr using thegiven style.

deprecated: 3.0 

Draws a handle as used inGtkHandleBox andGtkPaned.

deprecated: 3.0 

Draws a horizontal line from (x1,y) to (x2,y) incrusing the given style and state.

deprecated: 3.0 

Draws a layout oncr using the given parameters.

deprecated: 3.0 

Draws a radio button indicator in the given rectangle oncr withthe given parameters.

deprecated: 3.0 

Draws a resize grip in the given rectangle oncr using the given parameters.

deprecated: 3.0 

Draws a shadow around the given rectangle incrusing the given style and state and shadow type.

deprecated: 3.0 

Draws a shadow around the given rectangle incrusing the given style and state and shadow type, leaving agap in one side.

deprecated: 3.0 

Draws a slider in the given rectangle oncr using thegiven style and orientation.

deprecated: 3.0 

Draws a spinner onwindow using the given parameters.

deprecated: 3.0 

Draws an option menu tab (i.e. the up and down pointing arrows)in the given rectangle oncr using the given parameters.

deprecated: 3.0 

Draws a vertical line from (x,y1_) to (x,y2_) incrusing the given style and state.

deprecated: 3.0 

Parses command line arguments, and initializes globalattributes ofGTK+, but does not actually open a connectionto a display. (See gdk_display_open(), gdk_get_display_arg_name()).

Runs a page setup dialog, letting the user modify the values frompage_setup. If the user cancels the dialog, the returnedGtkPageSetupis identical to the passed inpage_setup, otherwise it contains themodifications done in the dialog.

since: 2.10

Runs a page setup dialog, letting the user modify the values frompage_setup.

since: 2.10

Sends an event to a widget, propagating the event to parent widgetsif the event remains unhandled.

Adds a file to the list of files to be parsed at theend of gtk_init().

deprecated: 3.0 

Searches for a theme engine in theGTK+ search path. This functionis not useful for applications and should not be used.

deprecated: 3.0 

Looks up a file in pixmap path for the specifiedGtkSettings.If the file is not found, it outputs a warning message usingg_warning() and returnsNULL.

deprecated: 3.0 

Retrieves the current list ofRC files that will be parsedat the end of gtk_init().

deprecated: 3.0 

Obtains the path to theIM modules file. See the documentationof theGTK_IM_MODULE_FILEenvironment variable for more details.

deprecated: 3.0 

Obtains the path in which to look forIM modules. See the documentationof theGTK_PATHenvironment variable for more details about looking up modules. Thisfunction is useful solely for utilities supplied withGTK+ and shouldnot be used by applications under normal circumstances.

deprecated: 3.0 

Returns a directory in whichGTK+ looks for theme engines.For full information about the search for theme engines,see the docs forGTK_PATH in [RunningGTK+ Applications][gtk-running].

deprecated: 3.0 

Finds all matchingRC styles for a given widget,composites them together, and then creates aGtkStyle representing the composite appearance.(GTK+ actually keeps a cache of previouslycreated styles, so a new style may not be created.).

deprecated: 3.0 

Creates up aGtkStyle from styles defined in aRC file by providingthe raw components used in matching. This function may be usefulwhen creating pseudo-widgets that should be themed like widgets butdon’t actually have correspondingGTK+ widgets. An example of thiswould be items inside aGNOME canvas widget.

deprecated: 3.0 

Returns the standard directory in which themes shouldbe installed. (GTK+ does not actually use this directory itself.).

deprecated: 3.0 

Parses a given resource file.

deprecated: 3.0 

Parses a color in the format expectedin aRC file.

deprecated: 3.0 

Parses a color in the format expectedin aRC file. Ifstyle is notNULL, it will be consulted to resolvereferences to symbolic colors.

deprecated: 3.0 since: 2.12

Parses aGtkPathPriorityType variable from the format expectedin aRC file.

deprecated: 3.0 

Parses aGtkStateType variable from the format expectedin aRC file.

deprecated: 3.0 

Parses resource information directly from a string.

deprecated: 3.0 

If the modification time on any previously read file for thedefaultGtkSettings has changed, discard all style informationand then reread all previously readRC files.

deprecated: 3.0 

If the modification time on any previously read filefor the givenGtkSettings has changed, discard all style informationand then reread all previously readRC files.

deprecated: 3.0 

This function recomputes the styles for all widgets that use aparticularGtkSettings object. (There is oneGtkSettings objectperGdkScreen, see gtk_settings_get_for_screen()); It is usefulwhen some global parameter has changed that affects the appearanceof all widgets, because when a widget gets a new style, it willboth redraw and recompute any cached information about itsappearance. As an example, it is used when the default font sizeset by the operating system changes. Note that this functiondoesn’t affect widgets that have a style set explicitly on themwith gtk_widget_set_style().

deprecated: 3.0 since: 2.4

deprecated: 3.0 

Sets the list of files thatGTK+ will read at theend of gtk_init().

deprecated: 3.0 

Renders an activity indicator (such as inGtkSpinner).The stateGTK_STATE_FLAG_CHECKED determines whether there isactivity going on.

since: 3.0

Renders an arrow pointing toangle.

since: 3.0

Renders the background of an element.

since: 3.0

Returns the area that will be affected (i.e. drawn to) whencallinggtk_render_background() for the givencontext and rectangle.

since: 3.20

Renders a checkmark (as in aGtkCheckButton).

since: 3.0

Renders an expander (as used inGtkTreeView andGtkExpander) in the areadefined byx,y,width,height. The stateGTK_STATE_FLAG_CHECKEDdetermines whether the expander is collapsed or expanded.

since: 3.0

Renders a extension (as in aGtkNotebook tab) in the rectangledefined byx,y,width,height. The side where the extensionconnects to is defined bygap_side.

since: 3.0

Renders a focus indicator on the rectangle determined byx,y,width,height.

since: 3.0

Renders a frame around the rectangle defined byx,y,width,height.

since: 3.0

Renders a frame around the rectangle defined by (x,y,width,height),leaving a gap on one side.xy0_gap andxy1_gap will mean X coordinatesforGTK_POS_TOP andGTK_POS_BOTTOM gap sides, and Y coordinates forGTK_POS_LEFT andGTK_POS_RIGHT.

deprecated: 3.24 since: 3.0

Renders a handle (as inGtkHandleBox,GtkPaned andGtkWindow’s resize grip), in the rectangledetermined byx,y,width,height.

since: 3.0

Renders the icon inpixbuf at the specifiedx andy coordinates.

since: 3.2

Renders the icon specified bysource at the givensize, returning the resultin a pixbuf.

deprecated: 3.10 since: 3.0

Renders the icon insurface at the specifiedx andy coordinates.

since: 3.10

Draws a text caret oncr at the specified index oflayout.

since: 3.4

Renderslayout on the coordinatesx,y.

since: 3.0

Renders a line from (x0, y0) to (x1, y1).

since: 3.0

Renders an option mark (as in aGtkRadioButton), theGTK_STATE_FLAG_CHECKEDstate will determine whether the option is on or off, andGTK_STATE_FLAG_INCONSISTENT whether it should be marked as undefined.

since: 3.0

Renders a slider (as inGtkScale) in the rectangle defined byx,y,width,height.orientation defines whether the slider is verticalor horizontal.

since: 3.0

Converts a color fromRGB space toHSV.

since: 2.14

Appends a specified target to the list of supported targets for agiven widget and selection.

Prepends a table of targets to the list of supported targetsfor a given widget and selection.

Remove all targets registered for the given selection for the widget.

Requests the contents of a selection. When received,a “selection-received” signal will be generated.

Claims ownership of a given selection for a particular widget,or, ifwidget isNULL, release ownership of the selection.

Claim ownership of a given selection for a particular widget, or,ifwidget isNULL, release ownership of the selection.

since: 2.2

Removes all handlers and unsets ownership of allselections for a widget. Called when widget is beingdestroyed. This function will not generally becalled by applications.

Sets theGTK+ debug flags.

This is a convenience function for showing an application’s about box.The constructed dialog is associated with the parent window andreused for future invocations of this function.

since: 2.6

A convenience function for launching the default applicationto show the uri. Like gtk_show_uri_on_window(), but takes a screenas transient parent instead of a window.

deprecated: 3.22 since: 2.14

This is a convenience function for launching the default applicationto show the uri. The uri must be of a form understood byGIO (i.e. youneed to install gvfs to get support for uri schemes such as http://or ftp://, as only local files are handled byGIO itself).Typical examples are-file:///home/gnome/pict.jpg-http://www.gnome.org-mailto:me@gnome.org.

since: 3.22

Registers each of the stock items initems. If an item alreadyexists with the same stockID as one of theitems, the old itemgets replaced. The stock items are copied, soGTK+ does not holdany pointer intoitems anditems can be freed. Usegtk_stock_add_static() ifitems is persistent andGTK+ need notcopy the array.

deprecated: 3.10 

Same as gtk_stock_add(), but doesn’t copyitems, soitems must persist until application exit.

deprecated: 3.10 

Retrieves a list of all known stock IDs added to aGtkIconFactoryor registered with gtk_stock_add(). The list must be freed with g_slist_free(),and each string in the list must be freed with g_free().

deprecated: 3.10 

Fillsitem with the registered values forstock_id, returningTRUEifstock_id was known.

deprecated: 3.10 

Sets a function to be used for translating thelabel ofa stock item.

deprecated: 3.10 since: 2.8

This function frees a target table as returned by gtk_target_table_new_from_list().

since: 2.10

This function creates anGtkTargetEntry array that contains thesame targets as the passed %list. The returned table is newlyallocated and should be freed usinggtk_target_table_free() when nolonger needed.

since: 2.10

Determines if any of the targets intargets can be used toprovide aGdkPixbuf.

since: 2.10

Determines if any of the targets intargets can be used toprovide rich text.

since: 2.10

Determines if any of the targets intargets can be used toprovide text.

since: 2.10

Determines if any of the targets intargets can be used toprovide an uri list.

since: 2.10

Create a simple window with window titlewindow_title andtext contentsdialog_text.The window will quit any running gtk_main()-loop when destroyed, and itwill automatically be destroyed upon test function teardown.

deprecated: 3.20 since: 2.14

This function wrapsg_object_new() for widget types.It’ll automatically show all created non window widgets, alsog_object_ref_sink() them (to keep them alive across a running test)and set them up for destruction during the next test teardown phase.

deprecated: 3.20 since: 2.14

Create a window with window titlewindow_title, text contentsdialog_text,and a number of buttons, according to the paired argument list givenas @… parameters.Each button is created with alabel and a ::clicked signal handler thatincremrents the integer stored innump.The window will be automatically shown withgtk_widget_show_now() aftercreation, so when this function returns it has already been mapped,resized and positioned on screen.The window will quit any running gtk_main()-loop when destroyed, and itwill automatically be destroyed upon test function teardown.

deprecated: 3.20 since: 2.14

This function will searchwidget and all its descendants for a GtkLabelwidget with a text string matchinglabel_pattern.Thelabel_pattern may contain asterisks “*” and question marks “?” asplaceholders,g_pattern_match() is used for the matching.Note that locales other than “C“ tend to alter (translate” label strings,so this function is genrally only useful in test programs withpredetermined locales, seegtk_test_init() for more details.

since: 2.14

This function will search siblings ofbase_widget and siblings of itsancestors for all widgets matchingwidget_type.Of the matching widgets, the one that is geometrically closest tobase_widget will be returned.The general purpose of this function is to find the most likely “action”widget, relative to another labeling widget. Such as finding abutton or text entry widget, given its corresponding label widget.

since: 2.14

This function will search the descendants ofwidget for a widgetof typewidget_type that has a label matchinglabel_pattern nextto it. This is most useful for automatedGUI testing, e.g. to findthe “OK” button in a dialog and synthesize clicks on it.However see gtk_test_find_label(),gtk_test_find_sibling() andgtk_test_widget_click() for possible caveats involving the search ofsuch widgets and synthesizing widget events.

since: 2.14

This function is used to initialize aGTK+ test program.

since: 2.14

Return the type ids that have been registered aftercalling gtk_test_register_all_types().

since: 2.14

Force registration of all core Gtk+ and Gdk object types.This allowes to refer to any of those object types viag_type_from_name() after calling this function.

since: 2.14

Retrive the literal adjustment value for GtkRange basedwidgets and spin buttons. Note that the value returned bythis function is anything between the lower and upper boundsof the adjustment belonging towidget, and is not a percentageas passed in to gtk_test_slider_set_perc().

deprecated: 3.20 since: 2.14

This function will adjust the slider position of all GtkRangebased widgets, such as scrollbars or scales, it’ll also adjustspin buttons. The adjustment value of these widgets is set toa value between the lower and upper limits, according to thepercentage argument.

deprecated: 3.20 since: 2.14

This function will generate abutton click in the upwards or downwardsspin button arrow areas, usually leading to an increase or decrease ofspin button’s value.

deprecated: 3.20 since: 2.14

Retrive the text string ofwidget if it is a GtkLabel,GtkEditable (entry and text widgets) or GtkTextView.

deprecated: 3.20 since: 2.14

Set the text string ofwidget tostring if it is a GtkLabel,GtkEditable (entry and text widgets) or GtkTextView.

deprecated: 3.20 since: 2.14

This function will generate abutton click (button press and buttonrelease event) in the middle of the first GdkWindow found that belongstowidget.For windowless widgets likeGtkButton (which returnsFALSE fromgtk_widget_get_has_window()), this will often be aninput-only event window. For other widgets, this is usually widget->window.Certain caveats should be considered when using this function, inparticular because the mouse pointer is warped to the button clicklocation, seegdk_test_simulate_button() for details.

deprecated: 3.20 since: 2.14

This function will generate keyboard press and release events inthe middle of the first GdkWindow found that belongs towidget.For windowless widgets likeGtkButton (which returnsFALSE fromgtk_widget_get_has_window()), this will often be aninput-only event window. For other widgets, this is usually widget->window.Certain caveats should be considered when using this function, inparticular because the mouse pointer is warped to the key presslocation, seegdk_test_simulate_key() for details.

since: 2.14

Enters the main loop and waits forwidget to be “drawn”. In thiscontext that means it waits for the frame clock ofwidget to haverun a full styling, layout and drawing cycle.

since: 3.10

Obtains atree_model andpath from selection data of target typeGTK_TREE_MODEL_ROW. Normally called from a drag_data_received handler.This function can only be used ifselection_data originates from the sameprocess that’s calling this function, because a pointer to the tree modelis being passed around. If you aren’t in the same process, then you’llget memory corruption. In theGtkTreeDragDest drag_data_received handler,you can assume that selection data of typeGTK_TREE_MODEL_ROW isin from the current process. The returned path must be freed with gtk_tree_path_free().

Sets selection data of target typeGTK_TREE_MODEL_ROW. Normally usedin a drag_data_get handler.

All this function does it to returnTRUE.

This macro should be used to emit a warning about and unexpectedtype valuein aGtkBuildable add_child implementation.

This macro should be used to emit a standard warning about unexpectedproperties inset_cell_property() andget_cell_property() implementations.

ReturnsTRUE if the version of theGTK+ header filesis the same as or newer than the passed-in version.

This macro should be used to emit a standard warning about unexpectedproperties inset_child_property() andget_child_property() implementations.

Binds a callback function defined in a template to thewidget_class.

since: 3.10

Binds a child widget defined in a template to thewidget_class.

since: 3.10

Binds a child widget defined in a template to thewidget_class, andalso makes it available as an internal child in GtkBuilder, under thenamemember_name.

since: 3.10

Binds a child widget defined in a template to thewidget_class, andalso makes it available as an internal child in GtkBuilder, under thenamemember_name.

since: 3.10

Binds a child widget defined in a template to thewidget_class.

since: 3.10

Like gtk_get_binary_age(), but from the headers used atapplication compile time, rather than from the library linkedagainst at application run time.

Constant to return from a signal handler for theGtkSpinButton::inputsignal in case of conversion failure.

Like gtk_get_interface_age(), but from the headers used atapplication compile time, rather than from the library linkedagainst at application run time.

The name used for the stock full offset included byGtkLevelBar.

The name used for the stock high offset included byGtkLevelBar.

The name used for the stock low offset included byGtkLevelBar.

Like gtk_get_major_version(), but from the headers used atapplication compile time, rather than from the library linkedagainst at application run time.

The maximum length of sequences in compose tables.

Like gtk_get_micro_version(), but from the headers used atapplication compile time, rather than from the library linkedagainst at application run time.

Like gtk_get_minor_version(), but from the headers used atapplication compile time, rather than from the library linkedagainst 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 filename of the output without the path to the directory and thefile extension.

The key used by the “Print to file” printer to store thedirectory to which the output should be written.

The key used by the “Print to file” printer to store the formatof the output. The supported values are “PS” and “PDF”.

The key used by the “Print to file” printer to store theURIto which the output should be written.GTK+ itself supportsonly “file://” URIs.

Use this priority for functionality related to size allocation.

The “About” item..

deprecated: 3.10 

The “Add” item and icon.

deprecated: 3.10 

The “Apply” item and icon.

deprecated: 3.10 

The “Bold” item and icon.

deprecated: 3.10 

The “Cancel” item and icon.

deprecated: 3.10 

The “Caps Lock Warning” icon.

deprecated: 3.10 

The “CD-Rom” item and icon.

deprecated: 3.10 

The “Clear” item and icon.

deprecated: 3.10 

The “Close” item and icon.

deprecated: 3.10 

The “Color Picker” item and icon.

deprecated: 3.10 

The “Connect” icon.

deprecated: 3.10 

The “Convert” item and icon.

deprecated: 3.10 

The “Copy” item and icon.

deprecated: 3.10 

The “Cut” item and icon.

deprecated: 3.10 

The “Delete” item and icon.

deprecated: 3.10 

The “Authentication” item and icon.

deprecated: 3.10 

The “Error” item and icon.

deprecated: 3.10 

The “Information” item and icon.

deprecated: 3.10 

The “Question” item and icon.

deprecated: 3.10 

The “Warning” item and icon.

deprecated: 3.10 

The “Directory” icon.

deprecated: 3.10 

The “Discard” item.

deprecated: 3.10 

The “Disconnect” icon.

deprecated: 3.10 

The “Drag-And-Drop” icon.

deprecated: 3.10 

The “Drag-And-Drop multiple” icon.

deprecated: 3.10 

The “Edit” item and icon.

deprecated: 3.10 

The “Execute” item and icon.

deprecated: 3.10 

The “File” item and icon.

deprecated: 3.10 

The “Find” item and icon.

deprecated: 3.10 

The “Find and Replace” item and icon.

deprecated: 3.10 

The “Floppy” item and icon.

deprecated: 3.10 

The “Fullscreen” item and icon.

deprecated: 3.10 

The “Back” item and icon. The icon has anRTL variant.

deprecated: 3.10 

The “Down” item and icon.

deprecated: 3.10 

The “Forward” item and icon. The icon has anRTL variant.

deprecated: 3.10 

The “Up” item and icon.

deprecated: 3.10 

The “Bottom” item and icon.

deprecated: 3.10 

The “First” item and icon. The icon has anRTL variant.

deprecated: 3.10 

The “Last” item and icon. The icon has anRTL variant.

deprecated: 3.10 

The “Top” item and icon.

deprecated: 3.10 

The “Harddisk” item and icon.

deprecated: 3.10 

The “Help” item and icon.

deprecated: 3.10 

The “Home” item and icon.

deprecated: 3.10 

The “Indent” item and icon. The icon has anRTL variant.

deprecated: 3.10 

The “Index” item and icon.

deprecated: 3.10 

The “Info” item and icon.

deprecated: 3.10 

The “Italic” item and icon.

deprecated: 3.10 

The “Jump to” item and icon. The icon has anRTL variant.

deprecated: 3.10 

The “Center” item and icon.

deprecated: 3.10 

The “Fill” item and icon.

deprecated: 3.10 

The “Left” item and icon.

deprecated: 3.10 

The “Right” item and icon.

deprecated: 3.10 

The “Leave Fullscreen” item and icon.

deprecated: 3.10 

The “Media Forward” item and icon. The icon has anRTL variant.

deprecated: 3.10 

The “Media Next” item and icon. The icon has anRTL variant.

deprecated: 3.10 

The “Media Pause” item and icon.

deprecated: 3.10 

The “Media Play” item and icon. The icon has anRTL variant.

deprecated: 3.10 

The “Media Previous” item and icon. The icon has anRTL variant.

deprecated: 3.10 

The “Media Record” item and icon.

deprecated: 3.10 

The “Media Rewind” item and icon. The icon has anRTL variant.

deprecated: 3.10 

The “Media Stop” item and icon.

deprecated: 3.10 

The “Missing image” icon.

deprecated: 3.10 

The “Network” item and icon.

deprecated: 3.10 

The “New” item and icon.

deprecated: 3.10 

The “No” item and icon.

deprecated: 3.10 

The “OK” item and icon.

deprecated: 3.10 

The “Open” item and icon.

deprecated: 3.10 

The “Landscape Orientation” item and icon.

deprecated: 3.10 

The “Portrait Orientation” item and icon.

deprecated: 3.10 

The “Reverse Landscape Orientation” item and icon.

deprecated: 3.10 

The “Reverse Portrait Orientation” item and icon.

deprecated: 3.10 

The “Page Setup” item and icon.

deprecated: 3.10 

The “Paste” item and icon.

deprecated: 3.10 

The “Preferences” item and icon.

deprecated: 3.10 

The “Print” item and icon.

deprecated: 3.10 

The “Print Error” icon.

deprecated: 3.10 

The “Print Paused” icon.

deprecated: 3.10 

The “Print Preview” item and icon.

deprecated: 3.10 

The “Print Report” icon.

deprecated: 3.10 

The “Print Warning” icon.

deprecated: 3.10 

The “Properties” item and icon.

deprecated: 3.10 

The “Quit” item and icon.

deprecated: 3.10 

The “Redo” item and icon. The icon has anRTL variant.

deprecated: 3.10 

The “Refresh” item and icon.

deprecated: 3.10 

The “Remove” item and icon.

deprecated: 3.10 

The “Revert” item and icon. The icon has anRTL variant.

deprecated: 3.10 

The “Save” item and icon.

deprecated: 3.10 

The “Save As” item and icon.

deprecated: 3.10 

The “Select All” item and icon.

deprecated: 3.10 

The “Color” item and icon.

deprecated: 3.10 

The “Font” item and icon.

deprecated: 3.10 

The “Ascending” item and icon.

deprecated: 3.10 

The “Descending” item and icon.

deprecated: 3.10 

The “Spell Check” item and icon.

deprecated: 3.10 

The “Stop” item and icon.

deprecated: 3.10 

The “Strikethrough” item and icon.

deprecated: 3.10 

The “Undelete” item and icon. The icon has anRTL variant.

deprecated: 3.10 

The “Underline” item and icon.

deprecated: 3.10 

The “Undo” item and icon. The icon has anRTL variant.

deprecated: 3.10 

The “Unindent” item and icon. The icon has anRTL variant.

deprecated: 3.10 

The “Yes” item and icon.

deprecated: 3.10 

The “Zoom 100%” item and icon.

deprecated: 3.10 

The “Zoom to Fit” item and icon.

deprecated: 3.10 

The “Zoom In” item and icon.

deprecated: 3.10 

The “Zoom Out” item and icon.

deprecated: 3.10 

ACSS class to match an accelerator.

ACSS class used when rendering an arrow element.

ACSS class to match the window background.

ACSS class to indicate an area at the bottom of a widget.

ACSS class to match buttons.

ACSS class to match calendars.

ACSS class to match content rendered in cell views.

ACSS class to match check boxes.

ACSS class to match combobox entries.

ACSS class to match context menus.

ACSS class that gets added to windows which have client-side decorations.

ACSS class used when rendering a drag handle fortext selection.

ACSS class to match the default widget.

ACSS class used when an action (usually a button) isone that is expected to remove or destroy something visibleto the user.

ACSS class to match dimmed labels.

ACSS class for a drag-and-drop indicator.

ACSS class defining a dock area.

ACSS class to match text entries.

ACSS class for an area displaying an error message,such as those in infobars.

ACSS class defining an expander, such as those in treeviews.

ACSS class that is added when widgets that usually havea frame or border (like buttons or entries) should appearwithout it.

ACSS class defining a frame delimiting content, such asGtkFrame or the scrolled window frame around thescrollable area.

ACSS class defining a resize grip.

ACSS class to match a header element.

ACSS class defining a highlighted area, such as headings inassistants and calendars.

ACSS class for horizontally layered widgets.

ACSS class defining an image, such as the icon in an entry.

ACSS class for an area displaying an informational message,such as those in infobars.

ACSS class to match inline toolbars.

ACSS class used when rendering a drag handle forthe insertion cursor position.

ACSS class to match labels.

ACSS class to indicate an area at the left of a widget.

ACSS class used when rendering a level indicator, suchas a battery charge level, or a password strength.

ACSS class to match a linked area, such as a box containing buttonsbelonging to the same control.

ACSS class to match lists.

ACSS class to match list rows.

ACSS class defining marks in a widget, such as in scales.

ACSS class to match menus.

ACSS class to menubars.

ACSS class to match menu items.

ACSS class that is added to message dialogs.

ACSS class that is added to text view that should usea monospace font.

ACSS class used when an element needs the user attention,for instance a button in a stack switcher corresponding toa hidden page that changed state.

ACSS class defining a notebook.

ACSS class used when rendering anOSD (On Screen Display) element,on top of another container.

ACSS class that is added on the visual hints that happenwhen scrolling is attempted past the limits of a scrollable area.

ACSS class for a pane separator, such as those inGtkPaned.

ACSS class that is added to areas that should look like paper.

ACSS class that matches popovers.

ACSS class that is added to the toplevel windows used for menus.

ACSS class to match primary toolbars.

ACSS class to use when rendering activity as a progressbar.

ACSS class to use when rendering a pulse in an indeterminate progress bar.

ACSS class for an area displaying a question to the user,such as those in infobars.

ACSS class to match radio buttons.

ACSS class to match a raised control, such as a raisedbutton on a toolbar.

ACSS class used to indicate a read-only state.

ACSS class to indicate an area at the right of a widget.

ACSS class to match the rubberband selection rectangle.

ACSS class to match scale widgets.

ACSS class to match scale widgets with marks attached,all the marks are above for horizontalGtkScale.left for verticalGtkScale.

ACSS class to match scale widgets with marks attached,all the marks are below for horizontalGtkScale,right for verticalGtkScale.

ACSS class to match scrollbars.

ACSS class to match the junction area between an horizontaland vertical scrollbar, when they’re both shown.

ACSS class for a separator.

ACSS class defining a sidebar, such as the left side ina file chooser.

ACSS class to match sliders.

ACSS class defining an spinbutton.

ACSS class to use when rendering activity as a “spinner”.

ACSS class to match statusbars.

ACSS class used for the subtitle label in a titlebar ina toplevel window.

ACSS class used when an action (usually a button) is theprimary suggested action in a specific context.

ACSS class used for the title label in a titlebar ina toplevel window.

ACSS class used when rendering a titlebar in a toplevel window.

ACSS class to match toolbars.

ACSS class to match tooltip windows.

ACSS class to indicate an area at the top of a widget.

ACSS class for touch selection popups on entriesand text views.

ACSS class to match troughs, as in scrollbars and progressbars.

ACSS class that is added on the visual hints that happenwhere content is ‘scrolled off’ and can be made visibleby scrolling.

ACSS class for vertically layered widgets.

ACSS class defining a view, such as iconviews or treeviews.

ACSS class for an area displaying a warning message,such as those in infobars.

ACSS class to indicate that aUI element should be ‘wide’.Used byGtkPaned.

A property holding the background color of rendered elements as aGdkRGBA.

A property holding the element’s background as a #cairo_pattern_t.

A property holding the element’s border color as aGdkRGBA.

A property holding the rendered element’s border radius in pixels as a #gint.

A property holding the element’s border style as aGtkBorderStyle.

A property holding the rendered element’s border width in pixels asaGtkBorder. The border is the intermediary spacing property of thepadding/border/margin series.

A property holding the foreground color of rendered elements as aGdkRGBA.

A property holding the font properties used when rendering textas aPangoFontDescription.

A property holding the rendered element’s margin as aGtkBorder. Themargin is defined as the spacing between the border of the elementand its surrounding elements. It is external toGtkWidget‘ssize allocations, and the most external spacing property of thepadding/border/margin series.

A property holding the rendered element’s padding as aGtkBorder. Thepadding is defined as the spacing between the inner part of the element borderand its child. It’s the innermost spacing property of the padding/border/margin series.

A priority that can be used when adding aGtkStyleProviderfor application-specific style information.

The priority used for default style informationthat is used in the absence of themes.

The priority used for style information providedviaGtkSettings.

The priority used for style information providedby themes.

The priority used for the style information fromXDG_CONFIG_HOME/gtk-3.0/gtk.css.

A widget region name to define a treeview column.

deprecated: 3.20 

A widget region name to define a treeview column header.

deprecated: 3.20 

A widget region name to define a treeview row.

deprecated: 3.20 

A widget region name to define a notebook tab.

deprecated: 3.20 

The priority at which the text view validates onscreen linesin an idle job in the background.

The GTK_TREE_SORTABLE_DEFAULT_SORT_COLUMN_ID can be used to make aGtkTreeSortable use the default sort function.

The GTK_TREE_SORTABLE_DEFAULT_SORT_COLUMN_ID can be used to make aGtkTreeSortable use no sorting.