9639 lines
483 KiB
HTML
9639 lines
483 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>Windows: GDK 3 Reference Manual</title>
|
||
<meta name="generator" content="DocBook XSL Stylesheets Vsnapshot">
|
||
<link rel="home" href="index.html" title="GDK 3 Reference Manual">
|
||
<link rel="up" href="reference.html" title="API Reference">
|
||
<link rel="prev" href="gdk3-Cursors.html" title="Cursors">
|
||
<link rel="next" href="GdkFrameClock.html" title="Frame clock">
|
||
<meta name="generator" content="GTK-Doc V1.29 (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="#gdk3-Windows.description" class="shortcut">Description</a></span><span id="nav_hierarchy"> <span class="dim">|</span>
|
||
<a href="#gdk3-Windows.object-hierarchy" class="shortcut">Object Hierarchy</a></span><span id="nav_properties"> <span class="dim">|</span>
|
||
<a href="#gdk3-Windows.properties" class="shortcut">Properties</a></span><span id="nav_signals"> <span class="dim">|</span>
|
||
<a href="#gdk3-Windows.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="reference.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
|
||
<td><a accesskey="p" href="gdk3-Cursors.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
|
||
<td><a accesskey="n" href="GdkFrameClock.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
|
||
</tr></table>
|
||
<div class="refentry">
|
||
<a name="gdk3-Windows"></a><div class="titlepage"></div>
|
||
<div class="refnamediv"><table width="100%"><tr>
|
||
<td valign="top">
|
||
<h2><span class="refentrytitle"><a name="gdk3-Windows.top_of_page"></a>Windows</span></h2>
|
||
<p>Windows — Onscreen display areas in the target window system</p>
|
||
</td>
|
||
<td class="gallery_image" valign="top" align="right"></td>
|
||
</tr></table></div>
|
||
<div class="refsect1">
|
||
<a name="gdk3-Windows.functions"></a><h2>Functions</h2>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="functions_return">
|
||
<col class="functions_name">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="function_type">
|
||
<a class="link" href="gdk3-Windows.html#GdkWindow"><span class="returnvalue">GdkWindow</span></a> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="gdk3-Windows.html#gdk-window-new" title="gdk_window_new ()">gdk_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="gdk3-Windows.html#gdk-window-destroy" title="gdk_window_destroy ()">gdk_window_destroy</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<a class="link" href="gdk3-Windows.html#GdkWindowType" title="enum GdkWindowType"><span class="returnvalue">GdkWindowType</span></a>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="gdk3-Windows.html#gdk-window-get-window-type" title="gdk_window_get_window_type ()">gdk_window_get_window_type</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<a class="link" href="GdkDisplay.html" title="GdkDisplay"><span class="returnvalue">GdkDisplay</span></a> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="gdk3-Windows.html#gdk-window-get-display" title="gdk_window_get_display ()">gdk_window_get_display</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<a class="link" href="GdkScreen.html" title="GdkScreen"><span class="returnvalue">GdkScreen</span></a> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="gdk3-Windows.html#gdk-window-get-screen" title="gdk_window_get_screen ()">gdk_window_get_screen</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<a class="link" href="gdk3-Visuals.html#GdkVisual"><span class="returnvalue">GdkVisual</span></a> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="gdk3-Windows.html#gdk-window-get-visual" title="gdk_window_get_visual ()">gdk_window_get_visual</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<a class="link" href="gdk3-Windows.html#GdkWindow"><span class="returnvalue">GdkWindow</span></a> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="gdk3-Windows.html#gdk-window-at-pointer" title="gdk_window_at_pointer ()">gdk_window_at_pointer</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="gdk3-Windows.html#gdk-window-show" title="gdk_window_show ()">gdk_window_show</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="gdk3-Windows.html#gdk-window-show-unraised" title="gdk_window_show_unraised ()">gdk_window_show_unraised</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="gdk3-Windows.html#gdk-window-hide" title="gdk_window_hide ()">gdk_window_hide</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="gdk3-Windows.html#gdk-window-is-destroyed" title="gdk_window_is_destroyed ()">gdk_window_is_destroyed</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="gdk3-Windows.html#gdk-window-is-visible" title="gdk_window_is_visible ()">gdk_window_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="gdk3-Windows.html#gdk-window-is-viewable" title="gdk_window_is_viewable ()">gdk_window_is_viewable</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="gdk3-Windows.html#gdk-window-is-input-only" title="gdk_window_is_input_only ()">gdk_window_is_input_only</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="gdk3-Windows.html#gdk-window-is-shaped" title="gdk_window_is_shaped ()">gdk_window_is_shaped</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<a class="link" href="gdk3-Event-Structures.html#GdkWindowState" title="enum GdkWindowState"><span class="returnvalue">GdkWindowState</span></a>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="gdk3-Windows.html#gdk-window-get-state" title="gdk_window_get_state ()">gdk_window_get_state</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="gdk3-Windows.html#gdk-window-withdraw" title="gdk_window_withdraw ()">gdk_window_withdraw</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="gdk3-Windows.html#gdk-window-iconify" title="gdk_window_iconify ()">gdk_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="gdk3-Windows.html#gdk-window-deiconify" title="gdk_window_deiconify ()">gdk_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="gdk3-Windows.html#gdk-window-stick" title="gdk_window_stick ()">gdk_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="gdk3-Windows.html#gdk-window-unstick" title="gdk_window_unstick ()">gdk_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="gdk3-Windows.html#gdk-window-maximize" title="gdk_window_maximize ()">gdk_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="gdk3-Windows.html#gdk-window-unmaximize" title="gdk_window_unmaximize ()">gdk_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="gdk3-Windows.html#gdk-window-fullscreen" title="gdk_window_fullscreen ()">gdk_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="gdk3-Windows.html#gdk-window-fullscreen-on-monitor" title="gdk_window_fullscreen_on_monitor ()">gdk_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="gdk3-Windows.html#gdk-window-unfullscreen" title="gdk_window_unfullscreen ()">gdk_window_unfullscreen</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<a class="link" href="gdk3-Windows.html#GdkFullscreenMode" title="enum GdkFullscreenMode"><span class="returnvalue">GdkFullscreenMode</span></a>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="gdk3-Windows.html#gdk-window-get-fullscreen-mode" title="gdk_window_get_fullscreen_mode ()">gdk_window_get_fullscreen_mode</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="gdk3-Windows.html#gdk-window-set-fullscreen-mode" title="gdk_window_set_fullscreen_mode ()">gdk_window_set_fullscreen_mode</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="gdk3-Windows.html#gdk-window-set-keep-above" title="gdk_window_set_keep_above ()">gdk_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="gdk3-Windows.html#gdk-window-set-keep-below" title="gdk_window_set_keep_below ()">gdk_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="gdk3-Windows.html#gdk-window-set-opacity" title="gdk_window_set_opacity ()">gdk_window_set_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="gdk3-Windows.html#gdk-window-set-composited" title="gdk_window_set_composited ()">gdk_window_set_composited</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="gdk3-Windows.html#gdk-window-get-composited" title="gdk_window_get_composited ()">gdk_window_get_composited</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="gdk3-Windows.html#gdk-window-set-pass-through" title="gdk_window_set_pass_through ()">gdk_window_set_pass_through</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="gdk3-Windows.html#gdk-window-get-pass-through" title="gdk_window_get_pass_through ()">gdk_window_get_pass_through</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="gdk3-Windows.html#gdk-window-move" title="gdk_window_move ()">gdk_window_move</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="gdk3-Windows.html#gdk-window-resize" title="gdk_window_resize ()">gdk_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="gdk3-Windows.html#gdk-window-move-resize" title="gdk_window_move_resize ()">gdk_window_move_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="gdk3-Windows.html#gdk-window-scroll" title="gdk_window_scroll ()">gdk_window_scroll</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="gdk3-Windows.html#gdk-window-move-to-rect" title="gdk_window_move_to_rect ()">gdk_window_move_to_rect</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="gdk3-Windows.html#gdk-window-move-region" title="gdk_window_move_region ()">gdk_window_move_region</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="gdk3-Windows.html#gdk-window-flush" title="gdk_window_flush ()">gdk_window_flush</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="gdk3-Windows.html#gdk-window-has-native" title="gdk_window_has_native ()">gdk_window_has_native</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="gdk3-Windows.html#gdk-window-ensure-native" title="gdk_window_ensure_native ()">gdk_window_ensure_native</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="gdk3-Windows.html#gdk-window-reparent" title="gdk_window_reparent ()">gdk_window_reparent</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="gdk3-Windows.html#gdk-window-raise" title="gdk_window_raise ()">gdk_window_raise</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="gdk3-Windows.html#gdk-window-lower" title="gdk_window_lower ()">gdk_window_lower</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="gdk3-Windows.html#gdk-window-restack" title="gdk_window_restack ()">gdk_window_restack</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="gdk3-Windows.html#gdk-window-focus" title="gdk_window_focus ()">gdk_window_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="gdk3-Windows.html#gdk-window-register-dnd" title="gdk_window_register_dnd ()">gdk_window_register_dnd</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="gdk3-Windows.html#gdk-window-begin-resize-drag" title="gdk_window_begin_resize_drag ()">gdk_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="gdk3-Windows.html#gdk-window-begin-resize-drag-for-device" title="gdk_window_begin_resize_drag_for_device ()">gdk_window_begin_resize_drag_for_device</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="gdk3-Windows.html#gdk-window-begin-move-drag" title="gdk_window_begin_move_drag ()">gdk_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="gdk3-Windows.html#gdk-window-begin-move-drag-for-device" title="gdk_window_begin_move_drag_for_device ()">gdk_window_begin_move_drag_for_device</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="gdk3-Windows.html#gdk-window-show-window-menu" title="gdk_window_show_window_menu ()">gdk_window_show_window_menu</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="gdk3-Windows.html#gdk-window-constrain-size" title="gdk_window_constrain_size ()">gdk_window_constrain_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="gdk3-Windows.html#gdk-window-beep" title="gdk_window_beep ()">gdk_window_beep</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gint</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="gdk3-Windows.html#gdk-window-get-scale-factor" title="gdk_window_get_scale_factor ()">gdk_window_get_scale_factor</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="gdk3-Windows.html#gdk-window-set-opaque-region" title="gdk_window_set_opaque_region ()">gdk_window_set_opaque_region</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<a class="link" href="GdkGLContext.html" title="GdkGLContext"><span class="returnvalue">GdkGLContext</span></a> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="gdk3-Windows.html#gdk-window-create-gl-context" title="gdk_window_create_gl_context ()">gdk_window_create_gl_context</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="gdk3-Windows.html#gdk-window-mark-paint-from-clip" title="gdk_window_mark_paint_from_clip ()">gdk_window_mark_paint_from_clip</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<a href="/usr/share/gtk-doc/html/cairo/cairo-Regions.html#cairo-region-t"><span class="returnvalue">cairo_region_t</span></a> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="gdk3-Windows.html#gdk-window-get-clip-region" title="gdk_window_get_clip_region ()">gdk_window_get_clip_region</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="gdk3-Windows.html#gdk-window-begin-paint-rect" title="gdk_window_begin_paint_rect ()">gdk_window_begin_paint_rect</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="gdk3-Windows.html#gdk-window-begin-paint-region" title="gdk_window_begin_paint_region ()">gdk_window_begin_paint_region</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="gdk3-Windows.html#gdk-window-end-paint" title="gdk_window_end_paint ()">gdk_window_end_paint</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<a class="link" href="GdkDrawingContext.html" title="GdkDrawingContext"><span class="returnvalue">GdkDrawingContext</span></a> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="gdk3-Windows.html#gdk-window-begin-draw-frame" title="gdk_window_begin_draw_frame ()">gdk_window_begin_draw_frame</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="gdk3-Windows.html#gdk-window-end-draw-frame" title="gdk_window_end_draw_frame ()">gdk_window_end_draw_frame</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<a href="/usr/share/gtk-doc/html/cairo/cairo-Regions.html#cairo-region-t"><span class="returnvalue">cairo_region_t</span></a> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="gdk3-Windows.html#gdk-window-get-visible-region" title="gdk_window_get_visible_region ()">gdk_window_get_visible_region</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<span class="c_punctuation">(</span><a class="link" href="gdk3-Windows.html#GdkWindowInvalidateHandlerFunc" title="GdkWindowInvalidateHandlerFunc ()">*GdkWindowInvalidateHandlerFunc</a><span class="c_punctuation">)</span> <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="gdk3-Windows.html#gdk-window-set-invalidate-handler" title="gdk_window_set_invalidate_handler ()">gdk_window_set_invalidate_handler</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="gdk3-Windows.html#gdk-window-invalidate-rect" title="gdk_window_invalidate_rect ()">gdk_window_invalidate_rect</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="gdk3-Windows.html#gdk-window-invalidate-region" title="gdk_window_invalidate_region ()">gdk_window_invalidate_region</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<span class="c_punctuation">(</span><a class="link" href="gdk3-Windows.html#GdkWindowChildFunc" title="GdkWindowChildFunc ()">*GdkWindowChildFunc</a><span class="c_punctuation">)</span> <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="gdk3-Windows.html#gdk-window-invalidate-maybe-recurse" title="gdk_window_invalidate_maybe_recurse ()">gdk_window_invalidate_maybe_recurse</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<a href="/usr/share/gtk-doc/html/cairo/cairo-Regions.html#cairo-region-t"><span class="returnvalue">cairo_region_t</span></a> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="gdk3-Windows.html#gdk-window-get-update-area" title="gdk_window_get_update_area ()">gdk_window_get_update_area</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="gdk3-Windows.html#gdk-window-freeze-updates" title="gdk_window_freeze_updates ()">gdk_window_freeze_updates</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="gdk3-Windows.html#gdk-window-thaw-updates" title="gdk_window_thaw_updates ()">gdk_window_thaw_updates</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="gdk3-Windows.html#gdk-window-process-all-updates" title="gdk_window_process_all_updates ()">gdk_window_process_all_updates</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="gdk3-Windows.html#gdk-window-process-updates" title="gdk_window_process_updates ()">gdk_window_process_updates</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="gdk3-Windows.html#gdk-window-set-debug-updates" title="gdk_window_set_debug_updates ()">gdk_window_set_debug_updates</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="gdk3-Windows.html#gdk-window-enable-synchronized-configure" title="gdk_window_enable_synchronized_configure ()">gdk_window_enable_synchronized_configure</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="gdk3-Windows.html#gdk-window-configure-finished" title="gdk_window_configure_finished ()">gdk_window_configure_finished</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<a class="link" href="GdkFrameClock.html" title="Frame clock"><span class="returnvalue">GdkFrameClock</span></a> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="gdk3-Windows.html#gdk-window-get-frame-clock" title="gdk_window_get_frame_clock ()">gdk_window_get_frame_clock</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="gdk3-Windows.html#gdk-window-set-user-data" title="gdk_window_set_user_data ()">gdk_window_set_user_data</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="gdk3-Windows.html#gdk-window-set-override-redirect" title="gdk_window_set_override_redirect ()">gdk_window_set_override_redirect</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="gdk3-Windows.html#gdk-window-set-accept-focus" title="gdk_window_set_accept_focus ()">gdk_window_set_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="gdk3-Windows.html#gdk-window-get-accept-focus" title="gdk_window_get_accept_focus ()">gdk_window_get_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="gdk3-Windows.html#gdk-window-set-focus-on-map" title="gdk_window_set_focus_on_map ()">gdk_window_set_focus_on_map</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="gdk3-Windows.html#gdk-window-get-focus-on-map" title="gdk_window_get_focus_on_map ()">gdk_window_get_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="gdk3-Windows.html#gdk-window-add-filter" title="gdk_window_add_filter ()">gdk_window_add_filter</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="gdk3-Windows.html#gdk-window-remove-filter" title="gdk_window_remove_filter ()">gdk_window_remove_filter</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<a class="link" href="gdk3-Windows.html#GdkFilterReturn" title="enum GdkFilterReturn"><span class="returnvalue">GdkFilterReturn</span></a>
|
||
</td>
|
||
<td class="function_name">
|
||
<span class="c_punctuation">(</span><a class="link" href="gdk3-Windows.html#GdkFilterFunc" title="GdkFilterFunc ()">*GdkFilterFunc</a><span class="c_punctuation">)</span> <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="gdk3-Windows.html#gdk-window-shape-combine-region" title="gdk_window_shape_combine_region ()">gdk_window_shape_combine_region</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="gdk3-Windows.html#gdk-window-set-child-shapes" title="gdk_window_set_child_shapes ()">gdk_window_set_child_shapes</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="gdk3-Windows.html#gdk-window-merge-child-shapes" title="gdk_window_merge_child_shapes ()">gdk_window_merge_child_shapes</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="gdk3-Windows.html#gdk-window-input-shape-combine-region" title="gdk_window_input_shape_combine_region ()">gdk_window_input_shape_combine_region</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="gdk3-Windows.html#gdk-window-set-child-input-shapes" title="gdk_window_set_child_input_shapes ()">gdk_window_set_child_input_shapes</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="gdk3-Windows.html#gdk-window-merge-child-input-shapes" title="gdk_window_merge_child_input_shapes ()">gdk_window_merge_child_input_shapes</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="gdk3-Windows.html#gdk-window-set-static-gravities" title="gdk_window_set_static_gravities ()">gdk_window_set_static_gravities</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="gdk3-Windows.html#gdk-window-set-title" title="gdk_window_set_title ()">gdk_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="gdk3-Windows.html#gdk-window-set-background" title="gdk_window_set_background ()">gdk_window_set_background</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="gdk3-Windows.html#gdk-window-set-background-rgba" title="gdk_window_set_background_rgba ()">gdk_window_set_background_rgba</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="gdk3-Windows.html#gdk-window-set-background-pattern" title="gdk_window_set_background_pattern ()">gdk_window_set_background_pattern</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<a href="/usr/share/gtk-doc/html/cairo/cairo-cairo-pattern-t.html#cairo-pattern-t"><span class="returnvalue">cairo_pattern_t</span></a> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="gdk3-Windows.html#gdk-window-get-background-pattern" title="gdk_window_get_background_pattern ()">gdk_window_get_background_pattern</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="gdk3-Windows.html#gdk-window-set-cursor" title="gdk_window_set_cursor ()">gdk_window_set_cursor</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<a class="link" href="gdk3-Cursors.html#GdkCursor"><span class="returnvalue">GdkCursor</span></a> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="gdk3-Windows.html#gdk-window-get-cursor" title="gdk_window_get_cursor ()">gdk_window_get_cursor</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="gdk3-Windows.html#gdk-window-get-user-data" title="gdk_window_get_user_data ()">gdk_window_get_user_data</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="gdk3-Windows.html#gdk-window-get-geometry" title="gdk_window_get_geometry ()">gdk_window_get_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="gdk3-Windows.html#gdk-window-set-geometry-hints" title="gdk_window_set_geometry_hints ()">gdk_window_set_geometry_hints</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">int</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="gdk3-Windows.html#gdk-window-get-width" title="gdk_window_get_width ()">gdk_window_get_width</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">int</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="gdk3-Windows.html#gdk-window-get-height" title="gdk_window_get_height ()">gdk_window_get_height</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="gdk3-Windows.html#gdk-window-set-icon-list" title="gdk_window_set_icon_list ()">gdk_window_set_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="gdk3-Windows.html#gdk-window-set-modal-hint" title="gdk_window_set_modal_hint ()">gdk_window_set_modal_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="gdk3-Windows.html#gdk-window-get-modal-hint" title="gdk_window_get_modal_hint ()">gdk_window_get_modal_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="gdk3-Windows.html#gdk-window-set-type-hint" title="gdk_window_set_type_hint ()">gdk_window_set_type_hint</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<a class="link" href="gdk3-Windows.html#GdkWindowTypeHint" title="enum GdkWindowTypeHint"><span class="returnvalue">GdkWindowTypeHint</span></a>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="gdk3-Windows.html#gdk-window-get-type-hint" title="gdk_window_get_type_hint ()">gdk_window_get_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="gdk3-Windows.html#gdk-window-set-shadow-width" title="gdk_window_set_shadow_width ()">gdk_window_set_shadow_width</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="gdk3-Windows.html#gdk-window-set-skip-taskbar-hint" title="gdk_window_set_skip_taskbar_hint ()">gdk_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="gdk3-Windows.html#gdk-window-set-skip-pager-hint" title="gdk_window_set_skip_pager_hint ()">gdk_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="gdk3-Windows.html#gdk-window-set-urgency-hint" title="gdk_window_set_urgency_hint ()">gdk_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="gdk3-Windows.html#gdk-window-get-position" title="gdk_window_get_position ()">gdk_window_get_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="gdk3-Windows.html#gdk-window-get-root-origin" title="gdk_window_get_root_origin ()">gdk_window_get_root_origin</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="gdk3-Windows.html#gdk-window-get-frame-extents" title="gdk_window_get_frame_extents ()">gdk_window_get_frame_extents</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gint</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="gdk3-Windows.html#gdk-window-get-origin" title="gdk_window_get_origin ()">gdk_window_get_origin</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="gdk3-Windows.html#gdk-window-get-root-coords" title="gdk_window_get_root_coords ()">gdk_window_get_root_coords</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<a class="link" href="gdk3-Windows.html#GdkWindow"><span class="returnvalue">GdkWindow</span></a> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="gdk3-Windows.html#gdk-window-get-pointer" title="gdk_window_get_pointer ()">gdk_window_get_pointer</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<a class="link" href="gdk3-Windows.html#GdkWindow"><span class="returnvalue">GdkWindow</span></a> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="gdk3-Windows.html#gdk-window-get-device-position" title="gdk_window_get_device_position ()">gdk_window_get_device_position</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<a class="link" href="gdk3-Windows.html#GdkWindow"><span class="returnvalue">GdkWindow</span></a> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="gdk3-Windows.html#gdk-window-get-device-position-double" title="gdk_window_get_device_position_double ()">gdk_window_get_device_position_double</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<a class="link" href="gdk3-Windows.html#GdkWindow"><span class="returnvalue">GdkWindow</span></a> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="gdk3-Windows.html#gdk-window-get-parent" title="gdk_window_get_parent ()">gdk_window_get_parent</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<a class="link" href="gdk3-Windows.html#GdkWindow"><span class="returnvalue">GdkWindow</span></a> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="gdk3-Windows.html#gdk-window-get-toplevel" title="gdk_window_get_toplevel ()">gdk_window_get_toplevel</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="gdk3-Windows.html#gdk-window-get-children" title="gdk_window_get_children ()">gdk_window_get_children</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="gdk3-Windows.html#gdk-window-get-children-with-user-data" title="gdk_window_get_children_with_user_data ()">gdk_window_get_children_with_user_data</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="gdk3-Windows.html#gdk-window-peek-children" title="gdk_window_peek_children ()">gdk_window_peek_children</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<a class="link" href="gdk3-Events.html#GdkEventMask" title="enum GdkEventMask"><span class="returnvalue">GdkEventMask</span></a>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="gdk3-Windows.html#gdk-window-get-events" title="gdk_window_get_events ()">gdk_window_get_events</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="gdk3-Windows.html#gdk-window-set-events" title="gdk_window_set_events ()">gdk_window_set_events</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="gdk3-Windows.html#gdk-window-set-icon-name" title="gdk_window_set_icon_name ()">gdk_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="gdk3-Windows.html#gdk-window-set-transient-for" title="gdk_window_set_transient_for ()">gdk_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="gdk3-Windows.html#gdk-window-set-role" title="gdk_window_set_role ()">gdk_window_set_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="gdk3-Windows.html#gdk-window-set-startup-id" title="gdk_window_set_startup_id ()">gdk_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="gdk3-Windows.html#gdk-window-set-group" title="gdk_window_set_group ()">gdk_window_set_group</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<a class="link" href="gdk3-Windows.html#GdkWindow"><span class="returnvalue">GdkWindow</span></a> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="gdk3-Windows.html#gdk-window-get-group" title="gdk_window_get_group ()">gdk_window_get_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="gdk3-Windows.html#gdk-window-set-decorations" title="gdk_window_set_decorations ()">gdk_window_set_decorations</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="gdk3-Windows.html#gdk-window-get-decorations" title="gdk_window_get_decorations ()">gdk_window_get_decorations</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="gdk3-Windows.html#gdk-window-set-functions" title="gdk_window_set_functions ()">gdk_window_set_functions</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<a class="link" href="gdk3-Windows.html#GdkWindow"><span class="returnvalue">GdkWindow</span></a> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="gdk3-Windows.html#gdk-get-default-root-window" title="gdk_get_default_root_window ()">gdk_get_default_root_window</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="gdk3-Windows.html#gdk-window-get-support-multidevice" title="gdk_window_get_support_multidevice ()">gdk_window_get_support_multidevice</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="gdk3-Windows.html#gdk-window-set-support-multidevice" title="gdk_window_set_support_multidevice ()">gdk_window_set_support_multidevice</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<a class="link" href="gdk3-Cursors.html#GdkCursor"><span class="returnvalue">GdkCursor</span></a> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="gdk3-Windows.html#gdk-window-get-device-cursor" title="gdk_window_get_device_cursor ()">gdk_window_get_device_cursor</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="gdk3-Windows.html#gdk-window-set-device-cursor" title="gdk_window_set_device_cursor ()">gdk_window_set_device_cursor</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<a class="link" href="gdk3-Events.html#GdkEventMask" title="enum GdkEventMask"><span class="returnvalue">GdkEventMask</span></a>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="gdk3-Windows.html#gdk-window-get-device-events" title="gdk_window_get_device_events ()">gdk_window_get_device_events</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="gdk3-Windows.html#gdk-window-set-device-events" title="gdk_window_set_device_events ()">gdk_window_set_device_events</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<a class="link" href="gdk3-Events.html#GdkEventMask" title="enum GdkEventMask"><span class="returnvalue">GdkEventMask</span></a>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="gdk3-Windows.html#gdk-window-get-source-events" title="gdk_window_get_source_events ()">gdk_window_get_source_events</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="gdk3-Windows.html#gdk-window-set-source-events" title="gdk_window_set_source_events ()">gdk_window_set_source_events</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="gdk3-Windows.html#gdk-window-get-event-compression" title="gdk_window_get_event_compression ()">gdk_window_get_event_compression</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="gdk3-Windows.html#gdk-window-set-event-compression" title="gdk_window_set_event_compression ()">gdk_window_set_event_compression</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<a href="/usr/share/gtk-doc/html/cairo/cairo-cairo-surface-t.html#cairo-surface-t"><span class="returnvalue">cairo_surface_t</span></a> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="gdk3-Windows.html#gdk-offscreen-window-get-surface" title="gdk_offscreen_window_get_surface ()">gdk_offscreen_window_get_surface</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="gdk3-Windows.html#gdk-offscreen-window-set-embedder" title="gdk_offscreen_window_set_embedder ()">gdk_offscreen_window_set_embedder</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<a class="link" href="gdk3-Windows.html#GdkWindow"><span class="returnvalue">GdkWindow</span></a> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="gdk3-Windows.html#gdk-offscreen-window-get-embedder" title="gdk_offscreen_window_get_embedder ()">gdk_offscreen_window_get_embedder</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="gdk3-Windows.html#gdk-window-geometry-changed" title="gdk_window_geometry_changed ()">gdk_window_geometry_changed</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="gdk3-Windows.html#gdk-window-coords-from-parent" title="gdk_window_coords_from_parent ()">gdk_window_coords_from_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="gdk3-Windows.html#gdk-window-coords-to-parent" title="gdk_window_coords_to_parent ()">gdk_window_coords_to_parent</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<a class="link" href="gdk3-Windows.html#GdkWindow"><span class="returnvalue">GdkWindow</span></a> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="gdk3-Windows.html#gdk-window-get-effective-parent" title="gdk_window_get_effective_parent ()">gdk_window_get_effective_parent</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<a class="link" href="gdk3-Windows.html#GdkWindow"><span class="returnvalue">GdkWindow</span></a> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="gdk3-Windows.html#gdk-window-get-effective-toplevel" title="gdk_window_get_effective_toplevel ()">gdk_window_get_effective_toplevel</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="gdk3-Windows.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">
|
||
<a class="link" href="gdk3-Cursors.html#GdkCursor"><span class="type">GdkCursor</span></a> *</td>
|
||
<td class="property_name"><a class="link" href="gdk3-Windows.html#GdkWindow--cursor" title="The “cursor” property">cursor</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="gdk3-Windows.signals"></a><h2>Signals</h2>
|
||
<div class="informaltable"><table class="informaltable" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="signals_return">
|
||
<col width="300px" class="signals_name">
|
||
<col width="200px" class="signals_flags">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="signal_type">
|
||
<span class="returnvalue">CairoSurface</span>*</td>
|
||
<td class="signal_name"><a class="link" href="gdk3-Windows.html#GdkWindow-create-surface" title="The “create-surface” signal">create-surface</a></td>
|
||
<td class="signal_flags">Run Last</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="signal_type"><span class="returnvalue">void</span></td>
|
||
<td class="signal_name"><a class="link" href="gdk3-Windows.html#GdkWindow-from-embedder" title="The “from-embedder” signal">from-embedder</a></td>
|
||
<td class="signal_flags">Run Last</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="signal_type"><span class="returnvalue">void</span></td>
|
||
<td class="signal_name"><a class="link" href="gdk3-Windows.html#GdkWindow-moved-to-rect" title="The “moved-to-rect” signal">moved-to-rect</a></td>
|
||
<td class="signal_flags">Run First</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="signal_type">
|
||
<a class="link" href="gdk3-Windows.html#GdkWindow"><span class="returnvalue">GdkWindow</span></a>*</td>
|
||
<td class="signal_name"><a class="link" href="gdk3-Windows.html#GdkWindow-pick-embedded-child" title="The “pick-embedded-child” signal">pick-embedded-child</a></td>
|
||
<td class="signal_flags">Run Last</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="signal_type"><span class="returnvalue">void</span></td>
|
||
<td class="signal_name"><a class="link" href="gdk3-Windows.html#GdkWindow-to-embedder" title="The “to-embedder” signal">to-embedder</a></td>
|
||
<td class="signal_flags">Run Last</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<a name="GdkWindow"></a><div class="refsect1">
|
||
<a name="gdk3-Windows.other"></a><h2>Types and Values</h2>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="name">
|
||
<col class="description">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="datatype_keyword"> </td>
|
||
<td class="function_name"><a class="link" href="gdk3-Windows.html#GdkWindow-struct" title="GdkWindow">GdkWindow</a></td>
|
||
</tr>
|
||
<tr>
|
||
<td class="datatype_keyword">enum</td>
|
||
<td class="function_name"><a class="link" href="gdk3-Windows.html#GdkWindowType" title="enum GdkWindowType">GdkWindowType</a></td>
|
||
</tr>
|
||
<tr>
|
||
<td class="datatype_keyword">enum</td>
|
||
<td class="function_name"><a class="link" href="gdk3-Windows.html#GdkWindowWindowClass" title="enum GdkWindowWindowClass">GdkWindowWindowClass</a></td>
|
||
</tr>
|
||
<tr>
|
||
<td class="datatype_keyword">enum</td>
|
||
<td class="function_name"><a class="link" href="gdk3-Windows.html#GdkWindowHints" title="enum GdkWindowHints">GdkWindowHints</a></td>
|
||
</tr>
|
||
<tr>
|
||
<td class="datatype_keyword">struct</td>
|
||
<td class="function_name"><a class="link" href="gdk3-Windows.html#GdkGeometry" title="struct GdkGeometry">GdkGeometry</a></td>
|
||
</tr>
|
||
<tr>
|
||
<td class="datatype_keyword">enum</td>
|
||
<td class="function_name"><a class="link" href="gdk3-Windows.html#GdkGravity" title="enum GdkGravity">GdkGravity</a></td>
|
||
</tr>
|
||
<tr>
|
||
<td class="datatype_keyword">enum</td>
|
||
<td class="function_name"><a class="link" href="gdk3-Windows.html#GdkAnchorHints" title="enum GdkAnchorHints">GdkAnchorHints</a></td>
|
||
</tr>
|
||
<tr>
|
||
<td class="datatype_keyword">enum</td>
|
||
<td class="function_name"><a class="link" href="gdk3-Windows.html#GdkWindowEdge" title="enum GdkWindowEdge">GdkWindowEdge</a></td>
|
||
</tr>
|
||
<tr>
|
||
<td class="datatype_keyword">enum</td>
|
||
<td class="function_name"><a class="link" href="gdk3-Windows.html#GdkWindowTypeHint" title="enum GdkWindowTypeHint">GdkWindowTypeHint</a></td>
|
||
</tr>
|
||
<tr>
|
||
<td class="datatype_keyword">struct</td>
|
||
<td class="function_name"><a class="link" href="gdk3-Windows.html#GdkWindowAttr" title="struct GdkWindowAttr">GdkWindowAttr</a></td>
|
||
</tr>
|
||
<tr>
|
||
<td class="datatype_keyword">enum</td>
|
||
<td class="function_name"><a class="link" href="gdk3-Windows.html#GdkWindowAttributesType" title="enum GdkWindowAttributesType">GdkWindowAttributesType</a></td>
|
||
</tr>
|
||
<tr>
|
||
<td class="datatype_keyword">enum</td>
|
||
<td class="function_name"><a class="link" href="gdk3-Windows.html#GdkFullscreenMode" title="enum GdkFullscreenMode">GdkFullscreenMode</a></td>
|
||
</tr>
|
||
<tr>
|
||
<td class="datatype_keyword">enum</td>
|
||
<td class="function_name"><a class="link" href="gdk3-Windows.html#GdkFilterReturn" title="enum GdkFilterReturn">GdkFilterReturn</a></td>
|
||
</tr>
|
||
<tr>
|
||
<td class="typedef_keyword">typedef</td>
|
||
<td class="function_name"><a class="link" href="gdk3-Windows.html#GdkXEvent" title="GdkXEvent">GdkXEvent</a></td>
|
||
</tr>
|
||
<tr>
|
||
<td class="define_keyword">#define</td>
|
||
<td class="function_name"><a class="link" href="gdk3-Windows.html#GDK-PARENT-RELATIVE:CAPS" title="GDK_PARENT_RELATIVE">GDK_PARENT_RELATIVE</a></td>
|
||
</tr>
|
||
<tr>
|
||
<td class="datatype_keyword">enum</td>
|
||
<td class="function_name"><a class="link" href="gdk3-Windows.html#GdkModifierType" title="enum GdkModifierType">GdkModifierType</a></td>
|
||
</tr>
|
||
<tr>
|
||
<td class="datatype_keyword">enum</td>
|
||
<td class="function_name"><a class="link" href="gdk3-Windows.html#GdkModifierIntent" title="enum GdkModifierIntent">GdkModifierIntent</a></td>
|
||
</tr>
|
||
<tr>
|
||
<td class="datatype_keyword">enum</td>
|
||
<td class="function_name"><a class="link" href="gdk3-Windows.html#GdkWMDecoration" title="enum GdkWMDecoration">GdkWMDecoration</a></td>
|
||
</tr>
|
||
<tr>
|
||
<td class="datatype_keyword">enum</td>
|
||
<td class="function_name"><a class="link" href="gdk3-Windows.html#GdkWMFunction" title="enum GdkWMFunction">GdkWMFunction</a></td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="gdk3-Windows.object-hierarchy"></a><h2>Object Hierarchy</h2>
|
||
<pre class="screen"> GObject
|
||
<span class="lineart">╰──</span> GdkWindow
|
||
</pre>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="gdk3-Windows.includes"></a><h2>Includes</h2>
|
||
<pre class="synopsis">#include <gdk/gdk.h>
|
||
</pre>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="gdk3-Windows.description"></a><h2>Description</h2>
|
||
<p>A <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> is a (usually) rectangular region on the screen.
|
||
It’s a low-level object, used to implement high-level objects such as
|
||
<span class="type">GtkWidget</span> and <span class="type">GtkWindow</span> on the GTK+ level. A <span class="type">GtkWindow</span> is a toplevel
|
||
window, the thing a user might think of as a “window” with a titlebar
|
||
and so on; a <span class="type">GtkWindow</span> may contain many <a href="gdk3-Windows.html#GdkWindow-struct"><span class="type">GdkWindows</span></a>. For example,
|
||
each <span class="type">GtkButton</span> has a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> associated with it.</p>
|
||
<div class="refsect2">
|
||
<a name="COMPOSITED-WINDOWS"></a><h3>Composited Windows</h3>
|
||
<p>Normally, the windowing system takes care of rendering the contents
|
||
of a child window onto its parent window. This mechanism can be
|
||
intercepted by calling <a class="link" href="gdk3-Windows.html#gdk-window-set-composited" title="gdk_window_set_composited ()"><code class="function">gdk_window_set_composited()</code></a> on the child
|
||
window. For a “composited” window it is the
|
||
responsibility of the application to render the window contents at
|
||
the right spot.</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="OFFSCREEN-WINDOWS"></a><h3>Offscreen Windows</h3>
|
||
<p>Offscreen windows are more general than composited windows, since
|
||
they allow not only to modify the rendering of the child window onto
|
||
its parent, but also to apply coordinate transformations.</p>
|
||
<p>To integrate an offscreen window into a window hierarchy, one has
|
||
to call <a class="link" href="gdk3-Windows.html#gdk-offscreen-window-set-embedder" title="gdk_offscreen_window_set_embedder ()"><code class="function">gdk_offscreen_window_set_embedder()</code></a> and handle a number of
|
||
signals. The <a class="link" href="gdk3-Windows.html#GdkWindow-pick-embedded-child" title="The “pick-embedded-child” signal"><span class="type">“pick-embedded-child”</span></a> signal on the embedder
|
||
window is used to select an offscreen child at given coordinates,
|
||
and the <a class="link" href="gdk3-Windows.html#GdkWindow-to-embedder" title="The “to-embedder” signal"><span class="type">“to-embedder”</span></a> and <a class="link" href="gdk3-Windows.html#GdkWindow-from-embedder" title="The “from-embedder” signal"><span class="type">“from-embedder”</span></a> signals
|
||
on the offscreen window are used to translate coordinates between
|
||
the embedder and the offscreen window.</p>
|
||
<p>For rendering an offscreen window onto its embedder, the contents
|
||
of the offscreen window are available as a surface, via
|
||
<a class="link" href="gdk3-Windows.html#gdk-offscreen-window-get-surface" title="gdk_offscreen_window_get_surface ()"><code class="function">gdk_offscreen_window_get_surface()</code></a>.</p>
|
||
</div>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="gdk3-Windows.functions_details"></a><h2>Functions</h2>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-new"></a><h3>gdk_window_new ()</h3>
|
||
<pre class="programlisting"><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="returnvalue">GdkWindow</span></a> *
|
||
gdk_window_new (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *parent</code></em>,
|
||
<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindowAttr" title="struct GdkWindowAttr"><span class="type">GdkWindowAttr</span></a> *attributes</code></em>,
|
||
<em class="parameter"><code><span class="type">gint</span> attributes_mask</code></em>);</pre>
|
||
<p>Creates a new <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> using the attributes from
|
||
<em class="parameter"><code>attributes</code></em>
|
||
. See <a class="link" href="gdk3-Windows.html#GdkWindowAttr" title="struct GdkWindowAttr"><span class="type">GdkWindowAttr</span></a> and <a class="link" href="gdk3-Windows.html#GdkWindowAttributesType" title="enum GdkWindowAttributesType"><span class="type">GdkWindowAttributesType</span></a> for
|
||
more details. Note: to use this on displays other than the default
|
||
display, <em class="parameter"><code>parent</code></em>
|
||
must be specified.</p>
|
||
<p><span class="annotation">[<acronym title="This symbol is a constructor, not a static method."><span class="acronym">constructor</span></acronym>]</span></p>
|
||
<div class="refsect3">
|
||
<a name="gdk-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>parent</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a>, or <code class="literal">NULL</code> to create the window as a child of
|
||
the default root window for the default display. </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>attributes</p></td>
|
||
<td class="parameter_description"><p>attributes of the new window</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>attributes_mask</p></td>
|
||
<td class="parameter_description"><p>mask indicating which
|
||
fields in <em class="parameter"><code>attributes</code></em>
|
||
are valid. </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> GdkWindowAttributesType]</span></td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-new.returns"></a><h4>Returns</h4>
|
||
<p>the new <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a>. </p>
|
||
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-destroy"></a><h3>gdk_window_destroy ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gdk_window_destroy (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre>
|
||
<p>Destroys the window system resources associated with <em class="parameter"><code>window</code></em>
|
||
and decrements <em class="parameter"><code>window</code></em>
|
||
's
|
||
reference count. The window system resources for all children of <em class="parameter"><code>window</code></em>
|
||
are also
|
||
destroyed, but the children’s reference counts are not decremented.</p>
|
||
<p>Note that a window will not be destroyed automatically when its reference count
|
||
reaches zero. You must call this function yourself before that happens.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-destroy.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="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-get-window-type"></a><h3>gdk_window_get_window_type ()</h3>
|
||
<pre class="programlisting"><a class="link" href="gdk3-Windows.html#GdkWindowType" title="enum GdkWindowType"><span class="returnvalue">GdkWindowType</span></a>
|
||
gdk_window_get_window_type (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre>
|
||
<p>Gets the type of the window. See <a class="link" href="gdk3-Windows.html#GdkWindowType" title="enum GdkWindowType"><span class="type">GdkWindowType</span></a>.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-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="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-get-window-type.returns"></a><h4>Returns</h4>
|
||
<p> type of window</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-get-display"></a><h3>gdk_window_get_display ()</h3>
|
||
<pre class="programlisting"><a class="link" href="GdkDisplay.html" title="GdkDisplay"><span class="returnvalue">GdkDisplay</span></a> *
|
||
gdk_window_get_display (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre>
|
||
<p>Gets the <a class="link" href="GdkDisplay.html" title="GdkDisplay"><span class="type">GdkDisplay</span></a> associated with a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a>.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-get-display.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="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-get-display.returns"></a><h4>Returns</h4>
|
||
<p>the <a class="link" href="GdkDisplay.html" title="GdkDisplay"><span class="type">GdkDisplay</span></a> associated with <em class="parameter"><code>window</code></em>
|
||
. </p>
|
||
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
|
||
</div>
|
||
<p class="since">Since: 2.24</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-get-screen"></a><h3>gdk_window_get_screen ()</h3>
|
||
<pre class="programlisting"><a class="link" href="GdkScreen.html" title="GdkScreen"><span class="returnvalue">GdkScreen</span></a> *
|
||
gdk_window_get_screen (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre>
|
||
<p>Gets the <a class="link" href="GdkScreen.html" title="GdkScreen"><span class="type">GdkScreen</span></a> associated with a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a>.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-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="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-get-screen.returns"></a><h4>Returns</h4>
|
||
<p>the <a class="link" href="GdkScreen.html" title="GdkScreen"><span class="type">GdkScreen</span></a> associated with <em class="parameter"><code>window</code></em>
|
||
. </p>
|
||
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
|
||
</div>
|
||
<p class="since">Since: 2.24</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-get-visual"></a><h3>gdk_window_get_visual ()</h3>
|
||
<pre class="programlisting"><a class="link" href="gdk3-Visuals.html#GdkVisual"><span class="returnvalue">GdkVisual</span></a> *
|
||
gdk_window_get_visual (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre>
|
||
<p>Gets the <a class="link" href="gdk3-Visuals.html#GdkVisual"><span class="type">GdkVisual</span></a> describing the pixel format of <em class="parameter"><code>window</code></em>
|
||
.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-get-visual.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="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-get-visual.returns"></a><h4>Returns</h4>
|
||
<p>a <a class="link" href="gdk3-Visuals.html#GdkVisual"><span class="type">GdkVisual</span></a>. </p>
|
||
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
|
||
</div>
|
||
<p class="since">Since: 2.24</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-at-pointer"></a><h3>gdk_window_at_pointer ()</h3>
|
||
<pre class="programlisting"><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="returnvalue">GdkWindow</span></a> *
|
||
gdk_window_at_pointer (<em class="parameter"><code><span class="type">gint</span> *win_x</code></em>,
|
||
<em class="parameter"><code><span class="type">gint</span> *win_y</code></em>);</pre>
|
||
<div class="warning">
|
||
<p><code class="literal">gdk_window_at_pointer</code> has been deprecated since version 3.0 and should not be used in newly-written code.</p>
|
||
<p>Use <a class="link" href="GdkDevice.html#gdk-device-get-window-at-position" title="gdk_device_get_window_at_position ()"><code class="function">gdk_device_get_window_at_position()</code></a> instead.</p>
|
||
</div>
|
||
<p>Obtains the window underneath the mouse pointer, returning the
|
||
location of that window in <em class="parameter"><code>win_x</code></em>
|
||
, <em class="parameter"><code>win_y</code></em>
|
||
. Returns <code class="literal">NULL</code> if the
|
||
window under the mouse pointer is not known to GDK (if the window
|
||
belongs to another application and a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> hasn’t been created
|
||
for it with <code class="function">gdk_window_foreign_new()</code>)</p>
|
||
<p>NOTE: For multihead-aware widgets or applications use
|
||
<a class="link" href="GdkDisplay.html#gdk-display-get-window-at-pointer" title="gdk_display_get_window_at_pointer ()"><code class="function">gdk_display_get_window_at_pointer()</code></a> instead.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-at-pointer.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>win_x</p></td>
|
||
<td class="parameter_description"><p>return location for origin of the window under the pointer. </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>win_y</p></td>
|
||
<td class="parameter_description"><p>return location for origin of the window under the pointer. </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 class="refsect3">
|
||
<a name="gdk-window-at-pointer.returns"></a><h4>Returns</h4>
|
||
<p>window under the mouse pointer. </p>
|
||
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-show"></a><h3>gdk_window_show ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gdk_window_show (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre>
|
||
<p>Like <a class="link" href="gdk3-Windows.html#gdk-window-show-unraised" title="gdk_window_show_unraised ()"><code class="function">gdk_window_show_unraised()</code></a>, but also raises the window to the
|
||
top of the window stack (moves the window to the front of the
|
||
Z-order).</p>
|
||
<p>This function maps a window so it’s visible onscreen. Its opposite
|
||
is <a class="link" href="gdk3-Windows.html#gdk-window-hide" title="gdk_window_hide ()"><code class="function">gdk_window_hide()</code></a>.</p>
|
||
<p>When implementing a <span class="type">GtkWidget</span>, you should call this function on the widget's
|
||
<a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> as part of the “map” method.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-show.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="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-show-unraised"></a><h3>gdk_window_show_unraised ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gdk_window_show_unraised (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre>
|
||
<p>Shows a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> onscreen, but does not modify its stacking
|
||
order. In contrast, <a class="link" href="gdk3-Windows.html#gdk-window-show" title="gdk_window_show ()"><code class="function">gdk_window_show()</code></a> will raise the window
|
||
to the top of the window stack.</p>
|
||
<p>On the X11 platform, in Xlib terms, this function calls
|
||
<code class="function">XMapWindow()</code> (it also updates some internal GDK state, which means
|
||
that you can’t really use <code class="function">XMapWindow()</code> directly on a GDK window).</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-show-unraised.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="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-hide"></a><h3>gdk_window_hide ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gdk_window_hide (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre>
|
||
<p>For toplevel windows, withdraws them, so they will no longer be
|
||
known to the window manager; for all windows, unmaps them, so
|
||
they won’t be displayed. Normally done automatically as
|
||
part of <code class="function">gtk_widget_hide()</code>.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-hide.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="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-is-destroyed"></a><h3>gdk_window_is_destroyed ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gdk_window_is_destroyed (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre>
|
||
<p>Check to see if a window is destroyed..</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-is-destroyed.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="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-is-destroyed.returns"></a><h4>Returns</h4>
|
||
<p> <code class="literal">TRUE</code> if the window is destroyed</p>
|
||
</div>
|
||
<p class="since">Since: 2.18</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-is-visible"></a><h3>gdk_window_is_visible ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gdk_window_is_visible (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre>
|
||
<p>Checks whether the window has been mapped (with <a class="link" href="gdk3-Windows.html#gdk-window-show" title="gdk_window_show ()"><code class="function">gdk_window_show()</code></a> or
|
||
<a class="link" href="gdk3-Windows.html#gdk-window-show-unraised" title="gdk_window_show_unraised ()"><code class="function">gdk_window_show_unraised()</code></a>).</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-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="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-is-visible.returns"></a><h4>Returns</h4>
|
||
<p> <code class="literal">TRUE</code> if the window is mapped</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-is-viewable"></a><h3>gdk_window_is_viewable ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gdk_window_is_viewable (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre>
|
||
<p>Check if the window and all ancestors of the window are
|
||
mapped. (This is not necessarily "viewable" in the X sense, since
|
||
we only check as far as we have GDK window parents, not to the root
|
||
window.)</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-is-viewable.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="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-is-viewable.returns"></a><h4>Returns</h4>
|
||
<p> <code class="literal">TRUE</code> if the window is viewable</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-is-input-only"></a><h3>gdk_window_is_input_only ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gdk_window_is_input_only (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre>
|
||
<p>Determines whether or not the window is an input only window.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-is-input-only.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 toplevel <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-is-input-only.returns"></a><h4>Returns</h4>
|
||
<p> <code class="literal">TRUE</code> if <em class="parameter"><code>window</code></em>
|
||
is input only</p>
|
||
</div>
|
||
<p class="since">Since: 2.22</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-is-shaped"></a><h3>gdk_window_is_shaped ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gdk_window_is_shaped (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre>
|
||
<p>Determines whether or not the window is shaped.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-is-shaped.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 toplevel <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-is-shaped.returns"></a><h4>Returns</h4>
|
||
<p> <code class="literal">TRUE</code> if <em class="parameter"><code>window</code></em>
|
||
is shaped</p>
|
||
</div>
|
||
<p class="since">Since: 2.22</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-get-state"></a><h3>gdk_window_get_state ()</h3>
|
||
<pre class="programlisting"><a class="link" href="gdk3-Event-Structures.html#GdkWindowState" title="enum GdkWindowState"><span class="returnvalue">GdkWindowState</span></a>
|
||
gdk_window_get_state (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre>
|
||
<p>Gets the bitwise OR of the currently active window state flags,
|
||
from the <a class="link" href="gdk3-Event-Structures.html#GdkWindowState" title="enum GdkWindowState"><span class="type">GdkWindowState</span></a> enumeration.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-get-state.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="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-get-state.returns"></a><h4>Returns</h4>
|
||
<p> window state bitfield</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-withdraw"></a><h3>gdk_window_withdraw ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gdk_window_withdraw (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre>
|
||
<p>Withdraws a window (unmaps it and asks the window manager to forget about it).
|
||
This function is not really useful as <a class="link" href="gdk3-Windows.html#gdk-window-hide" title="gdk_window_hide ()"><code class="function">gdk_window_hide()</code></a> automatically
|
||
withdraws toplevel windows before hiding them.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-withdraw.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 toplevel <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-iconify"></a><h3>gdk_window_iconify ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gdk_window_iconify (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre>
|
||
<p>Asks to iconify (minimize) <em class="parameter"><code>window</code></em>
|
||
. The window manager may choose
|
||
to ignore the request, but normally will honor it. Using
|
||
<code class="function">gtk_window_iconify()</code> is preferred, if you have a <span class="type">GtkWindow</span> widget.</p>
|
||
<p>This function only makes sense when <em class="parameter"><code>window</code></em>
|
||
is a toplevel window.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-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 toplevel <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-deiconify"></a><h3>gdk_window_deiconify ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gdk_window_deiconify (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre>
|
||
<p>Attempt to deiconify (unminimize) <em class="parameter"><code>window</code></em>
|
||
. On X11 the window manager may
|
||
choose to ignore the request to deiconify. When using GTK+,
|
||
use <code class="function">gtk_window_deiconify()</code> instead of the <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> variant. Or better yet,
|
||
you probably want to use <code class="function">gtk_window_present_with_time()</code>, which raises the window, focuses it,
|
||
unminimizes it, and puts it on the current desktop.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-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 toplevel <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-stick"></a><h3>gdk_window_stick ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gdk_window_stick (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre>
|
||
<p>“Pins” a window such that it’s on all workspaces and does not scroll
|
||
with viewports, for window managers that have scrollable viewports.
|
||
(When using <span class="type">GtkWindow</span>, <code class="function">gtk_window_stick()</code> may be more useful.)</p>
|
||
<p>On the X11 platform, this function depends on window manager
|
||
support, so may have no effect with many window managers. However,
|
||
GDK will do the best it can to convince the window manager to stick
|
||
the window. For window managers that don’t support this operation,
|
||
there’s nothing you can do to force it to happen.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-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 toplevel <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-unstick"></a><h3>gdk_window_unstick ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gdk_window_unstick (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre>
|
||
<p>Reverse operation for <a class="link" href="gdk3-Windows.html#gdk-window-stick" title="gdk_window_stick ()"><code class="function">gdk_window_stick()</code></a>; see <a class="link" href="gdk3-Windows.html#gdk-window-stick" title="gdk_window_stick ()"><code class="function">gdk_window_stick()</code></a>,
|
||
and <code class="function">gtk_window_unstick()</code>.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-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 toplevel <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-maximize"></a><h3>gdk_window_maximize ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gdk_window_maximize (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre>
|
||
<p>Maximizes the window. If the window was already maximized, then
|
||
this function does nothing.</p>
|
||
<p>On X11, asks the window manager to maximize <em class="parameter"><code>window</code></em>
|
||
, 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
|
||
“maximized”; so you can’t rely on the maximization actually
|
||
happening. But it will happen with most standard window managers,
|
||
and GDK makes a best effort to get it to happen.</p>
|
||
<p>On Windows, reliably maximizes the window.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-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 toplevel <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-unmaximize"></a><h3>gdk_window_unmaximize ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gdk_window_unmaximize (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre>
|
||
<p>Unmaximizes the window. If the window wasn’t maximized, then this
|
||
function does nothing.</p>
|
||
<p>On X11, asks the window manager to unmaximize <em class="parameter"><code>window</code></em>
|
||
, 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 “maximized”; so you can’t rely on the unmaximization
|
||
actually happening. But it will happen with most standard window
|
||
managers, and GDK makes a best effort to get it to happen.</p>
|
||
<p>On Windows, reliably unmaximizes the window.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-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 toplevel <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-fullscreen"></a><h3>gdk_window_fullscreen ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gdk_window_fullscreen (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre>
|
||
<p>Moves the window into fullscreen mode. This means the
|
||
window covers the entire screen and is above any panels
|
||
or task bars.</p>
|
||
<p>If the window was already fullscreen, then this function does nothing.</p>
|
||
<p>On X11, asks the window manager to put <em class="parameter"><code>window</code></em>
|
||
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.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-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 toplevel <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</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="gdk-window-fullscreen-on-monitor"></a><h3>gdk_window_fullscreen_on_monitor ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gdk_window_fullscreen_on_monitor (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><span class="type">gint</span> monitor</code></em>);</pre>
|
||
<p>Moves the window into fullscreen mode on the given monitor. This means
|
||
the window covers the entire screen and is above any panels or task bars.</p>
|
||
<p>If the window was already fullscreen, then this function does nothing.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-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 toplevel <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></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 display fullscreen on.</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: UNRELEASED</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-unfullscreen"></a><h3>gdk_window_unfullscreen ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gdk_window_unfullscreen (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre>
|
||
<p>Moves the window out of fullscreen mode. If the window was not
|
||
fullscreen, does nothing.</p>
|
||
<p>On X11, asks the window manager to move <em class="parameter"><code>window</code></em>
|
||
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.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-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 toplevel <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</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="gdk-window-get-fullscreen-mode"></a><h3>gdk_window_get_fullscreen_mode ()</h3>
|
||
<pre class="programlisting"><a class="link" href="gdk3-Windows.html#GdkFullscreenMode" title="enum GdkFullscreenMode"><span class="returnvalue">GdkFullscreenMode</span></a>
|
||
gdk_window_get_fullscreen_mode (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre>
|
||
<p>Obtains the <a class="link" href="gdk3-Windows.html#GdkFullscreenMode" title="enum GdkFullscreenMode"><span class="type">GdkFullscreenMode</span></a> of the <em class="parameter"><code>window</code></em>
|
||
.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-get-fullscreen-mode.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 toplevel <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-get-fullscreen-mode.returns"></a><h4>Returns</h4>
|
||
<p> The <a class="link" href="gdk3-Windows.html#GdkFullscreenMode" title="enum GdkFullscreenMode"><span class="type">GdkFullscreenMode</span></a> applied to the window when fullscreen.</p>
|
||
</div>
|
||
<p class="since">Since: <a class="link" href="api-index-3-8.html#api-index-3.8">3.8</a></p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-set-fullscreen-mode"></a><h3>gdk_window_set_fullscreen_mode ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gdk_window_set_fullscreen_mode (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkFullscreenMode" title="enum GdkFullscreenMode"><span class="type">GdkFullscreenMode</span></a> mode</code></em>);</pre>
|
||
<p>Specifies whether the <em class="parameter"><code>window</code></em>
|
||
should span over all monitors (in a multi-head
|
||
setup) or only the current monitor when in fullscreen mode.</p>
|
||
<p>The <em class="parameter"><code>mode</code></em>
|
||
argument is from the <a class="link" href="gdk3-Windows.html#GdkFullscreenMode" title="enum GdkFullscreenMode"><span class="type">GdkFullscreenMode</span></a> enumeration.
|
||
If <a class="link" href="gdk3-Windows.html#GDK-FULLSCREEN-ON-ALL-MONITORS:CAPS"><span class="type">GDK_FULLSCREEN_ON_ALL_MONITORS</span></a> is specified, the fullscreen <em class="parameter"><code>window</code></em>
|
||
will
|
||
span over all monitors from the <a class="link" href="GdkScreen.html" title="GdkScreen"><span class="type">GdkScreen</span></a>.</p>
|
||
<p>On X11, searches through the list of monitors from the <a class="link" href="GdkScreen.html" title="GdkScreen"><span class="type">GdkScreen</span></a> the ones
|
||
which delimit the 4 edges of the entire <a class="link" href="GdkScreen.html" title="GdkScreen"><span class="type">GdkScreen</span></a> and will ask the window
|
||
manager to span the <em class="parameter"><code>window</code></em>
|
||
over these monitors.</p>
|
||
<p>If the XINERAMA extension is not available or not usable, this function
|
||
has no effect.</p>
|
||
<p>Not all window managers support this, so you can’t rely on the fullscreen
|
||
window to span over the multiple monitors when <a class="link" href="gdk3-Windows.html#GDK-FULLSCREEN-ON-ALL-MONITORS:CAPS"><span class="type">GDK_FULLSCREEN_ON_ALL_MONITORS</span></a>
|
||
is specified.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-set-fullscreen-mode.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 toplevel <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>mode</p></td>
|
||
<td class="parameter_description"><p>fullscreen mode</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: <a class="link" href="api-index-3-8.html#api-index-3.8">3.8</a></p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-set-keep-above"></a><h3>gdk_window_set_keep_above ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gdk_window_set_keep_above (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><span class="type">gboolean</span> setting</code></em>);</pre>
|
||
<p>Set if <em class="parameter"><code>window</code></em>
|
||
must be kept above other windows. If the
|
||
window was already above, then this function does nothing.</p>
|
||
<p>On X11, asks the window manager to keep <em class="parameter"><code>window</code></em>
|
||
above, 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
|
||
“keep above”; so you can’t rely on the window being kept above.
|
||
But it will happen with most standard window managers,
|
||
and GDK makes a best effort to get it to happen.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-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 toplevel <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</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="gdk-window-set-keep-below"></a><h3>gdk_window_set_keep_below ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gdk_window_set_keep_below (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><span class="type">gboolean</span> setting</code></em>);</pre>
|
||
<p>Set if <em class="parameter"><code>window</code></em>
|
||
must be kept below other windows. If the
|
||
window was already below, then this function does nothing.</p>
|
||
<p>On X11, asks the window manager to keep <em class="parameter"><code>window</code></em>
|
||
below, 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
|
||
“keep below”; so you can’t rely on the window being kept below.
|
||
But it will happen with most standard window managers,
|
||
and GDK makes a best effort to get it to happen.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-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 toplevel <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</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="gdk-window-set-opacity"></a><h3>gdk_window_set_opacity ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gdk_window_set_opacity (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><span class="type">gdouble</span> opacity</code></em>);</pre>
|
||
<p>Set <em class="parameter"><code>window</code></em>
|
||
to render as partially transparent,
|
||
with opacity 0 being fully transparent and 1 fully opaque. (Values
|
||
of the opacity parameter are clamped to the [0,1] range.) </p>
|
||
<p>For toplevel windows this depends on support from the windowing system
|
||
that may not always be there. For instance, On X11, this works only on
|
||
X screens with a compositing manager running. On Wayland, there is no
|
||
per-window opacity value that the compositor would apply. Instead, use
|
||
<code class="literal">gdk_window_set_opaque_region (window, NULL)</code> to tell the compositor
|
||
that the entire window is (potentially) non-opaque, and draw your content
|
||
with alpha, or use <code class="function">gtk_widget_set_opacity()</code> to set an overall opacity
|
||
for your widgets.</p>
|
||
<p>For child windows this function only works for non-native windows.</p>
|
||
<p>For setting up per-pixel alpha topelevels, see <a class="link" href="GdkScreen.html#gdk-screen-get-rgba-visual" title="gdk_screen_get_rgba_visual ()"><code class="function">gdk_screen_get_rgba_visual()</code></a>,
|
||
and for non-toplevels, see <a class="link" href="gdk3-Windows.html#gdk-window-set-composited" title="gdk_window_set_composited ()"><code class="function">gdk_window_set_composited()</code></a>.</p>
|
||
<p>Support for non-toplevel windows was added in 3.8.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-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 top-level or non-native <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>opacity</p></td>
|
||
<td class="parameter_description"><p>opacity</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="gdk-window-set-composited"></a><h3>gdk_window_set_composited ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gdk_window_set_composited (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><span class="type">gboolean</span> composited</code></em>);</pre>
|
||
<div class="warning">
|
||
<p><code class="literal">gdk_window_set_composited</code> has been deprecated since version 3.16 and should not be used in newly-written code.</p>
|
||
<p>Compositing is an outdated technology that
|
||
only ever worked on X11.</p>
|
||
</div>
|
||
<p>Sets a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> as composited, or unsets it. Composited
|
||
windows do not automatically have their contents drawn to
|
||
the screen. Drawing is redirected to an offscreen buffer
|
||
and an expose event is emitted on the parent of the composited
|
||
window. It is the responsibility of the parent’s expose handler
|
||
to manually merge the off-screen content onto the screen in
|
||
whatever way it sees fit.</p>
|
||
<p>It only makes sense for child windows to be composited; see
|
||
<a class="link" href="gdk3-Windows.html#gdk-window-set-opacity" title="gdk_window_set_opacity ()"><code class="function">gdk_window_set_opacity()</code></a> if you need translucent toplevel
|
||
windows.</p>
|
||
<p>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.</p>
|
||
<p>This call is only supported on some systems (currently,
|
||
only X11 with new enough Xcomposite and Xdamage extensions).
|
||
You must call <a class="link" href="GdkDisplay.html#gdk-display-supports-composite" title="gdk_display_supports_composite ()"><code class="function">gdk_display_supports_composite()</code></a> to check if
|
||
setting a window as composited is supported before
|
||
attempting to do so.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-set-composited.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="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>composited</p></td>
|
||
<td class="parameter_description"><p><code class="literal">TRUE</code> to set the window as composited</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="gdk-window-get-composited"></a><h3>gdk_window_get_composited ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gdk_window_get_composited (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre>
|
||
<div class="warning">
|
||
<p><code class="literal">gdk_window_get_composited</code> has been deprecated since version 3.16 and should not be used in newly-written code.</p>
|
||
<p>Compositing is an outdated technology that
|
||
only ever worked on X11.</p>
|
||
</div>
|
||
<p>Determines whether <em class="parameter"><code>window</code></em>
|
||
is composited.</p>
|
||
<p>See <a class="link" href="gdk3-Windows.html#gdk-window-set-composited" title="gdk_window_set_composited ()"><code class="function">gdk_window_set_composited()</code></a>.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-get-composited.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="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-get-composited.returns"></a><h4>Returns</h4>
|
||
<p> <code class="literal">TRUE</code> if the window is composited.</p>
|
||
</div>
|
||
<p class="since">Since: 2.22</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-set-pass-through"></a><h3>gdk_window_set_pass_through ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gdk_window_set_pass_through (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><span class="type">gboolean</span> pass_through</code></em>);</pre>
|
||
<p>Sets whether input to the window is passed through to the window
|
||
below.</p>
|
||
<p>The default value of this is <code class="literal">FALSE</code>, which means that pointer
|
||
events that happen inside the window are send first to the window,
|
||
but if the event is not selected by the event mask then the event
|
||
is sent to the parent window, and so on up the hierarchy.</p>
|
||
<p>If <em class="parameter"><code>pass_through</code></em>
|
||
is <code class="literal">TRUE</code> then such pointer events happen as if the
|
||
window wasn't there at all, and thus will be sent first to any
|
||
windows below <em class="parameter"><code>window</code></em>
|
||
. This is useful if the window is used in a
|
||
transparent fashion. In the terminology of the web this would be called
|
||
"pointer-events: none".</p>
|
||
<p>Note that a window with <em class="parameter"><code>pass_through</code></em>
|
||
<code class="literal">TRUE</code> can still have a subwindow
|
||
without pass through, so you can get events on a subset of a window. And in
|
||
that cases you would get the in-between related events such as the pointer
|
||
enter/leave events on its way to the destination window.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-set-pass-through.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="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>pass_through</p></td>
|
||
<td class="parameter_description"><p>a boolean</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="gdk-window-get-pass-through"></a><h3>gdk_window_get_pass_through ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gdk_window_get_pass_through (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre>
|
||
<p>Returns whether input to the window is passed through to the window
|
||
below.</p>
|
||
<p>See <a class="link" href="gdk3-Windows.html#gdk-window-set-pass-through" title="gdk_window_set_pass_through ()"><code class="function">gdk_window_set_pass_through()</code></a> for details</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-get-pass-through.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="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</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-18.html#api-index-3.18">3.18</a></p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-move"></a><h3>gdk_window_move ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gdk_window_move (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</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>Repositions a window relative to its parent window.
|
||
For toplevel windows, window managers may ignore or modify the move;
|
||
you should probably use <code class="function">gtk_window_move()</code> on a <span class="type">GtkWindow</span> widget
|
||
anyway, instead of using GDK functions. For child windows,
|
||
the move will reliably succeed.</p>
|
||
<p>If you’re also planning to resize the window, use <a class="link" href="gdk3-Windows.html#gdk-window-move-resize" title="gdk_window_move_resize ()"><code class="function">gdk_window_move_resize()</code></a>
|
||
to both move and resize simultaneously, for a nicer visual effect.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-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="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</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 relative to window’s parent</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>y</p></td>
|
||
<td class="parameter_description"><p>Y coordinate relative to window’s parent</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-resize"></a><h3>gdk_window_resize ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gdk_window_resize (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</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 <em class="parameter"><code>window</code></em>
|
||
; for toplevel windows, asks the window manager to resize
|
||
the window. The window manager may not allow the resize. When using GTK+,
|
||
use <code class="function">gtk_window_resize()</code> instead of this low-level GDK function.</p>
|
||
<p>Windows may not be resized below 1x1.</p>
|
||
<p>If you’re also planning to move the window, use <a class="link" href="gdk3-Windows.html#gdk-window-move-resize" title="gdk_window_move_resize ()"><code class="function">gdk_window_move_resize()</code></a>
|
||
to both move and resize simultaneously, for a nicer visual effect.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-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="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>width</p></td>
|
||
<td class="parameter_description"><p>new width of the window</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>height</p></td>
|
||
<td class="parameter_description"><p>new height of the window</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-move-resize"></a><h3>gdk_window_move_resize ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gdk_window_move_resize (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</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>,
|
||
<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>Equivalent to calling <a class="link" href="gdk3-Windows.html#gdk-window-move" title="gdk_window_move ()"><code class="function">gdk_window_move()</code></a> and <a class="link" href="gdk3-Windows.html#gdk-window-resize" title="gdk_window_resize ()"><code class="function">gdk_window_resize()</code></a>,
|
||
except that both operations are performed at once, avoiding strange
|
||
visual effects. (i.e. the user may be able to see the window first
|
||
move, then resize, if you don’t use <a class="link" href="gdk3-Windows.html#gdk-window-move-resize" title="gdk_window_move_resize ()"><code class="function">gdk_window_move_resize()</code></a>.)</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-move-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="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>x</p></td>
|
||
<td class="parameter_description"><p>new X position relative to window’s parent</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>y</p></td>
|
||
<td class="parameter_description"><p>new Y position relative to window’s parent</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>width</p></td>
|
||
<td class="parameter_description"><p>new width</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>height</p></td>
|
||
<td class="parameter_description"><p>new height</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-scroll"></a><h3>gdk_window_scroll ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gdk_window_scroll (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><span class="type">gint</span> dx</code></em>,
|
||
<em class="parameter"><code><span class="type">gint</span> dy</code></em>);</pre>
|
||
<p>Scroll the contents of <em class="parameter"><code>window</code></em>
|
||
, both pixels and children, by the
|
||
given amount. <em class="parameter"><code>window</code></em>
|
||
itself does not move. Portions of the window
|
||
that the scroll operation brings in from offscreen areas are
|
||
invalidated. The invalidated region may be bigger than what would
|
||
strictly be necessary.</p>
|
||
<p>For X11, a minimum area will be invalidated if the window has no
|
||
subwindows, or if the edges of the window’s parent do not extend
|
||
beyond the edges of the window. In other cases, a multi-step process
|
||
is used to scroll the window which may produce temporary visual
|
||
artifacts and unnecessary invalidations.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-scroll.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="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>dx</p></td>
|
||
<td class="parameter_description"><p>Amount to scroll in the X direction</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>dy</p></td>
|
||
<td class="parameter_description"><p>Amount to scroll in the Y direction</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-move-to-rect"></a><h3>gdk_window_move_to_rect ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gdk_window_move_to_rect (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code>const <a class="link" href="gdk3-Points-Rectangles-and-Regions.html#GdkRectangle" title="GdkRectangle"><span class="type">GdkRectangle</span></a> *rect</code></em>,
|
||
<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkGravity" title="enum GdkGravity"><span class="type">GdkGravity</span></a> rect_anchor</code></em>,
|
||
<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkGravity" title="enum GdkGravity"><span class="type">GdkGravity</span></a> window_anchor</code></em>,
|
||
<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkAnchorHints" title="enum GdkAnchorHints"><span class="type">GdkAnchorHints</span></a> anchor_hints</code></em>,
|
||
<em class="parameter"><code><span class="type">gint</span> rect_anchor_dx</code></em>,
|
||
<em class="parameter"><code><span class="type">gint</span> rect_anchor_dy</code></em>);</pre>
|
||
<p>Moves <em class="parameter"><code>window</code></em>
|
||
to <em class="parameter"><code>rect</code></em>
|
||
, aligning their anchor points.</p>
|
||
<p><em class="parameter"><code>rect</code></em>
|
||
is relative to the top-left corner of the window that <em class="parameter"><code>window</code></em>
|
||
is
|
||
transient for. <em class="parameter"><code>rect_anchor</code></em>
|
||
and <em class="parameter"><code>window_anchor</code></em>
|
||
determine anchor points on
|
||
<em class="parameter"><code>rect</code></em>
|
||
and <em class="parameter"><code>window</code></em>
|
||
to pin together. <em class="parameter"><code>rect</code></em>
|
||
's anchor point can optionally be
|
||
offset by <em class="parameter"><code>rect_anchor_dx</code></em>
|
||
and <em class="parameter"><code>rect_anchor_dy</code></em>
|
||
, which is equivalent to
|
||
offsetting the position of <em class="parameter"><code>window</code></em>
|
||
.</p>
|
||
<p><em class="parameter"><code>anchor_hints</code></em>
|
||
determines how <em class="parameter"><code>window</code></em>
|
||
will be moved if the anchor points cause
|
||
it to move off-screen. For example, <a class="link" href="gdk3-Windows.html#GDK-ANCHOR-FLIP-X:CAPS"><code class="literal">GDK_ANCHOR_FLIP_X</code></a> will replace
|
||
<a class="link" href="gdk3-Windows.html#GDK-GRAVITY-NORTH-WEST:CAPS"><code class="literal">GDK_GRAVITY_NORTH_WEST</code></a> with <a class="link" href="gdk3-Windows.html#GDK-GRAVITY-NORTH-EAST:CAPS"><code class="literal">GDK_GRAVITY_NORTH_EAST</code></a> and vice versa if
|
||
<em class="parameter"><code>window</code></em>
|
||
extends beyond the left or right edges of the monitor.</p>
|
||
<p>Connect to the <a class="link" href="gdk3-Windows.html#GdkWindow-moved-to-rect" title="The “moved-to-rect” signal"><span class="type">“moved-to-rect”</span></a> signal to find out how it was
|
||
actually positioned.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-move-to-rect.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 <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> to move</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>rect</p></td>
|
||
<td class="parameter_description"><p>the destination <a class="link" href="gdk3-Points-Rectangles-and-Regions.html#GdkRectangle" title="GdkRectangle"><span class="type">GdkRectangle</span></a> to align <em class="parameter"><code>window</code></em>
|
||
with. </p></td>
|
||
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL must not be passed as the value in, out, in-out; or as a return value."><span class="acronym">not nullable</span></acronym>]</span></td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>rect_anchor</p></td>
|
||
<td class="parameter_description"><p>the point on <em class="parameter"><code>rect</code></em>
|
||
to align with <em class="parameter"><code>window</code></em>
|
||
's anchor point</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>window_anchor</p></td>
|
||
<td class="parameter_description"><p>the point on <em class="parameter"><code>window</code></em>
|
||
to align with <em class="parameter"><code>rect</code></em>
|
||
's anchor point</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>anchor_hints</p></td>
|
||
<td class="parameter_description"><p>positioning hints to use when limited on space</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>rect_anchor_dx</p></td>
|
||
<td class="parameter_description"><p>horizontal offset to shift <em class="parameter"><code>window</code></em>
|
||
, i.e. <em class="parameter"><code>rect</code></em>
|
||
's anchor
|
||
point</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>rect_anchor_dy</p></td>
|
||
<td class="parameter_description"><p>vertical offset to shift <em class="parameter"><code>window</code></em>
|
||
, i.e. <em class="parameter"><code>rect</code></em>
|
||
's anchor point</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: <a class="link" href="api-index-3-24.html#api-index-3.24">3.24</a></p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-move-region"></a><h3>gdk_window_move_region ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gdk_window_move_region (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/cairo/cairo-Regions.html#cairo-region-t"><span class="type">cairo_region_t</span></a> *region</code></em>,
|
||
<em class="parameter"><code><span class="type">gint</span> dx</code></em>,
|
||
<em class="parameter"><code><span class="type">gint</span> dy</code></em>);</pre>
|
||
<p>Move the part of <em class="parameter"><code>window</code></em>
|
||
indicated by <em class="parameter"><code>region</code></em>
|
||
by <em class="parameter"><code>dy</code></em>
|
||
pixels in the Y
|
||
direction and <em class="parameter"><code>dx</code></em>
|
||
pixels in the X direction. The portions of <em class="parameter"><code>region</code></em>
|
||
|
||
that not covered by the new position of <em class="parameter"><code>region</code></em>
|
||
are invalidated.</p>
|
||
<p>Child windows are not moved.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-move-region.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="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>region</p></td>
|
||
<td class="parameter_description"><p>The <a href="/usr/share/gtk-doc/html/cairo/cairo-Regions.html#cairo-region-t"><span class="type">cairo_region_t</span></a> to move</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>dx</p></td>
|
||
<td class="parameter_description"><p>Amount to move in the X direction</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>dy</p></td>
|
||
<td class="parameter_description"><p>Amount to move in the Y direction</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="gdk-window-flush"></a><h3>gdk_window_flush ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gdk_window_flush (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre>
|
||
<div class="warning"><p><code class="literal">gdk_window_flush</code> has been deprecated since version 3.14 and should not be used in newly-written code.</p></div>
|
||
<p>This function does nothing.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-flush.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="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: 2.18</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-has-native"></a><h3>gdk_window_has_native ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gdk_window_has_native (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre>
|
||
<p>Checks whether the window has a native window or not. Note that
|
||
you can use <a class="link" href="gdk3-Windows.html#gdk-window-ensure-native" title="gdk_window_ensure_native ()"><code class="function">gdk_window_ensure_native()</code></a> if a native window is needed.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-has-native.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="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-has-native.returns"></a><h4>Returns</h4>
|
||
<p> <code class="literal">TRUE</code> if the <em class="parameter"><code>window</code></em>
|
||
has a native window, <code class="literal">FALSE</code> otherwise.</p>
|
||
</div>
|
||
<p class="since">Since: 2.22</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-ensure-native"></a><h3>gdk_window_ensure_native ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gdk_window_ensure_native (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre>
|
||
<p>Tries to ensure that there is a window-system native window for this
|
||
GdkWindow. This may fail in some situations, returning <code class="literal">FALSE</code>.</p>
|
||
<p>Offscreen window and children of them can never have native windows.</p>
|
||
<p>Some backends may not support native child windows.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-ensure-native.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="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-ensure-native.returns"></a><h4>Returns</h4>
|
||
<p> <code class="literal">TRUE</code> if the window has a native window, <code class="literal">FALSE</code> otherwise</p>
|
||
</div>
|
||
<p class="since">Since: 2.18</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-reparent"></a><h3>gdk_window_reparent ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gdk_window_reparent (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *new_parent</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>Reparents <em class="parameter"><code>window</code></em>
|
||
into the given <em class="parameter"><code>new_parent</code></em>
|
||
. The window being
|
||
reparented will be unmapped as a side effect.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-reparent.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="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>new_parent</p></td>
|
||
<td class="parameter_description"><p>new parent to move <em class="parameter"><code>window</code></em>
|
||
into</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>x</p></td>
|
||
<td class="parameter_description"><p>X location inside the new parent</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>y</p></td>
|
||
<td class="parameter_description"><p>Y location inside the new parent</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-raise"></a><h3>gdk_window_raise ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gdk_window_raise (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre>
|
||
<p>Raises <em class="parameter"><code>window</code></em>
|
||
to the top of the Z-order (stacking order), so that
|
||
other windows with the same parent window appear below <em class="parameter"><code>window</code></em>
|
||
.
|
||
This is true whether or not the windows are visible.</p>
|
||
<p>If <em class="parameter"><code>window</code></em>
|
||
is a toplevel, the window manager may choose to deny the
|
||
request to move the window in the Z-order, <a class="link" href="gdk3-Windows.html#gdk-window-raise" title="gdk_window_raise ()"><code class="function">gdk_window_raise()</code></a> only
|
||
requests the restack, does not guarantee it.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-raise.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="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-lower"></a><h3>gdk_window_lower ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gdk_window_lower (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre>
|
||
<p>Lowers <em class="parameter"><code>window</code></em>
|
||
to the bottom of the Z-order (stacking order), so that
|
||
other windows with the same parent window appear above <em class="parameter"><code>window</code></em>
|
||
.
|
||
This is true whether or not the other windows are visible.</p>
|
||
<p>If <em class="parameter"><code>window</code></em>
|
||
is a toplevel, the window manager may choose to deny the
|
||
request to move the window in the Z-order, <a class="link" href="gdk3-Windows.html#gdk-window-lower" title="gdk_window_lower ()"><code class="function">gdk_window_lower()</code></a> only
|
||
requests the restack, does not guarantee it.</p>
|
||
<p>Note that <a class="link" href="gdk3-Windows.html#gdk-window-show" title="gdk_window_show ()"><code class="function">gdk_window_show()</code></a> raises the window again, so don’t call this
|
||
function before <a class="link" href="gdk3-Windows.html#gdk-window-show" title="gdk_window_show ()"><code class="function">gdk_window_show()</code></a>. (Try <a class="link" href="gdk3-Windows.html#gdk-window-show-unraised" title="gdk_window_show_unraised ()"><code class="function">gdk_window_show_unraised()</code></a>.)</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-lower.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="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-restack"></a><h3>gdk_window_restack ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gdk_window_restack (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *sibling</code></em>,
|
||
<em class="parameter"><code><span class="type">gboolean</span> above</code></em>);</pre>
|
||
<p>Changes the position of <em class="parameter"><code>window</code></em>
|
||
in the Z-order (stacking order), so that
|
||
it is above <em class="parameter"><code>sibling</code></em>
|
||
(if <em class="parameter"><code>above</code></em>
|
||
is <code class="literal">TRUE</code>) or below <em class="parameter"><code>sibling</code></em>
|
||
(if <em class="parameter"><code>above</code></em>
|
||
is
|
||
<code class="literal">FALSE</code>).</p>
|
||
<p>If <em class="parameter"><code>sibling</code></em>
|
||
is <code class="literal">NULL</code>, then this either raises (if <em class="parameter"><code>above</code></em>
|
||
is <code class="literal">TRUE</code>) or
|
||
lowers the window.</p>
|
||
<p>If <em class="parameter"><code>window</code></em>
|
||
is a toplevel, the window manager may choose to deny the
|
||
request to move the window in the Z-order, <a class="link" href="gdk3-Windows.html#gdk-window-restack" title="gdk_window_restack ()"><code class="function">gdk_window_restack()</code></a> only
|
||
requests the restack, does not guarantee it.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-restack.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="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>sibling</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> that is a sibling of <em class="parameter"><code>window</code></em>
|
||
, 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>above</p></td>
|
||
<td class="parameter_description"><p>a boolean</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: 2.18</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-focus"></a><h3>gdk_window_focus ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gdk_window_focus (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><span class="type">guint32</span> timestamp</code></em>);</pre>
|
||
<p>Sets keyboard focus to <em class="parameter"><code>window</code></em>
|
||
. In most cases, <code class="function">gtk_window_present_with_time()</code>
|
||
should be used on a <span class="type">GtkWindow</span>, rather than calling this function.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-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="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>timestamp</p></td>
|
||
<td class="parameter_description"><p>timestamp of the event triggering the window focus</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-register-dnd"></a><h3>gdk_window_register_dnd ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gdk_window_register_dnd (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre>
|
||
<p>Registers a window as a potential drop destination.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-register-dnd.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="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a>.</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-begin-resize-drag"></a><h3>gdk_window_begin_resize_drag ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gdk_window_begin_resize_drag (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindowEdge" title="enum GdkWindowEdge"><span class="type">GdkWindowEdge</span></a> 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>Begins a window resize operation (for a toplevel window).</p>
|
||
<p>This function assumes that the drag is controlled by the
|
||
client pointer device, use <a class="link" href="gdk3-Windows.html#gdk-window-begin-resize-drag-for-device" title="gdk_window_begin_resize_drag_for_device ()"><code class="function">gdk_window_begin_resize_drag_for_device()</code></a>
|
||
to begin a drag with a different device.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-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 toplevel <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>edge</p></td>
|
||
<td class="parameter_description"><p>the edge or corner from which the drag is started</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>button</p></td>
|
||
<td class="parameter_description"><p>the button being used to drag, or 0 for a keyboard-initiated drag</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>root_x</p></td>
|
||
<td class="parameter_description"><p>root window X coordinate of mouse click that began the drag</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>root_y</p></td>
|
||
<td class="parameter_description"><p>root window Y coordinate of mouse click that began 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 of mouse click that began the drag (use <a class="link" href="gdk3-Events.html#gdk-event-get-time" title="gdk_event_get_time ()"><code class="function">gdk_event_get_time()</code></a>)</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-begin-resize-drag-for-device"></a><h3>gdk_window_begin_resize_drag_for_device ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gdk_window_begin_resize_drag_for_device
|
||
(<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindowEdge" title="enum GdkWindowEdge"><span class="type">GdkWindowEdge</span></a> edge</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GdkDevice.html" title="GdkDevice"><span class="type">GdkDevice</span></a> *device</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>Begins a window resize operation (for a toplevel window).
|
||
You might use this function to implement a “window resize grip,” for
|
||
example; in fact <span class="type">GtkStatusbar</span> uses it. The function works best
|
||
with window managers that support the
|
||
<a class="ulink" href="http://www.freedesktop.org/Standards/wm-spec" target="_top">Extended Window Manager Hints</a>
|
||
but has a fallback implementation for other window managers.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-begin-resize-drag-for-device.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 toplevel <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>edge</p></td>
|
||
<td class="parameter_description"><p>the edge or corner from which the drag is started</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>device</p></td>
|
||
<td class="parameter_description"><p>the device used for the operation</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>button</p></td>
|
||
<td class="parameter_description"><p>the button being used to drag, or 0 for a keyboard-initiated drag</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>root_x</p></td>
|
||
<td class="parameter_description"><p>root window X coordinate of mouse click that began the drag</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>root_y</p></td>
|
||
<td class="parameter_description"><p>root window Y coordinate of mouse click that began 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 of mouse click that began the drag (use <a class="link" href="gdk3-Events.html#gdk-event-get-time" title="gdk_event_get_time ()"><code class="function">gdk_event_get_time()</code></a>)</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="gdk-window-begin-move-drag"></a><h3>gdk_window_begin_move_drag ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gdk_window_begin_move_drag (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</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>Begins a window move operation (for a toplevel window).</p>
|
||
<p>This function assumes that the drag is controlled by the
|
||
client pointer device, use <a class="link" href="gdk3-Windows.html#gdk-window-begin-move-drag-for-device" title="gdk_window_begin_move_drag_for_device ()"><code class="function">gdk_window_begin_move_drag_for_device()</code></a>
|
||
to begin a drag with a different device.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-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 toplevel <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>button</p></td>
|
||
<td class="parameter_description"><p>the button being used to drag, or 0 for a keyboard-initiated drag</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>root_x</p></td>
|
||
<td class="parameter_description"><p>root window X coordinate of mouse click that began the drag</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>root_y</p></td>
|
||
<td class="parameter_description"><p>root window Y coordinate of mouse click that began 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 of mouse click that began the drag</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-begin-move-drag-for-device"></a><h3>gdk_window_begin_move_drag_for_device ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gdk_window_begin_move_drag_for_device (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GdkDevice.html" title="GdkDevice"><span class="type">GdkDevice</span></a> *device</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>Begins a window move operation (for a toplevel window).
|
||
You might use this function to implement a “window move grip,” for
|
||
example. The function works best with window managers that support the
|
||
<a class="ulink" href="http://www.freedesktop.org/Standards/wm-spec" target="_top">Extended Window Manager Hints</a>
|
||
but has a fallback implementation for other window managers.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-begin-move-drag-for-device.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 toplevel <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>device</p></td>
|
||
<td class="parameter_description"><p>the device used for the operation</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>button</p></td>
|
||
<td class="parameter_description"><p>the button being used to drag, or 0 for a keyboard-initiated drag</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>root_x</p></td>
|
||
<td class="parameter_description"><p>root window X coordinate of mouse click that began the drag</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>root_y</p></td>
|
||
<td class="parameter_description"><p>root window Y coordinate of mouse click that began 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 of mouse click that began the drag</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="gdk-window-show-window-menu"></a><h3>gdk_window_show_window_menu ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gdk_window_show_window_menu (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><a class="link" href="gdk3-Event-Structures.html#GdkEvent" title="union GdkEvent"><span class="type">GdkEvent</span></a> *event</code></em>);</pre>
|
||
<p>Asks the windowing system to show the window menu. The window menu
|
||
is the menu shown when right-clicking the titlebar on traditional
|
||
windows managed by the window manager. This is useful for windows
|
||
using client-side decorations, activating it with a right-click
|
||
on the window decorations.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-show-window-menu.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="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</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 <a class="link" href="gdk3-Event-Structures.html#GdkEvent" title="union GdkEvent"><span class="type">GdkEvent</span></a> to show the menu for</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-show-window-menu.returns"></a><h4>Returns</h4>
|
||
<p> <code class="literal">TRUE</code> if the window menu was shown and <code class="literal">FALSE</code> otherwise.</p>
|
||
</div>
|
||
<p class="since">Since: <a class="link" href="api-index-3-14.html#api-index-3.14">3.14</a></p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-constrain-size"></a><h3>gdk_window_constrain_size ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gdk_window_constrain_size (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkGeometry" title="struct GdkGeometry"><span class="type">GdkGeometry</span></a> *geometry</code></em>,
|
||
<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindowHints" title="enum GdkWindowHints"><span class="type">GdkWindowHints</span></a> flags</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>,
|
||
<em class="parameter"><code><span class="type">gint</span> *new_width</code></em>,
|
||
<em class="parameter"><code><span class="type">gint</span> *new_height</code></em>);</pre>
|
||
<p>Constrains a desired width and height according to a
|
||
set of geometry hints (such as minimum and maximum size).</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-constrain-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>geometry</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="gdk3-Windows.html#GdkGeometry" title="struct GdkGeometry"><span class="type">GdkGeometry</span></a> structure</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>flags</p></td>
|
||
<td class="parameter_description"><p>a mask indicating what portions of <em class="parameter"><code>geometry</code></em>
|
||
are set</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>width</p></td>
|
||
<td class="parameter_description"><p>desired width of window</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>height</p></td>
|
||
<td class="parameter_description"><p>desired height of the window</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>new_width</p></td>
|
||
<td class="parameter_description"><p>location to store resulting width. </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>
|
||
<tr>
|
||
<td class="parameter_name"><p>new_height</p></td>
|
||
<td class="parameter_description"><p>location to store resulting height. </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>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-beep"></a><h3>gdk_window_beep ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gdk_window_beep (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre>
|
||
<p>Emits a short beep associated to <em class="parameter"><code>window</code></em>
|
||
in the appropriate
|
||
display, if supported. Otherwise, emits a short beep on
|
||
the display just as <a class="link" href="GdkDisplay.html#gdk-display-beep" title="gdk_display_beep ()"><code class="function">gdk_display_beep()</code></a>.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-beep.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 toplevel <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></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="gdk-window-get-scale-factor"></a><h3>gdk_window_get_scale_factor ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gint</span>
|
||
gdk_window_get_scale_factor (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre>
|
||
<p>Returns the internal scale factor that maps from window coordiantes
|
||
to the actual device pixels. On traditional systems this is 1, but
|
||
on very high density outputs this can be a higher value (often 2).</p>
|
||
<p>A higher value means that drawing is automatically scaled up to
|
||
a higher resolution, so any code doing drawing will automatically look
|
||
nicer. However, if you are supplying pixel-based data the scale
|
||
value can be used to determine whether to use a pixel resource
|
||
with higher resolution data.</p>
|
||
<p>The scale of a window may change during runtime, if this happens
|
||
a configure event will be sent to the toplevel window.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-get-scale-factor.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 get scale factor for</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-get-scale-factor.returns"></a><h4>Returns</h4>
|
||
<p> the scale factor</p>
|
||
</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="gdk-window-set-opaque-region"></a><h3>gdk_window_set_opaque_region ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gdk_window_set_opaque_region (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/cairo/cairo-Regions.html#cairo-region-t"><span class="type">cairo_region_t</span></a> *region</code></em>);</pre>
|
||
<p>For optimisation purposes, compositing window managers may
|
||
like to not draw obscured regions of windows, or turn off blending
|
||
during for these regions. With RGB windows with no transparency,
|
||
this is just the shape of the window, but with ARGB32 windows, the
|
||
compositor does not know what regions of the window are transparent
|
||
or not.</p>
|
||
<p>This function only works for toplevel windows.</p>
|
||
<p>GTK+ will update this property automatically if
|
||
the <em class="parameter"><code>window</code></em>
|
||
background is opaque, as we know where the opaque regions
|
||
are. If your window background is not opaque, please update this
|
||
property in your <span class="type">“style-updated”</span> handler.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-set-opaque-region.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 top-level or non-native <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>region</p></td>
|
||
<td class="parameter_description"><p>a region, 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-10.html#api-index-3.10">3.10</a></p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-create-gl-context"></a><h3>gdk_window_create_gl_context ()</h3>
|
||
<pre class="programlisting"><a class="link" href="GdkGLContext.html" title="GdkGLContext"><span class="returnvalue">GdkGLContext</span></a> *
|
||
gdk_window_create_gl_context (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
|
||
<p>Creates a new <a class="link" href="GdkGLContext.html" title="GdkGLContext"><span class="type">GdkGLContext</span></a> matching the
|
||
framebuffer format to the visual of the <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a>. The context
|
||
is disconnected from any particular window or surface.</p>
|
||
<p>If the creation of the <a class="link" href="GdkGLContext.html" title="GdkGLContext"><span class="type">GdkGLContext</span></a> failed, <em class="parameter"><code>error</code></em>
|
||
will be set.</p>
|
||
<p>Before using the returned <a class="link" href="GdkGLContext.html" title="GdkGLContext"><span class="type">GdkGLContext</span></a>, you will need to
|
||
call <a class="link" href="GdkGLContext.html#gdk-gl-context-make-current" title="gdk_gl_context_make_current ()"><code class="function">gdk_gl_context_make_current()</code></a> or <a class="link" href="GdkGLContext.html#gdk-gl-context-realize" title="gdk_gl_context_realize ()"><code class="function">gdk_gl_context_realize()</code></a>.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-create-gl-context.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="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>error</p></td>
|
||
<td class="parameter_description"><p>return location for an error</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-create-gl-context.returns"></a><h4>Returns</h4>
|
||
<p>the newly created <a class="link" href="GdkGLContext.html" title="GdkGLContext"><span class="type">GdkGLContext</span></a>, or
|
||
<code class="literal">NULL</code> on error. </p>
|
||
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</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="gdk-window-mark-paint-from-clip"></a><h3>gdk_window_mark_paint_from_clip ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gdk_window_mark_paint_from_clip (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/cairo/cairo-cairo-t.html#cairo-t"><span class="type">cairo_t</span></a> *cr</code></em>);</pre>
|
||
<p>If you call this during a paint (e.g. between <a class="link" href="gdk3-Windows.html#gdk-window-begin-paint-region" title="gdk_window_begin_paint_region ()"><code class="function">gdk_window_begin_paint_region()</code></a>
|
||
and <a class="link" href="gdk3-Windows.html#gdk-window-end-paint" title="gdk_window_end_paint ()"><code class="function">gdk_window_end_paint()</code></a> then GDK will mark the current clip region of the
|
||
window as being drawn. This is required when mixing GL rendering via
|
||
<a class="link" href="gdk3-Cairo-Interaction.html#gdk-cairo-draw-from-gl" title="gdk_cairo_draw_from_gl ()"><code class="function">gdk_cairo_draw_from_gl()</code></a> and cairo rendering, as otherwise GDK has no way
|
||
of knowing when something paints over the GL-drawn regions.</p>
|
||
<p>This is typically called automatically by GTK+ and you don't need
|
||
to care about this.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-mark-paint-from-clip.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="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>cr</p></td>
|
||
<td class="parameter_description"><p>a <a href="/usr/share/gtk-doc/html/cairo/cairo-cairo-t.html#cairo-t"><span class="type">cairo_t</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-16.html#api-index-3.16">3.16</a></p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-get-clip-region"></a><h3>gdk_window_get_clip_region ()</h3>
|
||
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/cairo/cairo-Regions.html#cairo-region-t"><span class="returnvalue">cairo_region_t</span></a> *
|
||
gdk_window_get_clip_region (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre>
|
||
<p>Computes the region of a window that potentially can be written
|
||
to by drawing primitives. This region may not take into account
|
||
other factors such as if the window is obscured by other windows,
|
||
but no area outside of this region will be affected by drawing
|
||
primitives.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-get-clip-region.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="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-get-clip-region.returns"></a><h4>Returns</h4>
|
||
<p> a <a href="/usr/share/gtk-doc/html/cairo/cairo-Regions.html#cairo-region-t"><span class="type">cairo_region_t</span></a>. This must be freed with <a href="/usr/share/gtk-doc/html/cairo/cairo-Regions.html#cairo-region-destroy"><code class="function">cairo_region_destroy()</code></a>
|
||
when you are done.</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-begin-paint-rect"></a><h3>gdk_window_begin_paint_rect ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gdk_window_begin_paint_rect (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code>const <a class="link" href="gdk3-Points-Rectangles-and-Regions.html#GdkRectangle" title="GdkRectangle"><span class="type">GdkRectangle</span></a> *rectangle</code></em>);</pre>
|
||
<div class="warning">
|
||
<p><code class="literal">gdk_window_begin_paint_rect</code> has been deprecated since version 3.22 and should not be used in newly-written code.</p>
|
||
<p>Use <a class="link" href="gdk3-Windows.html#gdk-window-begin-draw-frame" title="gdk_window_begin_draw_frame ()"><code class="function">gdk_window_begin_draw_frame()</code></a> instead</p>
|
||
</div>
|
||
<p>A convenience wrapper around <a class="link" href="gdk3-Windows.html#gdk-window-begin-paint-region" title="gdk_window_begin_paint_region ()"><code class="function">gdk_window_begin_paint_region()</code></a> which
|
||
creates a rectangular region for you. See
|
||
<a class="link" href="gdk3-Windows.html#gdk-window-begin-paint-region" title="gdk_window_begin_paint_region ()"><code class="function">gdk_window_begin_paint_region()</code></a> for details.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-begin-paint-rect.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="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>rectangle</p></td>
|
||
<td class="parameter_description"><p>rectangle you intend to draw to</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-begin-paint-region"></a><h3>gdk_window_begin_paint_region ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gdk_window_begin_paint_region (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/cairo/cairo-Regions.html#cairo-region-t"><span class="type">cairo_region_t</span></a> *region</code></em>);</pre>
|
||
<div class="warning">
|
||
<p><code class="literal">gdk_window_begin_paint_region</code> has been deprecated since version 3.22 and should not be used in newly-written code.</p>
|
||
<p>Use <a class="link" href="gdk3-Windows.html#gdk-window-begin-draw-frame" title="gdk_window_begin_draw_frame ()"><code class="function">gdk_window_begin_draw_frame()</code></a> instead</p>
|
||
</div>
|
||
<p>Indicates that you are beginning the process of redrawing <em class="parameter"><code>region</code></em>
|
||
.
|
||
A backing store (offscreen buffer) large enough to contain <em class="parameter"><code>region</code></em>
|
||
|
||
will be created. The backing store will be initialized with the
|
||
background color or background surface for <em class="parameter"><code>window</code></em>
|
||
. Then, all
|
||
drawing operations performed on <em class="parameter"><code>window</code></em>
|
||
will be diverted to the
|
||
backing store. When you call <a class="link" href="gdk3-Windows.html#gdk-window-end-paint" title="gdk_window_end_paint ()"><code class="function">gdk_window_end_paint()</code></a>, the backing
|
||
store will be copied to <em class="parameter"><code>window</code></em>
|
||
, making it visible onscreen. Only
|
||
the part of <em class="parameter"><code>window</code></em>
|
||
contained in <em class="parameter"><code>region</code></em>
|
||
will be modified; that is,
|
||
drawing operations are clipped to <em class="parameter"><code>region</code></em>
|
||
.</p>
|
||
<p>The net result of all this is to remove flicker, because the user
|
||
sees the finished product appear all at once when you call
|
||
<a class="link" href="gdk3-Windows.html#gdk-window-end-paint" title="gdk_window_end_paint ()"><code class="function">gdk_window_end_paint()</code></a>. If you draw to <em class="parameter"><code>window</code></em>
|
||
directly without
|
||
calling <a class="link" href="gdk3-Windows.html#gdk-window-begin-paint-region" title="gdk_window_begin_paint_region ()"><code class="function">gdk_window_begin_paint_region()</code></a>, the user may see flicker
|
||
as individual drawing operations are performed in sequence. The
|
||
clipping and background-initializing features of
|
||
<a class="link" href="gdk3-Windows.html#gdk-window-begin-paint-region" title="gdk_window_begin_paint_region ()"><code class="function">gdk_window_begin_paint_region()</code></a> are conveniences for the
|
||
programmer, so you can avoid doing that work yourself.</p>
|
||
<p>When using GTK+, the widget system automatically places calls to
|
||
<a class="link" href="gdk3-Windows.html#gdk-window-begin-paint-region" title="gdk_window_begin_paint_region ()"><code class="function">gdk_window_begin_paint_region()</code></a> and <a class="link" href="gdk3-Windows.html#gdk-window-end-paint" title="gdk_window_end_paint ()"><code class="function">gdk_window_end_paint()</code></a> around
|
||
emissions of the expose_event signal. That is, if you’re writing an
|
||
expose event handler, you can assume that the exposed area in
|
||
<a class="link" href="gdk3-Event-Structures.html#GdkEventExpose" title="struct GdkEventExpose"><span class="type">GdkEventExpose</span></a> has already been cleared to the window background,
|
||
is already set as the clip region, and already has a backing store.
|
||
Therefore in most cases, application code need not call
|
||
<a class="link" href="gdk3-Windows.html#gdk-window-begin-paint-region" title="gdk_window_begin_paint_region ()"><code class="function">gdk_window_begin_paint_region()</code></a>. (You can disable the automatic
|
||
calls around expose events on a widget-by-widget basis by calling
|
||
<code class="function">gtk_widget_set_double_buffered()</code>.)</p>
|
||
<p>If you call this function multiple times before calling the
|
||
matching <a class="link" href="gdk3-Windows.html#gdk-window-end-paint" title="gdk_window_end_paint ()"><code class="function">gdk_window_end_paint()</code></a>, the backing stores are pushed onto
|
||
a stack. <a class="link" href="gdk3-Windows.html#gdk-window-end-paint" title="gdk_window_end_paint ()"><code class="function">gdk_window_end_paint()</code></a> copies the topmost backing store
|
||
onscreen, subtracts the topmost region from all other regions in
|
||
the stack, and pops the stack. All drawing operations affect only
|
||
the topmost backing store in the stack. One matching call to
|
||
<a class="link" href="gdk3-Windows.html#gdk-window-end-paint" title="gdk_window_end_paint ()"><code class="function">gdk_window_end_paint()</code></a> is required for each call to
|
||
<a class="link" href="gdk3-Windows.html#gdk-window-begin-paint-region" title="gdk_window_begin_paint_region ()"><code class="function">gdk_window_begin_paint_region()</code></a>.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-begin-paint-region.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="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>region</p></td>
|
||
<td class="parameter_description"><p>region you intend to draw to</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-end-paint"></a><h3>gdk_window_end_paint ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gdk_window_end_paint (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre>
|
||
<div class="warning"><p><code class="literal">gdk_window_end_paint</code> is deprecated and should not be used in newly-written code.</p></div>
|
||
<p>Indicates that the backing store created by the most recent call
|
||
to <a class="link" href="gdk3-Windows.html#gdk-window-begin-paint-region" title="gdk_window_begin_paint_region ()"><code class="function">gdk_window_begin_paint_region()</code></a> should be copied onscreen and
|
||
deleted, leaving the next-most-recent backing store or no backing
|
||
store at all as the active paint region. See
|
||
<a class="link" href="gdk3-Windows.html#gdk-window-begin-paint-region" title="gdk_window_begin_paint_region ()"><code class="function">gdk_window_begin_paint_region()</code></a> for full details.</p>
|
||
<p>It is an error to call this function without a matching
|
||
<a class="link" href="gdk3-Windows.html#gdk-window-begin-paint-region" title="gdk_window_begin_paint_region ()"><code class="function">gdk_window_begin_paint_region()</code></a> first.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-end-paint.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="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-begin-draw-frame"></a><h3>gdk_window_begin_draw_frame ()</h3>
|
||
<pre class="programlisting"><a class="link" href="GdkDrawingContext.html" title="GdkDrawingContext"><span class="returnvalue">GdkDrawingContext</span></a> *
|
||
gdk_window_begin_draw_frame (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/cairo/cairo-Regions.html#cairo-region-t"><span class="type">cairo_region_t</span></a> *region</code></em>);</pre>
|
||
<p>Indicates that you are beginning the process of redrawing <em class="parameter"><code>region</code></em>
|
||
|
||
on <em class="parameter"><code>window</code></em>
|
||
, and provides you with a <a class="link" href="GdkDrawingContext.html" title="GdkDrawingContext"><span class="type">GdkDrawingContext</span></a>.</p>
|
||
<p>If <em class="parameter"><code>window</code></em>
|
||
is a top level <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a>, backed by a native window
|
||
implementation, a backing store (offscreen buffer) large enough to
|
||
contain <em class="parameter"><code>region</code></em>
|
||
will be created. The backing store will be initialized
|
||
with the background color or background surface for <em class="parameter"><code>window</code></em>
|
||
. Then, all
|
||
drawing operations performed on <em class="parameter"><code>window</code></em>
|
||
will be diverted to the
|
||
backing store. When you call <code class="function">gdk_window_end_frame()</code>, the contents of
|
||
the backing store will be copied to <em class="parameter"><code>window</code></em>
|
||
, making it visible
|
||
on screen. Only the part of <em class="parameter"><code>window</code></em>
|
||
contained in <em class="parameter"><code>region</code></em>
|
||
will be
|
||
modified; that is, drawing operations are clipped to <em class="parameter"><code>region</code></em>
|
||
.</p>
|
||
<p>The net result of all this is to remove flicker, because the user
|
||
sees the finished product appear all at once when you call
|
||
<a class="link" href="gdk3-Windows.html#gdk-window-end-draw-frame" title="gdk_window_end_draw_frame ()"><code class="function">gdk_window_end_draw_frame()</code></a>. If you draw to <em class="parameter"><code>window</code></em>
|
||
directly without
|
||
calling <a class="link" href="gdk3-Windows.html#gdk-window-begin-draw-frame" title="gdk_window_begin_draw_frame ()"><code class="function">gdk_window_begin_draw_frame()</code></a>, the user may see flicker
|
||
as individual drawing operations are performed in sequence.</p>
|
||
<p>When using GTK+, the widget system automatically places calls to
|
||
<a class="link" href="gdk3-Windows.html#gdk-window-begin-draw-frame" title="gdk_window_begin_draw_frame ()"><code class="function">gdk_window_begin_draw_frame()</code></a> and <a class="link" href="gdk3-Windows.html#gdk-window-end-draw-frame" title="gdk_window_end_draw_frame ()"><code class="function">gdk_window_end_draw_frame()</code></a> around
|
||
emissions of the <code class="literal">GtkWidget::draw</code> signal. That is, if you’re
|
||
drawing the contents of the widget yourself, you can assume that the
|
||
widget has a cleared background, is already set as the clip region,
|
||
and already has a backing store. Therefore in most cases, application
|
||
code in GTK does not need to call <a class="link" href="gdk3-Windows.html#gdk-window-begin-draw-frame" title="gdk_window_begin_draw_frame ()"><code class="function">gdk_window_begin_draw_frame()</code></a>
|
||
explicitly.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-begin-draw-frame.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="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>region</p></td>
|
||
<td class="parameter_description"><p>a Cairo region</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-begin-draw-frame.returns"></a><h4>Returns</h4>
|
||
<p>a <a class="link" href="GdkDrawingContext.html" title="GdkDrawingContext"><span class="type">GdkDrawingContext</span></a> context that should be
|
||
used to draw the contents of the window; the returned context is owned
|
||
by GDK. </p>
|
||
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
|
||
</div>
|
||
<p class="since">Since: <a class="link" href="api-index-3-22.html#api-index-3.22">3.22</a></p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-end-draw-frame"></a><h3>gdk_window_end_draw_frame ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gdk_window_end_draw_frame (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GdkDrawingContext.html" title="GdkDrawingContext"><span class="type">GdkDrawingContext</span></a> *context</code></em>);</pre>
|
||
<p>Indicates that the drawing of the contents of <em class="parameter"><code>window</code></em>
|
||
started with
|
||
<code class="function">gdk_window_begin_frame()</code> has been completed.</p>
|
||
<p>This function will take care of destroying the <a class="link" href="GdkDrawingContext.html" title="GdkDrawingContext"><span class="type">GdkDrawingContext</span></a>.</p>
|
||
<p>It is an error to call this function without a matching
|
||
<code class="function">gdk_window_begin_frame()</code> first.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-end-draw-frame.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="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>context</p></td>
|
||
<td class="parameter_description"><p>the <a class="link" href="GdkDrawingContext.html" title="GdkDrawingContext"><span class="type">GdkDrawingContext</span></a> created by <a class="link" href="gdk3-Windows.html#gdk-window-begin-draw-frame" title="gdk_window_begin_draw_frame ()"><code class="function">gdk_window_begin_draw_frame()</code></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: <a class="link" href="api-index-3-22.html#api-index-3.22">3.22</a></p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-get-visible-region"></a><h3>gdk_window_get_visible_region ()</h3>
|
||
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/cairo/cairo-Regions.html#cairo-region-t"><span class="returnvalue">cairo_region_t</span></a> *
|
||
gdk_window_get_visible_region (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre>
|
||
<p>Computes the region of the <em class="parameter"><code>window</code></em>
|
||
that is potentially visible.
|
||
This does not necessarily take into account if the window is
|
||
obscured by other windows, but no area outside of this region
|
||
is visible.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-get-visible-region.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="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-get-visible-region.returns"></a><h4>Returns</h4>
|
||
<p> a <a href="/usr/share/gtk-doc/html/cairo/cairo-Regions.html#cairo-region-t"><span class="type">cairo_region_t</span></a>. This must be freed with <a href="/usr/share/gtk-doc/html/cairo/cairo-Regions.html#cairo-region-destroy"><code class="function">cairo_region_destroy()</code></a>
|
||
when you are done.</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GdkWindowInvalidateHandlerFunc"></a><h3>GdkWindowInvalidateHandlerFunc ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
<span class="c_punctuation">(</span>*GdkWindowInvalidateHandlerFunc<span class="c_punctuation">)</span> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/cairo/cairo-Regions.html#cairo-region-t"><span class="type">cairo_region_t</span></a> *region</code></em>);</pre>
|
||
<p>Whenever some area of the window is invalidated (directly in the
|
||
window or in a child window) this gets called with <em class="parameter"><code>region</code></em>
|
||
in
|
||
the coordinate space of <em class="parameter"><code>window</code></em>
|
||
. You can use <em class="parameter"><code>region</code></em>
|
||
to just
|
||
keep track of the dirty region, or you can actually change
|
||
<em class="parameter"><code>region</code></em>
|
||
in case you are doing display tricks like showing
|
||
a child in multiple places.</p>
|
||
<div class="refsect3">
|
||
<a name="GdkWindowInvalidateHandlerFunc.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="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>region</p></td>
|
||
<td class="parameter_description"><p>a <a href="/usr/share/gtk-doc/html/cairo/cairo-Regions.html#cairo-region-t"><span class="type">cairo_region_t</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="gdk-window-set-invalidate-handler"></a><h3>gdk_window_set_invalidate_handler ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gdk_window_set_invalidate_handler (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindowInvalidateHandlerFunc" title="GdkWindowInvalidateHandlerFunc ()"><span class="type">GdkWindowInvalidateHandlerFunc</span></a> handler</code></em>);</pre>
|
||
<p>Registers an invalidate handler for a specific window. This
|
||
will get called whenever a region in the window or its children
|
||
is invalidated.</p>
|
||
<p>This can be used to record the invalidated region, which is
|
||
useful if you are keeping an offscreen copy of some region
|
||
and want to keep it up to date. You can also modify the
|
||
invalidated region in case you’re doing some effect where
|
||
e.g. a child widget appears in multiple places.</p>
|
||
<p><span class="annotation">[<acronym title="Exposed in C code, not necessarily available in other languages."><span class="acronym">skip</span></acronym>]</span></p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-set-invalidate-handler.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="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>handler</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="gdk3-Windows.html#GdkWindowInvalidateHandlerFunc" title="GdkWindowInvalidateHandlerFunc ()"><span class="type">GdkWindowInvalidateHandlerFunc</span></a> callback function</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="gdk-window-invalidate-rect"></a><h3>gdk_window_invalidate_rect ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gdk_window_invalidate_rect (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code>const <a class="link" href="gdk3-Points-Rectangles-and-Regions.html#GdkRectangle" title="GdkRectangle"><span class="type">GdkRectangle</span></a> *rect</code></em>,
|
||
<em class="parameter"><code><span class="type">gboolean</span> invalidate_children</code></em>);</pre>
|
||
<p>A convenience wrapper around <a class="link" href="gdk3-Windows.html#gdk-window-invalidate-region" title="gdk_window_invalidate_region ()"><code class="function">gdk_window_invalidate_region()</code></a> which
|
||
invalidates a rectangular region. See
|
||
<a class="link" href="gdk3-Windows.html#gdk-window-invalidate-region" title="gdk_window_invalidate_region ()"><code class="function">gdk_window_invalidate_region()</code></a> for details.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-invalidate-rect.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="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>rect</p></td>
|
||
<td class="parameter_description"><p>rectangle to invalidate or <code class="literal">NULL</code> to invalidate the whole
|
||
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>
|
||
<tr>
|
||
<td class="parameter_name"><p>invalidate_children</p></td>
|
||
<td class="parameter_description"><p>whether to also invalidate child windows</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-invalidate-region"></a><h3>gdk_window_invalidate_region ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gdk_window_invalidate_region (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/cairo/cairo-Regions.html#cairo-region-t"><span class="type">cairo_region_t</span></a> *region</code></em>,
|
||
<em class="parameter"><code><span class="type">gboolean</span> invalidate_children</code></em>);</pre>
|
||
<p>Adds <em class="parameter"><code>region</code></em>
|
||
to the update area for <em class="parameter"><code>window</code></em>
|
||
. The update area is the
|
||
region that needs to be redrawn, or “dirty region.” The call
|
||
<a class="link" href="gdk3-Windows.html#gdk-window-process-updates" title="gdk_window_process_updates ()"><code class="function">gdk_window_process_updates()</code></a> sends one or more expose events to the
|
||
window, which together cover the entire update area. An
|
||
application would normally redraw the contents of <em class="parameter"><code>window</code></em>
|
||
in
|
||
response to those expose events.</p>
|
||
<p>GDK will call <a class="link" href="gdk3-Windows.html#gdk-window-process-all-updates" title="gdk_window_process_all_updates ()"><code class="function">gdk_window_process_all_updates()</code></a> on your behalf
|
||
whenever your program returns to the main loop and becomes idle, so
|
||
normally there’s no need to do that manually, you just need to
|
||
invalidate regions that you know should be redrawn.</p>
|
||
<p>The <em class="parameter"><code>invalidate_children</code></em>
|
||
parameter controls whether the region of
|
||
each child window that intersects <em class="parameter"><code>region</code></em>
|
||
will also be invalidated.
|
||
If <code class="literal">FALSE</code>, then the update area for child windows will remain
|
||
unaffected. See gdk_window_invalidate_maybe_recurse if you need
|
||
fine grained control over which children are invalidated.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-invalidate-region.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="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>region</p></td>
|
||
<td class="parameter_description"><p>a <a href="/usr/share/gtk-doc/html/cairo/cairo-Regions.html#cairo-region-t"><span class="type">cairo_region_t</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>invalidate_children</p></td>
|
||
<td class="parameter_description"><p><code class="literal">TRUE</code> to also invalidate child windows</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GdkWindowChildFunc"></a><h3>GdkWindowChildFunc ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
<span class="c_punctuation">(</span>*GdkWindowChildFunc<span class="c_punctuation">)</span> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><span class="type">gpointer</span> user_data</code></em>);</pre>
|
||
<p>A function of this type is passed to <a class="link" href="gdk3-Windows.html#gdk-window-invalidate-maybe-recurse" title="gdk_window_invalidate_maybe_recurse ()"><code class="function">gdk_window_invalidate_maybe_recurse()</code></a>.
|
||
It gets called for each child of the window to determine whether to
|
||
recursively invalidate it or now.</p>
|
||
<div class="refsect3">
|
||
<a name="GdkWindowChildFunc.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="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></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</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="GdkWindowChildFunc.returns"></a><h4>Returns</h4>
|
||
<p> <code class="literal">TRUE</code> to invalidate <em class="parameter"><code>window</code></em>
|
||
recursively</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-invalidate-maybe-recurse"></a><h3>gdk_window_invalidate_maybe_recurse ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gdk_window_invalidate_maybe_recurse (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/cairo/cairo-Regions.html#cairo-region-t"><span class="type">cairo_region_t</span></a> *region</code></em>,
|
||
<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindowChildFunc" title="GdkWindowChildFunc ()"><span class="type">GdkWindowChildFunc</span></a> child_func</code></em>,
|
||
<em class="parameter"><code><span class="type">gpointer</span> user_data</code></em>);</pre>
|
||
<p>Adds <em class="parameter"><code>region</code></em>
|
||
to the update area for <em class="parameter"><code>window</code></em>
|
||
. The update area is the
|
||
region that needs to be redrawn, or “dirty region.” The call
|
||
<a class="link" href="gdk3-Windows.html#gdk-window-process-updates" title="gdk_window_process_updates ()"><code class="function">gdk_window_process_updates()</code></a> sends one or more expose events to the
|
||
window, which together cover the entire update area. An
|
||
application would normally redraw the contents of <em class="parameter"><code>window</code></em>
|
||
in
|
||
response to those expose events.</p>
|
||
<p>GDK will call <a class="link" href="gdk3-Windows.html#gdk-window-process-all-updates" title="gdk_window_process_all_updates ()"><code class="function">gdk_window_process_all_updates()</code></a> on your behalf
|
||
whenever your program returns to the main loop and becomes idle, so
|
||
normally there’s no need to do that manually, you just need to
|
||
invalidate regions that you know should be redrawn.</p>
|
||
<p>The <em class="parameter"><code>child_func</code></em>
|
||
parameter controls whether the region of
|
||
each child window that intersects <em class="parameter"><code>region</code></em>
|
||
will also be invalidated.
|
||
Only children for which <em class="parameter"><code>child_func</code></em>
|
||
returns <span class="type">TRUE</span> will have the area
|
||
invalidated.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-invalidate-maybe-recurse.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="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>region</p></td>
|
||
<td class="parameter_description"><p>a <a href="/usr/share/gtk-doc/html/cairo/cairo-Regions.html#cairo-region-t"><span class="type">cairo_region_t</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>child_func</p></td>
|
||
<td class="parameter_description"><p>function to use to decide if to
|
||
recurse to a child, <code class="literal">NULL</code> means never recurse. </p></td>
|
||
<td class="parameter_annotations"><span class="annotation">[<acronym title="The callback is valid only during the call to the method."><span class="acronym">scope call</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>user_data</p></td>
|
||
<td class="parameter_description"><p>data passed to <em class="parameter"><code>child_func</code></em>
|
||
</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-get-update-area"></a><h3>gdk_window_get_update_area ()</h3>
|
||
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/cairo/cairo-Regions.html#cairo-region-t"><span class="returnvalue">cairo_region_t</span></a> *
|
||
gdk_window_get_update_area (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre>
|
||
<p>Transfers ownership of the update area from <em class="parameter"><code>window</code></em>
|
||
to the caller
|
||
of the function. That is, after calling this function, <em class="parameter"><code>window</code></em>
|
||
will
|
||
no longer have an invalid/dirty region; the update area is removed
|
||
from <em class="parameter"><code>window</code></em>
|
||
and handed to you. If a window has no update area,
|
||
<a class="link" href="gdk3-Windows.html#gdk-window-get-update-area" title="gdk_window_get_update_area ()"><code class="function">gdk_window_get_update_area()</code></a> returns <code class="literal">NULL</code>. You are responsible for
|
||
calling <a href="/usr/share/gtk-doc/html/cairo/cairo-Regions.html#cairo-region-destroy"><code class="function">cairo_region_destroy()</code></a> on the returned region if it’s non-<code class="literal">NULL</code>.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-get-update-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="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-get-update-area.returns"></a><h4>Returns</h4>
|
||
<p> the update area for <em class="parameter"><code>window</code></em>
|
||
</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-freeze-updates"></a><h3>gdk_window_freeze_updates ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gdk_window_freeze_updates (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre>
|
||
<p>Temporarily freezes a window such that it won’t receive expose
|
||
events. The window will begin receiving expose events again when
|
||
<a class="link" href="gdk3-Windows.html#gdk-window-thaw-updates" title="gdk_window_thaw_updates ()"><code class="function">gdk_window_thaw_updates()</code></a> is called. If <a class="link" href="gdk3-Windows.html#gdk-window-freeze-updates" title="gdk_window_freeze_updates ()"><code class="function">gdk_window_freeze_updates()</code></a>
|
||
has been called more than once, <a class="link" href="gdk3-Windows.html#gdk-window-thaw-updates" title="gdk_window_thaw_updates ()"><code class="function">gdk_window_thaw_updates()</code></a> must be called
|
||
an equal number of times to begin processing exposes.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-freeze-updates.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="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-thaw-updates"></a><h3>gdk_window_thaw_updates ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gdk_window_thaw_updates (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre>
|
||
<p>Thaws a window frozen with <a class="link" href="gdk3-Windows.html#gdk-window-freeze-updates" title="gdk_window_freeze_updates ()"><code class="function">gdk_window_freeze_updates()</code></a>.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-thaw-updates.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="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-process-all-updates"></a><h3>gdk_window_process_all_updates ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gdk_window_process_all_updates (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
|
||
<div class="warning"><p><code class="literal">gdk_window_process_all_updates</code> has been deprecated since version 3.22 and should not be used in newly-written code.</p></div>
|
||
<p>Calls <a class="link" href="gdk3-Windows.html#gdk-window-process-updates" title="gdk_window_process_updates ()"><code class="function">gdk_window_process_updates()</code></a> for all windows (see <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a>)
|
||
in the application.</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-process-updates"></a><h3>gdk_window_process_updates ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gdk_window_process_updates (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><span class="type">gboolean</span> update_children</code></em>);</pre>
|
||
<div class="warning"><p><code class="literal">gdk_window_process_updates</code> has been deprecated since version 3.22 and should not be used in newly-written code.</p></div>
|
||
<p>Sends one or more expose events to <em class="parameter"><code>window</code></em>
|
||
. The areas in each
|
||
expose event will cover the entire update area for the window (see
|
||
<a class="link" href="gdk3-Windows.html#gdk-window-invalidate-region" title="gdk_window_invalidate_region ()"><code class="function">gdk_window_invalidate_region()</code></a> for details). Normally GDK calls
|
||
<a class="link" href="gdk3-Windows.html#gdk-window-process-all-updates" title="gdk_window_process_all_updates ()"><code class="function">gdk_window_process_all_updates()</code></a> on your behalf, so there’s no
|
||
need to call this function unless you want to force expose events
|
||
to be delivered immediately and synchronously (vs. the usual
|
||
case, where GDK delivers them in an idle handler). Occasionally
|
||
this is useful to produce nicer scrolling behavior, for example.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-process-updates.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="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>update_children</p></td>
|
||
<td class="parameter_description"><p>whether to also process updates for child windows</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-set-debug-updates"></a><h3>gdk_window_set_debug_updates ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gdk_window_set_debug_updates (<em class="parameter"><code><span class="type">gboolean</span> setting</code></em>);</pre>
|
||
<div class="warning"><p><code class="literal">gdk_window_set_debug_updates</code> has been deprecated since version 3.22 and should not be used in newly-written code.</p></div>
|
||
<p>With update debugging enabled, calls to
|
||
<a class="link" href="gdk3-Windows.html#gdk-window-invalidate-region" title="gdk_window_invalidate_region ()"><code class="function">gdk_window_invalidate_region()</code></a> clear the invalidated region of the
|
||
screen to a noticeable color, and GDK pauses for a short time
|
||
before sending exposes to windows during
|
||
<a class="link" href="gdk3-Windows.html#gdk-window-process-updates" title="gdk_window_process_updates ()"><code class="function">gdk_window_process_updates()</code></a>. The net effect is that you can see
|
||
the invalid region for each window and watch redraws as they
|
||
occur. This allows you to diagnose inefficiencies in your application.</p>
|
||
<p>In essence, because the GDK rendering model prevents all flicker,
|
||
if you are redrawing the same region 400 times you may never
|
||
notice, aside from noticing a speed problem. Enabling update
|
||
debugging causes GTK to flicker slowly and noticeably, so you can
|
||
see exactly what’s being redrawn when, in what order.</p>
|
||
<p>The --gtk-debug=updates command line option passed to GTK+ programs
|
||
enables this debug option at application startup time. That's
|
||
usually more useful than calling <a class="link" href="gdk3-Windows.html#gdk-window-set-debug-updates" title="gdk_window_set_debug_updates ()"><code class="function">gdk_window_set_debug_updates()</code></a>
|
||
yourself, though you might want to use this function to enable
|
||
updates sometime after application startup time.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-set-debug-updates.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 turn on update debugging</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-enable-synchronized-configure"></a><h3>gdk_window_enable_synchronized_configure ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gdk_window_enable_synchronized_configure
|
||
(<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre>
|
||
<div class="warning">
|
||
<p><code class="literal">gdk_window_enable_synchronized_configure</code> has been deprecated since version 3.8 and should not be used in newly-written code.</p>
|
||
<p>this function is no longer needed</p>
|
||
</div>
|
||
<p>Does nothing, present only for compatiblity.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-enable-synchronized-configure.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 toplevel <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></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="gdk-window-configure-finished"></a><h3>gdk_window_configure_finished ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gdk_window_configure_finished (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre>
|
||
<div class="warning">
|
||
<p><code class="literal">gdk_window_configure_finished</code> has been deprecated since version 3.8 and should not be used in newly-written code.</p>
|
||
<p>this function is no longer needed</p>
|
||
</div>
|
||
<p>Does nothing, present only for compatiblity.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-configure-finished.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 toplevel <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></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="gdk-window-get-frame-clock"></a><h3>gdk_window_get_frame_clock ()</h3>
|
||
<pre class="programlisting"><a class="link" href="GdkFrameClock.html" title="Frame clock"><span class="returnvalue">GdkFrameClock</span></a> *
|
||
gdk_window_get_frame_clock (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre>
|
||
<p>Gets the frame clock for the window. The frame clock for a window
|
||
never changes unless the window is reparented to a new toplevel
|
||
window.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-get-frame-clock.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 get frame clock for</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-get-frame-clock.returns"></a><h4>Returns</h4>
|
||
<p>the frame clock. </p>
|
||
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
|
||
</div>
|
||
<p class="since">Since: <a class="link" href="api-index-3-8.html#api-index-3.8">3.8</a></p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-set-user-data"></a><h3>gdk_window_set_user_data ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gdk_window_set_user_data (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><span class="type">gpointer</span> user_data</code></em>);</pre>
|
||
<p>For most purposes this function is deprecated in favor of
|
||
<code class="function">g_object_set_data()</code>. However, for historical reasons GTK+ stores
|
||
the <span class="type">GtkWidget</span> that owns a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> as user data on the
|
||
<a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a>. So, custom widget implementations should use
|
||
this function for that. If GTK+ receives an event for a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a>,
|
||
and the user data for the window is non-<code class="literal">NULL</code>, GTK+ will assume the
|
||
user data is a <span class="type">GtkWidget</span>, and forward the event to that widget.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-set-user-data.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="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></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. </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>][<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> GObject.Object]</span></td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-set-override-redirect"></a><h3>gdk_window_set_override_redirect ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gdk_window_set_override_redirect (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><span class="type">gboolean</span> override_redirect</code></em>);</pre>
|
||
<p>An override redirect window is not under the control of the window manager.
|
||
This means it won’t have a titlebar, won’t be minimizable, etc. - it will
|
||
be entirely under the control of the application. The window manager
|
||
can’t see the override redirect window at all.</p>
|
||
<p>Override redirect should only be used for short-lived temporary
|
||
windows, such as popup menus. <span class="type">GtkMenu</span> uses an override redirect
|
||
window in its implementation, for example.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-set-override-redirect.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 toplevel <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>override_redirect</p></td>
|
||
<td class="parameter_description"><p><code class="literal">TRUE</code> if window should be override redirect</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-set-accept-focus"></a><h3>gdk_window_set_accept_focus ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gdk_window_set_accept_focus (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><span class="type">gboolean</span> accept_focus</code></em>);</pre>
|
||
<p>Setting <em class="parameter"><code>accept_focus</code></em>
|
||
to <code class="literal">FALSE</code> hints the desktop environment that the
|
||
window doesn’t want to receive input focus.</p>
|
||
<p>On X, it is the responsibility of the window manager to interpret this
|
||
hint. ICCCM-compliant window manager usually respect it.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-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 toplevel <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>accept_focus</p></td>
|
||
<td class="parameter_description"><p><code class="literal">TRUE</code> if the window should 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="gdk-window-get-accept-focus"></a><h3>gdk_window_get_accept_focus ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gdk_window_get_accept_focus (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre>
|
||
<p>Determines whether or not the desktop environment shuld be hinted that
|
||
the window does not want to receive input focus.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-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 toplevel <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a>.</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-get-accept-focus.returns"></a><h4>Returns</h4>
|
||
<p> whether or not the window should receive input focus.</p>
|
||
</div>
|
||
<p class="since">Since: 2.22</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-set-focus-on-map"></a><h3>gdk_window_set_focus_on_map ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gdk_window_set_focus_on_map (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><span class="type">gboolean</span> focus_on_map</code></em>);</pre>
|
||
<p>Setting <em class="parameter"><code>focus_on_map</code></em>
|
||
to <code class="literal">FALSE</code> hints the desktop environment that the
|
||
window doesn’t want to receive input focus when it is mapped.
|
||
focus_on_map should be turned off for windows that aren’t triggered
|
||
interactively (such as popups from network activity).</p>
|
||
<p>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.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-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 toplevel <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>focus_on_map</p></td>
|
||
<td class="parameter_description"><p><code class="literal">TRUE</code> if the window should receive input focus when mapped</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="gdk-window-get-focus-on-map"></a><h3>gdk_window_get_focus_on_map ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gdk_window_get_focus_on_map (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre>
|
||
<p>Determines whether or not the desktop environment should be hinted that the
|
||
window does not want to receive input focus when it is mapped.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-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 toplevel <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a>.</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-get-focus-on-map.returns"></a><h4>Returns</h4>
|
||
<p> whether or not the window wants to receive input focus when
|
||
it is mapped.</p>
|
||
</div>
|
||
<p class="since">Since: 2.22</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-add-filter"></a><h3>gdk_window_add_filter ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gdk_window_add_filter (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkFilterFunc" title="GdkFilterFunc ()"><span class="type">GdkFilterFunc</span></a> function</code></em>,
|
||
<em class="parameter"><code><span class="type">gpointer</span> data</code></em>);</pre>
|
||
<p>Adds an event filter to <em class="parameter"><code>window</code></em>
|
||
, allowing you to intercept events
|
||
before they reach GDK. This is a low-level operation and makes it
|
||
easy to break GDK and/or GTK+, so you have to know what you're
|
||
doing. Pass <code class="literal">NULL</code> for <em class="parameter"><code>window</code></em>
|
||
to get all events for all windows,
|
||
instead of events for a specific window.</p>
|
||
<p>If you are interested in X GenericEvents, bear in mind that
|
||
<code class="function">XGetEventData()</code> has been already called on the event, and
|
||
<code class="function">XFreeEventData()</code> must not be called within <em class="parameter"><code>function</code></em>
|
||
.</p>
|
||
<p><span class="annotation">[<acronym title="Exposed in C code, not necessarily available in other languages."><span class="acronym">skip</span></acronym>]</span></p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-add-filter.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="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a>. </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>function</p></td>
|
||
<td class="parameter_description"><p>filter callback</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>data</p></td>
|
||
<td class="parameter_description"><p>data to pass to filter callback</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-remove-filter"></a><h3>gdk_window_remove_filter ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gdk_window_remove_filter (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkFilterFunc" title="GdkFilterFunc ()"><span class="type">GdkFilterFunc</span></a> function</code></em>,
|
||
<em class="parameter"><code><span class="type">gpointer</span> data</code></em>);</pre>
|
||
<p>Remove a filter previously added with <a class="link" href="gdk3-Windows.html#gdk-window-add-filter" title="gdk_window_add_filter ()"><code class="function">gdk_window_add_filter()</code></a>.</p>
|
||
<p><span class="annotation">[<acronym title="Exposed in C code, not necessarily available in other languages."><span class="acronym">skip</span></acronym>]</span></p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-remove-filter.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="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>function</p></td>
|
||
<td class="parameter_description"><p>previously-added filter function</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>data</p></td>
|
||
<td class="parameter_description"><p>user data for previously-added filter function</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GdkFilterFunc"></a><h3>GdkFilterFunc ()</h3>
|
||
<pre class="programlisting"><a class="link" href="gdk3-Windows.html#GdkFilterReturn" title="enum GdkFilterReturn"><span class="returnvalue">GdkFilterReturn</span></a>
|
||
<span class="c_punctuation">(</span>*GdkFilterFunc<span class="c_punctuation">)</span> (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkXEvent" title="GdkXEvent"><span class="type">GdkXEvent</span></a> *xevent</code></em>,
|
||
<em class="parameter"><code><a class="link" href="gdk3-Event-Structures.html#GdkEvent" title="union GdkEvent"><span class="type">GdkEvent</span></a> *event</code></em>,
|
||
<em class="parameter"><code><span class="type">gpointer</span> data</code></em>);</pre>
|
||
<p>Specifies the type of function used to filter native events before they are
|
||
converted to GDK events.</p>
|
||
<p>When a filter is called, <em class="parameter"><code>event</code></em>
|
||
is unpopulated, except for
|
||
<code class="literal">event->window</code>. The filter may translate the native
|
||
event to a GDK event and store the result in <em class="parameter"><code>event</code></em>
|
||
, or handle it without
|
||
translation. If the filter translates the event and processing should
|
||
continue, it should return <a class="link" href="gdk3-Windows.html#GDK-FILTER-TRANSLATE:CAPS"><code class="literal">GDK_FILTER_TRANSLATE</code></a>.</p>
|
||
<div class="refsect3">
|
||
<a name="GdkFilterFunc.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>xevent</p></td>
|
||
<td class="parameter_description"><p>the native event to filter.</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>event</p></td>
|
||
<td class="parameter_description"><p>the GDK event to which the X event will be translated.</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>data</p></td>
|
||
<td class="parameter_description"><p>user data set when the filter was installed. </p></td>
|
||
<td class="parameter_annotations"><span class="annotation">[<acronym title="This parameter is a 'user_data', for callbacks; many bindings can pass NULL here."><span class="acronym">closure</span></acronym>]</span></td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="GdkFilterFunc.returns"></a><h4>Returns</h4>
|
||
<p> a <a class="link" href="gdk3-Windows.html#GdkFilterReturn" title="enum GdkFilterReturn"><span class="type">GdkFilterReturn</span></a> value.</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-shape-combine-region"></a><h3>gdk_window_shape_combine_region ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gdk_window_shape_combine_region (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/cairo/cairo-Regions.html#cairo-region-t"><span class="type">cairo_region_t</span></a> *shape_region</code></em>,
|
||
<em class="parameter"><code><span class="type">gint</span> offset_x</code></em>,
|
||
<em class="parameter"><code><span class="type">gint</span> offset_y</code></em>);</pre>
|
||
<p>Makes pixels in <em class="parameter"><code>window</code></em>
|
||
outside <em class="parameter"><code>shape_region</code></em>
|
||
be transparent,
|
||
so that the window may be nonrectangular.</p>
|
||
<p>If <em class="parameter"><code>shape_region</code></em>
|
||
is <code class="literal">NULL</code>, the shape will be unset, so the whole
|
||
window will be opaque again. <em class="parameter"><code>offset_x</code></em>
|
||
and <em class="parameter"><code>offset_y</code></em>
|
||
are ignored
|
||
if <em class="parameter"><code>shape_region</code></em>
|
||
is <code class="literal">NULL</code>.</p>
|
||
<p>On the X11 platform, this uses an X server extension which is
|
||
widely available on most common platforms, but not available on
|
||
very old X servers, and occasionally the implementation will be
|
||
buggy. On servers without the shape extension, this function
|
||
will do nothing.</p>
|
||
<p>This function works on both toplevel and child windows.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-shape-combine-region.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="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>shape_region</p></td>
|
||
<td class="parameter_description"><p>region of window to be non-transparent. </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>offset_x</p></td>
|
||
<td class="parameter_description"><p>X position of <em class="parameter"><code>shape_region</code></em>
|
||
in <em class="parameter"><code>window</code></em>
|
||
coordinates</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>offset_y</p></td>
|
||
<td class="parameter_description"><p>Y position of <em class="parameter"><code>shape_region</code></em>
|
||
in <em class="parameter"><code>window</code></em>
|
||
coordinates</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-set-child-shapes"></a><h3>gdk_window_set_child_shapes ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gdk_window_set_child_shapes (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre>
|
||
<p>Sets the shape mask of <em class="parameter"><code>window</code></em>
|
||
to the union of shape masks
|
||
for all children of <em class="parameter"><code>window</code></em>
|
||
, ignoring the shape mask of <em class="parameter"><code>window</code></em>
|
||
|
||
itself. Contrast with <a class="link" href="gdk3-Windows.html#gdk-window-merge-child-shapes" title="gdk_window_merge_child_shapes ()"><code class="function">gdk_window_merge_child_shapes()</code></a> which includes
|
||
the shape mask of <em class="parameter"><code>window</code></em>
|
||
in the masks to be merged.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-set-child-shapes.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="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-merge-child-shapes"></a><h3>gdk_window_merge_child_shapes ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gdk_window_merge_child_shapes (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre>
|
||
<p>Merges the shape masks for any child windows into the
|
||
shape mask for <em class="parameter"><code>window</code></em>
|
||
. i.e. the union of all masks
|
||
for <em class="parameter"><code>window</code></em>
|
||
and its children will become the new mask
|
||
for <em class="parameter"><code>window</code></em>
|
||
. See <a class="link" href="gdk3-Windows.html#gdk-window-shape-combine-region" title="gdk_window_shape_combine_region ()"><code class="function">gdk_window_shape_combine_region()</code></a>.</p>
|
||
<p>This function is distinct from <a class="link" href="gdk3-Windows.html#gdk-window-set-child-shapes" title="gdk_window_set_child_shapes ()"><code class="function">gdk_window_set_child_shapes()</code></a>
|
||
because it includes <em class="parameter"><code>window</code></em>
|
||
’s shape mask in the set of shapes to
|
||
be merged.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-merge-child-shapes.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="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-input-shape-combine-region"></a><h3>gdk_window_input_shape_combine_region ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gdk_window_input_shape_combine_region (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/cairo/cairo-Regions.html#cairo-region-t"><span class="type">cairo_region_t</span></a> *shape_region</code></em>,
|
||
<em class="parameter"><code><span class="type">gint</span> offset_x</code></em>,
|
||
<em class="parameter"><code><span class="type">gint</span> offset_y</code></em>);</pre>
|
||
<p>Like <a class="link" href="gdk3-Windows.html#gdk-window-shape-combine-region" title="gdk_window_shape_combine_region ()"><code class="function">gdk_window_shape_combine_region()</code></a>, but the shape applies
|
||
only to event handling. Mouse events which happen while
|
||
the pointer position corresponds to an unset bit in the
|
||
mask will be passed on the window below <em class="parameter"><code>window</code></em>
|
||
.</p>
|
||
<p>An input shape is typically used with RGBA 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”.</p>
|
||
<p>On the X11 platform, this requires version 1.1 of the
|
||
shape extension.</p>
|
||
<p>On the Win32 platform, this functionality is not present and the
|
||
function does nothing.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-input-shape-combine-region.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="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>shape_region</p></td>
|
||
<td class="parameter_description"><p>region of window to be non-transparent</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>offset_x</p></td>
|
||
<td class="parameter_description"><p>X position of <em class="parameter"><code>shape_region</code></em>
|
||
in <em class="parameter"><code>window</code></em>
|
||
coordinates</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>offset_y</p></td>
|
||
<td class="parameter_description"><p>Y position of <em class="parameter"><code>shape_region</code></em>
|
||
in <em class="parameter"><code>window</code></em>
|
||
coordinates</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="gdk-window-set-child-input-shapes"></a><h3>gdk_window_set_child_input_shapes ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gdk_window_set_child_input_shapes (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre>
|
||
<p>Sets the input shape mask of <em class="parameter"><code>window</code></em>
|
||
to the union of input shape masks
|
||
for all children of <em class="parameter"><code>window</code></em>
|
||
, ignoring the input shape mask of <em class="parameter"><code>window</code></em>
|
||
|
||
itself. Contrast with <a class="link" href="gdk3-Windows.html#gdk-window-merge-child-input-shapes" title="gdk_window_merge_child_input_shapes ()"><code class="function">gdk_window_merge_child_input_shapes()</code></a> which includes
|
||
the input shape mask of <em class="parameter"><code>window</code></em>
|
||
in the masks to be merged.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-set-child-input-shapes.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="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></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="gdk-window-merge-child-input-shapes"></a><h3>gdk_window_merge_child_input_shapes ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gdk_window_merge_child_input_shapes (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre>
|
||
<p>Merges the input shape masks for any child windows into the
|
||
input shape mask for <em class="parameter"><code>window</code></em>
|
||
. i.e. the union of all input masks
|
||
for <em class="parameter"><code>window</code></em>
|
||
and its children will become the new input mask
|
||
for <em class="parameter"><code>window</code></em>
|
||
. See <a class="link" href="gdk3-Windows.html#gdk-window-input-shape-combine-region" title="gdk_window_input_shape_combine_region ()"><code class="function">gdk_window_input_shape_combine_region()</code></a>.</p>
|
||
<p>This function is distinct from <a class="link" href="gdk3-Windows.html#gdk-window-set-child-input-shapes" title="gdk_window_set_child_input_shapes ()"><code class="function">gdk_window_set_child_input_shapes()</code></a>
|
||
because it includes <em class="parameter"><code>window</code></em>
|
||
’s input shape mask in the set of
|
||
shapes to be merged.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-merge-child-input-shapes.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="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></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="gdk-window-set-static-gravities"></a><h3>gdk_window_set_static_gravities ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gdk_window_set_static_gravities (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><span class="type">gboolean</span> use_static</code></em>);</pre>
|
||
<div class="warning">
|
||
<p><code class="literal">gdk_window_set_static_gravities</code> has been deprecated since version 3.16 and should not be used in newly-written code.</p>
|
||
<p>static gravities haven't worked on anything but X11
|
||
for a long time.</p>
|
||
</div>
|
||
<p>Used to set the bit gravity of the given window to static, and flag
|
||
it so all children get static subwindow gravity. This is used if you
|
||
are implementing scary features that involve deep knowledge of the
|
||
windowing system. Don’t worry about it.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-set-static-gravities.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="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>use_static</p></td>
|
||
<td class="parameter_description"><p><code class="literal">TRUE</code> to turn on static gravity</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-set-static-gravities.returns"></a><h4>Returns</h4>
|
||
<p> <code class="literal">FALSE</code></p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-set-title"></a><h3>gdk_window_set_title ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gdk_window_set_title (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code>const <span class="type">gchar</span> *title</code></em>);</pre>
|
||
<p>Sets the title of a toplevel window, to be displayed in the titlebar.
|
||
If you haven’t explicitly set the icon name for the window
|
||
(using <a class="link" href="gdk3-Windows.html#gdk-window-set-icon-name" title="gdk_window_set_icon_name ()"><code class="function">gdk_window_set_icon_name()</code></a>), the icon name will be set to
|
||
<em class="parameter"><code>title</code></em>
|
||
as well. <em class="parameter"><code>title</code></em>
|
||
must be in UTF-8 encoding (as with all
|
||
user-readable strings in GDK/GTK+). <em class="parameter"><code>title</code></em>
|
||
may not be <code class="literal">NULL</code>.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-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 toplevel <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</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 <em class="parameter"><code>window</code></em>
|
||
</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-set-background"></a><h3>gdk_window_set_background ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gdk_window_set_background (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code>const <a class="link" href="gdk3-Colors.html#GdkColor" title="GdkColor"><span class="type">GdkColor</span></a> *color</code></em>);</pre>
|
||
<div class="warning">
|
||
<p><code class="literal">gdk_window_set_background</code> has been deprecated since version 3.4 and should not be used in newly-written code.</p>
|
||
<p>Don't use this function</p>
|
||
</div>
|
||
<p>Sets the background color of <em class="parameter"><code>window</code></em>
|
||
.</p>
|
||
<p>However, when using GTK+, influence the background of a widget
|
||
using a style class or CSS — if you’re an application — or with
|
||
<code class="function">gtk_style_context_set_background()</code> — if you're implementing a
|
||
custom widget.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-set-background.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="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>color</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="gdk3-Colors.html#GdkColor" title="GdkColor"><span class="type">GdkColor</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-set-background-rgba"></a><h3>gdk_window_set_background_rgba ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gdk_window_set_background_rgba (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code>const <a class="link" href="gdk3-RGBA-Colors.html#GdkRGBA" title="GdkRGBA"><span class="type">GdkRGBA</span></a> *rgba</code></em>);</pre>
|
||
<div class="warning">
|
||
<p><code class="literal">gdk_window_set_background_rgba</code> has been deprecated since version 3.22 and should not be used in newly-written code.</p>
|
||
<p>Don't use this function</p>
|
||
</div>
|
||
<p>Sets the background color of <em class="parameter"><code>window</code></em>
|
||
.</p>
|
||
<p>See also <a class="link" href="gdk3-Windows.html#gdk-window-set-background-pattern" title="gdk_window_set_background_pattern ()"><code class="function">gdk_window_set_background_pattern()</code></a>.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-set-background-rgba.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="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>rgba</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="gdk3-RGBA-Colors.html#GdkRGBA" title="GdkRGBA"><span class="type">GdkRGBA</span></a> color</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-set-background-pattern"></a><h3>gdk_window_set_background_pattern ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gdk_window_set_background_pattern (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/cairo/cairo-cairo-pattern-t.html#cairo-pattern-t"><span class="type">cairo_pattern_t</span></a> *pattern</code></em>);</pre>
|
||
<div class="warning">
|
||
<p><code class="literal">gdk_window_set_background_pattern</code> has been deprecated since version 3.22 and should not be used in newly-written code.</p>
|
||
<p>Don't use this function</p>
|
||
</div>
|
||
<p>Sets the background of <em class="parameter"><code>window</code></em>
|
||
.</p>
|
||
<p>A background of <code class="literal">NULL</code> means that the window won't have any background. On the
|
||
X11 backend it's also possible to inherit the background from the parent
|
||
window using <a class="link" href="gdk3-X-Window-System-Interaction.html#gdk-x11-get-parent-relative-pattern" title="gdk_x11_get_parent_relative_pattern ()"><code class="function">gdk_x11_get_parent_relative_pattern()</code></a>.</p>
|
||
<p>The windowing system will normally fill a window with its background
|
||
when the window is obscured then exposed.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-set-background-pattern.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="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>pattern</p></td>
|
||
<td class="parameter_description"><p>a pattern to use, 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="gdk-window-get-background-pattern"></a><h3>gdk_window_get_background_pattern ()</h3>
|
||
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/cairo/cairo-cairo-pattern-t.html#cairo-pattern-t"><span class="returnvalue">cairo_pattern_t</span></a> *
|
||
gdk_window_get_background_pattern (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre>
|
||
<div class="warning">
|
||
<p><code class="literal">gdk_window_get_background_pattern</code> has been deprecated since version 3.22 and should not be used in newly-written code.</p>
|
||
<p>Don't use this function</p>
|
||
</div>
|
||
<p>Gets the pattern used to clear the background on <em class="parameter"><code>window</code></em>
|
||
.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-get-background-pattern.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 window</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-get-background-pattern.returns"></a><h4>Returns</h4>
|
||
<p>The pattern to use for the
|
||
background or <code class="literal">NULL</code> if there is no background. </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="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
|
||
</div>
|
||
<p class="since">Since: 2.22</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-set-cursor"></a><h3>gdk_window_set_cursor ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gdk_window_set_cursor (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><a class="link" href="gdk3-Cursors.html#GdkCursor"><span class="type">GdkCursor</span></a> *cursor</code></em>);</pre>
|
||
<p>Sets the default mouse pointer for a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a>.</p>
|
||
<p>Note that <em class="parameter"><code>cursor</code></em>
|
||
must be for the same display as <em class="parameter"><code>window</code></em>
|
||
.</p>
|
||
<p>Use <a class="link" href="gdk3-Cursors.html#gdk-cursor-new-for-display" title="gdk_cursor_new_for_display ()"><code class="function">gdk_cursor_new_for_display()</code></a> or <a class="link" href="gdk3-Cursors.html#gdk-cursor-new-from-pixbuf" title="gdk_cursor_new_from_pixbuf ()"><code class="function">gdk_cursor_new_from_pixbuf()</code></a> to
|
||
create the cursor. To make the cursor invisible, use <a class="link" href="gdk3-Cursors.html#GDK-BLANK-CURSOR:CAPS"><code class="literal">GDK_BLANK_CURSOR</code></a>.
|
||
Passing <code class="literal">NULL</code> for the <em class="parameter"><code>cursor</code></em>
|
||
argument to <a class="link" href="gdk3-Windows.html#gdk-window-set-cursor" title="gdk_window_set_cursor ()"><code class="function">gdk_window_set_cursor()</code></a> means
|
||
that <em class="parameter"><code>window</code></em>
|
||
will use the cursor of its parent window. Most windows
|
||
should use this default.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-set-cursor.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="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>cursor</p></td>
|
||
<td class="parameter_description"><p>a cursor. </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="gdk-window-get-cursor"></a><h3>gdk_window_get_cursor ()</h3>
|
||
<pre class="programlisting"><a class="link" href="gdk3-Cursors.html#GdkCursor"><span class="returnvalue">GdkCursor</span></a> *
|
||
gdk_window_get_cursor (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre>
|
||
<p>Retrieves a <a class="link" href="gdk3-Cursors.html#GdkCursor"><span class="type">GdkCursor</span></a> pointer for the cursor currently set on the
|
||
specified <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a>, or <code class="literal">NULL</code>. If the return value is <code class="literal">NULL</code> then
|
||
there is no custom cursor set on the specified window, and it is
|
||
using the cursor for its parent window.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-get-cursor.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="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-get-cursor.returns"></a><h4>Returns</h4>
|
||
<p>a <a class="link" href="gdk3-Cursors.html#GdkCursor"><span class="type">GdkCursor</span></a>, or <code class="literal">NULL</code>. The
|
||
returned object is owned by the <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> and should not be
|
||
unreferenced directly. Use <a class="link" href="gdk3-Windows.html#gdk-window-set-cursor" title="gdk_window_set_cursor ()"><code class="function">gdk_window_set_cursor()</code></a> to unset the
|
||
cursor of the window. </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="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
|
||
</div>
|
||
<p class="since">Since: 2.18</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-get-user-data"></a><h3>gdk_window_get_user_data ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gdk_window_get_user_data (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><span class="type">gpointer</span> *data</code></em>);</pre>
|
||
<p>Retrieves the user data for <em class="parameter"><code>window</code></em>
|
||
, which is normally the widget
|
||
that <em class="parameter"><code>window</code></em>
|
||
belongs to. See <a class="link" href="gdk3-Windows.html#gdk-window-set-user-data" title="gdk_window_set_user_data ()"><code class="function">gdk_window_set_user_data()</code></a>.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-get-user-data.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="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>data</p></td>
|
||
<td class="parameter_description"><p>return location for user data. </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>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-get-geometry"></a><h3>gdk_window_get_geometry ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gdk_window_get_geometry (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</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>,
|
||
<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>Any of the return location arguments to this function may be <code class="literal">NULL</code>,
|
||
if you aren’t interested in getting the value of that field.</p>
|
||
<p>The X and Y coordinates returned are relative to the parent window
|
||
of <em class="parameter"><code>window</code></em>
|
||
, which for toplevels usually means relative to the
|
||
window decorations (titlebar, etc.) rather than relative to the
|
||
root window (screen-size background window).</p>
|
||
<p>On the X11 platform, the geometry is obtained from the X server,
|
||
so reflects the latest position of <em class="parameter"><code>window</code></em>
|
||
; this may be out-of-sync
|
||
with the position of <em class="parameter"><code>window</code></em>
|
||
delivered in the most-recently-processed
|
||
<a class="link" href="gdk3-Event-Structures.html#GdkEventConfigure" title="struct GdkEventConfigure"><span class="type">GdkEventConfigure</span></a>. <a class="link" href="gdk3-Windows.html#gdk-window-get-position" title="gdk_window_get_position ()"><code class="function">gdk_window_get_position()</code></a> in contrast gets the
|
||
position from the most recent configure event.</p>
|
||
<p>Note: If <em class="parameter"><code>window</code></em>
|
||
is not a toplevel, it is much better
|
||
to call <a class="link" href="gdk3-Windows.html#gdk-window-get-position" title="gdk_window_get_position ()"><code class="function">gdk_window_get_position()</code></a>, <a class="link" href="gdk3-Windows.html#gdk-window-get-width" title="gdk_window_get_width ()"><code class="function">gdk_window_get_width()</code></a> and
|
||
<a class="link" href="gdk3-Windows.html#gdk-window-get-height" title="gdk_window_get_height ()"><code class="function">gdk_window_get_height()</code></a> instead, because it avoids the roundtrip to
|
||
the X server and because these functions support the full 32-bit
|
||
coordinate space, whereas <a class="link" href="gdk3-Windows.html#gdk-window-get-geometry" title="gdk_window_get_geometry ()"><code class="function">gdk_window_get_geometry()</code></a> is restricted to
|
||
the 16-bit coordinates of X11.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-get-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="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>x</p></td>
|
||
<td class="parameter_description"><p>return location for X coordinate of window (relative to its parent). </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>y</p></td>
|
||
<td class="parameter_description"><p>return location for Y coordinate of window (relative to its parent). </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>width</p></td>
|
||
<td class="parameter_description"><p>return location for width of window. </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>return location for height of window. </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="gdk-window-set-geometry-hints"></a><h3>gdk_window_set_geometry_hints ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gdk_window_set_geometry_hints (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code>const <a class="link" href="gdk3-Windows.html#GdkGeometry" title="struct GdkGeometry"><span class="type">GdkGeometry</span></a> *geometry</code></em>,
|
||
<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindowHints" title="enum GdkWindowHints"><span class="type">GdkWindowHints</span></a> geom_mask</code></em>);</pre>
|
||
<p>Sets the geometry hints for <em class="parameter"><code>window</code></em>
|
||
. Hints flagged in <em class="parameter"><code>geom_mask</code></em>
|
||
|
||
are set, hints not flagged in <em class="parameter"><code>geom_mask</code></em>
|
||
are unset.
|
||
To unset all hints, use a <em class="parameter"><code>geom_mask</code></em>
|
||
of 0 and a <em class="parameter"><code>geometry</code></em>
|
||
of <code class="literal">NULL</code>.</p>
|
||
<p>This function provides hints to the windowing system about
|
||
acceptable sizes for a toplevel window. The purpose of
|
||
this is to constrain user resizing, but the windowing system
|
||
will typically (but is not required to) also constrain the
|
||
current size of the window to the provided values and
|
||
constrain programatic resizing via <a class="link" href="gdk3-Windows.html#gdk-window-resize" title="gdk_window_resize ()"><code class="function">gdk_window_resize()</code></a> or
|
||
<a class="link" href="gdk3-Windows.html#gdk-window-move-resize" title="gdk_window_move_resize ()"><code class="function">gdk_window_move_resize()</code></a>.</p>
|
||
<p>Note that on X11, this effect has no effect on windows
|
||
of type <a class="link" href="gdk3-Windows.html#GDK-WINDOW-TEMP:CAPS"><code class="literal">GDK_WINDOW_TEMP</code></a> or windows where override redirect
|
||
has been turned on via <a class="link" href="gdk3-Windows.html#gdk-window-set-override-redirect" title="gdk_window_set_override_redirect ()"><code class="function">gdk_window_set_override_redirect()</code></a>
|
||
since these windows are not resizable by the user.</p>
|
||
<p>Since you can’t count on the windowing system doing the
|
||
constraints for programmatic resizes, you should generally
|
||
call <a class="link" href="gdk3-Windows.html#gdk-window-constrain-size" title="gdk_window_constrain_size ()"><code class="function">gdk_window_constrain_size()</code></a> yourself to determine
|
||
appropriate sizes.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-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 toplevel <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</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 hints</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>geom_mask</p></td>
|
||
<td class="parameter_description"><p>bitmask indicating fields of <em class="parameter"><code>geometry</code></em>
|
||
to pay attention to</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-get-width"></a><h3>gdk_window_get_width ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">int</span>
|
||
gdk_window_get_width (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre>
|
||
<p>Returns the width of the given <em class="parameter"><code>window</code></em>
|
||
.</p>
|
||
<p>On the X11 platform the returned size is the size reported in the
|
||
most-recently-processed configure event, rather than the current
|
||
size on the X server.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-get-width.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="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-get-width.returns"></a><h4>Returns</h4>
|
||
<p> The width of <em class="parameter"><code>window</code></em>
|
||
</p>
|
||
</div>
|
||
<p class="since">Since: 2.24</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-get-height"></a><h3>gdk_window_get_height ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">int</span>
|
||
gdk_window_get_height (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre>
|
||
<p>Returns the height of the given <em class="parameter"><code>window</code></em>
|
||
.</p>
|
||
<p>On the X11 platform the returned size is the size reported in the
|
||
most-recently-processed configure event, rather than the current
|
||
size on the X server.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-get-height.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="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-get-height.returns"></a><h4>Returns</h4>
|
||
<p> The height of <em class="parameter"><code>window</code></em>
|
||
</p>
|
||
</div>
|
||
<p class="since">Since: 2.24</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-set-icon-list"></a><h3>gdk_window_set_icon_list ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gdk_window_set_icon_list (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><span class="type">GList</span> *pixbufs</code></em>);</pre>
|
||
<p>Sets a list of icons for the window. One of these will be used
|
||
to represent the window when it has been iconified. The icon is
|
||
usually shown in an icon box or some sort of task bar. Which icon
|
||
size is shown depends on the window manager. The window manager
|
||
can scale the icon but setting several size icons can give better
|
||
image quality since the window manager may only need to scale the
|
||
icon by a small amount or not at all.</p>
|
||
<p>Note that some platforms don't support window icons.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-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>The <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> toplevel window to set the icon of.</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>pixbufs</p></td>
|
||
<td class="parameter_description"><p>A list of pixbufs, of different sizes. </p></td>
|
||
<td class="parameter_annotations"><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>][<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="gdk-window-set-modal-hint"></a><h3>gdk_window_set_modal_hint ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gdk_window_set_modal_hint (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><span class="type">gboolean</span> modal</code></em>);</pre>
|
||
<p>The application can use this hint to tell the window manager
|
||
that a certain window has modal behaviour. The window manager
|
||
can use this information to handle modal windows in a special
|
||
way.</p>
|
||
<p>You should only use this on windows for which you have
|
||
previously called <a class="link" href="gdk3-Windows.html#gdk-window-set-transient-for" title="gdk_window_set_transient_for ()"><code class="function">gdk_window_set_transient_for()</code></a></p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-set-modal-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 toplevel <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>modal</p></td>
|
||
<td class="parameter_description"><p><code class="literal">TRUE</code> if the window is modal, <code class="literal">FALSE</code> otherwise.</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-get-modal-hint"></a><h3>gdk_window_get_modal_hint ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gdk_window_get_modal_hint (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre>
|
||
<p>Determines whether or not the window manager is hinted that <em class="parameter"><code>window</code></em>
|
||
|
||
has modal behaviour.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-get-modal-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 toplevel <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a>.</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-get-modal-hint.returns"></a><h4>Returns</h4>
|
||
<p> whether or not the window has the modal hint set.</p>
|
||
</div>
|
||
<p class="since">Since: 2.22</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-set-type-hint"></a><h3>gdk_window_set_type_hint ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gdk_window_set_type_hint (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindowTypeHint" title="enum GdkWindowTypeHint"><span class="type">GdkWindowTypeHint</span></a> hint</code></em>);</pre>
|
||
<p>The application can use this call to provide a hint to the window
|
||
manager about the functionality of a window. The window manager
|
||
can use this information when determining the decoration and behaviour
|
||
of the window.</p>
|
||
<p>The hint must be set before the window is mapped.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-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 toplevel <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>hint</p></td>
|
||
<td class="parameter_description"><p>A hint of the function this window will have</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-get-type-hint"></a><h3>gdk_window_get_type_hint ()</h3>
|
||
<pre class="programlisting"><a class="link" href="gdk3-Windows.html#GdkWindowTypeHint" title="enum GdkWindowTypeHint"><span class="returnvalue">GdkWindowTypeHint</span></a>
|
||
gdk_window_get_type_hint (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre>
|
||
<p>This function returns the type hint set for a window.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-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 toplevel <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-get-type-hint.returns"></a><h4>Returns</h4>
|
||
<p> The type hint set for <em class="parameter"><code>window</code></em>
|
||
</p>
|
||
</div>
|
||
<p class="since">Since: 2.10</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-set-shadow-width"></a><h3>gdk_window_set_shadow_width ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gdk_window_set_shadow_width (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><span class="type">gint</span> left</code></em>,
|
||
<em class="parameter"><code><span class="type">gint</span> right</code></em>,
|
||
<em class="parameter"><code><span class="type">gint</span> top</code></em>,
|
||
<em class="parameter"><code><span class="type">gint</span> bottom</code></em>);</pre>
|
||
<p>Newer GTK+ windows using client-side decorations use extra geometry
|
||
around their frames for effects like shadows and invisible borders.
|
||
Window managers that want to maximize windows or snap to edges need
|
||
to know where the extents of the actual frame lie, so that users
|
||
don’t feel like windows are snapping against random invisible edges.</p>
|
||
<p>Note that this property is automatically updated by GTK+, so this
|
||
function should only be used by applications which do not use GTK+
|
||
to create toplevel windows.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-set-shadow-width.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="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>left</p></td>
|
||
<td class="parameter_description"><p>The left extent</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>right</p></td>
|
||
<td class="parameter_description"><p>The right extent</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>top</p></td>
|
||
<td class="parameter_description"><p>The top extent</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>bottom</p></td>
|
||
<td class="parameter_description"><p>The bottom extent</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</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="gdk-window-set-skip-taskbar-hint"></a><h3>gdk_window_set_skip_taskbar_hint ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gdk_window_set_skip_taskbar_hint (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><span class="type">gboolean</span> skips_taskbar</code></em>);</pre>
|
||
<p>Toggles whether a window should appear in a task list or window
|
||
list. If a window’s semantic type as specified with
|
||
<a class="link" href="gdk3-Windows.html#gdk-window-set-type-hint" title="gdk_window_set_type_hint ()"><code class="function">gdk_window_set_type_hint()</code></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.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-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 toplevel <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>skips_taskbar</p></td>
|
||
<td class="parameter_description"><p><code class="literal">TRUE</code> to skip the taskbar</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="gdk-window-set-skip-pager-hint"></a><h3>gdk_window_set_skip_pager_hint ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gdk_window_set_skip_pager_hint (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><span class="type">gboolean</span> skips_pager</code></em>);</pre>
|
||
<p>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). If a
|
||
window’s semantic type as specified with <a class="link" href="gdk3-Windows.html#gdk-window-set-type-hint" title="gdk_window_set_type_hint ()"><code class="function">gdk_window_set_type_hint()</code></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.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-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 toplevel <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>skips_pager</p></td>
|
||
<td class="parameter_description"><p><code class="literal">TRUE</code> to skip 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="gdk-window-set-urgency-hint"></a><h3>gdk_window_set_urgency_hint ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gdk_window_set_urgency_hint (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><span class="type">gboolean</span> urgent</code></em>);</pre>
|
||
<p>Toggles whether a window needs the user's
|
||
urgent attention.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-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 toplevel <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>urgent</p></td>
|
||
<td class="parameter_description"><p><code class="literal">TRUE</code> if the window is 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="gdk-window-get-position"></a><h3>gdk_window_get_position ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gdk_window_get_position (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</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>Obtains the position of the window as reported in the
|
||
most-recently-processed <a class="link" href="gdk3-Event-Structures.html#GdkEventConfigure" title="struct GdkEventConfigure"><span class="type">GdkEventConfigure</span></a>. Contrast with
|
||
<a class="link" href="gdk3-Windows.html#gdk-window-get-geometry" title="gdk_window_get_geometry ()"><code class="function">gdk_window_get_geometry()</code></a> which queries the X server for the
|
||
current window position, regardless of which events have been
|
||
received or processed.</p>
|
||
<p>The position coordinates are relative to the window’s parent window.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-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="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</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 of window. </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>y</p></td>
|
||
<td class="parameter_description"><p>Y coordinate of window. </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="gdk-window-get-root-origin"></a><h3>gdk_window_get_root_origin ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gdk_window_get_root_origin (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</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>Obtains the top-left corner of the window manager frame in root
|
||
window coordinates.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-get-root-origin.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 toplevel <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>x</p></td>
|
||
<td class="parameter_description"><p>return location for X position of window frame. </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>
|
||
<tr>
|
||
<td class="parameter_name"><p>y</p></td>
|
||
<td class="parameter_description"><p>return location for Y position of window frame. </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>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-get-frame-extents"></a><h3>gdk_window_get_frame_extents ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gdk_window_get_frame_extents (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><a class="link" href="gdk3-Points-Rectangles-and-Regions.html#GdkRectangle" title="GdkRectangle"><span class="type">GdkRectangle</span></a> *rect</code></em>);</pre>
|
||
<p>Obtains the bounding box of the window, including window manager
|
||
titlebar/borders if any. The frame position is given in root window
|
||
coordinates. To get the position of the window itself (rather than
|
||
the frame) in root window coordinates, use <a class="link" href="gdk3-Windows.html#gdk-window-get-origin" title="gdk_window_get_origin ()"><code class="function">gdk_window_get_origin()</code></a>.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-get-frame-extents.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 toplevel <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>rect</p></td>
|
||
<td class="parameter_description"><p>rectangle to fill with bounding box of the window frame. </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>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-get-origin"></a><h3>gdk_window_get_origin ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gint</span>
|
||
gdk_window_get_origin (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</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>Obtains the position of a window in root window coordinates.
|
||
(Compare with <a class="link" href="gdk3-Windows.html#gdk-window-get-position" title="gdk_window_get_position ()"><code class="function">gdk_window_get_position()</code></a> and
|
||
<a class="link" href="gdk3-Windows.html#gdk-window-get-geometry" title="gdk_window_get_geometry ()"><code class="function">gdk_window_get_geometry()</code></a> which return the position of a window
|
||
relative to its parent window.)</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-get-origin.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="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>x</p></td>
|
||
<td class="parameter_description"><p>return location for X coordinate. </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>y</p></td>
|
||
<td class="parameter_description"><p>return location for Y coordinate. </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 class="refsect3">
|
||
<a name="gdk-window-get-origin.returns"></a><h4>Returns</h4>
|
||
<p> not meaningful, ignore</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-get-root-coords"></a><h3>gdk_window_get_root_coords ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gdk_window_get_root_coords (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</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>,
|
||
<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>Obtains the position of a window position in root
|
||
window coordinates. This is similar to
|
||
<a class="link" href="gdk3-Windows.html#gdk-window-get-origin" title="gdk_window_get_origin ()"><code class="function">gdk_window_get_origin()</code></a> but allows you to pass
|
||
in any position in the window, not just the origin.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-get-root-coords.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="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</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 in window</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>y</p></td>
|
||
<td class="parameter_description"><p>Y coordinate in window</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. </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>
|
||
<tr>
|
||
<td class="parameter_name"><p>root_y</p></td>
|
||
<td class="parameter_description"><p>return location for Y coordinate. </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>
|
||
<p class="since">Since: 2.18</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-get-pointer"></a><h3>gdk_window_get_pointer ()</h3>
|
||
<pre class="programlisting"><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="returnvalue">GdkWindow</span></a> *
|
||
gdk_window_get_pointer (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</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>,
|
||
<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkModifierType" title="enum GdkModifierType"><span class="type">GdkModifierType</span></a> *mask</code></em>);</pre>
|
||
<div class="warning">
|
||
<p><code class="literal">gdk_window_get_pointer</code> has been deprecated since version 3.0 and should not be used in newly-written code.</p>
|
||
<p>Use <a class="link" href="gdk3-Windows.html#gdk-window-get-device-position" title="gdk_window_get_device_position ()"><code class="function">gdk_window_get_device_position()</code></a> instead.</p>
|
||
</div>
|
||
<p>Obtains the current pointer position and modifier state.
|
||
The position is given in coordinates relative to the upper left
|
||
corner of <em class="parameter"><code>window</code></em>
|
||
.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-get-pointer.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="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>x</p></td>
|
||
<td class="parameter_description"><p>return location for X coordinate of pointer or <code class="literal">NULL</code> to not
|
||
return the X coordinate. </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>y</p></td>
|
||
<td class="parameter_description"><p>return location for Y coordinate of pointer or <code class="literal">NULL</code> to not
|
||
return the Y coordinate. </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>mask</p></td>
|
||
<td class="parameter_description"><p>return location for modifier mask or <code class="literal">NULL</code> to not return the
|
||
modifier mask. </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 class="refsect3">
|
||
<a name="gdk-window-get-pointer.returns"></a><h4>Returns</h4>
|
||
<p>the window containing the
|
||
pointer (as with <a class="link" href="gdk3-Windows.html#gdk-window-at-pointer" title="gdk_window_at_pointer ()"><code class="function">gdk_window_at_pointer()</code></a>), or <code class="literal">NULL</code> if the window
|
||
containing the pointer isn’t known to GDK. </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="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-get-device-position"></a><h3>gdk_window_get_device_position ()</h3>
|
||
<pre class="programlisting"><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="returnvalue">GdkWindow</span></a> *
|
||
gdk_window_get_device_position (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GdkDevice.html" title="GdkDevice"><span class="type">GdkDevice</span></a> *device</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>,
|
||
<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkModifierType" title="enum GdkModifierType"><span class="type">GdkModifierType</span></a> *mask</code></em>);</pre>
|
||
<p>Obtains the current device position and modifier state.
|
||
The position is given in coordinates relative to the upper left
|
||
corner of <em class="parameter"><code>window</code></em>
|
||
.</p>
|
||
<p>Use <a class="link" href="gdk3-Windows.html#gdk-window-get-device-position-double" title="gdk_window_get_device_position_double ()"><code class="function">gdk_window_get_device_position_double()</code></a> if you need subpixel precision.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-get-device-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="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a>.</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>device</p></td>
|
||
<td class="parameter_description"><p>pointer <a class="link" href="GdkDevice.html" title="GdkDevice"><span class="type">GdkDevice</span></a> to query to.</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>x</p></td>
|
||
<td class="parameter_description"><p>return location for the X coordinate of <em class="parameter"><code>device</code></em>
|
||
, 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>y</p></td>
|
||
<td class="parameter_description"><p>return location for the Y coordinate of <em class="parameter"><code>device</code></em>
|
||
, 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>mask</p></td>
|
||
<td class="parameter_description"><p>return location for the modifier mask, 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 class="refsect3">
|
||
<a name="gdk-window-get-device-position.returns"></a><h4>Returns</h4>
|
||
<p>The window underneath <em class="parameter"><code>device</code></em>
|
||
(as with <a class="link" href="GdkDevice.html#gdk-device-get-window-at-position" title="gdk_device_get_window_at_position ()"><code class="function">gdk_device_get_window_at_position()</code></a>), or <code class="literal">NULL</code> if the
|
||
window is not known to GDK. </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="Don't free data after the code is done."><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="gdk-window-get-device-position-double"></a><h3>gdk_window_get_device_position_double ()</h3>
|
||
<pre class="programlisting"><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="returnvalue">GdkWindow</span></a> *
|
||
gdk_window_get_device_position_double (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GdkDevice.html" title="GdkDevice"><span class="type">GdkDevice</span></a> *device</code></em>,
|
||
<em class="parameter"><code><span class="type">gdouble</span> *x</code></em>,
|
||
<em class="parameter"><code><span class="type">gdouble</span> *y</code></em>,
|
||
<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkModifierType" title="enum GdkModifierType"><span class="type">GdkModifierType</span></a> *mask</code></em>);</pre>
|
||
<p>Obtains the current device position in doubles and modifier state.
|
||
The position is given in coordinates relative to the upper left
|
||
corner of <em class="parameter"><code>window</code></em>
|
||
.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-get-device-position-double.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="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a>.</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>device</p></td>
|
||
<td class="parameter_description"><p>pointer <a class="link" href="GdkDevice.html" title="GdkDevice"><span class="type">GdkDevice</span></a> to query to.</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>x</p></td>
|
||
<td class="parameter_description"><p>return location for the X coordinate of <em class="parameter"><code>device</code></em>
|
||
, 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>y</p></td>
|
||
<td class="parameter_description"><p>return location for the Y coordinate of <em class="parameter"><code>device</code></em>
|
||
, 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>mask</p></td>
|
||
<td class="parameter_description"><p>return location for the modifier mask, 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 class="refsect3">
|
||
<a name="gdk-window-get-device-position-double.returns"></a><h4>Returns</h4>
|
||
<p>The window underneath <em class="parameter"><code>device</code></em>
|
||
(as with <a class="link" href="GdkDevice.html#gdk-device-get-window-at-position" title="gdk_device_get_window_at_position ()"><code class="function">gdk_device_get_window_at_position()</code></a>), or <code class="literal">NULL</code> if the
|
||
window is not known to GDK. </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="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
|
||
</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="gdk-window-get-parent"></a><h3>gdk_window_get_parent ()</h3>
|
||
<pre class="programlisting"><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="returnvalue">GdkWindow</span></a> *
|
||
gdk_window_get_parent (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre>
|
||
<p>Obtains the parent of <em class="parameter"><code>window</code></em>
|
||
, as known to GDK. Does not query the
|
||
X server; thus this returns the parent as passed to <a class="link" href="gdk3-Windows.html#gdk-window-new" title="gdk_window_new ()"><code class="function">gdk_window_new()</code></a>,
|
||
not the actual parent. This should never matter unless you’re using
|
||
Xlib calls mixed with GDK calls on the X11 platform. It may also
|
||
matter for toplevel windows, because the window manager may choose
|
||
to reparent them.</p>
|
||
<p>Note that you should use <a class="link" href="gdk3-Windows.html#gdk-window-get-effective-parent" title="gdk_window_get_effective_parent ()"><code class="function">gdk_window_get_effective_parent()</code></a> when
|
||
writing generic code that walks up a window hierarchy, because
|
||
<a class="link" href="gdk3-Windows.html#gdk-window-get-parent" title="gdk_window_get_parent ()"><code class="function">gdk_window_get_parent()</code></a> will most likely not do what you expect if
|
||
there are offscreen windows in the hierarchy.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-get-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="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-get-parent.returns"></a><h4>Returns</h4>
|
||
<p>parent of <em class="parameter"><code>window</code></em>
|
||
. </p>
|
||
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-get-toplevel"></a><h3>gdk_window_get_toplevel ()</h3>
|
||
<pre class="programlisting"><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="returnvalue">GdkWindow</span></a> *
|
||
gdk_window_get_toplevel (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre>
|
||
<p>Gets the toplevel window that’s an ancestor of <em class="parameter"><code>window</code></em>
|
||
.</p>
|
||
<p>Any window type but <a class="link" href="gdk3-Windows.html#GDK-WINDOW-CHILD:CAPS"><code class="literal">GDK_WINDOW_CHILD</code></a> is considered a
|
||
toplevel window, as is a <a class="link" href="gdk3-Windows.html#GDK-WINDOW-CHILD:CAPS"><code class="literal">GDK_WINDOW_CHILD</code></a> window that
|
||
has a root window as parent.</p>
|
||
<p>Note that you should use <a class="link" href="gdk3-Windows.html#gdk-window-get-effective-toplevel" title="gdk_window_get_effective_toplevel ()"><code class="function">gdk_window_get_effective_toplevel()</code></a> when
|
||
you want to get to a window’s toplevel as seen on screen, because
|
||
<a class="link" href="gdk3-Windows.html#gdk-window-get-toplevel" title="gdk_window_get_toplevel ()"><code class="function">gdk_window_get_toplevel()</code></a> will most likely not do what you expect
|
||
if there are offscreen windows in the hierarchy.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-get-toplevel.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="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-get-toplevel.returns"></a><h4>Returns</h4>
|
||
<p>the toplevel window containing <em class="parameter"><code>window</code></em>
|
||
. </p>
|
||
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-get-children"></a><h3>gdk_window_get_children ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">GList</span> *
|
||
gdk_window_get_children (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre>
|
||
<p>Gets the list of children of <em class="parameter"><code>window</code></em>
|
||
known to GDK.
|
||
This function only returns children created via GDK,
|
||
so for example it’s useless when used with the root window;
|
||
it only returns windows an application created itself.</p>
|
||
<p>The returned list must be freed, but the elements in the
|
||
list need not be.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-get-children.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="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-get-children.returns"></a><h4>Returns</h4>
|
||
<p>list of child windows inside <em class="parameter"><code>window</code></em>
|
||
. </p>
|
||
<p><span class="annotation">[<acronym title="Free data container after the code is done."><span class="acronym">transfer container</span></acronym>][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> GdkWindow]</span></p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-get-children-with-user-data"></a><h3>gdk_window_get_children_with_user_data ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">GList</span> *
|
||
gdk_window_get_children_with_user_data
|
||
(<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><span class="type">gpointer</span> user_data</code></em>);</pre>
|
||
<p>Gets the list of children of <em class="parameter"><code>window</code></em>
|
||
known to GDK with a
|
||
particular <em class="parameter"><code>user_data</code></em>
|
||
set on it.</p>
|
||
<p>The returned list must be freed, but the elements in the
|
||
list need not be.</p>
|
||
<p>The list is returned in (relative) stacking order, i.e. the
|
||
lowest window is first.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-get-children-with-user-data.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="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></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 to look for</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-get-children-with-user-data.returns"></a><h4>Returns</h4>
|
||
<p>list of child windows inside <em class="parameter"><code>window</code></em>
|
||
. </p>
|
||
<p><span class="annotation">[<acronym title="Free data container after the code is done."><span class="acronym">transfer container</span></acronym>][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> GdkWindow]</span></p>
|
||
</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="gdk-window-peek-children"></a><h3>gdk_window_peek_children ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">GList</span> *
|
||
gdk_window_peek_children (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre>
|
||
<p>Like <a class="link" href="gdk3-Windows.html#gdk-window-get-children" title="gdk_window_get_children ()"><code class="function">gdk_window_get_children()</code></a>, but does not copy the list of
|
||
children, so the list does not need to be freed.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-peek-children.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="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-peek-children.returns"></a><h4>Returns</h4>
|
||
<p>a reference to the list of child windows in <em class="parameter"><code>window</code></em>
|
||
. </p>
|
||
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> GdkWindow]</span></p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-get-events"></a><h3>gdk_window_get_events ()</h3>
|
||
<pre class="programlisting"><a class="link" href="gdk3-Events.html#GdkEventMask" title="enum GdkEventMask"><span class="returnvalue">GdkEventMask</span></a>
|
||
gdk_window_get_events (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre>
|
||
<p>Gets the event mask for <em class="parameter"><code>window</code></em>
|
||
for all master input devices. See
|
||
<a class="link" href="gdk3-Windows.html#gdk-window-set-events" title="gdk_window_set_events ()"><code class="function">gdk_window_set_events()</code></a>.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-get-events.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="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-get-events.returns"></a><h4>Returns</h4>
|
||
<p> event mask for <em class="parameter"><code>window</code></em>
|
||
</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-set-events"></a><h3>gdk_window_set_events ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gdk_window_set_events (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><a class="link" href="gdk3-Events.html#GdkEventMask" title="enum GdkEventMask"><span class="type">GdkEventMask</span></a> event_mask</code></em>);</pre>
|
||
<p>The event mask for a window determines which events will be reported
|
||
for that window from all master input devices. For example, an event mask
|
||
including <a class="link" href="gdk3-Events.html#GDK-BUTTON-PRESS-MASK:CAPS"><span class="type">GDK_BUTTON_PRESS_MASK</span></a> means the window should report button
|
||
press events. The event mask is the bitwise OR of values from the
|
||
<a class="link" href="gdk3-Events.html#GdkEventMask" title="enum GdkEventMask"><span class="type">GdkEventMask</span></a> enumeration.</p>
|
||
<p>See the input handling overview for details.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-set-events.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="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>event_mask</p></td>
|
||
<td class="parameter_description"><p>event mask for <em class="parameter"><code>window</code></em>
|
||
</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-set-icon-name"></a><h3>gdk_window_set_icon_name ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gdk_window_set_icon_name (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code>const <span class="type">gchar</span> *name</code></em>);</pre>
|
||
<p>Windows may have a name used while minimized, distinct from the
|
||
name they display in their titlebar. Most of the time this is a bad
|
||
idea from a user interface standpoint. But you can set such a name
|
||
with this function, if you like.</p>
|
||
<p>After calling this with a non-<code class="literal">NULL</code> <em class="parameter"><code>name</code></em>
|
||
, calls to <a class="link" href="gdk3-Windows.html#gdk-window-set-title" title="gdk_window_set_title ()"><code class="function">gdk_window_set_title()</code></a>
|
||
will not update the icon title.</p>
|
||
<p>Using <code class="literal">NULL</code> for <em class="parameter"><code>name</code></em>
|
||
unsets the icon title; further calls to
|
||
<a class="link" href="gdk3-Windows.html#gdk-window-set-title" title="gdk_window_set_title ()"><code class="function">gdk_window_set_title()</code></a> will again update the icon title as well.</p>
|
||
<p>Note that some platforms don't support window icons.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-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 toplevel <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>name</p></td>
|
||
<td class="parameter_description"><p>name of window while iconified (minimized). </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="gdk-window-set-transient-for"></a><h3>gdk_window_set_transient_for ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gdk_window_set_transient_for (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *parent</code></em>);</pre>
|
||
<p>Indicates to the window manager that <em class="parameter"><code>window</code></em>
|
||
is a transient dialog
|
||
associated with the application window <em class="parameter"><code>parent</code></em>
|
||
. This allows the
|
||
window manager to do things like center <em class="parameter"><code>window</code></em>
|
||
on <em class="parameter"><code>parent</code></em>
|
||
and
|
||
keep <em class="parameter"><code>window</code></em>
|
||
above <em class="parameter"><code>parent</code></em>
|
||
.</p>
|
||
<p>See <code class="function">gtk_window_set_transient_for()</code> if you’re using <span class="type">GtkWindow</span> or
|
||
<span class="type">GtkDialog</span>.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-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 toplevel <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>parent</p></td>
|
||
<td class="parameter_description"><p>another toplevel <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-set-role"></a><h3>gdk_window_set_role ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gdk_window_set_role (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code>const <span class="type">gchar</span> *role</code></em>);</pre>
|
||
<p>When using GTK+, typically you should use <code class="function">gtk_window_set_role()</code> instead
|
||
of this low-level function.</p>
|
||
<p>The window manager and session manager use a window’s role to
|
||
distinguish it from other kinds of window in the same application.
|
||
When an application is restarted after being saved in a previous
|
||
session, all windows with the same title and role are treated as
|
||
interchangeable. So if you have two windows with the same title
|
||
that should be distinguished for session management purposes, you
|
||
should set the role on those windows. It doesn’t matter what string
|
||
you use for the role, as long as you have a different role for each
|
||
non-interchangeable kind of window.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-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 toplevel <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>role</p></td>
|
||
<td class="parameter_description"><p>a string indicating its role</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-set-startup-id"></a><h3>gdk_window_set_startup_id ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gdk_window_set_startup_id (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code>const <span class="type">gchar</span> *startup_id</code></em>);</pre>
|
||
<p>When using GTK+, typically you should use <code class="function">gtk_window_set_startup_id()</code>
|
||
instead of this low-level function.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-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 toplevel <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</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="gdk-window-set-group"></a><h3>gdk_window_set_group ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gdk_window_set_group (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *leader</code></em>);</pre>
|
||
<p>Sets the group leader window for <em class="parameter"><code>window</code></em>
|
||
. By default,
|
||
GDK sets the group leader for all toplevel windows
|
||
to a global window implicitly created by GDK. With this function
|
||
you can override this default.</p>
|
||
<p>The group leader window allows the window manager to distinguish
|
||
all windows that belong to a single application. It may for example
|
||
allow users to minimize/unminimize all windows belonging to an
|
||
application at once. You should only set a non-default group window
|
||
if your application pretends to be multiple applications.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-set-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 toplevel <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>leader</p></td>
|
||
<td class="parameter_description"><p>group leader window, or <code class="literal">NULL</code> to restore the default group leader 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="gdk-window-get-group"></a><h3>gdk_window_get_group ()</h3>
|
||
<pre class="programlisting"><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="returnvalue">GdkWindow</span></a> *
|
||
gdk_window_get_group (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre>
|
||
<p>Returns the group leader window for <em class="parameter"><code>window</code></em>
|
||
. See <a class="link" href="gdk3-Windows.html#gdk-window-set-group" title="gdk_window_set_group ()"><code class="function">gdk_window_set_group()</code></a>.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-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 toplevel <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-get-group.returns"></a><h4>Returns</h4>
|
||
<p>the group leader window for <em class="parameter"><code>window</code></em>
|
||
. </p>
|
||
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
|
||
</div>
|
||
<p class="since">Since: 2.4</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-set-decorations"></a><h3>gdk_window_set_decorations ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gdk_window_set_decorations (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWMDecoration" title="enum GdkWMDecoration"><span class="type">GdkWMDecoration</span></a> decorations</code></em>);</pre>
|
||
<p>“Decorations” are the features the window manager adds to a toplevel <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a>.
|
||
This function sets the traditional Motif window manager hints that tell the
|
||
window manager which decorations you would like your window to have.
|
||
Usually you should use <code class="function">gtk_window_set_decorated()</code> on a <span class="type">GtkWindow</span> instead of
|
||
using the GDK function directly.</p>
|
||
<p>The <em class="parameter"><code>decorations</code></em>
|
||
argument is the logical OR of the fields in
|
||
the <a class="link" href="gdk3-Windows.html#GdkWMDecoration" title="enum GdkWMDecoration"><span class="type">GdkWMDecoration</span></a> enumeration. If <a class="link" href="gdk3-Windows.html#GDK-DECOR-ALL:CAPS"><span class="type">GDK_DECOR_ALL</span></a> is included in the
|
||
mask, the other bits indicate which decorations should be turned off.
|
||
If <a class="link" href="gdk3-Windows.html#GDK-DECOR-ALL:CAPS"><span class="type">GDK_DECOR_ALL</span></a> is not included, then the other bits indicate
|
||
which decorations should be turned on.</p>
|
||
<p>Most window managers honor a decorations hint of 0 to disable all decorations,
|
||
but very few honor all possible combinations of bits.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-set-decorations.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 toplevel <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>decorations</p></td>
|
||
<td class="parameter_description"><p>decoration hint mask</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-get-decorations"></a><h3>gdk_window_get_decorations ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gdk_window_get_decorations (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWMDecoration" title="enum GdkWMDecoration"><span class="type">GdkWMDecoration</span></a> *decorations</code></em>);</pre>
|
||
<p>Returns the decorations set on the GdkWindow with
|
||
<a class="link" href="gdk3-Windows.html#gdk-window-set-decorations" title="gdk_window_set_decorations ()"><code class="function">gdk_window_set_decorations()</code></a>.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-get-decorations.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 toplevel <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> to get the decorations from</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>decorations</p></td>
|
||
<td class="parameter_description"><p>The window decorations will be written here. </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="gdk-window-get-decorations.returns"></a><h4>Returns</h4>
|
||
<p> <code class="literal">TRUE</code> if the window has decorations set, <code class="literal">FALSE</code> otherwise.</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-set-functions"></a><h3>gdk_window_set_functions ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gdk_window_set_functions (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWMFunction" title="enum GdkWMFunction"><span class="type">GdkWMFunction</span></a> functions</code></em>);</pre>
|
||
<p>Sets hints about the window management functions to make available
|
||
via buttons on the window frame.</p>
|
||
<p>On the X backend, this function sets the traditional Motif window
|
||
manager hint for this purpose. However, few window managers do
|
||
anything reliable or interesting with this hint. Many ignore it
|
||
entirely.</p>
|
||
<p>The <em class="parameter"><code>functions</code></em>
|
||
argument is the logical OR of values from the
|
||
<a class="link" href="gdk3-Windows.html#GdkWMFunction" title="enum GdkWMFunction"><span class="type">GdkWMFunction</span></a> enumeration. If the bitmask includes <a class="link" href="gdk3-Windows.html#GDK-FUNC-ALL:CAPS"><span class="type">GDK_FUNC_ALL</span></a>,
|
||
then the other bits indicate which functions to disable; if
|
||
it doesn’t include <a class="link" href="gdk3-Windows.html#GDK-FUNC-ALL:CAPS"><span class="type">GDK_FUNC_ALL</span></a>, it indicates which functions to
|
||
enable.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-set-functions.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 toplevel <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>functions</p></td>
|
||
<td class="parameter_description"><p>bitmask of operations to allow on <em class="parameter"><code>window</code></em>
|
||
</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-get-default-root-window"></a><h3>gdk_get_default_root_window ()</h3>
|
||
<pre class="programlisting"><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="returnvalue">GdkWindow</span></a> *
|
||
gdk_get_default_root_window (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
|
||
<p>Obtains the root window (parent all other windows are inside)
|
||
for the default display and screen.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-get-default-root-window.returns"></a><h4>Returns</h4>
|
||
<p>the default root window. </p>
|
||
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-get-support-multidevice"></a><h3>gdk_window_get_support_multidevice ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gdk_window_get_support_multidevice (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre>
|
||
<p>Returns <code class="literal">TRUE</code> if the window is aware of the existence of multiple
|
||
devices.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-get-support-multidevice.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="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a>.</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-get-support-multidevice.returns"></a><h4>Returns</h4>
|
||
<p> <code class="literal">TRUE</code> if the window handles multidevice features.</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="gdk-window-set-support-multidevice"></a><h3>gdk_window_set_support_multidevice ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gdk_window_set_support_multidevice (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><span class="type">gboolean</span> support_multidevice</code></em>);</pre>
|
||
<p>This function will enable multidevice features in <em class="parameter"><code>window</code></em>
|
||
.</p>
|
||
<p>Multidevice aware windows will need to handle properly multiple,
|
||
per device enter/leave events, device grabs and grab ownerships.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-set-support-multidevice.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="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a>.</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>support_multidevice</p></td>
|
||
<td class="parameter_description"><p><code class="literal">TRUE</code> to enable multidevice support in <em class="parameter"><code>window</code></em>
|
||
.</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="gdk-window-get-device-cursor"></a><h3>gdk_window_get_device_cursor ()</h3>
|
||
<pre class="programlisting"><a class="link" href="gdk3-Cursors.html#GdkCursor"><span class="returnvalue">GdkCursor</span></a> *
|
||
gdk_window_get_device_cursor (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GdkDevice.html" title="GdkDevice"><span class="type">GdkDevice</span></a> *device</code></em>);</pre>
|
||
<p>Retrieves a <a class="link" href="gdk3-Cursors.html#GdkCursor"><span class="type">GdkCursor</span></a> pointer for the <em class="parameter"><code>device</code></em>
|
||
currently set on the
|
||
specified <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a>, or <code class="literal">NULL</code>. If the return value is <code class="literal">NULL</code> then
|
||
there is no custom cursor set on the specified window, and it is
|
||
using the cursor for its parent window.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-get-device-cursor.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="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a>.</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>device</p></td>
|
||
<td class="parameter_description"><p>a master, pointer <a class="link" href="GdkDevice.html" title="GdkDevice"><span class="type">GdkDevice</span></a>.</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-get-device-cursor.returns"></a><h4>Returns</h4>
|
||
<p>a <a class="link" href="gdk3-Cursors.html#GdkCursor"><span class="type">GdkCursor</span></a>, or <code class="literal">NULL</code>. The
|
||
returned object is owned by the <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> and should not be
|
||
unreferenced directly. Use <a class="link" href="gdk3-Windows.html#gdk-window-set-cursor" title="gdk_window_set_cursor ()"><code class="function">gdk_window_set_cursor()</code></a> to unset the
|
||
cursor of the window. </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="Don't free data after the code is done."><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="gdk-window-set-device-cursor"></a><h3>gdk_window_set_device_cursor ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gdk_window_set_device_cursor (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GdkDevice.html" title="GdkDevice"><span class="type">GdkDevice</span></a> *device</code></em>,
|
||
<em class="parameter"><code><a class="link" href="gdk3-Cursors.html#GdkCursor"><span class="type">GdkCursor</span></a> *cursor</code></em>);</pre>
|
||
<p>Sets a specific <a class="link" href="gdk3-Cursors.html#GdkCursor"><span class="type">GdkCursor</span></a> for a given device when it gets inside <em class="parameter"><code>window</code></em>
|
||
.
|
||
Use <a class="link" href="gdk3-Cursors.html#gdk-cursor-new-for-display" title="gdk_cursor_new_for_display ()"><code class="function">gdk_cursor_new_for_display()</code></a> or <a class="link" href="gdk3-Cursors.html#gdk-cursor-new-from-pixbuf" title="gdk_cursor_new_from_pixbuf ()"><code class="function">gdk_cursor_new_from_pixbuf()</code></a> to create
|
||
the cursor. To make the cursor invisible, use <a class="link" href="gdk3-Cursors.html#GDK-BLANK-CURSOR:CAPS"><code class="literal">GDK_BLANK_CURSOR</code></a>. Passing
|
||
<code class="literal">NULL</code> for the <em class="parameter"><code>cursor</code></em>
|
||
argument to <a class="link" href="gdk3-Windows.html#gdk-window-set-cursor" title="gdk_window_set_cursor ()"><code class="function">gdk_window_set_cursor()</code></a> means that
|
||
<em class="parameter"><code>window</code></em>
|
||
will use the cursor of its parent window. Most windows should
|
||
use this default.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-set-device-cursor.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="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>device</p></td>
|
||
<td class="parameter_description"><p>a master, pointer <a class="link" href="GdkDevice.html" title="GdkDevice"><span class="type">GdkDevice</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>cursor</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="gdk3-Cursors.html#GdkCursor"><span class="type">GdkCursor</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-0.html#api-index-3.0">3.0</a></p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-get-device-events"></a><h3>gdk_window_get_device_events ()</h3>
|
||
<pre class="programlisting"><a class="link" href="gdk3-Events.html#GdkEventMask" title="enum GdkEventMask"><span class="returnvalue">GdkEventMask</span></a>
|
||
gdk_window_get_device_events (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GdkDevice.html" title="GdkDevice"><span class="type">GdkDevice</span></a> *device</code></em>);</pre>
|
||
<p>Returns the event mask for <em class="parameter"><code>window</code></em>
|
||
corresponding to an specific device.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-get-device-events.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="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a>.</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>device</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GdkDevice.html" title="GdkDevice"><span class="type">GdkDevice</span></a>.</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-get-device-events.returns"></a><h4>Returns</h4>
|
||
<p> device event mask for <em class="parameter"><code>window</code></em>
|
||
</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="gdk-window-set-device-events"></a><h3>gdk_window_set_device_events ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gdk_window_set_device_events (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GdkDevice.html" title="GdkDevice"><span class="type">GdkDevice</span></a> *device</code></em>,
|
||
<em class="parameter"><code><a class="link" href="gdk3-Events.html#GdkEventMask" title="enum GdkEventMask"><span class="type">GdkEventMask</span></a> event_mask</code></em>);</pre>
|
||
<p>Sets the event mask for a given device (Normally a floating device, not
|
||
attached to any visible pointer) to <em class="parameter"><code>window</code></em>
|
||
. For example, an event mask
|
||
including <a class="link" href="gdk3-Events.html#GDK-BUTTON-PRESS-MASK:CAPS"><span class="type">GDK_BUTTON_PRESS_MASK</span></a> means the window should report button
|
||
press events. The event mask is the bitwise OR of values from the
|
||
<a class="link" href="gdk3-Events.html#GdkEventMask" title="enum GdkEventMask"><span class="type">GdkEventMask</span></a> enumeration.</p>
|
||
<p>See the input handling overview for details.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-set-device-events.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="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>device</p></td>
|
||
<td class="parameter_description"><p><a class="link" href="GdkDevice.html" title="GdkDevice"><span class="type">GdkDevice</span></a> to enable events for.</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>event_mask</p></td>
|
||
<td class="parameter_description"><p>event mask for <em class="parameter"><code>window</code></em>
|
||
</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="gdk-window-get-source-events"></a><h3>gdk_window_get_source_events ()</h3>
|
||
<pre class="programlisting"><a class="link" href="gdk3-Events.html#GdkEventMask" title="enum GdkEventMask"><span class="returnvalue">GdkEventMask</span></a>
|
||
gdk_window_get_source_events (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GdkDevice.html#GdkInputSource" title="enum GdkInputSource"><span class="type">GdkInputSource</span></a> source</code></em>);</pre>
|
||
<p>Returns the event mask for <em class="parameter"><code>window</code></em>
|
||
corresponding to the device class specified
|
||
by <em class="parameter"><code>source</code></em>
|
||
.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-get-source-events.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="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>source</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GdkDevice.html#GdkInputSource" title="enum GdkInputSource"><span class="type">GdkInputSource</span></a> to define the source class.</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-get-source-events.returns"></a><h4>Returns</h4>
|
||
<p> source event mask for <em class="parameter"><code>window</code></em>
|
||
</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-set-source-events"></a><h3>gdk_window_set_source_events ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gdk_window_set_source_events (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GdkDevice.html#GdkInputSource" title="enum GdkInputSource"><span class="type">GdkInputSource</span></a> source</code></em>,
|
||
<em class="parameter"><code><a class="link" href="gdk3-Events.html#GdkEventMask" title="enum GdkEventMask"><span class="type">GdkEventMask</span></a> event_mask</code></em>);</pre>
|
||
<p>Sets the event mask for any floating device (i.e. not attached to any
|
||
visible pointer) that has the source defined as <em class="parameter"><code>source</code></em>
|
||
. This event
|
||
mask will be applied both to currently existing, newly added devices
|
||
after this call, and devices being attached/detached.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-set-source-events.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="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>source</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GdkDevice.html#GdkInputSource" title="enum GdkInputSource"><span class="type">GdkInputSource</span></a> to define the source class.</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>event_mask</p></td>
|
||
<td class="parameter_description"><p>event mask for <em class="parameter"><code>window</code></em>
|
||
</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="gdk-window-get-event-compression"></a><h3>gdk_window_get_event_compression ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gdk_window_get_event_compression (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre>
|
||
<p>Get the current event compression setting for this window.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-get-event-compression.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="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-get-event-compression.returns"></a><h4>Returns</h4>
|
||
<p> <code class="literal">TRUE</code> if motion events will be compressed</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="gdk-window-set-event-compression"></a><h3>gdk_window_set_event_compression ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gdk_window_set_event_compression (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><span class="type">gboolean</span> event_compression</code></em>);</pre>
|
||
<p>Determines whether or not extra unprocessed motion events in
|
||
the event queue can be discarded. If <code class="literal">TRUE</code> only the most recent
|
||
event will be delivered.</p>
|
||
<p>Some types of applications, e.g. paint programs, need to see all
|
||
motion events and will benefit from turning off event compression.</p>
|
||
<p>By default, event compression is enabled.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-set-event-compression.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="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>event_compression</p></td>
|
||
<td class="parameter_description"><p><code class="literal">TRUE</code> if motion events should be compressed</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</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="gdk-offscreen-window-get-surface"></a><h3>gdk_offscreen_window_get_surface ()</h3>
|
||
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/cairo/cairo-cairo-surface-t.html#cairo-surface-t"><span class="returnvalue">cairo_surface_t</span></a> *
|
||
gdk_offscreen_window_get_surface (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre>
|
||
<p>Gets the offscreen surface that an offscreen window renders into.
|
||
If you need to keep this around over window resizes, you need to
|
||
add a reference to it.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-offscreen-window-get-surface.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="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gdk-offscreen-window-get-surface.returns"></a><h4>Returns</h4>
|
||
<p>The offscreen surface, or
|
||
<code class="literal">NULL</code> if not offscreen. </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="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-offscreen-window-set-embedder"></a><h3>gdk_offscreen_window_set_embedder ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gdk_offscreen_window_set_embedder (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *embedder</code></em>);</pre>
|
||
<p>Sets <em class="parameter"><code>window</code></em>
|
||
to be embedded in <em class="parameter"><code>embedder</code></em>
|
||
.</p>
|
||
<p>To fully embed an offscreen window, in addition to calling this
|
||
function, it is also necessary to handle the <a class="link" href="gdk3-Windows.html#GdkWindow-pick-embedded-child" title="The “pick-embedded-child” signal"><span class="type">“pick-embedded-child”</span></a>
|
||
signal on the <em class="parameter"><code>embedder</code></em>
|
||
and the <a class="link" href="gdk3-Windows.html#GdkWindow-to-embedder" title="The “to-embedder” signal"><span class="type">“to-embedder”</span></a> and
|
||
<a class="link" href="gdk3-Windows.html#GdkWindow-from-embedder" title="The “from-embedder” signal"><span class="type">“from-embedder”</span></a> signals on <em class="parameter"><code>window</code></em>
|
||
.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-offscreen-window-set-embedder.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="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>embedder</p></td>
|
||
<td class="parameter_description"><p>the <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> that <em class="parameter"><code>window</code></em>
|
||
gets embedded in</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: 2.18</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-offscreen-window-get-embedder"></a><h3>gdk_offscreen_window_get_embedder ()</h3>
|
||
<pre class="programlisting"><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="returnvalue">GdkWindow</span></a> *
|
||
gdk_offscreen_window_get_embedder (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre>
|
||
<p>Gets the window that <em class="parameter"><code>window</code></em>
|
||
is embedded in.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-offscreen-window-get-embedder.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="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gdk-offscreen-window-get-embedder.returns"></a><h4>Returns</h4>
|
||
<p>the embedding <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a>, or
|
||
<code class="literal">NULL</code> if <em class="parameter"><code>window</code></em>
|
||
is not an mbedded offscreen window. </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="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
|
||
</div>
|
||
<p class="since">Since: 2.18</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-geometry-changed"></a><h3>gdk_window_geometry_changed ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gdk_window_geometry_changed (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre>
|
||
<p>This function informs GDK that the geometry of an embedded
|
||
offscreen window has changed. This is necessary for GDK to keep
|
||
track of which offscreen window the pointer is in.</p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-geometry-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>an embedded offscreen <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: 2.18</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-coords-from-parent"></a><h3>gdk_window_coords_from_parent ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gdk_window_coords_from_parent (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><span class="type">gdouble</span> parent_x</code></em>,
|
||
<em class="parameter"><code><span class="type">gdouble</span> parent_y</code></em>,
|
||
<em class="parameter"><code><span class="type">gdouble</span> *x</code></em>,
|
||
<em class="parameter"><code><span class="type">gdouble</span> *y</code></em>);</pre>
|
||
<p>Transforms window coordinates from a parent window to a child
|
||
window, where the parent window is the normal parent as returned by
|
||
<a class="link" href="gdk3-Windows.html#gdk-window-get-parent" title="gdk_window_get_parent ()"><code class="function">gdk_window_get_parent()</code></a> for normal windows, and the window's
|
||
embedder as returned by <a class="link" href="gdk3-Windows.html#gdk-offscreen-window-get-embedder" title="gdk_offscreen_window_get_embedder ()"><code class="function">gdk_offscreen_window_get_embedder()</code></a> for
|
||
offscreen windows.</p>
|
||
<p>For normal windows, calling this function is equivalent to subtracting
|
||
the return values of <a class="link" href="gdk3-Windows.html#gdk-window-get-position" title="gdk_window_get_position ()"><code class="function">gdk_window_get_position()</code></a> from the parent coordinates.
|
||
For offscreen windows however (which can be arbitrarily transformed),
|
||
this function calls the GdkWindow::from-embedder: signal to translate
|
||
the coordinates.</p>
|
||
<p>You should always use this function when writing generic code that
|
||
walks down a window hierarchy.</p>
|
||
<p>See also: <a class="link" href="gdk3-Windows.html#gdk-window-coords-to-parent" title="gdk_window_coords_to_parent ()"><code class="function">gdk_window_coords_to_parent()</code></a></p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-coords-from-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 child window</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>parent_x</p></td>
|
||
<td class="parameter_description"><p>X coordinate in parent’s coordinate system</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>parent_y</p></td>
|
||
<td class="parameter_description"><p>Y coordinate in parent’s coordinate system</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>x</p></td>
|
||
<td class="parameter_description"><p>return location for X coordinate in child’s coordinate system. </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>y</p></td>
|
||
<td class="parameter_description"><p>return location for Y coordinate in child’s coordinate system. </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>
|
||
<p class="since">Since: 2.22</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-coords-to-parent"></a><h3>gdk_window_coords_to_parent ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gdk_window_coords_to_parent (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>,
|
||
<em class="parameter"><code><span class="type">gdouble</span> x</code></em>,
|
||
<em class="parameter"><code><span class="type">gdouble</span> y</code></em>,
|
||
<em class="parameter"><code><span class="type">gdouble</span> *parent_x</code></em>,
|
||
<em class="parameter"><code><span class="type">gdouble</span> *parent_y</code></em>);</pre>
|
||
<p>Transforms window coordinates from a child window to its parent
|
||
window, where the parent window is the normal parent as returned by
|
||
<a class="link" href="gdk3-Windows.html#gdk-window-get-parent" title="gdk_window_get_parent ()"><code class="function">gdk_window_get_parent()</code></a> for normal windows, and the window's
|
||
embedder as returned by <a class="link" href="gdk3-Windows.html#gdk-offscreen-window-get-embedder" title="gdk_offscreen_window_get_embedder ()"><code class="function">gdk_offscreen_window_get_embedder()</code></a> for
|
||
offscreen windows.</p>
|
||
<p>For normal windows, calling this function is equivalent to adding
|
||
the return values of <a class="link" href="gdk3-Windows.html#gdk-window-get-position" title="gdk_window_get_position ()"><code class="function">gdk_window_get_position()</code></a> to the child coordinates.
|
||
For offscreen windows however (which can be arbitrarily transformed),
|
||
this function calls the GdkWindow::to-embedder: signal to translate
|
||
the coordinates.</p>
|
||
<p>You should always use this function when writing generic code that
|
||
walks up a window hierarchy.</p>
|
||
<p>See also: <a class="link" href="gdk3-Windows.html#gdk-window-coords-from-parent" title="gdk_window_coords_from_parent ()"><code class="function">gdk_window_coords_from_parent()</code></a></p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-coords-to-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 child window</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>x</p></td>
|
||
<td class="parameter_description"><p>X coordinate in child’s coordinate system</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>y</p></td>
|
||
<td class="parameter_description"><p>Y coordinate in child’s coordinate system</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>parent_x</p></td>
|
||
<td class="parameter_description"><p>return location for X coordinate
|
||
in parent’s coordinate system, 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>parent_y</p></td>
|
||
<td class="parameter_description"><p>return location for Y coordinate
|
||
in parent’s coordinate system, 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>
|
||
<p class="since">Since: 2.22</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-get-effective-parent"></a><h3>gdk_window_get_effective_parent ()</h3>
|
||
<pre class="programlisting"><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="returnvalue">GdkWindow</span></a> *
|
||
gdk_window_get_effective_parent (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre>
|
||
<p>Obtains the parent of <em class="parameter"><code>window</code></em>
|
||
, as known to GDK. Works like
|
||
<a class="link" href="gdk3-Windows.html#gdk-window-get-parent" title="gdk_window_get_parent ()"><code class="function">gdk_window_get_parent()</code></a> for normal windows, but returns the
|
||
window’s embedder for offscreen windows.</p>
|
||
<p>See also: <a class="link" href="gdk3-Windows.html#gdk-offscreen-window-get-embedder" title="gdk_offscreen_window_get_embedder ()"><code class="function">gdk_offscreen_window_get_embedder()</code></a></p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-get-effective-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="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-get-effective-parent.returns"></a><h4>Returns</h4>
|
||
<p>effective parent of <em class="parameter"><code>window</code></em>
|
||
. </p>
|
||
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
|
||
</div>
|
||
<p class="since">Since: 2.22</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gdk-window-get-effective-toplevel"></a><h3>gdk_window_get_effective_toplevel ()</h3>
|
||
<pre class="programlisting"><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="returnvalue">GdkWindow</span></a> *
|
||
gdk_window_get_effective_toplevel (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre>
|
||
<p>Gets the toplevel window that’s an ancestor of <em class="parameter"><code>window</code></em>
|
||
.</p>
|
||
<p>Works like <a class="link" href="gdk3-Windows.html#gdk-window-get-toplevel" title="gdk_window_get_toplevel ()"><code class="function">gdk_window_get_toplevel()</code></a>, but treats an offscreen window's
|
||
embedder as its parent, using <a class="link" href="gdk3-Windows.html#gdk-window-get-effective-parent" title="gdk_window_get_effective_parent ()"><code class="function">gdk_window_get_effective_parent()</code></a>.</p>
|
||
<p>See also: <a class="link" href="gdk3-Windows.html#gdk-offscreen-window-get-embedder" title="gdk_offscreen_window_get_embedder ()"><code class="function">gdk_offscreen_window_get_embedder()</code></a></p>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-get-effective-toplevel.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="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gdk-window-get-effective-toplevel.returns"></a><h4>Returns</h4>
|
||
<p>the effective toplevel window containing <em class="parameter"><code>window</code></em>
|
||
. </p>
|
||
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
|
||
</div>
|
||
<p class="since">Since: 2.22</p>
|
||
</div>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="gdk3-Windows.other_details"></a><h2>Types and Values</h2>
|
||
<div class="refsect2">
|
||
<a name="GdkWindow-struct"></a><h3>GdkWindow</h3>
|
||
<pre class="programlisting">typedef struct _GdkWindow GdkWindow;</pre>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GdkWindowType"></a><h3>enum GdkWindowType</h3>
|
||
<p>Describes the kind of window.</p>
|
||
<div class="refsect3">
|
||
<a name="GdkWindowType.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="GDK-WINDOW-ROOT:CAPS"></a>GDK_WINDOW_ROOT</p></td>
|
||
<td class="enum_member_description">
|
||
<p>root window; this window has no parent, covers the entire
|
||
screen, and is created by the window system</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-WINDOW-TOPLEVEL:CAPS"></a>GDK_WINDOW_TOPLEVEL</p></td>
|
||
<td class="enum_member_description">
|
||
<p>toplevel window (used to implement <span class="type">GtkWindow</span>)</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-WINDOW-CHILD:CAPS"></a>GDK_WINDOW_CHILD</p></td>
|
||
<td class="enum_member_description">
|
||
<p>child window (used to implement e.g. <span class="type">GtkEntry</span>)</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-WINDOW-TEMP:CAPS"></a>GDK_WINDOW_TEMP</p></td>
|
||
<td class="enum_member_description">
|
||
<p>override redirect temporary window (used to implement
|
||
<span class="type">GtkMenu</span>)</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-WINDOW-FOREIGN:CAPS"></a>GDK_WINDOW_FOREIGN</p></td>
|
||
<td class="enum_member_description">
|
||
<p>foreign window (see <code class="function">gdk_window_foreign_new()</code>)</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-WINDOW-OFFSCREEN:CAPS"></a>GDK_WINDOW_OFFSCREEN</p></td>
|
||
<td class="enum_member_description">
|
||
<p>offscreen window (see
|
||
<a class="link" href="gdk3-Windows.html#OFFSCREEN-WINDOWS" title="Offscreen Windows">Offscreen Windows</a>). Since 2.18</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-WINDOW-SUBSURFACE:CAPS"></a>GDK_WINDOW_SUBSURFACE</p></td>
|
||
<td class="enum_member_description">
|
||
<p>subsurface-based window; This window is visually
|
||
tied to a toplevel, and is moved/stacked with it. Currently this window
|
||
type is only implemented in Wayland. Since 3.14</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GdkWindowWindowClass"></a><h3>enum GdkWindowWindowClass</h3>
|
||
<p><em class="parameter"><code>GDK_INPUT_OUTPUT</code></em>
|
||
windows are the standard kind of window you might expect.
|
||
Such windows receive events and are also displayed on screen.
|
||
<em class="parameter"><code>GDK_INPUT_ONLY</code></em>
|
||
windows are invisible; they are usually placed above other
|
||
windows in order to trap or filter the events. You can’t draw on
|
||
<em class="parameter"><code>GDK_INPUT_ONLY</code></em>
|
||
windows.</p>
|
||
<div class="refsect3">
|
||
<a name="GdkWindowWindowClass.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="GDK-INPUT-OUTPUT:CAPS"></a>GDK_INPUT_OUTPUT</p></td>
|
||
<td class="enum_member_description">
|
||
<p>window for graphics and events</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-INPUT-ONLY:CAPS"></a>GDK_INPUT_ONLY</p></td>
|
||
<td class="enum_member_description">
|
||
<p>window for events only</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GdkWindowHints"></a><h3>enum GdkWindowHints</h3>
|
||
<p>Used to indicate which fields of a <a class="link" href="gdk3-Windows.html#GdkGeometry" title="struct GdkGeometry"><span class="type">GdkGeometry</span></a> struct should be paid
|
||
attention to. Also, the presence/absence of <em class="parameter"><code>GDK_HINT_POS</code></em>
|
||
,
|
||
<em class="parameter"><code>GDK_HINT_USER_POS</code></em>
|
||
, and <em class="parameter"><code>GDK_HINT_USER_SIZE</code></em>
|
||
is significant, though they don't
|
||
directly refer to <a class="link" href="gdk3-Windows.html#GdkGeometry" title="struct GdkGeometry"><span class="type">GdkGeometry</span></a> fields. <em class="parameter"><code>GDK_HINT_USER_POS</code></em>
|
||
will be set
|
||
automatically by <span class="type">GtkWindow</span> if you call <code class="function">gtk_window_move()</code>.
|
||
<em class="parameter"><code>GDK_HINT_USER_POS</code></em>
|
||
and <em class="parameter"><code>GDK_HINT_USER_SIZE</code></em>
|
||
should be set if the user
|
||
specified a size/position using a --geometry command-line argument;
|
||
<code class="function">gtk_window_parse_geometry()</code> automatically sets these flags.</p>
|
||
<div class="refsect3">
|
||
<a name="GdkWindowHints.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="GDK-HINT-POS:CAPS"></a>GDK_HINT_POS</p></td>
|
||
<td class="enum_member_description">
|
||
<p>indicates that the program has positioned the window</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-HINT-MIN-SIZE:CAPS"></a>GDK_HINT_MIN_SIZE</p></td>
|
||
<td class="enum_member_description">
|
||
<p>min size fields are set</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-HINT-MAX-SIZE:CAPS"></a>GDK_HINT_MAX_SIZE</p></td>
|
||
<td class="enum_member_description">
|
||
<p>max size fields are set</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-HINT-BASE-SIZE:CAPS"></a>GDK_HINT_BASE_SIZE</p></td>
|
||
<td class="enum_member_description">
|
||
<p>base size fields are set</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-HINT-ASPECT:CAPS"></a>GDK_HINT_ASPECT</p></td>
|
||
<td class="enum_member_description">
|
||
<p>aspect ratio fields are set</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-HINT-RESIZE-INC:CAPS"></a>GDK_HINT_RESIZE_INC</p></td>
|
||
<td class="enum_member_description">
|
||
<p>resize increment fields are set</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-HINT-WIN-GRAVITY:CAPS"></a>GDK_HINT_WIN_GRAVITY</p></td>
|
||
<td class="enum_member_description">
|
||
<p>window gravity field is set</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-HINT-USER-POS:CAPS"></a>GDK_HINT_USER_POS</p></td>
|
||
<td class="enum_member_description">
|
||
<p>indicates that the window’s position was explicitly set
|
||
by the user</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-HINT-USER-SIZE:CAPS"></a>GDK_HINT_USER_SIZE</p></td>
|
||
<td class="enum_member_description">
|
||
<p>indicates that the window’s size was explicitly set by
|
||
the user</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GdkGeometry"></a><h3>struct GdkGeometry</h3>
|
||
<pre class="programlisting">struct GdkGeometry {
|
||
gint min_width;
|
||
gint min_height;
|
||
gint max_width;
|
||
gint max_height;
|
||
gint base_width;
|
||
gint base_height;
|
||
gint width_inc;
|
||
gint height_inc;
|
||
gdouble min_aspect;
|
||
gdouble max_aspect;
|
||
GdkGravity win_gravity;
|
||
};
|
||
</pre>
|
||
<p>The <a class="link" href="gdk3-Windows.html#GdkGeometry" title="struct GdkGeometry"><span class="type">GdkGeometry</span></a> struct gives the window manager information about
|
||
a window’s geometry constraints. Normally you would set these on
|
||
the GTK+ level using <code class="function">gtk_window_set_geometry_hints()</code>. <span class="type">GtkWindow</span>
|
||
then sets the hints on the <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> it creates.</p>
|
||
<p>gdk_window_set_geometry_hints() expects the hints to be fully valid already
|
||
and simply passes them to the window manager; in contrast,
|
||
<code class="function">gtk_window_set_geometry_hints()</code> performs some interpretation. For example,
|
||
<span class="type">GtkWindow</span> will apply the hints to the geometry widget instead of the
|
||
toplevel window, if you set a geometry widget. Also, the
|
||
<em class="parameter"><code>min_width</code></em>
|
||
/<em class="parameter"><code>min_height</code></em>
|
||
/<em class="parameter"><code>max_width</code></em>
|
||
/<em class="parameter"><code>max_height</code></em>
|
||
fields may be set to -1, and
|
||
<span class="type">GtkWindow</span> will substitute the size request of the window or geometry widget.
|
||
If the minimum size hint is not provided, <span class="type">GtkWindow</span> will use its requisition
|
||
as the minimum size. If the minimum size is provided and a geometry widget is
|
||
set, <span class="type">GtkWindow</span> will take the minimum size as the minimum size of the
|
||
geometry widget rather than the entire window. The base size is treated
|
||
similarly.</p>
|
||
<p>The canonical use-case for <code class="function">gtk_window_set_geometry_hints()</code> is to get a
|
||
terminal widget to resize properly. Here, the terminal text area should be
|
||
the geometry widget; <span class="type">GtkWindow</span> will then automatically set the base size to
|
||
the size of other widgets in the terminal window, such as the menubar and
|
||
scrollbar. Then, the <em class="parameter"><code>width_inc</code></em>
|
||
and <em class="parameter"><code>height_inc</code></em>
|
||
fields should be set to the
|
||
size of one character in the terminal. Finally, the base size should be set
|
||
to the size of one character. The net effect is that the minimum size of the
|
||
terminal will have a 1x1 character terminal area, and only terminal sizes on
|
||
the “character grid” will be allowed.</p>
|
||
<p>Here’s an example of how the terminal example would be implemented, assuming
|
||
a terminal area widget called “terminal” and a toplevel window “toplevel”:</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</pre></td>
|
||
<td class="listing_code"><pre class="programlisting"><span class="usertype">GdkGeometry</span><span class="normal"> hints</span><span class="symbol">;</span>
|
||
|
||
<span class="normal">hints</span><span class="symbol">.</span><span class="normal">base_width </span><span class="symbol">=</span><span class="normal"> terminal</span><span class="symbol">-></span><span class="normal">char_width</span><span class="symbol">;</span>
|
||
<span class="normal"> hints</span><span class="symbol">.</span><span class="normal">base_height </span><span class="symbol">=</span><span class="normal"> terminal</span><span class="symbol">-></span><span class="normal">char_height</span><span class="symbol">;</span>
|
||
<span class="normal"> hints</span><span class="symbol">.</span><span class="normal">min_width </span><span class="symbol">=</span><span class="normal"> terminal</span><span class="symbol">-></span><span class="normal">char_width</span><span class="symbol">;</span>
|
||
<span class="normal"> hints</span><span class="symbol">.</span><span class="normal">min_height </span><span class="symbol">=</span><span class="normal"> terminal</span><span class="symbol">-></span><span class="normal">char_height</span><span class="symbol">;</span>
|
||
<span class="normal"> hints</span><span class="symbol">.</span><span class="normal">width_inc </span><span class="symbol">=</span><span class="normal"> terminal</span><span class="symbol">-></span><span class="normal">char_width</span><span class="symbol">;</span>
|
||
<span class="normal"> hints</span><span class="symbol">.</span><span class="normal">height_inc </span><span class="symbol">=</span><span class="normal"> terminal</span><span class="symbol">-></span><span class="normal">char_height</span><span class="symbol">;</span>
|
||
|
||
<span class="normal"> </span><span class="function">gtk_window_set_geometry_hints</span><span class="normal"> </span><span class="symbol">(</span><span class="function">GTK_WINDOW</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">toplevel</span><span class="symbol">),</span>
|
||
<span class="normal"> </span><span class="function">GTK_WIDGET</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">terminal</span><span class="symbol">),</span>
|
||
<span class="normal"> </span><span class="symbol">&</span><span class="normal">hints</span><span class="symbol">,</span>
|
||
<span class="normal"> <a href="gdk3-Windows.html#GDK-HINT-RESIZE-INC:CAPS">GDK_HINT_RESIZE_INC</a> </span><span class="symbol">|</span>
|
||
<span class="normal"> <a href="gdk3-Windows.html#GDK-HINT-MIN-SIZE:CAPS">GDK_HINT_MIN_SIZE</a> </span><span class="symbol">|</span>
|
||
<span class="normal"> <a href="gdk3-Windows.html#GDK-HINT-BASE-SIZE:CAPS">GDK_HINT_BASE_SIZE</a></span><span class="symbol">);</span></pre></td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
</div>
|
||
|
||
<p></p>
|
||
<p>The other useful fields are the <em class="parameter"><code>min_aspect</code></em>
|
||
and <em class="parameter"><code>max_aspect</code></em>
|
||
fields; these
|
||
contain a width/height ratio as a floating point number. If a geometry widget
|
||
is set, the aspect applies to the geometry widget rather than the entire
|
||
window. The most common use of these hints is probably to set <em class="parameter"><code>min_aspect</code></em>
|
||
and
|
||
<em class="parameter"><code>max_aspect</code></em>
|
||
to the same value, thus forcing the window to keep a constant
|
||
aspect ratio.</p>
|
||
<div class="refsect3">
|
||
<a name="GdkGeometry.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><span class="type">gint</span> <em class="structfield"><code><a name="GdkGeometry.min-width"></a>min_width</code></em>;</p></td>
|
||
<td class="struct_member_description"><p>minimum width of window (or -1 to use requisition, with
|
||
<span class="type">GtkWindow</span> only)</p></td>
|
||
<td class="struct_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="struct_member_name"><p><span class="type">gint</span> <em class="structfield"><code><a name="GdkGeometry.min-height"></a>min_height</code></em>;</p></td>
|
||
<td class="struct_member_description"><p>minimum height of window (or -1 to use requisition, with
|
||
<span class="type">GtkWindow</span> only)</p></td>
|
||
<td class="struct_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="struct_member_name"><p><span class="type">gint</span> <em class="structfield"><code><a name="GdkGeometry.max-width"></a>max_width</code></em>;</p></td>
|
||
<td class="struct_member_description"><p>maximum width of window (or -1 to use requisition, with
|
||
<span class="type">GtkWindow</span> only)</p></td>
|
||
<td class="struct_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="struct_member_name"><p><span class="type">gint</span> <em class="structfield"><code><a name="GdkGeometry.max-height"></a>max_height</code></em>;</p></td>
|
||
<td class="struct_member_description"><p>maximum height of window (or -1 to use requisition, with
|
||
<span class="type">GtkWindow</span> only)</p></td>
|
||
<td class="struct_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="struct_member_name"><p><span class="type">gint</span> <em class="structfield"><code><a name="GdkGeometry.base-width"></a>base_width</code></em>;</p></td>
|
||
<td class="struct_member_description"><p>allowed window widths are <em class="parameter"><code>base_width</code></em>
|
||
+ <em class="parameter"><code>width_inc</code></em>
|
||
* N where N
|
||
is any integer (-1 allowed with <span class="type">GtkWindow</span>)</p></td>
|
||
<td class="struct_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="struct_member_name"><p><span class="type">gint</span> <em class="structfield"><code><a name="GdkGeometry.base-height"></a>base_height</code></em>;</p></td>
|
||
<td class="struct_member_description"><p>allowed window widths are <em class="parameter"><code>base_height</code></em>
|
||
+ <em class="parameter"><code>height_inc</code></em>
|
||
* N where
|
||
N is any integer (-1 allowed with <span class="type">GtkWindow</span>)</p></td>
|
||
<td class="struct_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="struct_member_name"><p><span class="type">gint</span> <em class="structfield"><code><a name="GdkGeometry.width-inc"></a>width_inc</code></em>;</p></td>
|
||
<td class="struct_member_description"><p>width resize increment</p></td>
|
||
<td class="struct_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="struct_member_name"><p><span class="type">gint</span> <em class="structfield"><code><a name="GdkGeometry.height-inc"></a>height_inc</code></em>;</p></td>
|
||
<td class="struct_member_description"><p>height resize increment</p></td>
|
||
<td class="struct_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="struct_member_name"><p><span class="type">gdouble</span> <em class="structfield"><code><a name="GdkGeometry.min-aspect"></a>min_aspect</code></em>;</p></td>
|
||
<td class="struct_member_description"><p>minimum width/height ratio</p></td>
|
||
<td class="struct_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="struct_member_name"><p><span class="type">gdouble</span> <em class="structfield"><code><a name="GdkGeometry.max-aspect"></a>max_aspect</code></em>;</p></td>
|
||
<td class="struct_member_description"><p>maximum width/height ratio</p></td>
|
||
<td class="struct_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="struct_member_name"><p><a class="link" href="gdk3-Windows.html#GdkGravity" title="enum GdkGravity"><span class="type">GdkGravity</span></a> <em class="structfield"><code><a name="GdkGeometry.win-gravity"></a>win_gravity</code></em>;</p></td>
|
||
<td class="struct_member_description"><p>window gravity, see <code class="function">gtk_window_set_gravity()</code></p></td>
|
||
<td class="struct_member_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GdkGravity"></a><h3>enum GdkGravity</h3>
|
||
<p>Defines the reference point of a window and the meaning of coordinates
|
||
passed to <code class="function">gtk_window_move()</code>. See <code class="function">gtk_window_move()</code> and the "implementation
|
||
notes" section of the
|
||
<a class="ulink" href="http://www.freedesktop.org/Standards/wm-spec" target="_top">Extended Window Manager Hints</a>
|
||
specification for more details.</p>
|
||
<div class="refsect3">
|
||
<a name="GdkGravity.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="GDK-GRAVITY-NORTH-WEST:CAPS"></a>GDK_GRAVITY_NORTH_WEST</p></td>
|
||
<td class="enum_member_description">
|
||
<p>the reference point is at the top left corner.</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-GRAVITY-NORTH:CAPS"></a>GDK_GRAVITY_NORTH</p></td>
|
||
<td class="enum_member_description">
|
||
<p>the reference point is in the middle of the top edge.</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-GRAVITY-NORTH-EAST:CAPS"></a>GDK_GRAVITY_NORTH_EAST</p></td>
|
||
<td class="enum_member_description">
|
||
<p>the reference point is at the top right corner.</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-GRAVITY-WEST:CAPS"></a>GDK_GRAVITY_WEST</p></td>
|
||
<td class="enum_member_description">
|
||
<p>the reference point is at the middle of the left edge.</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-GRAVITY-CENTER:CAPS"></a>GDK_GRAVITY_CENTER</p></td>
|
||
<td class="enum_member_description">
|
||
<p>the reference point is at the center of the window.</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-GRAVITY-EAST:CAPS"></a>GDK_GRAVITY_EAST</p></td>
|
||
<td class="enum_member_description">
|
||
<p>the reference point is at the middle of the right edge.</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-GRAVITY-SOUTH-WEST:CAPS"></a>GDK_GRAVITY_SOUTH_WEST</p></td>
|
||
<td class="enum_member_description">
|
||
<p>the reference point is at the lower left corner.</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-GRAVITY-SOUTH:CAPS"></a>GDK_GRAVITY_SOUTH</p></td>
|
||
<td class="enum_member_description">
|
||
<p>the reference point is at the middle of the lower edge.</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-GRAVITY-SOUTH-EAST:CAPS"></a>GDK_GRAVITY_SOUTH_EAST</p></td>
|
||
<td class="enum_member_description">
|
||
<p>the reference point is at the lower right corner.</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-GRAVITY-STATIC:CAPS"></a>GDK_GRAVITY_STATIC</p></td>
|
||
<td class="enum_member_description">
|
||
<p>the reference point is at the top left corner of the
|
||
window itself, ignoring window manager decorations.</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GdkAnchorHints"></a><h3>enum GdkAnchorHints</h3>
|
||
<p>Positioning hints for aligning a window relative to a rectangle.</p>
|
||
<p>These hints determine how the window should be positioned in the case that
|
||
the window would fall off-screen if placed in its ideal position.</p>
|
||
<p>For example, <a class="link" href="gdk3-Windows.html#GDK-ANCHOR-FLIP-X:CAPS"><code class="literal">GDK_ANCHOR_FLIP_X</code></a> will replace <a class="link" href="gdk3-Windows.html#GDK-GRAVITY-NORTH-WEST:CAPS"><code class="literal">GDK_GRAVITY_NORTH_WEST</code></a> with
|
||
<a class="link" href="gdk3-Windows.html#GDK-GRAVITY-NORTH-EAST:CAPS"><code class="literal">GDK_GRAVITY_NORTH_EAST</code></a> and vice versa if the window extends beyond the left
|
||
or right edges of the monitor.</p>
|
||
<p>If <a class="link" href="gdk3-Windows.html#GDK-ANCHOR-SLIDE-X:CAPS"><code class="literal">GDK_ANCHOR_SLIDE_X</code></a> is set, the window can be shifted horizontally to fit
|
||
on-screen. If <a class="link" href="gdk3-Windows.html#GDK-ANCHOR-RESIZE-X:CAPS"><code class="literal">GDK_ANCHOR_RESIZE_X</code></a> is set, the window can be shrunken
|
||
horizontally to fit.</p>
|
||
<p>In general, when multiple flags are set, flipping should take precedence over
|
||
sliding, which should take precedence over resizing.</p>
|
||
<div class="refsect3">
|
||
<a name="GdkAnchorHints.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="GDK-ANCHOR-FLIP-X:CAPS"></a>GDK_ANCHOR_FLIP_X</p></td>
|
||
<td class="enum_member_description">
|
||
<p>allow flipping anchors horizontally</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-ANCHOR-FLIP-Y:CAPS"></a>GDK_ANCHOR_FLIP_Y</p></td>
|
||
<td class="enum_member_description">
|
||
<p>allow flipping anchors vertically</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-ANCHOR-SLIDE-X:CAPS"></a>GDK_ANCHOR_SLIDE_X</p></td>
|
||
<td class="enum_member_description">
|
||
<p>allow sliding window horizontally</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-ANCHOR-SLIDE-Y:CAPS"></a>GDK_ANCHOR_SLIDE_Y</p></td>
|
||
<td class="enum_member_description">
|
||
<p>allow sliding window vertically</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-ANCHOR-RESIZE-X:CAPS"></a>GDK_ANCHOR_RESIZE_X</p></td>
|
||
<td class="enum_member_description">
|
||
<p>allow resizing window horizontally</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-ANCHOR-RESIZE-Y:CAPS"></a>GDK_ANCHOR_RESIZE_Y</p></td>
|
||
<td class="enum_member_description">
|
||
<p>allow resizing window vertically</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-ANCHOR-FLIP:CAPS"></a>GDK_ANCHOR_FLIP</p></td>
|
||
<td class="enum_member_description">
|
||
<p>allow flipping anchors on both axes</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-ANCHOR-SLIDE:CAPS"></a>GDK_ANCHOR_SLIDE</p></td>
|
||
<td class="enum_member_description">
|
||
<p>allow sliding window on both axes</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-ANCHOR-RESIZE:CAPS"></a>GDK_ANCHOR_RESIZE</p></td>
|
||
<td class="enum_member_description">
|
||
<p>allow resizing window on both axes</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: <a class="link" href="api-index-3-22.html#api-index-3.22">3.22</a></p>
|
||
<p class="stability">Stability Level: <acronym title="Unstable interfaces are experimental or transitional. They are typically used to
|
||
give outside developers early access to new or rapidly changing technology, or
|
||
to provide an interim solution to a problem where a more general solution is
|
||
anticipated. No claims are made about either source or binary compatibility from
|
||
one minor release to the next.
|
||
|
||
The Unstable interface level is a warning that these interfaces are subject to
|
||
change without warning and should not be used in unbundled products.
|
||
|
||
Given such caveats, customer impact need not be a factor when considering
|
||
incompatible changes to an Unstable interface in a major or minor release.
|
||
Nonetheless, when such changes are introduced, the changes should still be
|
||
mentioned in the release notes for the affected release.
|
||
"><span class="acronym">Unstable</span></acronym></p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GdkWindowEdge"></a><h3>enum GdkWindowEdge</h3>
|
||
<p>Determines a window edge or corner.</p>
|
||
<div class="refsect3">
|
||
<a name="GdkWindowEdge.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="GDK-WINDOW-EDGE-NORTH-WEST:CAPS"></a>GDK_WINDOW_EDGE_NORTH_WEST</p></td>
|
||
<td class="enum_member_description">
|
||
<p>the top left corner.</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-WINDOW-EDGE-NORTH:CAPS"></a>GDK_WINDOW_EDGE_NORTH</p></td>
|
||
<td class="enum_member_description">
|
||
<p>the top edge.</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-WINDOW-EDGE-NORTH-EAST:CAPS"></a>GDK_WINDOW_EDGE_NORTH_EAST</p></td>
|
||
<td class="enum_member_description">
|
||
<p>the top right corner.</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-WINDOW-EDGE-WEST:CAPS"></a>GDK_WINDOW_EDGE_WEST</p></td>
|
||
<td class="enum_member_description">
|
||
<p>the left edge.</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-WINDOW-EDGE-EAST:CAPS"></a>GDK_WINDOW_EDGE_EAST</p></td>
|
||
<td class="enum_member_description">
|
||
<p>the right edge.</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-WINDOW-EDGE-SOUTH-WEST:CAPS"></a>GDK_WINDOW_EDGE_SOUTH_WEST</p></td>
|
||
<td class="enum_member_description">
|
||
<p>the lower left corner.</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-WINDOW-EDGE-SOUTH:CAPS"></a>GDK_WINDOW_EDGE_SOUTH</p></td>
|
||
<td class="enum_member_description">
|
||
<p>the lower edge.</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-WINDOW-EDGE-SOUTH-EAST:CAPS"></a>GDK_WINDOW_EDGE_SOUTH_EAST</p></td>
|
||
<td class="enum_member_description">
|
||
<p>the lower right corner.</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GdkWindowTypeHint"></a><h3>enum GdkWindowTypeHint</h3>
|
||
<p>These are hints for the window manager that indicate what type of function
|
||
the window has. The window manager can use this when determining decoration
|
||
and behaviour of the window. The hint must be set before mapping the window.</p>
|
||
<p>See the <a class="ulink" href="http://www.freedesktop.org/Standards/wm-spec" target="_top">Extended Window Manager Hints</a>
|
||
specification for more details about window types.</p>
|
||
<div class="refsect3">
|
||
<a name="GdkWindowTypeHint.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="GDK-WINDOW-TYPE-HINT-NORMAL:CAPS"></a>GDK_WINDOW_TYPE_HINT_NORMAL</p></td>
|
||
<td class="enum_member_description">
|
||
<p>Normal toplevel window.</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-WINDOW-TYPE-HINT-DIALOG:CAPS"></a>GDK_WINDOW_TYPE_HINT_DIALOG</p></td>
|
||
<td class="enum_member_description">
|
||
<p>Dialog window.</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-WINDOW-TYPE-HINT-MENU:CAPS"></a>GDK_WINDOW_TYPE_HINT_MENU</p></td>
|
||
<td class="enum_member_description">
|
||
<p>Window used to implement a menu; GTK+ uses
|
||
this hint only for torn-off menus, see <span class="type">GtkTearoffMenuItem</span>.</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-WINDOW-TYPE-HINT-TOOLBAR:CAPS"></a>GDK_WINDOW_TYPE_HINT_TOOLBAR</p></td>
|
||
<td class="enum_member_description">
|
||
<p>Window used to implement toolbars.</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-WINDOW-TYPE-HINT-SPLASHSCREEN:CAPS"></a>GDK_WINDOW_TYPE_HINT_SPLASHSCREEN</p></td>
|
||
<td class="enum_member_description">
|
||
<p>Window used to display a splash
|
||
screen during application startup.</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-WINDOW-TYPE-HINT-UTILITY:CAPS"></a>GDK_WINDOW_TYPE_HINT_UTILITY</p></td>
|
||
<td class="enum_member_description">
|
||
<p>Utility windows which are not detached
|
||
toolbars or dialogs.</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-WINDOW-TYPE-HINT-DOCK:CAPS"></a>GDK_WINDOW_TYPE_HINT_DOCK</p></td>
|
||
<td class="enum_member_description">
|
||
<p>Used for creating dock or panel windows.</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-WINDOW-TYPE-HINT-DESKTOP:CAPS"></a>GDK_WINDOW_TYPE_HINT_DESKTOP</p></td>
|
||
<td class="enum_member_description">
|
||
<p>Used for creating the desktop background
|
||
window.</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-WINDOW-TYPE-HINT-DROPDOWN-MENU:CAPS"></a>GDK_WINDOW_TYPE_HINT_DROPDOWN_MENU</p></td>
|
||
<td class="enum_member_description">
|
||
<p>A menu that belongs to a menubar.</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-WINDOW-TYPE-HINT-POPUP-MENU:CAPS"></a>GDK_WINDOW_TYPE_HINT_POPUP_MENU</p></td>
|
||
<td class="enum_member_description">
|
||
<p>A menu that does not belong to a menubar,
|
||
e.g. a context menu.</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-WINDOW-TYPE-HINT-TOOLTIP:CAPS"></a>GDK_WINDOW_TYPE_HINT_TOOLTIP</p></td>
|
||
<td class="enum_member_description">
|
||
<p>A tooltip.</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-WINDOW-TYPE-HINT-NOTIFICATION:CAPS"></a>GDK_WINDOW_TYPE_HINT_NOTIFICATION</p></td>
|
||
<td class="enum_member_description">
|
||
<p>A notification - typically a “bubble”
|
||
that belongs to a status icon.</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-WINDOW-TYPE-HINT-COMBO:CAPS"></a>GDK_WINDOW_TYPE_HINT_COMBO</p></td>
|
||
<td class="enum_member_description">
|
||
<p>A popup from a combo box.</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-WINDOW-TYPE-HINT-DND:CAPS"></a>GDK_WINDOW_TYPE_HINT_DND</p></td>
|
||
<td class="enum_member_description">
|
||
<p>A window that is used to implement a DND cursor.</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GdkWindowAttr"></a><h3>struct GdkWindowAttr</h3>
|
||
<pre class="programlisting">struct GdkWindowAttr {
|
||
gchar *title;
|
||
gint event_mask;
|
||
gint x, y;
|
||
gint width;
|
||
gint height;
|
||
GdkWindowWindowClass wclass;
|
||
GdkVisual *visual;
|
||
GdkWindowType window_type;
|
||
GdkCursor *cursor;
|
||
gchar *wmclass_name;
|
||
gchar *wmclass_class;
|
||
gboolean override_redirect;
|
||
GdkWindowTypeHint type_hint;
|
||
};
|
||
</pre>
|
||
<p>Attributes to use for a newly-created window.</p>
|
||
<div class="refsect3">
|
||
<a name="GdkWindowAttr.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><span class="type">gchar</span> *<em class="structfield"><code><a name="GdkWindowAttr.title"></a>title</code></em>;</p></td>
|
||
<td class="struct_member_description"><p>title of the window (for toplevel windows)</p></td>
|
||
<td class="struct_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="struct_member_name"><p><span class="type">gint</span> <em class="structfield"><code><a name="GdkWindowAttr.event-mask"></a>event_mask</code></em>;</p></td>
|
||
<td class="struct_member_description"><p>event mask (see <a class="link" href="gdk3-Windows.html#gdk-window-set-events" title="gdk_window_set_events ()"><code class="function">gdk_window_set_events()</code></a>)</p></td>
|
||
<td class="struct_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="struct_member_name"><p><span class="type">gint</span> <em class="structfield"><code><a name="GdkWindowAttr.x"></a>x</code></em>;</p></td>
|
||
<td class="struct_member_description"><p>X coordinate relative to parent window (see <a class="link" href="gdk3-Windows.html#gdk-window-move" title="gdk_window_move ()"><code class="function">gdk_window_move()</code></a>)</p></td>
|
||
<td class="struct_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="struct_member_name"><p><span class="type">gint</span> <em class="structfield"><code><a name="GdkWindowAttr.y"></a>y</code></em>;</p></td>
|
||
<td class="struct_member_description"><p>Y coordinate relative to parent window (see <a class="link" href="gdk3-Windows.html#gdk-window-move" title="gdk_window_move ()"><code class="function">gdk_window_move()</code></a>)</p></td>
|
||
<td class="struct_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="struct_member_name"><p><span class="type">gint</span> <em class="structfield"><code><a name="GdkWindowAttr.width"></a>width</code></em>;</p></td>
|
||
<td class="struct_member_description"><p>width of window</p></td>
|
||
<td class="struct_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="struct_member_name"><p><span class="type">gint</span> <em class="structfield"><code><a name="GdkWindowAttr.height"></a>height</code></em>;</p></td>
|
||
<td class="struct_member_description"><p>height of window</p></td>
|
||
<td class="struct_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="struct_member_name"><p><a class="link" href="gdk3-Windows.html#GdkWindowWindowClass" title="enum GdkWindowWindowClass"><span class="type">GdkWindowWindowClass</span></a> <em class="structfield"><code><a name="GdkWindowAttr.wclass"></a>wclass</code></em>;</p></td>
|
||
<td class="struct_member_description"><p><a class="link" href="gdk3-Windows.html#GDK-INPUT-OUTPUT:CAPS"><span class="type">GDK_INPUT_OUTPUT</span></a> (normal window) or <a class="link" href="gdk3-Windows.html#GDK-INPUT-ONLY:CAPS"><span class="type">GDK_INPUT_ONLY</span></a> (invisible
|
||
window that receives events)</p></td>
|
||
<td class="struct_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="struct_member_name"><p><a class="link" href="gdk3-Visuals.html#GdkVisual"><span class="type">GdkVisual</span></a> *<em class="structfield"><code><a name="GdkWindowAttr.visual"></a>visual</code></em>;</p></td>
|
||
<td class="struct_member_description"><p><a class="link" href="gdk3-Visuals.html#GdkVisual"><span class="type">GdkVisual</span></a> for window</p></td>
|
||
<td class="struct_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="struct_member_name"><p><a class="link" href="gdk3-Windows.html#GdkWindowType" title="enum GdkWindowType"><span class="type">GdkWindowType</span></a> <em class="structfield"><code><a name="GdkWindowAttr.window-type"></a>window_type</code></em>;</p></td>
|
||
<td class="struct_member_description"><p>type of window</p></td>
|
||
<td class="struct_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="struct_member_name"><p><a class="link" href="gdk3-Cursors.html#GdkCursor"><span class="type">GdkCursor</span></a> *<em class="structfield"><code><a name="GdkWindowAttr.cursor"></a>cursor</code></em>;</p></td>
|
||
<td class="struct_member_description"><p>cursor for the window (see <a class="link" href="gdk3-Windows.html#gdk-window-set-cursor" title="gdk_window_set_cursor ()"><code class="function">gdk_window_set_cursor()</code></a>)</p></td>
|
||
<td class="struct_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="struct_member_name"><p><span class="type">gchar</span> *<em class="structfield"><code><a name="GdkWindowAttr.wmclass-name"></a>wmclass_name</code></em>;</p></td>
|
||
<td class="struct_member_description"><p>don’t use (see <code class="function">gtk_window_set_wmclass()</code>)</p></td>
|
||
<td class="struct_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="struct_member_name"><p><span class="type">gchar</span> *<em class="structfield"><code><a name="GdkWindowAttr.wmclass-class"></a>wmclass_class</code></em>;</p></td>
|
||
<td class="struct_member_description"><p>don’t use (see <code class="function">gtk_window_set_wmclass()</code>)</p></td>
|
||
<td class="struct_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="struct_member_name"><p><span class="type">gboolean</span> <em class="structfield"><code><a name="GdkWindowAttr.override-redirect"></a>override_redirect</code></em>;</p></td>
|
||
<td class="struct_member_description"><p><code class="literal">TRUE</code> to bypass the window manager</p></td>
|
||
<td class="struct_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="struct_member_name"><p><a class="link" href="gdk3-Windows.html#GdkWindowTypeHint" title="enum GdkWindowTypeHint"><span class="type">GdkWindowTypeHint</span></a> <em class="structfield"><code><a name="GdkWindowAttr.type-hint"></a>type_hint</code></em>;</p></td>
|
||
<td class="struct_member_description"><p>a hint of the function of the window</p></td>
|
||
<td class="struct_member_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GdkWindowAttributesType"></a><h3>enum GdkWindowAttributesType</h3>
|
||
<p>Used to indicate which fields in the <a class="link" href="gdk3-Windows.html#GdkWindowAttr" title="struct GdkWindowAttr"><span class="type">GdkWindowAttr</span></a> struct should be honored.
|
||
For example, if you filled in the “cursor” and “x” fields of <a class="link" href="gdk3-Windows.html#GdkWindowAttr" title="struct GdkWindowAttr"><span class="type">GdkWindowAttr</span></a>,
|
||
pass “<em class="parameter"><code>GDK_WA_X</code></em>
|
||
| <em class="parameter"><code>GDK_WA_CURSOR</code></em>
|
||
” to <a class="link" href="gdk3-Windows.html#gdk-window-new" title="gdk_window_new ()"><code class="function">gdk_window_new()</code></a>. Fields in
|
||
<a class="link" href="gdk3-Windows.html#GdkWindowAttr" title="struct GdkWindowAttr"><span class="type">GdkWindowAttr</span></a> not covered by a bit in this enum are required; for example,
|
||
the <em class="parameter"><code>width</code></em>
|
||
/<em class="parameter"><code>height</code></em>
|
||
, <em class="parameter"><code>wclass</code></em>
|
||
, and <em class="parameter"><code>window_type</code></em>
|
||
fields are required, they have
|
||
no corresponding flag in <a class="link" href="gdk3-Windows.html#GdkWindowAttributesType" title="enum GdkWindowAttributesType"><span class="type">GdkWindowAttributesType</span></a>.</p>
|
||
<div class="refsect3">
|
||
<a name="GdkWindowAttributesType.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="GDK-WA-TITLE:CAPS"></a>GDK_WA_TITLE</p></td>
|
||
<td class="enum_member_description">
|
||
<p>Honor the title field</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-WA-X:CAPS"></a>GDK_WA_X</p></td>
|
||
<td class="enum_member_description">
|
||
<p>Honor the X coordinate field</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-WA-Y:CAPS"></a>GDK_WA_Y</p></td>
|
||
<td class="enum_member_description">
|
||
<p>Honor the Y coordinate field</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-WA-CURSOR:CAPS"></a>GDK_WA_CURSOR</p></td>
|
||
<td class="enum_member_description">
|
||
<p>Honor the cursor field</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-WA-VISUAL:CAPS"></a>GDK_WA_VISUAL</p></td>
|
||
<td class="enum_member_description">
|
||
<p>Honor the visual field</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-WA-WMCLASS:CAPS"></a>GDK_WA_WMCLASS</p></td>
|
||
<td class="enum_member_description">
|
||
<p>Honor the wmclass_class and wmclass_name fields</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-WA-NOREDIR:CAPS"></a>GDK_WA_NOREDIR</p></td>
|
||
<td class="enum_member_description">
|
||
<p>Honor the override_redirect field</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-WA-TYPE-HINT:CAPS"></a>GDK_WA_TYPE_HINT</p></td>
|
||
<td class="enum_member_description">
|
||
<p>Honor the type_hint field</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GdkFullscreenMode"></a><h3>enum GdkFullscreenMode</h3>
|
||
<p>Indicates which monitor (in a multi-head setup) a window should span over
|
||
when in fullscreen mode.</p>
|
||
<div class="refsect3">
|
||
<a name="GdkFullscreenMode.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="GDK-FULLSCREEN-ON-CURRENT-MONITOR:CAPS"></a>GDK_FULLSCREEN_ON_CURRENT_MONITOR</p></td>
|
||
<td class="enum_member_description">
|
||
<p>Fullscreen on current monitor only.</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-FULLSCREEN-ON-ALL-MONITORS:CAPS"></a>GDK_FULLSCREEN_ON_ALL_MONITORS</p></td>
|
||
<td class="enum_member_description">
|
||
<p>Span across all monitors when fullscreen.</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: <a class="link" href="api-index-3-8.html#api-index-3.8">3.8</a></p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GdkFilterReturn"></a><h3>enum GdkFilterReturn</h3>
|
||
<p>Specifies the result of applying a <a class="link" href="gdk3-Windows.html#GdkFilterFunc" title="GdkFilterFunc ()"><span class="type">GdkFilterFunc</span></a> to a native event.</p>
|
||
<div class="refsect3">
|
||
<a name="GdkFilterReturn.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="GDK-FILTER-CONTINUE:CAPS"></a>GDK_FILTER_CONTINUE</p></td>
|
||
<td class="enum_member_description">
|
||
<p>event not handled, continue processing.</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-FILTER-TRANSLATE:CAPS"></a>GDK_FILTER_TRANSLATE</p></td>
|
||
<td class="enum_member_description">
|
||
<p>native event translated into a GDK event and stored
|
||
in the <code class="literal">event</code> structure that was passed in.</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-FILTER-REMOVE:CAPS"></a>GDK_FILTER_REMOVE</p></td>
|
||
<td class="enum_member_description">
|
||
<p>event handled, terminate processing.</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GdkXEvent"></a><h3>GdkXEvent</h3>
|
||
<pre class="programlisting">typedef void GdkXEvent; /* Can be cast to window system specific
|
||
</pre>
|
||
<p>Used to represent native events (XEvents for the X11
|
||
backend, MSGs for Win32).</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GDK-PARENT-RELATIVE:CAPS"></a><h3>GDK_PARENT_RELATIVE</h3>
|
||
<pre class="programlisting">#define GDK_PARENT_RELATIVE 1L
|
||
</pre>
|
||
<p>A special value, indicating that the background
|
||
for a window should be inherited from the parent window.</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GdkModifierType"></a><h3>enum GdkModifierType</h3>
|
||
<p>A set of bit-flags to indicate the state of modifier keys and mouse buttons
|
||
in various event types. Typical modifier keys are Shift, Control, Meta,
|
||
Super, Hyper, Alt, Compose, Apple, CapsLock or ShiftLock.</p>
|
||
<p>Like the X Window System, GDK supports 8 modifier keys and 5 mouse buttons.</p>
|
||
<p>Since 2.10, GDK recognizes which of the Meta, Super or Hyper keys are mapped
|
||
to Mod2 - Mod5, and indicates this by setting <a class="link" href="gdk3-Windows.html#GDK-SUPER-MASK:CAPS"><code class="literal">GDK_SUPER_MASK</code></a>,
|
||
<a class="link" href="gdk3-Windows.html#GDK-HYPER-MASK:CAPS"><code class="literal">GDK_HYPER_MASK</code></a> or <a class="link" href="gdk3-Windows.html#GDK-META-MASK:CAPS"><code class="literal">GDK_META_MASK</code></a> in the state field of key events.</p>
|
||
<p>Note that GDK may add internal values to events which include
|
||
reserved values such as <a class="link" href="gdk3-Windows.html#GDK-MODIFIER-RESERVED-13-MASK:CAPS"><code class="literal">GDK_MODIFIER_RESERVED_13_MASK</code></a>. Your code
|
||
should preserve and ignore them. You can use <a class="link" href="gdk3-Windows.html#GDK-MODIFIER-MASK:CAPS"><code class="literal">GDK_MODIFIER_MASK</code></a> to
|
||
remove all reserved values.</p>
|
||
<p>Also note that the GDK X backend interprets button press events for button
|
||
4-7 as scroll events, so <a class="link" href="gdk3-Windows.html#GDK-BUTTON4-MASK:CAPS"><code class="literal">GDK_BUTTON4_MASK</code></a> and <a class="link" href="gdk3-Windows.html#GDK-BUTTON5-MASK:CAPS"><code class="literal">GDK_BUTTON5_MASK</code></a> will never
|
||
be set.</p>
|
||
<div class="refsect3">
|
||
<a name="GdkModifierType.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="GDK-SHIFT-MASK:CAPS"></a>GDK_SHIFT_MASK</p></td>
|
||
<td class="enum_member_description">
|
||
<p>the Shift key.</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-LOCK-MASK:CAPS"></a>GDK_LOCK_MASK</p></td>
|
||
<td class="enum_member_description">
|
||
<p>a Lock key (depending on the modifier mapping of the
|
||
X server this may either be CapsLock or ShiftLock).</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-CONTROL-MASK:CAPS"></a>GDK_CONTROL_MASK</p></td>
|
||
<td class="enum_member_description">
|
||
<p>the Control key.</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-MOD1-MASK:CAPS"></a>GDK_MOD1_MASK</p></td>
|
||
<td class="enum_member_description">
|
||
<p>the fourth modifier key (it depends on the modifier
|
||
mapping of the X server which key is interpreted as this modifier, but
|
||
normally it is the Alt key).</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-MOD2-MASK:CAPS"></a>GDK_MOD2_MASK</p></td>
|
||
<td class="enum_member_description">
|
||
<p>the fifth modifier key (it depends on the modifier
|
||
mapping of the X server which key is interpreted as this modifier).</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-MOD3-MASK:CAPS"></a>GDK_MOD3_MASK</p></td>
|
||
<td class="enum_member_description">
|
||
<p>the sixth modifier key (it depends on the modifier
|
||
mapping of the X server which key is interpreted as this modifier).</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-MOD4-MASK:CAPS"></a>GDK_MOD4_MASK</p></td>
|
||
<td class="enum_member_description">
|
||
<p>the seventh modifier key (it depends on the modifier
|
||
mapping of the X server which key is interpreted as this modifier).</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-MOD5-MASK:CAPS"></a>GDK_MOD5_MASK</p></td>
|
||
<td class="enum_member_description">
|
||
<p>the eighth modifier key (it depends on the modifier
|
||
mapping of the X server which key is interpreted as this modifier).</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-BUTTON1-MASK:CAPS"></a>GDK_BUTTON1_MASK</p></td>
|
||
<td class="enum_member_description">
|
||
<p>the first mouse button.</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-BUTTON2-MASK:CAPS"></a>GDK_BUTTON2_MASK</p></td>
|
||
<td class="enum_member_description">
|
||
<p>the second mouse button.</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-BUTTON3-MASK:CAPS"></a>GDK_BUTTON3_MASK</p></td>
|
||
<td class="enum_member_description">
|
||
<p>the third mouse button.</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-BUTTON4-MASK:CAPS"></a>GDK_BUTTON4_MASK</p></td>
|
||
<td class="enum_member_description">
|
||
<p>the fourth mouse button.</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-BUTTON5-MASK:CAPS"></a>GDK_BUTTON5_MASK</p></td>
|
||
<td class="enum_member_description">
|
||
<p>the fifth mouse button.</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-MODIFIER-RESERVED-13-MASK:CAPS"></a>GDK_MODIFIER_RESERVED_13_MASK</p></td>
|
||
<td class="enum_member_description">
|
||
<p>A reserved bit flag; do not use in your own code</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-MODIFIER-RESERVED-14-MASK:CAPS"></a>GDK_MODIFIER_RESERVED_14_MASK</p></td>
|
||
<td class="enum_member_description">
|
||
<p>A reserved bit flag; do not use in your own code</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-MODIFIER-RESERVED-15-MASK:CAPS"></a>GDK_MODIFIER_RESERVED_15_MASK</p></td>
|
||
<td class="enum_member_description">
|
||
<p>A reserved bit flag; do not use in your own code</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-MODIFIER-RESERVED-16-MASK:CAPS"></a>GDK_MODIFIER_RESERVED_16_MASK</p></td>
|
||
<td class="enum_member_description">
|
||
<p>A reserved bit flag; do not use in your own code</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-MODIFIER-RESERVED-17-MASK:CAPS"></a>GDK_MODIFIER_RESERVED_17_MASK</p></td>
|
||
<td class="enum_member_description">
|
||
<p>A reserved bit flag; do not use in your own code</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-MODIFIER-RESERVED-18-MASK:CAPS"></a>GDK_MODIFIER_RESERVED_18_MASK</p></td>
|
||
<td class="enum_member_description">
|
||
<p>A reserved bit flag; do not use in your own code</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-MODIFIER-RESERVED-19-MASK:CAPS"></a>GDK_MODIFIER_RESERVED_19_MASK</p></td>
|
||
<td class="enum_member_description">
|
||
<p>A reserved bit flag; do not use in your own code</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-MODIFIER-RESERVED-20-MASK:CAPS"></a>GDK_MODIFIER_RESERVED_20_MASK</p></td>
|
||
<td class="enum_member_description">
|
||
<p>A reserved bit flag; do not use in your own code</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-MODIFIER-RESERVED-21-MASK:CAPS"></a>GDK_MODIFIER_RESERVED_21_MASK</p></td>
|
||
<td class="enum_member_description">
|
||
<p>A reserved bit flag; do not use in your own code</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-MODIFIER-RESERVED-22-MASK:CAPS"></a>GDK_MODIFIER_RESERVED_22_MASK</p></td>
|
||
<td class="enum_member_description">
|
||
<p>A reserved bit flag; do not use in your own code</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-MODIFIER-RESERVED-23-MASK:CAPS"></a>GDK_MODIFIER_RESERVED_23_MASK</p></td>
|
||
<td class="enum_member_description">
|
||
<p>A reserved bit flag; do not use in your own code</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-MODIFIER-RESERVED-24-MASK:CAPS"></a>GDK_MODIFIER_RESERVED_24_MASK</p></td>
|
||
<td class="enum_member_description">
|
||
<p>A reserved bit flag; do not use in your own code</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-MODIFIER-RESERVED-25-MASK:CAPS"></a>GDK_MODIFIER_RESERVED_25_MASK</p></td>
|
||
<td class="enum_member_description">
|
||
<p>A reserved bit flag; do not use in your own code</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-SUPER-MASK:CAPS"></a>GDK_SUPER_MASK</p></td>
|
||
<td class="enum_member_description">
|
||
<p>the Super modifier. Since 2.10</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-HYPER-MASK:CAPS"></a>GDK_HYPER_MASK</p></td>
|
||
<td class="enum_member_description">
|
||
<p>the Hyper modifier. Since 2.10</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-META-MASK:CAPS"></a>GDK_META_MASK</p></td>
|
||
<td class="enum_member_description">
|
||
<p>the Meta modifier. Since 2.10</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-MODIFIER-RESERVED-29-MASK:CAPS"></a>GDK_MODIFIER_RESERVED_29_MASK</p></td>
|
||
<td class="enum_member_description">
|
||
<p>A reserved bit flag; do not use in your own code</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-RELEASE-MASK:CAPS"></a>GDK_RELEASE_MASK</p></td>
|
||
<td class="enum_member_description">
|
||
<p>not used in GDK itself. GTK+ uses it to differentiate
|
||
between (keyval, modifiers) pairs from key press and release events.</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-MODIFIER-MASK:CAPS"></a>GDK_MODIFIER_MASK</p></td>
|
||
<td class="enum_member_description">
|
||
<p>a mask covering all modifier types.</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GdkModifierIntent"></a><h3>enum GdkModifierIntent</h3>
|
||
<p>This enum is used with <a class="link" href="gdk3-Keyboard-Handling.html#gdk-keymap-get-modifier-mask" title="gdk_keymap_get_modifier_mask ()"><code class="function">gdk_keymap_get_modifier_mask()</code></a>
|
||
in order to determine what modifiers the
|
||
currently used windowing system backend uses for particular
|
||
purposes. For example, on X11/Windows, the Control key is used for
|
||
invoking menu shortcuts (accelerators), whereas on Apple computers
|
||
it’s the Command key (which correspond to <a class="link" href="gdk3-Windows.html#GDK-CONTROL-MASK:CAPS"><code class="literal">GDK_CONTROL_MASK</code></a> and
|
||
<a class="link" href="gdk3-Windows.html#GDK-MOD2-MASK:CAPS"><code class="literal">GDK_MOD2_MASK</code></a>, respectively).</p>
|
||
<div class="refsect3">
|
||
<a name="GdkModifierIntent.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="GDK-MODIFIER-INTENT-PRIMARY-ACCELERATOR:CAPS"></a>GDK_MODIFIER_INTENT_PRIMARY_ACCELERATOR</p></td>
|
||
<td class="enum_member_description">
|
||
<p>the primary modifier used to invoke
|
||
menu accelerators.</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-MODIFIER-INTENT-CONTEXT-MENU:CAPS"></a>GDK_MODIFIER_INTENT_CONTEXT_MENU</p></td>
|
||
<td class="enum_member_description">
|
||
<p>the modifier used to invoke context menus.
|
||
Note that mouse button 3 always triggers context menus. When this modifier
|
||
is not 0, it additionally triggers context menus when used with mouse button 1.</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-MODIFIER-INTENT-EXTEND-SELECTION:CAPS"></a>GDK_MODIFIER_INTENT_EXTEND_SELECTION</p></td>
|
||
<td class="enum_member_description">
|
||
<p>the modifier used to extend selections
|
||
using <code class="literal">modifier</code>-click or <code class="literal">modifier</code>-cursor-key</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-MODIFIER-INTENT-MODIFY-SELECTION:CAPS"></a>GDK_MODIFIER_INTENT_MODIFY_SELECTION</p></td>
|
||
<td class="enum_member_description">
|
||
<p>the modifier used to modify selections,
|
||
which in most cases means toggling the clicked item into or out of the selection.</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-MODIFIER-INTENT-NO-TEXT-INPUT:CAPS"></a>GDK_MODIFIER_INTENT_NO_TEXT_INPUT</p></td>
|
||
<td class="enum_member_description">
|
||
<p>when any of these modifiers is pressed, the
|
||
key event cannot produce a symbol directly. This is meant to be used for
|
||
input methods, and for use cases like typeahead search.</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-MODIFIER-INTENT-SHIFT-GROUP:CAPS"></a>GDK_MODIFIER_INTENT_SHIFT_GROUP</p></td>
|
||
<td class="enum_member_description">
|
||
<p>the modifier that switches between keyboard
|
||
groups (AltGr on X11/Windows and Option/Alt on OS X).</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-MODIFIER-INTENT-DEFAULT-MOD-MASK:CAPS"></a>GDK_MODIFIER_INTENT_DEFAULT_MOD_MASK</p></td>
|
||
<td class="enum_member_description">
|
||
<p>The set of modifier masks accepted
|
||
as modifiers in accelerators. Needed because Command is mapped to MOD2 on
|
||
OSX, which is widely used, but on X11 MOD2 is NumLock and using that for a
|
||
mod key is problematic at best.
|
||
Ref: https://bugzilla.gnome.org/show_bug.cgi?id=736125.</p>
|
||
</td>
|
||
<td class="enum_member_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="GdkWMDecoration"></a><h3>enum GdkWMDecoration</h3>
|
||
<p>These are hints originally defined by the Motif toolkit.
|
||
The window manager can use them when determining how to decorate
|
||
the window. The hint must be set before mapping the window.</p>
|
||
<div class="refsect3">
|
||
<a name="GdkWMDecoration.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="GDK-DECOR-ALL:CAPS"></a>GDK_DECOR_ALL</p></td>
|
||
<td class="enum_member_description">
|
||
<p>all decorations should be applied.</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-DECOR-BORDER:CAPS"></a>GDK_DECOR_BORDER</p></td>
|
||
<td class="enum_member_description">
|
||
<p>a frame should be drawn around the window.</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-DECOR-RESIZEH:CAPS"></a>GDK_DECOR_RESIZEH</p></td>
|
||
<td class="enum_member_description">
|
||
<p>the frame should have resize handles.</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-DECOR-TITLE:CAPS"></a>GDK_DECOR_TITLE</p></td>
|
||
<td class="enum_member_description">
|
||
<p>a titlebar should be placed above the window.</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-DECOR-MENU:CAPS"></a>GDK_DECOR_MENU</p></td>
|
||
<td class="enum_member_description">
|
||
<p>a button for opening a menu should be included.</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-DECOR-MINIMIZE:CAPS"></a>GDK_DECOR_MINIMIZE</p></td>
|
||
<td class="enum_member_description">
|
||
<p>a minimize button should be included.</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-DECOR-MAXIMIZE:CAPS"></a>GDK_DECOR_MAXIMIZE</p></td>
|
||
<td class="enum_member_description">
|
||
<p>a maximize button should be included.</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GdkWMFunction"></a><h3>enum GdkWMFunction</h3>
|
||
<p>These are hints originally defined by the Motif toolkit. The window manager
|
||
can use them when determining the functions to offer for the window. The
|
||
hint must be set before mapping the window.</p>
|
||
<div class="refsect3">
|
||
<a name="GdkWMFunction.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="GDK-FUNC-ALL:CAPS"></a>GDK_FUNC_ALL</p></td>
|
||
<td class="enum_member_description">
|
||
<p>all functions should be offered.</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-FUNC-RESIZE:CAPS"></a>GDK_FUNC_RESIZE</p></td>
|
||
<td class="enum_member_description">
|
||
<p>the window should be resizable.</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-FUNC-MOVE:CAPS"></a>GDK_FUNC_MOVE</p></td>
|
||
<td class="enum_member_description">
|
||
<p>the window should be movable.</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-FUNC-MINIMIZE:CAPS"></a>GDK_FUNC_MINIMIZE</p></td>
|
||
<td class="enum_member_description">
|
||
<p>the window should be minimizable.</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-FUNC-MAXIMIZE:CAPS"></a>GDK_FUNC_MAXIMIZE</p></td>
|
||
<td class="enum_member_description">
|
||
<p>the window should be maximizable.</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GDK-FUNC-CLOSE:CAPS"></a>GDK_FUNC_CLOSE</p></td>
|
||
<td class="enum_member_description">
|
||
<p>the window should be closable.</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="gdk3-Windows.property-details"></a><h2>Property Details</h2>
|
||
<div class="refsect2">
|
||
<a name="GdkWindow--cursor"></a><h3>The <code class="literal">“cursor”</code> property</h3>
|
||
<pre class="programlisting"> “cursor” <a class="link" href="gdk3-Cursors.html#GdkCursor"><span class="type">GdkCursor</span></a> *</pre>
|
||
<p>The mouse pointer for a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a>. See <a class="link" href="gdk3-Windows.html#gdk-window-set-cursor" title="gdk_window_set_cursor ()"><code class="function">gdk_window_set_cursor()</code></a> and
|
||
<a class="link" href="gdk3-Windows.html#gdk-window-get-cursor" title="gdk_window_get_cursor ()"><code class="function">gdk_window_get_cursor()</code></a> for details.</p>
|
||
<p>Flags: Read / Write</p>
|
||
<p class="since">Since: 2.18</p>
|
||
</div>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="gdk3-Windows.signal-details"></a><h2>Signal Details</h2>
|
||
<div class="refsect2">
|
||
<a name="GdkWindow-create-surface"></a><h3>The <code class="literal">“create-surface”</code> signal</h3>
|
||
<pre class="programlisting"><span class="returnvalue">CairoSurface</span>*
|
||
user_function (<a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window,
|
||
<span class="type">gint</span> width,
|
||
<span class="type">gint</span> height,
|
||
<span class="type">gpointer</span> user_data)</pre>
|
||
<p>The ::create-surface signal is emitted when an offscreen window
|
||
needs its surface (re)created, which happens either when the
|
||
window is first drawn to, or when the window is being
|
||
resized. The first signal handler that returns a non-<code class="literal">NULL</code>
|
||
surface will stop any further signal emission, and its surface
|
||
will be used.</p>
|
||
<p>Note that it is not possible to access the window's previous
|
||
surface from within any callback of this signal. Calling
|
||
<a class="link" href="gdk3-Windows.html#gdk-offscreen-window-get-surface" title="gdk_offscreen_window_get_surface ()"><code class="function">gdk_offscreen_window_get_surface()</code></a> will lead to a crash.</p>
|
||
<div class="refsect3">
|
||
<a name="GdkWindow-create-surface.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 offscreen window on which the signal is emitted</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>width</p></td>
|
||
<td class="parameter_description"><p>the width of the offscreen surface to create</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>height</p></td>
|
||
<td class="parameter_description"><p>the height of the offscreen surface to create</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>
|
||
<div class="refsect3">
|
||
<a name="GdkWindow-create-surface.returns"></a><h4>Returns</h4>
|
||
<p> the newly created <a href="/usr/share/gtk-doc/html/cairo/cairo-cairo-surface-t.html#cairo-surface-t"><span class="type">cairo_surface_t</span></a> for the offscreen window</p>
|
||
</div>
|
||
<p>Flags: Run Last</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="GdkWindow-from-embedder"></a><h3>The <code class="literal">“from-embedder”</code> signal</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
user_function (<a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window,
|
||
<span class="type">gdouble</span> embedder_x,
|
||
<span class="type">gdouble</span> embedder_y,
|
||
<span class="type">gpointer</span> offscreen_x,
|
||
<span class="type">gpointer</span> offscreen_y,
|
||
<span class="type">gpointer</span> user_data)</pre>
|
||
<p>The ::from-embedder signal is emitted to translate coordinates
|
||
in the embedder of an offscreen window to the offscreen window.</p>
|
||
<p>See also <a class="link" href="gdk3-Windows.html#GdkWindow-to-embedder" title="The “to-embedder” signal"><span class="type">“to-embedder”</span></a>.</p>
|
||
<div class="refsect3">
|
||
<a name="GdkWindow-from-embedder.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 offscreen window on which the signal is emitted</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>embedder_x</p></td>
|
||
<td class="parameter_description"><p>x coordinate in the embedder window</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>embedder_y</p></td>
|
||
<td class="parameter_description"><p>y coordinate in the embedder window</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>offscreen_x</p></td>
|
||
<td class="parameter_description"><p>return location for the x
|
||
coordinate in the offscreen window. </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="Override the parsed C type with given type."><span class="acronym">type</span></acronym> double]</span></td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>offscreen_y</p></td>
|
||
<td class="parameter_description"><p>return location for the y
|
||
coordinate in the offscreen window. </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="Override the parsed C type with given type."><span class="acronym">type</span></acronym> double]</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.18</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GdkWindow-moved-to-rect"></a><h3>The <code class="literal">“moved-to-rect”</code> signal</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
user_function (<a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window,
|
||
<span class="type">gpointer</span> flipped_rect,
|
||
<span class="type">gpointer</span> final_rect,
|
||
<span class="type">gboolean</span> flipped_x,
|
||
<span class="type">gboolean</span> flipped_y,
|
||
<span class="type">gpointer</span> user_data)</pre>
|
||
<p>Emitted when the position of <em class="parameter"><code>window</code></em>
|
||
is finalized after being moved to a
|
||
destination rectangle.</p>
|
||
<p><em class="parameter"><code>window</code></em>
|
||
might be flipped over the destination rectangle in order to keep
|
||
it on-screen, in which case <em class="parameter"><code>flipped_x</code></em>
|
||
and <em class="parameter"><code>flipped_y</code></em>
|
||
will be set to <code class="literal">TRUE</code>
|
||
accordingly.</p>
|
||
<p><em class="parameter"><code>flipped_rect</code></em>
|
||
is the ideal position of <em class="parameter"><code>window</code></em>
|
||
after any possible
|
||
flipping, but before any possible sliding. <em class="parameter"><code>final_rect</code></em>
|
||
is <em class="parameter"><code>flipped_rect</code></em>
|
||
,
|
||
but possibly translated in the case that flipping is still ineffective in
|
||
keeping <em class="parameter"><code>window</code></em>
|
||
on-screen.</p>
|
||
<div class="refsect3">
|
||
<a name="GdkWindow-moved-to-rect.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 <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> that moved</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>flipped_rect</p></td>
|
||
<td class="parameter_description"><p>the position of <em class="parameter"><code>window</code></em>
|
||
after any possible
|
||
flipping or <code class="literal">NULL</code> if the backend can't obtain it. </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>final_rect</p></td>
|
||
<td class="parameter_description"><p>the final position of <em class="parameter"><code>window</code></em>
|
||
or <code class="literal">NULL</code> if the
|
||
backend can't obtain it. </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>flipped_x</p></td>
|
||
<td class="parameter_description"><p><code class="literal">TRUE</code> if the anchors were flipped horizontally</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>flipped_y</p></td>
|
||
<td class="parameter_description"><p><code class="literal">TRUE</code> if the anchors were flipped vertically</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>
|
||
<p class="since">Since: <a class="link" href="api-index-3-22.html#api-index-3.22">3.22</a></p>
|
||
<p class="stability">Stability Level: <acronym title="An interface that can be used within the GNOME stack itself, but that is not
|
||
documented for end-users. Such functions should only be used in specified and
|
||
documented ways.
|
||
"><span class="acronym">Private</span></acronym></p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GdkWindow-pick-embedded-child"></a><h3>The <code class="literal">“pick-embedded-child”</code> signal</h3>
|
||
<pre class="programlisting"><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="returnvalue">GdkWindow</span></a>*
|
||
user_function (<a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window,
|
||
<span class="type">gdouble</span> x,
|
||
<span class="type">gdouble</span> y,
|
||
<span class="type">gpointer</span> user_data)</pre>
|
||
<p>The ::pick-embedded-child signal is emitted to find an embedded
|
||
child at the given position.</p>
|
||
<div class="refsect3">
|
||
<a name="GdkWindow-pick-embedded-child.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>x</p></td>
|
||
<td class="parameter_description"><p>x coordinate in the window</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>y</p></td>
|
||
<td class="parameter_description"><p>y coordinate in the window</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>
|
||
<div class="refsect3">
|
||
<a name="GdkWindow-pick-embedded-child.returns"></a><h4>Returns</h4>
|
||
<p>the <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> of the
|
||
embedded child at <em class="parameter"><code>x</code></em>
|
||
, <em class="parameter"><code>y</code></em>
|
||
, 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="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
|
||
</div>
|
||
<p>Flags: Run Last</p>
|
||
<p class="since">Since: 2.18</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GdkWindow-to-embedder"></a><h3>The <code class="literal">“to-embedder”</code> signal</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
user_function (<a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window,
|
||
<span class="type">gdouble</span> offscreen_x,
|
||
<span class="type">gdouble</span> offscreen_y,
|
||
<span class="type">gpointer</span> embedder_x,
|
||
<span class="type">gpointer</span> embedder_y,
|
||
<span class="type">gpointer</span> user_data)</pre>
|
||
<p>The ::to-embedder signal is emitted to translate coordinates
|
||
in an offscreen window to its embedder.</p>
|
||
<p>See also <a class="link" href="gdk3-Windows.html#GdkWindow-from-embedder" title="The “from-embedder” signal"><span class="type">“from-embedder”</span></a>.</p>
|
||
<div class="refsect3">
|
||
<a name="GdkWindow-to-embedder.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 offscreen window on which the signal is emitted</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>offscreen_x</p></td>
|
||
<td class="parameter_description"><p>x coordinate in the offscreen window</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>offscreen_y</p></td>
|
||
<td class="parameter_description"><p>y coordinate in the offscreen window</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>embedder_x</p></td>
|
||
<td class="parameter_description"><p>return location for the x
|
||
coordinate in the embedder window. </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="Override the parsed C type with given type."><span class="acronym">type</span></acronym> double]</span></td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>embedder_y</p></td>
|
||
<td class="parameter_description"><p>return location for the y
|
||
coordinate in the embedder window. </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="Override the parsed C type with given type."><span class="acronym">type</span></acronym> double]</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.18</p>
|
||
</div>
|
||
</div>
|
||
</div>
|
||
<div class="footer">
|
||
<hr>Generated by GTK-Doc V1.29</div>
|
||
</body>
|
||
</html> |