Struct libadwaita::builders::ApplicationWindowBuilder
source · pub struct ApplicationWindowBuilder { /* private fields */ }
Expand description
A builder-pattern type to construct ApplicationWindow
objects.
Implementations§
source§impl ApplicationWindowBuilder
impl ApplicationWindowBuilder
sourcepub fn content(self, content: &impl IsA<Widget>) -> Self
pub fn content(self, content: &impl IsA<Widget>) -> Self
The content widget.
This property should always be used instead of child
.
If this property is true
, the window will display a menubar
unless it is shown by the desktop shell.
See [ApplicationExtManual::set_menubar()
][crate::gtk::prelude::ApplicationExtManual::set_menubar()].
If false
, the window will not display a menubar, regardless
of whether the desktop shell is showing it or not.
sourcepub fn application(self, application: &impl IsA<Application>) -> Self
pub fn application(self, application: &impl IsA<Application>) -> Self
The gtk::Application
associated with the window.
The application will be kept alive for at least as long as it has any windows associated with it (see g_application_hold() for a way to keep it alive without windows).
Normally, the connection between the application and the window
will remain until the window is destroyed, but you can explicitly
remove it by setting the :application property to None
.
sourcepub fn decorated(self, decorated: bool) -> Self
pub fn decorated(self, decorated: bool) -> Self
Whether the window should have a frame (also known as decorations).
sourcepub fn default_height(self, default_height: i32) -> Self
pub fn default_height(self, default_height: i32) -> Self
The default height of the window.
sourcepub fn default_widget(self, default_widget: &impl IsA<Widget>) -> Self
pub fn default_widget(self, default_widget: &impl IsA<Widget>) -> Self
The default widget.
sourcepub fn default_width(self, default_width: i32) -> Self
pub fn default_width(self, default_width: i32) -> Self
The default width of the window.
sourcepub fn deletable(self, deletable: bool) -> Self
pub fn deletable(self, deletable: bool) -> Self
Whether the window frame should have a close button.
sourcepub fn destroy_with_parent(self, destroy_with_parent: bool) -> Self
pub fn destroy_with_parent(self, destroy_with_parent: bool) -> Self
If this window should be destroyed when the parent is destroyed.
sourcepub fn focus_visible(self, focus_visible: bool) -> Self
pub fn focus_visible(self, focus_visible: bool) -> Self
Whether ‘focus rectangles’ are currently visible in this window.
This property is maintained by GTK based on user input and should not be set by applications.
sourcepub fn focus_widget(self, focus_widget: &impl IsA<Widget>) -> Self
pub fn focus_widget(self, focus_widget: &impl IsA<Widget>) -> Self
The focus widget.
sourcepub fn fullscreened(self, fullscreened: bool) -> Self
pub fn fullscreened(self, fullscreened: bool) -> Self
Whether the window is fullscreen.
Setting this property is the equivalent of calling
[GtkWindowExtManual::fullscreen()
][crate::gtk::prelude::GtkWindowExtManual::fullscreen()] or [GtkWindowExtManual::unfullscreen()
][crate::gtk::prelude::GtkWindowExtManual::unfullscreen()];
either operation is asynchronous, which means you will need to
connect to the ::notify signal in order to know whether the
operation was successful.
Available on crate feature gtk_v4_2
only.
gtk_v4_2
only.Whether the window frame should handle F10 for activating menubars.
sourcepub fn hide_on_close(self, hide_on_close: bool) -> Self
pub fn hide_on_close(self, hide_on_close: bool) -> Self
If this window should be hidden when the users clicks the close button.
sourcepub fn icon_name(self, icon_name: impl Into<GString>) -> Self
pub fn icon_name(self, icon_name: impl Into<GString>) -> Self
Specifies the name of the themed icon to use as the window icon.
See Gtk::IconTheme
for more details.
sourcepub fn maximized(self, maximized: bool) -> Self
pub fn maximized(self, maximized: bool) -> Self
Whether the window is maximized.
Setting this property is the equivalent of calling
[GtkWindowExtManual::maximize()
][crate::gtk::prelude::GtkWindowExtManual::maximize()] or [GtkWindowExtManual::unmaximize()
][crate::gtk::prelude::GtkWindowExtManual::unmaximize()];
either operation is asynchronous, which means you will need to
connect to the ::notify signal in order to know whether the
operation was successful.
sourcepub fn mnemonics_visible(self, mnemonics_visible: bool) -> Self
pub fn mnemonics_visible(self, mnemonics_visible: bool) -> Self
Whether mnemonics are currently visible in this window.
This property is maintained by GTK based on user input, and should not be set by applications.
sourcepub fn startup_id(self, startup_id: impl Into<GString>) -> Self
pub fn startup_id(self, startup_id: impl Into<GString>) -> Self
A write-only property for setting window’s startup notification identifier.
sourcepub fn titlebar(self, titlebar: &impl IsA<Widget>) -> Self
Available on crate feature gtk_v4_6
only.
pub fn titlebar(self, titlebar: &impl IsA<Widget>) -> Self
gtk_v4_6
only.The titlebar widget.
sourcepub fn transient_for(self, transient_for: &impl IsA<Window>) -> Self
pub fn transient_for(self, transient_for: &impl IsA<Window>) -> Self
The transient parent of the window.
sourcepub fn can_focus(self, can_focus: bool) -> Self
pub fn can_focus(self, can_focus: bool) -> Self
Whether the widget or any of its descendents can accept the input focus.
This property is meant to be set by widget implementations, typically in their instance init function.
sourcepub fn can_target(self, can_target: bool) -> Self
pub fn can_target(self, can_target: bool) -> Self
Whether the widget can receive pointer events.
sourcepub fn css_classes(self, css_classes: impl Into<StrV>) -> Self
pub fn css_classes(self, css_classes: impl Into<StrV>) -> Self
A list of css classes applied to this widget.
sourcepub fn css_name(self, css_name: impl Into<GString>) -> Self
pub fn css_name(self, css_name: impl Into<GString>) -> Self
The name of this widget in the CSS tree.
This property is meant to be set by widget implementations, typically in their instance init function.
sourcepub fn focus_on_click(self, focus_on_click: bool) -> Self
pub fn focus_on_click(self, focus_on_click: bool) -> Self
Whether the widget should grab focus when it is clicked with the mouse.
This property is only relevant for widgets that can take focus.
sourcepub fn focusable(self, focusable: bool) -> Self
pub fn focusable(self, focusable: bool) -> Self
Whether this widget itself will accept the input focus.
sourcepub fn halign(self, halign: Align) -> Self
pub fn halign(self, halign: Align) -> Self
How to distribute horizontal space if widget gets extra space.
sourcepub fn has_tooltip(self, has_tooltip: bool) -> Self
pub fn has_tooltip(self, has_tooltip: bool) -> Self
Enables or disables the emission of the ::query-tooltip signal on @widget.
A value of true
indicates that @widget can have a tooltip, in this case
the widget will be queried using query-tooltip
to
determine whether it will provide a tooltip or not.
sourcepub fn height_request(self, height_request: i32) -> Self
pub fn height_request(self, height_request: i32) -> Self
Override for height request of the widget.
If this is -1, the natural request will be used.
sourcepub fn hexpand_set(self, hexpand_set: bool) -> Self
pub fn hexpand_set(self, hexpand_set: bool) -> Self
Whether to use the hexpand
property.
sourcepub fn layout_manager(self, layout_manager: &impl IsA<LayoutManager>) -> Self
pub fn layout_manager(self, layout_manager: &impl IsA<LayoutManager>) -> Self
The gtk::LayoutManager
instance to use to compute the preferred size
of the widget, and allocate its children.
This property is meant to be set by widget implementations, typically in their instance init function.
sourcepub fn margin_bottom(self, margin_bottom: i32) -> Self
pub fn margin_bottom(self, margin_bottom: i32) -> Self
Margin on bottom side of widget.
This property adds margin outside of the widget’s normal size
request, the margin will be added in addition to the size from
[WidgetExtManual::set_size_request()
][crate::gtk::prelude::WidgetExtManual::set_size_request()] for example.
sourcepub fn margin_end(self, margin_end: i32) -> Self
pub fn margin_end(self, margin_end: i32) -> Self
Margin on end of widget, horizontally.
This property supports left-to-right and right-to-left text directions.
This property adds margin outside of the widget’s normal size
request, the margin will be added in addition to the size from
[WidgetExtManual::set_size_request()
][crate::gtk::prelude::WidgetExtManual::set_size_request()] for example.
sourcepub fn margin_start(self, margin_start: i32) -> Self
pub fn margin_start(self, margin_start: i32) -> Self
Margin on start of widget, horizontally.
This property supports left-to-right and right-to-left text directions.
This property adds margin outside of the widget’s normal size
request, the margin will be added in addition to the size from
[WidgetExtManual::set_size_request()
][crate::gtk::prelude::WidgetExtManual::set_size_request()] for example.
sourcepub fn margin_top(self, margin_top: i32) -> Self
pub fn margin_top(self, margin_top: i32) -> Self
Margin on top side of widget.
This property adds margin outside of the widget’s normal size
request, the margin will be added in addition to the size from
[WidgetExtManual::set_size_request()
][crate::gtk::prelude::WidgetExtManual::set_size_request()] for example.
sourcepub fn overflow(self, overflow: Overflow) -> Self
pub fn overflow(self, overflow: Overflow) -> Self
How content outside the widget’s content area is treated.
This property is meant to be set by widget implementations, typically in their instance init function.
sourcepub fn receives_default(self, receives_default: bool) -> Self
pub fn receives_default(self, receives_default: bool) -> Self
Whether the widget will receive the default action when it is focused.
sourcepub fn tooltip_markup(self, tooltip_markup: impl Into<GString>) -> Self
pub fn tooltip_markup(self, tooltip_markup: impl Into<GString>) -> Self
Sets the text of tooltip to be the given string, which is marked up with Pango markup.
Also see Gtk::Tooltip::set_markup()
.
This is a convenience property which will take care of getting the
tooltip shown if the given string is not None
:
has-tooltip
will automatically be set to true
and there will be taken care of query-tooltip
in
the default signal handler.
Note that if both tooltip-text
and
tooltip-markup
are set, the last one wins.
sourcepub fn tooltip_text(self, tooltip_text: impl Into<GString>) -> Self
pub fn tooltip_text(self, tooltip_text: impl Into<GString>) -> Self
Sets the text of tooltip to be the given string.
Also see Gtk::Tooltip::set_text()
.
This is a convenience property which will take care of getting the
tooltip shown if the given string is not None
:
has-tooltip
will automatically be set to true
and there will be taken care of query-tooltip
in
the default signal handler.
Note that if both tooltip-text
and
tooltip-markup
are set, the last one wins.
sourcepub fn valign(self, valign: Align) -> Self
pub fn valign(self, valign: Align) -> Self
How to distribute vertical space if widget gets extra space.
sourcepub fn vexpand_set(self, vexpand_set: bool) -> Self
pub fn vexpand_set(self, vexpand_set: bool) -> Self
Whether to use the vexpand
property.
sourcepub fn width_request(self, width_request: i32) -> Self
pub fn width_request(self, width_request: i32) -> Self
Override for width request of the widget.
If this is -1, the natural request will be used.
sourcepub fn accessible_role(self, accessible_role: AccessibleRole) -> Self
pub fn accessible_role(self, accessible_role: AccessibleRole) -> Self
The accessible role of the given gtk::Accessible
implementation.
The accessible role cannot be changed once set.
sourcepub fn build(self) -> ApplicationWindow
pub fn build(self) -> ApplicationWindow
Build the ApplicationWindow
.