6464 lines
325 KiB
HTML
6464 lines
325 KiB
HTML
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
||
<html>
|
||
<head>
|
||
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
|
||
<title>GtkWindow: GTK+ 3 Reference Manual</title>
|
||
<meta name="generator" content="DocBook XSL Stylesheets Vsnapshot">
|
||
<link rel="home" href="index.html" title="GTK+ 3 Reference Manual">
|
||
<link rel="up" href="WindowWidgets.html" title="Windows">
|
||
<link rel="prev" href="WindowWidgets.html" title="Windows">
|
||
<link rel="next" href="GtkDialog.html" title="GtkDialog">
|
||
<meta name="generator" content="GTK-Doc V1.33.1 (XML mode)">
|
||
<link rel="stylesheet" href="style.css" type="text/css">
|
||
</head>
|
||
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
|
||
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="5"><tr valign="middle">
|
||
<td width="100%" align="left" class="shortcuts">
|
||
<a href="#" class="shortcut">Top</a><span id="nav_description"> <span class="dim">|</span>
|
||
<a href="#GtkWindow.description" class="shortcut">Description</a></span><span id="nav_hierarchy"> <span class="dim">|</span>
|
||
<a href="#GtkWindow.object-hierarchy" class="shortcut">Object Hierarchy</a></span><span id="nav_interfaces"> <span class="dim">|</span>
|
||
<a href="#GtkWindow.implemented-interfaces" class="shortcut">Implemented Interfaces</a></span><span id="nav_properties"> <span class="dim">|</span>
|
||
<a href="#GtkWindow.properties" class="shortcut">Properties</a></span><span id="nav_style_properties"> <span class="dim">|</span>
|
||
<a href="#GtkWindow.style-properties" class="shortcut">Style Properties</a></span><span id="nav_signals"> <span class="dim">|</span>
|
||
<a href="#GtkWindow.signals" class="shortcut">Signals</a></span>
|
||
</td>
|
||
<td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
|
||
<td><a accesskey="u" href="WindowWidgets.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
|
||
<td><a accesskey="p" href="WindowWidgets.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
|
||
<td><a accesskey="n" href="GtkDialog.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
|
||
</tr></table>
|
||
<div class="refentry">
|
||
<a name="GtkWindow"></a><div class="titlepage"></div>
|
||
<div class="refnamediv"><table width="100%"><tr>
|
||
<td valign="top">
|
||
<h2><span class="refentrytitle"><a name="GtkWindow.top_of_page"></a>GtkWindow</span></h2>
|
||
<p>GtkWindow — Toplevel which can contain other widgets</p>
|
||
</td>
|
||
<td class="gallery_image" valign="top" align="right"><img src="window.png"></td>
|
||
</tr></table></div>
|
||
<div class="refsect1">
|
||
<a name="GtkWindow.functions"></a><h2>Functions</h2>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="functions_proto_type">
|
||
<col class="functions_proto_name">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="function_type">
|
||
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-new" title="gtk_window_new ()">gtk_window_new</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-set-title" title="gtk_window_set_title ()">gtk_window_set_title</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-set-wmclass" title="gtk_window_set_wmclass ()">gtk_window_set_wmclass</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-set-resizable" title="gtk_window_set_resizable ()">gtk_window_set_resizable</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-get-resizable" title="gtk_window_get_resizable ()">gtk_window_get_resizable</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-add-accel-group" title="gtk_window_add_accel_group ()">gtk_window_add_accel_group</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-remove-accel-group" title="gtk_window_remove_accel_group ()">gtk_window_remove_accel_group</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-activate-focus" title="gtk_window_activate_focus ()">gtk_window_activate_focus</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-activate-default" title="gtk_window_activate_default ()">gtk_window_activate_default</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-set-modal" title="gtk_window_set_modal ()">gtk_window_set_modal</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-set-default-size" title="gtk_window_set_default_size ()">gtk_window_set_default_size</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-set-default-geometry" title="gtk_window_set_default_geometry ()">gtk_window_set_default_geometry</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-set-geometry-hints" title="gtk_window_set_geometry_hints ()">gtk_window_set_geometry_hints</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-set-gravity" title="gtk_window_set_gravity ()">gtk_window_set_gravity</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">GdkGravity</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-get-gravity" title="gtk_window_get_gravity ()">gtk_window_get_gravity</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-set-position" title="gtk_window_set_position ()">gtk_window_set_position</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-set-transient-for" title="gtk_window_set_transient_for ()">gtk_window_set_transient_for</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-set-attached-to" title="gtk_window_set_attached_to ()">gtk_window_set_attached_to</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-set-destroy-with-parent" title="gtk_window_set_destroy_with_parent ()">gtk_window_set_destroy_with_parent</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-set-hide-titlebar-when-maximized" title="gtk_window_set_hide_titlebar_when_maximized ()">gtk_window_set_hide_titlebar_when_maximized</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-set-screen" title="gtk_window_set_screen ()">gtk_window_set_screen</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">GdkScreen</span> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-get-screen" title="gtk_window_get_screen ()">gtk_window_get_screen</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-is-active" title="gtk_window_is_active ()">gtk_window_is_active</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-is-maximized" title="gtk_window_is_maximized ()">gtk_window_is_maximized</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-has-toplevel-focus" title="gtk_window_has_toplevel_focus ()">gtk_window_has_toplevel_focus</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">GList</span> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-list-toplevels" title="gtk_window_list_toplevels ()">gtk_window_list_toplevels</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-add-mnemonic" title="gtk_window_add_mnemonic ()">gtk_window_add_mnemonic</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-remove-mnemonic" title="gtk_window_remove_mnemonic ()">gtk_window_remove_mnemonic</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-mnemonic-activate" title="gtk_window_mnemonic_activate ()">gtk_window_mnemonic_activate</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-activate-key" title="gtk_window_activate_key ()">gtk_window_activate_key</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-propagate-key-event" title="gtk_window_propagate_key_event ()">gtk_window_propagate_key_event</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-get-focus" title="gtk_window_get_focus ()">gtk_window_get_focus</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-set-focus" title="gtk_window_set_focus ()">gtk_window_set_focus</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-get-default-widget" title="gtk_window_get_default_widget ()">gtk_window_get_default_widget</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-set-default" title="gtk_window_set_default ()">gtk_window_set_default</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-present" title="gtk_window_present ()">gtk_window_present</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-present-with-time" title="gtk_window_present_with_time ()">gtk_window_present_with_time</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-close" title="gtk_window_close ()">gtk_window_close</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-iconify" title="gtk_window_iconify ()">gtk_window_iconify</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-deiconify" title="gtk_window_deiconify ()">gtk_window_deiconify</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-stick" title="gtk_window_stick ()">gtk_window_stick</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-unstick" title="gtk_window_unstick ()">gtk_window_unstick</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-maximize" title="gtk_window_maximize ()">gtk_window_maximize</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-unmaximize" title="gtk_window_unmaximize ()">gtk_window_unmaximize</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-fullscreen" title="gtk_window_fullscreen ()">gtk_window_fullscreen</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-fullscreen-on-monitor" title="gtk_window_fullscreen_on_monitor ()">gtk_window_fullscreen_on_monitor</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-unfullscreen" title="gtk_window_unfullscreen ()">gtk_window_unfullscreen</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-set-keep-above" title="gtk_window_set_keep_above ()">gtk_window_set_keep_above</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-set-keep-below" title="gtk_window_set_keep_below ()">gtk_window_set_keep_below</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-begin-resize-drag" title="gtk_window_begin_resize_drag ()">gtk_window_begin_resize_drag</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-begin-move-drag" title="gtk_window_begin_move_drag ()">gtk_window_begin_move_drag</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-set-decorated" title="gtk_window_set_decorated ()">gtk_window_set_decorated</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-set-deletable" title="gtk_window_set_deletable ()">gtk_window_set_deletable</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-set-mnemonic-modifier" title="gtk_window_set_mnemonic_modifier ()">gtk_window_set_mnemonic_modifier</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-set-type-hint" title="gtk_window_set_type_hint ()">gtk_window_set_type_hint</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-set-skip-taskbar-hint" title="gtk_window_set_skip_taskbar_hint ()">gtk_window_set_skip_taskbar_hint</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-set-skip-pager-hint" title="gtk_window_set_skip_pager_hint ()">gtk_window_set_skip_pager_hint</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-set-urgency-hint" title="gtk_window_set_urgency_hint ()">gtk_window_set_urgency_hint</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-set-accept-focus" title="gtk_window_set_accept_focus ()">gtk_window_set_accept_focus</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-set-focus-on-map" title="gtk_window_set_focus_on_map ()">gtk_window_set_focus_on_map</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-set-startup-id" title="gtk_window_set_startup_id ()">gtk_window_set_startup_id</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-set-role" title="gtk_window_set_role ()">gtk_window_set_role</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-get-decorated" title="gtk_window_get_decorated ()">gtk_window_get_decorated</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-get-deletable" title="gtk_window_get_deletable ()">gtk_window_get_deletable</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">GList</span> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-get-default-icon-list" title="gtk_window_get_default_icon_list ()">gtk_window_get_default_icon_list</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">const <span class="returnvalue">gchar</span> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-get-default-icon-name" title="gtk_window_get_default_icon_name ()">gtk_window_get_default_icon_name</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-get-default-size" title="gtk_window_get_default_size ()">gtk_window_get_default_size</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-get-destroy-with-parent" title="gtk_window_get_destroy_with_parent ()">gtk_window_get_destroy_with_parent</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-get-hide-titlebar-when-maximized" title="gtk_window_get_hide_titlebar_when_maximized ()">gtk_window_get_hide_titlebar_when_maximized</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">GdkPixbuf</span> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-get-icon" title="gtk_window_get_icon ()">gtk_window_get_icon</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">GList</span> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-get-icon-list" title="gtk_window_get_icon_list ()">gtk_window_get_icon_list</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">const <span class="returnvalue">gchar</span> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-get-icon-name" title="gtk_window_get_icon_name ()">gtk_window_get_icon_name</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">GdkModifierType</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-get-mnemonic-modifier" title="gtk_window_get_mnemonic_modifier ()">gtk_window_get_mnemonic_modifier</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-get-modal" title="gtk_window_get_modal ()">gtk_window_get_modal</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-get-position" title="gtk_window_get_position ()">gtk_window_get_position</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">const <span class="returnvalue">gchar</span> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-get-role" title="gtk_window_get_role ()">gtk_window_get_role</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-get-size" title="gtk_window_get_size ()">gtk_window_get_size</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">const <span class="returnvalue">gchar</span> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-get-title" title="gtk_window_get_title ()">gtk_window_get_title</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<a class="link" href="GtkWindow.html" title="GtkWindow"><span class="returnvalue">GtkWindow</span></a> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-get-transient-for" title="gtk_window_get_transient_for ()">gtk_window_get_transient_for</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-get-attached-to" title="gtk_window_get_attached_to ()">gtk_window_get_attached_to</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">GdkWindowTypeHint</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-get-type-hint" title="gtk_window_get_type_hint ()">gtk_window_get_type_hint</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-get-skip-taskbar-hint" title="gtk_window_get_skip_taskbar_hint ()">gtk_window_get_skip_taskbar_hint</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-get-skip-pager-hint" title="gtk_window_get_skip_pager_hint ()">gtk_window_get_skip_pager_hint</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-get-urgency-hint" title="gtk_window_get_urgency_hint ()">gtk_window_get_urgency_hint</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-get-accept-focus" title="gtk_window_get_accept_focus ()">gtk_window_get_accept_focus</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-get-focus-on-map" title="gtk_window_get_focus_on_map ()">gtk_window_get_focus_on_map</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<a class="link" href="GtkWindowGroup.html" title="GtkWindowGroup"><span class="returnvalue">GtkWindowGroup</span></a> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-get-group" title="gtk_window_get_group ()">gtk_window_get_group</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-has-group" title="gtk_window_has_group ()">gtk_window_has_group</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<a class="link" href="GtkWindow.html#GtkWindowType" title="enum GtkWindowType"><span class="returnvalue">GtkWindowType</span></a>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-get-window-type" title="gtk_window_get_window_type ()">gtk_window_get_window_type</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-move" title="gtk_window_move ()">gtk_window_move</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-parse-geometry" title="gtk_window_parse_geometry ()">gtk_window_parse_geometry</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-reshow-with-initial-size" title="gtk_window_reshow_with_initial_size ()">gtk_window_reshow_with_initial_size</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-resize" title="gtk_window_resize ()">gtk_window_resize</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-resize-to-geometry" title="gtk_window_resize_to_geometry ()">gtk_window_resize_to_geometry</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-set-default-icon-list" title="gtk_window_set_default_icon_list ()">gtk_window_set_default_icon_list</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-set-default-icon" title="gtk_window_set_default_icon ()">gtk_window_set_default_icon</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-set-default-icon-from-file" title="gtk_window_set_default_icon_from_file ()">gtk_window_set_default_icon_from_file</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-set-default-icon-name" title="gtk_window_set_default_icon_name ()">gtk_window_set_default_icon_name</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-set-icon" title="gtk_window_set_icon ()">gtk_window_set_icon</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-set-icon-list" title="gtk_window_set_icon_list ()">gtk_window_set_icon_list</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-set-icon-from-file" title="gtk_window_set_icon_from_file ()">gtk_window_set_icon_from_file</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-set-icon-name" title="gtk_window_set_icon_name ()">gtk_window_set_icon_name</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-set-auto-startup-notification" title="gtk_window_set_auto_startup_notification ()">gtk_window_set_auto_startup_notification</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gdouble</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-get-opacity" title="gtk_window_get_opacity ()">gtk_window_get_opacity</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-set-opacity" title="gtk_window_set_opacity ()">gtk_window_set_opacity</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-get-mnemonics-visible" title="gtk_window_get_mnemonics_visible ()">gtk_window_get_mnemonics_visible</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-set-mnemonics-visible" title="gtk_window_set_mnemonics_visible ()">gtk_window_set_mnemonics_visible</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-get-focus-visible" title="gtk_window_get_focus_visible ()">gtk_window_get_focus_visible</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-set-focus-visible" title="gtk_window_set_focus_visible ()">gtk_window_set_focus_visible</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-set-has-resize-grip" title="gtk_window_set_has_resize_grip ()">gtk_window_set_has_resize_grip</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-get-has-resize-grip" title="gtk_window_get_has_resize_grip ()">gtk_window_get_has_resize_grip</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-resize-grip-is-visible" title="gtk_window_resize_grip_is_visible ()">gtk_window_resize_grip_is_visible</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-get-resize-grip-area" title="gtk_window_get_resize_grip_area ()">gtk_window_get_resize_grip_area</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<a class="link" href="GtkApplication.html" title="GtkApplication"><span class="returnvalue">GtkApplication</span></a> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-get-application" title="gtk_window_get_application ()">gtk_window_get_application</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-set-application" title="gtk_window_set_application ()">gtk_window_set_application</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-set-has-user-ref-count" title="gtk_window_set_has_user_ref_count ()">gtk_window_set_has_user_ref_count</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-set-titlebar" title="gtk_window_set_titlebar ()">gtk_window_set_titlebar</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-get-titlebar" title="gtk_window_get_titlebar ()">gtk_window_get_titlebar</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkWindow.html#gtk-window-set-interactive-debugging" title="gtk_window_set_interactive_debugging ()">gtk_window_set_interactive_debugging</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="GtkWindow.properties"></a><h2>Properties</h2>
|
||
<div class="informaltable"><table class="informaltable" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="properties_type">
|
||
<col width="300px" class="properties_name">
|
||
<col width="200px" class="properties_flags">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="property_type"><span class="type">gboolean</span></td>
|
||
<td class="property_name"><a class="link" href="GtkWindow.html#GtkWindow--accept-focus" title="The “accept-focus” property">accept-focus</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type">
|
||
<a class="link" href="GtkApplication.html" title="GtkApplication"><span class="type">GtkApplication</span></a> *</td>
|
||
<td class="property_name"><a class="link" href="GtkWindow.html#GtkWindow--application" title="The “application” property">application</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type">
|
||
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *</td>
|
||
<td class="property_name"><a class="link" href="GtkWindow.html#GtkWindow--attached-to" title="The “attached-to” property">attached-to</a></td>
|
||
<td class="property_flags">Read / Write / Construct</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type"><span class="type">gboolean</span></td>
|
||
<td class="property_name"><a class="link" href="GtkWindow.html#GtkWindow--decorated" title="The “decorated” property">decorated</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type"><span class="type">int</span></td>
|
||
<td class="property_name"><a class="link" href="GtkWindow.html#GtkWindow--default-height" title="The “default-height” property">default-height</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type"><span class="type">int</span></td>
|
||
<td class="property_name"><a class="link" href="GtkWindow.html#GtkWindow--default-width" title="The “default-width” property">default-width</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type"><span class="type">gboolean</span></td>
|
||
<td class="property_name"><a class="link" href="GtkWindow.html#GtkWindow--deletable" title="The “deletable” property">deletable</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type"><span class="type">gboolean</span></td>
|
||
<td class="property_name"><a class="link" href="GtkWindow.html#GtkWindow--destroy-with-parent" title="The “destroy-with-parent” property">destroy-with-parent</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type"><span class="type">gboolean</span></td>
|
||
<td class="property_name"><a class="link" href="GtkWindow.html#GtkWindow--focus-on-map" title="The “focus-on-map” property">focus-on-map</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type"><span class="type">gboolean</span></td>
|
||
<td class="property_name"><a class="link" href="GtkWindow.html#GtkWindow--focus-visible" title="The “focus-visible” property">focus-visible</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type"><span class="type">GdkGravity</span></td>
|
||
<td class="property_name"><a class="link" href="GtkWindow.html#GtkWindow--gravity" title="The “gravity” property">gravity</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type"><span class="type">gboolean</span></td>
|
||
<td class="property_name"><a class="link" href="GtkWindow.html#GtkWindow--has-resize-grip" title="The “has-resize-grip” property">has-resize-grip</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type"><span class="type">gboolean</span></td>
|
||
<td class="property_name"><a class="link" href="GtkWindow.html#GtkWindow--has-toplevel-focus" title="The “has-toplevel-focus” property">has-toplevel-focus</a></td>
|
||
<td class="property_flags">Read</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type"><span class="type">gboolean</span></td>
|
||
<td class="property_name"><a class="link" href="GtkWindow.html#GtkWindow--hide-titlebar-when-maximized" title="The “hide-titlebar-when-maximized” property">hide-titlebar-when-maximized</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type">
|
||
<span class="type">GdkPixbuf</span> *</td>
|
||
<td class="property_name"><a class="link" href="GtkWindow.html#GtkWindow--icon" title="The “icon” property">icon</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type">
|
||
<span class="type">char</span> *</td>
|
||
<td class="property_name"><a class="link" href="GtkWindow.html#GtkWindow--icon-name" title="The “icon-name” property">icon-name</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type"><span class="type">gboolean</span></td>
|
||
<td class="property_name"><a class="link" href="GtkWindow.html#GtkWindow--is-active" title="The “is-active” property">is-active</a></td>
|
||
<td class="property_flags">Read</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type"><span class="type">gboolean</span></td>
|
||
<td class="property_name"><a class="link" href="GtkWindow.html#GtkWindow--is-maximized" title="The “is-maximized” property">is-maximized</a></td>
|
||
<td class="property_flags">Read</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type"><span class="type">gboolean</span></td>
|
||
<td class="property_name"><a class="link" href="GtkWindow.html#GtkWindow--mnemonics-visible" title="The “mnemonics-visible” property">mnemonics-visible</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type"><span class="type">gboolean</span></td>
|
||
<td class="property_name"><a class="link" href="GtkWindow.html#GtkWindow--modal" title="The “modal” property">modal</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type"><span class="type">gboolean</span></td>
|
||
<td class="property_name"><a class="link" href="GtkWindow.html#GtkWindow--resizable" title="The “resizable” property">resizable</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type"><span class="type">gboolean</span></td>
|
||
<td class="property_name"><a class="link" href="GtkWindow.html#GtkWindow--resize-grip-visible" title="The “resize-grip-visible” property">resize-grip-visible</a></td>
|
||
<td class="property_flags">Read</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type">
|
||
<span class="type">char</span> *</td>
|
||
<td class="property_name"><a class="link" href="GtkWindow.html#GtkWindow--role" title="The “role” property">role</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type">
|
||
<span class="type">GdkScreen</span> *</td>
|
||
<td class="property_name"><a class="link" href="GtkWindow.html#GtkWindow--screen" title="The “screen” property">screen</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type"><span class="type">gboolean</span></td>
|
||
<td class="property_name"><a class="link" href="GtkWindow.html#GtkWindow--skip-pager-hint" title="The “skip-pager-hint” property">skip-pager-hint</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type"><span class="type">gboolean</span></td>
|
||
<td class="property_name"><a class="link" href="GtkWindow.html#GtkWindow--skip-taskbar-hint" title="The “skip-taskbar-hint” property">skip-taskbar-hint</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type">
|
||
<span class="type">char</span> *</td>
|
||
<td class="property_name"><a class="link" href="GtkWindow.html#GtkWindow--startup-id" title="The “startup-id” property">startup-id</a></td>
|
||
<td class="property_flags">Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type">
|
||
<span class="type">char</span> *</td>
|
||
<td class="property_name"><a class="link" href="GtkWindow.html#GtkWindow--title" title="The “title” property">title</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type">
|
||
<a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *</td>
|
||
<td class="property_name"><a class="link" href="GtkWindow.html#GtkWindow--transient-for" title="The “transient-for” property">transient-for</a></td>
|
||
<td class="property_flags">Read / Write / Construct</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type"><a class="link" href="GtkWindow.html#GtkWindowType" title="enum GtkWindowType"><span class="type">GtkWindowType</span></a></td>
|
||
<td class="property_name"><a class="link" href="GtkWindow.html#GtkWindow--type" title="The “type” property">type</a></td>
|
||
<td class="property_flags">Read / Write / Construct Only</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type"><span class="type">GdkWindowTypeHint</span></td>
|
||
<td class="property_name"><a class="link" href="GtkWindow.html#GtkWindow--type-hint" title="The “type-hint” property">type-hint</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type"><span class="type">gboolean</span></td>
|
||
<td class="property_name"><a class="link" href="GtkWindow.html#GtkWindow--urgency-hint" title="The “urgency-hint” property">urgency-hint</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type"><a class="link" href="GtkWindow.html#GtkWindowPosition" title="enum GtkWindowPosition"><span class="type">GtkWindowPosition</span></a></td>
|
||
<td class="property_name"><a class="link" href="GtkWindow.html#GtkWindow--window-position" title="The “window-position” property">window-position</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="GtkWindow.style-properties"></a><h2>Style Properties</h2>
|
||
<div class="informaltable"><table class="informaltable" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="style_properties_type">
|
||
<col width="300px" class="style_properties_name">
|
||
<col width="200px" class="style_properties_flags">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="property_type">
|
||
<span class="type">char</span> *</td>
|
||
<td class="property_name"><a class="link" href="GtkWindow.html#GtkWindow--s-decoration-button-layout" title="The “decoration-button-layout” style property">decoration-button-layout</a></td>
|
||
<td class="property_flags">Read</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type"><span class="type">int</span></td>
|
||
<td class="property_name"><a class="link" href="GtkWindow.html#GtkWindow--s-decoration-resize-handle" title="The “decoration-resize-handle” style property">decoration-resize-handle</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="GtkWindow.signals"></a><h2>Signals</h2>
|
||
<div class="informaltable"><table class="informaltable" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="signal_proto_type">
|
||
<col width="300px" class="signal_proto_name">
|
||
<col width="200px" class="signal_proto_flags">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="signal_type"><span class="returnvalue">void</span></td>
|
||
<td class="signal_name"><a class="link" href="GtkWindow.html#GtkWindow-activate-default" title="The “activate-default” signal">activate-default</a></td>
|
||
<td class="signal_flags">Action</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="signal_type"><span class="returnvalue">void</span></td>
|
||
<td class="signal_name"><a class="link" href="GtkWindow.html#GtkWindow-activate-focus" title="The “activate-focus” signal">activate-focus</a></td>
|
||
<td class="signal_flags">Action</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="signal_type"><span class="returnvalue">gboolean</span></td>
|
||
<td class="signal_name"><a class="link" href="GtkWindow.html#GtkWindow-enable-debugging" title="The “enable-debugging” signal">enable-debugging</a></td>
|
||
<td class="signal_flags">Action</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="signal_type"><span class="returnvalue">void</span></td>
|
||
<td class="signal_name"><a class="link" href="GtkWindow.html#GtkWindow-keys-changed" title="The “keys-changed” signal">keys-changed</a></td>
|
||
<td class="signal_flags">Run First</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="signal_type"><span class="returnvalue">void</span></td>
|
||
<td class="signal_name"><a class="link" href="GtkWindow.html#GtkWindow-set-focus" title="The “set-focus” signal">set-focus</a></td>
|
||
<td class="signal_flags">Run Last</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="GtkWindow.other"></a><h2>Types and Values</h2>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="other_proto_type">
|
||
<col class="other_proto_name">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="datatype_keyword"> </td>
|
||
<td class="function_name"><a class="link" href="GtkWindow.html#GtkWindow-struct" title="GtkWindow">GtkWindow</a></td>
|
||
</tr>
|
||
<tr>
|
||
<td class="datatype_keyword">struct</td>
|
||
<td class="function_name"><a class="link" href="GtkWindow.html#GtkWindowClass" title="struct GtkWindowClass">GtkWindowClass</a></td>
|
||
</tr>
|
||
<tr>
|
||
<td class="datatype_keyword">enum</td>
|
||
<td class="function_name"><a class="link" href="GtkWindow.html#GtkWindowType" title="enum GtkWindowType">GtkWindowType</a></td>
|
||
</tr>
|
||
<tr>
|
||
<td class="datatype_keyword">enum</td>
|
||
<td class="function_name"><a class="link" href="GtkWindow.html#GtkWindowPosition" title="enum GtkWindowPosition">GtkWindowPosition</a></td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="GtkWindow.object-hierarchy"></a><h2>Object Hierarchy</h2>
|
||
<pre class="screen"> GObject
|
||
<span class="lineart">╰──</span> GInitiallyUnowned
|
||
<span class="lineart">╰──</span> <a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a>
|
||
<span class="lineart">╰──</span> <a class="link" href="GtkContainer.html" title="GtkContainer">GtkContainer</a>
|
||
<span class="lineart">╰──</span> <a class="link" href="GtkBin.html" title="GtkBin">GtkBin</a>
|
||
<span class="lineart">╰──</span> GtkWindow
|
||
<span class="lineart">├──</span> <a class="link" href="GtkDialog.html" title="GtkDialog">GtkDialog</a>
|
||
<span class="lineart">├──</span> <a class="link" href="GtkApplicationWindow.html" title="GtkApplicationWindow">GtkApplicationWindow</a>
|
||
<span class="lineart">├──</span> <a class="link" href="GtkAssistant.html" title="GtkAssistant">GtkAssistant</a>
|
||
<span class="lineart">├──</span> <a class="link" href="GtkOffscreenWindow.html" title="GtkOffscreenWindow">GtkOffscreenWindow</a>
|
||
<span class="lineart">├──</span> <a class="link" href="GtkPlug.html" title="GtkPlug">GtkPlug</a>
|
||
<span class="lineart">╰──</span> <a class="link" href="GtkShortcutsWindow.html" title="GtkShortcutsWindow">GtkShortcutsWindow</a>
|
||
</pre>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="GtkWindow.implemented-interfaces"></a><h2>Implemented Interfaces</h2>
|
||
<p>
|
||
GtkWindow implements
|
||
AtkImplementorIface and <a class="link" href="GtkBuildable.html" title="GtkBuildable">GtkBuildable</a>.</p>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="GtkWindow.includes"></a><h2>Includes</h2>
|
||
<pre class="synopsis">#include <gtk/gtk.h>
|
||
</pre>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="GtkWindow.description"></a><h2>Description</h2>
|
||
<p>A GtkWindow is a toplevel window which can contain other widgets.
|
||
Windows normally have decorations that are under the control
|
||
of the windowing system and allow the user to manipulate the window
|
||
(resize it, move it, close it,...).</p>
|
||
<div class="refsect2">
|
||
<a name="id-1.3.6.2.11.3"></a><h3>GtkWindow as GtkBuildable</h3>
|
||
<p>The GtkWindow implementation of the <a class="link" href="GtkBuildable.html" title="GtkBuildable"><span class="type">GtkBuildable</span></a> interface supports a
|
||
custom <accel-groups> element, which supports any number of <group>
|
||
elements representing the <a class="link" href="gtk3-Keyboard-Accelerators.html#GtkAccelGroup"><span class="type">GtkAccelGroup</span></a> objects you want to add to
|
||
your window (synonymous with <a class="link" href="GtkWindow.html#gtk-window-add-accel-group" title="gtk_window_add_accel_group ()"><code class="function">gtk_window_add_accel_group()</code></a>.</p>
|
||
<p>It also supports the <initial-focus> element, whose name property names
|
||
the widget to receive the focus when the window is mapped.</p>
|
||
<p>An example of a UI definition fragment with accel groups:</p>
|
||
<div class="informalexample">
|
||
<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
|
||
<tbody>
|
||
<tr>
|
||
<td class="listing_lines" align="right"><pre>1
|
||
2
|
||
3
|
||
4
|
||
5
|
||
6
|
||
7
|
||
8
|
||
9
|
||
10</pre></td>
|
||
<td class="listing_code"><pre class="programlisting"><span class="o"><</span><span class="n">object</span> <span class="n">class</span><span class="o">=</span><span class="s">"GtkWindow"</span><span class="o">></span>
|
||
<span class="o"><</span><span class="n">accel</span><span class="o">-</span><span class="n">groups</span><span class="o">></span>
|
||
<span class="o"><</span><span class="n">group</span> <span class="n">name</span><span class="o">=</span><span class="s">"accelgroup1"</span><span class="o">/></span>
|
||
<span class="o"></</span><span class="n">accel</span><span class="o">-</span><span class="n">groups</span><span class="o">></span>
|
||
<span class="o"><</span><span class="n">initial</span><span class="o">-</span><span class="n">focus</span> <span class="n">name</span><span class="o">=</span><span class="s">"thunderclap"</span><span class="o">/></span>
|
||
<span class="o"></</span><span class="n">object</span><span class="o">></span>
|
||
|
||
<span class="p">...</span>
|
||
|
||
<span class="o"><</span><span class="n">object</span> <span class="n">class</span><span class="o">=</span><span class="s">"GtkAccelGroup"</span> <span class="n">id</span><span class="o">=</span><span class="s">"accelgroup1"</span><span class="o">/></span></pre></td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
</div>
|
||
|
||
<p></p>
|
||
<p>The GtkWindow implementation of the <a class="link" href="GtkBuildable.html" title="GtkBuildable"><span class="type">GtkBuildable</span></a> interface supports
|
||
setting a child as the titlebar by specifying “titlebar” as the “type”
|
||
attribute of a <child> element.</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="id-1.3.6.2.11.4"></a><h3>CSS nodes</h3>
|
||
<div class="informalexample">
|
||
<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
|
||
<tbody>
|
||
<tr>
|
||
<td class="listing_lines" align="right"><pre>1
|
||
2
|
||
3
|
||
4</pre></td>
|
||
<td class="listing_code"><pre class="programlisting"><span class="n">window</span><span class="p">.</span><span class="n">background</span>
|
||
<span class="err">├──</span> <span class="n">decoration</span>
|
||
<span class="err">├──</span> <span class="o"><</span><span class="n">titlebar</span> <span class="n">child</span><span class="o">></span><span class="p">.</span><span class="n">titlebar</span> <span class="p">[.</span><span class="k">default</span><span class="o">-</span><span class="n">decoration</span><span class="p">]</span>
|
||
<span class="err">╰──</span> <span class="o"><</span><span class="n">child</span><span class="o">></span></pre></td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
</div>
|
||
|
||
<p></p>
|
||
<p>GtkWindow has a main CSS node with name window and style class .background,
|
||
and a subnode with name decoration.</p>
|
||
<p>Style classes that are typically used with the main CSS node are .csd (when
|
||
client-side decorations are in use), .solid-csd (for client-side decorations
|
||
without invisible borders), .ssd (used by mutter when rendering server-side
|
||
decorations). GtkWindow also represents window states with the following
|
||
style classes on the main node: .tiled, .maximized, .fullscreen. Specialized
|
||
types of window often add their own discriminating style classes, such as
|
||
.popup or .tooltip.</p>
|
||
<p>GtkWindow adds the .titlebar and .default-decoration style classes to the
|
||
widget that is added as a titlebar child.</p>
|
||
</div>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="GtkWindow.functions_details"></a><h2>Functions</h2>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-new"></a><h3>gtk_window_new ()</h3>
|
||
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
|
||
gtk_window_new (<em class="parameter"><code><a class="link" href="GtkWindow.html#GtkWindowType" title="enum GtkWindowType"><span class="type">GtkWindowType</span></a> type</code></em>);</pre>
|
||
<p>Creates a new <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a>, which is a toplevel window that can
|
||
contain other widgets. Nearly always, the type of the window should
|
||
be <a class="link" href="GtkWindow.html#GTK-WINDOW-TOPLEVEL:CAPS"><span class="type">GTK_WINDOW_TOPLEVEL</span></a>. If you’re implementing something like a
|
||
popup menu from scratch (which is a bad idea, just use <a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a>),
|
||
you might use <a class="link" href="GtkWindow.html#GTK-WINDOW-POPUP:CAPS"><span class="type">GTK_WINDOW_POPUP</span></a>. <a class="link" href="GtkWindow.html#GTK-WINDOW-POPUP:CAPS"><span class="type">GTK_WINDOW_POPUP</span></a> is not for
|
||
dialogs, though in some other toolkits dialogs are called “popups”.
|
||
In GTK+, <a class="link" href="GtkWindow.html#GTK-WINDOW-POPUP:CAPS"><span class="type">GTK_WINDOW_POPUP</span></a> means a pop-up menu or pop-up tooltip.
|
||
On X11, popup windows are not controlled by the
|
||
<a class="link" href="gtk-x11.html#gtk-X11-arch" title="Understanding the X11 architecture">window manager</a>.</p>
|
||
<p>If you simply want an undecorated window (no window borders), use
|
||
<a class="link" href="GtkWindow.html#gtk-window-set-decorated" title="gtk_window_set_decorated ()"><code class="function">gtk_window_set_decorated()</code></a>, don’t use <a class="link" href="GtkWindow.html#GTK-WINDOW-POPUP:CAPS"><span class="type">GTK_WINDOW_POPUP</span></a>.</p>
|
||
<p>All top-level windows created by <a class="link" href="GtkWindow.html#gtk-window-new" title="gtk_window_new ()"><code class="function">gtk_window_new()</code></a> are stored in
|
||
an internal top-level window list. This list can be obtained from
|
||
<a class="link" href="GtkWindow.html#gtk-window-list-toplevels" title="gtk_window_list_toplevels ()"><code class="function">gtk_window_list_toplevels()</code></a>. Due to Gtk+ keeping a reference to
|
||
the window internally, <a class="link" href="GtkWindow.html#gtk-window-new" title="gtk_window_new ()"><code class="function">gtk_window_new()</code></a> does not return a reference
|
||
to the caller.</p>
|
||
<p>To delete a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a>, call <a class="link" href="GtkWidget.html#gtk-widget-destroy" title="gtk_widget_destroy ()"><code class="function">gtk_widget_destroy()</code></a>.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-new.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>type</p></td>
|
||
<td class="parameter_description"><p>type of window</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-new.returns"></a><h4>Returns</h4>
|
||
<p> a new <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a>.</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-set-title"></a><h3>gtk_window_set_title ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_window_set_title (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code>const <span class="type">gchar</span> *title</code></em>);</pre>
|
||
<p>Sets the title of the <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a>. The title of a window will be
|
||
displayed in its title bar; on the X Window System, the title bar
|
||
is rendered by the <a class="link" href="gtk-x11.html#gtk-X11-arch" title="Understanding the X11 architecture">window manager</a>,
|
||
so exactly how the title appears to users may vary
|
||
according to a user’s exact configuration. The title should help a
|
||
user distinguish this window from other windows they may have
|
||
open. A good title might include the application name and current
|
||
document filename, for example.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-set-title.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>title</p></td>
|
||
<td class="parameter_description"><p>title of the window</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-set-wmclass"></a><h3>gtk_window_set_wmclass ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_window_set_wmclass (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code>const <span class="type">gchar</span> *wmclass_name</code></em>,
|
||
<em class="parameter"><code>const <span class="type">gchar</span> *wmclass_class</code></em>);</pre>
|
||
<div class="warning"><p><code class="literal">gtk_window_set_wmclass</code> has been deprecated since version 3.22 and should not be used in newly-written code.</p></div>
|
||
<p>Don’t use this function. It sets the X Window System “class” and
|
||
“name” hints for a window. According to the ICCCM, you should
|
||
always set these to the same value for all windows in an
|
||
application, and GTK+ sets them to that value by default, so calling
|
||
this function is sort of pointless. However, you may want to call
|
||
<a class="link" href="GtkWindow.html#gtk-window-set-role" title="gtk_window_set_role ()"><code class="function">gtk_window_set_role()</code></a> on each window in your application, for the
|
||
benefit of the session manager. Setting the role allows the window
|
||
manager to restore window positions when loading a saved session.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-set-wmclass.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>wmclass_name</p></td>
|
||
<td class="parameter_description"><p>window name hint</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>wmclass_class</p></td>
|
||
<td class="parameter_description"><p>window class hint</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-set-resizable"></a><h3>gtk_window_set_resizable ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_window_set_resizable (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><span class="type">gboolean</span> resizable</code></em>);</pre>
|
||
<p>Sets whether the user can resize a window. Windows are user resizable
|
||
by default.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-set-resizable.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>resizable</p></td>
|
||
<td class="parameter_description"><p><code class="literal">TRUE</code> if the user can resize this window</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-get-resizable"></a><h3>gtk_window_get_resizable ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_window_get_resizable (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>);</pre>
|
||
<p>Gets the value set by <a class="link" href="GtkWindow.html#gtk-window-set-resizable" title="gtk_window_set_resizable ()"><code class="function">gtk_window_set_resizable()</code></a>.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-get-resizable.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-get-resizable.returns"></a><h4>Returns</h4>
|
||
<p> <code class="literal">TRUE</code> if the user can resize the window</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-add-accel-group"></a><h3>gtk_window_add_accel_group ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_window_add_accel_group (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><a class="link" href="gtk3-Keyboard-Accelerators.html#GtkAccelGroup"><span class="type">GtkAccelGroup</span></a> *accel_group</code></em>);</pre>
|
||
<p>Associate <em class="parameter"><code>accel_group</code></em>
|
||
with <em class="parameter"><code>window</code></em>
|
||
, such that calling
|
||
<a class="link" href="gtk3-Keyboard-Accelerators.html#gtk-accel-groups-activate" title="gtk_accel_groups_activate ()"><code class="function">gtk_accel_groups_activate()</code></a> on <em class="parameter"><code>window</code></em>
|
||
will activate accelerators
|
||
in <em class="parameter"><code>accel_group</code></em>
|
||
.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-add-accel-group.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>window to attach accelerator group to</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>accel_group</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="gtk3-Keyboard-Accelerators.html#GtkAccelGroup"><span class="type">GtkAccelGroup</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-remove-accel-group"></a><h3>gtk_window_remove_accel_group ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_window_remove_accel_group (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><a class="link" href="gtk3-Keyboard-Accelerators.html#GtkAccelGroup"><span class="type">GtkAccelGroup</span></a> *accel_group</code></em>);</pre>
|
||
<p>Reverses the effects of <a class="link" href="GtkWindow.html#gtk-window-add-accel-group" title="gtk_window_add_accel_group ()"><code class="function">gtk_window_add_accel_group()</code></a>.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-remove-accel-group.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>accel_group</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="gtk3-Keyboard-Accelerators.html#GtkAccelGroup"><span class="type">GtkAccelGroup</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-activate-focus"></a><h3>gtk_window_activate_focus ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_window_activate_focus (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>);</pre>
|
||
<p>Activates the current focused widget within the window.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-activate-focus.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-activate-focus.returns"></a><h4>Returns</h4>
|
||
<p> <code class="literal">TRUE</code> if a widget got activated.</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-activate-default"></a><h3>gtk_window_activate_default ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_window_activate_default (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>);</pre>
|
||
<p>Activates the default widget for the window, unless the current
|
||
focused widget has been configured to receive the default action
|
||
(see <a class="link" href="GtkWidget.html#gtk-widget-set-receives-default" title="gtk_widget_set_receives_default ()"><code class="function">gtk_widget_set_receives_default()</code></a>), in which case the
|
||
focused widget is activated.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-activate-default.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-activate-default.returns"></a><h4>Returns</h4>
|
||
<p> <code class="literal">TRUE</code> if a widget got activated.</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-set-modal"></a><h3>gtk_window_set_modal ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_window_set_modal (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><span class="type">gboolean</span> modal</code></em>);</pre>
|
||
<p>Sets a window modal or non-modal. Modal windows prevent interaction
|
||
with other windows in the same application. To keep modal dialogs
|
||
on top of main application windows, use
|
||
<a class="link" href="GtkWindow.html#gtk-window-set-transient-for" title="gtk_window_set_transient_for ()"><code class="function">gtk_window_set_transient_for()</code></a> to make the dialog transient for the
|
||
parent; most <a class="link" href="gtk-x11.html#gtk-X11-arch" title="Understanding the X11 architecture">window managers</a>
|
||
will then disallow lowering the dialog below the parent.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-set-modal.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>modal</p></td>
|
||
<td class="parameter_description"><p>whether the window is modal</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-set-default-size"></a><h3>gtk_window_set_default_size ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_window_set_default_size (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><span class="type">gint</span> width</code></em>,
|
||
<em class="parameter"><code><span class="type">gint</span> height</code></em>);</pre>
|
||
<p>Sets the default size of a window. If the window’s “natural” size
|
||
(its size request) is larger than the default, the default will be
|
||
ignored. More generally, if the default size does not obey the
|
||
geometry hints for the window (<a class="link" href="GtkWindow.html#gtk-window-set-geometry-hints" title="gtk_window_set_geometry_hints ()"><code class="function">gtk_window_set_geometry_hints()</code></a> can
|
||
be used to set these explicitly), the default size will be clamped
|
||
to the nearest permitted size.</p>
|
||
<p>Unlike <a class="link" href="GtkWidget.html#gtk-widget-set-size-request" title="gtk_widget_set_size_request ()"><code class="function">gtk_widget_set_size_request()</code></a>, which sets a size request for
|
||
a widget and thus would keep users from shrinking the window, this
|
||
function only sets the initial size, just as if the user had
|
||
resized the window themselves. Users can still shrink the window
|
||
again as they normally would. Setting a default size of -1 means to
|
||
use the “natural” default size (the size request of the window).</p>
|
||
<p>For more control over a window’s initial size and how resizing works,
|
||
investigate <a class="link" href="GtkWindow.html#gtk-window-set-geometry-hints" title="gtk_window_set_geometry_hints ()"><code class="function">gtk_window_set_geometry_hints()</code></a>.</p>
|
||
<p>For some uses, <a class="link" href="GtkWindow.html#gtk-window-resize" title="gtk_window_resize ()"><code class="function">gtk_window_resize()</code></a> is a more appropriate function.
|
||
<a class="link" href="GtkWindow.html#gtk-window-resize" title="gtk_window_resize ()"><code class="function">gtk_window_resize()</code></a> changes the current size of the window, rather
|
||
than the size to be used on initial display. <a class="link" href="GtkWindow.html#gtk-window-resize" title="gtk_window_resize ()"><code class="function">gtk_window_resize()</code></a> always
|
||
affects the window itself, not the geometry widget.</p>
|
||
<p>The default size of a window only affects the first time a window is
|
||
shown; if a window is hidden and re-shown, it will remember the size
|
||
it had prior to hiding, rather than using the default size.</p>
|
||
<p>Windows can’t actually be 0x0 in size, they must be at least 1x1, but
|
||
passing 0 for <em class="parameter"><code>width</code></em>
|
||
and <em class="parameter"><code>height</code></em>
|
||
is OK, resulting in a 1x1 default size.</p>
|
||
<p>If you use this function to reestablish a previously saved window size,
|
||
note that the appropriate size to save is the one returned by
|
||
<a class="link" href="GtkWindow.html#gtk-window-get-size" title="gtk_window_get_size ()"><code class="function">gtk_window_get_size()</code></a>. Using the window allocation directly will not
|
||
work in all circumstances and can lead to growing or shrinking windows.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-set-default-size.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>width</p></td>
|
||
<td class="parameter_description"><p>width in pixels, or -1 to unset the default width</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>height</p></td>
|
||
<td class="parameter_description"><p>height in pixels, or -1 to unset the default height</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-set-default-geometry"></a><h3>gtk_window_set_default_geometry ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_window_set_default_geometry (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><span class="type">gint</span> width</code></em>,
|
||
<em class="parameter"><code><span class="type">gint</span> height</code></em>);</pre>
|
||
<div class="warning">
|
||
<p><code class="literal">gtk_window_set_default_geometry</code> has been deprecated since version 3.20 and should not be used in newly-written code.</p>
|
||
<p>This function does nothing. If you want to set a default
|
||
size, use <a class="link" href="GtkWindow.html#gtk-window-set-default-size" title="gtk_window_set_default_size ()"><code class="function">gtk_window_set_default_size()</code></a> instead.</p>
|
||
</div>
|
||
<p>Like <a class="link" href="GtkWindow.html#gtk-window-set-default-size" title="gtk_window_set_default_size ()"><code class="function">gtk_window_set_default_size()</code></a>, but <em class="parameter"><code>width</code></em>
|
||
and <em class="parameter"><code>height</code></em>
|
||
are interpreted
|
||
in terms of the base size and increment set with
|
||
gtk_window_set_geometry_hints.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-set-default-geometry.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>width</p></td>
|
||
<td class="parameter_description"><p>width in resize increments, or -1 to unset the default width</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>height</p></td>
|
||
<td class="parameter_description"><p>height in resize increments, or -1 to unset the default height</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-set-geometry-hints"></a><h3>gtk_window_set_geometry_hints ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_window_set_geometry_hints (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *geometry_widget</code></em>,
|
||
<em class="parameter"><code><span class="type">GdkGeometry</span> *geometry</code></em>,
|
||
<em class="parameter"><code><span class="type">GdkWindowHints</span> geom_mask</code></em>);</pre>
|
||
<p>This function sets up hints about how a window can be resized by
|
||
the user. You can set a minimum and maximum size; allowed resize
|
||
increments (e.g. for xterm, you can only resize by the size of a
|
||
character); aspect ratios; and more. See the <span class="type">GdkGeometry</span> struct.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-set-geometry-hints.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>geometry_widget</p></td>
|
||
<td class="parameter_description"><p>widget the geometry hints used to be applied to
|
||
or <code class="literal">NULL</code>. Since 3.20 this argument is ignored and GTK behaves as if <code class="literal">NULL</code> was
|
||
set. </p></td>
|
||
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>geometry</p></td>
|
||
<td class="parameter_description"><p>struct containing geometry information or <code class="literal">NULL</code>. </p></td>
|
||
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>geom_mask</p></td>
|
||
<td class="parameter_description"><p>mask indicating which struct fields should be paid attention to</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-set-gravity"></a><h3>gtk_window_set_gravity ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_window_set_gravity (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><span class="type">GdkGravity</span> gravity</code></em>);</pre>
|
||
<p>Window gravity defines the meaning of coordinates passed to
|
||
<a class="link" href="GtkWindow.html#gtk-window-move" title="gtk_window_move ()"><code class="function">gtk_window_move()</code></a>. See <a class="link" href="GtkWindow.html#gtk-window-move" title="gtk_window_move ()"><code class="function">gtk_window_move()</code></a> and <span class="type">GdkGravity</span> for
|
||
more details.</p>
|
||
<p>The default window gravity is <span class="type">GDK_GRAVITY_NORTH_WEST</span> which will
|
||
typically “do what you mean.”</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-set-gravity.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>gravity</p></td>
|
||
<td class="parameter_description"><p>window gravity</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-get-gravity"></a><h3>gtk_window_get_gravity ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">GdkGravity</span>
|
||
gtk_window_get_gravity (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>);</pre>
|
||
<p>Gets the value set by <a class="link" href="GtkWindow.html#gtk-window-set-gravity" title="gtk_window_set_gravity ()"><code class="function">gtk_window_set_gravity()</code></a>.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-get-gravity.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-get-gravity.returns"></a><h4>Returns</h4>
|
||
<p>window gravity. </p>
|
||
<p><span class="annotation">[<acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>]</span></p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-set-position"></a><h3>gtk_window_set_position ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_window_set_position (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkWindow.html#GtkWindowPosition" title="enum GtkWindowPosition"><span class="type">GtkWindowPosition</span></a> position</code></em>);</pre>
|
||
<p>Sets a position constraint for this window. If the old or new
|
||
constraint is <a class="link" href="GtkWindow.html#GTK-WIN-POS-CENTER-ALWAYS:CAPS"><code class="literal">GTK_WIN_POS_CENTER_ALWAYS</code></a>, this will also cause
|
||
the window to be repositioned to satisfy the new constraint.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-set-position.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a>.</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>position</p></td>
|
||
<td class="parameter_description"><p>a position constraint.</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-set-transient-for"></a><h3>gtk_window_set_transient_for ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_window_set_transient_for (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *parent</code></em>);</pre>
|
||
<p>Dialog windows should be set transient for the main application
|
||
window they were spawned from. This allows
|
||
<a class="link" href="gtk-x11.html#gtk-X11-arch" title="Understanding the X11 architecture">window managers</a> to e.g. keep the
|
||
dialog on top of the main window, or center the dialog over the
|
||
main window. <a class="link" href="GtkDialog.html#gtk-dialog-new-with-buttons" title="gtk_dialog_new_with_buttons ()"><code class="function">gtk_dialog_new_with_buttons()</code></a> and other convenience
|
||
functions in GTK+ will sometimes call
|
||
<a class="link" href="GtkWindow.html#gtk-window-set-transient-for" title="gtk_window_set_transient_for ()"><code class="function">gtk_window_set_transient_for()</code></a> on your behalf.</p>
|
||
<p>Passing <code class="literal">NULL</code> for <em class="parameter"><code>parent</code></em>
|
||
unsets the current transient window.</p>
|
||
<p>On Wayland, this function can also be used to attach a new
|
||
<a class="link" href="GtkWindow.html#GTK-WINDOW-POPUP:CAPS"><span class="type">GTK_WINDOW_POPUP</span></a> to a <a class="link" href="GtkWindow.html#GTK-WINDOW-TOPLEVEL:CAPS"><span class="type">GTK_WINDOW_TOPLEVEL</span></a> parent already mapped
|
||
on screen so that the <a class="link" href="GtkWindow.html#GTK-WINDOW-POPUP:CAPS"><span class="type">GTK_WINDOW_POPUP</span></a> will be created as a
|
||
subsurface-based window <span class="type">GDK_WINDOW_SUBSURFACE</span> which can be
|
||
positioned at will relatively to the <a class="link" href="GtkWindow.html#GTK-WINDOW-TOPLEVEL:CAPS"><span class="type">GTK_WINDOW_TOPLEVEL</span></a> surface.</p>
|
||
<p>On Windows, this function puts the child window on top of the parent,
|
||
much as the window manager would have done on X.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-set-transient-for.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>parent</p></td>
|
||
<td class="parameter_description"><p>parent window, or <code class="literal">NULL</code>. </p></td>
|
||
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-set-attached-to"></a><h3>gtk_window_set_attached_to ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_window_set_attached_to (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *attach_widget</code></em>);</pre>
|
||
<p>Marks <em class="parameter"><code>window</code></em>
|
||
as attached to <em class="parameter"><code>attach_widget</code></em>
|
||
. This creates a logical binding
|
||
between the window and the widget it belongs to, which is used by GTK+ to
|
||
propagate information such as styling or accessibility to <em class="parameter"><code>window</code></em>
|
||
as if it
|
||
was a children of <em class="parameter"><code>attach_widget</code></em>
|
||
.</p>
|
||
<p>Examples of places where specifying this relation is useful are for instance
|
||
a <a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> created by a <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a>, a completion popup window
|
||
created by <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> or a typeahead search entry created by <a class="link" href="GtkTreeView.html" title="GtkTreeView"><span class="type">GtkTreeView</span></a>.</p>
|
||
<p>Note that this function should not be confused with
|
||
<a class="link" href="GtkWindow.html#gtk-window-set-transient-for" title="gtk_window_set_transient_for ()"><code class="function">gtk_window_set_transient_for()</code></a>, which specifies a window manager relation
|
||
between two toplevels instead.</p>
|
||
<p>Passing <code class="literal">NULL</code> for <em class="parameter"><code>attach_widget</code></em>
|
||
detaches the window.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-set-attached-to.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>attach_widget</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>, or <code class="literal">NULL</code>. </p></td>
|
||
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: <a class="link" href="api-index-3-4.html#api-index-3.4">3.4</a></p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-set-destroy-with-parent"></a><h3>gtk_window_set_destroy_with_parent ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_window_set_destroy_with_parent (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><span class="type">gboolean</span> setting</code></em>);</pre>
|
||
<p>If <em class="parameter"><code>setting</code></em>
|
||
is <code class="literal">TRUE</code>, then destroying the transient parent of <em class="parameter"><code>window</code></em>
|
||
|
||
will also destroy <em class="parameter"><code>window</code></em>
|
||
itself. This is useful for dialogs that
|
||
shouldn’t persist beyond the lifetime of the main window they're
|
||
associated with, for example.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-set-destroy-with-parent.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>setting</p></td>
|
||
<td class="parameter_description"><p>whether to destroy <em class="parameter"><code>window</code></em>
|
||
with its transient parent</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-set-hide-titlebar-when-maximized"></a><h3>gtk_window_set_hide_titlebar_when_maximized ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_window_set_hide_titlebar_when_maximized
|
||
(<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><span class="type">gboolean</span> setting</code></em>);</pre>
|
||
<p>If <em class="parameter"><code>setting</code></em>
|
||
is <code class="literal">TRUE</code>, then <em class="parameter"><code>window</code></em>
|
||
will request that it’s titlebar
|
||
should be hidden when maximized.
|
||
This is useful for windows that don’t convey any information other
|
||
than the application name in the titlebar, to put the available
|
||
screen space to better use. If the underlying window system does not
|
||
support the request, the setting will not have any effect.</p>
|
||
<p>Note that custom titlebars set with <a class="link" href="GtkWindow.html#gtk-window-set-titlebar" title="gtk_window_set_titlebar ()"><code class="function">gtk_window_set_titlebar()</code></a> are
|
||
not affected by this. The application is in full control of their
|
||
content and visibility anyway.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-set-hide-titlebar-when-maximized.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>setting</p></td>
|
||
<td class="parameter_description"><p>whether to hide the titlebar when <em class="parameter"><code>window</code></em>
|
||
is maximized</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: <a class="link" href="api-index-3-4.html#api-index-3.4">3.4</a></p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-set-screen"></a><h3>gtk_window_set_screen ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_window_set_screen (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><span class="type">GdkScreen</span> *screen</code></em>);</pre>
|
||
<p>Sets the <span class="type">GdkScreen</span> where the <em class="parameter"><code>window</code></em>
|
||
is displayed; if
|
||
the window is already mapped, it will be unmapped, and
|
||
then remapped on the new screen.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-set-screen.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a>.</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>screen</p></td>
|
||
<td class="parameter_description"><p>a <span class="type">GdkScreen</span>.</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: 2.2</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-get-screen"></a><h3>gtk_window_get_screen ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">GdkScreen</span> *
|
||
gtk_window_get_screen (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>);</pre>
|
||
<p>Returns the <span class="type">GdkScreen</span> associated with <em class="parameter"><code>window</code></em>
|
||
.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-get-screen.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a>.</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-get-screen.returns"></a><h4>Returns</h4>
|
||
<p>a <span class="type">GdkScreen</span>. </p>
|
||
<p><span class="annotation">[<acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>]</span></p>
|
||
</div>
|
||
<p class="since">Since: 2.2</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-is-active"></a><h3>gtk_window_is_active ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_window_is_active (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>);</pre>
|
||
<p>Returns whether the window is part of the current active toplevel.
|
||
(That is, the toplevel window receiving keystrokes.)
|
||
The return value is <code class="literal">TRUE</code> if the window is active toplevel
|
||
itself, but also if it is, say, a <a class="link" href="GtkPlug.html" title="GtkPlug"><span class="type">GtkPlug</span></a> embedded in the active toplevel.
|
||
You might use this function if you wanted to draw a widget
|
||
differently in an active window from a widget in an inactive window.
|
||
See <a class="link" href="GtkWindow.html#gtk-window-has-toplevel-focus" title="gtk_window_has_toplevel_focus ()"><code class="function">gtk_window_has_toplevel_focus()</code></a></p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-is-active.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-is-active.returns"></a><h4>Returns</h4>
|
||
<p> <code class="literal">TRUE</code> if the window part of the current active window.</p>
|
||
</div>
|
||
<p class="since">Since: 2.4</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-is-maximized"></a><h3>gtk_window_is_maximized ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_window_is_maximized (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>);</pre>
|
||
<p>Retrieves the current maximized state of <em class="parameter"><code>window</code></em>
|
||
.</p>
|
||
<p>Note that since maximization is ultimately handled by the window
|
||
manager and happens asynchronously to an application request, you
|
||
shouldn’t assume the return value of this function changing
|
||
immediately (or at all), as an effect of calling
|
||
<a class="link" href="GtkWindow.html#gtk-window-maximize" title="gtk_window_maximize ()"><code class="function">gtk_window_maximize()</code></a> or <a class="link" href="GtkWindow.html#gtk-window-unmaximize" title="gtk_window_unmaximize ()"><code class="function">gtk_window_unmaximize()</code></a>.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-is-maximized.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-is-maximized.returns"></a><h4>Returns</h4>
|
||
<p> whether the window has a maximized state.</p>
|
||
</div>
|
||
<p class="since">Since: <a class="link" href="api-index-3-12.html#api-index-3.12">3.12</a></p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-has-toplevel-focus"></a><h3>gtk_window_has_toplevel_focus ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_window_has_toplevel_focus (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>);</pre>
|
||
<p>Returns whether the input focus is within this GtkWindow.
|
||
For real toplevel windows, this is identical to <a class="link" href="GtkWindow.html#gtk-window-is-active" title="gtk_window_is_active ()"><code class="function">gtk_window_is_active()</code></a>,
|
||
but for embedded windows, like <a class="link" href="GtkPlug.html" title="GtkPlug"><span class="type">GtkPlug</span></a>, the results will differ.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-has-toplevel-focus.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-has-toplevel-focus.returns"></a><h4>Returns</h4>
|
||
<p> <code class="literal">TRUE</code> if the input focus is within this GtkWindow</p>
|
||
</div>
|
||
<p class="since">Since: 2.4</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-list-toplevels"></a><h3>gtk_window_list_toplevels ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">GList</span> *
|
||
gtk_window_list_toplevels (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
|
||
<p>Returns a list of all existing toplevel windows. 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
|
||
<code class="literal">g_list_foreach (result, (GFunc)g_object_ref, NULL)</code> first, and
|
||
then unref all the widgets afterwards.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-list-toplevels.returns"></a><h4>Returns</h4>
|
||
<p>list of toplevel widgets. </p>
|
||
<p><span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> GtkWidget][<acronym title="The caller owns the data container, but not the data inside it."><span class="acronym">transfer container</span></acronym>]</span></p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-add-mnemonic"></a><h3>gtk_window_add_mnemonic ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_window_add_mnemonic (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><span class="type">guint</span> keyval</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *target</code></em>);</pre>
|
||
<p>Adds a mnemonic to this window.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-add-mnemonic.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>keyval</p></td>
|
||
<td class="parameter_description"><p>the mnemonic</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>target</p></td>
|
||
<td class="parameter_description"><p>the widget that gets activated by the mnemonic</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-remove-mnemonic"></a><h3>gtk_window_remove_mnemonic ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_window_remove_mnemonic (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><span class="type">guint</span> keyval</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *target</code></em>);</pre>
|
||
<p>Removes a mnemonic from this window.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-remove-mnemonic.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>keyval</p></td>
|
||
<td class="parameter_description"><p>the mnemonic</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>target</p></td>
|
||
<td class="parameter_description"><p>the widget that gets activated by the mnemonic</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-mnemonic-activate"></a><h3>gtk_window_mnemonic_activate ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_window_mnemonic_activate (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><span class="type">guint</span> keyval</code></em>,
|
||
<em class="parameter"><code><span class="type">GdkModifierType</span> modifier</code></em>);</pre>
|
||
<p>Activates the targets associated with the mnemonic.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-mnemonic-activate.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>keyval</p></td>
|
||
<td class="parameter_description"><p>the mnemonic</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>modifier</p></td>
|
||
<td class="parameter_description"><p>the modifiers</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-mnemonic-activate.returns"></a><h4>Returns</h4>
|
||
<p> <code class="literal">TRUE</code> if the activation is done.</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-activate-key"></a><h3>gtk_window_activate_key ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_window_activate_key (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><span class="type">GdkEventKey</span> *event</code></em>);</pre>
|
||
<p>Activates mnemonics and accelerators for this <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a>. This is normally
|
||
called by the default ::key_press_event handler for toplevel windows,
|
||
however in some cases it may be useful to call this directly when
|
||
overriding the standard key handling for a toplevel window.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-activate-key.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>event</p></td>
|
||
<td class="parameter_description"><p>a <span class="type">GdkEventKey</span></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-activate-key.returns"></a><h4>Returns</h4>
|
||
<p> <code class="literal">TRUE</code> if a mnemonic or accelerator was found and activated.</p>
|
||
</div>
|
||
<p class="since">Since: 2.4</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-propagate-key-event"></a><h3>gtk_window_propagate_key_event ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_window_propagate_key_event (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><span class="type">GdkEventKey</span> *event</code></em>);</pre>
|
||
<p>Propagate a key press or release event to the focus widget and
|
||
up the focus container chain until a widget handles <em class="parameter"><code>event</code></em>
|
||
.
|
||
This is normally called by the default ::key_press_event and
|
||
::key_release_event handlers for toplevel windows,
|
||
however in some cases it may be useful to call this directly when
|
||
overriding the standard key handling for a toplevel window.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-propagate-key-event.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>event</p></td>
|
||
<td class="parameter_description"><p>a <span class="type">GdkEventKey</span></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-propagate-key-event.returns"></a><h4>Returns</h4>
|
||
<p> <code class="literal">TRUE</code> if a widget in the focus chain handled the event.</p>
|
||
</div>
|
||
<p class="since">Since: 2.4</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-get-focus"></a><h3>gtk_window_get_focus ()</h3>
|
||
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
|
||
gtk_window_get_focus (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>);</pre>
|
||
<p>Retrieves the current focused widget within the window.
|
||
Note that this is the widget that would have the focus
|
||
if the toplevel window focused; if the toplevel window
|
||
is not focused then <code class="literal">gtk_widget_has_focus (widget)</code> will
|
||
not be <code class="literal">TRUE</code> for the widget.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-get-focus.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-get-focus.returns"></a><h4>Returns</h4>
|
||
<p>the currently focused widget,
|
||
or <code class="literal">NULL</code> if there is none. </p>
|
||
<p><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>][<acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>]</span></p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-set-focus"></a><h3>gtk_window_set_focus ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_window_set_focus (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *focus</code></em>);</pre>
|
||
<p>If <em class="parameter"><code>focus</code></em>
|
||
is not the current focus widget, and is focusable, sets
|
||
it as the focus widget for the window. If <em class="parameter"><code>focus</code></em>
|
||
is <code class="literal">NULL</code>, unsets
|
||
the focus widget for this window. To set the focus to a particular
|
||
widget in the toplevel, it is usually more convenient to use
|
||
<a class="link" href="GtkWidget.html#gtk-widget-grab-focus" title="gtk_widget_grab_focus ()"><code class="function">gtk_widget_grab_focus()</code></a> instead of this function.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-set-focus.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>focus</p></td>
|
||
<td class="parameter_description"><p>widget to be the new focus widget, or <code class="literal">NULL</code> to unset
|
||
any focus widget for the toplevel window. </p></td>
|
||
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-get-default-widget"></a><h3>gtk_window_get_default_widget ()</h3>
|
||
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
|
||
gtk_window_get_default_widget (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>);</pre>
|
||
<p>Returns the default widget for <em class="parameter"><code>window</code></em>
|
||
. See
|
||
<a class="link" href="GtkWindow.html#gtk-window-set-default" title="gtk_window_set_default ()"><code class="function">gtk_window_set_default()</code></a> for more details.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-get-default-widget.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-get-default-widget.returns"></a><h4>Returns</h4>
|
||
<p>the default widget, or <code class="literal">NULL</code>
|
||
if there is none. </p>
|
||
<p><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>][<acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>]</span></p>
|
||
</div>
|
||
<p class="since">Since: 2.14</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-set-default"></a><h3>gtk_window_set_default ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_window_set_default (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *default_widget</code></em>);</pre>
|
||
<p>The default widget is the widget that’s activated when the user
|
||
presses Enter in a dialog (for example). This function sets or
|
||
unsets the default widget for a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a>. When setting (rather
|
||
than unsetting) the default widget it’s generally easier to call
|
||
<a class="link" href="GtkWidget.html#gtk-widget-grab-default" title="gtk_widget_grab_default ()"><code class="function">gtk_widget_grab_default()</code></a> on the widget. Before making a widget
|
||
the default widget, you must call <a class="link" href="GtkWidget.html#gtk-widget-set-can-default" title="gtk_widget_set_can_default ()"><code class="function">gtk_widget_set_can_default()</code></a> on
|
||
the widget you’d like to make the default.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-set-default.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>default_widget</p></td>
|
||
<td class="parameter_description"><p>widget to be the default, or <code class="literal">NULL</code>
|
||
to unset the default widget for the toplevel. </p></td>
|
||
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-present"></a><h3>gtk_window_present ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_window_present (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>);</pre>
|
||
<p>Presents a window to the user. This function should not be used
|
||
as when it is called, it is too late to gather a valid timestamp
|
||
to allow focus stealing prevention to work correctly.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-present.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-present-with-time"></a><h3>gtk_window_present_with_time ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_window_present_with_time (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><span class="type">guint32</span> timestamp</code></em>);</pre>
|
||
<p>Presents a window to the user. This may mean raising the window
|
||
in the stacking order, deiconifying it, moving it to the current
|
||
desktop, and/or giving it the keyboard focus, possibly dependent
|
||
on the user’s platform, window manager, and preferences.</p>
|
||
<p>If <em class="parameter"><code>window</code></em>
|
||
is hidden, this function calls <a class="link" href="GtkWidget.html#gtk-widget-show" title="gtk_widget_show ()"><code class="function">gtk_widget_show()</code></a>
|
||
as well.</p>
|
||
<p>This function should be used when the user tries to open a window
|
||
that’s already open. Say for example the preferences dialog is
|
||
currently open, and the user chooses Preferences from the menu
|
||
a second time; use <a class="link" href="GtkWindow.html#gtk-window-present" title="gtk_window_present ()"><code class="function">gtk_window_present()</code></a> to move the already-open dialog
|
||
where the user can see it.</p>
|
||
<p>Presents a window to the user in response to a user interaction. The
|
||
timestamp should be gathered when the window was requested to be shown
|
||
(when clicking a link for example), rather than once the window is
|
||
ready to be shown.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-present-with-time.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>timestamp</p></td>
|
||
<td class="parameter_description"><p>the timestamp of the user interaction (typically a
|
||
button or key press event) which triggered this call</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: 2.8</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-close"></a><h3>gtk_window_close ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_window_close (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>);</pre>
|
||
<p>Requests that the window is closed, similar to what happens
|
||
when a window manager close button is clicked.</p>
|
||
<p>This function can be used with close buttons in custom
|
||
titlebars.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-close.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: <a class="link" href="api-index-3-10.html#api-index-3.10">3.10</a></p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-iconify"></a><h3>gtk_window_iconify ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_window_iconify (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>);</pre>
|
||
<p>Asks to iconify (i.e. minimize) the specified <em class="parameter"><code>window</code></em>
|
||
. Note that
|
||
you shouldn’t assume the window is definitely iconified afterward,
|
||
because other entities (e.g. the user or
|
||
<a class="link" href="gtk-x11.html#gtk-X11-arch" title="Understanding the X11 architecture">window manager</a>) could deiconify it
|
||
again, or there may not be a window manager in which case
|
||
iconification isn’t possible, etc. But normally the window will end
|
||
up iconified. Just don’t write code that crashes if not.</p>
|
||
<p>It’s permitted to call this function before showing a window,
|
||
in which case the window will be iconified before it ever appears
|
||
onscreen.</p>
|
||
<p>You can track iconification via the “window-state-event” signal
|
||
on <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-iconify.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-deiconify"></a><h3>gtk_window_deiconify ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_window_deiconify (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>);</pre>
|
||
<p>Asks to deiconify (i.e. unminimize) the specified <em class="parameter"><code>window</code></em>
|
||
. Note
|
||
that you shouldn’t assume the window is definitely deiconified
|
||
afterward, because other entities (e.g. the user or
|
||
<a class="link" href="gtk-x11.html#gtk-X11-arch" title="Understanding the X11 architecture">window manager</a>)) could iconify it
|
||
again before your code which assumes deiconification gets to run.</p>
|
||
<p>You can track iconification via the “window-state-event” signal
|
||
on <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-deiconify.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-stick"></a><h3>gtk_window_stick ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_window_stick (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>);</pre>
|
||
<p>Asks to stick <em class="parameter"><code>window</code></em>
|
||
, which means that it will appear on all user
|
||
desktops. Note that you shouldn’t assume the window is definitely
|
||
stuck afterward, because other entities (e.g. the user or
|
||
<a class="link" href="gtk-x11.html#gtk-X11-arch" title="Understanding the X11 architecture">window manager</a> could unstick it
|
||
again, and some window managers do not support sticking
|
||
windows. But normally the window will end up stuck. Just don't
|
||
write code that crashes if not.</p>
|
||
<p>It’s permitted to call this function before showing a window.</p>
|
||
<p>You can track stickiness via the “window-state-event” signal
|
||
on <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-stick.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-unstick"></a><h3>gtk_window_unstick ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_window_unstick (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>);</pre>
|
||
<p>Asks to unstick <em class="parameter"><code>window</code></em>
|
||
, which means that it will appear on only
|
||
one of the user’s desktops. Note that you shouldn’t assume the
|
||
window is definitely unstuck afterward, because other entities
|
||
(e.g. the user or <a class="link" href="gtk-x11.html#gtk-X11-arch" title="Understanding the X11 architecture">window manager</a>) could
|
||
stick it again. But normally the window will
|
||
end up stuck. Just don’t write code that crashes if not.</p>
|
||
<p>You can track stickiness via the “window-state-event” signal
|
||
on <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-unstick.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-maximize"></a><h3>gtk_window_maximize ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_window_maximize (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>);</pre>
|
||
<p>Asks to maximize <em class="parameter"><code>window</code></em>
|
||
, so that it becomes full-screen. Note that
|
||
you shouldn’t assume the window is definitely maximized afterward,
|
||
because other entities (e.g. the user or
|
||
<a class="link" href="gtk-x11.html#gtk-X11-arch" title="Understanding the X11 architecture">window manager</a>) could unmaximize it
|
||
again, and not all window managers support maximization. But
|
||
normally the window will end up maximized. Just don’t write code
|
||
that crashes if not.</p>
|
||
<p>It’s permitted to call this function before showing a window,
|
||
in which case the window will be maximized when it appears onscreen
|
||
initially.</p>
|
||
<p>You can track maximization via the “window-state-event” signal
|
||
on <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>, or by listening to notifications on the
|
||
<a class="link" href="GtkWindow.html#GtkWindow--is-maximized" title="The “is-maximized” property"><span class="type">“is-maximized”</span></a> property.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-maximize.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-unmaximize"></a><h3>gtk_window_unmaximize ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_window_unmaximize (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>);</pre>
|
||
<p>Asks to unmaximize <em class="parameter"><code>window</code></em>
|
||
. Note that you shouldn’t assume the
|
||
window is definitely unmaximized afterward, because other entities
|
||
(e.g. the user or <a class="link" href="gtk-x11.html#gtk-X11-arch" title="Understanding the X11 architecture">window manager</a>)
|
||
could maximize it again, and not all window
|
||
managers honor requests to unmaximize. But normally the window will
|
||
end up unmaximized. Just don’t write code that crashes if not.</p>
|
||
<p>You can track maximization via the “window-state-event” signal
|
||
on <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-unmaximize.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-fullscreen"></a><h3>gtk_window_fullscreen ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_window_fullscreen (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>);</pre>
|
||
<p>Asks to place <em class="parameter"><code>window</code></em>
|
||
in the fullscreen state. Note that you
|
||
shouldn’t assume the window is definitely full screen afterward,
|
||
because other entities (e.g. the user or
|
||
<a class="link" href="gtk-x11.html#gtk-X11-arch" title="Understanding the X11 architecture">window manager</a>) could unfullscreen it
|
||
again, and not all window managers honor requests to fullscreen
|
||
windows. But normally the window will end up fullscreen. Just
|
||
don’t write code that crashes if not.</p>
|
||
<p>You can track the fullscreen state via the “window-state-event” signal
|
||
on <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-fullscreen.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: 2.2</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-fullscreen-on-monitor"></a><h3>gtk_window_fullscreen_on_monitor ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_window_fullscreen_on_monitor (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><span class="type">GdkScreen</span> *screen</code></em>,
|
||
<em class="parameter"><code><span class="type">gint</span> monitor</code></em>);</pre>
|
||
<p>Asks to place <em class="parameter"><code>window</code></em>
|
||
in the fullscreen state. Note that you shouldn't assume
|
||
the window is definitely full screen afterward.</p>
|
||
<p>You can track the fullscreen state via the "window-state-event" signal
|
||
on <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-fullscreen-on-monitor.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>screen</p></td>
|
||
<td class="parameter_description"><p>a <span class="type">GdkScreen</span> to draw to</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>monitor</p></td>
|
||
<td class="parameter_description"><p>which monitor to go fullscreen on</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: <a class="link" href="api-index-3-18.html#api-index-3.18">3.18</a></p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-unfullscreen"></a><h3>gtk_window_unfullscreen ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_window_unfullscreen (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>);</pre>
|
||
<p>Asks to toggle off the fullscreen state for <em class="parameter"><code>window</code></em>
|
||
. Note that you
|
||
shouldn’t assume the window is definitely not full screen
|
||
afterward, because other entities (e.g. the user or
|
||
<a class="link" href="gtk-x11.html#gtk-X11-arch" title="Understanding the X11 architecture">window manager</a>) could fullscreen it
|
||
again, and not all window managers honor requests to unfullscreen
|
||
windows. But normally the window will end up restored to its normal
|
||
state. Just don’t write code that crashes if not.</p>
|
||
<p>You can track the fullscreen state via the “window-state-event” signal
|
||
on <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-unfullscreen.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: 2.2</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-set-keep-above"></a><h3>gtk_window_set_keep_above ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_window_set_keep_above (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><span class="type">gboolean</span> setting</code></em>);</pre>
|
||
<p>Asks to keep <em class="parameter"><code>window</code></em>
|
||
above, so that it stays on top. Note that
|
||
you shouldn’t assume the window is definitely above afterward,
|
||
because other entities (e.g. the user or
|
||
<a class="link" href="gtk-x11.html#gtk-X11-arch" title="Understanding the X11 architecture">window manager</a>) could not keep it above,
|
||
and not all window managers support keeping windows above. But
|
||
normally the window will end kept above. Just don’t write code
|
||
that crashes if not.</p>
|
||
<p>It’s permitted to call this function before showing a window,
|
||
in which case the window will be kept above when it appears onscreen
|
||
initially.</p>
|
||
<p>You can track the above state via the “window-state-event” signal
|
||
on <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>.</p>
|
||
<p>Note that, according to the
|
||
<a class="ulink" href="http://www.freedesktop.org/Standards/wm-spec" target="_top">Extended Window Manager Hints Specification</a>,
|
||
the above state is mainly meant for user preferences and should not
|
||
be used by applications e.g. for drawing attention to their
|
||
dialogs.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-set-keep-above.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>setting</p></td>
|
||
<td class="parameter_description"><p>whether to keep <em class="parameter"><code>window</code></em>
|
||
above other windows</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: 2.4</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-set-keep-below"></a><h3>gtk_window_set_keep_below ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_window_set_keep_below (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><span class="type">gboolean</span> setting</code></em>);</pre>
|
||
<p>Asks to keep <em class="parameter"><code>window</code></em>
|
||
below, so that it stays in bottom. Note that
|
||
you shouldn’t assume the window is definitely below afterward,
|
||
because other entities (e.g. the user or
|
||
<a class="link" href="gtk-x11.html#gtk-X11-arch" title="Understanding the X11 architecture">window manager</a>) could not keep it below,
|
||
and not all window managers support putting windows below. But
|
||
normally the window will be kept below. Just don’t write code
|
||
that crashes if not.</p>
|
||
<p>It’s permitted to call this function before showing a window,
|
||
in which case the window will be kept below when it appears onscreen
|
||
initially.</p>
|
||
<p>You can track the below state via the “window-state-event” signal
|
||
on <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>.</p>
|
||
<p>Note that, according to the
|
||
<a class="ulink" href="http://www.freedesktop.org/Standards/wm-spec" target="_top">Extended Window Manager Hints Specification</a>,
|
||
the above state is mainly meant for user preferences and should not
|
||
be used by applications e.g. for drawing attention to their
|
||
dialogs.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-set-keep-below.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>setting</p></td>
|
||
<td class="parameter_description"><p>whether to keep <em class="parameter"><code>window</code></em>
|
||
below other windows</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: 2.4</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-begin-resize-drag"></a><h3>gtk_window_begin_resize_drag ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_window_begin_resize_drag (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><span class="type">GdkWindowEdge</span> edge</code></em>,
|
||
<em class="parameter"><code><span class="type">gint</span> button</code></em>,
|
||
<em class="parameter"><code><span class="type">gint</span> root_x</code></em>,
|
||
<em class="parameter"><code><span class="type">gint</span> root_y</code></em>,
|
||
<em class="parameter"><code><span class="type">guint32</span> timestamp</code></em>);</pre>
|
||
<p>Starts resizing a window. This function is used if an application
|
||
has window resizing controls. When GDK can support it, the resize
|
||
will be done using the standard mechanism for the
|
||
<a class="link" href="gtk-x11.html#gtk-X11-arch" title="Understanding the X11 architecture">window manager</a> or windowing
|
||
system. Otherwise, GDK will try to emulate window resizing,
|
||
potentially not all that well, depending on the windowing system.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-begin-resize-drag.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>button</p></td>
|
||
<td class="parameter_description"><p>mouse button that initiated the drag</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>edge</p></td>
|
||
<td class="parameter_description"><p>position of the resize control</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>root_x</p></td>
|
||
<td class="parameter_description"><p>X position where the user clicked to initiate the drag, in root window coordinates</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>root_y</p></td>
|
||
<td class="parameter_description"><p>Y position where the user clicked to initiate the drag</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>timestamp</p></td>
|
||
<td class="parameter_description"><p>timestamp from the click event that initiated the drag</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-begin-move-drag"></a><h3>gtk_window_begin_move_drag ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_window_begin_move_drag (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><span class="type">gint</span> button</code></em>,
|
||
<em class="parameter"><code><span class="type">gint</span> root_x</code></em>,
|
||
<em class="parameter"><code><span class="type">gint</span> root_y</code></em>,
|
||
<em class="parameter"><code><span class="type">guint32</span> timestamp</code></em>);</pre>
|
||
<p>Starts moving a window. This function is used if an application has
|
||
window movement grips. When GDK can support it, the window movement
|
||
will be done using the standard mechanism for the
|
||
<a class="link" href="gtk-x11.html#gtk-X11-arch" title="Understanding the X11 architecture">window manager</a> or windowing
|
||
system. Otherwise, GDK will try to emulate window movement,
|
||
potentially not all that well, depending on the windowing system.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-begin-move-drag.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>button</p></td>
|
||
<td class="parameter_description"><p>mouse button that initiated the drag</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>root_x</p></td>
|
||
<td class="parameter_description"><p>X position where the user clicked to initiate the drag, in root window coordinates</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>root_y</p></td>
|
||
<td class="parameter_description"><p>Y position where the user clicked to initiate the drag</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>timestamp</p></td>
|
||
<td class="parameter_description"><p>timestamp from the click event that initiated the drag</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-set-decorated"></a><h3>gtk_window_set_decorated ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_window_set_decorated (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><span class="type">gboolean</span> setting</code></em>);</pre>
|
||
<p>By default, windows are decorated with a title bar, resize
|
||
controls, etc. Some <a class="link" href="gtk-x11.html#gtk-X11-arch" title="Understanding the X11 architecture">window managers</a>
|
||
allow GTK+ to disable these decorations, creating a
|
||
borderless window. If you set the decorated property to <code class="literal">FALSE</code>
|
||
using this function, GTK+ will do its best to convince the window
|
||
manager not to decorate the window. Depending on the system, this
|
||
function may not have any effect when called on a window that is
|
||
already visible, so you should call it before calling <a class="link" href="GtkWidget.html#gtk-widget-show" title="gtk_widget_show ()"><code class="function">gtk_widget_show()</code></a>.</p>
|
||
<p>On Windows, this function always works, since there’s no window manager
|
||
policy involved.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-set-decorated.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>setting</p></td>
|
||
<td class="parameter_description"><p><code class="literal">TRUE</code> to decorate the window</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-set-deletable"></a><h3>gtk_window_set_deletable ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_window_set_deletable (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><span class="type">gboolean</span> setting</code></em>);</pre>
|
||
<p>By default, windows have a close button in the window frame. Some
|
||
<a class="link" href="gtk-x11.html#gtk-X11-arch" title="Understanding the X11 architecture">window managers</a> allow GTK+ to
|
||
disable this button. If you set the deletable property to <code class="literal">FALSE</code>
|
||
using this function, GTK+ will do its best to convince the window
|
||
manager not to show a close button. Depending on the system, this
|
||
function may not have any effect when called on a window that is
|
||
already visible, so you should call it before calling <a class="link" href="GtkWidget.html#gtk-widget-show" title="gtk_widget_show ()"><code class="function">gtk_widget_show()</code></a>.</p>
|
||
<p>On Windows, this function always works, since there’s no window manager
|
||
policy involved.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-set-deletable.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>setting</p></td>
|
||
<td class="parameter_description"><p><code class="literal">TRUE</code> to decorate the window as deletable</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: 2.10</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-set-mnemonic-modifier"></a><h3>gtk_window_set_mnemonic_modifier ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_window_set_mnemonic_modifier (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><span class="type">GdkModifierType</span> modifier</code></em>);</pre>
|
||
<p>Sets the mnemonic modifier for this window.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-set-mnemonic-modifier.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>modifier</p></td>
|
||
<td class="parameter_description"><p>the modifier mask used to activate
|
||
mnemonics on this window.</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-set-type-hint"></a><h3>gtk_window_set_type_hint ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_window_set_type_hint (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><span class="type">GdkWindowTypeHint</span> hint</code></em>);</pre>
|
||
<p>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.</p>
|
||
<p>This function should be called before the window becomes visible.</p>
|
||
<p>gtk_dialog_new_with_buttons() and other convenience functions in GTK+
|
||
will sometimes call <a class="link" href="GtkWindow.html#gtk-window-set-type-hint" title="gtk_window_set_type_hint ()"><code class="function">gtk_window_set_type_hint()</code></a> on your behalf.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-set-type-hint.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>hint</p></td>
|
||
<td class="parameter_description"><p>the window type</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-set-skip-taskbar-hint"></a><h3>gtk_window_set_skip_taskbar_hint ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_window_set_skip_taskbar_hint (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><span class="type">gboolean</span> setting</code></em>);</pre>
|
||
<p>Windows may set a hint asking the desktop environment not to display
|
||
the window in the task bar. This function sets this hint.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-set-skip-taskbar-hint.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> </p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>setting</p></td>
|
||
<td class="parameter_description"><p><code class="literal">TRUE</code> to keep this window from appearing in the task bar</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: 2.2</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-set-skip-pager-hint"></a><h3>gtk_window_set_skip_pager_hint ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_window_set_skip_pager_hint (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><span class="type">gboolean</span> setting</code></em>);</pre>
|
||
<p>Windows may set a hint asking the desktop environment not to display
|
||
the window in the pager. This function sets this hint.
|
||
(A "pager" is any desktop navigation tool such as a workspace
|
||
switcher that displays a thumbnail representation of the windows
|
||
on the screen.)</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-set-skip-pager-hint.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> </p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>setting</p></td>
|
||
<td class="parameter_description"><p><code class="literal">TRUE</code> to keep this window from appearing in the pager</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: 2.2</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-set-urgency-hint"></a><h3>gtk_window_set_urgency_hint ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_window_set_urgency_hint (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><span class="type">gboolean</span> setting</code></em>);</pre>
|
||
<p>Windows may set a hint asking the desktop environment to draw
|
||
the users attention to the window. This function sets this hint.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-set-urgency-hint.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> </p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>setting</p></td>
|
||
<td class="parameter_description"><p><code class="literal">TRUE</code> to mark this window as urgent</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: 2.8</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-set-accept-focus"></a><h3>gtk_window_set_accept_focus ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_window_set_accept_focus (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><span class="type">gboolean</span> setting</code></em>);</pre>
|
||
<p>Windows may set a hint asking the desktop environment not to receive
|
||
the input focus. This function sets this hint.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-set-accept-focus.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> </p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>setting</p></td>
|
||
<td class="parameter_description"><p><code class="literal">TRUE</code> to let this window receive input focus</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: 2.4</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-set-focus-on-map"></a><h3>gtk_window_set_focus_on_map ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_window_set_focus_on_map (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><span class="type">gboolean</span> setting</code></em>);</pre>
|
||
<p>Windows may set a hint asking the desktop environment not to receive
|
||
the input focus when the window is mapped. This function sets this
|
||
hint.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-set-focus-on-map.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> </p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>setting</p></td>
|
||
<td class="parameter_description"><p><code class="literal">TRUE</code> to let this window receive input focus on map</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: 2.6</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-set-startup-id"></a><h3>gtk_window_set_startup_id ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_window_set_startup_id (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code>const <span class="type">gchar</span> *startup_id</code></em>);</pre>
|
||
<p>Startup notification identifiers are used by desktop environment to
|
||
track application startup, to provide user feedback and other
|
||
features. This function changes the corresponding property on the
|
||
underlying GdkWindow. Normally, startup identifier is managed
|
||
automatically and you should only use this function in special cases
|
||
like transferring focus from other processes. You should use this
|
||
function before calling <a class="link" href="GtkWindow.html#gtk-window-present" title="gtk_window_present ()"><code class="function">gtk_window_present()</code></a> or any equivalent
|
||
function generating a window map event.</p>
|
||
<p>This function is only useful on X11, not with other GTK+ targets.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-set-startup-id.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>startup_id</p></td>
|
||
<td class="parameter_description"><p>a string with startup-notification identifier</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: 2.12</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-set-role"></a><h3>gtk_window_set_role ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_window_set_role (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code>const <span class="type">gchar</span> *role</code></em>);</pre>
|
||
<p>This function is only useful on X11, not with other GTK+ targets.</p>
|
||
<p>In combination with the window title, the window role allows a
|
||
<a class="link" href="gtk-x11.html#gtk-X11-arch" title="Understanding the X11 architecture">window manager</a> to identify "the
|
||
same" window when an application is restarted. So for example you
|
||
might set the “toolbox” role on your app’s toolbox window, so that
|
||
when the user restarts their session, the window manager can put
|
||
the toolbox back in the same place.</p>
|
||
<p>If a window already has a unique title, you don’t need to set the
|
||
role, since the WM can use the title to identify the window when
|
||
restoring the session.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-set-role.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>role</p></td>
|
||
<td class="parameter_description"><p>unique identifier for the window to be used when restoring a session</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-get-decorated"></a><h3>gtk_window_get_decorated ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_window_get_decorated (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>);</pre>
|
||
<p>Returns whether the window has been set to have decorations
|
||
such as a title bar via <a class="link" href="GtkWindow.html#gtk-window-set-decorated" title="gtk_window_set_decorated ()"><code class="function">gtk_window_set_decorated()</code></a>.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-get-decorated.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-get-decorated.returns"></a><h4>Returns</h4>
|
||
<p> <code class="literal">TRUE</code> if the window has been set to have decorations</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-get-deletable"></a><h3>gtk_window_get_deletable ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_window_get_deletable (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>);</pre>
|
||
<p>Returns whether the window has been set to have a close button
|
||
via <a class="link" href="GtkWindow.html#gtk-window-set-deletable" title="gtk_window_set_deletable ()"><code class="function">gtk_window_set_deletable()</code></a>.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-get-deletable.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-get-deletable.returns"></a><h4>Returns</h4>
|
||
<p> <code class="literal">TRUE</code> if the window has been set to have a close button</p>
|
||
</div>
|
||
<p class="since">Since: 2.10</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-get-default-icon-list"></a><h3>gtk_window_get_default_icon_list ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">GList</span> *
|
||
gtk_window_get_default_icon_list (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
|
||
<p>Gets the value set by <a class="link" href="GtkWindow.html#gtk-window-set-default-icon-list" title="gtk_window_set_default_icon_list ()"><code class="function">gtk_window_set_default_icon_list()</code></a>.
|
||
The list is a copy and should be freed with <code class="function">g_list_free()</code>,
|
||
but the pixbufs in the list have not had their reference count
|
||
incremented.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-get-default-icon-list.returns"></a><h4>Returns</h4>
|
||
<p>copy of default icon list. </p>
|
||
<p><span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> GdkPixbuf][<acronym title="The caller owns the data container, but not the data inside it."><span class="acronym">transfer container</span></acronym>]</span></p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-get-default-icon-name"></a><h3>gtk_window_get_default_icon_name ()</h3>
|
||
<pre class="programlisting">const <span class="returnvalue">gchar</span> *
|
||
gtk_window_get_default_icon_name (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
|
||
<p>Returns the fallback icon name for windows that has been set
|
||
with <a class="link" href="GtkWindow.html#gtk-window-set-default-icon-name" title="gtk_window_set_default_icon_name ()"><code class="function">gtk_window_set_default_icon_name()</code></a>. The returned
|
||
string is owned by GTK+ and should not be modified. It
|
||
is only valid until the next call to
|
||
<a class="link" href="GtkWindow.html#gtk-window-set-default-icon-name" title="gtk_window_set_default_icon_name ()"><code class="function">gtk_window_set_default_icon_name()</code></a>.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-get-default-icon-name.returns"></a><h4>Returns</h4>
|
||
<p> the fallback icon name for windows</p>
|
||
</div>
|
||
<p class="since">Since: 2.16</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-get-default-size"></a><h3>gtk_window_get_default_size ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_window_get_default_size (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><span class="type">gint</span> *width</code></em>,
|
||
<em class="parameter"><code><span class="type">gint</span> *height</code></em>);</pre>
|
||
<p>Gets the default size of the window. A value of -1 for the width or
|
||
height indicates that a default size has not been explicitly set
|
||
for that dimension, so the “natural” size of the window will be
|
||
used.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-get-default-size.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>width</p></td>
|
||
<td class="parameter_description"><p>location to store the default width, or <code class="literal">NULL</code>. </p></td>
|
||
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>height</p></td>
|
||
<td class="parameter_description"><p>location to store the default height, or <code class="literal">NULL</code>. </p></td>
|
||
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-get-destroy-with-parent"></a><h3>gtk_window_get_destroy_with_parent ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_window_get_destroy_with_parent (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>);</pre>
|
||
<p>Returns whether the window will be destroyed with its transient parent. See
|
||
<a class="link" href="GtkWindow.html#gtk-window-set-destroy-with-parent" title="gtk_window_set_destroy_with_parent ()"><code class="function">gtk_window_set_destroy_with_parent()</code></a>.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-get-destroy-with-parent.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-get-destroy-with-parent.returns"></a><h4>Returns</h4>
|
||
<p> <code class="literal">TRUE</code> if the window will be destroyed with its transient parent.</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-get-hide-titlebar-when-maximized"></a><h3>gtk_window_get_hide_titlebar_when_maximized ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_window_get_hide_titlebar_when_maximized
|
||
(<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>);</pre>
|
||
<p>Returns whether the window has requested to have its titlebar hidden
|
||
when maximized. See <a class="link" href="GtkWindow.html#gtk-window-set-hide-titlebar-when-maximized" title="gtk_window_set_hide_titlebar_when_maximized ()"><code class="function">gtk_window_set_hide_titlebar_when_maximized()</code></a>.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-get-hide-titlebar-when-maximized.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-get-hide-titlebar-when-maximized.returns"></a><h4>Returns</h4>
|
||
<p> <code class="literal">TRUE</code> if the window has requested to have its titlebar
|
||
hidden when maximized</p>
|
||
</div>
|
||
<p class="since">Since: <a class="link" href="api-index-3-4.html#api-index-3.4">3.4</a></p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-get-icon"></a><h3>gtk_window_get_icon ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">GdkPixbuf</span> *
|
||
gtk_window_get_icon (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>);</pre>
|
||
<p>Gets the value set by <a class="link" href="GtkWindow.html#gtk-window-set-icon" title="gtk_window_set_icon ()"><code class="function">gtk_window_set_icon()</code></a> (or if you've
|
||
called <a class="link" href="GtkWindow.html#gtk-window-set-icon-list" title="gtk_window_set_icon_list ()"><code class="function">gtk_window_set_icon_list()</code></a>, gets the first icon in
|
||
the icon list).</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-get-icon.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-get-icon.returns"></a><h4>Returns</h4>
|
||
<p>icon for window or <code class="literal">NULL</code> if none. </p>
|
||
<p><span class="annotation">[<acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>][<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-get-icon-list"></a><h3>gtk_window_get_icon_list ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">GList</span> *
|
||
gtk_window_get_icon_list (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>);</pre>
|
||
<p>Retrieves the list of icons set by <a class="link" href="GtkWindow.html#gtk-window-set-icon-list" title="gtk_window_set_icon_list ()"><code class="function">gtk_window_set_icon_list()</code></a>.
|
||
The list is copied, but the reference count on each
|
||
member won’t be incremented.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-get-icon-list.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-get-icon-list.returns"></a><h4>Returns</h4>
|
||
<p>copy of window’s icon list. </p>
|
||
<p><span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> GdkPixbuf][<acronym title="The caller owns the data container, but not the data inside it."><span class="acronym">transfer container</span></acronym>]</span></p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-get-icon-name"></a><h3>gtk_window_get_icon_name ()</h3>
|
||
<pre class="programlisting">const <span class="returnvalue">gchar</span> *
|
||
gtk_window_get_icon_name (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>);</pre>
|
||
<p>Returns the name of the themed icon for the window,
|
||
see <a class="link" href="GtkWindow.html#gtk-window-set-icon-name" title="gtk_window_set_icon_name ()"><code class="function">gtk_window_set_icon_name()</code></a>.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-get-icon-name.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-get-icon-name.returns"></a><h4>Returns</h4>
|
||
<p>the icon name or <code class="literal">NULL</code> if the window has
|
||
no themed icon. </p>
|
||
<p><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></p>
|
||
</div>
|
||
<p class="since">Since: 2.6</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-get-mnemonic-modifier"></a><h3>gtk_window_get_mnemonic_modifier ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">GdkModifierType</span>
|
||
gtk_window_get_mnemonic_modifier (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>);</pre>
|
||
<p>Returns the mnemonic modifier for this window. See
|
||
<a class="link" href="GtkWindow.html#gtk-window-set-mnemonic-modifier" title="gtk_window_set_mnemonic_modifier ()"><code class="function">gtk_window_set_mnemonic_modifier()</code></a>.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-get-mnemonic-modifier.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-get-mnemonic-modifier.returns"></a><h4>Returns</h4>
|
||
<p> the modifier mask used to activate
|
||
mnemonics on this window.</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-get-modal"></a><h3>gtk_window_get_modal ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_window_get_modal (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>);</pre>
|
||
<p>Returns whether the window is modal. See <a class="link" href="GtkWindow.html#gtk-window-set-modal" title="gtk_window_set_modal ()"><code class="function">gtk_window_set_modal()</code></a>.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-get-modal.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-get-modal.returns"></a><h4>Returns</h4>
|
||
<p> <code class="literal">TRUE</code> if the window is set to be modal and
|
||
establishes a grab when shown</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-get-position"></a><h3>gtk_window_get_position ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_window_get_position (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><span class="type">gint</span> *root_x</code></em>,
|
||
<em class="parameter"><code><span class="type">gint</span> *root_y</code></em>);</pre>
|
||
<p>This function returns the position you need to pass to
|
||
<a class="link" href="GtkWindow.html#gtk-window-move" title="gtk_window_move ()"><code class="function">gtk_window_move()</code></a> to keep <em class="parameter"><code>window</code></em>
|
||
in its current position.
|
||
This means that the meaning of the returned value varies with
|
||
window gravity. See <a class="link" href="GtkWindow.html#gtk-window-move" title="gtk_window_move ()"><code class="function">gtk_window_move()</code></a> for more details.</p>
|
||
<p>The reliability of this function depends on the windowing system
|
||
currently in use. Some windowing systems, such as Wayland, do not
|
||
support a global coordinate system, and thus the position of the
|
||
window will always be (0, 0). Others, like X11, do not have a reliable
|
||
way to obtain the geometry of the decorations of a window if they are
|
||
provided by the window manager. Additionally, on X11, window manager
|
||
have been known to mismanage window gravity, which result in windows
|
||
moving even if you use the coordinates of the current position as
|
||
returned by this function.</p>
|
||
<p>If you haven’t changed the window gravity, its gravity will be
|
||
<span class="type">GDK_GRAVITY_NORTH_WEST</span>. This means that <a class="link" href="GtkWindow.html#gtk-window-get-position" title="gtk_window_get_position ()"><code class="function">gtk_window_get_position()</code></a>
|
||
gets the position of the top-left corner of the window manager
|
||
frame for the window. <a class="link" href="GtkWindow.html#gtk-window-move" title="gtk_window_move ()"><code class="function">gtk_window_move()</code></a> sets the position of this
|
||
same top-left corner.</p>
|
||
<p>If a window has gravity <span class="type">GDK_GRAVITY_STATIC</span> the window manager
|
||
frame is not relevant, and thus <a class="link" href="GtkWindow.html#gtk-window-get-position" title="gtk_window_get_position ()"><code class="function">gtk_window_get_position()</code></a> will
|
||
always produce accurate results. However you can’t use static
|
||
gravity to do things like place a window in a corner of the screen,
|
||
because static gravity ignores the window manager decorations.</p>
|
||
<p>Ideally, this function should return appropriate values if the
|
||
window has client side decorations, assuming that the windowing
|
||
system supports global coordinates.</p>
|
||
<p>In practice, saving the window position should not be left to
|
||
applications, as they lack enough knowledge of the windowing
|
||
system and the window manager state to effectively do so. The
|
||
appropriate way to implement saving the window position is to
|
||
use a platform-specific protocol, wherever that is available.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-get-position.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>root_x</p></td>
|
||
<td class="parameter_description"><p>return location for X coordinate of
|
||
gravity-determined reference point, or <code class="literal">NULL</code>. </p></td>
|
||
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>root_y</p></td>
|
||
<td class="parameter_description"><p>return location for Y coordinate of
|
||
gravity-determined reference point, or <code class="literal">NULL</code>. </p></td>
|
||
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-get-role"></a><h3>gtk_window_get_role ()</h3>
|
||
<pre class="programlisting">const <span class="returnvalue">gchar</span> *
|
||
gtk_window_get_role (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>);</pre>
|
||
<p>Returns the role of the window. See <a class="link" href="GtkWindow.html#gtk-window-set-role" title="gtk_window_set_role ()"><code class="function">gtk_window_set_role()</code></a> for
|
||
further explanation.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-get-role.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-get-role.returns"></a><h4>Returns</h4>
|
||
<p>the role of the window if set, or <code class="literal">NULL</code>. The
|
||
returned is owned by the widget and must not be modified or freed. </p>
|
||
<p><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-get-size"></a><h3>gtk_window_get_size ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_window_get_size (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><span class="type">gint</span> *width</code></em>,
|
||
<em class="parameter"><code><span class="type">gint</span> *height</code></em>);</pre>
|
||
<p>Obtains the current size of <em class="parameter"><code>window</code></em>
|
||
.</p>
|
||
<p>If <em class="parameter"><code>window</code></em>
|
||
is not visible on screen, this function return the size GTK+
|
||
will suggest to the <a class="link" href="gtk-x11.html#gtk-X11-arch" title="Understanding the X11 architecture">window manager</a> for the initial window
|
||
size (but this is not reliably the same as the size the window manager
|
||
will actually select). See: <a class="link" href="GtkWindow.html#gtk-window-set-default-size" title="gtk_window_set_default_size ()"><code class="function">gtk_window_set_default_size()</code></a>.</p>
|
||
<p>Depending on the windowing system and the window manager constraints,
|
||
the size returned by this function may not match the size set using
|
||
<a class="link" href="GtkWindow.html#gtk-window-resize" title="gtk_window_resize ()"><code class="function">gtk_window_resize()</code></a>; additionally, since <a class="link" href="GtkWindow.html#gtk-window-resize" title="gtk_window_resize ()"><code class="function">gtk_window_resize()</code></a> may be
|
||
implemented as an asynchronous operation, GTK+ cannot guarantee in any
|
||
way that this code:</p>
|
||
<div class="informalexample">
|
||
<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
|
||
<tbody>
|
||
<tr>
|
||
<td class="listing_lines" align="right"><pre>1
|
||
2
|
||
3
|
||
4
|
||
5</pre></td>
|
||
<td class="listing_code"><pre class="programlisting"><span class="c1">// width and height are set elsewhere</span>
|
||
<span class="n">gtk_window_resize</span> <span class="p">(</span><span class="n">window</span><span class="p">,</span> <span class="n">width</span><span class="p">,</span> <span class="n">height</span><span class="p">);</span>
|
||
|
||
<span class="kt">int</span> <span class="n">new_width</span><span class="p">,</span> <span class="n">new_height</span><span class="p">;</span>
|
||
<span class="n">gtk_window_get_size</span> <span class="p">(</span><span class="n">window</span><span class="p">,</span> <span class="o">&</span><span class="n">new_width</span><span class="p">,</span> <span class="o">&</span><span class="n">new_height</span><span class="p">);</span></pre></td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
</div>
|
||
|
||
<p></p>
|
||
<p>will result in <code class="literal">new_width</code> and <code class="literal">new_height</code> matching <code class="literal">width</code> and
|
||
<code class="literal">height</code>, respectively.</p>
|
||
<p>This function will return the logical size of the <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a>,
|
||
excluding the widgets used in client side decorations; there is,
|
||
however, no guarantee that the result will be completely accurate
|
||
because client side decoration may include widgets that depend on
|
||
the user preferences and that may not be visibile at the time you
|
||
call this function.</p>
|
||
<p>The dimensions returned by this function are suitable for being
|
||
stored across sessions; use <a class="link" href="GtkWindow.html#gtk-window-set-default-size" title="gtk_window_set_default_size ()"><code class="function">gtk_window_set_default_size()</code></a> to
|
||
restore them when before showing the window.</p>
|
||
<p>To avoid potential race conditions, you should only call this
|
||
function in response to a size change notification, for instance
|
||
inside a handler for the <a class="link" href="GtkWidget.html#GtkWidget-size-allocate" title="The “size-allocate” signal"><span class="type">“size-allocate”</span></a> signal, or
|
||
inside a handler for the <a class="link" href="GtkWidget.html#GtkWidget-configure-event" title="The “configure-event” signal"><span class="type">“configure-event”</span></a> signal:</p>
|
||
<div class="informalexample">
|
||
<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
|
||
<tbody>
|
||
<tr>
|
||
<td class="listing_lines" align="right"><pre>1
|
||
2
|
||
3
|
||
4
|
||
5
|
||
6
|
||
7
|
||
8
|
||
9</pre></td>
|
||
<td class="listing_code"><pre class="programlisting"><span class="k">static</span> <span class="kt">void</span>
|
||
<span class="n">on_size_allocate</span> <span class="p">(</span><span class="n">GtkWidget</span> <span class="o">*</span><span class="n">widget</span><span class="p">,</span> <span class="n">GtkAllocation</span> <span class="o">*</span><span class="n">allocation</span><span class="p">)</span>
|
||
<span class="p">{</span>
|
||
<span class="kt">int</span> <span class="n">new_width</span><span class="p">,</span> <span class="n">new_height</span><span class="p">;</span>
|
||
|
||
<span class="n">gtk_window_get_size</span> <span class="p">(</span><span class="n">GTK_WINDOW</span> <span class="p">(</span><span class="n">widget</span><span class="p">),</span> <span class="o">&</span><span class="n">new_width</span><span class="p">,</span> <span class="o">&</span><span class="n">new_height</span><span class="p">);</span>
|
||
|
||
<span class="p">...</span>
|
||
<span class="p">}</span></pre></td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
</div>
|
||
|
||
<p></p>
|
||
<p>Note that, if you connect to the <a class="link" href="GtkWidget.html#GtkWidget-size-allocate" title="The “size-allocate” signal"><span class="type">“size-allocate”</span></a> signal,
|
||
you should not use the dimensions of the <a class="link" href="GtkWidget.html#GtkAllocation" title="GtkAllocation"><span class="type">GtkAllocation</span></a> passed to
|
||
the signal handler, as the allocation may contain client side
|
||
decorations added by GTK+, depending on the windowing system in
|
||
use.</p>
|
||
<p>If you are getting a window size in order to position the window
|
||
on the screen, you should, instead, simply set the window’s semantic
|
||
type with <a class="link" href="GtkWindow.html#gtk-window-set-type-hint" title="gtk_window_set_type_hint ()"><code class="function">gtk_window_set_type_hint()</code></a>, which allows the window manager
|
||
to e.g. center dialogs. Also, if you set the transient parent of
|
||
dialogs with <a class="link" href="GtkWindow.html#gtk-window-set-transient-for" title="gtk_window_set_transient_for ()"><code class="function">gtk_window_set_transient_for()</code></a> window managers will
|
||
often center the dialog over its parent window. It's much preferred
|
||
to let the window manager handle these cases rather than doing it
|
||
yourself, because all apps will behave consistently and according to
|
||
user or system preferences, if the window manager handles it. Also,
|
||
the window manager can take into account the size of the window
|
||
decorations and border that it may add, and of which GTK+ has no
|
||
knowledge. Additionally, positioning windows in global screen coordinates
|
||
may not be allowed by the windowing system. For more information,
|
||
see: <a class="link" href="GtkWindow.html#gtk-window-set-position" title="gtk_window_set_position ()"><code class="function">gtk_window_set_position()</code></a>.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-get-size.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>width</p></td>
|
||
<td class="parameter_description"><p>return location for width, or <code class="literal">NULL</code>. </p></td>
|
||
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>height</p></td>
|
||
<td class="parameter_description"><p>return location for height, or <code class="literal">NULL</code>. </p></td>
|
||
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-get-title"></a><h3>gtk_window_get_title ()</h3>
|
||
<pre class="programlisting">const <span class="returnvalue">gchar</span> *
|
||
gtk_window_get_title (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>);</pre>
|
||
<p>Retrieves the title of the window. See <a class="link" href="GtkWindow.html#gtk-window-set-title" title="gtk_window_set_title ()"><code class="function">gtk_window_set_title()</code></a>.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-get-title.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-get-title.returns"></a><h4>Returns</h4>
|
||
<p>the title of the window, or <code class="literal">NULL</code> if none has
|
||
been set explicitly. The returned string is owned by the widget
|
||
and must not be modified or freed. </p>
|
||
<p><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-get-transient-for"></a><h3>gtk_window_get_transient_for ()</h3>
|
||
<pre class="programlisting"><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="returnvalue">GtkWindow</span></a> *
|
||
gtk_window_get_transient_for (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>);</pre>
|
||
<p>Fetches the transient parent for this window. See
|
||
<a class="link" href="GtkWindow.html#gtk-window-set-transient-for" title="gtk_window_set_transient_for ()"><code class="function">gtk_window_set_transient_for()</code></a>.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-get-transient-for.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-get-transient-for.returns"></a><h4>Returns</h4>
|
||
<p>the transient parent for this
|
||
window, or <code class="literal">NULL</code> if no transient parent has been set. </p>
|
||
<p><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>][<acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>]</span></p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-get-attached-to"></a><h3>gtk_window_get_attached_to ()</h3>
|
||
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
|
||
gtk_window_get_attached_to (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>);</pre>
|
||
<p>Fetches the attach widget for this window. See
|
||
<a class="link" href="GtkWindow.html#gtk-window-set-attached-to" title="gtk_window_set_attached_to ()"><code class="function">gtk_window_set_attached_to()</code></a>.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-get-attached-to.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-get-attached-to.returns"></a><h4>Returns</h4>
|
||
<p>the widget where the window
|
||
is attached, or <code class="literal">NULL</code> if the window is not attached to any widget. </p>
|
||
<p><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>][<acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>]</span></p>
|
||
</div>
|
||
<p class="since">Since: <a class="link" href="api-index-3-4.html#api-index-3.4">3.4</a></p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-get-type-hint"></a><h3>gtk_window_get_type_hint ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">GdkWindowTypeHint</span>
|
||
gtk_window_get_type_hint (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>);</pre>
|
||
<p>Gets the type hint for this window. See <a class="link" href="GtkWindow.html#gtk-window-set-type-hint" title="gtk_window_set_type_hint ()"><code class="function">gtk_window_set_type_hint()</code></a>.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-get-type-hint.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-get-type-hint.returns"></a><h4>Returns</h4>
|
||
<p> the type hint for <em class="parameter"><code>window</code></em>
|
||
.</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-get-skip-taskbar-hint"></a><h3>gtk_window_get_skip_taskbar_hint ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_window_get_skip_taskbar_hint (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>);</pre>
|
||
<p>Gets the value set by <a class="link" href="GtkWindow.html#gtk-window-set-skip-taskbar-hint" title="gtk_window_set_skip_taskbar_hint ()"><code class="function">gtk_window_set_skip_taskbar_hint()</code></a></p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-get-skip-taskbar-hint.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-get-skip-taskbar-hint.returns"></a><h4>Returns</h4>
|
||
<p> <code class="literal">TRUE</code> if window shouldn’t be in taskbar</p>
|
||
</div>
|
||
<p class="since">Since: 2.2</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-get-skip-pager-hint"></a><h3>gtk_window_get_skip_pager_hint ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_window_get_skip_pager_hint (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>);</pre>
|
||
<p>Gets the value set by <a class="link" href="GtkWindow.html#gtk-window-set-skip-pager-hint" title="gtk_window_set_skip_pager_hint ()"><code class="function">gtk_window_set_skip_pager_hint()</code></a>.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-get-skip-pager-hint.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-get-skip-pager-hint.returns"></a><h4>Returns</h4>
|
||
<p> <code class="literal">TRUE</code> if window shouldn’t be in pager</p>
|
||
</div>
|
||
<p class="since">Since: 2.2</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-get-urgency-hint"></a><h3>gtk_window_get_urgency_hint ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_window_get_urgency_hint (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>);</pre>
|
||
<p>Gets the value set by <a class="link" href="GtkWindow.html#gtk-window-set-urgency-hint" title="gtk_window_set_urgency_hint ()"><code class="function">gtk_window_set_urgency_hint()</code></a></p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-get-urgency-hint.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-get-urgency-hint.returns"></a><h4>Returns</h4>
|
||
<p> <code class="literal">TRUE</code> if window is urgent</p>
|
||
</div>
|
||
<p class="since">Since: 2.8</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-get-accept-focus"></a><h3>gtk_window_get_accept_focus ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_window_get_accept_focus (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>);</pre>
|
||
<p>Gets the value set by <a class="link" href="GtkWindow.html#gtk-window-set-accept-focus" title="gtk_window_set_accept_focus ()"><code class="function">gtk_window_set_accept_focus()</code></a>.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-get-accept-focus.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-get-accept-focus.returns"></a><h4>Returns</h4>
|
||
<p> <code class="literal">TRUE</code> if window should receive the input focus</p>
|
||
</div>
|
||
<p class="since">Since: 2.4</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-get-focus-on-map"></a><h3>gtk_window_get_focus_on_map ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_window_get_focus_on_map (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>);</pre>
|
||
<p>Gets the value set by <a class="link" href="GtkWindow.html#gtk-window-set-focus-on-map" title="gtk_window_set_focus_on_map ()"><code class="function">gtk_window_set_focus_on_map()</code></a>.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-get-focus-on-map.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-get-focus-on-map.returns"></a><h4>Returns</h4>
|
||
<p> <code class="literal">TRUE</code> if window should receive the input focus when
|
||
mapped.</p>
|
||
</div>
|
||
<p class="since">Since: 2.6</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-get-group"></a><h3>gtk_window_get_group ()</h3>
|
||
<pre class="programlisting"><a class="link" href="GtkWindowGroup.html" title="GtkWindowGroup"><span class="returnvalue">GtkWindowGroup</span></a> *
|
||
gtk_window_get_group (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>);</pre>
|
||
<p>Returns the group for <em class="parameter"><code>window</code></em>
|
||
or the default group, if
|
||
<em class="parameter"><code>window</code></em>
|
||
is <code class="literal">NULL</code> or if <em class="parameter"><code>window</code></em>
|
||
does not have an explicit
|
||
window group.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-get-group.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a>, or <code class="literal">NULL</code>. </p></td>
|
||
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-get-group.returns"></a><h4>Returns</h4>
|
||
<p>the <a class="link" href="GtkWindowGroup.html" title="GtkWindowGroup"><span class="type">GtkWindowGroup</span></a> for a window or the default group. </p>
|
||
<p><span class="annotation">[<acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>]</span></p>
|
||
</div>
|
||
<p class="since">Since: 2.10</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-has-group"></a><h3>gtk_window_has_group ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_window_has_group (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>);</pre>
|
||
<p>Returns whether <em class="parameter"><code>window</code></em>
|
||
has an explicit window group.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-has-group.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-has-group.returns"></a><h4>Returns</h4>
|
||
<p> <code class="literal">TRUE</code> if <em class="parameter"><code>window</code></em>
|
||
has an explicit window group.</p>
|
||
<p>Since 2.22</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-get-window-type"></a><h3>gtk_window_get_window_type ()</h3>
|
||
<pre class="programlisting"><a class="link" href="GtkWindow.html#GtkWindowType" title="enum GtkWindowType"><span class="returnvalue">GtkWindowType</span></a>
|
||
gtk_window_get_window_type (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>);</pre>
|
||
<p>Gets the type of the window. See <a class="link" href="GtkWindow.html#GtkWindowType" title="enum GtkWindowType"><span class="type">GtkWindowType</span></a>.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-get-window-type.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-get-window-type.returns"></a><h4>Returns</h4>
|
||
<p> the type of the window</p>
|
||
</div>
|
||
<p class="since">Since: 2.20</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-move"></a><h3>gtk_window_move ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_window_move (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><span class="type">gint</span> x</code></em>,
|
||
<em class="parameter"><code><span class="type">gint</span> y</code></em>);</pre>
|
||
<p>Asks the <a class="link" href="gtk-x11.html#gtk-X11-arch" title="Understanding the X11 architecture">window manager</a> to move
|
||
<em class="parameter"><code>window</code></em>
|
||
to the given position. Window managers are free to ignore
|
||
this; most window managers ignore requests for initial window
|
||
positions (instead using a user-defined placement algorithm) and
|
||
honor requests after the window has already been shown.</p>
|
||
<p>Note: the position is the position of the gravity-determined
|
||
reference point for the window. The gravity determines two things:
|
||
first, the location of the reference point in root window
|
||
coordinates; and second, which point on the window is positioned at
|
||
the reference point.</p>
|
||
<p>By default the gravity is <span class="type">GDK_GRAVITY_NORTH_WEST</span>, so the reference
|
||
point is simply the <em class="parameter"><code>x</code></em>
|
||
, <em class="parameter"><code>y</code></em>
|
||
supplied to <a class="link" href="GtkWindow.html#gtk-window-move" title="gtk_window_move ()"><code class="function">gtk_window_move()</code></a>. The
|
||
top-left corner of the window decorations (aka window frame or
|
||
border) will be placed at <em class="parameter"><code>x</code></em>
|
||
, <em class="parameter"><code>y</code></em>
|
||
. Therefore, to position a window
|
||
at the top left of the screen, you want to use the default gravity
|
||
(which is <span class="type">GDK_GRAVITY_NORTH_WEST</span>) and move the window to 0,0.</p>
|
||
<p>To position a window at the bottom right corner of the screen, you
|
||
would set <span class="type">GDK_GRAVITY_SOUTH_EAST</span>, which means that the reference
|
||
point is at <em class="parameter"><code>x</code></em>
|
||
+ the window width and <em class="parameter"><code>y</code></em>
|
||
+ the window height, and
|
||
the bottom-right corner of the window border will be placed at that
|
||
reference point. So, to place a window in the bottom right corner
|
||
you would first set gravity to south east, then write:
|
||
<code class="literal">gtk_window_move (window, <code class="function">gdk_screen_width()</code> - window_width,
|
||
<code class="function">gdk_screen_height()</code> - window_height)</code> (note that this
|
||
example does not take multi-head scenarios into account).</p>
|
||
<p>The <a class="ulink" href="http://www.freedesktop.org/Standards/wm-spec" target="_top">Extended Window Manager Hints Specification</a>
|
||
has a nice table of gravities in the “implementation notes” section.</p>
|
||
<p>The <a class="link" href="GtkWindow.html#gtk-window-get-position" title="gtk_window_get_position ()"><code class="function">gtk_window_get_position()</code></a> documentation may also be relevant.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-move.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>x</p></td>
|
||
<td class="parameter_description"><p>X coordinate to move window to</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>y</p></td>
|
||
<td class="parameter_description"><p>Y coordinate to move window to</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-parse-geometry"></a><h3>gtk_window_parse_geometry ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_window_parse_geometry (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code>const <span class="type">gchar</span> *geometry</code></em>);</pre>
|
||
<div class="warning">
|
||
<p><code class="literal">gtk_window_parse_geometry</code> has been deprecated since version 3.20 and should not be used in newly-written code.</p>
|
||
<p>Geometry handling in GTK is deprecated.</p>
|
||
</div>
|
||
<p>Parses a standard X Window System geometry string - see the
|
||
manual page for X (type “man X”) for details on this.
|
||
<a class="link" href="GtkWindow.html#gtk-window-parse-geometry" title="gtk_window_parse_geometry ()"><code class="function">gtk_window_parse_geometry()</code></a> does work on all GTK+ ports
|
||
including Win32 but is primarily intended for an X environment.</p>
|
||
<p>If either a size or a position can be extracted from the
|
||
geometry string, <a class="link" href="GtkWindow.html#gtk-window-parse-geometry" title="gtk_window_parse_geometry ()"><code class="function">gtk_window_parse_geometry()</code></a> returns <code class="literal">TRUE</code>
|
||
and calls <a class="link" href="GtkWindow.html#gtk-window-set-default-size" title="gtk_window_set_default_size ()"><code class="function">gtk_window_set_default_size()</code></a> and/or <a class="link" href="GtkWindow.html#gtk-window-move" title="gtk_window_move ()"><code class="function">gtk_window_move()</code></a>
|
||
to resize/move the window.</p>
|
||
<p>If <a class="link" href="GtkWindow.html#gtk-window-parse-geometry" title="gtk_window_parse_geometry ()"><code class="function">gtk_window_parse_geometry()</code></a> returns <code class="literal">TRUE</code>, it will also
|
||
set the <span class="type">GDK_HINT_USER_POS</span> and/or <span class="type">GDK_HINT_USER_SIZE</span> hints
|
||
indicating to the window manager that the size/position of
|
||
the window was user-specified. This causes most window
|
||
managers to honor the geometry.</p>
|
||
<p>Note that for <a class="link" href="GtkWindow.html#gtk-window-parse-geometry" title="gtk_window_parse_geometry ()"><code class="function">gtk_window_parse_geometry()</code></a> to work as expected, it has
|
||
to be called when the window has its “final” size, i.e. after calling
|
||
<a class="link" href="GtkWidget.html#gtk-widget-show-all" title="gtk_widget_show_all ()"><code class="function">gtk_widget_show_all()</code></a> on the contents and <a class="link" href="GtkWindow.html#gtk-window-set-geometry-hints" title="gtk_window_set_geometry_hints ()"><code class="function">gtk_window_set_geometry_hints()</code></a>
|
||
on the window.</p>
|
||
<div class="informalexample">
|
||
<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
|
||
<tbody>
|
||
<tr>
|
||
<td class="listing_lines" align="right"><pre>1
|
||
2
|
||
3
|
||
4
|
||
5
|
||
6
|
||
7
|
||
8
|
||
9
|
||
10
|
||
11
|
||
12
|
||
13
|
||
14
|
||
15
|
||
16
|
||
17
|
||
18
|
||
19
|
||
20
|
||
21
|
||
22
|
||
23
|
||
24
|
||
25
|
||
26
|
||
27
|
||
28
|
||
29
|
||
30
|
||
31
|
||
32
|
||
33
|
||
34
|
||
35
|
||
36
|
||
37
|
||
38
|
||
39
|
||
40
|
||
41
|
||
42
|
||
43
|
||
44
|
||
45
|
||
46
|
||
47
|
||
48
|
||
49</pre></td>
|
||
<td class="listing_code"><pre class="programlisting"><span class="cp">#include</span> <span class="cpf"><gtk/gtk.h></span><span class="cp"></span>
|
||
|
||
<span class="k">static</span> <span class="kt">void</span>
|
||
<span class="n">fill_with_content</span> <span class="p">(</span><span class="n">GtkWidget</span> <span class="o">*</span><span class="n">vbox</span><span class="p">)</span>
|
||
<span class="p">{</span>
|
||
<span class="c1">// fill with content...</span>
|
||
<span class="p">}</span>
|
||
|
||
<span class="kt">int</span>
|
||
<span class="n">main</span> <span class="p">(</span><span class="kt">int</span> <span class="n">argc</span><span class="p">,</span> <span class="kt">char</span> <span class="o">*</span><span class="n">argv</span><span class="p">[])</span>
|
||
<span class="p">{</span>
|
||
<span class="n">GtkWidget</span> <span class="o">*</span><span class="n">window</span><span class="p">,</span> <span class="o">*</span><span class="n">vbox</span><span class="p">;</span>
|
||
<span class="n">GdkGeometry</span> <span class="n">size_hints</span> <span class="o">=</span> <span class="p">{</span>
|
||
<span class="mi">100</span><span class="p">,</span> <span class="mi">50</span><span class="p">,</span> <span class="mi">0</span><span class="p">,</span> <span class="mi">0</span><span class="p">,</span> <span class="mi">100</span><span class="p">,</span> <span class="mi">50</span><span class="p">,</span> <span class="mi">10</span><span class="p">,</span>
|
||
<span class="mi">10</span><span class="p">,</span> <span class="mf">0.0</span><span class="p">,</span> <span class="mf">0.0</span><span class="p">,</span> <span class="n">GDK_GRAVITY_NORTH_WEST</span>
|
||
<span class="p">};</span>
|
||
|
||
<span class="n">gtk_init</span> <span class="p">(</span><span class="o">&</span><span class="n">argc</span><span class="p">,</span> <span class="o">&</span><span class="n">argv</span><span class="p">);</span>
|
||
|
||
<span class="n">window</span> <span class="o">=</span> <span class="n">gtk_window_new</span> <span class="p">(</span><span class="n">GTK_WINDOW_TOPLEVEL</span><span class="p">);</span>
|
||
<span class="n">vbox</span> <span class="o">=</span> <span class="n">gtk_box_new</span> <span class="p">(</span><span class="n">GTK_ORIENTATION_VERTICAL</span><span class="p">,</span> <span class="mi">0</span><span class="p">);</span>
|
||
|
||
<span class="n">gtk_container_add</span> <span class="p">(</span><span class="n">GTK_CONTAINER</span> <span class="p">(</span><span class="n">window</span><span class="p">),</span> <span class="n">vbox</span><span class="p">);</span>
|
||
<span class="n">fill_with_content</span> <span class="p">(</span><span class="n">vbox</span><span class="p">);</span>
|
||
<span class="n">gtk_widget_show_all</span> <span class="p">(</span><span class="n">vbox</span><span class="p">);</span>
|
||
|
||
<span class="n">gtk_window_set_geometry_hints</span> <span class="p">(</span><span class="n">GTK_WINDOW</span> <span class="p">(</span><span class="n">window</span><span class="p">),</span>
|
||
<span class="nb">NULL</span><span class="p">,</span>
|
||
<span class="o">&</span><span class="n">size_hints</span><span class="p">,</span>
|
||
<span class="n">GDK_HINT_MIN_SIZE</span> <span class="o">|</span>
|
||
<span class="n">GDK_HINT_BASE_SIZE</span> <span class="o">|</span>
|
||
<span class="n">GDK_HINT_RESIZE_INC</span><span class="p">);</span>
|
||
|
||
<span class="k">if</span> <span class="p">(</span><span class="n">argc</span> <span class="o">></span> <span class="mi">1</span><span class="p">)</span>
|
||
<span class="p">{</span>
|
||
<span class="n">gboolean</span> <span class="n">res</span><span class="p">;</span>
|
||
<span class="n">res</span> <span class="o">=</span> <span class="n">gtk_window_parse_geometry</span> <span class="p">(</span><span class="n">GTK_WINDOW</span> <span class="p">(</span><span class="n">window</span><span class="p">),</span>
|
||
<span class="n">argv</span><span class="p">[</span><span class="mi">1</span><span class="p">]);</span>
|
||
<span class="k">if</span> <span class="p">(</span><span class="o">!</span> <span class="n">res</span><span class="p">)</span>
|
||
<span class="n">fprintf</span> <span class="p">(</span><span class="n">stderr</span><span class="p">,</span>
|
||
<span class="s">"Failed to parse “%s”</span><span class="se">\n</span><span class="s">"</span><span class="p">,</span>
|
||
<span class="n">argv</span><span class="p">[</span><span class="mi">1</span><span class="p">]);</span>
|
||
<span class="p">}</span>
|
||
|
||
<span class="n">gtk_widget_show_all</span> <span class="p">(</span><span class="n">window</span><span class="p">);</span>
|
||
<span class="n">gtk_main</span> <span class="p">();</span>
|
||
|
||
<span class="k">return</span> <span class="mi">0</span><span class="p">;</span>
|
||
<span class="p">}</span></pre></td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
</div>
|
||
|
||
<p></p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-parse-geometry.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>geometry</p></td>
|
||
<td class="parameter_description"><p>geometry string</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-parse-geometry.returns"></a><h4>Returns</h4>
|
||
<p> <code class="literal">TRUE</code> if string was parsed successfully</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-reshow-with-initial-size"></a><h3>gtk_window_reshow_with_initial_size ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_window_reshow_with_initial_size (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>);</pre>
|
||
<div class="warning">
|
||
<p><code class="literal">gtk_window_reshow_with_initial_size</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
|
||
<p>GUI builders can call <a class="link" href="GtkWidget.html#gtk-widget-hide" title="gtk_widget_hide ()"><code class="function">gtk_widget_hide()</code></a>,
|
||
<a class="link" href="GtkWidget.html#gtk-widget-unrealize" title="gtk_widget_unrealize ()"><code class="function">gtk_widget_unrealize()</code></a> and then <a class="link" href="GtkWidget.html#gtk-widget-show" title="gtk_widget_show ()"><code class="function">gtk_widget_show()</code></a> on <em class="parameter"><code>window</code></em>
|
||
|
||
themselves, if they still need this functionality.</p>
|
||
</div>
|
||
<p>Hides <em class="parameter"><code>window</code></em>
|
||
, then reshows it, resetting the
|
||
default size and position of the window. Used
|
||
by GUI builders only.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-reshow-with-initial-size.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-resize"></a><h3>gtk_window_resize ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_window_resize (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><span class="type">gint</span> width</code></em>,
|
||
<em class="parameter"><code><span class="type">gint</span> height</code></em>);</pre>
|
||
<p>Resizes the window as if the user had done so, obeying geometry
|
||
constraints. The default geometry constraint is that windows may
|
||
not be smaller than their size request; to override this
|
||
constraint, call <a class="link" href="GtkWidget.html#gtk-widget-set-size-request" title="gtk_widget_set_size_request ()"><code class="function">gtk_widget_set_size_request()</code></a> to set the window's
|
||
request to a smaller value.</p>
|
||
<p>If <a class="link" href="GtkWindow.html#gtk-window-resize" title="gtk_window_resize ()"><code class="function">gtk_window_resize()</code></a> is called before showing a window for the
|
||
first time, it overrides any default size set with
|
||
<a class="link" href="GtkWindow.html#gtk-window-set-default-size" title="gtk_window_set_default_size ()"><code class="function">gtk_window_set_default_size()</code></a>.</p>
|
||
<p>Windows may not be resized smaller than 1 by 1 pixels.</p>
|
||
<p>When using client side decorations, GTK+ will do its best to adjust
|
||
the given size so that the resulting window size matches the
|
||
requested size without the title bar, borders and shadows added for
|
||
the client side decorations, but there is no guarantee that the
|
||
result will be totally accurate because these widgets added for
|
||
client side decorations depend on the theme and may not be realized
|
||
or visible at the time <a class="link" href="GtkWindow.html#gtk-window-resize" title="gtk_window_resize ()"><code class="function">gtk_window_resize()</code></a> is issued.</p>
|
||
<p>If the GtkWindow has a titlebar widget (see <a class="link" href="GtkWindow.html#gtk-window-set-titlebar" title="gtk_window_set_titlebar ()"><code class="function">gtk_window_set_titlebar()</code></a>), then
|
||
typically, <a class="link" href="GtkWindow.html#gtk-window-resize" title="gtk_window_resize ()"><code class="function">gtk_window_resize()</code></a> will compensate for the height of the titlebar
|
||
widget only if the height is known when the resulting GtkWindow configuration
|
||
is issued.
|
||
For example, if new widgets are added after the GtkWindow configuration
|
||
and cause the titlebar widget to grow in height, this will result in a
|
||
window content smaller that specified by <a class="link" href="GtkWindow.html#gtk-window-resize" title="gtk_window_resize ()"><code class="function">gtk_window_resize()</code></a> and not
|
||
a larger window.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-resize.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>width</p></td>
|
||
<td class="parameter_description"><p>width in pixels to resize the window to</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>height</p></td>
|
||
<td class="parameter_description"><p>height in pixels to resize the window to</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-resize-to-geometry"></a><h3>gtk_window_resize_to_geometry ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_window_resize_to_geometry (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><span class="type">gint</span> width</code></em>,
|
||
<em class="parameter"><code><span class="type">gint</span> height</code></em>);</pre>
|
||
<div class="warning">
|
||
<p><code class="literal">gtk_window_resize_to_geometry</code> has been deprecated since version 3.20 and should not be used in newly-written code.</p>
|
||
<p>This function does nothing. Use
|
||
<a class="link" href="GtkWindow.html#gtk-window-resize" title="gtk_window_resize ()"><code class="function">gtk_window_resize()</code></a> and compute the geometry yourself.</p>
|
||
</div>
|
||
<p>Like <a class="link" href="GtkWindow.html#gtk-window-resize" title="gtk_window_resize ()"><code class="function">gtk_window_resize()</code></a>, but <em class="parameter"><code>width</code></em>
|
||
and <em class="parameter"><code>height</code></em>
|
||
are interpreted
|
||
in terms of the base size and increment set with
|
||
gtk_window_set_geometry_hints.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-resize-to-geometry.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>width</p></td>
|
||
<td class="parameter_description"><p>width in resize increments to resize the window to</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>height</p></td>
|
||
<td class="parameter_description"><p>height in resize increments to resize the window to</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-set-default-icon-list"></a><h3>gtk_window_set_default_icon_list ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_window_set_default_icon_list (<em class="parameter"><code><span class="type">GList</span> *list</code></em>);</pre>
|
||
<p>Sets an icon list to be used as fallback for windows that haven't
|
||
had <a class="link" href="GtkWindow.html#gtk-window-set-icon-list" title="gtk_window_set_icon_list ()"><code class="function">gtk_window_set_icon_list()</code></a> called on them to set up a
|
||
window-specific icon list. This function allows you to set up the
|
||
icon for all windows in your app at once.</p>
|
||
<p>See <a class="link" href="GtkWindow.html#gtk-window-set-icon-list" title="gtk_window_set_icon_list ()"><code class="function">gtk_window_set_icon_list()</code></a> for more details.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-set-default-icon-list.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>list</p></td>
|
||
<td class="parameter_description"><p>a list of <span class="type">GdkPixbuf</span>. </p></td>
|
||
<td class="parameter_annotations"><span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> GdkPixbuf][<acronym title="The caller owns the data container, but not the data inside it."><span class="acronym">transfer container</span></acronym>]</span></td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-set-default-icon"></a><h3>gtk_window_set_default_icon ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_window_set_default_icon (<em class="parameter"><code><span class="type">GdkPixbuf</span> *icon</code></em>);</pre>
|
||
<p>Sets an icon to be used as fallback for windows that haven't
|
||
had <a class="link" href="GtkWindow.html#gtk-window-set-icon" title="gtk_window_set_icon ()"><code class="function">gtk_window_set_icon()</code></a> called on them from a pixbuf.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-set-default-icon.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>icon</p></td>
|
||
<td class="parameter_description"><p>the icon</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: 2.4</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-set-default-icon-from-file"></a><h3>gtk_window_set_default_icon_from_file ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_window_set_default_icon_from_file (<em class="parameter"><code>const <span class="type">gchar</span> *filename</code></em>,
|
||
<em class="parameter"><code><span class="type">GError</span> **err</code></em>);</pre>
|
||
<p>Sets an icon to be used as fallback for windows that haven't
|
||
had <a class="link" href="GtkWindow.html#gtk-window-set-icon-list" title="gtk_window_set_icon_list ()"><code class="function">gtk_window_set_icon_list()</code></a> called on them from a file
|
||
on disk. Warns on failure if <em class="parameter"><code>err</code></em>
|
||
is <code class="literal">NULL</code>.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-set-default-icon-from-file.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>filename</p></td>
|
||
<td class="parameter_description"><p>location of icon file. </p></td>
|
||
<td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> filename]</span></td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>err</p></td>
|
||
<td class="parameter_description"><p>location to store error, or <code class="literal">NULL</code>. </p></td>
|
||
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-set-default-icon-from-file.returns"></a><h4>Returns</h4>
|
||
<p> <code class="literal">TRUE</code> if setting the icon succeeded.</p>
|
||
</div>
|
||
<p class="since">Since: 2.2</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-set-default-icon-name"></a><h3>gtk_window_set_default_icon_name ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_window_set_default_icon_name (<em class="parameter"><code>const <span class="type">gchar</span> *name</code></em>);</pre>
|
||
<p>Sets an icon to be used as fallback for windows that haven't
|
||
had <a class="link" href="GtkWindow.html#gtk-window-set-icon-list" title="gtk_window_set_icon_list ()"><code class="function">gtk_window_set_icon_list()</code></a> called on them from a named
|
||
themed icon, see <a class="link" href="GtkWindow.html#gtk-window-set-icon-name" title="gtk_window_set_icon_name ()"><code class="function">gtk_window_set_icon_name()</code></a>.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-set-default-icon-name.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>name</p></td>
|
||
<td class="parameter_description"><p>the name of the themed icon</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: 2.6</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-set-icon"></a><h3>gtk_window_set_icon ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_window_set_icon (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><span class="type">GdkPixbuf</span> *icon</code></em>);</pre>
|
||
<p>Sets up the icon representing a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a>. This icon is used when
|
||
the window is minimized (also known as iconified). Some window
|
||
managers or desktop environments may also place it in the window
|
||
frame, or display it in other contexts. On others, the icon is not
|
||
used at all, so your mileage may vary.</p>
|
||
<p>The icon should be provided in whatever size it was naturally
|
||
drawn; that is, don’t scale the image before passing it to
|
||
GTK+. Scaling is postponed until the last minute, when the desired
|
||
final size is known, to allow best quality.</p>
|
||
<p>If you have your icon hand-drawn in multiple sizes, use
|
||
<a class="link" href="GtkWindow.html#gtk-window-set-icon-list" title="gtk_window_set_icon_list ()"><code class="function">gtk_window_set_icon_list()</code></a>. Then the best size will be used.</p>
|
||
<p>This function is equivalent to calling <a class="link" href="GtkWindow.html#gtk-window-set-icon-list" title="gtk_window_set_icon_list ()"><code class="function">gtk_window_set_icon_list()</code></a>
|
||
with a 1-element list.</p>
|
||
<p>See also <a class="link" href="GtkWindow.html#gtk-window-set-default-icon-list" title="gtk_window_set_default_icon_list ()"><code class="function">gtk_window_set_default_icon_list()</code></a> to set the icon
|
||
for all windows in your application in one go.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-set-icon.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>icon</p></td>
|
||
<td class="parameter_description"><p>icon image, or <code class="literal">NULL</code>. </p></td>
|
||
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-set-icon-list"></a><h3>gtk_window_set_icon_list ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_window_set_icon_list (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><span class="type">GList</span> *list</code></em>);</pre>
|
||
<p>Sets up the icon representing a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a>. The icon is used when
|
||
the window is minimized (also known as iconified). Some window
|
||
managers or desktop environments may also place it in the window
|
||
frame, or display it in other contexts. On others, the icon is not
|
||
used at all, so your mileage may vary.</p>
|
||
<p>gtk_window_set_icon_list() allows you to pass in the same icon in
|
||
several hand-drawn sizes. The list should contain the natural sizes
|
||
your icon is available in; that is, don’t scale the image before
|
||
passing it to GTK+. Scaling is postponed until the last minute,
|
||
when the desired final size is known, to allow best quality.</p>
|
||
<p>By passing several sizes, you may improve the final image quality
|
||
of the icon, by reducing or eliminating automatic image scaling.</p>
|
||
<p>Recommended sizes to provide: 16x16, 32x32, 48x48 at minimum, and
|
||
larger images (64x64, 128x128) if you have them.</p>
|
||
<p>See also <a class="link" href="GtkWindow.html#gtk-window-set-default-icon-list" title="gtk_window_set_default_icon_list ()"><code class="function">gtk_window_set_default_icon_list()</code></a> to set the icon
|
||
for all windows in your application in one go.</p>
|
||
<p>Note that transient windows (those who have been set transient for another
|
||
window using <a class="link" href="GtkWindow.html#gtk-window-set-transient-for" title="gtk_window_set_transient_for ()"><code class="function">gtk_window_set_transient_for()</code></a>) will inherit their
|
||
icon from their transient parent. So there’s no need to explicitly
|
||
set the icon on transient windows.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-set-icon-list.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>list</p></td>
|
||
<td class="parameter_description"><p>list of <span class="type">GdkPixbuf</span>. </p></td>
|
||
<td class="parameter_annotations"><span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> GdkPixbuf]</span></td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-set-icon-from-file"></a><h3>gtk_window_set_icon_from_file ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_window_set_icon_from_file (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code>const <span class="type">gchar</span> *filename</code></em>,
|
||
<em class="parameter"><code><span class="type">GError</span> **err</code></em>);</pre>
|
||
<p>Sets the icon for <em class="parameter"><code>window</code></em>
|
||
.
|
||
Warns on failure if <em class="parameter"><code>err</code></em>
|
||
is <code class="literal">NULL</code>.</p>
|
||
<p>This function is equivalent to calling <a class="link" href="GtkWindow.html#gtk-window-set-icon" title="gtk_window_set_icon ()"><code class="function">gtk_window_set_icon()</code></a>
|
||
with a pixbuf created by loading the image from <em class="parameter"><code>filename</code></em>
|
||
.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-set-icon-from-file.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>filename</p></td>
|
||
<td class="parameter_description"><p>location of icon file. </p></td>
|
||
<td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> filename]</span></td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>err</p></td>
|
||
<td class="parameter_description"><p>location to store error, or <code class="literal">NULL</code>. </p></td>
|
||
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-set-icon-from-file.returns"></a><h4>Returns</h4>
|
||
<p> <code class="literal">TRUE</code> if setting the icon succeeded.</p>
|
||
</div>
|
||
<p class="since">Since: 2.2</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-set-icon-name"></a><h3>gtk_window_set_icon_name ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_window_set_icon_name (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code>const <span class="type">gchar</span> *name</code></em>);</pre>
|
||
<p>Sets the icon for the window from a named themed icon.
|
||
See the docs for <a class="link" href="GtkIconTheme.html" title="GtkIconTheme"><span class="type">GtkIconTheme</span></a> for more details.
|
||
On some platforms, the window icon is not used at all.</p>
|
||
<p>Note that this has nothing to do with the WM_ICON_NAME
|
||
property which is mentioned in the ICCCM.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-set-icon-name.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>name</p></td>
|
||
<td class="parameter_description"><p>the name of the themed icon. </p></td>
|
||
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: 2.6</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-set-auto-startup-notification"></a><h3>gtk_window_set_auto_startup_notification ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_window_set_auto_startup_notification
|
||
(<em class="parameter"><code><span class="type">gboolean</span> setting</code></em>);</pre>
|
||
<p>By default, after showing the first <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a>, GTK+ calls
|
||
<code class="function">gdk_notify_startup_complete()</code>. Call this function to disable
|
||
the automatic startup notification. You might do this if your
|
||
first window is a splash screen, and you want to delay notification
|
||
until after your real main window has been shown, for example.</p>
|
||
<p>In that example, you would disable startup notification
|
||
temporarily, show your splash screen, then re-enable it so that
|
||
showing the main window would automatically result in notification.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-set-auto-startup-notification.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>setting</p></td>
|
||
<td class="parameter_description"><p><code class="literal">TRUE</code> to automatically do startup notification</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: 2.2</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-get-opacity"></a><h3>gtk_window_get_opacity ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gdouble</span>
|
||
gtk_window_get_opacity (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>);</pre>
|
||
<div class="warning">
|
||
<p><code class="literal">gtk_window_get_opacity</code> has been deprecated since version 3.8 and should not be used in newly-written code.</p>
|
||
<p>Use gtk_widget_get_opacity instead.</p>
|
||
</div>
|
||
<p>Fetches the requested opacity for this window. See
|
||
<a class="link" href="GtkWindow.html#gtk-window-set-opacity" title="gtk_window_set_opacity ()"><code class="function">gtk_window_set_opacity()</code></a>.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-get-opacity.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-get-opacity.returns"></a><h4>Returns</h4>
|
||
<p> the requested opacity for this window.</p>
|
||
</div>
|
||
<p class="since">Since: 2.12</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-set-opacity"></a><h3>gtk_window_set_opacity ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_window_set_opacity (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><span class="type">gdouble</span> opacity</code></em>);</pre>
|
||
<div class="warning">
|
||
<p><code class="literal">gtk_window_set_opacity</code> has been deprecated since version 3.8 and should not be used in newly-written code.</p>
|
||
<p>Use gtk_widget_set_opacity instead.</p>
|
||
</div>
|
||
<p>Request the windowing system to make <em class="parameter"><code>window</code></em>
|
||
partially transparent,
|
||
with opacity 0 being fully transparent and 1 fully opaque. (Values
|
||
of the opacity parameter are clamped to the [0,1] range.) On X11
|
||
this has any effect only on X screens with a compositing manager
|
||
running. See <a class="link" href="GtkWidget.html#gtk-widget-is-composited" title="gtk_widget_is_composited ()"><code class="function">gtk_widget_is_composited()</code></a>. On Windows it should work
|
||
always.</p>
|
||
<p>Note that setting a window’s opacity after the window has been
|
||
shown causes it to flicker once on Windows.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-set-opacity.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>opacity</p></td>
|
||
<td class="parameter_description"><p>desired opacity, between 0 and 1</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: 2.12</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-get-mnemonics-visible"></a><h3>gtk_window_get_mnemonics_visible ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_window_get_mnemonics_visible (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>);</pre>
|
||
<p>Gets the value of the <a class="link" href="GtkWindow.html#GtkWindow--mnemonics-visible" title="The “mnemonics-visible” property"><span class="type">“mnemonics-visible”</span></a> property.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-get-mnemonics-visible.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-get-mnemonics-visible.returns"></a><h4>Returns</h4>
|
||
<p> <code class="literal">TRUE</code> if mnemonics are supposed to be visible
|
||
in this window.</p>
|
||
</div>
|
||
<p class="since">Since: 2.20</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-set-mnemonics-visible"></a><h3>gtk_window_set_mnemonics_visible ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_window_set_mnemonics_visible (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><span class="type">gboolean</span> setting</code></em>);</pre>
|
||
<p>Sets the <a class="link" href="GtkWindow.html#GtkWindow--mnemonics-visible" title="The “mnemonics-visible” property"><span class="type">“mnemonics-visible”</span></a> property.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-set-mnemonics-visible.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>setting</p></td>
|
||
<td class="parameter_description"><p>the new value</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: 2.20</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-get-focus-visible"></a><h3>gtk_window_get_focus_visible ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_window_get_focus_visible (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>);</pre>
|
||
<p>Gets the value of the <a class="link" href="GtkWindow.html#GtkWindow--focus-visible" title="The “focus-visible” property"><span class="type">“focus-visible”</span></a> property.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-get-focus-visible.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-get-focus-visible.returns"></a><h4>Returns</h4>
|
||
<p> <code class="literal">TRUE</code> if “focus rectangles” are supposed to be visible
|
||
in this window.</p>
|
||
</div>
|
||
<p class="since">Since: <a class="link" href="api-index-3-2.html#api-index-3.2">3.2</a></p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-set-focus-visible"></a><h3>gtk_window_set_focus_visible ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_window_set_focus_visible (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><span class="type">gboolean</span> setting</code></em>);</pre>
|
||
<p>Sets the <a class="link" href="GtkWindow.html#GtkWindow--focus-visible" title="The “focus-visible” property"><span class="type">“focus-visible”</span></a> property.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-set-focus-visible.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>setting</p></td>
|
||
<td class="parameter_description"><p>the new value</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: <a class="link" href="api-index-3-2.html#api-index-3.2">3.2</a></p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-set-has-resize-grip"></a><h3>gtk_window_set_has_resize_grip ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_window_set_has_resize_grip (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><span class="type">gboolean</span> value</code></em>);</pre>
|
||
<div class="warning">
|
||
<p><code class="literal">gtk_window_set_has_resize_grip</code> has been deprecated since version 3.14 and should not be used in newly-written code.</p>
|
||
<p>Resize grips have been removed.</p>
|
||
</div>
|
||
<p>Sets whether <em class="parameter"><code>window</code></em>
|
||
has a corner resize grip.</p>
|
||
<p>Note that the resize grip is only shown if the window
|
||
is actually resizable and not maximized. Use
|
||
<a class="link" href="GtkWindow.html#gtk-window-resize-grip-is-visible" title="gtk_window_resize_grip_is_visible ()"><code class="function">gtk_window_resize_grip_is_visible()</code></a> to find out if the
|
||
resize grip is currently shown.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-set-has-resize-grip.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>value</p></td>
|
||
<td class="parameter_description"><p><code class="literal">TRUE</code> to allow a resize grip</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-get-has-resize-grip"></a><h3>gtk_window_get_has_resize_grip ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_window_get_has_resize_grip (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>);</pre>
|
||
<div class="warning">
|
||
<p><code class="literal">gtk_window_get_has_resize_grip</code> has been deprecated since version 3.14 and should not be used in newly-written code.</p>
|
||
<p>Resize grips have been removed.</p>
|
||
</div>
|
||
<p>Determines whether the window may have a resize grip.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-get-has-resize-grip.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-get-has-resize-grip.returns"></a><h4>Returns</h4>
|
||
<p> <code class="literal">TRUE</code> if the window has a resize grip</p>
|
||
</div>
|
||
<p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-resize-grip-is-visible"></a><h3>gtk_window_resize_grip_is_visible ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_window_resize_grip_is_visible (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>);</pre>
|
||
<div class="warning">
|
||
<p><code class="literal">gtk_window_resize_grip_is_visible</code> has been deprecated since version 3.14 and should not be used in newly-written code.</p>
|
||
<p>Resize grips have been removed.</p>
|
||
</div>
|
||
<p>Determines whether a resize grip is visible for the specified window.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-resize-grip-is-visible.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-resize-grip-is-visible.returns"></a><h4>Returns</h4>
|
||
<p> <code class="literal">TRUE</code> if a resize grip exists and is visible</p>
|
||
</div>
|
||
<p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-get-resize-grip-area"></a><h3>gtk_window_get_resize_grip_area ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_window_get_resize_grip_area (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><span class="type">GdkRectangle</span> *rect</code></em>);</pre>
|
||
<div class="warning">
|
||
<p><code class="literal">gtk_window_get_resize_grip_area</code> has been deprecated since version 3.14 and should not be used in newly-written code.</p>
|
||
<p>Resize grips have been removed.</p>
|
||
</div>
|
||
<p>If a window has a resize grip, this will retrieve the grip
|
||
position, width and height into the specified <span class="type">GdkRectangle</span>.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-get-resize-grip-area.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>rect</p></td>
|
||
<td class="parameter_description"><p>a pointer to a <span class="type">GdkRectangle</span> which we should store
|
||
the resize grip area. </p></td>
|
||
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-get-resize-grip-area.returns"></a><h4>Returns</h4>
|
||
<p> <code class="literal">TRUE</code> if the resize grip’s area was retrieved</p>
|
||
</div>
|
||
<p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-get-application"></a><h3>gtk_window_get_application ()</h3>
|
||
<pre class="programlisting"><a class="link" href="GtkApplication.html" title="GtkApplication"><span class="returnvalue">GtkApplication</span></a> *
|
||
gtk_window_get_application (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>);</pre>
|
||
<p>Gets the <a class="link" href="GtkApplication.html" title="GtkApplication"><span class="type">GtkApplication</span></a> associated with the window (if any).</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-get-application.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-get-application.returns"></a><h4>Returns</h4>
|
||
<p>a <a class="link" href="GtkApplication.html" title="GtkApplication"><span class="type">GtkApplication</span></a>, or <code class="literal">NULL</code>. </p>
|
||
<p><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>][<acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>]</span></p>
|
||
</div>
|
||
<p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-set-application"></a><h3>gtk_window_set_application ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_window_set_application (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkApplication.html" title="GtkApplication"><span class="type">GtkApplication</span></a> *application</code></em>);</pre>
|
||
<p>Sets or unsets the <a class="link" href="GtkApplication.html" title="GtkApplication"><span class="type">GtkApplication</span></a> associated with the window.</p>
|
||
<p>The application will be kept alive for at least as long as it has any windows
|
||
associated with it (see <code class="function">g_application_hold()</code> for a way to keep it alive
|
||
without windows).</p>
|
||
<p>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 <em class="parameter"><code>application</code></em>
|
||
to <code class="literal">NULL</code>.</p>
|
||
<p>This is equivalent to calling <a class="link" href="GtkApplication.html#gtk-application-remove-window" title="gtk_application_remove_window ()"><code class="function">gtk_application_remove_window()</code></a> and/or
|
||
<a class="link" href="GtkApplication.html#gtk-application-add-window" title="gtk_application_add_window ()"><code class="function">gtk_application_add_window()</code></a> on the old/new applications as relevant.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-set-application.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>application</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkApplication.html" title="GtkApplication"><span class="type">GtkApplication</span></a>, or <code class="literal">NULL</code> to unset. </p></td>
|
||
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-set-has-user-ref-count"></a><h3>gtk_window_set_has_user_ref_count ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_window_set_has_user_ref_count (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><span class="type">gboolean</span> setting</code></em>);</pre>
|
||
<p>Tells GTK+ whether to drop its extra reference to the window
|
||
when <a class="link" href="GtkWidget.html#gtk-widget-destroy" title="gtk_widget_destroy ()"><code class="function">gtk_widget_destroy()</code></a> is called.</p>
|
||
<p>This function is only exported for the benefit of language
|
||
bindings which may need to keep the window alive until their
|
||
wrapper object is garbage collected. There is no justification
|
||
for ever calling this function in an application.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-set-has-user-ref-count.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>setting</p></td>
|
||
<td class="parameter_description"><p>the new value</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-set-titlebar"></a><h3>gtk_window_set_titlebar ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_window_set_titlebar (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *titlebar</code></em>);</pre>
|
||
<p>Sets a custom titlebar for <em class="parameter"><code>window</code></em>
|
||
.</p>
|
||
<p>A typical widget used here is <a class="link" href="GtkHeaderBar.html" title="GtkHeaderBar"><span class="type">GtkHeaderBar</span></a>, as it provides various features
|
||
expected of a titlebar while allowing the addition of child widgets to it.</p>
|
||
<p>If you set a custom titlebar, GTK+ will do its best to convince
|
||
the window manager not to put its own titlebar on the window.
|
||
Depending on the system, this function may not work for a window
|
||
that is already visible, so you set the titlebar before calling
|
||
<a class="link" href="GtkWidget.html#gtk-widget-show" title="gtk_widget_show ()"><code class="function">gtk_widget_show()</code></a>.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-set-titlebar.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>titlebar</p></td>
|
||
<td class="parameter_description"><p>the widget to use as titlebar. </p></td>
|
||
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: <a class="link" href="api-index-3-10.html#api-index-3.10">3.10</a></p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-get-titlebar"></a><h3>gtk_window_get_titlebar ()</h3>
|
||
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
|
||
gtk_window_get_titlebar (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>);</pre>
|
||
<p>Returns the custom titlebar that has been set with
|
||
<a class="link" href="GtkWindow.html#gtk-window-set-titlebar" title="gtk_window_set_titlebar ()"><code class="function">gtk_window_set_titlebar()</code></a>.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-get-titlebar.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-get-titlebar.returns"></a><h4>Returns</h4>
|
||
<p>the custom titlebar, or <code class="literal">NULL</code>. </p>
|
||
<p><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>][<acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>]</span></p>
|
||
</div>
|
||
<p class="since">Since: <a class="link" href="api-index-3-16.html#api-index-3.16">3.16</a></p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-window-set-interactive-debugging"></a><h3>gtk_window_set_interactive_debugging ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_window_set_interactive_debugging (<em class="parameter"><code><span class="type">gboolean</span> enable</code></em>);</pre>
|
||
<p>Opens or closes the <a class="link" href="gtk-running.html#interactive-debugging" title="Interactive debugging">interactive debugger</a>,
|
||
which offers access to the widget hierarchy of the application
|
||
and to useful debugging tools.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-window-set-interactive-debugging.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>enable</p></td>
|
||
<td class="parameter_description"><p><code class="literal">TRUE</code> to enable interactive debugging</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: <a class="link" href="api-index-3-14.html#api-index-3.14">3.14</a></p>
|
||
</div>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="GtkWindow.other_details"></a><h2>Types and Values</h2>
|
||
<div class="refsect2">
|
||
<a name="GtkWindow-struct"></a><h3>GtkWindow</h3>
|
||
<pre class="programlisting">typedef struct _GtkWindow GtkWindow;</pre>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkWindowClass"></a><h3>struct GtkWindowClass</h3>
|
||
<pre class="programlisting">struct GtkWindowClass {
|
||
GtkBinClass parent_class;
|
||
|
||
void (* set_focus) (GtkWindow *window,
|
||
GtkWidget *focus);
|
||
|
||
/* G_SIGNAL_ACTION signals for keybindings */
|
||
|
||
void (* activate_focus) (GtkWindow *window);
|
||
void (* activate_default) (GtkWindow *window);
|
||
void (* keys_changed) (GtkWindow *window);
|
||
gboolean (* enable_debugging) (GtkWindow *window,
|
||
gboolean toggle);
|
||
};
|
||
</pre>
|
||
<div class="refsect3">
|
||
<a name="GtkWindowClass.members"></a><h4>Members</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="300px" class="struct_members_name">
|
||
<col class="struct_members_description">
|
||
<col width="200px" class="struct_members_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="struct_member_name"><p><em class="structfield"><code><a name="GtkWindowClass.set-focus"></a>set_focus</code></em> ()</p></td>
|
||
<td class="struct_member_description"><p>Sets child as the focus widget for the window.</p></td>
|
||
<td class="struct_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="struct_member_name"><p><em class="structfield"><code><a name="GtkWindowClass.activate-focus"></a>activate_focus</code></em> ()</p></td>
|
||
<td class="struct_member_description"><p>Activates the current focused widget within the window.</p></td>
|
||
<td class="struct_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="struct_member_name"><p><em class="structfield"><code><a name="GtkWindowClass.activate-default"></a>activate_default</code></em> ()</p></td>
|
||
<td class="struct_member_description"><p>Activates the default widget for the window.</p></td>
|
||
<td class="struct_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="struct_member_name"><p><em class="structfield"><code><a name="GtkWindowClass.keys-changed"></a>keys_changed</code></em> ()</p></td>
|
||
<td class="struct_member_description"><p>Signal gets emitted when the set of accelerators or
|
||
mnemonics that are associated with window changes.</p></td>
|
||
<td class="struct_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="struct_member_name"><p><em class="structfield"><code><a name="GtkWindowClass.enable-debugging"></a>enable_debugging</code></em> ()</p></td>
|
||
<td class="struct_member_description"><p>Class handler for the <a class="link" href="GtkWindow.html#GtkWindow-enable-debugging" title="The “enable-debugging” signal"><span class="type">“enable-debugging”</span></a>
|
||
keybinding signal. Since: 3.14</p></td>
|
||
<td class="struct_member_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkWindowType"></a><h3>enum GtkWindowType</h3>
|
||
<p>A <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> can be one of these types. Most things you’d consider a
|
||
“window” should have type <a class="link" href="GtkWindow.html#GTK-WINDOW-TOPLEVEL:CAPS"><span class="type">GTK_WINDOW_TOPLEVEL</span></a>; windows with this type
|
||
are managed by the window manager and have a frame by default (call
|
||
<a class="link" href="GtkWindow.html#gtk-window-set-decorated" title="gtk_window_set_decorated ()"><code class="function">gtk_window_set_decorated()</code></a> to toggle the frame). Windows with type
|
||
<a class="link" href="GtkWindow.html#GTK-WINDOW-POPUP:CAPS"><span class="type">GTK_WINDOW_POPUP</span></a> are ignored by the window manager; window manager
|
||
keybindings won’t work on them, the window manager won’t decorate the
|
||
window with a frame, many GTK+ features that rely on the window
|
||
manager will not work (e.g. resize grips and
|
||
maximization/minimization). <a class="link" href="GtkWindow.html#GTK-WINDOW-POPUP:CAPS"><span class="type">GTK_WINDOW_POPUP</span></a> is used to implement
|
||
widgets such as <a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> or tooltips that you normally don’t think of
|
||
as windows per se. Nearly all windows should be <a class="link" href="GtkWindow.html#GTK-WINDOW-TOPLEVEL:CAPS"><span class="type">GTK_WINDOW_TOPLEVEL</span></a>.
|
||
In particular, do not use <a class="link" href="GtkWindow.html#GTK-WINDOW-POPUP:CAPS"><span class="type">GTK_WINDOW_POPUP</span></a> just to turn off
|
||
the window borders; use <a class="link" href="GtkWindow.html#gtk-window-set-decorated" title="gtk_window_set_decorated ()"><code class="function">gtk_window_set_decorated()</code></a> for that.</p>
|
||
<div class="refsect3">
|
||
<a name="GtkWindowType.members"></a><h4>Members</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="300px" class="enum_members_name">
|
||
<col class="enum_members_description">
|
||
<col width="200px" class="enum_members_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GTK-WINDOW-TOPLEVEL:CAPS"></a>GTK_WINDOW_TOPLEVEL</p></td>
|
||
<td class="enum_member_description">
|
||
<p>A regular window, such as a dialog.</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GTK-WINDOW-POPUP:CAPS"></a>GTK_WINDOW_POPUP</p></td>
|
||
<td class="enum_member_description">
|
||
<p>A special window such as a tooltip.</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkWindowPosition"></a><h3>enum GtkWindowPosition</h3>
|
||
<p>Window placement can be influenced using this enumeration. Note that
|
||
using <a class="link" href="GtkWindow.html#GTK-WIN-POS-CENTER-ALWAYS:CAPS"><span class="type">GTK_WIN_POS_CENTER_ALWAYS</span></a> is almost always a bad idea.
|
||
It won’t necessarily work well with all window managers or on all windowing systems.</p>
|
||
<div class="refsect3">
|
||
<a name="GtkWindowPosition.members"></a><h4>Members</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="300px" class="enum_members_name">
|
||
<col class="enum_members_description">
|
||
<col width="200px" class="enum_members_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GTK-WIN-POS-NONE:CAPS"></a>GTK_WIN_POS_NONE</p></td>
|
||
<td class="enum_member_description">
|
||
<p>No influence is made on placement.</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GTK-WIN-POS-CENTER:CAPS"></a>GTK_WIN_POS_CENTER</p></td>
|
||
<td class="enum_member_description">
|
||
<p>Windows should be placed in the center of the screen.</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GTK-WIN-POS-MOUSE:CAPS"></a>GTK_WIN_POS_MOUSE</p></td>
|
||
<td class="enum_member_description">
|
||
<p>Windows should be placed at the current mouse position.</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GTK-WIN-POS-CENTER-ALWAYS:CAPS"></a>GTK_WIN_POS_CENTER_ALWAYS</p></td>
|
||
<td class="enum_member_description">
|
||
<p>Keep window centered as it changes size, etc.</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GTK-WIN-POS-CENTER-ON-PARENT:CAPS"></a>GTK_WIN_POS_CENTER_ON_PARENT</p></td>
|
||
<td class="enum_member_description">
|
||
<p>Center the window on its transient
|
||
parent (see <a class="link" href="GtkWindow.html#gtk-window-set-transient-for" title="gtk_window_set_transient_for ()"><code class="function">gtk_window_set_transient_for()</code></a>).</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="GtkWindow.property-details"></a><h2>Property Details</h2>
|
||
<div class="refsect2">
|
||
<a name="GtkWindow--accept-focus"></a><h3>The <code class="literal">“accept-focus”</code> property</h3>
|
||
<pre class="programlisting"> “accept-focus” <span class="type">gboolean</span></pre>
|
||
<p>Whether the window should receive the input focus.</p>
|
||
<p>Owner: GtkWindow</p>
|
||
<p>Flags: Read / Write</p>
|
||
<p>Default value: TRUE</p>
|
||
<p class="since">Since: 2.4</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkWindow--application"></a><h3>The <code class="literal">“application”</code> property</h3>
|
||
<pre class="programlisting"> “application” <a class="link" href="GtkApplication.html" title="GtkApplication"><span class="type">GtkApplication</span></a> *</pre>
|
||
<p>The <a class="link" href="GtkApplication.html" title="GtkApplication"><span class="type">GtkApplication</span></a> associated with the window.</p>
|
||
<p>The application will be kept alive for at least as long as it
|
||
has any windows associated with it (see <code class="function">g_application_hold()</code>
|
||
for a way to keep it alive without windows).</p>
|
||
<p>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 <code class="literal">NULL</code>.</p>
|
||
<p>Owner: GtkWindow</p>
|
||
<p>Flags: Read / Write</p>
|
||
<p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkWindow--attached-to"></a><h3>The <code class="literal">“attached-to”</code> property</h3>
|
||
<pre class="programlisting"> “attached-to” <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *</pre>
|
||
<p>The widget to which this window is attached.
|
||
See <a class="link" href="GtkWindow.html#gtk-window-set-attached-to" title="gtk_window_set_attached_to ()"><code class="function">gtk_window_set_attached_to()</code></a>.</p>
|
||
<p>Examples of places where specifying this relation is useful are
|
||
for instance a <a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> created by a <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a>, a completion
|
||
popup window created by <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> or a typeahead search entry
|
||
created by <a class="link" href="GtkTreeView.html" title="GtkTreeView"><span class="type">GtkTreeView</span></a>.</p>
|
||
<p>Owner: GtkWindow</p>
|
||
<p>Flags: Read / Write / Construct</p>
|
||
<p class="since">Since: <a class="link" href="api-index-3-4.html#api-index-3.4">3.4</a></p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkWindow--decorated"></a><h3>The <code class="literal">“decorated”</code> property</h3>
|
||
<pre class="programlisting"> “decorated” <span class="type">gboolean</span></pre>
|
||
<p>Whether the window should be decorated by the window manager.</p>
|
||
<p>Owner: GtkWindow</p>
|
||
<p>Flags: Read / Write</p>
|
||
<p>Default value: TRUE</p>
|
||
<p class="since">Since: 2.4</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkWindow--default-height"></a><h3>The <code class="literal">“default-height”</code> property</h3>
|
||
<pre class="programlisting"> “default-height” <span class="type">int</span></pre>
|
||
<p>The default height of the window, used when initially showing the window.</p>
|
||
<p>Owner: GtkWindow</p>
|
||
<p>Flags: Read / Write</p>
|
||
<p>Allowed values: >= -1</p>
|
||
<p>Default value: -1</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkWindow--default-width"></a><h3>The <code class="literal">“default-width”</code> property</h3>
|
||
<pre class="programlisting"> “default-width” <span class="type">int</span></pre>
|
||
<p>The default width of the window, used when initially showing the window.</p>
|
||
<p>Owner: GtkWindow</p>
|
||
<p>Flags: Read / Write</p>
|
||
<p>Allowed values: >= -1</p>
|
||
<p>Default value: -1</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkWindow--deletable"></a><h3>The <code class="literal">“deletable”</code> property</h3>
|
||
<pre class="programlisting"> “deletable” <span class="type">gboolean</span></pre>
|
||
<p>Whether the window frame should have a close button.</p>
|
||
<p>Owner: GtkWindow</p>
|
||
<p>Flags: Read / Write</p>
|
||
<p>Default value: TRUE</p>
|
||
<p class="since">Since: 2.10</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkWindow--destroy-with-parent"></a><h3>The <code class="literal">“destroy-with-parent”</code> property</h3>
|
||
<pre class="programlisting"> “destroy-with-parent” <span class="type">gboolean</span></pre>
|
||
<p>If this window should be destroyed when the parent is destroyed.</p>
|
||
<p>Owner: GtkWindow</p>
|
||
<p>Flags: Read / Write</p>
|
||
<p>Default value: FALSE</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkWindow--focus-on-map"></a><h3>The <code class="literal">“focus-on-map”</code> property</h3>
|
||
<pre class="programlisting"> “focus-on-map” <span class="type">gboolean</span></pre>
|
||
<p>Whether the window should receive the input focus when mapped.</p>
|
||
<p>Owner: GtkWindow</p>
|
||
<p>Flags: Read / Write</p>
|
||
<p>Default value: TRUE</p>
|
||
<p class="since">Since: 2.6</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkWindow--focus-visible"></a><h3>The <code class="literal">“focus-visible”</code> property</h3>
|
||
<pre class="programlisting"> “focus-visible” <span class="type">gboolean</span></pre>
|
||
<p>Whether 'focus rectangles' are currently visible in this window.</p>
|
||
<p>This property is maintained by GTK+ based on user input
|
||
and should not be set by applications.</p>
|
||
<p>Owner: GtkWindow</p>
|
||
<p>Flags: Read / Write</p>
|
||
<p>Default value: TRUE</p>
|
||
<p class="since">Since: 2.20</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkWindow--gravity"></a><h3>The <code class="literal">“gravity”</code> property</h3>
|
||
<pre class="programlisting"> “gravity” <span class="type">GdkGravity</span></pre>
|
||
<p>The window gravity of the window. See <a class="link" href="GtkWindow.html#gtk-window-move" title="gtk_window_move ()"><code class="function">gtk_window_move()</code></a> and <span class="type">GdkGravity</span> for
|
||
more details about window gravity.</p>
|
||
<p>Owner: GtkWindow</p>
|
||
<p>Flags: Read / Write</p>
|
||
<p>Default value: GDK_GRAVITY_NORTH_WEST</p>
|
||
<p class="since">Since: 2.4</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkWindow--has-resize-grip"></a><h3>The <code class="literal">“has-resize-grip”</code> property</h3>
|
||
<pre class="programlisting"> “has-resize-grip” <span class="type">gboolean</span></pre>
|
||
<p>Whether the window has a corner resize grip.</p>
|
||
<p>Note that the resize grip is only shown if the window is
|
||
actually resizable and not maximized. Use
|
||
<a class="link" href="GtkWindow.html#GtkWindow--resize-grip-visible" title="The “resize-grip-visible” property"><span class="type">“resize-grip-visible”</span></a> to find out if the resize
|
||
grip is currently shown.</p>
|
||
<div class="warning">
|
||
<p><code class="literal">GtkWindow:has-resize-grip</code> has been deprecated since version 3.14 and should not be used in newly-written code.</p>
|
||
<p>Resize grips have been removed.</p>
|
||
</div>
|
||
<p>Owner: GtkWindow</p>
|
||
<p>Flags: Read / Write</p>
|
||
<p>Default value: FALSE</p>
|
||
<p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkWindow--has-toplevel-focus"></a><h3>The <code class="literal">“has-toplevel-focus”</code> property</h3>
|
||
<pre class="programlisting"> “has-toplevel-focus” <span class="type">gboolean</span></pre>
|
||
<p>Whether the input focus is within this GtkWindow.</p>
|
||
<p>Owner: GtkWindow</p>
|
||
<p>Flags: Read</p>
|
||
<p>Default value: FALSE</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkWindow--hide-titlebar-when-maximized"></a><h3>The <code class="literal">“hide-titlebar-when-maximized”</code> property</h3>
|
||
<pre class="programlisting"> “hide-titlebar-when-maximized” <span class="type">gboolean</span></pre>
|
||
<p>Whether the titlebar should be hidden during maximization.</p>
|
||
<p>Owner: GtkWindow</p>
|
||
<p>Flags: Read / Write</p>
|
||
<p>Default value: FALSE</p>
|
||
<p class="since">Since: <a class="link" href="api-index-3-4.html#api-index-3.4">3.4</a></p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkWindow--icon"></a><h3>The <code class="literal">“icon”</code> property</h3>
|
||
<pre class="programlisting"> “icon” <span class="type">GdkPixbuf</span> *</pre>
|
||
<p>Icon for this window.</p>
|
||
<p>Owner: GtkWindow</p>
|
||
<p>Flags: Read / Write</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkWindow--icon-name"></a><h3>The <code class="literal">“icon-name”</code> property</h3>
|
||
<pre class="programlisting"> “icon-name” <span class="type">char</span> *</pre>
|
||
<p>The :icon-name property specifies the name of the themed icon to
|
||
use as the window icon. See <a class="link" href="GtkIconTheme.html" title="GtkIconTheme"><span class="type">GtkIconTheme</span></a> for more details.</p>
|
||
<p>Owner: GtkWindow</p>
|
||
<p>Flags: Read / Write</p>
|
||
<p>Default value: NULL</p>
|
||
<p class="since">Since: 2.6</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkWindow--is-active"></a><h3>The <code class="literal">“is-active”</code> property</h3>
|
||
<pre class="programlisting"> “is-active” <span class="type">gboolean</span></pre>
|
||
<p>Whether the toplevel is the current active window.</p>
|
||
<p>Owner: GtkWindow</p>
|
||
<p>Flags: Read</p>
|
||
<p>Default value: FALSE</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkWindow--is-maximized"></a><h3>The <code class="literal">“is-maximized”</code> property</h3>
|
||
<pre class="programlisting"> “is-maximized” <span class="type">gboolean</span></pre>
|
||
<p>Whether the window is maximized.</p>
|
||
<p>Owner: GtkWindow</p>
|
||
<p>Flags: Read</p>
|
||
<p>Default value: FALSE</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkWindow--mnemonics-visible"></a><h3>The <code class="literal">“mnemonics-visible”</code> property</h3>
|
||
<pre class="programlisting"> “mnemonics-visible” <span class="type">gboolean</span></pre>
|
||
<p>Whether mnemonics are currently visible in this window.</p>
|
||
<p>This property is maintained by GTK+ based on user input,
|
||
and should not be set by applications.</p>
|
||
<p>Owner: GtkWindow</p>
|
||
<p>Flags: Read / Write</p>
|
||
<p>Default value: TRUE</p>
|
||
<p class="since">Since: 2.20</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkWindow--modal"></a><h3>The <code class="literal">“modal”</code> property</h3>
|
||
<pre class="programlisting"> “modal” <span class="type">gboolean</span></pre>
|
||
<p>If TRUE, the window is modal (other windows are not usable while this one is up).</p>
|
||
<p>Owner: GtkWindow</p>
|
||
<p>Flags: Read / Write</p>
|
||
<p>Default value: FALSE</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkWindow--resizable"></a><h3>The <code class="literal">“resizable”</code> property</h3>
|
||
<pre class="programlisting"> “resizable” <span class="type">gboolean</span></pre>
|
||
<p>If TRUE, users can resize the window.</p>
|
||
<p>Owner: GtkWindow</p>
|
||
<p>Flags: Read / Write</p>
|
||
<p>Default value: TRUE</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkWindow--resize-grip-visible"></a><h3>The <code class="literal">“resize-grip-visible”</code> property</h3>
|
||
<pre class="programlisting"> “resize-grip-visible” <span class="type">gboolean</span></pre>
|
||
<p>Whether a corner resize grip is currently shown.</p>
|
||
<div class="warning">
|
||
<p><code class="literal">GtkWindow:resize-grip-visible</code> has been deprecated since version 3.14 and should not be used in newly-written code.</p>
|
||
<p>Resize grips have been removed.</p>
|
||
</div>
|
||
<p>Owner: GtkWindow</p>
|
||
<p>Flags: Read</p>
|
||
<p>Default value: FALSE</p>
|
||
<p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkWindow--role"></a><h3>The <code class="literal">“role”</code> property</h3>
|
||
<pre class="programlisting"> “role” <span class="type">char</span> *</pre>
|
||
<p>Unique identifier for the window to be used when restoring a session.</p>
|
||
<p>Owner: GtkWindow</p>
|
||
<p>Flags: Read / Write</p>
|
||
<p>Default value: NULL</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkWindow--screen"></a><h3>The <code class="literal">“screen”</code> property</h3>
|
||
<pre class="programlisting"> “screen” <span class="type">GdkScreen</span> *</pre>
|
||
<p>The screen where this window will be displayed.</p>
|
||
<p>Owner: GtkWindow</p>
|
||
<p>Flags: Read / Write</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkWindow--skip-pager-hint"></a><h3>The <code class="literal">“skip-pager-hint”</code> property</h3>
|
||
<pre class="programlisting"> “skip-pager-hint” <span class="type">gboolean</span></pre>
|
||
<p>TRUE if the window should not be in the pager.</p>
|
||
<p>Owner: GtkWindow</p>
|
||
<p>Flags: Read / Write</p>
|
||
<p>Default value: FALSE</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkWindow--skip-taskbar-hint"></a><h3>The <code class="literal">“skip-taskbar-hint”</code> property</h3>
|
||
<pre class="programlisting"> “skip-taskbar-hint” <span class="type">gboolean</span></pre>
|
||
<p>TRUE if the window should not be in the task bar.</p>
|
||
<p>Owner: GtkWindow</p>
|
||
<p>Flags: Read / Write</p>
|
||
<p>Default value: FALSE</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkWindow--startup-id"></a><h3>The <code class="literal">“startup-id”</code> property</h3>
|
||
<pre class="programlisting"> “startup-id” <span class="type">char</span> *</pre>
|
||
<p>The :startup-id is a write-only property for setting window's
|
||
startup notification identifier. See <a class="link" href="GtkWindow.html#gtk-window-set-startup-id" title="gtk_window_set_startup_id ()"><code class="function">gtk_window_set_startup_id()</code></a>
|
||
for more details.</p>
|
||
<p>Owner: GtkWindow</p>
|
||
<p>Flags: Write</p>
|
||
<p>Default value: NULL</p>
|
||
<p class="since">Since: 2.12</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkWindow--title"></a><h3>The <code class="literal">“title”</code> property</h3>
|
||
<pre class="programlisting"> “title” <span class="type">char</span> *</pre>
|
||
<p>The title of the window.</p>
|
||
<p>Owner: GtkWindow</p>
|
||
<p>Flags: Read / Write</p>
|
||
<p>Default value: NULL</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkWindow--transient-for"></a><h3>The <code class="literal">“transient-for”</code> property</h3>
|
||
<pre class="programlisting"> “transient-for” <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *</pre>
|
||
<p>The transient parent of the window. See <a class="link" href="GtkWindow.html#gtk-window-set-transient-for" title="gtk_window_set_transient_for ()"><code class="function">gtk_window_set_transient_for()</code></a> for
|
||
more details about transient windows.</p>
|
||
<p>Owner: GtkWindow</p>
|
||
<p>Flags: Read / Write / Construct</p>
|
||
<p class="since">Since: 2.10</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkWindow--type"></a><h3>The <code class="literal">“type”</code> property</h3>
|
||
<pre class="programlisting"> “type” <a class="link" href="GtkWindow.html#GtkWindowType" title="enum GtkWindowType"><span class="type">GtkWindowType</span></a></pre>
|
||
<p>The type of the window.</p>
|
||
<p>Owner: GtkWindow</p>
|
||
<p>Flags: Read / Write / Construct Only</p>
|
||
<p>Default value: GTK_WINDOW_TOPLEVEL</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkWindow--type-hint"></a><h3>The <code class="literal">“type-hint”</code> property</h3>
|
||
<pre class="programlisting"> “type-hint” <span class="type">GdkWindowTypeHint</span></pre>
|
||
<p>Hint to help the desktop environment understand what kind of window this is and how to treat it.</p>
|
||
<p>Owner: GtkWindow</p>
|
||
<p>Flags: Read / Write</p>
|
||
<p>Default value: GDK_WINDOW_TYPE_HINT_NORMAL</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkWindow--urgency-hint"></a><h3>The <code class="literal">“urgency-hint”</code> property</h3>
|
||
<pre class="programlisting"> “urgency-hint” <span class="type">gboolean</span></pre>
|
||
<p>TRUE if the window should be brought to the user's attention.</p>
|
||
<p>Owner: GtkWindow</p>
|
||
<p>Flags: Read / Write</p>
|
||
<p>Default value: FALSE</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkWindow--window-position"></a><h3>The <code class="literal">“window-position”</code> property</h3>
|
||
<pre class="programlisting"> “window-position” <a class="link" href="GtkWindow.html#GtkWindowPosition" title="enum GtkWindowPosition"><span class="type">GtkWindowPosition</span></a></pre>
|
||
<p>The initial position of the window.</p>
|
||
<p>Owner: GtkWindow</p>
|
||
<p>Flags: Read / Write</p>
|
||
<p>Default value: GTK_WIN_POS_NONE</p>
|
||
</div>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="GtkWindow.style-property-details"></a><h2>Style Property Details</h2>
|
||
<div class="refsect2">
|
||
<a name="GtkWindow--s-decoration-button-layout"></a><h3>The <code class="literal">“decoration-button-layout”</code> style property</h3>
|
||
<pre class="programlisting"> “decoration-button-layout” <span class="type">char</span> *</pre>
|
||
<p>Decorated button layout.</p>
|
||
<p>Owner: GtkWindow</p>
|
||
<p>Flags: Read</p>
|
||
<p>Default value: "menu:close"</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkWindow--s-decoration-resize-handle"></a><h3>The <code class="literal">“decoration-resize-handle”</code> style property</h3>
|
||
<pre class="programlisting"> “decoration-resize-handle” <span class="type">int</span></pre>
|
||
<p>Decoration resize handle size.</p>
|
||
<p>Owner: GtkWindow</p>
|
||
<p>Flags: Read / Write</p>
|
||
<p>Allowed values: >= 0</p>
|
||
<p>Default value: 20</p>
|
||
</div>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="GtkWindow.signal-details"></a><h2>Signal Details</h2>
|
||
<div class="refsect2">
|
||
<a name="GtkWindow-activate-default"></a><h3>The <code class="literal">“activate-default”</code> signal</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
user_function (<a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window,
|
||
<span class="type">gpointer</span> user_data)</pre>
|
||
<p>The ::activate-default signal is a
|
||
<a class="link" href="gtk3-Bindings.html#GtkBindingSignal" title="struct GtkBindingSignal">keybinding signal</a>
|
||
which gets emitted when the user activates the default widget
|
||
of <em class="parameter"><code>window</code></em>
|
||
.</p>
|
||
<div class="refsect3">
|
||
<a name="GtkWindow-activate-default.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>the window which received the signal</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>user_data</p></td>
|
||
<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p>Flags: Action</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkWindow-activate-focus"></a><h3>The <code class="literal">“activate-focus”</code> signal</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
user_function (<a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window,
|
||
<span class="type">gpointer</span> user_data)</pre>
|
||
<p>The ::activate-focus signal is a
|
||
<a class="link" href="gtk3-Bindings.html#GtkBindingSignal" title="struct GtkBindingSignal">keybinding signal</a>
|
||
which gets emitted when the user activates the currently
|
||
focused widget of <em class="parameter"><code>window</code></em>
|
||
.</p>
|
||
<div class="refsect3">
|
||
<a name="GtkWindow-activate-focus.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>the window which received the signal</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>user_data</p></td>
|
||
<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p>Flags: Action</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkWindow-enable-debugging"></a><h3>The <code class="literal">“enable-debugging”</code> signal</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
user_function (<a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window,
|
||
<span class="type">gboolean</span> toggle,
|
||
<span class="type">gpointer</span> user_data)</pre>
|
||
<p>The ::enable-debugging signal is a <a class="link" href="gtk3-Bindings.html#GtkBindingSignal" title="struct GtkBindingSignal">keybinding signal</a>
|
||
which gets emitted when the user enables or disables interactive
|
||
debugging. When <em class="parameter"><code>toggle</code></em>
|
||
is <code class="literal">TRUE</code>, interactive debugging is toggled
|
||
on or off, when it is <code class="literal">FALSE</code>, the debugger will be pointed at the
|
||
widget under the pointer.</p>
|
||
<p>The default bindings for this signal are Ctrl-Shift-I
|
||
and Ctrl-Shift-D.</p>
|
||
<p>Return: <code class="literal">TRUE</code> if the key binding was handled</p>
|
||
<div class="refsect3">
|
||
<a name="GtkWindow-enable-debugging.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>the window on which the signal is emitted</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>toggle</p></td>
|
||
<td class="parameter_description"><p>toggle the debugger</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>user_data</p></td>
|
||
<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p>Flags: Action</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkWindow-keys-changed"></a><h3>The <code class="literal">“keys-changed”</code> signal</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
user_function (<a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window,
|
||
<span class="type">gpointer</span> user_data)</pre>
|
||
<p>The ::keys-changed signal gets emitted when the set of accelerators
|
||
or mnemonics that are associated with <em class="parameter"><code>window</code></em>
|
||
changes.</p>
|
||
<div class="refsect3">
|
||
<a name="GtkWindow-keys-changed.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>the window which received the signal</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>user_data</p></td>
|
||
<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p>Flags: Run First</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkWindow-set-focus"></a><h3>The <code class="literal">“set-focus”</code> signal</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
user_function (<a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window,
|
||
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget,
|
||
<span class="type">gpointer</span> user_data)</pre>
|
||
<p>This signal is emitted whenever the currently focused widget in
|
||
this window changes.</p>
|
||
<div class="refsect3">
|
||
<a name="GtkWindow-set-focus.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>window</p></td>
|
||
<td class="parameter_description"><p>the window which received the signal</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>widget</p></td>
|
||
<td class="parameter_description"><p>the newly focused widget (or <code class="literal">NULL</code> for no focus). </p></td>
|
||
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>user_data</p></td>
|
||
<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p>Flags: Run Last</p>
|
||
<p class="since">Since: 2.24</p>
|
||
</div>
|
||
</div>
|
||
</div>
|
||
<div class="footer">
|
||
<hr>Generated by GTK-Doc V1.33.1</div>
|
||
</body>
|
||
</html> |