Package ch.bailu.gtk.gtk
Class Widget
- All Implemented Interfaces:
PointerInterface
- Direct Known Subclasses:
ActionBar
,AppChooserButton
,AppChooserWidget
,AspectFrame
,Avatar
,Bin
,Box
,Button
,ButtonContent
,Calendar
,Carousel
,CarouselIndicatorDots
,CarouselIndicatorLines
,CellView
,CenterBox
,CheckButton
,Clamp
,ClampScrollable
,ColorButton
,ColorChooserWidget
,ColumnView
,ComboBox
,DragIcon
,DrawingArea
,DropDown
,EditableLabel
,Entry
,Expander
,FileChooserWidget
,Fixed
,Flap
,FlowBox
,FlowBoxChild
,FontButton
,FontChooserWidget
,Frame
,GLArea
,Grid
,HeaderBar
,HeaderBar
,IconView
,Image
,InfoBar
,Inscription
,Label
,Leaflet
,LevelBar
,ListBase
,ListBox
,ListBoxRow
,MediaControls
,MenuButton
,Notebook
,Overlay
,Paned
,PasswordEntry
,Picture
,Popover
,PopoverMenuBar
,PreferencesGroup
,PreferencesPage
,ProgressBar
,Range
,Revealer
,ScaleButton
,Scrollbar
,ScrolledWindow
,SearchBar
,SearchEntry
,Separator
,ShortcutLabel
,ShortcutsShortcut
,SpinButton
,Spinner
,SplitButton
,Squeezer
,Stack
,StackSidebar
,StackSwitcher
,Statusbar
,StatusPage
,Switch
,TabBar
,TabView
,Text
,TextView
,ToastOverlay
,TreeExpander
,TreeView
,Video
,Viewport
,ViewStack
,ViewSwitcher
,ViewSwitcherBar
,ViewSwitcherTitle
,Window
,WindowControls
,WindowHandle
,WindowTitle
The base class for all widgets.
`GtkWidget` is the base class all widgets in GTK derive from. It manages the
widget lifecycle, layout, states and style.
### Height-for-width Geometry Management
GTK uses a height-for-width (and width-for-height) geometry management
system. Height-for-width means that a widget can change how much
vertical space it needs, depending on the amount of horizontal space
that it is given (and similar for width-for-height). The most common
example is a label that reflows to fill up the available width, wraps
to fewer lines, and therefore needs less height.
Height-for-width geometry management is implemented in GTK by way
of two virtual methods:
- [vfunc@Gtk.Widget.get_request_mode]
- [vfunc@Gtk.Widget.measure]
There are some important things to keep in mind when implementing
height-for-width and when using it in widget implementations.
If you implement a direct `GtkWidget` subclass that supports
height-for-width or width-for-height geometry management for itself
or its child widgets, the [vfunc@Gtk.Widget.get_request_mode] virtual
function must be implemented as well and return the widget's preferred
request mode. The default implementation of this virtual function
returns %GTK_SIZE_REQUEST_CONSTANT_SIZE, which means that the widget will
only ever get -1 passed as the for_size value to its
[vfunc@Gtk.Widget.measure] implementation.
The geometry management system will query a widget hierarchy in
only one orientation at a time. When widgets are initially queried
for their minimum sizes it is generally done in two initial passes
in the [enum@Gtk.SizeRequestMode] chosen by the toplevel.
For example, when queried in the normal %GTK_SIZE_REQUEST_HEIGHT_FOR_WIDTH mode:
First, the default minimum and natural width for each widget
in the interface will be computed using [id@gtk_widget_measure] with an
orientation of %GTK_ORIENTATION_HORIZONTAL and a for_size of -1.
Because the preferred widths for each widget depend on the preferred
widths of their children, this information propagates up the hierarchy,
and finally a minimum and natural width is determined for the entire
toplevel. Next, the toplevel will use the minimum width to query for the
minimum height contextual to that width using [id@gtk_widget_measure] with an
orientation of %GTK_ORIENTATION_VERTICAL and a for_size of the just computed
width. This will also be a highly recursive operation. The minimum height
for the minimum width is normally used to set the minimum size constraint
on the toplevel.
After the toplevel window has initially requested its size in both
dimensions it can go on to allocate itself a reasonable size (or a size
previously specified with [method@Gtk.Window.set_default_size]). During the
recursive allocation process it’s important to note that request cycles
will be recursively executed while widgets allocate their children.
Each widget, once allocated a size, will go on to first share the
space in one orientation among its children and then request each child's
height for its target allocated width or its width for allocated height,
depending. In this way a `GtkWidget` will typically be requested its size
a number of times before actually being allocated a size. The size a
widget is finally allocated can of course differ from the size it has
requested. For this reason, `GtkWidget` caches a small number of results
to avoid re-querying for the same sizes in one allocation cycle.
If a widget does move content around to intelligently use up the
allocated size then it must support the request in both
`GtkSizeRequestMode`s even if the widget in question only
trades sizes in a single orientation.
For instance, a [class@Gtk.Label] that does height-for-width word wrapping
will not expect to have [vfunc@Gtk.Widget.measure] with an orientation of
%GTK_ORIENTATION_VERTICAL called because that call is specific to a
width-for-height request. In this case the label must return the height
required for its own minimum possible width. By following this rule any
widget that handles height-for-width or width-for-height requests will
always be allocated at least enough space to fit its own content.
Here are some examples of how a %GTK_SIZE_REQUEST_HEIGHT_FOR_WIDTH widget
generally deals with width-for-height requests:
```c
static void
foo_widget_measure (GtkWidget *widget,
GtkOrientation orientation,
int for_size,
int *minimum_size,
int *natural_size,
int *minimum_baseline,
int *natural_baseline)
{
if (orientation == GTK_ORIENTATION_HORIZONTAL)
{
// Calculate minimum and natural width
}
else // VERTICAL
{
if (i_am_in_height_for_width_mode)
{
int min_width, dummy;
// First, get the minimum width of our widget
GTK_WIDGET_GET_CLASS (widget)->measure (widget, GTK_ORIENTATION_HORIZONTAL, -1,
&min_width, &dummy, &dummy, &dummy);
// Now use the minimum width to retrieve the minimum and natural height to display
// that width.
GTK_WIDGET_GET_CLASS (widget)->measure (widget, GTK_ORIENTATION_VERTICAL, min_width,
minimum_size, natural_size, &dummy, &dummy);
}
else
{
// ... some widgets do both.
}
}
}
```
Often a widget needs to get its own request during size request or
allocation. For example, when computing height it may need to also
compute width. Or when deciding how to use an allocation, the widget
may need to know its natural size. In these cases, the widget should
be careful to call its virtual methods directly, like in the code
example above.
It will not work to use the wrapper function [method@Gtk.Widget.measure]
inside your own [vfunc@Gtk.Widget.size_allocate] implementation.
These return a request adjusted by [class@Gtk.SizeGroup], the widget's
align and expand flags, as well as its CSS style.
If a widget used the wrappers inside its virtual method implementations,
then the adjustments (such as widget margins) would be applied
twice. GTK therefore does not allow this and will warn if you try
to do it.
Of course if you are getting the size request for another widget, such
as a child widget, you must use [id@gtk_widget_measure]; otherwise, you
would not properly consider widget margins, [class@Gtk.SizeGroup], and
so forth.
GTK also supports baseline vertical alignment of widgets. This
means that widgets are positioned such that the typographical baseline of
widgets in the same row are aligned. This happens if a widget supports
baselines, has a vertical alignment of %GTK_ALIGN_BASELINE, and is inside
a widget that supports baselines and has a natural “row” that it aligns to
the baseline, or a baseline assigned to it by the grandparent.
Baseline alignment support for a widget is also done by the
[vfunc@Gtk.Widget.measure] virtual function. It allows you to report
both a minimum and natural size.
If a widget ends up baseline aligned it will be allocated all the space in
the parent as if it was %GTK_ALIGN_FILL, but the selected baseline can be
found via [id@gtk_widget_get_allocated_baseline]. If the baseline has a
value other than -1 you need to align the widget such that the baseline
appears at the position.
### GtkWidget as GtkBuildable
The `GtkWidget` implementation of the `GtkBuildable` interface
supports various custom elements to specify additional aspects of widgets
that are not directly expressed as properties.
If the widget uses a [class@Gtk.LayoutManager], `GtkWidget` supports
a custom `<layout>` element, used to define layout properties:
```xml
<object class="GtkGrid" id="my_grid">
<child>
<object class="GtkLabel" id="label1">
<property name="label">Description</property>
<layout>
<property name="column">0</property>
<property name="row">0</property>
<property name="row-span">1</property>
<property name="column-span">1</property>
</layout>
</object>
</child>
<child>
<object class="GtkEntry" id="description_entry">
<layout>
<property name="column">1</property>
<property name="row">0</property>
<property name="row-span">1</property>
<property name="column-span">1</property>
</layout>
</object>
</child>
</object>
```
`GtkWidget` allows style information such as style classes to
be associated with widgets, using the custom `<style>` element:
```xml
<object class="GtkButton" id="button1">
<style>
<class name="my-special-button-class"/>
<class name="dark-button"/>
</style>
</object>
```
`GtkWidget` allows defining accessibility information, such as properties,
relations, and states, using the custom `<accessibility>` element:
```xml
<object class="GtkButton" id="button1">
<accessibility>
<property name="label">Download</property>
<relation name="labelled-by">label1</relation>
</accessibility>
</object>
```
### Building composite widgets from template XML
`GtkWidget `exposes some facilities to automate the procedure
of creating composite widgets using "templates".
To create composite widgets with `GtkBuilder` XML, one must associate
the interface description with the widget class at class initialization
time using [method@Gtk.WidgetClass.set_template].
The interface description semantics expected in composite template descriptions
is slightly different from regular [class@Gtk.Builder] XML.
Unlike regular interface descriptions, [method@Gtk.WidgetClass.set_template] will
expect a `<template>` tag as a direct child of the toplevel `<interface>`
tag. The `<template>` tag must specify the “class” attribute which must be
the type name of the widget. Optionally, the “parent” attribute may be
specified to specify the direct parent type of the widget type, this is
ignored by `GtkBuilder` but required for UI design tools like
[Glade](https://glade.gnome.org/) to introspect what kind of properties and
internal children exist for a given type when the actual type does not exist.
The XML which is contained inside the `<template>` tag behaves as if it were
added to the `<object>` tag defining the widget itself. You may set properties
on a widget by inserting `<property>` tags into the `<template>` tag, and also
add `<child>` tags to add children and extend a widget in the normal way you
would with `<object>` tags.
Additionally, `<object>` tags can also be added before and after the initial
`<template>` tag in the normal way, allowing one to define auxiliary objects
which might be referenced by other widgets declared as children of the
`<template>` tag.
An example of a template definition:
```xml
<interface>
<template class="FooWidget" parent="GtkBox">
<property name="orientation">horizontal</property>
<property name="spacing">4</property>
<child>
<object class="GtkButton" id="hello_button">
<property name="label">Hello World</property>
<signal name="clicked" handler="hello_button_clicked" object="FooWidget" swapped="yes"/>
</object>
</child>
<child>
<object class="GtkButton" id="goodbye_button">
<property name="label">Goodbye World</property>
</object>
</child>
</template>
</interface>
```
Typically, you'll place the template fragment into a file that is
bundled with your project, using `GResource`. In order to load the
template, you need to call [method@Gtk.WidgetClass.set_template_from_resource]
from the class initialization of your `GtkWidget` type:
```c
static void
foo_widget_class_init (FooWidgetClass *klass)
{
// ...
gtk_widget_class_set_template_from_resource (GTK_WIDGET_CLASS (klass),
"/com/example/ui/foowidget.ui");
}
```
You will also need to call [method@Gtk.Widget.init_template] from the
instance initialization function:
```c
static void
foo_widget_init (FooWidget *self)
{
gtk_widget_init_template (GTK_WIDGET (self));
// Initialize the rest of the widget...
}
```
as well as calling [method@Gtk.Widget.dispose_template] from the dispose
function:
```c
static void
foo_widget_dispose (GObject *gobject)
{
FooWidget *self = FOO_WIDGET (gobject);
// Dispose objects for which you have a reference...
// Clear the template children for this widget type
gtk_widget_dispose_template (GTK_WIDGET (self), FOO_TYPE_WIDGET);
G_OBJECT_CLASS (foo_widget_parent_class)->dispose (gobject);
}
```
You can access widgets defined in the template using the
[id@gtk_widget_get_template_child] function, but you will typically declare
a pointer in the instance private data structure of your type using the same
name as the widget in the template definition, and call
[method@Gtk.WidgetClass.bind_template_child_full] (or one of its wrapper macros
[func@Gtk.widget_class_bind_template_child] and [func@Gtk.widget_class_bind_template_child_private])
with that name, e.g.
```c
typedef struct {
GtkWidget *hello_button;
GtkWidget *goodbye_button;
} FooWidgetPrivate;
G_DEFINE_TYPE_WITH_PRIVATE (FooWidget, foo_widget, GTK_TYPE_BOX)
static void
foo_widget_dispose (GObject *gobject)
{
gtk_widget_dispose_template (GTK_WIDGET (gobject), FOO_TYPE_WIDGET);
G_OBJECT_CLASS (foo_widget_parent_class)->dispose (gobject);
}
static void
foo_widget_class_init (FooWidgetClass *klass)
{
// ...
G_OBJECT_CLASS (klass)->dispose = foo_widget_dispose;
gtk_widget_class_set_template_from_resource (GTK_WIDGET_CLASS (klass),
"/com/example/ui/foowidget.ui");
gtk_widget_class_bind_template_child_private (GTK_WIDGET_CLASS (klass),
FooWidget, hello_button);
gtk_widget_class_bind_template_child_private (GTK_WIDGET_CLASS (klass),
FooWidget, goodbye_button);
}
static void
foo_widget_init (FooWidget *widget)
{
gtk_widget_init_template (GTK_WIDGET (widget));
}
```
You can also use [method@Gtk.WidgetClass.bind_template_callback_full] (or
is wrapper macro [func@Gtk.widget_class_bind_template_callback]) to connect
a signal callback defined in the template with a function visible in the
scope of the class, e.g.
```c
// the signal handler has the instance and user data swapped
// because of the swapped="yes" attribute in the template XML
static void
hello_button_clicked (FooWidget *self,
GtkButton *button)
{
g_print ("Hello, world!\n");
}
static void
foo_widget_class_init (FooWidgetClass *klass)
{
// ...
gtk_widget_class_set_template_from_resource (GTK_WIDGET_CLASS (klass),
"/com/example/ui/foowidget.ui");
gtk_widget_class_bind_template_callback (GTK_WIDGET_CLASS (klass), hello_button_clicked);
}
```
`GtkWidget` is the base class all widgets in GTK derive from. It manages the
widget lifecycle, layout, states and style.
### Height-for-width Geometry Management
GTK uses a height-for-width (and width-for-height) geometry management
system. Height-for-width means that a widget can change how much
vertical space it needs, depending on the amount of horizontal space
that it is given (and similar for width-for-height). The most common
example is a label that reflows to fill up the available width, wraps
to fewer lines, and therefore needs less height.
Height-for-width geometry management is implemented in GTK by way
of two virtual methods:
- [vfunc@Gtk.Widget.get_request_mode]
- [vfunc@Gtk.Widget.measure]
There are some important things to keep in mind when implementing
height-for-width and when using it in widget implementations.
If you implement a direct `GtkWidget` subclass that supports
height-for-width or width-for-height geometry management for itself
or its child widgets, the [vfunc@Gtk.Widget.get_request_mode] virtual
function must be implemented as well and return the widget's preferred
request mode. The default implementation of this virtual function
returns %GTK_SIZE_REQUEST_CONSTANT_SIZE, which means that the widget will
only ever get -1 passed as the for_size value to its
[vfunc@Gtk.Widget.measure] implementation.
The geometry management system will query a widget hierarchy in
only one orientation at a time. When widgets are initially queried
for their minimum sizes it is generally done in two initial passes
in the [enum@Gtk.SizeRequestMode] chosen by the toplevel.
For example, when queried in the normal %GTK_SIZE_REQUEST_HEIGHT_FOR_WIDTH mode:
First, the default minimum and natural width for each widget
in the interface will be computed using [id@gtk_widget_measure] with an
orientation of %GTK_ORIENTATION_HORIZONTAL and a for_size of -1.
Because the preferred widths for each widget depend on the preferred
widths of their children, this information propagates up the hierarchy,
and finally a minimum and natural width is determined for the entire
toplevel. Next, the toplevel will use the minimum width to query for the
minimum height contextual to that width using [id@gtk_widget_measure] with an
orientation of %GTK_ORIENTATION_VERTICAL and a for_size of the just computed
width. This will also be a highly recursive operation. The minimum height
for the minimum width is normally used to set the minimum size constraint
on the toplevel.
After the toplevel window has initially requested its size in both
dimensions it can go on to allocate itself a reasonable size (or a size
previously specified with [method@Gtk.Window.set_default_size]). During the
recursive allocation process it’s important to note that request cycles
will be recursively executed while widgets allocate their children.
Each widget, once allocated a size, will go on to first share the
space in one orientation among its children and then request each child's
height for its target allocated width or its width for allocated height,
depending. In this way a `GtkWidget` will typically be requested its size
a number of times before actually being allocated a size. The size a
widget is finally allocated can of course differ from the size it has
requested. For this reason, `GtkWidget` caches a small number of results
to avoid re-querying for the same sizes in one allocation cycle.
If a widget does move content around to intelligently use up the
allocated size then it must support the request in both
`GtkSizeRequestMode`s even if the widget in question only
trades sizes in a single orientation.
For instance, a [class@Gtk.Label] that does height-for-width word wrapping
will not expect to have [vfunc@Gtk.Widget.measure] with an orientation of
%GTK_ORIENTATION_VERTICAL called because that call is specific to a
width-for-height request. In this case the label must return the height
required for its own minimum possible width. By following this rule any
widget that handles height-for-width or width-for-height requests will
always be allocated at least enough space to fit its own content.
Here are some examples of how a %GTK_SIZE_REQUEST_HEIGHT_FOR_WIDTH widget
generally deals with width-for-height requests:
```c
static void
foo_widget_measure (GtkWidget *widget,
GtkOrientation orientation,
int for_size,
int *minimum_size,
int *natural_size,
int *minimum_baseline,
int *natural_baseline)
{
if (orientation == GTK_ORIENTATION_HORIZONTAL)
{
// Calculate minimum and natural width
}
else // VERTICAL
{
if (i_am_in_height_for_width_mode)
{
int min_width, dummy;
// First, get the minimum width of our widget
GTK_WIDGET_GET_CLASS (widget)->measure (widget, GTK_ORIENTATION_HORIZONTAL, -1,
&min_width, &dummy, &dummy, &dummy);
// Now use the minimum width to retrieve the minimum and natural height to display
// that width.
GTK_WIDGET_GET_CLASS (widget)->measure (widget, GTK_ORIENTATION_VERTICAL, min_width,
minimum_size, natural_size, &dummy, &dummy);
}
else
{
// ... some widgets do both.
}
}
}
```
Often a widget needs to get its own request during size request or
allocation. For example, when computing height it may need to also
compute width. Or when deciding how to use an allocation, the widget
may need to know its natural size. In these cases, the widget should
be careful to call its virtual methods directly, like in the code
example above.
It will not work to use the wrapper function [method@Gtk.Widget.measure]
inside your own [vfunc@Gtk.Widget.size_allocate] implementation.
These return a request adjusted by [class@Gtk.SizeGroup], the widget's
align and expand flags, as well as its CSS style.
If a widget used the wrappers inside its virtual method implementations,
then the adjustments (such as widget margins) would be applied
twice. GTK therefore does not allow this and will warn if you try
to do it.
Of course if you are getting the size request for another widget, such
as a child widget, you must use [id@gtk_widget_measure]; otherwise, you
would not properly consider widget margins, [class@Gtk.SizeGroup], and
so forth.
GTK also supports baseline vertical alignment of widgets. This
means that widgets are positioned such that the typographical baseline of
widgets in the same row are aligned. This happens if a widget supports
baselines, has a vertical alignment of %GTK_ALIGN_BASELINE, and is inside
a widget that supports baselines and has a natural “row” that it aligns to
the baseline, or a baseline assigned to it by the grandparent.
Baseline alignment support for a widget is also done by the
[vfunc@Gtk.Widget.measure] virtual function. It allows you to report
both a minimum and natural size.
If a widget ends up baseline aligned it will be allocated all the space in
the parent as if it was %GTK_ALIGN_FILL, but the selected baseline can be
found via [id@gtk_widget_get_allocated_baseline]. If the baseline has a
value other than -1 you need to align the widget such that the baseline
appears at the position.
### GtkWidget as GtkBuildable
The `GtkWidget` implementation of the `GtkBuildable` interface
supports various custom elements to specify additional aspects of widgets
that are not directly expressed as properties.
If the widget uses a [class@Gtk.LayoutManager], `GtkWidget` supports
a custom `<layout>` element, used to define layout properties:
```xml
<object class="GtkGrid" id="my_grid">
<child>
<object class="GtkLabel" id="label1">
<property name="label">Description</property>
<layout>
<property name="column">0</property>
<property name="row">0</property>
<property name="row-span">1</property>
<property name="column-span">1</property>
</layout>
</object>
</child>
<child>
<object class="GtkEntry" id="description_entry">
<layout>
<property name="column">1</property>
<property name="row">0</property>
<property name="row-span">1</property>
<property name="column-span">1</property>
</layout>
</object>
</child>
</object>
```
`GtkWidget` allows style information such as style classes to
be associated with widgets, using the custom `<style>` element:
```xml
<object class="GtkButton" id="button1">
<style>
<class name="my-special-button-class"/>
<class name="dark-button"/>
</style>
</object>
```
`GtkWidget` allows defining accessibility information, such as properties,
relations, and states, using the custom `<accessibility>` element:
```xml
<object class="GtkButton" id="button1">
<accessibility>
<property name="label">Download</property>
<relation name="labelled-by">label1</relation>
</accessibility>
</object>
```
### Building composite widgets from template XML
`GtkWidget `exposes some facilities to automate the procedure
of creating composite widgets using "templates".
To create composite widgets with `GtkBuilder` XML, one must associate
the interface description with the widget class at class initialization
time using [method@Gtk.WidgetClass.set_template].
The interface description semantics expected in composite template descriptions
is slightly different from regular [class@Gtk.Builder] XML.
Unlike regular interface descriptions, [method@Gtk.WidgetClass.set_template] will
expect a `<template>` tag as a direct child of the toplevel `<interface>`
tag. The `<template>` tag must specify the “class” attribute which must be
the type name of the widget. Optionally, the “parent” attribute may be
specified to specify the direct parent type of the widget type, this is
ignored by `GtkBuilder` but required for UI design tools like
[Glade](https://glade.gnome.org/) to introspect what kind of properties and
internal children exist for a given type when the actual type does not exist.
The XML which is contained inside the `<template>` tag behaves as if it were
added to the `<object>` tag defining the widget itself. You may set properties
on a widget by inserting `<property>` tags into the `<template>` tag, and also
add `<child>` tags to add children and extend a widget in the normal way you
would with `<object>` tags.
Additionally, `<object>` tags can also be added before and after the initial
`<template>` tag in the normal way, allowing one to define auxiliary objects
which might be referenced by other widgets declared as children of the
`<template>` tag.
An example of a template definition:
```xml
<interface>
<template class="FooWidget" parent="GtkBox">
<property name="orientation">horizontal</property>
<property name="spacing">4</property>
<child>
<object class="GtkButton" id="hello_button">
<property name="label">Hello World</property>
<signal name="clicked" handler="hello_button_clicked" object="FooWidget" swapped="yes"/>
</object>
</child>
<child>
<object class="GtkButton" id="goodbye_button">
<property name="label">Goodbye World</property>
</object>
</child>
</template>
</interface>
```
Typically, you'll place the template fragment into a file that is
bundled with your project, using `GResource`. In order to load the
template, you need to call [method@Gtk.WidgetClass.set_template_from_resource]
from the class initialization of your `GtkWidget` type:
```c
static void
foo_widget_class_init (FooWidgetClass *klass)
{
// ...
gtk_widget_class_set_template_from_resource (GTK_WIDGET_CLASS (klass),
"/com/example/ui/foowidget.ui");
}
```
You will also need to call [method@Gtk.Widget.init_template] from the
instance initialization function:
```c
static void
foo_widget_init (FooWidget *self)
{
gtk_widget_init_template (GTK_WIDGET (self));
// Initialize the rest of the widget...
}
```
as well as calling [method@Gtk.Widget.dispose_template] from the dispose
function:
```c
static void
foo_widget_dispose (GObject *gobject)
{
FooWidget *self = FOO_WIDGET (gobject);
// Dispose objects for which you have a reference...
// Clear the template children for this widget type
gtk_widget_dispose_template (GTK_WIDGET (self), FOO_TYPE_WIDGET);
G_OBJECT_CLASS (foo_widget_parent_class)->dispose (gobject);
}
```
You can access widgets defined in the template using the
[id@gtk_widget_get_template_child] function, but you will typically declare
a pointer in the instance private data structure of your type using the same
name as the widget in the template definition, and call
[method@Gtk.WidgetClass.bind_template_child_full] (or one of its wrapper macros
[func@Gtk.widget_class_bind_template_child] and [func@Gtk.widget_class_bind_template_child_private])
with that name, e.g.
```c
typedef struct {
GtkWidget *hello_button;
GtkWidget *goodbye_button;
} FooWidgetPrivate;
G_DEFINE_TYPE_WITH_PRIVATE (FooWidget, foo_widget, GTK_TYPE_BOX)
static void
foo_widget_dispose (GObject *gobject)
{
gtk_widget_dispose_template (GTK_WIDGET (gobject), FOO_TYPE_WIDGET);
G_OBJECT_CLASS (foo_widget_parent_class)->dispose (gobject);
}
static void
foo_widget_class_init (FooWidgetClass *klass)
{
// ...
G_OBJECT_CLASS (klass)->dispose = foo_widget_dispose;
gtk_widget_class_set_template_from_resource (GTK_WIDGET_CLASS (klass),
"/com/example/ui/foowidget.ui");
gtk_widget_class_bind_template_child_private (GTK_WIDGET_CLASS (klass),
FooWidget, hello_button);
gtk_widget_class_bind_template_child_private (GTK_WIDGET_CLASS (klass),
FooWidget, goodbye_button);
}
static void
foo_widget_init (FooWidget *widget)
{
gtk_widget_init_template (GTK_WIDGET (widget));
}
```
You can also use [method@Gtk.WidgetClass.bind_template_callback_full] (or
is wrapper macro [func@Gtk.widget_class_bind_template_callback]) to connect
a signal callback defined in the template with a function visible in the
scope of the class, e.g.
```c
// the signal handler has the instance and user data swapped
// because of the swapped="yes" attribute in the template XML
static void
hello_button_clicked (FooWidget *self,
GtkButton *button)
{
g_print ("Hello, world!\n");
}
static void
foo_widget_class_init (FooWidgetClass *klass)
{
// ...
gtk_widget_class_set_template_from_resource (GTK_WIDGET_CLASS (klass),
"/com/example/ui/foowidget.ui");
gtk_widget_class_bind_template_callback (GTK_WIDGET_CLASS (klass), hello_button_clicked);
}
```
-
Nested Class Summary
Modifier and TypeClassDescriptionstatic interface
static interface
static interface
static interface
static interface
static interface
static interface
static interface
static interface
static interface
static interface
static interface
static interface
static interface
static interface
Nested classes/interfaces inherited from class ch.bailu.gtk.gobject.Object
Object.OnBindingTransformFunc, Object.OnDuplicateFunc, Object.OnNotify, Object.OnToggleNotify, Object.OnWeakNotify
-
Field Summary
Modifier and TypeFieldDescriptionstatic final String
static final String
static final String
static final String
static final String
static final String
static final String
static final String
static final String
static final String
static final String
static final String
static final String
Fields inherited from class ch.bailu.gtk.gobject.Object
SIGNAL_ON_NOTIFY
-
Constructor Summary
-
Method Summary
Modifier and TypeMethodDescriptionvoid
actionSetEnabled
(Str action_name, boolean enabled) Enable or disable an action installed with
gtk_widget_class_install_action().void
actionSetEnabled
(String action_name, boolean enabled) Enable or disable an action installed with
gtk_widget_class_install_action().boolean
activate()
For widgets that can be “activated” (buttons, menu items, etc.),
this function activates them.boolean
activateAction
(Str name, Str format_string, Object... _elipse) Looks up the action in the action groups associated
with @widget and its ancestors, and activates it.boolean
activateAction
(String name, String format_string, Object... _elipse) Looks up the action in the action groups associated
with @widget and its ancestors, and activates it.boolean
activateActionVariant
(Str name, Variant args) Looks up the action in the action groups associated with
@widget and its ancestors, and activates it.boolean
activateActionVariant
(String name, Variant args) Looks up the action in the action groups associated with
@widget and its ancestors, and activates it.void
Activates the `default.activate` action from @widget.void
addController
(EventController controller) Adds @controller to @widget so that it will receive events.void
addCssClass
(Str css_class) Adds a style class to @widget.void
addCssClass
(String css_class) Adds a style class to @widget.void
addMnemonicLabel
(Widget label) Adds a widget to the list of mnemonic labels for this widget.int
addTickCallback
(Widget.OnTickCallback callback, Pointer user_data, Widget.OnDestroyNotify notify) Queues an animation frame update and adds a callback to be called
before each frame.void
This function is only used by `GtkWidget` subclasses, to
assign a size, position and (optionally) baseline to their
child widgets.Implements interfaceAccessible
.Implements interfaceBuildable
.Implements interfaceConstraintTarget
.boolean
childFocus
(int direction) Called by widgets as the user moves around the window using
keyboard shortcuts.boolean
computeBounds
(Widget target, Rect out_bounds) Computes the bounds for @widget in the coordinate space of @target.boolean
computeExpand
(int orientation) Computes whether a container should give this widget
extra space when possible.boolean
computePoint
(Widget target, Point point, Point out_point) Translates the given @point in @widget's coordinates to coordinates
relative to @target’s coordinate system.boolean
computeTransform
(Widget target, Matrix out_transform) Computes a matrix suitable to describe a transformation from
@widget's coordinate system into @target's coordinate system.boolean
contains
(double x, double y) Tests if the point at (@x, @y) is contained in @widget.Creates a new `PangoContext` with the appropriate font map,
font options, font description, and base direction for drawing
text for this widget.createPangoLayout
(Str text) Creates a new `PangoLayout` with the appropriate font map,
font description, and base direction for drawing text for
this widget.createPangoLayout
(String text) Creates a new `PangoLayout` with the appropriate font map,
font description, and base direction for drawing text for
this widget.void
disposeTemplate
(long widget_type) Clears the template children for the given widget.boolean
dragCheckThreshold
(int start_x, int start_y, int current_x, int current_y) Checks to see if a drag movement has passed the GTK drag threshold.void
Notifies the user about an input-related error on this widget.int
Returns the baseline that has currently been allocated to @widget.int
Returns the height that has currently been allocated to @widget.int
Returns the width that has currently been allocated to @widget.void
getAllocation
(Rectangle allocation) Retrieves the widget’s allocation.getAncestor
(long widget_type) Gets the first ancestor of @widget with type @widget_type.boolean
Determines whether the input focus can enter @widget or any
of its children.boolean
Queries whether @widget can be the target of pointer events.boolean
Gets the value set with gtk_widget_set_child_visible().static ClassHandler
Gets the clipboard object for @widget.Returns the list of style classes applied to @widget.Returns the CSS name that is used for @self.Queries the cursor set on @widget.static int
Obtains the current default reading direction.int
Gets the reading direction for a particular widget.Get the `GdkDisplay` for the toplevel window associated with
this widget.Returns the widgets first child.boolean
Determines whether @widget can own the input focus.Returns the current focus child of @widget.boolean
Returns whether the widget should grab focus when it is clicked
with the mouse.Gets the font map of @widget.Returns the `cairo_font_options_t` of widget.Obtains the frame clock for a widget.int
Gets the horizontal alignment of @widget.boolean
Returns the current value of the `has-tooltip` property.int
Returns the content height of the widget.boolean
Gets whether the widget would like any available extra horizontal
space.boolean
Gets whether gtk_widget_set_hexpand() has been used
to explicitly set the expand flag on this widget.static int
Returns the widgets last child.Retrieves the layout manager used by @widget.boolean
Whether the widget is mapped.int
Gets the bottom margin of @widget.int
Gets the end margin of @widget.int
Gets the start margin of @widget.int
Gets the top margin of @widget.getName()
Retrieves the name of a widget.Returns the nearest `GtkNative` ancestor of @widget.Returns the widgets next sibling.double
#Fetches the requested opacity for this widget.int
Returns the widgets overflow value.Gets a `PangoContext` with the appropriate font map, font description,
and base direction for this widget.Returns the parent widget of @widget.static long
static TypeSystem.TypeSize
void
getPreferredSize
(Requisition minimum_size, Requisition natural_size) Retrieves the minimum and natural size of a widget, taking
into account the widget’s preference for height-for-width management.Returns the widgets previous sibling.Gets the primary clipboard of @widget.boolean
Determines whether @widget is realized.boolean
Determines whether @widget is always treated as the default widget
within its toplevel when it has the focus, even if another widget
is the default.int
Gets whether the widget prefers a height-for-width layout
or a width-for-height layout.getRoot()
Returns the `GtkRoot` widget of @widget.int
Retrieves the internal scale factor that maps from window
coordinates to the actual device pixels.boolean
Returns the widget’s sensitivity.Gets the settings object holding the settings used for this widget.int
getSize
(int orientation) Returns the content width or height of the widget.void
getSizeRequest
(Int width, Int height) Gets the size request that was explicitly set for the widget using
gtk_widget_set_size_request().int
Returns the widget state as a flag set.Returns the style context associated to @widget.getTemplateChild
(long widget_type, Str name) Fetch an object build from the template XML for @widget_type in
this @widget instance.getTemplateChild
(long widget_type, String name) Fetch an object build from the template XML for @widget_type in
this @widget instance.Gets the contents of the tooltip for @widget.Gets the contents of the tooltip for @widget.static long
static TypeSystem.TypeSize
int
Gets the vertical alignment of @widget.boolean
Gets whether the widget would like any available extra vertical
space.boolean
Gets whether gtk_widget_set_vexpand() has been used to
explicitly set the expand flag on this widget.boolean
Determines whether the widget is visible.int
getWidth()
Returns the content width of the widget.boolean
Causes @widget to have the keyboard focus for the `GtkWindow` it's inside.boolean
hasCssClass
(Str css_class) Returns whether @css_class is currently applied to @widget.boolean
hasCssClass
(String css_class) Returns whether @css_class is currently applied to @widget.boolean
Determines whether @widget is the current default widget
within its toplevel.boolean
hasFocus()
Determines if the widget has the global input focus.boolean
Determines if the widget should show a visible indication that
it has the global input focus.void
hide()
Reverses the effects of gtk_widget_show().boolean
Returns whether the widget is currently being destroyed.void
Creates and initializes child widgets defined in templates.void
insertActionGroup
(Str name, ActionGroup group) Inserts @group into @widget.void
insertActionGroup
(String name, ActionGroup group) Inserts @group into @widget.void
insertAfter
(Widget parent, Widget previous_sibling) Inserts @widget into the child widget list of @parent.void
insertBefore
(Widget parent, Widget next_sibling) Inserts @widget into the child widget list of @parent.boolean
isAncestor
(Widget ancestor) Determines whether @widget is somewhere inside @ancestor,
possibly with intermediate containers.boolean
Determines whether @widget can be drawn to.boolean
isFocus()
Determines if the widget is the focus widget within its
toplevel.boolean
Returns the widget’s effective sensitivity.boolean
Determines whether the widget and all its parents are marked as
visible.boolean
keynavFailed
(int direction) Emits the `::keynav-failed` signal on the widget.Returns the widgets for which this widget is the target of a
mnemonic.void
map()
Causes a widget to be mapped if it isn’t already.void
measure
(int orientation, int for_size, Int minimum, Int natural, Int minimum_baseline, Int natural_baseline) Measures @widget in the orientation @orientation and for the given @for_size.boolean
mnemonicActivate
(boolean group_cycling) Emits the ::mnemonic-activate signal.Returns a `GListModel` to track the children of @widget.Returns a `GListModel` to track the [class@Gtk.EventController]s
of @widget.onDestroy
(Widget.OnDestroy signal) Connect to signal "destroy".Connect to signal "direction-changed".onHide
(Widget.OnHide signal) Connect to signal "hide".onKeynavFailed
(Widget.OnKeynavFailed signal) Connect to signal "keynav-failed".onMap
(Widget.OnMap signal) Connect to signal "map".Connect to signal "mnemonic-activate".onMoveFocus
(Widget.OnMoveFocus signal) Connect to signal "move-focus".onQueryTooltip
(Widget.OnQueryTooltip signal) Connect to signal "query-tooltip".onRealize
(Widget.OnRealize signal) Connect to signal "realize".onShow
(Widget.OnShow signal) Connect to signal "show".Connect to signal "state-flags-changed".onUnmap
(Widget.OnUnmap signal) Connect to signal "unmap".onUnrealize
(Widget.OnUnrealize signal) Connect to signal "unrealize".pick
(double x, double y, int flags) Finds the descendant of @widget closest to the point (@x, @y).void
Flags the widget for a rerun of the [vfunc@Gtk.Widget.size_allocate]
function.void
Schedules this widget to be redrawn in the paint phase
of the current or the next frame.void
Flags a widget to have its size renegotiated.void
realize()
Creates the GDK resources associated with a widget.void
removeController
(EventController controller) Removes @controller from @widget, so that it doesn't process
events anymore.void
removeCssClass
(Str css_class) Removes a style from @widget.void
removeCssClass
(String css_class) Removes a style from @widget.void
removeMnemonicLabel
(Widget label) Removes a widget from the list of mnemonic labels for this widget.void
removeTickCallback
(int id) Removes a tick callback previously registered with
gtk_widget_add_tick_callback().void
setCanFocus
(boolean can_focus) Specifies whether the input focus can enter the widget
or any of its children.void
setCanTarget
(boolean can_target) Sets whether @widget can be the target of pointer events.void
setChildVisible
(boolean child_visible) Sets whether @widget should be mapped along with its parent.void
setCssClasses
(Strs classes) Clear all style classes applied to @widget
and replace them with @classes.void
Sets the cursor to be shown when pointer devices point
towards @widget.void
setCursorFromName
(Str name) Sets a named cursor to be shown when pointer devices point
towards @widget.void
setCursorFromName
(String name) Sets a named cursor to be shown when pointer devices point
towards @widget.static void
setDefaultDirection
(int dir) Sets the default reading direction for widgets.void
setDirection
(int dir) Sets the reading direction on a particular widget.void
setFocusable
(boolean focusable) Specifies whether @widget can own the input focus.void
setFocusChild
(Widget child) Set @child as the current focus child of @widget.void
setFocusOnClick
(boolean focus_on_click) Sets whether the widget should grab focus when it is clicked
with the mouse.void
setFontMap
(FontMap font_map) Sets the font map to use for Pango rendering.void
setFontOptions
(FontOptions options) Sets the `cairo_font_options_t` used for Pango rendering
in this widget.void
setHalign
(int align) Sets the horizontal alignment of @widget.void
setHasTooltip
(boolean has_tooltip) Sets the `has-tooltip` property on @widget to @has_tooltip.void
setHexpand
(boolean expand) Sets whether the widget would like any available extra horizontal
space.void
setHexpandSet
(boolean set) Sets whether the hexpand flag will be used.void
setLayoutManager
(LayoutManager layout_manager) Sets the layout manager delegate instance that provides an
implementation for measuring and allocating the children of @widget.void
setMarginBottom
(int margin) Sets the bottom margin of @widget.void
setMarginEnd
(int margin) Sets the end margin of @widget.void
setMarginStart
(int margin) Sets the start margin of @widget.void
setMarginTop
(int margin) Sets the top margin of @widget.void
Sets a widgets name.void
Sets a widgets name.void
setOpacity
(double opacity) Request the @widget to be rendered partially transparent.void
setOverflow
(int overflow) Sets how @widget treats content that is drawn outside the
widget's content area.void
Sets @parent as the parent widget of @widget.void
setReceivesDefault
(boolean receives_default) Specifies whether @widget will be treated as the default
widget within its toplevel when it has the focus, even if
another widget is the default.void
setSensitive
(boolean sensitive) Sets the sensitivity of a widget.void
setSizeRequest
(int width, int height) Sets the minimum size of a widget.void
setStateFlags
(int flags, boolean clear) Turns on flag values in the current widget state.void
setTooltipMarkup
(Str markup) Sets @markup as the contents of the tooltip, which is marked
up with Pango markup.void
setTooltipMarkup
(String markup) Sets @markup as the contents of the tooltip, which is marked
up with Pango markup.void
setTooltipText
(Str text) Sets @text as the contents of the tooltip.void
setTooltipText
(String text) Sets @text as the contents of the tooltip.void
setValign
(int align) Sets the vertical alignment of @widget.void
setVexpand
(boolean expand) Sets whether the widget would like any available extra vertical
space.void
setVexpandSet
(boolean set) Sets whether the vexpand flag will be used.void
setVisible
(boolean visible) Sets the visibility state of @widget.boolean
Returns whether @widget should contribute to
the measuring and allocation of its parent.void
show()
Flags a widget to be displayed.void
sizeAllocate
(Rectangle allocation, int baseline) Allocates widget with a transformation that translates
the origin to the position in @allocation.void
snapshotChild
(Widget child, Snapshot snapshot) Snapshot the a child of @widget.void
Triggers a tooltip query on the display where the toplevel
of @widget is located.void
unmap()
Causes a widget to be unmapped if it’s currently mapped.void
unparent()
Dissociate @widget from its parent.void
Causes a widget to be unrealized (frees all GDK resources
associated with the widget).void
unsetStateFlags
(int flags) Turns off flag values for the current widget state.Methods inherited from class ch.bailu.gtk.gobject.Object
addToggleRef, bindProperty, bindProperty, bindPropertyFull, bindPropertyFull, bindPropertyWithClosures, bindPropertyWithClosures, compatControl, connect, connect, disconnect, disconnect, dupData, dupData, dupQdata, forceFloating, freezeNotify, get, get, getData, getData, getProperty, getProperty, getQdata, interfaceFindProperty, interfaceInstallProperty, isFloating, notify, notify, notifyByPspec, onNotify, ref, refSink, removeToggleRef, replaceData, replaceData, replaceQdata, runDispose, set, set, setData, setData, setDataFull, setDataFull, setProperty, setProperty, setQdata, setQdataFull, stealData, stealData, stealQdata, takeRef, thawNotify, unref, watchClosure, weakRef, weakUnref
Methods inherited from class ch.bailu.gtk.type.Pointer
asCPointer, cast, connectSignal, disconnectSignals, disconnectSignals, equals, hashCode, throwIfNull, throwNullPointerException, toString, unregisterCallbacks, unregisterCallbacks
Methods inherited from class ch.bailu.gtk.type.Type
asCPointer, asCPointer, asCPointerNotNull, asJnaPointer, asJnaPointer, asPointer, asPointer, cast, cast, throwIfNull
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
Methods inherited from interface ch.bailu.gtk.type.PointerInterface
asCPointerNotNull, asJnaPointer, asPointer, isNotNull, isNull
-
Field Details
-
SIGNAL_ON_DESTROY
- See Also:
-
SIGNAL_ON_DIRECTION_CHANGED
- See Also:
-
SIGNAL_ON_HIDE
- See Also:
-
SIGNAL_ON_KEYNAV_FAILED
- See Also:
-
SIGNAL_ON_MAP
- See Also:
-
SIGNAL_ON_MNEMONIC_ACTIVATE
- See Also:
-
SIGNAL_ON_MOVE_FOCUS
- See Also:
-
SIGNAL_ON_QUERY_TOOLTIP
- See Also:
-
SIGNAL_ON_REALIZE
- See Also:
-
SIGNAL_ON_SHOW
- See Also:
-
SIGNAL_ON_STATE_FLAGS_CHANGED
- See Also:
-
SIGNAL_ON_UNMAP
- See Also:
-
SIGNAL_ON_UNREALIZE
- See Also:
-
-
Constructor Details
-
Widget
-
-
Method Details
-
getClassHandler
-
actionSetEnabled
Enable or disable an action installed with
gtk_widget_class_install_action().- Parameters:
action_name
- action name, such as "clipboard.paste"enabled
- whether the action is now enabled
-
actionSetEnabled
Enable or disable an action installed with
gtk_widget_class_install_action().- Parameters:
action_name
- action name, such as "clipboard.paste"enabled
- whether the action is now enabled
-
activate
public boolean activate()For widgets that can be “activated” (buttons, menu items, etc.),
this function activates them.
The activation will emit the signal set using
[method@Gtk.WidgetClass.set_activate_signal] during class initialization.
Activation is what happens when you press <kbd>Enter</kbd>
on a widget during key navigation.
If you wish to handle the activation keybinding yourself, it is
recommended to use [method@Gtk.WidgetClass.add_shortcut] with an action
created with [ctor@Gtk.SignalAction.new].
If @widget isn't activatable, the function returns %FALSE.- Returns:
- %TRUE if the widget was activatable
-
activateAction
Looks up the action in the action groups associated
with @widget and its ancestors, and activates it.
This is a wrapper around [method@Gtk.Widget.activate_action_variant]
that constructs the @args variant according to @format_string.- Parameters:
name
- the name of the action to activateformat_string
- GVariant format string for arguments or %NULL for no arguments_elipse
- arguments, as given by format string- Returns:
- %TRUE if the action was activated, %FALSE if the action does not exist
-
activateAction
Looks up the action in the action groups associated
with @widget and its ancestors, and activates it.
This is a wrapper around [method@Gtk.Widget.activate_action_variant]
that constructs the @args variant according to @format_string.- Parameters:
name
- the name of the action to activateformat_string
- GVariant format string for arguments or %NULL for no arguments_elipse
- arguments, as given by format string- Returns:
- %TRUE if the action was activated, %FALSE if the action does not exist
-
activateActionVariant
Looks up the action in the action groups associated with
@widget and its ancestors, and activates it.
If the action is in an action group added with
[method@Gtk.Widget.insert_action_group], the @name is expected
to be prefixed with the prefix that was used when the group was
inserted.
The arguments must match the actions expected parameter type,
as returned by `g_action_get_parameter_type()`.- Parameters:
name
- the name of the action to activateargs
- parameters to use- Returns:
- %TRUE if the action was activated, %FALSE if the action does not exist.
-
activateActionVariant
Looks up the action in the action groups associated with
@widget and its ancestors, and activates it.
If the action is in an action group added with
[method@Gtk.Widget.insert_action_group], the @name is expected
to be prefixed with the prefix that was used when the group was
inserted.
The arguments must match the actions expected parameter type,
as returned by `g_action_get_parameter_type()`.- Parameters:
name
- the name of the action to activateargs
- parameters to use- Returns:
- %TRUE if the action was activated, %FALSE if the action does not exist.
-
activateDefault
public void activateDefault()Activates the `default.activate` action from @widget. -
addController
Adds @controller to @widget so that it will receive events.
You will usually want to call this function right after
creating any kind of [class@Gtk.EventController].- Parameters:
controller
- a `GtkEventController` that hasn't been added to a widget yet
-
addCssClass
Adds a style class to @widget.
After calling this function, the widgets style will match
for @css_class, according to CSS matching rules.
Use [method@Gtk.Widget.remove_css_class] to remove the
style again.- Parameters:
css_class
- The style class to add to @widget, without the leading '.' used for notation of style classes
-
addCssClass
Adds a style class to @widget.
After calling this function, the widgets style will match
for @css_class, according to CSS matching rules.
Use [method@Gtk.Widget.remove_css_class] to remove the
style again.- Parameters:
css_class
- The style class to add to @widget, without the leading '.' used for notation of style classes
-
addMnemonicLabel
Adds a widget to the list of mnemonic labels for this widget.
See [method@Gtk.Widget.list_mnemonic_labels]. Note the
list of mnemonic labels for the widget is cleared when the
widget is destroyed, so the caller must make sure to update
its internal state at this point as well.- Parameters:
label
- a `GtkWidget` that acts as a mnemonic label for @widget
-
addTickCallback
public int addTickCallback(Widget.OnTickCallback callback, @Nullable Pointer user_data, Widget.OnDestroyNotify notify) Queues an animation frame update and adds a callback to be called
before each frame.
Until the tick callback is removed, it will be called frequently
(usually at the frame rate of the output device or as quickly as
the application can be repainted, whichever is slower). For this
reason, is most suitable for handling graphics that change every
frame or every few frames. The tick callback does not automatically
imply a relayout or repaint. If you want a repaint or relayout, and
aren’t changing widget properties that would trigger that (for example,
changing the text of a `GtkLabel`), then you will have to call
[method@Gtk.Widget.queue_resize] or [method@Gtk.Widget.queue_draw]
yourself.
[method@Gdk.FrameClock.get_frame_time] should generally be used
for timing continuous animations and
[method@Gdk.FrameTimings.get_predicted_presentation_time] if you are
trying to display isolated frames at particular times.
This is a more convenient alternative to connecting directly to the
[signal@Gdk.FrameClock::update] signal of `GdkFrameClock`, since you
don't have to worry about when a `GdkFrameClock` is assigned to a widget.- Parameters:
callback
- function to call for updating animationsuser_data
- data to pass to @callbacknotify
- function to call to free @user_data when the callback is removed.- Returns:
- an id for the connection of this callback. Remove the callback by passing the id returned from this function to [method@Gtk.Widget.remove_tick_callback]
-
allocate
This function is only used by `GtkWidget` subclasses, to
assign a size, position and (optionally) baseline to their
child widgets.
In this function, the allocation and baseline may be adjusted.
The given allocation will be forced to be bigger than the
widget's minimum size, as well as at least 0×0 in size.
For a version that does not take a transform, see
[method@Gtk.Widget.size_allocate].- Parameters:
width
- New width of @widgetheight
- New height of @widgetbaseline
- New baseline of @widget, or -1transform
- Transformation to be applied to @widget
-
childFocus
public boolean childFocus(int direction) Called by widgets as the user moves around the window using
keyboard shortcuts.
The @direction argument indicates what kind of motion is taking place (up,
down, left, right, tab forward, tab backward).
This function calls the [vfunc@Gtk.Widget.focus] virtual function; widgets
can override the virtual function in order to implement appropriate focus
behavior.
The default `focus()` virtual function for a widget should return `TRUE` if
moving in @direction left the focus on a focusable location inside that
widget, and `FALSE` if moving in @direction moved the focus outside the
widget. When returning `TRUE`, widgets normally call [method@Gtk.Widget.grab_focus]
to place the focus accordingly; when returning `FALSE`, they don’t modify
the current focus location.
This function is used by custom widget implementations; if you're
writing an app, you’d use [method@Gtk.Widget.grab_focus] to move
the focus to a particular widget.- Parameters:
direction
- direction of focus movement- Returns:
- %TRUE if focus ended up inside @widget
-
computeBounds
Computes the bounds for @widget in the coordinate space of @target.
FIXME: Explain what "bounds" are.
If the operation is successful, %TRUE is returned. If @widget has no
bounds or the bounds cannot be expressed in @target's coordinate space
(for example if both widgets are in different windows), %FALSE is
returned and @bounds is set to the zero rectangle.
It is valid for @widget and @target to be the same widget.- Parameters:
target
- the `GtkWidget`out_bounds
- the rectangle taking the bounds- Returns:
- %TRUE if the bounds could be computed
-
computeExpand
public boolean computeExpand(int orientation) Computes whether a container should give this widget
extra space when possible.
Containers should check this, rather than looking at
[method@Gtk.Widget.get_hexpand] or [method@Gtk.Widget.get_vexpand].
This function already checks whether the widget is visible, so
visibility does not need to be checked separately. Non-visible
widgets are not expanded.
The computed expand value uses either the expand setting explicitly
set on the widget itself, or, if none has been explicitly set,
the widget may expand if some of its children do.- Parameters:
orientation
- expand direction- Returns:
- whether widget tree rooted here should be expanded
-
computePoint
Translates the given @point in @widget's coordinates to coordinates
relative to @target’s coordinate system.
In order to perform this operation, both widgets must share a
common ancestor.- Parameters:
target
- the `GtkWidget` to transform intopoint
- a point in @widget's coordinate systemout_point
- Set to the corresponding coordinates in @target's coordinate system- Returns:
- %TRUE if the point could be determined, %FALSE on failure. In this case, 0 is stored in @out_point.
-
computeTransform
Computes a matrix suitable to describe a transformation from
@widget's coordinate system into @target's coordinate system.
The transform can not be computed in certain cases, for example
when @widget and @target do not share a common ancestor. In that
case @out_transform gets set to the identity matrix.- Parameters:
target
- the target widget that the matrix will transform toout_transform
- location to store the final transformation- Returns:
- %TRUE if the transform could be computed, %FALSE otherwise
-
contains
public boolean contains(double x, double y) Tests if the point at (@x, @y) is contained in @widget.
The coordinates for (@x, @y) must be in widget coordinates, so
(0, 0) is assumed to be the top left of @widget's content area.- Parameters:
x
- X coordinate to test, relative to @widget's originy
- Y coordinate to test, relative to @widget's origin- Returns:
- %TRUE if @widget contains (@x, @y).
-
createPangoContext
Creates a new `PangoContext` with the appropriate font map,
font options, font description, and base direction for drawing
text for this widget.
See also [method@Gtk.Widget.get_pango_context].- Returns:
- the new `PangoContext`
-
createPangoLayout
Creates a new `PangoLayout` with the appropriate font map,
font description, and base direction for drawing text for
this widget.
If you keep a `PangoLayout` created in this way around,
you need to re-create it when the widget `PangoContext`
is replaced. This can be tracked by listening to changes
of the [property@Gtk.Widget:root] property on the widget.- Parameters:
text
- text to set on the layout- Returns:
- the new `PangoLayout`
-
createPangoLayout
Creates a new `PangoLayout` with the appropriate font map,
font description, and base direction for drawing text for
this widget.
If you keep a `PangoLayout` created in this way around,
you need to re-create it when the widget `PangoContext`
is replaced. This can be tracked by listening to changes
of the [property@Gtk.Widget:root] property on the widget.- Parameters:
text
- text to set on the layout- Returns:
- the new `PangoLayout`
-
disposeTemplate
public void disposeTemplate(long widget_type) Clears the template children for the given widget.
This function is the opposite of [method@Gtk.Widget.init_template], and
it is used to clear all the template children from a widget instance.
If you bound a template child to a field in the instance structure, or
in the instance private data structure, the field will be set to `NULL`
after this function returns.
You should call this function inside the `GObjectClass.dispose()`
implementation of any widget that called `gtk_widget_init_template()`.
Typically, you will want to call this function last, right before
chaining up to the parent type's dispose implementation, e.g.
```c
static void
some_widget_dispose (GObject *gobject)
{
SomeWidget *self = SOME_WIDGET (gobject);
// Clear the template data for SomeWidget
gtk_widget_dispose_template (GTK_WIDGET (self), SOME_TYPE_WIDGET);
G_OBJECT_CLASS (some_widget_parent_class)->dispose (gobject);
}
```- Parameters:
widget_type
- the type of the widget to finalize the template for
-
dragCheckThreshold
public boolean dragCheckThreshold(int start_x, int start_y, int current_x, int current_y) Checks to see if a drag movement has passed the GTK drag threshold.- Parameters:
start_x
- X coordinate of start of dragstart_y
- Y coordinate of start of dragcurrent_x
- current X coordinatecurrent_y
- current Y coordinate- Returns:
- %TRUE if the drag threshold has been passed.
-
errorBell
public void errorBell()Notifies the user about an input-related error on this widget.
If the [property@Gtk.Settings:gtk-error-bell] setting is %TRUE,
it calls [method@Gdk.Surface.beep], otherwise it does nothing.
Note that the effect of [method@Gdk.Surface.beep] can be configured
in many ways, depending on the windowing backend and the desktop
environment or window manager that is used. -
getAllocatedBaseline
public int getAllocatedBaseline()Returns the baseline that has currently been allocated to @widget.
This function is intended to be used when implementing handlers
for the `GtkWidget`Class.snapshot() function, and when allocating
child widgets in `GtkWidget`Class.size_allocate().- Returns:
- the baseline of the @widget, or -1 if none
-
getAllocatedHeight
public int getAllocatedHeight()Returns the height that has currently been allocated to @widget.- Returns:
- the height of the @widget
-
getAllocatedWidth
public int getAllocatedWidth()Returns the width that has currently been allocated to @widget.- Returns:
- the width of the @widget
-
getAllocation
Retrieves the widget’s allocation.
Note, when implementing a layout container: a widget’s allocation
will be its “adjusted” allocation, that is, the widget’s parent
typically calls [method@Gtk.Widget.size_allocate] with an allocation,
and that allocation is then adjusted (to handle margin
and alignment for example) before assignment to the widget.
[method@Gtk.Widget.get_allocation] returns the adjusted allocation that
was actually assigned to the widget. The adjusted allocation is
guaranteed to be completely contained within the
[method@Gtk.Widget.size_allocate] allocation, however.
So a layout container is guaranteed that its children stay inside
the assigned bounds, but not that they have exactly the bounds the
container assigned.- Parameters:
allocation
- a pointer to a `GtkAllocation` to copy to
-
getAncestor
Gets the first ancestor of @widget with type @widget_type.
For example, `gtk_widget_get_ancestor (widget, GTK_TYPE_BOX)`
gets the first `GtkBox` that’s an ancestor of @widget. No
reference will be added to the returned widget; it should
not be unreferenced.
Note that unlike [method@Gtk.Widget.is_ancestor], this function
considers @widget to be an ancestor of itself.- Parameters:
widget_type
- ancestor type- Returns:
- the ancestor widget
-
getCanFocus
public boolean getCanFocus()Determines whether the input focus can enter @widget or any
of its children.
See [method@Gtk.Widget.set_focusable].- Returns:
- %TRUE if the input focus can enter @widget, %FALSE otherwise
-
getCanTarget
public boolean getCanTarget()Queries whether @widget can be the target of pointer events.- Returns:
- %TRUE if @widget can receive pointer events
-
getChildVisible
public boolean getChildVisible()Gets the value set with gtk_widget_set_child_visible().
If you feel a need to use this function, your code probably
needs reorganization.
This function is only useful for container implementations
and should never be called by an application.- Returns:
- %TRUE if the widget is mapped with the parent.
-
getClipboard
Gets the clipboard object for @widget.
This is a utility function to get the clipboard object for the
`GdkDisplay` that @widget is using.
Note that this function always works, even when @widget is not
realized yet.- Returns:
- the appropriate clipboard object
-
getCssClasses
Returns the list of style classes applied to @widget.- Returns:
- a %NULL-terminated list of css classes currently applied to @widget. The returned list must freed using g_strfreev().
-
getCssName
Returns the CSS name that is used for @self.- Returns:
- the CSS name
-
getCursor
Queries the cursor set on @widget.
See [method@Gtk.Widget.set_cursor] for details.- Returns:
- the cursor currently in use or %NULL if the cursor is inherited
-
getDirection
public int getDirection()Gets the reading direction for a particular widget.
See [method@Gtk.Widget.set_direction].- Returns:
- the reading direction for the widget.
-
getDisplay
Get the `GdkDisplay` for the toplevel window associated with
this widget.
This function can only be called after the widget has been
added to a widget hierarchy with a `GtkWindow` at the top.
In general, you should only create display specific
resources when a widget has been realized, and you should
free those resources when the widget is unrealized.- Returns:
- the `GdkDisplay` for the toplevel for this widget.
-
getFirstChild
Returns the widgets first child.
This API is primarily meant for widget implementations.- Returns:
- The widget's first child
-
getFocusChild
Returns the current focus child of @widget.- Returns:
- The current focus child of @widget
-
getFocusOnClick
public boolean getFocusOnClick()Returns whether the widget should grab focus when it is clicked
with the mouse.
See [method@Gtk.Widget.set_focus_on_click].- Returns:
- %TRUE if the widget should grab focus when it is clicked with the mouse
-
getFocusable
public boolean getFocusable()Determines whether @widget can own the input focus.
See [method@Gtk.Widget.set_focusable].- Returns:
- %TRUE if @widget can own the input focus, %FALSE otherwise
-
getFontMap
Gets the font map of @widget.
See [method@Gtk.Widget.set_font_map].- Returns:
- A `PangoFontMap`
-
getFontOptions
Returns the `cairo_font_options_t` of widget.
Seee [method@Gtk.Widget.set_font_options].- Returns:
- the `cairo_font_options_t` of widget
-
getFrameClock
Obtains the frame clock for a widget.
The frame clock is a global “ticker” that can be used to drive
animations and repaints. The most common reason to get the frame
clock is to call [method@Gdk.FrameClock.get_frame_time], in order
to get a time to use for animating. For example you might record
the start of the animation with an initial value from
[method@Gdk.FrameClock.get_frame_time], and then update the animation
by calling [method@Gdk.FrameClock.get_frame_time] again during each repaint.
[method@Gdk.FrameClock.request_phase] will result in a new frame on the
clock, but won’t necessarily repaint any widgets. To repaint a
widget, you have to use [method@Gtk.Widget.queue_draw] which invalidates
the widget (thus scheduling it to receive a draw on the next
frame). gtk_widget_queue_draw() will also end up requesting a frame
on the appropriate frame clock.
A widget’s frame clock will not change while the widget is
mapped. Reparenting a widget (which implies a temporary unmap) can
change the widget’s frame clock.
Unrealized widgets do not have a frame clock.- Returns:
- a `GdkFrameClock`
-
getHalign
public int getHalign()Gets the horizontal alignment of @widget.
For backwards compatibility reasons this method will never return
%GTK_ALIGN_BASELINE, but instead it will convert it to
%GTK_ALIGN_FILL. Baselines are not supported for horizontal
alignment.- Returns:
- the horizontal alignment of @widget
-
getHasTooltip
public boolean getHasTooltip()Returns the current value of the `has-tooltip` property.- Returns:
- current value of `has-tooltip` on @widget.
-
getHeight
public int getHeight()Returns the content height of the widget.
This function returns the height passed to its
size-allocate implementation, which is the height you
should be using in [vfunc@Gtk.Widget.snapshot].
For pointer events, see [method@Gtk.Widget.contains].- Returns:
- The height of @widget
-
getHexpand
public boolean getHexpand()Gets whether the widget would like any available extra horizontal
space.
When a user resizes a `GtkWindow`, widgets with expand=TRUE
generally receive the extra space. For example, a list or
scrollable area or document in your window would often be set to
expand.
Containers should use [method@Gtk.Widget.compute_expand] rather
than this function, to see whether a widget, or any of its children,
has the expand flag set. If any child of a widget wants to
expand, the parent may ask to expand also.
This function only looks at the widget’s own hexpand flag, rather
than computing whether the entire widget tree rooted at this widget
wants to expand.- Returns:
- whether hexpand flag is set
-
getHexpandSet
public boolean getHexpandSet()Gets whether gtk_widget_set_hexpand() has been used
to explicitly set the expand flag on this widget.
If [property@Gtk.Widget:hexpand] property is set, then it
overrides any computed expand value based on child widgets.
If `hexpand` is not set, then the expand value depends on
whether any children of the widget would like to expand.
There are few reasons to use this function, but it’s here
for completeness and consistency.- Returns:
- whether hexpand has been explicitly set
-
getLastChild
Returns the widgets last child.
This API is primarily meant for widget implementations.- Returns:
- The widget's last child
-
getLayoutManager
Retrieves the layout manager used by @widget.
See [method@Gtk.Widget.set_layout_manager].- Returns:
- a `GtkLayoutManager`
-
getMapped
public boolean getMapped()Whether the widget is mapped.- Returns:
- %TRUE if the widget is mapped, %FALSE otherwise.
-
getMarginBottom
public int getMarginBottom()Gets the bottom margin of @widget.- Returns:
- The bottom margin of @widget
-
getMarginEnd
public int getMarginEnd()Gets the end margin of @widget.- Returns:
- The end margin of @widget
-
getMarginStart
public int getMarginStart()Gets the start margin of @widget.- Returns:
- The start margin of @widget
-
getMarginTop
public int getMarginTop()Gets the top margin of @widget.- Returns:
- The top margin of @widget
-
getName
Retrieves the name of a widget.
See [method@Gtk.Widget.set_name] for the significance of widget names.- Returns:
- name of the widget. This string is owned by GTK and should not be modified or freed
-
getNative
Returns the nearest `GtkNative` ancestor of @widget.
This function will return %NULL if the widget is not
contained inside a widget tree with a native ancestor.
`GtkNative` widgets will return themselves here.- Returns:
- the `GtkNative` ancestor of @widget
-
getNextSibling
Returns the widgets next sibling.
This API is primarily meant for widget implementations.- Returns:
- The widget's next sibling
-
getOpacity
public double getOpacity()#Fetches the requested opacity for this widget.
See [method@Gtk.Widget.set_opacity].- Returns:
- the requested opacity for this widget.
-
getOverflow
public int getOverflow()Returns the widgets overflow value.- Returns:
- The widget's overflow.
-
getPangoContext
Gets a `PangoContext` with the appropriate font map, font description,
and base direction for this widget.
Unlike the context returned by [method@Gtk.Widget.create_pango_context],
this context is owned by the widget (it can be used until the screen
for the widget changes or the widget is removed from its toplevel),
and will be updated to match any changes to the widget’s attributes.
This can be tracked by listening to changes of the
[property@Gtk.Widget:root] property on the widget.- Returns:
- the `PangoContext` for the widget.
-
getParent
Returns the parent widget of @widget.- Returns:
- the parent widget of @widget
-
getPreferredSize
public void getPreferredSize(@Nullable Requisition minimum_size, @Nullable Requisition natural_size) Retrieves the minimum and natural size of a widget, taking
into account the widget’s preference for height-for-width management.
This is used to retrieve a suitable size by container widgets which do
not impose any restrictions on the child placement. It can be used
to deduce toplevel window and menu sizes as well as child widgets in
free-form containers such as `GtkFixed`.
Handle with care. Note that the natural height of a height-for-width
widget will generally be a smaller size than the minimum height, since
the required height for the natural width is generally smaller than the
required height for the minimum width.
Use [id@gtk_widget_measure] if you want to support baseline alignment.- Parameters:
minimum_size
- location for storing the minimum sizenatural_size
- location for storing the natural size
-
getPrevSibling
Returns the widgets previous sibling.
This API is primarily meant for widget implementations.- Returns:
- The widget's previous sibling
-
getPrimaryClipboard
Gets the primary clipboard of @widget.
This is a utility function to get the primary clipboard object
for the `GdkDisplay` that @widget is using.
Note that this function always works, even when @widget is not
realized yet.- Returns:
- the appropriate clipboard object
-
getRealized
public boolean getRealized()Determines whether @widget is realized.- Returns:
- %TRUE if @widget is realized, %FALSE otherwise
-
getReceivesDefault
public boolean getReceivesDefault()Determines whether @widget is always treated as the default widget
within its toplevel when it has the focus, even if another widget
is the default.
See [method@Gtk.Widget.set_receives_default].- Returns:
- %TRUE if @widget acts as the default widget when focused, %FALSE otherwise
-
getRequestMode
public int getRequestMode()Gets whether the widget prefers a height-for-width layout
or a width-for-height layout.
Single-child widgets generally propagate the preference of
their child, more complex widgets need to request something
either in context of their children or in context of their
allocation capabilities.- Returns:
- The `GtkSizeRequestMode` preferred by @widget.
-
getRoot
Returns the `GtkRoot` widget of @widget.
This function will return %NULL if the widget is not contained
inside a widget tree with a root widget.
`GtkRoot` widgets will return themselves here.- Returns:
- the root widget of @widget
-
getScaleFactor
public int getScaleFactor()Retrieves the internal scale factor that maps from window
coordinates to the actual device pixels.
On traditional systems this is 1, on high density outputs,
it can be a higher value (typically 2).
See [method@Gdk.Surface.get_scale_factor].- Returns:
- the scale factor for @widget
-
getSensitive
public boolean getSensitive()Returns the widget’s sensitivity.
This function returns the value that has been set using
[method@Gtk.Widget.set_sensitive]).
The effective sensitivity of a widget is however determined
by both its own and its parent widget’s sensitivity.
See [method@Gtk.Widget.is_sensitive].- Returns:
- %TRUE if the widget is sensitive
-
getSettings
Gets the settings object holding the settings used for this widget.
Note that this function can only be called when the `GtkWidget`
is attached to a toplevel, since the settings object is specific
to a particular `GdkDisplay`. If you want to monitor the widget for
changes in its settings, connect to the `notify::display` signal.- Returns:
- the relevant `GtkSettings` object
-
getSize
public int getSize(int orientation) Returns the content width or height of the widget.
Which dimension is returned depends on @orientation.
This is equivalent to calling [method@Gtk.Widget.get_width]
for %GTK_ORIENTATION_HORIZONTAL or [method@Gtk.Widget.get_height]
for %GTK_ORIENTATION_VERTICAL, but can be used when
writing orientation-independent code, such as when
implementing [iface@Gtk.Orientable] widgets.- Parameters:
orientation
- the orientation to query- Returns:
- The size of @widget in @orientation.
-
getSizeRequest
Gets the size request that was explicitly set for the widget using
gtk_widget_set_size_request().
A value of -1 stored in @width or @height indicates that that
dimension has not been set explicitly and the natural requisition
of the widget will be used instead. See
[method@Gtk.Widget.set_size_request]. To get the size a widget will
actually request, call [method@Gtk.Widget.measure] instead of
this function.- Parameters:
width
- return location for widthheight
- return location for height
-
getStateFlags
public int getStateFlags()Returns the widget state as a flag set.
It is worth mentioning that the effective %GTK_STATE_FLAG_INSENSITIVE
state will be returned, that is, also based on parent insensitivity,
even if @widget itself is sensitive.
Also note that if you are looking for a way to obtain the
[flags@Gtk.StateFlags] to pass to a [class@Gtk.StyleContext]
method, you should look at [method@Gtk.StyleContext.get_state].- Returns:
- The state flags for widget
-
getStyleContext
Returns the style context associated to @widget.
The returned object is guaranteed to be the same
for the lifetime of @widget.- Returns:
- the widgets `GtkStyleContext`
-
getTemplateChild
Fetch an object build from the template XML for @widget_type in
this @widget instance.
This will only report children which were previously declared
with [method@Gtk.WidgetClass.bind_template_child_full] or one of its
variants.
This function is only meant to be called for code which is private
to the @widget_type which declared the child and is meant for language
bindings which cannot easily make use of the GObject structure offsets.- Parameters:
widget_type
- The `GType` to get a template child forname
- The “id” of the child defined in the template XML- Returns:
- The object built in the template XML with the id @name
-
getTemplateChild
Fetch an object build from the template XML for @widget_type in
this @widget instance.
This will only report children which were previously declared
with [method@Gtk.WidgetClass.bind_template_child_full] or one of its
variants.
This function is only meant to be called for code which is private
to the @widget_type which declared the child and is meant for language
bindings which cannot easily make use of the GObject structure offsets.- Parameters:
widget_type
- The `GType` to get a template child forname
- The “id” of the child defined in the template XML- Returns:
- The object built in the template XML with the id @name
-
getTooltipMarkup
Gets the contents of the tooltip for @widget.
If the tooltip has not been set using
[method@Gtk.Widget.set_tooltip_markup], this
function returns %NULL.- Returns:
- the tooltip text
-
getTooltipText
Gets the contents of the tooltip for @widget.
If the @widget's tooltip was set using
[method@Gtk.Widget.set_tooltip_markup],
this function will return the escaped text.- Returns:
- the tooltip text
-
getValign
public int getValign()Gets the vertical alignment of @widget.- Returns:
- the vertical alignment of @widget
-
getVexpand
public boolean getVexpand()Gets whether the widget would like any available extra vertical
space.
See [method@Gtk.Widget.get_hexpand] for more detail.- Returns:
- whether vexpand flag is set
-
getVexpandSet
public boolean getVexpandSet()Gets whether gtk_widget_set_vexpand() has been used to
explicitly set the expand flag on this widget.
See [method@Gtk.Widget.get_hexpand_set] for more detail.- Returns:
- whether vexpand has been explicitly set
-
getVisible
public boolean getVisible()Determines whether the widget is visible.
If you want to take into account whether the widget’s
parent is also marked as visible, use
[method@Gtk.Widget.is_visible] instead.
This function does not check if the widget is
obscured in any way.
See [method@Gtk.Widget.set_visible].- Returns:
- %TRUE if the widget is visible
-
getWidth
public int getWidth()Returns the content width of the widget.
This function returns the width passed to its
size-allocate implementation, which is the width you
should be using in [vfunc@Gtk.Widget.snapshot].
For pointer events, see [method@Gtk.Widget.contains].- Returns:
- The width of @widget
-
grabFocus
public boolean grabFocus()Causes @widget to have the keyboard focus for the `GtkWindow` it's inside.
If @widget is not focusable, or its [vfunc@Gtk.Widget.grab_focus]
implementation cannot transfer the focus to a descendant of @widget
that is focusable, it will not take focus and %FALSE will be returned.
Calling [method@Gtk.Widget.grab_focus] on an already focused widget
is allowed, should not have an effect, and return %TRUE.- Returns:
- %TRUE if focus is now inside @widget.
-
hasCssClass
Returns whether @css_class is currently applied to @widget.- Parameters:
css_class
- A style class, without the leading '.' used for notation of style classes- Returns:
- %TRUE if @css_class is currently applied to @widget, %FALSE otherwise.
-
hasCssClass
Returns whether @css_class is currently applied to @widget.- Parameters:
css_class
- A style class, without the leading '.' used for notation of style classes- Returns:
- %TRUE if @css_class is currently applied to @widget, %FALSE otherwise.
-
hasDefault
public boolean hasDefault()Determines whether @widget is the current default widget
within its toplevel.- Returns:
- %TRUE if @widget is the current default widget within its toplevel, %FALSE otherwise
-
hasFocus
public boolean hasFocus()Determines if the widget has the global input focus.
See [method@Gtk.Widget.is_focus] for the difference between
having the global input focus, and only having the focus
within a toplevel.- Returns:
- %TRUE if the widget has the global input focus.
-
hasVisibleFocus
public boolean hasVisibleFocus()Determines if the widget should show a visible indication that
it has the global input focus.
This is a convenience function that takes into account whether
focus indication should currently be shown in the toplevel window
of @widget. See [method@Gtk.Window.get_focus_visible] for more
information about focus indication.
To find out if the widget has the global input focus, use
[method@Gtk.Widget.has_focus].- Returns:
- %TRUE if the widget should display a “focus rectangle”
-
hide
public void hide()Reverses the effects of gtk_widget_show().
This is causing the widget to be hidden (invisible to the user). -
inDestruction
public boolean inDestruction()Returns whether the widget is currently being destroyed.
This information can sometimes be used to avoid doing
unnecessary work.- Returns:
- %TRUE if @widget is being destroyed
-
initTemplate
public void initTemplate()Creates and initializes child widgets defined in templates.
This function must be called in the instance initializer
for any class which assigned itself a template using
[method@Gtk.WidgetClass.set_template].
It is important to call this function in the instance initializer
of a `GtkWidget` subclass and not in `GObject.constructed()` or
`GObject.constructor()` for two reasons:
- derived widgets will assume that the composite widgets
defined by its parent classes have been created in their
relative instance initializers
- when calling `g_object_new()` on a widget with composite templates,
it’s important to build the composite widgets before the construct
properties are set. Properties passed to `g_object_new()` should
take precedence over properties set in the private template XML
A good rule of thumb is to call this function as the first thing in
an instance initialization function. -
insertActionGroup
Inserts @group into @widget.
Children of @widget that implement [iface@Gtk.Actionable] can
then be associated with actions in @group by setting their
“action-name” to @prefix.`action-name`.
Note that inheritance is defined for individual actions. I.e.
even if you insert a group with prefix @prefix, actions with
the same prefix will still be inherited from the parent, unless
the group contains an action with the same name.
If @group is %NULL, a previously inserted group for @name is
removed from @widget.- Parameters:
name
- the prefix for actions in @groupgroup
- a `GActionGroup`, or %NULL to remove the previously inserted group for @name
-
insertActionGroup
Inserts @group into @widget.
Children of @widget that implement [iface@Gtk.Actionable] can
then be associated with actions in @group by setting their
“action-name” to @prefix.`action-name`.
Note that inheritance is defined for individual actions. I.e.
even if you insert a group with prefix @prefix, actions with
the same prefix will still be inherited from the parent, unless
the group contains an action with the same name.
If @group is %NULL, a previously inserted group for @name is
removed from @widget.- Parameters:
name
- the prefix for actions in @groupgroup
- a `GActionGroup`, or %NULL to remove the previously inserted group for @name
-
insertAfter
Inserts @widget into the child widget list of @parent.
It will be placed after @previous_sibling, or at the beginning if
@previous_sibling is %NULL.
After calling this function, `gtk_widget_get_prev_sibling(widget)`
will return @previous_sibling.
If @parent is already set as the parent widget of @widget, this
function can also be used to reorder @widget in the child widget
list of @parent.
This API is primarily meant for widget implementations; if you are
just using a widget, you *must* use its own API for adding children.- Parameters:
parent
- the parent `GtkWidget` to insert @widget intoprevious_sibling
- the new previous sibling of @widget
-
insertBefore
Inserts @widget into the child widget list of @parent.
It will be placed before @next_sibling, or at the end if
@next_sibling is %NULL.
After calling this function, `gtk_widget_get_next_sibling(widget)`
will return @next_sibling.
If @parent is already set as the parent widget of @widget, this function
can also be used to reorder @widget in the child widget list of @parent.
This API is primarily meant for widget implementations; if you are
just using a widget, you *must* use its own API for adding children.- Parameters:
parent
- the parent `GtkWidget` to insert @widget intonext_sibling
- the new next sibling of @widget
-
isAncestor
Determines whether @widget is somewhere inside @ancestor,
possibly with intermediate containers.- Parameters:
ancestor
- another `GtkWidget`- Returns:
- %TRUE if @ancestor contains @widget as a child, grandchild, great grandchild, etc.
-
isDrawable
public boolean isDrawable()Determines whether @widget can be drawn to.
A widget can be drawn if it is mapped and visible.- Returns:
- %TRUE if @widget is drawable, %FALSE otherwise
-
isFocus
public boolean isFocus()Determines if the widget is the focus widget within its
toplevel.
This does not mean that the [property@Gtk.Widget:has-focus]
property is necessarily set; [property@Gtk.Widget:has-focus]
will only be set if the toplevel widget additionally has the
global input focus.- Returns:
- %TRUE if the widget is the focus widget.
-
isSensitive
public boolean isSensitive()Returns the widget’s effective sensitivity.
This means it is sensitive itself and also its
parent widget is sensitive.- Returns:
- %TRUE if the widget is effectively sensitive
-
isVisible
public boolean isVisible()Determines whether the widget and all its parents are marked as
visible.
This function does not check if the widget is obscured in any way.
See also [method@Gtk.Widget.get_visible] and
[method@Gtk.Widget.set_visible].- Returns:
- %TRUE if the widget and all its parents are visible
-
listMnemonicLabels
Returns the widgets for which this widget is the target of a
mnemonic.
Typically, these widgets will be labels. See, for example,
[method@Gtk.Label.set_mnemonic_widget].
The widgets in the list are not individually referenced.
If you want to iterate through the list and perform actions
involving callbacks that might destroy the widgets, you
must call `g_list_foreach (result, (GFunc)g_object_ref, NULL)`
first, and then unref all the widgets afterwards.- Returns:
- the list of mnemonic labels; free this list with g_list_free() when you are done with it.
-
map
public void map()Causes a widget to be mapped if it isn’t already.
This function is only for use in widget implementations. -
measure
public void measure(int orientation, int for_size, @Nullable Int minimum, @Nullable Int natural, @Nullable Int minimum_baseline, @Nullable Int natural_baseline) Measures @widget in the orientation @orientation and for the given @for_size.
As an example, if @orientation is %GTK_ORIENTATION_HORIZONTAL and @for_size
is 300, this functions will compute the minimum and natural width of @widget
if it is allocated at a height of 300 pixels.
See [GtkWidget’s geometry management section](class.Widget.html#height-for-width-geometry-management) for
a more details on implementing `GtkWidgetClass.measure()`.- Parameters:
orientation
- the orientation to measurefor_size
- Size for the opposite of @orientation, i.e. if @orientation is %GTK_ORIENTATION_HORIZONTAL, this is the height the widget should be measured with. The %GTK_ORIENTATION_VERTICAL case is analogous. This way, both height-for-width and width-for-height requests can be implemented. If no size is known, -1 can be passed.minimum
- location to store the minimum sizenatural
- location to store the natural sizeminimum_baseline
- location to store the baseline position for the minimum size, or -1 to report no baselinenatural_baseline
- location to store the baseline position for the natural size, or -1 to report no baseline
-
mnemonicActivate
public boolean mnemonicActivate(boolean group_cycling) Emits the ::mnemonic-activate signal.
See [signal@Gtk.Widget::mnemonic-activate].- Parameters:
group_cycling
- %TRUE if there are other widgets with the same mnemonic- Returns:
- %TRUE if the signal has been handled
-
observeChildren
Returns a `GListModel` to track the children of @widget.
Calling this function will enable extra internal bookkeeping
to track children and emit signals on the returned listmodel.
It may slow down operations a lot.
Applications should try hard to avoid calling this function
because of the slowdowns.- Returns:
- a `GListModel` tracking @widget's children
-
observeControllers
Returns a `GListModel` to track the [class@Gtk.EventController]s
of @widget.
Calling this function will enable extra internal bookkeeping
to track controllers and emit signals on the returned listmodel.
It may slow down operations a lot.
Applications should try hard to avoid calling this function
because of the slowdowns.- Returns:
- a `GListModel` tracking @widget's controllers
-
pick
Finds the descendant of @widget closest to the point (@x, @y).
The point must be given in widget coordinates, so (0, 0) is assumed
to be the top left of @widget's content area.
Usually widgets will return %NULL if the given coordinate is not
contained in @widget checked via [method@Gtk.Widget.contains].
Otherwise they will recursively try to find a child that does
not return %NULL. Widgets are however free to customize their
picking algorithm.
This function is used on the toplevel to determine the widget
below the mouse cursor for purposes of hover highlighting and
delivering events.- Parameters:
x
- X coordinate to test, relative to @widget's originy
- Y coordinate to test, relative to @widget's originflags
- Flags to influence what is picked- Returns:
- The widget descendant at the given point
-
queueAllocate
public void queueAllocate()Flags the widget for a rerun of the [vfunc@Gtk.Widget.size_allocate]
function.
Use this function instead of [method@Gtk.Widget.queue_resize]
when the @widget's size request didn't change but it wants to
reposition its contents.
An example user of this function is [method@Gtk.Widget.set_halign].
This function is only for use in widget implementations. -
queueDraw
public void queueDraw()Schedules this widget to be redrawn in the paint phase
of the current or the next frame.
This means @widget's [vfunc@Gtk.Widget.snapshot]
implementation will be called. -
queueResize
public void queueResize()Flags a widget to have its size renegotiated.
This should be called when a widget for some reason has a new
size request. For example, when you change the text in a
[class@Gtk.Label], the label queues a resize to ensure there’s
enough space for the new text.
Note that you cannot call gtk_widget_queue_resize() on a widget
from inside its implementation of the [vfunc@Gtk.Widget.size_allocate]
virtual method. Calls to gtk_widget_queue_resize() from inside
[vfunc@Gtk.Widget.size_allocate] will be silently ignored.
This function is only for use in widget implementations. -
realize
public void realize()Creates the GDK resources associated with a widget.
Normally realization happens implicitly; if you show a widget
and all its parent containers, then the widget will be realized
and mapped automatically.
Realizing a widget requires all the widget’s parent widgets to be
realized; calling this function realizes the widget’s parents
in addition to @widget itself. If a widget is not yet inside a
toplevel window when you realize it, bad things will happen.
This function is primarily used in widget implementations, and
isn’t very useful otherwise. Many times when you think you might
need it, a better approach is to connect to a signal that will be
called after the widget is realized automatically, such as
[signal@Gtk.Widget::realize]. -
removeController
Removes @controller from @widget, so that it doesn't process
events anymore.
It should not be used again.
Widgets will remove all event controllers automatically when they
are destroyed, there is normally no need to call this function.- Parameters:
controller
- a `GtkEventController`
-
removeCssClass
Removes a style from @widget.
After this, the style of @widget will stop matching for @css_class.- Parameters:
css_class
- The style class to remove from @widget, without the leading '.' used for notation of style classes
-
removeCssClass
Removes a style from @widget.
After this, the style of @widget will stop matching for @css_class.- Parameters:
css_class
- The style class to remove from @widget, without the leading '.' used for notation of style classes
-
removeMnemonicLabel
Removes a widget from the list of mnemonic labels for this widget.
See [method@Gtk.Widget.list_mnemonic_labels]. The widget must
have previously been added to the list with
[method@Gtk.Widget.add_mnemonic_label].- Parameters:
label
- a `GtkWidget` that was previously set as a mnemonic label for @widget with [method@Gtk.Widget.add_mnemonic_label]
-
removeTickCallback
public void removeTickCallback(int id) Removes a tick callback previously registered with
gtk_widget_add_tick_callback().- Parameters:
id
- an id returned by [method@Gtk.Widget.add_tick_callback]
-
setCanFocus
public void setCanFocus(boolean can_focus) Specifies whether the input focus can enter the widget
or any of its children.
Applications should set @can_focus to %FALSE to mark a
widget as for pointer/touch use only.
Note that having @can_focus be %TRUE is only one of the
necessary conditions for being focusable. A widget must
also be sensitive and focusable and not have an ancestor
that is marked as not can-focus in order to receive input
focus.
See [method@Gtk.Widget.grab_focus] for actually setting
the input focus on a widget.- Parameters:
can_focus
- whether or not the input focus can enter the widget or any of its children
-
setCanTarget
public void setCanTarget(boolean can_target) Sets whether @widget can be the target of pointer events.- Parameters:
can_target
- whether this widget should be able to receive pointer events
-
setChildVisible
public void setChildVisible(boolean child_visible) Sets whether @widget should be mapped along with its parent.
The child visibility can be set for widget before it is added
to a container with [method@Gtk.Widget.set_parent], to avoid
mapping children unnecessary before immediately unmapping them.
However it will be reset to its default state of %TRUE when the
widget is removed from a container.
Note that changing the child visibility of a widget does not
queue a resize on the widget. Most of the time, the size of
a widget is computed from all visible children, whether or
not they are mapped. If this is not the case, the container
can queue a resize itself.
This function is only useful for container implementations
and should never be called by an application.- Parameters:
child_visible
- if %TRUE, @widget should be mapped along with its parent.
-
setCssClasses
Clear all style classes applied to @widget
and replace them with @classes.- Parameters:
classes
- %NULL-terminated list of style classes to apply to @widget.
-
setCursor
Sets the cursor to be shown when pointer devices point
towards @widget.
If the @cursor is NULL, @widget will use the cursor
inherited from the parent widget.- Parameters:
cursor
- the new cursor
-
setCursorFromName
Sets a named cursor to be shown when pointer devices point
towards @widget.
This is a utility function that creates a cursor via
[ctor@Gdk.Cursor.new_from_name] and then sets it on @widget
with [method@Gtk.Widget.set_cursor]. See those functions for
details.
On top of that, this function allows @name to be %NULL, which
will do the same as calling [method@Gtk.Widget.set_cursor]
with a %NULL cursor.- Parameters:
name
- The name of the cursor
-
setCursorFromName
Sets a named cursor to be shown when pointer devices point
towards @widget.
This is a utility function that creates a cursor via
[ctor@Gdk.Cursor.new_from_name] and then sets it on @widget
with [method@Gtk.Widget.set_cursor]. See those functions for
details.
On top of that, this function allows @name to be %NULL, which
will do the same as calling [method@Gtk.Widget.set_cursor]
with a %NULL cursor.- Parameters:
name
- The name of the cursor
-
setDirection
public void setDirection(int dir) Sets the reading direction on a particular widget.
This direction controls the primary direction for widgets
containing text, and also the direction in which the children
of a container are packed. The ability to set the direction is
present in order so that correct localization into languages with
right-to-left reading directions can be done. Generally, applications
will let the default reading direction present, except for containers
where the containers are arranged in an order that is explicitly
visual rather than logical (such as buttons for text justification).
If the direction is set to %GTK_TEXT_DIR_NONE, then the value
set by [func@Gtk.Widget.set_default_direction] will be used.- Parameters:
dir
- the new direction
-
setFocusChild
Set @child as the current focus child of @widget.
This function is only suitable for widget implementations.
If you want a certain widget to get the input focus, call
[method@Gtk.Widget.grab_focus] on it.- Parameters:
child
- a direct child widget of @widget or %NULL to unset the focus child of @widget
-
setFocusOnClick
public void setFocusOnClick(boolean focus_on_click) Sets whether the widget should grab focus when it is clicked
with the mouse.
Making mouse clicks not grab focus is useful in places like
toolbars where you don’t want the keyboard focus removed from
the main area of the application.- Parameters:
focus_on_click
- whether the widget should grab focus when clicked with the mouse
-
setFocusable
public void setFocusable(boolean focusable) Specifies whether @widget can own the input focus.
Widget implementations should set @focusable to %TRUE in
their init() function if they want to receive keyboard input.
Note that having @focusable be %TRUE is only one of the
necessary conditions for being focusable. A widget must
also be sensitive and can-focus and not have an ancestor
that is marked as not can-focus in order to receive input
focus.
See [method@Gtk.Widget.grab_focus] for actually setting
the input focus on a widget.- Parameters:
focusable
- whether or not @widget can own the input focus
-
setFontMap
Sets the font map to use for Pango rendering.
The font map is the object that is used to look up fonts.
Setting a custom font map can be useful in special situations,
e.g. when you need to add application-specific fonts to the set
of available fonts.
When not set, the widget will inherit the font map from its parent.- Parameters:
font_map
- a `PangoFontMap`, or %NULL to unset any previously set font map
-
setFontOptions
Sets the `cairo_font_options_t` used for Pango rendering
in this widget.
When not set, the default font options for the `GdkDisplay`
will be used.- Parameters:
options
- a `cairo_font_options_t` to unset any previously set default font options
-
setHalign
public void setHalign(int align) Sets the horizontal alignment of @widget.- Parameters:
align
- the horizontal alignment
-
setHasTooltip
public void setHasTooltip(boolean has_tooltip) Sets the `has-tooltip` property on @widget to @has_tooltip.- Parameters:
has_tooltip
- whether or not @widget has a tooltip.
-
setHexpand
public void setHexpand(boolean expand) Sets whether the widget would like any available extra horizontal
space.
When a user resizes a `GtkWindow`, widgets with expand=TRUE
generally receive the extra space. For example, a list or
scrollable area or document in your window would often be set to
expand.
Call this function to set the expand flag if you would like your
widget to become larger horizontally when the window has extra
room.
By default, widgets automatically expand if any of their children
want to expand. (To see if a widget will automatically expand given
its current children and state, call [method@Gtk.Widget.compute_expand].
A container can decide how the expandability of children affects the
expansion of the container by overriding the compute_expand virtual
method on `GtkWidget`.).
Setting hexpand explicitly with this function will override the
automatic expand behavior.
This function forces the widget to expand or not to expand,
regardless of children. The override occurs because
[method@Gtk.Widget.set_hexpand] sets the hexpand-set property (see
[method@Gtk.Widget.set_hexpand_set]) which causes the widget’s hexpand
value to be used, rather than looking at children and widget state.- Parameters:
expand
- whether to expand
-
setHexpandSet
public void setHexpandSet(boolean set) Sets whether the hexpand flag will be used.
The [property@Gtk.Widget:hexpand-set] property will be set
automatically when you call [method@Gtk.Widget.set_hexpand]
to set hexpand, so the most likely reason to use this function
would be to unset an explicit expand flag.
If hexpand is set, then it overrides any computed
expand value based on child widgets. If hexpand is not
set, then the expand value depends on whether any
children of the widget would like to expand.
There are few reasons to use this function, but it’s here
for completeness and consistency.- Parameters:
set
- value for hexpand-set property
-
setLayoutManager
Sets the layout manager delegate instance that provides an
implementation for measuring and allocating the children of @widget.- Parameters:
layout_manager
- a `GtkLayoutManager`
-
setMarginBottom
public void setMarginBottom(int margin) Sets the bottom margin of @widget.- Parameters:
margin
- the bottom margin
-
setMarginEnd
public void setMarginEnd(int margin) Sets the end margin of @widget.- Parameters:
margin
- the end margin
-
setMarginStart
public void setMarginStart(int margin) Sets the start margin of @widget.- Parameters:
margin
- the start margin
-
setMarginTop
public void setMarginTop(int margin) Sets the top margin of @widget.- Parameters:
margin
- the top margin
-
setName
Sets a widgets name.
Setting a name allows you to refer to the widget from a
CSS file. You can apply a style to widgets with a particular name
in the CSS file. See the documentation for the CSS syntax (on the
same page as the docs for [class@Gtk.StyleContext].
Note that the CSS syntax has certain special characters to delimit
and represent elements in a selector (period, #, >, *...), so using
these will make your widget impossible to match by name. Any combination
of alphanumeric symbols, dashes and underscores will suffice.- Parameters:
name
- name for the widget
-
setName
Sets a widgets name.
Setting a name allows you to refer to the widget from a
CSS file. You can apply a style to widgets with a particular name
in the CSS file. See the documentation for the CSS syntax (on the
same page as the docs for [class@Gtk.StyleContext].
Note that the CSS syntax has certain special characters to delimit
and represent elements in a selector (period, #, >, *...), so using
these will make your widget impossible to match by name. Any combination
of alphanumeric symbols, dashes and underscores will suffice.- Parameters:
name
- name for the widget
-
setOpacity
public void setOpacity(double opacity) Request the @widget to be rendered partially transparent.
An opacity of 0 is fully transparent and an opacity of 1
is fully opaque.
Opacity works on both toplevel widgets and child widgets, although
there are some limitations: For toplevel widgets, applying opacity
depends on the capabilities of the windowing system. On X11, this
has any effect only on X displays with a compositing manager,
see gdk_display_is_composited(). On Windows and Wayland it should
always work, although setting a window’s opacity after the window
has been shown may cause some flicker.
Note that the opacity is inherited through inclusion — if you set
a toplevel to be partially translucent, all of its content will
appear translucent, since it is ultimatively rendered on that
toplevel. The opacity value itself is not inherited by child
widgets (since that would make widgets deeper in the hierarchy
progressively more translucent). As a consequence, [class@Gtk.Popover]s
and other [iface@Gtk.Native] widgets with their own surface will use their
own opacity value, and thus by default appear non-translucent,
even if they are attached to a toplevel that is translucent.- Parameters:
opacity
- desired opacity, between 0 and 1
-
setOverflow
public void setOverflow(int overflow) Sets how @widget treats content that is drawn outside the
widget's content area.
See the definition of [enum@Gtk.Overflow] for details.
This setting is provided for widget implementations and
should not be used by application code.
The default value is %GTK_OVERFLOW_VISIBLE.- Parameters:
overflow
- desired overflow
-
setParent
Sets @parent as the parent widget of @widget.
This takes care of details such as updating the state and style
of the child to reflect its new location and resizing the parent.
The opposite function is [method@Gtk.Widget.unparent].
This function is useful only when implementing subclasses of
`GtkWidget`.- Parameters:
parent
- parent widget
-
setReceivesDefault
public void setReceivesDefault(boolean receives_default) Specifies whether @widget will be treated as the default
widget within its toplevel when it has the focus, even if
another widget is the default.- Parameters:
receives_default
- whether or not @widget can be a default widget.
-
setSensitive
public void setSensitive(boolean sensitive) Sets the sensitivity of a widget.
A widget is sensitive if the user can interact with it.
Insensitive widgets are “grayed out” and the user can’t
interact with them. Insensitive widgets are known as
“inactive”, “disabled”, or “ghosted” in some other toolkits.- Parameters:
sensitive
- %TRUE to make the widget sensitive
-
setSizeRequest
public void setSizeRequest(int width, int height) Sets the minimum size of a widget.
That is, the widget’s size request will be at least @width
by @height. You can use this function to force a widget to
be larger than it normally would be.
In most cases, [method@Gtk.Window.set_default_size] is a better
choice for toplevel windows than this function; setting the default
size will still allow users to shrink the window. Setting the size
request will force them to leave the window at least as large as
the size request.
Note the inherent danger of setting any fixed size - themes,
translations into other languages, different fonts, and user action
can all change the appropriate size for a given widget. So, it's
basically impossible to hardcode a size that will always be
correct.
The size request of a widget is the smallest size a widget can
accept while still functioning well and drawing itself correctly.
However in some strange cases a widget may be allocated less than
its requested size, and in many cases a widget may be allocated more
space than it requested.
If the size request in a given direction is -1 (unset), then
the “natural” size request of the widget will be used instead.
The size request set here does not include any margin from the
properties
[property@Gtk.Widget:margin-start],
[property@Gtk.Widget:margin-end],
[property@Gtk.Widget:margin-top], and
[property@Gtk.Widget:margin-bottom], but it does include pretty
much all other padding or border properties set by any subclass
of `GtkWidget`.- Parameters:
width
- width @widget should request, or -1 to unsetheight
- height @widget should request, or -1 to unset
-
setStateFlags
public void setStateFlags(int flags, boolean clear) Turns on flag values in the current widget state.
Typical widget states are insensitive, prelighted, etc.
This function accepts the values %GTK_STATE_FLAG_DIR_LTR and
%GTK_STATE_FLAG_DIR_RTL but ignores them. If you want to set
the widget's direction, use [method@Gtk.Widget.set_direction].
This function is for use in widget implementations.- Parameters:
flags
- State flags to turn onclear
- Whether to clear state before turning on @flags
-
setTooltipMarkup
Sets @markup as the contents of the tooltip, which is marked
up with Pango markup.
This function will take care of setting the
[property@Gtk.Widget:has-tooltip] as a side effect, and of the
default handler for the [signal@Gtk.Widget::query-tooltip] signal.
See also [method@Gtk.Tooltip.set_markup].- Parameters:
markup
- the contents of the tooltip for @widget
-
setTooltipMarkup
Sets @markup as the contents of the tooltip, which is marked
up with Pango markup.
This function will take care of setting the
[property@Gtk.Widget:has-tooltip] as a side effect, and of the
default handler for the [signal@Gtk.Widget::query-tooltip] signal.
See also [method@Gtk.Tooltip.set_markup].- Parameters:
markup
- the contents of the tooltip for @widget
-
setTooltipText
Sets @text as the contents of the tooltip.
If @text contains any markup, it will be escaped.
This function will take care of setting
[property@Gtk.Widget:has-tooltip] as a side effect,
and of the default handler for the
[signal@Gtk.Widget::query-tooltip] signal.
See also [method@Gtk.Tooltip.set_text].- Parameters:
text
- the contents of the tooltip for @widget
-
setTooltipText
Sets @text as the contents of the tooltip.
If @text contains any markup, it will be escaped.
This function will take care of setting
[property@Gtk.Widget:has-tooltip] as a side effect,
and of the default handler for the
[signal@Gtk.Widget::query-tooltip] signal.
See also [method@Gtk.Tooltip.set_text].- Parameters:
text
- the contents of the tooltip for @widget
-
setValign
public void setValign(int align) Sets the vertical alignment of @widget.- Parameters:
align
- the vertical alignment
-
setVexpand
public void setVexpand(boolean expand) Sets whether the widget would like any available extra vertical
space.
See [method@Gtk.Widget.set_hexpand] for more detail.- Parameters:
expand
- whether to expand
-
setVexpandSet
public void setVexpandSet(boolean set) Sets whether the vexpand flag will be used.
See [method@Gtk.Widget.set_hexpand_set] for more detail.- Parameters:
set
- value for vexpand-set property
-
setVisible
public void setVisible(boolean visible) Sets the visibility state of @widget.
Note that setting this to %TRUE doesn’t mean the widget is
actually viewable, see [method@Gtk.Widget.get_visible].
This function simply calls [method@Gtk.Widget.show] or
[method@Gtk.Widget.hide] but is nicer to use when the
visibility of the widget depends on some condition.- Parameters:
visible
- whether the widget should be shown or not
-
shouldLayout
public boolean shouldLayout()Returns whether @widget should contribute to
the measuring and allocation of its parent.
This is %FALSE for invisible children, but also
for children that have their own surface.- Returns:
- %TRUE if child should be included in measuring and allocating
-
show
public void show()Flags a widget to be displayed.
Any widget that isn’t shown will not appear on the screen.
Remember that you have to show the containers containing a widget,
in addition to the widget itself, before it will appear onscreen.
When a toplevel container is shown, it is immediately realized and
mapped; other shown widgets are realized and mapped when their
toplevel container is realized and mapped. -
sizeAllocate
Allocates widget with a transformation that translates
the origin to the position in @allocation.
This is a simple form of [method@Gtk.Widget.allocate].- Parameters:
allocation
- position and size to be allocated to @widgetbaseline
- The baseline of the child, or -1
-
snapshotChild
Snapshot the a child of @widget.
When a widget receives a call to the snapshot function,
it must send synthetic [vfunc@Gtk.Widget.snapshot] calls
to all children. This function provides a convenient way
of doing this. A widget, when it receives a call to its
[vfunc@Gtk.Widget.snapshot] function, calls
gtk_widget_snapshot_child() once for each child, passing in
the @snapshot the widget received.
gtk_widget_snapshot_child() takes care of translating the origin of
@snapshot, and deciding whether the child needs to be snapshot.
This function does nothing for children that implement `GtkNative`.- Parameters:
child
- a child of @widgetsnapshot
- `GtkSnapshot` as passed to the widget. In particular, no calls to gtk_snapshot_translate() or other transform calls should have been made.
-
triggerTooltipQuery
public void triggerTooltipQuery()Triggers a tooltip query on the display where the toplevel
of @widget is located. -
unmap
public void unmap()Causes a widget to be unmapped if it’s currently mapped.
This function is only for use in widget implementations. -
unparent
public void unparent()Dissociate @widget from its parent.
This function is only for use in widget implementations,
typically in dispose. -
unrealize
public void unrealize()Causes a widget to be unrealized (frees all GDK resources
associated with the widget).
This function is only useful in widget implementations. -
unsetStateFlags
public void unsetStateFlags(int flags) Turns off flag values for the current widget state.
See [method@Gtk.Widget.set_state_flags].
This function is for use in widget implementations.- Parameters:
flags
- State flags to turn off
-
onDestroy
Connect to signal "destroy".
SeeWidget.OnDestroy.onDestroy()
for signal description.
FieldSIGNAL_ON_DESTROY
contains original signal name and can be used as resource reference.- Parameters:
signal
- callback function (lambda).- Returns:
SignalHandler
. Can be used to disconnect signal and to release callback function.
-
onDirectionChanged
Connect to signal "direction-changed".
SeeWidget.OnDirectionChanged.onDirectionChanged(int)
for signal description.
FieldSIGNAL_ON_DIRECTION_CHANGED
contains original signal name and can be used as resource reference.- Parameters:
signal
- callback function (lambda).- Returns:
SignalHandler
. Can be used to disconnect signal and to release callback function.
-
onHide
Connect to signal "hide".
SeeWidget.OnHide.onHide()
for signal description.
FieldSIGNAL_ON_HIDE
contains original signal name and can be used as resource reference.- Parameters:
signal
- callback function (lambda).- Returns:
SignalHandler
. Can be used to disconnect signal and to release callback function.
-
onMap
Connect to signal "map".
SeeWidget.OnMap.onMap()
for signal description.
FieldSIGNAL_ON_MAP
contains original signal name and can be used as resource reference.- Parameters:
signal
- callback function (lambda).- Returns:
SignalHandler
. Can be used to disconnect signal and to release callback function.
-
onMnemonicActivate
Connect to signal "mnemonic-activate".
SeeWidget.OnMnemonicActivate.onMnemonicActivate(boolean)
for signal description.
FieldSIGNAL_ON_MNEMONIC_ACTIVATE
contains original signal name and can be used as resource reference.- Parameters:
signal
- callback function (lambda).- Returns:
SignalHandler
. Can be used to disconnect signal and to release callback function.
-
onMoveFocus
Connect to signal "move-focus".
SeeWidget.OnMoveFocus.onMoveFocus(int)
for signal description.
FieldSIGNAL_ON_MOVE_FOCUS
contains original signal name and can be used as resource reference.- Parameters:
signal
- callback function (lambda).- Returns:
SignalHandler
. Can be used to disconnect signal and to release callback function.
-
onQueryTooltip
Connect to signal "query-tooltip".
SeeWidget.OnQueryTooltip.onQueryTooltip(int, int, boolean, ch.bailu.gtk.gtk.Tooltip)
for signal description.
FieldSIGNAL_ON_QUERY_TOOLTIP
contains original signal name and can be used as resource reference.- Parameters:
signal
- callback function (lambda).- Returns:
SignalHandler
. Can be used to disconnect signal and to release callback function.
-
onRealize
Connect to signal "realize".
SeeWidget.OnRealize.onRealize()
for signal description.
FieldSIGNAL_ON_REALIZE
contains original signal name and can be used as resource reference.- Parameters:
signal
- callback function (lambda).- Returns:
SignalHandler
. Can be used to disconnect signal and to release callback function.
-
onShow
Connect to signal "show".
SeeWidget.OnShow.onShow()
for signal description.
FieldSIGNAL_ON_SHOW
contains original signal name and can be used as resource reference.- Parameters:
signal
- callback function (lambda).- Returns:
SignalHandler
. Can be used to disconnect signal and to release callback function.
-
onStateFlagsChanged
Connect to signal "state-flags-changed".
SeeWidget.OnStateFlagsChanged.onStateFlagsChanged(int)
for signal description.
FieldSIGNAL_ON_STATE_FLAGS_CHANGED
contains original signal name and can be used as resource reference.- Parameters:
signal
- callback function (lambda).- Returns:
SignalHandler
. Can be used to disconnect signal and to release callback function.
-
onUnmap
Connect to signal "unmap".
SeeWidget.OnUnmap.onUnmap()
for signal description.
FieldSIGNAL_ON_UNMAP
contains original signal name and can be used as resource reference.- Parameters:
signal
- callback function (lambda).- Returns:
SignalHandler
. Can be used to disconnect signal and to release callback function.
-
onUnrealize
Connect to signal "unrealize".
SeeWidget.OnUnrealize.onUnrealize()
for signal description.
FieldSIGNAL_ON_UNREALIZE
contains original signal name and can be used as resource reference.- Parameters:
signal
- callback function (lambda).- Returns:
SignalHandler
. Can be used to disconnect signal and to release callback function.
-
getDefaultDirection
public static int getDefaultDirection()Obtains the current default reading direction.
See [func@Gtk.Widget.set_default_direction].- Returns:
- the current default direction.
-
setDefaultDirection
public static void setDefaultDirection(int dir) Sets the default reading direction for widgets.
See [method@Gtk.Widget.set_direction].- Parameters:
dir
- the new default direction. This cannot be %GTK_TEXT_DIR_NONE.
-
asAccessible
Implements interfaceAccessible
. Call this to get access to interface functions.- Returns:
Accessible
-
asBuildable
Implements interfaceBuildable
. Call this to get access to interface functions.- Returns:
Buildable
-
asConstraintTarget
Implements interfaceConstraintTarget
. Call this to get access to interface functions.- Returns:
ConstraintTarget
-
getTypeID
public static long getTypeID() -
getParentTypeID
public static long getParentTypeID() -
getTypeSize
-
getParentTypeSize
-
getInstanceSize
public static int getInstanceSize()
-