Window

---

Object Hierarchy:

Description:

Content:

Properties:

• public bool accept_focus { get; set; }
  Whether the window should receive the input focus.
• public bool allow_grow { get; set; }
• public bool allow_shrink { get; set; }
• 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 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 bool focus_on_map { get; set; }
  Whether the window should receive the input focus when mapped.
• public Gravity gravity { get; set; }
  The gravity to use when resizing the window programmatically.
• public bool has_toplevel_focus { get; }
• public Pixbuf icon { get; set; }
• 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 mnemonics_visible { get; set; }
  Whether mnemonics are currently visible in this window.
• public bool modal { get; set; }
  If true, the window is modal.
• public double opacity { get; set; }
• public bool resizable { get; set; }
  If true, users can resize the window.
• public string role { get; set; }
• public Screen screen { get; set; }
• public bool skip_pager_hint { get; set; }
• public bool skip_taskbar_hint { get; set; }
• public string startup_id { set; }
  A write-only property for setting window's startup notification identifier.
• public string title { get; set; }
  The title of the window.
• public Window transient_for { get; set construct; }
  The transient parent of the window.
• public WindowType type { get; construct; }
• public WindowTypeHint type_hint { get; set; }
• public bool urgency_hint { get; set; }
• public WindowPosition window_position { get; set; }

Static methods:

• public static List<unowned Pixbuf> get_default_icon_list ()
  Gets the value set by set_default_icon_list.
• public static unowned string get_default_icon_name ()
  Returns the fallback icon name for 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 (Pixbuf icon)
  Sets an icon to be used as fallback for windows that haven't had set_icon called on them from a pixbuf.
• public static bool set_default_icon_from_file (string filename) throws Error
  Sets an icon to be used as fallback for windows that haven't had set_icon_list called on them from a file on disk.
• public static void set_default_icon_list (owned List<unowned Pixbuf> list)
  Sets an icon list to be used as fallback for windows that haven't had set_icon_list called on them to set up a window-specific icon list.
• public static void set_default_icon_name (string name)
  Sets an icon to be used as fallback.

Creation methods:

• public Window (WindowType type = TOPLEVEL)
  Creates a new `GtkWindow`.

Methods:

• public bool activate_default ()
• public bool activate_focus ()
• public bool activate_key (EventKey event)
  Activates mnemonics and accelerators for this Window.
• public void add_accel_group (AccelGroup accel_group)
  Associate accel_group with this, such that calling accel_groups_activate on this will activate accelerators in accel_group.
• public void add_embedded_xid (NativeWindow xid)
• public void add_mnemonic (uint keyval, Widget target)
  Adds a mnemonic to this window.
• public void begin_move_drag (int button, int root_x, int root_y, uint32 timestamp)
  Starts moving a window.
• public void begin_resize_drag (WindowEdge edge, int button, int root_x, int root_y, uint32 timestamp)
  Starts resizing a window.
• public void deiconify ()
  Asks to deiconify (i.
• public void fullscreen ()
  Asks to place the window in the fullscreen state.
• public bool get_accept_focus ()
  Gets the value set by set_accept_focus.
• 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_on_map ()
  Gets the value set by set_focus_on_map.
• public void get_frame_dimensions (int left, int top, int right, int bottom)
• public Gravity 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_has_frame ()
• public unowned Pixbuf get_icon ()
  Gets the value set by set_icon (or if you've called set_icon_list, gets the first icon in the icon list).
• public List<unowned Pixbuf> get_icon_list ()
  Retrieves the list of icons set by set_icon_list.
• public unowned string get_icon_name ()
  Returns the name of the themed icon for the window.
• public ModifierType get_mnemonic_modifier ()
  Returns the mnemonic modifier for this 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 double get_opacity ()
  Fetches the requested opacity for this window.
• public void get_position (out int root_x, out int root_y)
  This function returns the position you need to pass to move to keep this in its current position.
• public bool get_resizable ()
  Gets whether the user can resize the window.
• public unowned string get_role ()
  Returns the role of the window.
• public unowned Screen get_screen ()
  Returns the Screen associated with this.
• public void get_size (out int width, out int height)
  Obtains the current size of this.
• public bool get_skip_pager_hint ()
  Gets the value set by set_skip_pager_hint.
• public bool get_skip_taskbar_hint ()
  Gets the value set by set_skip_taskbar_hint
• public unowned string get_title ()
  Retrieves the title of the window.
• public unowned Window get_transient_for ()
  Fetches the transient parent for this window.
• public WindowTypeHint get_type_hint ()
  Gets the type hint for this window.
• public bool get_urgency_hint ()
  Gets the value set by set_urgency_hint
• public WindowType get_window_type ()
  Gets the type of the window.
• public bool has_group ()
  Returns whether the window has an explicit window group.
• public void iconify ()
  Asks to iconify (i.
• public void maximize ()
  Asks to maximize the window, so that it fills the screen.
• public bool mnemonic_activate (uint keyval, ModifierType modifier)
  Activates the targets associated with the mnemonic.
• public void move (int x, int y)
  Asks the window manager to move this to the given position.
• public virtual void move_focus (DirectionType direction)
• public bool parse_geometry (string geometry)
  Parses a standard X Window System geometry string - see the manual page for X (type “man X”) for details on this.
• 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 bool propagate_key_event (EventKey event)
  Propagate a key press or release event to the focus widget and up the focus container chain until a widget handles event.
• public void remove_accel_group (AccelGroup accel_group)
  Reverses the effects of add_accel_group.
• public void remove_embedded_xid (NativeWindow xid)
• public void remove_mnemonic (uint keyval, Widget target)
  Removes a mnemonic from this window.
• public void reshow_with_initial_size ()
  Hides this, then reshows it, resetting the default size and position of the window.
• public void resize (int width, int height)
  Resizes the window as if the user had done so, obeying geometry constraints.
• public void set_accept_focus (bool setting)
  Windows may set a hint asking the desktop environment not to receive the input focus.
• public void set_decorated (bool setting)
  Sets whether the window should be decorated.
• public void set_default (Widget default_widget)
  The default widget is the widget that’s activated when the user presses Enter in a dialog (for example).
• public void set_default_size (int width, int height)
  Sets the default size of a window.
• 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_focus_on_map (bool setting)
  Windows may set a hint asking the desktop environment not to receive the input focus when the window is mapped.
• public void set_frame_dimensions (int left, int top, int right, int bottom)
• public void set_geometry_hints (Widget geometry_widget, Geometry geometry, WindowHints geom_mask)
  This function sets up hints about how a window can be resized by the user.
• public void set_gravity (Gravity gravity)
  Sets the gravity that is used when changing the window size programmatically.
• public void set_has_frame (bool setting)
• public void set_icon (Pixbuf icon)
  Sets up the icon representing a Window.
• public bool set_icon_from_file (string filename) throws Error
  Sets the icon for this.
• public void set_icon_list (List<Pixbuf> list)
  Sets up the icon representing a Window.
• public void set_icon_name (string name)
  Sets the icon for the window from a named themed icon.
• public void set_keep_above (bool setting)
  Asks to keep this above, so that it stays on top.
• public void set_keep_below (bool setting)
  Asks to keep this below, so that it stays in bottom.
• public void set_mnemonic_modifier (ModifierType modifier)
  Sets the mnemonic modifier for this window.
• 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_opacity (double opacity)
  Request the windowing system to make this partially transparent, with opacity 0 being fully transparent and 1 fully opaque.
• public void set_position (WindowPosition position)
  Sets a position constraint for this window.
• public void set_resizable (bool resizable)
  Sets whether the user can resize a window.
• public void set_role (string role)
  This function is only useful on X11, not with other GTK+ targets.
• public void set_screen (Screen screen)
  Sets the Screen where the this is displayed; if the window is already mapped, it will be unmapped, and then remapped on the new screen.
• public void set_skip_pager_hint (bool setting)
  Windows may set a hint asking the desktop environment not to display the window in the pager.
• public void set_skip_taskbar_hint (bool setting)
  Windows may set a hint asking the desktop environment not to display the window in the task bar.
• 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_transient_for (Window parent)
  Sets a transient parent for the window.
• public void set_type_hint (WindowTypeHint hint)
  By setting the type hint for the window, you allow the window manager to decorate and handle the window in a way which is suitable to the function of the window in your application.
• public void set_urgency_hint (bool setting)
  Windows may set a hint asking the desktop environment to draw the users attention to the window.
• public void set_wmclass (string wmclass_name, string wmclass_class)
  Don’t use this function.
• public void stick ()
  Asks to stick this, which means that it will appear on all user desktops.
• 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 unstick ()
  Asks to unstick this, which means that it will appear on only one of the user’s desktops.

Signals:

• public virtual signal void default_activated ()
  Emitted when the user activates the default widget.
• public virtual signal void focus_activated ()
  Emitted when the user activates the currently focused widget of window.
• public virtual signal bool frame_event (Event event)
• public virtual signal void keys_changed ()
  Emitted when the set of accelerators or mnemonics that are associated with the window changes.
• public virtual signal void set_focus (Widget? focus)
  Sets the focus widget.

Fields:

• public uint configure_notify_received
• public uint16 configure_request_count
• public unowned Widget default_widget
• public unowned Widget focus_widget
• public unowned Window frame
• public uint frame_bottom
• public uint frame_left
• public uint frame_right
• public uint frame_top
• public unowned WindowGeometryInfo geometry_info
• public unowned WindowGroup group
• public uint has_focus
• public uint has_frame
• public uint has_user_ref_count
• public uint iconify_initially
• public uint keys_changed_handler
• public uint maximize_initially
• public ModifierType mnemonic_modifier
• public uint need_default_position
• public uint need_default_size
• public uint position
• public uint stick_initially
• public unowned Window transient_parent
• public unowned string wm_role
• public unowned string wmclass_class
• public unowned string wmclass_name

Inherited Members: