Window

---

Object Hierarchy:

Description:

Content:

Properties:

• public Application application { get; set; }
  The `GtkApplication` associated with the window.
• public Widget child { get; set; }
  The child widget.
• public bool decorated { get; set; }
  Whether the window should have a frame (also known as *decorations*).
• public int default_height { get; set; }
  The default height of the window.
• public Widget default_widget { get; set; }
  The default widget.
• public int default_width { get; set; }
  The default width of the window.
• public bool deletable { get; set; }
  Whether the window frame should have a close button.
• public bool destroy_with_parent { get; set; }
  If this window should be destroyed when the parent is destroyed.
• public Display display { owned get; set; }
  The display that will display this window.
• public bool focus_visible { get; set; }
  Whether 'focus rectangles' are currently visible in this window.
• public Widget focus_widget { owned get; set; }
  The focus widget.
• public bool fullscreened { get; set; }
  Whether the window is fullscreen.
• public WindowGravity gravity { get; set; }
  The gravity to use when resizing the window programmatically.
• public bool handle_menubar_accel { get; set; }
  Whether the window frame should handle <kbd>F10</kbd> for activating menubars.
• public bool hide_on_close { get; set; }
  If this window should be hidden instead of destroyed when the user clicks the close button.
• public string icon_name { get; set; }
  Specifies the name of the themed icon to use as the window icon.
• public bool is_active { get; }
  Whether the toplevel is the currently active window.
• public bool maximized { get; set; }
  Whether the window is maximized.
• public bool mnemonics_visible { get; set; }
  Whether mnemonics are currently visible in this window.
• public bool modal { get; set; }
  If true, the window is modal.
• public bool resizable { get; set; }
  If true, users can resize the window.
• public string startup_id { set; }
  A write-only property for setting window's startup notification identifier.
• public bool suspended { get; }
  Whether the window is suspended.
• public string title { get; set; }
  The title of the window.
• public Widget titlebar { get; set; }
  The titlebar widget.
• public Window transient_for { get; set construct; }
  The transient parent of the window.

Static methods:

• public static unowned string? get_default_icon_name ()
  Returns the fallback icon name for windows.
• public static unowned ListModel get_toplevels ()
  Returns the list of all existing toplevel windows.
• public static List<unowned Window> list_toplevels ()
  Returns the list of all existing toplevel windows.
• public static void set_auto_startup_notification (bool setting)
  Sets whether the window should request startup notification.
• public static void set_default_icon_name (string name)
  Sets an icon to be used as fallback.
• public static void set_interactive_debugging (bool enable)
  Opens or closes the [interactive debugger](running.

Creation methods:

• public Window ()
  Creates a new `GtkWindow`.

Methods:

• public void close ()
  Requests that the window is closed.
• public void destroy ()
  Drops the internal reference GTK holds on toplevel windows.
• public void fullscreen ()
  Asks to place the window in the fullscreen state.
• public void fullscreen_on_monitor (Monitor monitor)
  Asks to place the window in the fullscreen state on the given monitor.
• public unowned Application? get_application ()
  Gets the application object associated with the window.
• public unowned Widget? get_child ()
  Gets the child widget of the window.
• public bool get_decorated ()
  Returns whether the window has been set to have decorations.
• public void get_default_size (out int width, out int height)
  Gets the default size of the window.
• public unowned Widget? get_default_widget ()
  Returns the default widget for this.
• public bool get_deletable ()
  Returns whether the window has been set to have a close button.
• public bool get_destroy_with_parent ()
  Returns whether the window will be destroyed with its transient parent.
• public unowned Widget? get_focus ()
  Retrieves the current focused widget within the window.
• public bool get_focus_visible ()
  Gets whether “focus rectangles” are supposed to be visible.
• public WindowGravity get_gravity ()
  Returns the gravity that is used when changing the window size programmatically.
• public unowned WindowGroup get_group ()
  Returns the group for the window.
• public bool get_handle_menubar_accel ()
  Returns whether this window reacts to <kbd>F10</kbd> presses by activating a menubar it contains.
• public bool get_hide_on_close ()
  Returns whether the window will be hidden instead of destroyed when the close button is clicked.
• public unowned string? get_icon_name ()
  Returns the name of the themed icon for the window.
• public bool get_mnemonics_visible ()
  Gets whether mnemonics are supposed to be visible.
• public bool get_modal ()
  Returns whether the window is modal.
• public bool get_resizable ()
  Gets whether the user can resize the window.
• public unowned string? get_title ()
  Retrieves the title of the window.
• public unowned Widget? get_titlebar ()
  Returns the titlebar that has been set with [method@Gtk.
• public unowned Window? get_transient_for ()
  Fetches the transient parent for this window.
• public bool has_group ()
  Returns whether the window has an explicit window group.
• public bool is_fullscreen ()
  Retrieves the current fullscreen state of the window.
• public bool is_maximized ()
  Retrieves the current maximized state of the window.
• public bool is_suspended ()
  Retrieves the current suspended state of the window.
• public void maximize ()
  Asks to maximize the window, so that it fills the screen.
• public void minimize ()
  Asks to minimize the window.
• public void present ()
  Presents a window to the user.
• public void present_with_time (uint32 timestamp)
  Presents a window to the user in response to an user interaction.
• public void set_application (Application? application)
  Sets or unsets the application object associated with the window.
• public void set_child (Widget? child)
  Sets the child widget of the window.
• public void set_decorated (bool setting)
  Sets whether the window should be decorated.
• public void set_default_size (int width, int height)
  Sets the default size of a window.
• public void set_default_widget (Widget? default_widget)
  Sets the default widget.
• public void set_deletable (bool setting)
  Sets whether the window should be deletable.
• public void set_destroy_with_parent (bool setting)
  Sets whether to destroy the window when the transient parent is destroyed.
• public void set_display (Display display)
  Sets the display where the window is displayed.
• public void set_focus (Widget? focus)
  Sets the focus widget.
• public void set_focus_visible (bool setting)
  Sets whether “focus rectangles” are supposed to be visible.
• public void set_gravity (WindowGravity gravity)
  Sets the gravity that is used when changing the window size programmatically.
• public void set_handle_menubar_accel (bool handle_menubar_accel)
  Sets whether this window should react to <kbd>F10</kbd> presses by activating a menubar it contains.
• public void set_hide_on_close (bool setting)
  Sets whether clicking the close button will hide the window instead of destroying it.
• public void set_icon_name (string? name)
  Sets the icon for the window from a named themed icon.
• public void set_mnemonics_visible (bool setting)
  Sets whether mnemonics are supposed to be visible.
• public void set_modal (bool modal)
  Sets a window modal or non-modal.
• public void set_resizable (bool resizable)
  Sets whether the user can resize a window.
• public void set_startup_id (string startup_id)
  Sets the startup notification ID.
• public void set_title (string? title)
  Sets the title of the window.
• public void set_titlebar (Widget? titlebar)
  Sets a custom titlebar for the window.
• public void set_transient_for (Window? parent)
  Sets a transient parent for the window.
• public async bool show_uri_full (string uri, uint32 timestamp, Cancellable? cancellable) throws Error
  This function launches the default application for showing a given uri.
• public void unfullscreen ()
  Asks to remove the fullscreen state for the window, and return to its previous state.
• public void unmaximize ()
  Asks to unmaximize the window.
• public void unminimize ()
  Asks to unminimize the window.

Signals:

• public virtual signal void activate_default ()
  Emitted when the user activates the default widget.
• public virtual signal void activate_focus ()
  Emitted when the user activates the currently focused widget of window.
• public virtual signal bool close_request ()
  Emitted when the user clicks on the close button of the window.
• public virtual signal bool enable_debugging (bool toggle)
  Emitted when the user enables or disables interactive debugging.
• public virtual signal void keys_changed ()
  Emitted when the set of accelerators or mnemonics that are associated with the window changes.

Inherited Members: