Crate gtk4

Expand description

§Rust GTK 4 bindings

The project website is here.

Rust bindings of GTK 4, part of gtk4-rs.

This library contains safe Rust bindings for GTK 4, a multi-platform GUI toolkit. It is a part of gtk-rs.

Most of this documentation is generated from the C API. Until all parts of the documentation have been reviewed there will be incongruities with the actual Rust API.

For a gentle introduction to gtk-rs we recommend the online book GUI development with Rust and GTK 4.

§Minimum supported Rust version

Currently, the minimum supported Rust version is 1.83.

§“Hello, World!” example program

GTK needs to be initialized before use by calling init. Creating an Application will call init for you.

The gtk4 crate is usually renamed to gtk. You can find an example in the features section for how to do this globally in your Cargo.toml.

use gtk4 as gtk;
use gtk::prelude::*;
use gtk::{glib, Application, ApplicationWindow};

fn main() -> glib::ExitCode {
    let app = Application::builder()
        .application_id("org.example.HelloWorld")
        .build();

    app.connect_activate(|app| {
        // We create the main window.
        let window = ApplicationWindow::builder()
            .application(app)
            .default_width(320)
            .default_height(200)
            .title("Hello, World!")
            .build();

        // Show the window.
        window.present();
    });

    app.run()
}

§The main loop

In a typical GTK application you set up the UI, assign signal handlers and run the main event loop.

use gtk4 as gtk;
use gtk::prelude::*;
use gtk::{glib, Application, ApplicationWindow, Button};

fn main() -> glib::ExitCode {
    let application = Application::builder()
        .application_id("com.example.FirstGtkApp")
        .build();

    application.connect_activate(|app| {
        let window = ApplicationWindow::builder()
            .application(app)
            .title("First GTK Program")
            .default_width(350)
            .default_height(70)
            .build();

        let button = Button::with_label("Click me!");
        button.connect_clicked(|_| {
            eprintln!("Clicked!");
        });
        window.set_child(Some(&button));

        window.present();
    });

    application.run()
}

§Threads

GTK is not thread-safe. Accordingly, none of this crate’s structs implement Send or Sync.

The thread where init was called is considered the main thread. OS X has its own notion of the main thread and init must be called on that thread. After successful initialization, calling any gtk or gdk functions (including init) from other threads will panic.

Any thread can schedule a closure to be run by the main loop on the main thread via glib::idle_add or glib::timeout_add. While working with GTK you might need the glib::idle_add_local or glib::timeout_add_local version without the Send bound. Those may only be called from the main thread.

§Panics

The gtk and gdk crates have some run-time safety and contract checks.

Any constructor or free function will panic if called before init or on a non-main thread.
Any &str or &Path parameter with an interior null (\0) character will cause a panic.
Some functions will panic if supplied out-of-range integer parameters. All such cases will be documented individually but they are not yet.
A panic in a closure that handles signals or in any other closure passed to a gtk function will abort the process.

§Features

§Library versions

By default this crate provides only GTK 4.0 APIs. You can access additional functionality by selecting one of the v4_2, v4_4, etc. features.

Cargo.toml example:

[dependencies.gtk]
package = "gtk4"
version = "0.x.y"
features = ["v4_2"]

Take care when choosing the version to target: some of your users might not have easy access to the latest ones. The higher the version, the fewer users will have it installed.

§Documentation

§Using

We recommend using crates from crates.io, as demonstrated here.

If you want to track the bleeding edge, use the git dependency instead:

[dependencies]
gtk = { git = "https://github.com/gtk-rs/gtk4-rs.git", package = "gtk4" }

Avoid mixing versioned and git crates like this:

# This will not compile
[dependencies]
gdk = {version = "0.1", package = "gdk4"}
gtk = { git = "https://github.com/gtk-rs/gtk4-rs.git", package = "gtk4" }

§Features

Feature	Description
`v4_20`	Enable the new APIs part of GTK 4.20
`v4_18`	Enable the new APIs part of GTK 4.18
`v4_16`	Enable the new APIs part of GTK 4.16
`v4_14`	Enable the new APIs part of GTK 4.14
`v4_12`	Enable the new APIs part of GTK 4.12
`v4_10`	Enable the new APIs part of GTK 4.10
`v4_8`	Enable the new APIs part of GTK 4.8
`v4_6`	Enable the new APIs part of GTK 4.6
`v4_4`	Enable the new APIs part of GTK 4.4
`v4_2`	Enable the new APIs part of GTK 4.2
`gnome_49`	Enable all version feature flags of this crate and its dependencies to match the GNOME 49 SDK
`gnome_48`	Enable all version feature flags of this crate and its dependencies to match the GNOME 48 SDK
`gnome_47`	Enable all version feature flags of this crate and its dependencies to match the GNOME 47 SDK
`gnome_46`	Enable all version feature flags of this crate and its dependencies to match the GNOME 46 SDK
`gnome_45`	Enable all version feature flags of this crate and its dependencies to match the GNOME 45 SDK
`gnome_44`	Enable all version feature flags of this crate and its dependencies to match the GNOME 44 SDK
`gnome_43`	Enable all version feature flags of this crate and its dependencies to match the GNOME 43 SDK
`gnome_42`	Enable all version feature flags of this crate and its dependencies to match the GNOME 42 SDK
`unsafe-assume-initialized`	Disable checks that gtk is initialized, for use in C ABI libraries
`xml_validation`	Enable `xml_validation` feature of gtk4-macros
`blueprint`	Enable `blueprint` feature of gtk4-macros

§See Also

§License

The Rust bindings of gtk4 are available under the MIT License, please refer to it.

Re-exports§

pub use subclass::widget::TemplateChild;
pub use cairo;
pub use gdk;
pub use gdk_pixbuf;
pub use gio;
pub use glib;
pub use graphene;
pub use gsk;
pub use gtk4_sys as ffi;
pub use pango;

Modules§

accessible
builders: Builder pattern types.
prelude: Traits intended for blanket imports.
subclass: Traits intended for creating custom types.

Structs§

ATContext: GLib type: GObject with reference counted clone semantics.
AboutDialog: GLib type: GObject with reference counted clone semantics.
Accessible: GLib type: GObject with reference counted clone semantics.
AccessibleList: GLib type: Boxed type with copy-on-clone semantics.
AccessibleRange: GLib type: GObject with reference counted clone semantics.
AccessibleText: GLib type: GObject with reference counted clone semantics.
AccessibleTextRange: GLib type: Inline allocated boxed type with stack copy semantics.
ActionBar: GLib type: GObject with reference counted clone semantics.
Actionable: GLib type: GObject with reference counted clone semantics.
ActivateAction: GLib type: GObject with reference counted clone semantics.
Adjustment: GLib type: GObject with reference counted clone semantics.
AlertDialog: GLib type: GObject with reference counted clone semantics.
AlternativeTrigger: GLib type: GObject with reference counted clone semantics.
AnyFilter: GLib type: GObject with reference counted clone semantics.
AppChooserDeprecated: GLib type: GObject with reference counted clone semantics.
AppChooserButtonDeprecated: GLib type: GObject with reference counted clone semantics.
AppChooserDialogDeprecated: GLib type: GObject with reference counted clone semantics.
AppChooserWidgetDeprecated: GLib type: GObject with reference counted clone semantics.
Application: GLib type: GObject with reference counted clone semantics.
ApplicationInhibitFlags
ApplicationWindow: GLib type: GObject with reference counted clone semantics.
AspectFrame: GLib type: GObject with reference counted clone semantics.
AssistantDeprecated: GLib type: GObject with reference counted clone semantics.
AssistantPageDeprecated: GLib type: GObject with reference counted clone semantics.
BinLayout: GLib type: GObject with reference counted clone semantics.
Bitset: GLib type: Shared boxed type with reference counted clone semantics.
BitsetIter
BookmarkList: GLib type: GObject with reference counted clone semantics.
BoolFilter: GLib type: GObject with reference counted clone semantics.
Border: GLib type: Inline allocated boxed type with stack copy semantics.
Box: GLib type: GObject with reference counted clone semantics.
BoxLayout: GLib type: GObject with reference counted clone semantics.
Buildable: GLib type: GObject with reference counted clone semantics.
Builder: GLib type: GObject with reference counted clone semantics.
BuilderCScope: GLib type: GObject with reference counted clone semantics.
BuilderClosureFlags
BuilderListItemFactory: GLib type: GObject with reference counted clone semantics.
BuilderRustScope: An implementation of BuilderScope that can bind Rust callbacks.
BuilderScope: GLib type: GObject with reference counted clone semantics.
Button: GLib type: GObject with reference counted clone semantics.
Calendar: GLib type: GObject with reference counted clone semantics.
CallbackAction: GLib type: GObject with reference counted clone semantics.
CellAreaDeprecated: GLib type: GObject with reference counted clone semantics.
CellAreaBoxDeprecated: GLib type: GObject with reference counted clone semantics.
CellAreaContextDeprecated: GLib type: GObject with reference counted clone semantics.
CellEditableDeprecated: GLib type: GObject with reference counted clone semantics.
CellLayoutDeprecated: GLib type: GObject with reference counted clone semantics.
CellRendererDeprecated: GLib type: GObject with reference counted clone semantics.
CellRendererAccelDeprecated: GLib type: GObject with reference counted clone semantics.
CellRendererComboDeprecated: GLib type: GObject with reference counted clone semantics.
CellRendererPixbufDeprecated: GLib type: GObject with reference counted clone semantics.
CellRendererProgressDeprecated: GLib type: GObject with reference counted clone semantics.
CellRendererSpinDeprecated: GLib type: GObject with reference counted clone semantics.
CellRendererSpinnerDeprecated: GLib type: GObject with reference counted clone semantics.
CellRendererStateDeprecated
CellRendererTextDeprecated: GLib type: GObject with reference counted clone semantics.
CellRendererToggleDeprecated: GLib type: GObject with reference counted clone semantics.
CellViewDeprecated: GLib type: GObject with reference counted clone semantics.
CenterBox: GLib type: GObject with reference counted clone semantics.
CenterLayout: GLib type: GObject with reference counted clone semantics.
CheckButton: GLib type: GObject with reference counted clone semantics.
ClosureExpression: GLib type: Shared boxed type with reference counted clone semantics.
ColorButtonDeprecated: GLib type: GObject with reference counted clone semantics.
ColorChooserDeprecated: GLib type: GObject with reference counted clone semantics.
ColorChooserDialogDeprecated: GLib type: GObject with reference counted clone semantics.
ColorChooserWidgetDeprecated: GLib type: GObject with reference counted clone semantics.
ColorDialog: GLib type: GObject with reference counted clone semantics.
ColorDialogButton: GLib type: GObject with reference counted clone semantics.
ColumnView: GLib type: GObject with reference counted clone semantics.
ColumnViewCell: GLib type: GObject with reference counted clone semantics.
ColumnViewColumn: GLib type: GObject with reference counted clone semantics.
ColumnViewRow: GLib type: GObject with reference counted clone semantics.
ColumnViewSorter: GLib type: GObject with reference counted clone semantics.
ComboBoxDeprecated: GLib type: GObject with reference counted clone semantics.
ComboBoxTextDeprecated: GLib type: GObject with reference counted clone semantics.
ConstantExpression: GLib type: Shared boxed type with reference counted clone semantics.
Constraint: GLib type: GObject with reference counted clone semantics.
ConstraintGuide: GLib type: GObject with reference counted clone semantics.
ConstraintLayout: GLib type: GObject with reference counted clone semantics.
ConstraintLayoutChild: GLib type: GObject with reference counted clone semantics.
ConstraintTarget: GLib type: GObject with reference counted clone semantics.
CssLocation: GLib type: Inline allocated boxed type with stack copy semantics.
CssProvider: GLib type: GObject with reference counted clone semantics.
CssSection: GLib type: Shared boxed type with reference counted clone semantics.
CustomFilter: GLib type: GObject with reference counted clone semantics.
CustomSorter: GLib type: GObject with reference counted clone semantics.
DebugFlags
DialogDeprecated: GLib type: GObject with reference counted clone semantics.
DialogFlagsDeprecated
DirectoryList: GLib type: GObject with reference counted clone semantics.
DragIcon: GLib type: GObject with reference counted clone semantics.
DragSource: GLib type: GObject with reference counted clone semantics.
DrawingArea: GLib type: GObject with reference counted clone semantics.
DropControllerMotion: GLib type: GObject with reference counted clone semantics.
DropDown: GLib type: GObject with reference counted clone semantics.
DropTarget: GLib type: GObject with reference counted clone semantics.
DropTargetAsync: GLib type: GObject with reference counted clone semantics.
Editable: GLib type: GObject with reference counted clone semantics.
EditableLabel: GLib type: GObject with reference counted clone semantics.
EmojiChooser: GLib type: GObject with reference counted clone semantics.
Entry: GLib type: GObject with reference counted clone semantics.
EntryBuffer: GLib type: GObject with reference counted clone semantics.
EntryCompletionDeprecated: GLib type: GObject with reference counted clone semantics.
EventController: GLib type: GObject with reference counted clone semantics.
EventControllerFocus: GLib type: GObject with reference counted clone semantics.
EventControllerKey: GLib type: GObject with reference counted clone semantics.
EventControllerLegacy: GLib type: GObject with reference counted clone semantics.
EventControllerMotion: GLib type: GObject with reference counted clone semantics.
EventControllerScroll: GLib type: GObject with reference counted clone semantics.
EventControllerScrollFlags
EveryFilter: GLib type: GObject with reference counted clone semantics.
Expander: GLib type: GObject with reference counted clone semantics.
Expression: GLib type: Shared boxed type with reference counted clone semantics.
ExpressionWatch: GLib type: Shared boxed type with reference counted clone semantics.
FileChooserDeprecated: GLib type: GObject with reference counted clone semantics.
FileChooserDialogDeprecated: GLib type: GObject with reference counted clone semantics.
FileChooserNativeDeprecated: GLib type: GObject with reference counted clone semantics.
FileChooserWidgetDeprecated: GLib type: GObject with reference counted clone semantics.
FileDialog: GLib type: GObject with reference counted clone semantics.
FileFilter: GLib type: GObject with reference counted clone semantics.
FileLauncher: GLib type: GObject with reference counted clone semantics.
Filter: GLib type: GObject with reference counted clone semantics.
FilterListModel: GLib type: GObject with reference counted clone semantics.
Fixed: GLib type: GObject with reference counted clone semantics.
FixedLayout: GLib type: GObject with reference counted clone semantics.
FixedLayoutChild: GLib type: GObject with reference counted clone semantics.
FlattenListModel: GLib type: GObject with reference counted clone semantics.
FlowBox: GLib type: GObject with reference counted clone semantics.
FlowBoxChild: GLib type: GObject with reference counted clone semantics.
FontButtonDeprecated: GLib type: GObject with reference counted clone semantics.
FontChooserDeprecated: GLib type: GObject with reference counted clone semantics.
FontChooserDialogDeprecated: GLib type: GObject with reference counted clone semantics.
FontChooserLevelDeprecated
FontChooserWidgetDeprecated: GLib type: GObject with reference counted clone semantics.
FontDialog: GLib type: GObject with reference counted clone semantics.
FontDialogButton: GLib type: GObject with reference counted clone semantics.
Frame: GLib type: GObject with reference counted clone semantics.
GLArea: GLib type: GObject with reference counted clone semantics.
Gesture: GLib type: GObject with reference counted clone semantics.
GestureClick: GLib type: GObject with reference counted clone semantics.
GestureDrag: GLib type: GObject with reference counted clone semantics.
GestureLongPress: GLib type: GObject with reference counted clone semantics.
GesturePan: GLib type: GObject with reference counted clone semantics.
GestureRotate: GLib type: GObject with reference counted clone semantics.
GestureSingle: GLib type: GObject with reference counted clone semantics.
GestureStylus: GLib type: GObject with reference counted clone semantics.
GestureSwipe: GLib type: GObject with reference counted clone semantics.
GestureZoom: GLib type: GObject with reference counted clone semantics.
GraphicsOffload: GLib type: GObject with reference counted clone semantics.
Grid: GLib type: GObject with reference counted clone semantics.
GridLayout: GLib type: GObject with reference counted clone semantics.
GridLayoutChild: GLib type: GObject with reference counted clone semantics.
GridView: GLib type: GObject with reference counted clone semantics.
HeaderBar: GLib type: GObject with reference counted clone semantics.
IMContext: GLib type: GObject with reference counted clone semantics.
IMContextSimple: GLib type: GObject with reference counted clone semantics.
IMMulticontext: GLib type: GObject with reference counted clone semantics.
IconLookupFlags
IconPaintable: GLib type: GObject with reference counted clone semantics.
IconTheme: GLib type: GObject with reference counted clone semantics.
IconViewDeprecated: GLib type: GObject with reference counted clone semantics.
Image: GLib type: GObject with reference counted clone semantics.
InfoBarDeprecated: GLib type: GObject with reference counted clone semantics.
InputHints
Inscription: GLib type: GObject with reference counted clone semantics.
KeyvalTrigger: GLib type: GObject with reference counted clone semantics.
Label: GLib type: GObject with reference counted clone semantics.
LayoutChild: GLib type: GObject with reference counted clone semantics.
LayoutManager: GLib type: GObject with reference counted clone semantics.
LevelBar: GLib type: GObject with reference counted clone semantics.
LinkButton: GLib type: GObject with reference counted clone semantics.
ListBase: GLib type: GObject with reference counted clone semantics.
ListBox: GLib type: GObject with reference counted clone semantics.
ListBoxRow: GLib type: GObject with reference counted clone semantics.
ListHeader: GLib type: GObject with reference counted clone semantics.
ListItem: GLib type: GObject with reference counted clone semantics.
ListItemFactory: GLib type: GObject with reference counted clone semantics.
ListScrollFlags
ListStoreDeprecated: GLib type: GObject with reference counted clone semantics.
ListView: GLib type: GObject with reference counted clone semantics.
LockButtonDeprecated: GLib type: GObject with reference counted clone semantics.
MapListModel: GLib type: GObject with reference counted clone semantics.
MediaControls: GLib type: GObject with reference counted clone semantics.
MediaFile: GLib type: GObject with reference counted clone semantics.
MediaStream: GLib type: GObject with reference counted clone semantics.
MenuButton: GLib type: GObject with reference counted clone semantics.
MessageDialogDeprecated: GLib type: GObject with reference counted clone semantics.
MnemonicAction: GLib type: GObject with reference counted clone semantics.
MnemonicTrigger: GLib type: GObject with reference counted clone semantics.
MountOperation: GLib type: GObject with reference counted clone semantics.
MultiFilter: GLib type: GObject with reference counted clone semantics.
MultiSelection: GLib type: GObject with reference counted clone semantics.
MultiSorter: GLib type: GObject with reference counted clone semantics.
NamedAction: GLib type: GObject with reference counted clone semantics.
Native: GLib type: GObject with reference counted clone semantics.
NativeDialog: GLib type: GObject with reference counted clone semantics.
NeverTrigger: GLib type: GObject with reference counted clone semantics.
NoSelection: GLib type: GObject with reference counted clone semantics.
Notebook: GLib type: GObject with reference counted clone semantics.
NotebookPage: GLib type: GObject with reference counted clone semantics.
NothingAction: GLib type: GObject with reference counted clone semantics.
NumericSorter: GLib type: GObject with reference counted clone semantics.
ObjectExpression: GLib type: Shared boxed type with reference counted clone semantics.
Orientable: GLib type: GObject with reference counted clone semantics.
Overlay: GLib type: GObject with reference counted clone semantics.
OverlayLayout: GLib type: GObject with reference counted clone semantics.
OverlayLayoutChild: GLib type: GObject with reference counted clone semantics.
PadActionEntry: GLib type: Inline allocated boxed type with stack copy semantics.
PadController: GLib type: GObject with reference counted clone semantics.
PageRange: GLib type: Inline allocated boxed type with stack copy semantics.
PageSetup: GLib type: GObject with reference counted clone semantics.
PageSetupUnixDialog: GLib type: GObject with reference counted clone semantics.
Paned: GLib type: GObject with reference counted clone semantics.
PaperSize: GLib type: Boxed type with copy-on-clone semantics.
ParamSpecExpression: GLib type: Shared boxed type with reference counted clone semantics.
PasswordEntry: GLib type: GObject with reference counted clone semantics.
PasswordEntryBuffer: GLib type: GObject with reference counted clone semantics.
PickFlags
Picture: GLib type: GObject with reference counted clone semantics.
Popover: GLib type: GObject with reference counted clone semantics.
PopoverMenu: GLib type: GObject with reference counted clone semantics.
PopoverMenuBar: GLib type: GObject with reference counted clone semantics.
PopoverMenuFlags
PrintCapabilities
PrintContext: GLib type: GObject with reference counted clone semantics.
PrintDialog: GLib type: GObject with reference counted clone semantics.
PrintJob: GLib type: GObject with reference counted clone semantics.
PrintOperation: GLib type: GObject with reference counted clone semantics.
PrintOperationPreview: GLib type: GObject with reference counted clone semantics.
PrintSettings: GLib type: GObject with reference counted clone semantics.
PrintSetup: GLib type: Shared boxed type with reference counted clone semantics.
PrintUnixDialog: GLib type: GObject with reference counted clone semantics.
Printer: GLib type: GObject with reference counted clone semantics.
ProgressBar: GLib type: GObject with reference counted clone semantics.
PropertyExpression: GLib type: Shared boxed type with reference counted clone semantics.
Range: GLib type: GObject with reference counted clone semantics.
RecentData: GLib type: Inline allocated boxed type with stack copy semantics.
RecentInfo: GLib type: Shared boxed type with reference counted clone semantics.
RecentManager: GLib type: GObject with reference counted clone semantics.
Requisition: GLib type: Inline allocated boxed type with stack copy semantics.
Revealer: GLib type: GObject with reference counted clone semantics.
Root: GLib type: GObject with reference counted clone semantics.
Scale: GLib type: GObject with reference counted clone semantics.
ScaleButton: GLib type: GObject with reference counted clone semantics.
ScrollInfo: GLib type: Shared boxed type with reference counted clone semantics.
Scrollable: GLib type: GObject with reference counted clone semantics.
Scrollbar: GLib type: GObject with reference counted clone semantics.
ScrolledWindow: GLib type: GObject with reference counted clone semantics.
SearchBar: GLib type: GObject with reference counted clone semantics.
SearchEntry: GLib type: GObject with reference counted clone semantics.
SectionModel: GLib type: GObject with reference counted clone semantics.
SelectionFilterModel: GLib type: GObject with reference counted clone semantics.
SelectionModel: GLib type: GObject with reference counted clone semantics.
Separator: GLib type: GObject with reference counted clone semantics.
Settings: GLib type: GObject with reference counted clone semantics.
Shortcut: GLib type: GObject with reference counted clone semantics.
ShortcutAction: GLib type: GObject with reference counted clone semantics.
ShortcutActionFlags
ShortcutController: GLib type: GObject with reference counted clone semantics.
ShortcutLabelDeprecated: GLib type: GObject with reference counted clone semantics.
ShortcutManager: GLib type: GObject with reference counted clone semantics.
ShortcutTrigger: GLib type: GObject with reference counted clone semantics.
ShortcutsGroupDeprecated: GLib type: GObject with reference counted clone semantics.
ShortcutsSectionDeprecated: GLib type: GObject with reference counted clone semantics.
ShortcutsShortcutDeprecated: GLib type: GObject with reference counted clone semantics.
ShortcutsWindowDeprecated: GLib type: GObject with reference counted clone semantics.
SignalAction: GLib type: GObject with reference counted clone semantics.
SignalListItemFactory: GLib type: GObject with reference counted clone semantics.
SingleSelection: GLib type: GObject with reference counted clone semantics.
SizeGroup: GLib type: GObject with reference counted clone semantics.
SliceListModel: GLib type: GObject with reference counted clone semantics.
Snapshot: GLib type: GObject with reference counted clone semantics.
SortListModel: GLib type: GObject with reference counted clone semantics.
Sorter: GLib type: GObject with reference counted clone semantics.
SpinButton: GLib type: GObject with reference counted clone semantics.
Spinner: GLib type: GObject with reference counted clone semantics.
Stack: GLib type: GObject with reference counted clone semantics.
StackPage: GLib type: GObject with reference counted clone semantics.
StackSidebar: GLib type: GObject with reference counted clone semantics.
StackSwitcher: GLib type: GObject with reference counted clone semantics.
StateFlags
StatusbarDeprecated: GLib type: GObject with reference counted clone semantics.
StringFilter: GLib type: GObject with reference counted clone semantics.
StringList: GLib type: GObject with reference counted clone semantics.
StringObject: GLib type: GObject with reference counted clone semantics.
StringSorter: GLib type: GObject with reference counted clone semantics.
StyleContextDeprecated: GLib type: GObject with reference counted clone semantics.
StyleContextPrintFlags
StyleProvider: GLib type: GObject with reference counted clone semantics.
Switch: GLib type: GObject with reference counted clone semantics.
SymbolicPaintable: GLib type: GObject with reference counted clone semantics.
Text: GLib type: GObject with reference counted clone semantics.
TextBuffer: GLib type: GObject with reference counted clone semantics.
TextBufferNotifyFlags
TextChildAnchor: GLib type: GObject with reference counted clone semantics.
TextIter: GLib type: Inline allocated boxed type with stack copy semantics.
TextMark: GLib type: GObject with reference counted clone semantics.
TextSearchFlags
TextTag: GLib type: GObject with reference counted clone semantics.
TextTagTable: GLib type: GObject with reference counted clone semantics.
TextView: GLib type: GObject with reference counted clone semantics.
TickCallbackId
ToggleButton: GLib type: GObject with reference counted clone semantics.
Tooltip: GLib type: GObject with reference counted clone semantics.
TreeDragDestDeprecated: GLib type: GObject with reference counted clone semantics.
TreeDragSourceDeprecated: GLib type: GObject with reference counted clone semantics.
TreeExpander: GLib type: GObject with reference counted clone semantics.
TreeIter: GLib type: Inline allocated boxed type with stack copy semantics.
TreeListModel: GLib type: GObject with reference counted clone semantics.
TreeListRow: GLib type: GObject with reference counted clone semantics.
TreeListRowSorter: GLib type: GObject with reference counted clone semantics.
TreeModelDeprecated: GLib type: GObject with reference counted clone semantics.
TreeModelFilterDeprecated: GLib type: GObject with reference counted clone semantics.
TreeModelFlagsDeprecated
TreeModelSortDeprecated: GLib type: GObject with reference counted clone semantics.
TreePath: GLib type: Boxed type with copy-on-clone semantics.
TreeRowReference: GLib type: Boxed type with copy-on-clone semantics.
TreeSelectionDeprecated: GLib type: GObject with reference counted clone semantics.
TreeSortableDeprecated: GLib type: GObject with reference counted clone semantics.
TreeStoreDeprecated: GLib type: GObject with reference counted clone semantics.
TreeViewDeprecated: GLib type: GObject with reference counted clone semantics.
TreeViewColumnDeprecated: GLib type: GObject with reference counted clone semantics.
UriLauncher: GLib type: GObject with reference counted clone semantics.
Video: GLib type: GObject with reference counted clone semantics.
Viewport: GLib type: GObject with reference counted clone semantics.
VolumeButtonDeprecated: GLib type: GObject with reference counted clone semantics.
Widget: GLib type: GObject with reference counted clone semantics.
WidgetPaintable: GLib type: GObject with reference counted clone semantics.
Window: GLib type: GObject with reference counted clone semantics.
WindowControls: GLib type: GObject with reference counted clone semantics.
WindowGroup: GLib type: GObject with reference counted clone semantics.
WindowHandle: GLib type: GObject with reference counted clone semantics.

Enums§

AccessibleAnnouncementPriority
AccessibleAutocomplete
AccessibleInvalidState
AccessiblePlatformState
AccessibleProperty
AccessibleRelation
AccessibleRole
AccessibleSort
AccessibleState
AccessibleTextContentChange
AccessibleTextGranularity
AccessibleTristate
Align
ArrowType
AssistantPageTypeDeprecated
BaselinePosition
BorderStyle
BuilderError
ButtonsType
CellRendererAccelModeDeprecated
CellRendererModeDeprecated
Collation
ConstraintAttribute
ConstraintRelation
ConstraintStrength
ConstraintVflParserError
ContentFit
CornerType
CssParserError
CssParserWarning
DeleteType
DialogError
DirectionType
EditableProperties
EntryIconPosition
EventSequenceState
FileChooserAction
FileChooserErrorDeprecated
FilterChange
FilterMatch
FontLevel
FontRendering
GraphicsOffloadEnabled
IconSize
IconThemeError
IconViewDropPositionDeprecated
ImageType
InputPurpose
InscriptionOverflow
InterfaceColorScheme
InterfaceContrast
Justification
LevelBarMode
License
ListTabBehavior
MessageType
MovementStep
NaturalWrapMode
NotebookTab
NumberUpLayout
Ordering
Orientation
Overflow
PackType
PadActionType
PageOrientation
PageSet
PanDirection
PolicyType
PositionType
PrintDuplex
PrintError
PrintOperationAction
PrintOperationResult
PrintPages
PrintQuality
PrintStatus
PropagationLimit
PropagationPhase
RecentManagerError
ResponseType
RevealerTransitionType
ScrollStep
ScrollType
ScrollablePolicy
SelectionMode
SensitivityType
ShortcutScope
ShortcutType
SizeGroupMode
SizeRequestMode
SortColumnDeprecated
SortType
SorterChange
SorterOrder
SpinButtonUpdatePolicy
SpinType
StackTransitionType
StringFilterMatchMode
SymbolicColor
SystemSetting
TextDirection
TextExtendSelection
TextViewLayer
TextWindowType
TreeViewColumnSizingDeprecated
TreeViewDropPositionDeprecated
TreeViewGridLinesDeprecated
Unit
WindowGravity
WrapMode

Constants§

ACCESSIBLE_VALUE_UNDEFINED
INVALID_LIST_POSITION
PRIORITY_RESIZE
STYLE_PROVIDER_PRIORITY_APPLICATION
STYLE_PROVIDER_PRIORITY_FALLBACK
STYLE_PROVIDER_PRIORITY_SETTINGS
STYLE_PROVIDER_PRIORITY_THEME
STYLE_PROVIDER_PRIORITY_USER
TEXT_VIEW_PRIORITY_VALIDATE

Statics§

ACCESSIBLE_ATTRIBUTE_BACKGROUND
ACCESSIBLE_ATTRIBUTE_FAMILY
ACCESSIBLE_ATTRIBUTE_FOREGROUND
ACCESSIBLE_ATTRIBUTE_OVERLINE
ACCESSIBLE_ATTRIBUTE_OVERLINE_NONE
ACCESSIBLE_ATTRIBUTE_OVERLINE_SINGLE
ACCESSIBLE_ATTRIBUTE_SIZE
ACCESSIBLE_ATTRIBUTE_STRETCH
ACCESSIBLE_ATTRIBUTE_STRETCH_CONDENSED
ACCESSIBLE_ATTRIBUTE_STRETCH_EXPANDED
ACCESSIBLE_ATTRIBUTE_STRETCH_EXTRA_CONDENSED
ACCESSIBLE_ATTRIBUTE_STRETCH_EXTRA_EXPANDED
ACCESSIBLE_ATTRIBUTE_STRETCH_NORMAL
ACCESSIBLE_ATTRIBUTE_STRETCH_SEMI_CONDENSED
ACCESSIBLE_ATTRIBUTE_STRETCH_SEMI_EXPANDED
ACCESSIBLE_ATTRIBUTE_STRETCH_ULTRA_CONDENSED
ACCESSIBLE_ATTRIBUTE_STRETCH_ULTRA_EXPANDED
ACCESSIBLE_ATTRIBUTE_STRIKETHROUGH
ACCESSIBLE_ATTRIBUTE_STYLE
ACCESSIBLE_ATTRIBUTE_STYLE_ITALIC
ACCESSIBLE_ATTRIBUTE_STYLE_NORMAL
ACCESSIBLE_ATTRIBUTE_STYLE_OBLIQUE
ACCESSIBLE_ATTRIBUTE_UNDERLINE
ACCESSIBLE_ATTRIBUTE_UNDERLINE_DOUBLE
ACCESSIBLE_ATTRIBUTE_UNDERLINE_ERROR
ACCESSIBLE_ATTRIBUTE_UNDERLINE_NONE
ACCESSIBLE_ATTRIBUTE_UNDERLINE_SINGLE
ACCESSIBLE_ATTRIBUTE_VARIANT
ACCESSIBLE_ATTRIBUTE_VARIANT_ALL_PETITE_CAPS
ACCESSIBLE_ATTRIBUTE_VARIANT_ALL_SMALL_CAPS
ACCESSIBLE_ATTRIBUTE_VARIANT_PETITE_CAPS
ACCESSIBLE_ATTRIBUTE_VARIANT_SMALL_CAPS
ACCESSIBLE_ATTRIBUTE_VARIANT_TITLE_CAPS
ACCESSIBLE_ATTRIBUTE_VARIANT_UNICASE
ACCESSIBLE_ATTRIBUTE_WEIGHT
IM_MODULE_EXTENSION_POINT_NAME
LEVEL_BAR_OFFSET_FULL
LEVEL_BAR_OFFSET_HIGH
LEVEL_BAR_OFFSET_LOW
MEDIA_FILE_EXTENSION_POINT_NAME
PAPER_NAME_A3
PAPER_NAME_A4
PAPER_NAME_A5
PAPER_NAME_B5
PAPER_NAME_EXECUTIVE
PAPER_NAME_LEGAL
PAPER_NAME_LETTER
PRINT_SETTINGS_COLLATE
PRINT_SETTINGS_DEFAULT_SOURCE
PRINT_SETTINGS_DITHER
PRINT_SETTINGS_DUPLEX
PRINT_SETTINGS_FINISHINGS
PRINT_SETTINGS_MEDIA_TYPE
PRINT_SETTINGS_NUMBER_UP
PRINT_SETTINGS_NUMBER_UP_LAYOUT
PRINT_SETTINGS_N_COPIES
PRINT_SETTINGS_ORIENTATION
PRINT_SETTINGS_OUTPUT_BASENAME
PRINT_SETTINGS_OUTPUT_BIN
PRINT_SETTINGS_OUTPUT_DIR
PRINT_SETTINGS_OUTPUT_FILE_FORMAT
PRINT_SETTINGS_OUTPUT_URI
PRINT_SETTINGS_PAGE_RANGES
PRINT_SETTINGS_PAGE_SET
PRINT_SETTINGS_PAPER_FORMAT
PRINT_SETTINGS_PAPER_HEIGHT
PRINT_SETTINGS_PAPER_WIDTH
PRINT_SETTINGS_PRINTER
PRINT_SETTINGS_PRINTER_LPI
PRINT_SETTINGS_PRINT_PAGES
PRINT_SETTINGS_QUALITY
PRINT_SETTINGS_RESOLUTION
PRINT_SETTINGS_RESOLUTION_X
PRINT_SETTINGS_RESOLUTION_Y
PRINT_SETTINGS_REVERSE
PRINT_SETTINGS_SCALE
PRINT_SETTINGS_USE_COLOR
PRINT_SETTINGS_WIN32_DRIVER_EXTRA
PRINT_SETTINGS_WIN32_DRIVER_VERSION

Functions§

accelerator_get_default_mod_mask
accelerator_get_label
accelerator_get_label_with_keycode
accelerator_name
accelerator_name_with_keycode
accelerator_parse
accelerator_parse_with_keycode
accelerator_valid
binary_age
check_version
debug_flags
default_language
disable_portals
disable_setlocale
enumerate_printers
hsv_to_rgb
init: Tries to initialize GTK.
interface_age
is_initialized: Returns true if GTK has been initialized.
is_initialized_main_thread: Returns true if GTK has been initialized and this is the main thread.
locale_direction
major_version
micro_version
minor_version
print_run_page_setup_dialog
print_run_page_setup_dialog_async
render_activityDeprecated
render_arrowDeprecated
render_backgroundDeprecated
render_checkDeprecated
render_expanderDeprecated
render_focusDeprecated
render_frameDeprecated
render_handleDeprecated
render_iconDeprecated
render_layoutDeprecated
render_lineDeprecated
render_optionDeprecated
rgb_to_hsv
set_debug_flags
set_initialized^⚠: Informs this crate that GTK has been initialized and the current thread is the main one.
show_about_dialog
show_uriDeprecated
show_uri_fullDeprecated
show_uri_full_futureDeprecated
style_context_add_provider_for_display
style_context_remove_provider_for_display
test_accessible_assertion_message_role
test_accessible_has_property
test_accessible_has_relation
test_accessible_has_role
test_accessible_has_state
test_list_all_types
test_register_all_types
test_widget_wait_for_draw
tree_create_row_drag_contentDeprecated
tree_get_row_drag_dataDeprecated

Type Aliases§

Allocation

Crate gtk4

Crate gtk4 Copy item path

§Rust GTK 4 bindings

§Minimum supported Rust version

§“Hello, World!” example program

§The main loop

§Threads

§Panics

§Features

§Library versions

§Documentation

§Using

§Features

§See Also

§License

Re-exports§

Modules§

Structs§

Enums§

Constants§

Statics§

Functions§

Type Aliases§

Crate gtk4