~ubuntu-branches/ubuntu/quantal/gtkmm3.0/quantal

Otherwise, emits a short beep on the display just as <a class="el" href="classGdk_1_1Display.html#a63ff8a09aa81f2bf1f7581ddba39fe69" title="Emits a short beep on display.">Gdk::Display::beep()</a>.

519

<dl class="since_2_12"><dt><a class="el" href="since_2_12.html#_since_2_12000007">Since gtkmm 2.12:</a></dt><dd></dd></dl>

519

<dl class="since_2_12"><dt><a class="el" href="since_2_12.html#_since_2_12000006">Since gtkmm 2.12:</a></dt><dd></dd></dl>

520

521

</div>

522

</div>

558

559

560

Begins a window move operation (for a toplevel window).

561

You might use this function to implement a "window move grip," for example. The function works best with window managers that support the Extended <a class="el" href="classGdk_1_1Window.html" title="A Gdk::Window is a rectangular region on the screen.">Window</a> Manager Hints, but has a fallback implementation for other window managers.

561

This function assumes that the drag is controlled by the client pointer device, use gdk_window_begin_move_drag_for_device() to begin a drag with a different device.

562

<dl><dt>Parameters:</dt><dd>

563

564

<tr><td class="paramname">button</td><td>The button being used to drag. </td></tr>

670

671

672

Begins a window resize operation (for a toplevel window).

673

You might use this function to implement a "window resize grip," for example; in fact <a class="el" href="classGtk_1_1Statusbar.html" title="Text status indicator This widget is used to display status information.">Gtk::Statusbar</a> uses it. The function works best with window managers that support the Extended <a class="el" href="classGdk_1_1Window.html" title="A Gdk::Window is a rectangular region on the screen.">Window</a> Manager Hints, but has a fallback implementation for other window managers.

673

This function assumes that the drag is controlled by the client pointer device, use gdk_window_begin_resize_drag_for_device() to begin a drag with a different device.

674

<dl><dt>Parameters:</dt><dd>

675

676

<tr><td class="paramname">edge</td><td>The edge or corner from which the drag is started. </td></tr>

701

Signal to the window system that the application has finished handling Configure events it has received.

702

<a class="el" href="classGdk_1_1Window.html" title="A Gdk::Window is a rectangular region on the screen.">Window</a> Managers can use this to better synchronize the frame repaint with the application. GTK+ applications will automatically call this function when appropriate.

703

This function can only be called if <a class="el" href="classGdk_1_1Window.html#a356e4e19207606e91f87346a378e1b1f" title="Indicates that the application will cooperate with the window system in synchronizing the window repa...">enable_synchronized_configure()</a> was called previously.

704

<dl class="since_2_6"><dt><a class="el" href="since_2_6.html#_since_2_6000012">Since gtkmm 2.6:</a></dt><dd></dd></dl>

704

<dl class="since_2_6"><dt><a class="el" href="since_2_6.html#_since_2_6000006">Since gtkmm 2.6:</a></dt><dd></dd></dl>

705

706

</div>

707

</div>

926

927

Creates a <a class="el" href="namespaceGdk_1_1Cairo.html">Cairo</a> context for drawing to drawable.

928

<dl class="return"><dt>Returns:</dt><dd>A newly created <a class="el" href="namespaceGdk_1_1Cairo.html">Cairo</a> context.</dd></dl>

929

<dl class="since_2_10"><dt><a class="el" href="since_2_10.html#_since_2_10000015">Since gtkmm 2.10:</a></dt><dd></dd></dl>

929

<dl class="since_2_10"><dt><a class="el" href="since_2_10.html#_since_2_10000016">Since gtkmm 2.10:</a></dt><dd></dd></dl>

930

931

</div>

932

</div>

1043

Indicates that the application will cooperate with the window system in synchronizing the window repaint with the window manager during resizing operations.

1044

After an application calls this function, it must call <a class="el" href="classGdk_1_1Window.html#aebb7266930dad01675f28abe8e5c4cf1" title="Signal to the window system that the application has finished handling Configure events it has receiv...">configure_finished()</a> every time it has finished all processing associated with a set of Configure events. Toplevel GTK+ windows automatically use this protocol.

1045

On X, calling this function makes window participate in the _NET_WM_SYNC_REQUEST window manager protocol.

1046

<dl class="since_2_6"><dt><a class="el" href="since_2_6.html#_since_2_6000011">Since gtkmm 2.6:</a></dt><dd></dd></dl>

1046

<dl class="since_2_6"><dt><a class="el" href="since_2_6.html#_since_2_6000005">Since gtkmm 2.6:</a></dt><dd></dd></dl>

1047

1048

</div>

1049

</div>

1173

This means the window covers the entire screen and is above any panels or task bars.

1174

If the window was already fullscreen, then this function does nothing.

1175

On X11, asks the window manager to put window in a fullscreen state, if the window manager supports this operation. Not all window managers support this, and some deliberately ignore it or don't have a concept of "fullscreen"; so you can't rely on the fullscreenification actually happening. But it will happen with most standard window managers, and GDK makes a best effort to get it to happen.

1176

<dl class="since_2_2"><dt><a class="el" href="since_2_2.html#_since_2_2000063">Since gtkmm 2.2:</a></dt><dd></dd></dl>

1176

<dl class="since_2_2"><dt><a class="el" href="since_2_2.html#_since_2_2000058">Since gtkmm 2.2:</a></dt><dd></dd></dl>

1177

1178

</div>

1179

</div>

2156

Obtains the current pointer position and modifier state.

2157

The position is given in coordinates relative to the upper left corner of window.

2158

Deprecated: 3.0: Use <a class="el" href="classGdk_1_1Window.html#a37dfbd885e04cc322b1e2e10264894b6" title="Obtains the current device position and modifier state.">get_device_position()</a> instead.

2159

<dl class="deprecated"><dt><a class="el" href="deprecated.html#_deprecated000001">Deprecated:</a></dt><dd>Use <a class="el" href="classGdk_1_1Window.html#a37dfbd885e04cc322b1e2e10264894b6" title="Obtains the current device position and modifier state.">get_device_position()</a> instead </dd></dl>

2159

<dl class="deprecated"><dt><a class="el" href="deprecated.html#_deprecated000002">Deprecated:</a></dt><dd>Use <a class="el" href="classGdk_1_1Window.html#a37dfbd885e04cc322b1e2e10264894b6" title="Obtains the current device position and modifier state.">get_device_position()</a> instead </dd></dl>

2160

<dl><dt>Parameters:</dt><dd>

2161

2162

<tr><td class="paramname">x</td><td>Return location for X coordinate of pointer or <code>0</code> to not return the X coordinate. </td></tr>

2457

2458

2459

This function returns the type hint set for a window.

2460

<dl class="since_2_10"><dt><a class="el" href="since_2_10.html#_since_2_10000014">Since gtkmm 2.10:</a></dt><dd></dd></dl>

2460

<dl class="since_2_10"><dt><a class="el" href="since_2_10.html#_since_2_10000015">Since gtkmm 2.10:</a></dt><dd></dd></dl>

2461

<dl class="return"><dt>Returns:</dt><dd>The type hint set for window. </dd></dl>

2462

2463

</div>

2763

An input shape is typically used with <a class="el" href="classGdk_1_1RGBA.html" title="An RGBA Color.">RGBA</a> windows. The alpha channel of the window defines which pixels are invisible and allows for nicely antialiased borders, and the input shape controls where the window is "clickable".

2764

On the X11 platform, this requires version 1.1 of the shape extension.

2765

On the Win32 platform, this functionality is not present and the function does nothing.

2766

<dl class="since_2_10"><dt><a class="el" href="since_2_10.html#_since_2_10000011">Since gtkmm 2.10:</a></dt><dd></dd></dl>

2766

<dl class="since_2_10"><dt><a class="el" href="since_2_10.html#_since_2_10000012">Since gtkmm 2.10:</a></dt><dd></dd></dl>

2767

<dl><dt>Parameters:</dt><dd>

2768

2769

<tr><td class="paramname">shape_region</td><td>Region of window to be non-transparent. </td></tr>

3015

Merges the input shape masks for any child windows into the input shape mask for window.

3016

i.e. the union of all input masks for window and its children will become the new input mask for window. See <a class="el" href="classGdk_1_1Window.html#aac2c9d614a46435a7812681fd95678d1" title="Like shape_combine_region(), but the shape applies only to event handling.">input_shape_combine_region()</a>.

3017

This function is distinct from <a class="el" href="classGdk_1_1Window.html#a4c4a3eff84349ff97ecf1d24972cc751" title="Sets the input shape mask of window to the union of input shape masks for all children of window...">set_child_input_shapes()</a> because it includes window's input shape mask in the set of shapes to be merged.

3018

<dl class="since_2_10"><dt><a class="el" href="since_2_10.html#_since_2_10000013">Since gtkmm 2.10:</a></dt><dd></dd></dl>

3018

<dl class="since_2_10"><dt><a class="el" href="since_2_10.html#_since_2_10000014">Since gtkmm 2.10:</a></dt><dd></dd></dl>

3019

3020

</div>

3021

</div>

3617

3618

Sets the background color of window.

3619

(However, when using GTK+, set the background of a widget with gtk_widget_modify_bg() - if you're an application - or gtk_style_set_background() - if you're implementing a custom widget.)

3620

See also set_background_pattern().

3620

See also set_background_pattern().

3621

Deprecated: 3.4: Use set_background_rgba() instead.

3622

<dl class="deprecated"><dt><a class="el" href="deprecated.html#_deprecated000001">Deprecated:</a></dt><dd>Use the <a class="el" href="classGdk_1_1Window.html#a3beabdcf6f6f2c36f03288aaba209863" title="Sets the background color of window.">set_background()</a> method that takes a <a class="el" href="classGdk_1_1RGBA.html" title="An RGBA Color.">Gdk::RGBA</a> instead. </dd></dl>

3621

3623

<dl><dt>Parameters:</dt><dd>

3622

3624

3623

3625

<tr><td class="paramname">color</td><td>A <a class="el" href="classGdk_1_1Color.html" title="Gdk::Color is used to describe an allocated or unallocated color.">Gdk::Color</a>. </td></tr>

3643

3645

3644

3646

Sets the input shape mask of window to the union of input shape masks for all children of window, ignoring the input shape mask of window itself.

3645

3647

Contrast with <a class="el" href="classGdk_1_1Window.html#adf4f0442926e39a327843a6b5946e4c5" title="Merges the input shape masks for any child windows into the input shape mask for window.">merge_child_input_shapes()</a> which includes the input shape mask of window in the masks to be merged.

3646

<dl class="since_2_10"><dt><a class="el" href="since_2_10.html#_since_2_10000012">Since gtkmm 2.10:</a></dt><dd></dd></dl>

3648

<dl class="since_2_10"><dt><a class="el" href="since_2_10.html#_since_2_10000013">Since gtkmm 2.10:</a></dt><dd></dd></dl>

3647

3649

3648

3650

</div>

3649

3651

</div>

3686

3688

It only makes sense for child windows to be composited; see <a class="el" href="classGdk_1_1Window.html#af70da6bc12c5997b6cd77f4cd14e5129" title="Request the windowing system to make window partially transparent, with opacity 0 being fully transpa...">set_opacity()</a> if you need translucent toplevel windows.

3687

3689

An additional effect of this call is that the area of this window is no longer clipped from regions marked for invalidation on its parent. Draws done on the parent window are also no longer clipped by the child.

3688

3690

This call is only supported on some systems (currently, only X11 with new enough Xcomposite and Xdamage extensions). You must call <a class="el" href="classGdk_1_1Display.html#aeb030dde7590e1b649f398e99da0c9b3" title="Returns true if Gdk::Window::set_composited() can be used to redirect drawing on the window using com...">Gdk::Display::supports_composite()</a> to check if setting a window as composited is supported before attempting to do so.

3689

<dl class="since_2_12"><dt><a class="el" href="since_2_12.html#_since_2_12000005">Since gtkmm 2.12:</a></dt><dd></dd></dl>

3691

<dl class="since_2_12"><dt><a class="el" href="since_2_12.html#_since_2_12000004">Since gtkmm 2.12:</a></dt><dd></dd></dl>

3690

3692

<dl><dt>Parameters:</dt><dd>

3691

3693

3692

3694

<tr><td class="paramname">composited</td><td><code>true</code> to set the window as composited. </td></tr>

3937

3939

Setting focus_on_map to <code>false</code> hints the desktop environment that the window doesn't want to receive input focus when it is mapped.

3938

3940

focus_on_map should be turned off for windows that aren't triggered interactively (such as popups from network activity).

3939

3941

On X, it is the responsibility of the window manager to interpret this hint. Window managers following the freedesktop.org window manager extension specification should respect it.

3940

<dl class="since_2_6"><dt><a class="el" href="since_2_6.html#_since_2_6000013">Since gtkmm 2.6:</a></dt><dd></dd></dl>

3942

<dl class="since_2_6"><dt><a class="el" href="since_2_6.html#_since_2_6000007">Since gtkmm 2.6:</a></dt><dd></dd></dl>

3941

3943

<dl><dt>Parameters:</dt><dd>

3942

3944

3943

3945

<tr><td class="paramname">focus_on_map</td><td><code>true</code> if the window should receive input focus when mapped. </td></tr>

4194

4196

4195

4197

4196

4198

Sets window to be embedded in embedder.

4197

To fully embed an offscreen window, in addition to calling this function, it is also necessary to handle the Gdk::Window::pick-embedded-child signal on the embedder and the Gdk::Window::to-embedder and Gdk::Window::from-embedder signals on window.

4199

To fully embed an offscreen window, in addition to calling this function, it is also necessary to handle the Gdk::Window::signal_pick_embedded_child() signal on the embedder and the Gdk::Window::signal_to_embedder() and Gdk::Window::signal_from_embedder() signals on window.

4198

4200

<dl class="since_2_18"><dt><a class="el" href="since_2_18.html#_since_2_18000010">Since gtkmm 2.18:</a></dt><dd></dd></dl>

4199

4201

<dl><dt>Parameters:</dt><dd>

4200

4202

4225

4227

(Values of the opacity parameter are clamped to the [0,1] range.)

4226

4228

On X11, this works only on X screens with a compositing manager running.

4227

4229

For setting up per-pixel alpha, see <a class="el" href="classGdk_1_1Screen.html#a20af3907afd8fc3098b0c9a34062c1d0" title="Gets a visual to use for creating windows with an alpha channel.">Gdk::Screen::get_rgba_visual()</a>. For making non-toplevel windows translucent, see <a class="el" href="classGdk_1_1Window.html#aba9d5bea3de05b31eff0da2bed753db8" title="Sets a Gdk::Window as composited, or unsets it.">set_composited()</a>.

4228

<dl class="since_2_12"><dt><a class="el" href="since_2_12.html#_since_2_12000008">Since gtkmm 2.12:</a></dt><dd></dd></dl>

4230

<dl class="since_2_12"><dt><a class="el" href="since_2_12.html#_since_2_12000007">Since gtkmm 2.12:</a></dt><dd></dd></dl>

4229

4231

<dl><dt>Parameters:</dt><dd>

4230

4232

4231

4233

<tr><td class="paramname">opacity</td><td>Opacity. </td></tr>

4305

4307

4306

4308

Toggles whether a window should appear in a pager (workspace switcher, or other desktop utility program that displays a small thumbnail representation of the windows on the desktop).

4307

4309

If a window's semantic type as specified with <a class="el" href="classGdk_1_1Window.html#a4505331d1882e0e02d076782ddfaa2ff" title="The application can use this call to provide a hint to the window manager about the functionality of ...">set_type_hint()</a> already fully describes the window, this function should not be called in addition, instead you should allow the window to be treated according to standard policy for its semantic type.

4308

<dl class="since_2_2"><dt><a class="el" href="since_2_2.html#_since_2_2000062">Since gtkmm 2.2:</a></dt><dd></dd></dl>

4310

<dl class="since_2_2"><dt><a class="el" href="since_2_2.html#_since_2_2000057">Since gtkmm 2.2:</a></dt><dd></dd></dl>

4309

4311

<dl><dt>Parameters:</dt><dd>

4310

4312

4311

4313

<tr><td class="paramname">skips_pager</td><td><code>true</code> to skip the pager. </td></tr>

4332

4334

4333

4335

Toggles whether a window should appear in a task list or window list.

4334

4336

4335

<dl class="since_2_2"><dt><a class="el" href="since_2_2.html#_since_2_2000061">Since gtkmm 2.2:</a></dt><dd></dd></dl>

4337

<dl class="since_2_2"><dt><a class="el" href="since_2_2.html#_since_2_2000056">Since gtkmm 2.2:</a></dt><dd></dd></dl>

4336

4338

<dl><dt>Parameters:</dt><dd>

4337

4339

4338

4340

<tr><td class="paramname">skips_taskbar</td><td><code>true</code> to skip the taskbar. </td></tr>

4396

4398

4397

4399

4398

4400

When using GTK+, typically you should use gtk_window_set_startup_id() instead of this low-level function.

4399

<dl class="since_2_12"><dt><a class="el" href="since_2_12.html#_since_2_12000006">Since gtkmm 2.12:</a></dt><dd></dd></dl>

4401

<dl class="since_2_12"><dt><a class="el" href="since_2_12.html#_since_2_12000005">Since gtkmm 2.12:</a></dt><dd></dd></dl>

4400

4402

<dl><dt>Parameters:</dt><dd>

4401

4403

4402

4404

<tr><td class="paramname">startup_id</td><td>A string with startup-notification identifier. </td></tr>

4733

4735

Moves the window out of fullscreen mode.

4734

4736

If the window was not fullscreen, does nothing.

4735

4737

On X11, asks the window manager to move window out of the fullscreen state, if the window manager supports this operation. Not all window managers support this, and some deliberately ignore it or don't have a concept of "fullscreen"; so you can't rely on the unfullscreenification actually happening. But it will happen with most standard window managers, and GDK makes a best effort to get it to happen.

4736

<dl class="since_2_2"><dt><a class="el" href="since_2_2.html#_since_2_2000064">Since gtkmm 2.2:</a></dt><dd></dd></dl>

4738

<dl class="since_2_2"><dt><a class="el" href="since_2_2.html#_since_2_2000059">Since gtkmm 2.2:</a></dt><dd></dd></dl>

4737

4739

4738

4740

</div>

4739

4741

</div>

4853

4855

<li>gdkmm/window.h</li>

4854

4856

</ul>

4855

4857

</div>

4856

<hr class="footer"/><address class="footer">Generated on Tue Feb 7 2012 10:44:06 for gtkmm by

4858

<hr class="footer"/><address class="footer">Generated on Tue Feb 28 2012 10:01:53 for gtkmm by

4857

4859

4858

4860

4859

4861

</body>

Older »