<para>
</para>
+<refsect2 id="GtkWindow-BUILDER-UI">
+<title>GtkWindow as GtkBuildable</title>
+<para>
+The GtkWindow implementation of the GtkBuildable interface supports a
+custom <accel-groups> element, which supports any number of <group>
+elements representing the GtkAccelGroup objects you want to add to your
+window (synonymous with gtk_window_add_accel_group().
+</para>
+<example>
+<title>A UI definition fragment with accel groups</title>
+<programlisting><![CDATA[
+<object class="GtkWindow">
+ <accel-groups>
+ <group name="accelgroup1"/>
+ </accel-groups>
+</object>
+
+...
+
+<object class="GtkAccelGroup" id="accelgroup1"/>
+]]></programlisting>
+</example>
+</refsect2>
<!-- ##### SECTION See_Also ##### -->
<para>
<!-- ##### SECTION Stability_Level ##### -->
+<!-- ##### SECTION Image ##### -->
+
+
<!-- ##### STRUCT GtkWindow ##### -->
<para>
@window: the object which received the signal.
-<!-- ##### SIGNAL GtkWindow::move-focus ##### -->
-<para>
-
-</para>
-
-@window: the object which received the signal.
-@arg1:
-
<!-- ##### SIGNAL GtkWindow::set-focus ##### -->
<para>
</para>
+<!-- ##### ARG GtkWindow:mnemonics-visible ##### -->
+<para>
+
+</para>
+
<!-- ##### ARG GtkWindow:modal ##### -->
<para>
</para>
+<!-- ##### ARG GtkWindow:opacity ##### -->
+<para>
+
+</para>
+
<!-- ##### ARG GtkWindow:resizable ##### -->
<para>
</para>
+<!-- ##### ARG GtkWindow:startup-id ##### -->
+<para>
+
+</para>
+
<!-- ##### ARG GtkWindow:title ##### -->
<para>
</para>
+<!-- ##### ARG GtkWindow:transient-for ##### -->
+<para>
+
+</para>
+
<!-- ##### ARG GtkWindow:type ##### -->
<para>
@wmclass_class:
-<!-- ##### FUNCTION gtk_window_set_policy ##### -->
-<para>
-Changes how a toplevel window deals with its size request and user resize
-attempts. There are really only two reasonable ways to call this function:
-<orderedlist>
-<listitem>
-<para>
-<literal>gtk_window_set_policy (GTK_WINDOW (window), FALSE, TRUE, FALSE)</literal>
-means that the window is user-resizable.
-</para>
-</listitem>
-<listitem>
-<para>
-<literal>gtk_window_set_policy (GTK_WINDOW (window), FALSE, FALSE, TRUE)</literal>
-means that the window's size is program-controlled, and should simply match
-the current size request of the window's children.
-</para>
-</listitem>
-</orderedlist>
-The first policy is the default, that is, by default windows are designed to
-be resized by users.
-</para>
-
-<para>
-The basic ugly truth of this function is that it should be simply:
-<literal>
- void gtk_window_set_resizable (GtkWindow* window, gboolean setting);
-</literal>
-...which is why GTK+ 2.0 introduces gtk_window_set_resizable(), which you
-should use instead of gtk_window_set_policy().
-</para>
-
-<para>
-If set to %TRUE, the @allow_grow parameter allows the user to expand the window
-beyond the size request of its child widgets. If @allow_grow is %TRUE, be sure to
-check that your child widgets work properly as the window is resized.
-</para>
-
-<para>
-A toplevel window will always change size to ensure its child widgets receive
-their requested size. This means that if you add child widgets, the toplevel
-window will expand to contain them. However, normally the toplevel will not
-shrink to fit the size request of its children if it's too large; the
-@auto_shrink parameter causes the window to shrink when child widgets have too
-much space. @auto_shrink is normally used with the second of the two window
-policies mentioned above. That is, set @auto_shrink to %TRUE if you want the
-window to have a fixed, always-optimal size determined by your program.
-</para>
-
-<para>
-Note that @auto_shrink doesn't do anything if @allow_shrink and @allow_grow are
-both set to %FALSE.
-</para>
-
-<para>
-Neither of the two suggested window policies set the @allow_shrink parameter to
-%TRUE. If @allow_shrink is %TRUE, the user can shrink the window so that its
-children do not receive their full size request; this is basically a bad thing,
-because most widgets will look wrong if this happens. Furthermore GTK+ has a
-tendency to re-expand the window if size is recalculated for any reason. The
-upshot is that @allow_shrink should always be set to %FALSE.
-</para>
-
-<para>
-Sometimes when you think you want to use @allow_shrink, the real problem is that
-some specific child widget is requesting too much space, so the user can't
-shrink the window sufficiently. Perhaps you are calling gtk_widget_set_size_request()
-on a child widget, and forcing its size request to be too large. Instead of
-setting the child's usize, consider using gtk_window_set_default_size() so that
-the child gets a larger allocation than it requests.
-</para>
-
-@window: the window
-@allow_shrink: whether the user can shrink the window below its size request
-@allow_grow: whether the user can grow the window larger than its size request
-@auto_shrink: whether the window automatically snaps back to its size request
- if it's larger
-@Deprecated: Use gtk_window_set_resizable() instead.
-
-
<!-- ##### FUNCTION gtk_window_set_resizable ##### -->
<para>
@accel_group:
-<!-- ##### MACRO gtk_window_position ##### -->
-<para>
-Deprecated alias for gtk_window_set_position().
-</para>
-
-
-
<!-- ##### FUNCTION gtk_window_activate_focus ##### -->
<para>
</para>
+@void:
@Returns:
@focus:
+<!-- ##### FUNCTION gtk_window_get_default_widget ##### -->
+<para>
+
+</para>
+
+@window:
+@Returns:
+
+
<!-- ##### FUNCTION gtk_window_set_default ##### -->
<para>
@modifier:
-<!-- ##### FUNCTION gtk_window_set_role ##### -->
-<para>
-
-</para>
-
-@window:
-@role:
-
-
<!-- ##### FUNCTION gtk_window_set_type_hint ##### -->
<para>
@setting:
+<!-- ##### FUNCTION gtk_window_set_startup_id ##### -->
+<para>
+
+</para>
+
+@window:
+@startup_id:
+
+
+<!-- ##### FUNCTION gtk_window_set_role ##### -->
+<para>
+
+</para>
+
+@window:
+@role:
+
+
<!-- ##### FUNCTION gtk_window_get_decorated ##### -->
<para>
</para>
+@void:
+@Returns:
+
+
+<!-- ##### FUNCTION gtk_window_get_default_icon_name ##### -->
+<para>
+
+</para>
+
+@void:
@Returns:
@window:
@root_x:
@root_y:
-<!-- # Unused Parameters # -->
-@x:
-@y:
<!-- ##### FUNCTION gtk_window_get_role ##### -->
@Returns:
+<!-- ##### FUNCTION gtk_window_get_group ##### -->
+<para>
+
+</para>
+
+@window:
+@Returns:
+
+
+<!-- ##### FUNCTION gtk_window_get_window_type ##### -->
+<para>
+
+</para>
+
+@window:
+@Returns:
+
+
<!-- ##### FUNCTION gtk_window_move ##### -->
<para>
</para>
@icon:
-<!-- # Unused Parameters # -->
-@pixbuf:
<!-- ##### FUNCTION gtk_window_set_default_icon_from_file ##### -->
@setting:
-<!-- ##### FUNCTION gtk_decorated_window_init ##### -->
+<!-- ##### FUNCTION gtk_window_get_opacity ##### -->
<para>
</para>
@window:
+@Returns:
-<!-- ##### FUNCTION gtk_decorated_window_calculate_frame_size ##### -->
+<!-- ##### FUNCTION gtk_window_set_opacity ##### -->
<para>
</para>
@window:
+@opacity:
-<!-- ##### FUNCTION gtk_decorated_window_set_title ##### -->
+<!-- ##### FUNCTION gtk_window_get_mnemonics_visible ##### -->
<para>
</para>
@window:
-@title:
+@Returns:
-<!-- ##### FUNCTION gtk_decorated_window_move_resize_window ##### -->
+<!-- ##### FUNCTION gtk_window_set_mnemonics_visible ##### -->
<para>
</para>
@window:
-@x:
-@y:
-@width:
-@height:
+@setting:
projects / ~andy / gtk / blobdiff