callisto-debian/gtk3
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

New upstream version 3.24.3

Browse Source
This commit is contained in:
Jeremy Bicha 2019-01-14 09:09:59 -05:00
commit fd8c775808
197 changed files with 434192 additions and 535722 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

446200
ChangeLog
View File

File diff suppressed because it is too large Load Diff

6
INSTALL
View File

@ -4,7 +4,7 @@ Prerequisites
GTK+ requires the following packages:
- The GLib, Pango, GdkPixbuf, ATK and cairo libraries, available at
the same location as GTK+. GTK+ 3.24.2 requires at least
the same location as GTK+. GTK+ 3.24.3 requires at least
GLib 2.53.4, Pango 1.41.0,
GdkPixbuf 2.30.0, ATK 2.15.1
and cairo 1.14.0.
@ -22,8 +22,8 @@ GTK+ requires the following packages:
Simple install procedure
========================
% tar xf gtk+-3.24.2.tar.xz # unpack the sources
% cd gtk+-3.24.2 # change to the toplevel directory
% tar xf gtk+-3.24.3.tar.xz # unpack the sources
% cd gtk+-3.24.3 # change to the toplevel directory
% ./configure # run the `configure' script
% make # build GTK+
[ Become root if necessary ]

4
Makefile.in
View File

@ -215,8 +215,8 @@ am__DIST_COMMON = $(srcdir)/INSTALL.in $(srcdir)/Makefile.in \
$(top_srcdir)/build-aux/missing ABOUT-NLS AUTHORS COPYING \
ChangeLog INSTALL NEWS README build-aux/compile \
build-aux/config.guess build-aux/config.rpath \
build-aux/config.sub build-aux/depcomp build-aux/install-sh \
build-aux/ltmain.sh build-aux/missing
build-aux/config.sub build-aux/install-sh build-aux/ltmain.sh \
build-aux/missing
DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST)
distdir = $(PACKAGE)-$(VERSION)
top_distdir = $(distdir)

21
NEWS
View File

@ -1,3 +1,24 @@
Overview of Changes in GTK+ 3.24.3
==================================
* Bugs fixed:
wayland: Respect length limits in text protocol
wayland: Support key themes
wayland: Fix hi-dpi cursor scaling
quartz: Make point-to-pixel conversions work on all versions
quartz: Re-add support for hidpi scaling
quartz: Fix search engine integration
win32: Fix ime change hangling
placessidebar: Insert drops in the right place
x11: Fix problems gdk_x11_get_parent_relative
x11: Fix Wacom tool types
icons: Recolor polygons as well in symbolic icons
switch: Use Unicode symbols for I/O instead of translations
* Translation updates:
Japanese
Overview of Changes in GTK+ 3.24.2
==================================

2
README
View File

@ -1,7 +1,7 @@
General Information
===================
This is GTK+ version 3.24.2. GTK+ is a multi-platform toolkit for
This is GTK+ version 3.24.3. GTK+ is a multi-platform toolkit for
creating graphical user interfaces. Offering a complete set of widgets,
GTK+ is suitable for projects ranging from small one-off projects to
complete application suites.

2
build/win32/introspection.body.mak
View File

@ -65,7 +65,7 @@ Gtk-3.0.gir: Gtk_3_0_gir_list
--include=Atk-1.0 \
--pkg-export=gtk+-3.0 \
--cflags-begin \
-DG_LOG_USE_STRUCTURED=1 -DGTK_VERSION="3.24.2" -DGTK_BINARY_VERSION="3.0.0" -DGTK_COMPILATION -DGTK_PRINT_BACKEND_ENABLE_UNSUPPORTED -DGTK_LIBDIR=\"/dummy/lib\" -DGTK_DATADIR=\"/dummy/share\" -DGTK_DATA_PREFIX=\"/dummy\" -DGTK_SYSCONFDIR=\"/dummy/etc\" -DGTK_HOST=\"$(AT_PLAT)-pc-vs$(VSVER)\" -DGTK_PRINT_BACKENDS=\"file\" -DINCLUDE_IM_am_et -DINCLUDE_IM_cedilla -DINCLUDE_IM_cyrillic_translit -DINCLUDE_IM_ime -DINCLUDE_IM_inuktitu -DINCLUDE_IM_ipa -DINCLUDE_IM_multipress -DINCLUDE_IM_thai -DINCLUDE_IM_ti_er -DINCLUDE_IM_ti_et -DINCLUDE_IM_viqr -DGTK_TEXT_USE_INTERNAL_UNSUPPORTED_API -I../.. -I../../gtk -I../../gdk \
-DG_LOG_USE_STRUCTURED=1 -DGTK_VERSION="3.24.3" -DGTK_BINARY_VERSION="3.0.0" -DGTK_COMPILATION -DGTK_PRINT_BACKEND_ENABLE_UNSUPPORTED -DGTK_LIBDIR=\"/dummy/lib\" -DGTK_DATADIR=\"/dummy/share\" -DGTK_DATA_PREFIX=\"/dummy\" -DGTK_SYSCONFDIR=\"/dummy/etc\" -DGTK_HOST=\"$(AT_PLAT)-pc-vs$(VSVER)\" -DGTK_PRINT_BACKENDS=\"file\" -DINCLUDE_IM_am_et -DINCLUDE_IM_cedilla -DINCLUDE_IM_cyrillic_translit -DINCLUDE_IM_ime -DINCLUDE_IM_inuktitu -DINCLUDE_IM_ipa -DINCLUDE_IM_multipress -DINCLUDE_IM_thai -DINCLUDE_IM_ti_er -DINCLUDE_IM_ti_et -DINCLUDE_IM_viqr -DGTK_TEXT_USE_INTERNAL_UNSUPPORTED_API -I../.. -I../../gtk -I../../gdk \
--cflags-end \
--warn-all --add-include-path=. --include-uninstalled=./Gdk-3.0.gir \
--filelist=Gtk_3_0_gir_list \

2
build/win32/vs10/gtk3-version-paths.props
View File

@ -5,7 +5,7 @@
<GlibEtcInstallRoot>$(SolutionDir)\..\..\..\..\vs$(VSVer)\$(Platform)</GlibEtcInstallRoot>
<CopyDir>..\..\..\..\vs$(VSVer)\$(Platform)</CopyDir>
<ApiVersion>3.0</ApiVersion>
<GtkVersion>3.24.2</GtkVersion>
<GtkVersion>3.24.3</GtkVersion>
<GtkLibtoolCompatibleDllPrefix>lib</GtkLibtoolCompatibleDllPrefix>
<GtkLibtoolCompatibleDllSuffix>.0-0</GtkLibtoolCompatibleDllSuffix>
<GtkSeparateVSDllPrefix />

2
build/win32/vs11/gtk3-version-paths.props
View File

@ -5,7 +5,7 @@
<GlibEtcInstallRoot>$(SolutionDir)\..\..\..\..\vs$(VSVer)\$(Platform)</GlibEtcInstallRoot>
<CopyDir>..\..\..\..\vs$(VSVer)\$(Platform)</CopyDir>
<ApiVersion>3.0</ApiVersion>
<GtkVersion>3.24.2</GtkVersion>
<GtkVersion>3.24.3</GtkVersion>
<GtkLibtoolCompatibleDllPrefix>lib</GtkLibtoolCompatibleDllPrefix>
<GtkLibtoolCompatibleDllSuffix>.0-0</GtkLibtoolCompatibleDllSuffix>
<GtkSeparateVSDllPrefix />

2
build/win32/vs12/gtk3-version-paths.props
View File

@ -5,7 +5,7 @@
<GlibEtcInstallRoot>$(SolutionDir)\..\..\..\..\vs$(VSVer)\$(Platform)</GlibEtcInstallRoot>
<CopyDir>..\..\..\..\vs$(VSVer)\$(Platform)</CopyDir>
<ApiVersion>3.0</ApiVersion>
<GtkVersion>3.24.2</GtkVersion>
<GtkVersion>3.24.3</GtkVersion>
<GtkLibtoolCompatibleDllPrefix>lib</GtkLibtoolCompatibleDllPrefix>
<GtkLibtoolCompatibleDllSuffix>.0-0</GtkLibtoolCompatibleDllSuffix>
<GtkSeparateVSDllPrefix />

2
build/win32/vs14/gtk3-version-paths.props
View File

@ -5,7 +5,7 @@
<GlibEtcInstallRoot>$(SolutionDir)\..\..\..\..\vs$(VSVer)\$(Platform)</GlibEtcInstallRoot>
<CopyDir>..\..\..\..\vs$(VSVer)\$(Platform)</CopyDir>
<ApiVersion>3.0</ApiVersion>
<GtkVersion>3.24.2</GtkVersion>
<GtkVersion>3.24.3</GtkVersion>
<GtkLibtoolCompatibleDllPrefix>lib</GtkLibtoolCompatibleDllPrefix>
<GtkLibtoolCompatibleDllSuffix>.0-0</GtkLibtoolCompatibleDllSuffix>
<GtkSeparateVSDllPrefix />

2
build/win32/vs15/gtk3-version-paths.props
View File

@ -5,7 +5,7 @@
<GlibEtcInstallRoot>$(SolutionDir)\..\..\..\..\vs$(VSVer)\$(Platform)</GlibEtcInstallRoot>
<CopyDir>..\..\..\..\vs$(VSVer)\$(Platform)</CopyDir>
<ApiVersion>3.0</ApiVersion>
<GtkVersion>3.24.2</GtkVersion>
<GtkVersion>3.24.3</GtkVersion>
<GtkLibtoolCompatibleDllPrefix>lib</GtkLibtoolCompatibleDllPrefix>
<GtkLibtoolCompatibleDllSuffix>.0-0</GtkLibtoolCompatibleDllSuffix>
<GtkSeparateVSDllPrefix />

2
build/win32/vs9/gtk3-version-paths.vsprops
View File

@ -22,7 +22,7 @@
/>
<UserMacro
Name="GtkVersion"
Value="3.24.2"
Value="3.24.3"
/>
<UserMacro
Name="GtkLibtoolCompatibleDllPrefix"

4
config.h.win32
View File

@ -287,7 +287,7 @@
#define PACKAGE_NAME "gtk+"
/* Define to the full name and version of this package. */
#define PACKAGE_STRING "gtk+ 3.24.2"
#define PACKAGE_STRING "gtk+ 3.24.3"
/* Define to the one symbol short name of this package. */
#define PACKAGE_TARNAME "gtk+"
@ -296,7 +296,7 @@
#define PACKAGE_URL ""
/* Define to the version of this package. */
#define PACKAGE_VERSION "3.24.2"
#define PACKAGE_VERSION "3.24.3"
/* Use NSBundle functions to determine load paths for libraries, translations,
etc. */

30
configure vendored
View File

@ -1,6 +1,6 @@
#! /bin/sh
# Guess values for system-dependent variables and create Makefiles.
# Generated by GNU Autoconf 2.69 for gtk+ 3.24.2.
# Generated by GNU Autoconf 2.69 for gtk+ 3.24.3.
#
# Report bugs to <http://bugzilla.gnome.org/enter_bug.cgi?product=gtk%2B>.
#
@ -591,8 +591,8 @@ MAKEFLAGS=
# Identity of this package.
PACKAGE_NAME='gtk+'
PACKAGE_TARNAME='gtk+'
PACKAGE_VERSION='3.24.2'
PACKAGE_STRING='gtk+ 3.24.2'
PACKAGE_VERSION='3.24.3'
PACKAGE_STRING='gtk+ 3.24.3'
PACKAGE_BUGREPORT='http://bugzilla.gnome.org/enter_bug.cgi?product=gtk%2B'
PACKAGE_URL=''
@ -1672,7 +1672,7 @@ if test "$ac_init_help" = "long"; then
# Omit some internal or obsolete options to make the list less imposing.
# This message is too long to be a string in the A/UX 3.1 sh.
cat <<_ACEOF
\`configure' configures gtk+ 3.24.2 to adapt to many kinds of systems.
\`configure' configures gtk+ 3.24.3 to adapt to many kinds of systems.
Usage: $0 [OPTION]... [VAR=VALUE]...
@ -1746,7 +1746,7 @@ fi
if test -n "$ac_init_help"; then
case $ac_init_help in
short | recursive ) echo "Configuration of gtk+ 3.24.2:";;
short | recursive ) echo "Configuration of gtk+ 3.24.3:";;
esac
cat <<\_ACEOF
@ -1990,7 +1990,7 @@ fi
test -n "$ac_init_help" && exit $ac_status
if $ac_init_version; then
cat <<\_ACEOF
gtk+ configure 3.24.2
gtk+ configure 3.24.3
generated by GNU Autoconf 2.69
Copyright (C) 2012 Free Software Foundation, Inc.
@ -2820,7 +2820,7 @@ cat >config.log <<_ACEOF
This file contains any messages produced by compilers while
running configure, to aid debugging if configure makes a mistake.
It was created by gtk+ $as_me 3.24.2, which was
It was created by gtk+ $as_me 3.24.3, which was
generated by GNU Autoconf 2.69. Invocation command line was
$ $0 $@
@ -3813,7 +3813,7 @@ fi
# Define the identity of the package.
PACKAGE='gtk+'
VERSION='3.24.2'
VERSION='3.24.3'
# Some tools Automake needs.
@ -4093,10 +4093,10 @@ AM_BACKSLASH='\'
GTK_MAJOR_VERSION=3
GTK_MINOR_VERSION=24
GTK_MICRO_VERSION=2
GTK_MICRO_VERSION=3
GTK_INTERFACE_AGE=0
GTK_BINARY_AGE=2402
GTK_VERSION=3.24.2
GTK_BINARY_AGE=2403
GTK_VERSION=3.24.3
GTK_API_VERSION=3.0
GTK_BINARY_VERSION=3.0.0
@ -4118,7 +4118,7 @@ GTK_BINARY_VERSION=3.0.0
LT_VERSION_INFO="2402:0:2402"
LT_VERSION_INFO="2403:0:2403"
LT_CURRENT_MINUS_AGE=0
@ -21049,7 +21049,7 @@ Usage: $0 [OPTIONS]
Report bugs to <bug-libtool@gnu.org>."
lt_cl_version="\
gtk+ config.lt 3.24.2
gtk+ config.lt 3.24.3
configured by $0, generated by GNU Autoconf 2.69.
Copyright (C) 2011 Free Software Foundation, Inc.
@ -30404,7 +30404,7 @@ cat >>$CONFIG_STATUS <<\_ACEOF || ac_write_fail=1
# report actual input values of CONFIG_FILES etc. instead of their
# values after options handling.
ac_log="
This file was extended by gtk+ $as_me 3.24.2, which was
This file was extended by gtk+ $as_me 3.24.3, which was
generated by GNU Autoconf 2.69. Invocation command line was
CONFIG_FILES = $CONFIG_FILES
@ -30470,7 +30470,7 @@ _ACEOF
cat >>$CONFIG_STATUS <<_ACEOF || ac_write_fail=1
ac_cs_config="`$as_echo "$ac_configure_args" | sed 's/^ //; s/[\\""\`\$]/\\\\&/g'`"
ac_cs_version="\\
gtk+ config.status 3.24.2
gtk+ config.status 3.24.3
configured by $0, generated by GNU Autoconf 2.69,
with options \\"\$ac_cs_config\\"

2
configure.ac
View File

@ -10,7 +10,7 @@
m4_define([gtk_major_version], [3])
m4_define([gtk_minor_version], [24])
m4_define([gtk_micro_version], [2])
m4_define([gtk_micro_version], [3])
m4_define([gtk_interface_age], [0])
m4_define([gtk_binary_age],
[m4_eval(100 * gtk_minor_version + gtk_micro_version)])

4
demos/gtk-demo/combobox.c
View File

@ -144,7 +144,7 @@ create_capital_store (void)
{ NULL, "Jackson" },
{ NULL, "Jefferson City" },
{ NULL, "Juneau" },
{ "K - O" },
{ "K - O", NULL },
{ NULL, "Lansing" },
{ NULL, "Lincoln" },
{ NULL, "Little Rock" },
@ -154,7 +154,7 @@ create_capital_store (void)
{ NULL, "Nashville" },
{ NULL, "Oklahoma City" },
{ NULL, "Olympia" },
{ NULL, "P - S" },
{ "P - S", NULL },
{ NULL, "Phoenix" },
{ NULL, "Pierre" },
{ NULL, "Providence" },

264287
demos/gtk-demo/demo_resources.c
View File

File diff suppressed because it is too large Load Diff

2524
demos/icon-browser/resources.c
View File

File diff suppressed because it is too large Load Diff

7139
demos/widget-factory/widget_factory_resources.c
View File

File diff suppressed because it is too large Load Diff

16
docs/reference/gdk/html/gdk3-RGBA-Colors.html
View File

@ -193,7 +193,7 @@ have full opacity)</p></li>
<li class="listitem"><p>A RGBA color in the form “rgba(r,g,b,a)”</p></li>
</ul></div>
<p>Where “r”, “g”, “b” and “a” are respectively the red, green, blue and
alpha color values. In the last two cases, r g and b are either integers
alpha color values. In the last two cases, “r”, “g”, and “b” are either integers
in the range 0 to 255 or percentage values in the range 0% to 100%, and
a is a floating point value in the range 0 to 1.</p>
<div class="refsect3">
@ -295,16 +295,16 @@ table that stores <a href="gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">Gdk
gdk_rgba_to_string (<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>
<p>Returns a textual specification of <em class="parameter"><code>rgba</code></em>
in the form
<code class="literal">rgb (r, g, b)</code> or
<code class="literal">rgba (r, g, b, a)</code>,
<code class="literal">rgb(r,g,b)</code> or
<code class="literal">rgba(r g,b,a)</code>,
where “r”, “g”, “b” and “a” represent the red, green,
blue and alpha values respectively. r, g, and b are
represented as integers in the range 0 to 255, and a
is represented as floating point value in the range 0 to 1.</p>
<p>These string forms are string forms those supported by
blue and alpha values respectively. “r”, “g”, and “b” are
represented as integers in the range 0 to 255, and “a”
is represented as a floating point value in the range 0 to 1.</p>
<p>These string forms are string forms that are supported by
the CSS3 colors module, and can be parsed by <a class="link" href="gdk3-RGBA-Colors.html#gdk-rgba-parse" title="gdk_rgba_parse ()"><code class="function">gdk_rgba_parse()</code></a>.</p>
<p>Note that this string representation may lose some
precision, since r, g and b are represented as 8-bit
precision, since “r”, “g” and “b” are represented as 8-bit
integers. If this is a concern, you should use a
different representation.</p>
<div class="refsect3">

2
docs/reference/gdk/html/index.html
View File

@ -15,7 +15,7 @@
<div>
<div><table class="navigation" id="top" width="100%" cellpadding="2" cellspacing="0"><tr><th valign="middle"><p class="title">GDK 3 Reference Manual</p></th></tr></table></div>
<div><p class="releaseinfo">
This document is for the GDK 3 library, version 3.24.2
This document is for the GDK 3 library, version 3.24.3
The latest versions can be found online at
<a class="ulink" href="https://developer.gnome.org/gdk3/" target="_top">https://developer.gnome.org/gdk3/</a>.

2
docs/reference/gdk/version.xml
View File

@ -1 +1 @@
3.24.2
3.24.3

2
docs/reference/gtk/broadwayd.1
View File

@ -2,7 +2,7 @@
.\" Title: broadwayd
.\" Author: Alexander Larsson
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\" Date: 12/12/2018
.\" Date: 01/13/2019
.\" Manual: User Commands
.\" Source: GTK+
.\" Language: English

2
docs/reference/gtk/gtk-builder-tool.1
View File

@ -2,7 +2,7 @@
.\" Title: gtk-builder-tool
.\" Author: Matthias Clasen
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\" Date: 12/12/2018
.\" Date: 01/13/2019
.\" Manual: User Commands
.\" Source: GTK+
.\" Language: English

2
docs/reference/gtk/gtk-encode-symbolic-svg.1
View File

@ -2,7 +2,7 @@
.\" Title: gtk-encode-symbolic-svg
.\" Author: Alexander Larsson
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\" Date: 12/12/2018
.\" Date: 01/13/2019
.\" Manual: User Commands
.\" Source: GTK+
.\" Language: English

2
docs/reference/gtk/gtk-launch.1
View File

@ -2,7 +2,7 @@
.\" Title: gtk-launch
.\" Author: Tomáš Bžatek <tbzatek@redhat.com>
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\" Date: 12/12/2018
.\" Date: 01/13/2019
.\" Manual: User Commands
.\" Source: GTK+
.\" Language: English

2
docs/reference/gtk/gtk-query-immodules-3.0.1
View File

@ -2,7 +2,7 @@
.\" Title: gtk-query-immodules-3.0
.\" Author: Matthias Clasen
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\" Date: 12/12/2018
.\" Date: 01/13/2019
.\" Manual: User Commands
.\" Source: GTK+
.\" Language: English

2
docs/reference/gtk/gtk-query-settings.1
View File

@ -2,7 +2,7 @@
.\" Title: gtk-query-settings
.\" Author: Timm Bäder
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\" Date: 12/12/2018
.\" Date: 01/13/2019
.\" Manual: User Commands
.\" Source: GTK+
.\" Language: English

2
docs/reference/gtk/gtk-update-icon-cache.1
View File

@ -2,7 +2,7 @@
.\" Title: gtk-update-icon-cache
.\" Author: Matthias Clasen
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\" Date: 12/12/2018
.\" Date: 01/13/2019
.\" Manual: User Commands
.\" Source: GTK+
.\" Language: English

2
docs/reference/gtk/gtk3-demo-application.1
View File

@ -2,7 +2,7 @@
.\" Title: gtk3-demo-application
.\" Author: Matthias Clasen
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\" Date: 12/12/2018
.\" Date: 01/13/2019
.\" Manual: User Commands
.\" Source: GTK+
.\" Language: English

2
docs/reference/gtk/gtk3-demo.1
View File

@ -2,7 +2,7 @@
.\" Title: gtk3-demo
.\" Author: Matthias Clasen
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\" Date: 12/12/2018
.\" Date: 01/13/2019
.\" Manual: User Commands
.\" Source: GTK+
.\" Language: English

2
docs/reference/gtk/gtk3-icon-browser.1
View File

@ -2,7 +2,7 @@
.\" Title: gtk3-icon-browser
.\" Author: Matthias Clasen
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\" Date: 12/12/2018
.\" Date: 01/13/2019
.\" Manual: User Commands
.\" Source: GTK+
.\" Language: English

2
docs/reference/gtk/gtk3-widget-factory.1
View File

@ -2,7 +2,7 @@
.\" Title: gtk3-widget-factory
.\" Author: Matthias Clasen
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\" Date: 12/12/2018
.\" Date: 01/13/2019
.\" Manual: User Commands
.\" Source: GTK+
.\" Language: English

2
docs/reference/gtk/html/Gestures.html
View File

@ -27,7 +27,7 @@
<span class="refentrytitle"><a href="GtkEventController.html">GtkEventController</a></span><span class="refpurpose"> — Self-contained handler of series of events</span>
</dt>
<dt>
<span class="refentrytitle"><a href="GtkEventControllerKey.html">GtkEventControllerKey</a></span><span class="refpurpose"></span>
<span class="refentrytitle"><a href="GtkEventControllerKey.html">GtkEventControllerKey</a></span><span class="refpurpose"> — Event controller for key events</span>
</dt>
<dt>
<span class="refentrytitle"><a href="GtkEventControllerScroll.html">GtkEventControllerScroll</a></span><span class="refpurpose"> — Event controller for scroll events</span>

6
docs/reference/gtk/html/GtkAccelLabel.html
View File

@ -236,7 +236,7 @@ though it is almost always used to display just one accelerator key.</p>
<span class="comment">// GtkMenuItem accelerators. We just need to make sure we use</span>
<span class="comment">// GTK_ACCEL_VISIBLE here.</span>
<span class="function"><a href="GtkWidget.html#gtk-widget-add-accelerator">gtk_widget_add_accelerator</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">save_item</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"activate"</span><span class="symbol">,</span><span class="normal"> accel_group</span><span class="symbol">,</span>
<span class="normal"> GDK_KEY_s</span><span class="symbol">,</span><span class="normal"> GDK_CONTROL_MASK</span><span class="symbol">,</span><span class="normal"> <a href="gtk3-Keyboard-Accelerators.html#GTK-ACCEL-VISIBLE:CAPS">GTK_ACCEL_VISIBLE</a></span><span class="symbol">);</span></pre></td>
<span class="normal"> GDK_KEY_s</span><span class="symbol">,</span><span class="normal"> <a href="../html/gdk3-Windows.html#GDK-CONTROL-MASK:CAPS">GDK_CONTROL_MASK</a></span><span class="symbol">,</span><span class="normal"> <a href="gtk3-Keyboard-Accelerators.html#GTK-ACCEL-VISIBLE:CAPS">GTK_ACCEL_VISIBLE</a></span><span class="symbol">);</span></pre></td>
</tr>
</tbody>
</table>
@ -422,7 +422,7 @@ be needed by applications.</p>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_accel_label_set_accel (<em class="parameter"><code><a class="link" href="GtkAccelLabel.html" title="GtkAccelLabel"><span class="type">GtkAccelLabel</span></a> *accel_label</code></em>,
<em class="parameter"><code><span class="type">guint</span> accelerator_key</code></em>,
<em class="parameter"><code><span class="type">GdkModifierType</span> accelerator_mods</code></em>);</pre>
<em class="parameter"><code><a href="../html/gdk3-Windows.html#GdkModifierType"><span class="type">GdkModifierType</span></a> accelerator_mods</code></em>);</pre>
<p>Manually sets a keyval and modifier mask as the accelerator rendered
by <em class="parameter"><code>accel_label</code></em>
.</p>
@ -465,7 +465,7 @@ used regardless of any associated accel closure or widget.</p>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_accel_label_get_accel (<em class="parameter"><code><a class="link" href="GtkAccelLabel.html" title="GtkAccelLabel"><span class="type">GtkAccelLabel</span></a> *accel_label</code></em>,
<em class="parameter"><code><span class="type">guint</span> *accelerator_key</code></em>,
<em class="parameter"><code><span class="type">GdkModifierType</span> *accelerator_mods</code></em>);</pre>
<em class="parameter"><code><a href="../html/gdk3-Windows.html#GdkModifierType"><span class="type">GdkModifierType</span></a> *accelerator_mods</code></em>);</pre>
<p>Gets the keyval and modifier mask set with
<a class="link" href="GtkAccelLabel.html#gtk-accel-label-set-accel" title="gtk_accel_label_set_accel ()"><code class="function">gtk_accel_label_set_accel()</code></a>.</p>
<div class="refsect3">

4
docs/reference/gtk/html/GtkBuilder.html
View File

@ -403,7 +403,7 @@ as <code class="literal">TRUE</code>, strings like “FALSE”, “f”, “no
as <code class="literal">FALSE</code>), enumerations (can be specified by their name, nick or
integer value), flags (can be specified by their name, nick, integer
value, optionally combined with “|”, e.g. “GTK_VISIBLE|GTK_REALIZED”)
and colors (in a format understood by <code class="function">gdk_rgba_parse()</code>).</p>
and colors (in a format understood by <a href="../html/gdk3-RGBA-Colors.html#gdk-rgba-parse"><code class="function">gdk_rgba_parse()</code></a>).</p>
<p>GVariants can be specified in the format understood by <code class="function">g_variant_parse()</code>,
and pixbufs can be specified as a filename of an image file to load.</p>
<p>Objects can be referred to by their name and by default refer to
@ -1634,7 +1634,7 @@ calls <code class="function">g_value_init()</code> on the <em class="parameter">
argument, so it need not be
initialised beforehand.</p>
<p>This function can handle char, uchar, boolean, int, uint, long,
ulong, enum, flags, float, double, string, <span class="type">GdkColor</span>, <span class="type">GdkRGBA</span> and
ulong, enum, flags, float, double, string, <a href="../html/gdk3-Colors.html#GdkColor"><span class="type">GdkColor</span></a>, <a href="../html/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a> and
<a class="link" href="GtkAdjustment.html" title="GtkAdjustment"><span class="type">GtkAdjustment</span></a> type values. Support for <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> type values is
still to come.</p>
<p>Upon errors <code class="literal">FALSE</code> will be returned and <em class="parameter"><code>error</code></em>

4
docs/reference/gtk/html/GtkButton.html
View File

@ -269,7 +269,7 @@
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">GdkWindow</span> *
<a href="../html/gdk3-Windows.html#GdkWindow-struct"><span class="returnvalue">GdkWindow</span></a> *
</td>
<td class="function_name">
<a class="link" href="GtkButton.html#gtk-button-get-event-window" title="gtk_button_get_event_window ()">gtk_button_get_event_window</a> <span class="c_punctuation">()</span>
@ -1370,7 +1370,7 @@ setting and always show the image, if available.</p>
<hr>
<div class="refsect2">
<a name="gtk-button-get-event-window"></a><h3>gtk_button_get_event_window ()</h3>
<pre class="programlisting"><span class="returnvalue">GdkWindow</span> *
<pre class="programlisting"><a href="../html/gdk3-Windows.html#GdkWindow-struct"><span class="returnvalue">GdkWindow</span></a> *
gtk_button_get_event_window (<em class="parameter"><code><a class="link" href="GtkButton.html" title="GtkButton"><span class="type">GtkButton</span></a> *button</code></em>);</pre>
<p>Returns the button’s event window if it is realized, <code class="literal">NULL</code> otherwise.
This function should be rarely needed.</p>

44
docs/reference/gtk/html/GtkCellArea.html
View File

@ -1038,8 +1038,8 @@ the cell renderers of a <a class="link" href="GtkCellArea.html" title="GtkCellAr
<a name="GtkCellAllocCallback"></a><h3>GtkCellAllocCallback ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
<span class="c_punctuation">(</span>*GtkCellAllocCallback<span class="c_punctuation">)</span> (<em class="parameter"><code><a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> *renderer</code></em>,
<em class="parameter"><code>const <span class="type">GdkRectangle</span> *cell_area</code></em>,
<em class="parameter"><code>const <span class="type">GdkRectangle</span> *cell_background</code></em>,
<em class="parameter"><code>const <a href="../html/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *cell_area</code></em>,
<em class="parameter"><code>const <a href="../html/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *cell_background</code></em>,
<em class="parameter"><code><span class="type">gpointer</span> data</code></em>);</pre>
<p>The type of the callback functions used for iterating over the
cell renderers and their allocated areas inside a <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a>,
@ -1273,8 +1273,8 @@ gtk_cell_area_foreach (<em class="parameter"><code><a class="link" href="GtkCell
gtk_cell_area_foreach_alloc (<em class="parameter"><code><a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> *area</code></em>,
<em class="parameter"><code><a class="link" href="GtkCellAreaContext.html" title="GtkCellAreaContext"><span class="type">GtkCellAreaContext</span></a> *context</code></em>,
<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>,
<em class="parameter"><code>const <span class="type">GdkRectangle</span> *cell_area</code></em>,
<em class="parameter"><code>const <span class="type">GdkRectangle</span> *background_area</code></em>,
<em class="parameter"><code>const <a href="../html/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *cell_area</code></em>,
<em class="parameter"><code>const <a href="../html/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *background_area</code></em>,
<em class="parameter"><code><a class="link" href="GtkCellArea.html#GtkCellAllocCallback" title="GtkCellAllocCallback ()"><span class="type">GtkCellAllocCallback</span></a> callback</code></em>,
<em class="parameter"><code><span class="type">gpointer</span> callback_data</code></em>);</pre>
<p>Calls <em class="parameter"><code>callback</code></em>
@ -1342,8 +1342,8 @@ relative coordinates of the background area</p></td>
gtk_cell_area_event (<em class="parameter"><code><a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> *area</code></em>,
<em class="parameter"><code><a class="link" href="GtkCellAreaContext.html" title="GtkCellAreaContext"><span class="type">GtkCellAreaContext</span></a> *context</code></em>,
<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>,
<em class="parameter"><code><span class="type">GdkEvent</span> *event</code></em>,
<em class="parameter"><code>const <span class="type">GdkRectangle</span> *cell_area</code></em>,
<em class="parameter"><code><a href="../html/gdk3-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a> *event</code></em>,
<em class="parameter"><code>const <a href="../html/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *cell_area</code></em>,
<em class="parameter"><code><a class="link" href="GtkCellRenderer.html#GtkCellRendererState" title="enum GtkCellRendererState"><span class="type">GtkCellRendererState</span></a> flags</code></em>);</pre>
<p>Delegates event handling to a <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a>.</p>
<div class="refsect3">
@ -1373,7 +1373,7 @@ is rendering to</p></td>
</tr>
<tr>
<td class="parameter_name"><p>event</p></td>
<td class="parameter_description"><p>the <span class="type">GdkEvent</span> to handle</p></td>
<td class="parameter_description"><p>the <a href="../html/gdk3-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a> to handle</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
@ -1407,8 +1407,8 @@ gtk_cell_area_render (<em class="parameter"><code><a class="link" href="GtkCellA
<em class="parameter"><code><a class="link" href="GtkCellAreaContext.html" title="GtkCellAreaContext"><span class="type">GtkCellAreaContext</span></a> *context</code></em>,
<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</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>,
<em class="parameter"><code>const <span class="type">GdkRectangle</span> *background_area</code></em>,
<em class="parameter"><code>const <span class="type">GdkRectangle</span> *cell_area</code></em>,
<em class="parameter"><code>const <a href="../html/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *background_area</code></em>,
<em class="parameter"><code>const <a href="../html/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *cell_area</code></em>,
<em class="parameter"><code><a class="link" href="GtkCellRenderer.html#GtkCellRendererState" title="enum GtkCellRendererState"><span class="type">GtkCellRendererState</span></a> flags</code></em>,
<em class="parameter"><code><span class="type">gboolean</span> paint_focus</code></em>);</pre>
<p>Renders <em class="parameter"><code>area</code></em>
@ -1485,8 +1485,8 @@ gtk_cell_area_get_cell_allocation (<em class="parameter"><code><a class="link" h
<em class="parameter"><code><a class="link" href="GtkCellAreaContext.html" title="GtkCellAreaContext"><span class="type">GtkCellAreaContext</span></a> *context</code></em>,
<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>,
<em class="parameter"><code><a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> *renderer</code></em>,
<em class="parameter"><code>const <span class="type">GdkRectangle</span> *cell_area</code></em>,
<em class="parameter"><code><span class="type">GdkRectangle</span> *allocation</code></em>);</pre>
<em class="parameter"><code>const <a href="../html/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *cell_area</code></em>,
<em class="parameter"><code><a href="../html/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *allocation</code></em>);</pre>
<p>Derives the allocation of <em class="parameter"><code>renderer</code></em>
inside <em class="parameter"><code>area</code></em>
if <em class="parameter"><code>area</code></em>
@ -1549,10 +1549,10 @@ for this row</p></td>
gtk_cell_area_get_cell_at_position (<em class="parameter"><code><a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> *area</code></em>,
<em class="parameter"><code><a class="link" href="GtkCellAreaContext.html" title="GtkCellAreaContext"><span class="type">GtkCellAreaContext</span></a> *context</code></em>,
<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>,
<em class="parameter"><code>const <span class="type">GdkRectangle</span> *cell_area</code></em>,
<em class="parameter"><code>const <a href="../html/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *cell_area</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">GdkRectangle</span> *alloc_area</code></em>);</pre>
<em class="parameter"><code><a href="../html/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *alloc_area</code></em>);</pre>
<p>Gets the <a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> at <em class="parameter"><code>x</code></em>
and <em class="parameter"><code>y</code></em>
coordinates inside <em class="parameter"><code>area</code></em>
@ -2696,7 +2696,7 @@ can do anything when activated.</p>
gtk_cell_area_activate (<em class="parameter"><code><a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> *area</code></em>,
<em class="parameter"><code><a class="link" href="GtkCellAreaContext.html" title="GtkCellAreaContext"><span class="type">GtkCellAreaContext</span></a> *context</code></em>,
<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>,
<em class="parameter"><code>const <span class="type">GdkRectangle</span> *cell_area</code></em>,
<em class="parameter"><code>const <a href="../html/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *cell_area</code></em>,
<em class="parameter"><code><a class="link" href="GtkCellRenderer.html#GtkCellRendererState" title="enum GtkCellRendererState"><span class="type">GtkCellRendererState</span></a> flags</code></em>,
<em class="parameter"><code><span class="type">gboolean</span> edit_only</code></em>);</pre>
<p>Activates <em class="parameter"><code>area</code></em>
@ -3150,8 +3150,8 @@ to edit the currently edited cell.</p>
gtk_cell_area_activate_cell (<em class="parameter"><code><a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> *area</code></em>,
<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>,
<em class="parameter"><code><a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> *renderer</code></em>,
<em class="parameter"><code><span class="type">GdkEvent</span> *event</code></em>,
<em class="parameter"><code>const <span class="type">GdkRectangle</span> *cell_area</code></em>,
<em class="parameter"><code><a href="../html/gdk3-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a> *event</code></em>,
<em class="parameter"><code>const <a href="../html/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *cell_area</code></em>,
<em class="parameter"><code><a class="link" href="GtkCellRenderer.html#GtkCellRendererState" title="enum GtkCellRendererState"><span class="type">GtkCellRendererState</span></a> flags</code></em>);</pre>
<p>This is used by <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> subclasses when handling events
to activate cells, the base <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> class activates cells
@ -3185,12 +3185,12 @@ to activate</p></td>
</tr>
<tr>
<td class="parameter_name"><p>event</p></td>
<td class="parameter_description"><p>the <span class="type">GdkEvent</span> for which cell activation should occur</p></td>
<td class="parameter_description"><p>the <a href="../html/gdk3-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a> for which cell activation should occur</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>cell_area</p></td>
<td class="parameter_description"><p>the <span class="type">GdkRectangle</span> in <em class="parameter"><code>widget</code></em>
<td class="parameter_description"><p>the <a href="../html/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> in <em class="parameter"><code>widget</code></em>
relative coordinates
of <em class="parameter"><code>renderer</code></em>
for the current row.</p></td>
@ -3254,8 +3254,8 @@ edit widget.</p>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_cell_area_inner_cell_area (<em class="parameter"><code><a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> *area</code></em>,
<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>,
<em class="parameter"><code>const <span class="type">GdkRectangle</span> *cell_area</code></em>,
<em class="parameter"><code><span class="type">GdkRectangle</span> *inner_area</code></em>);</pre>
<em class="parameter"><code>const <a href="../html/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *cell_area</code></em>,
<em class="parameter"><code><a href="../html/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *inner_area</code></em>);</pre>
<p>This is a convenience function for <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> implementations
to get the inner area where a given <a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> will be
rendered. It removes any padding previously added by <a class="link" href="GtkCellArea.html#gtk-cell-area-request-renderer" title="gtk_cell_area_request_renderer ()"><code class="function">gtk_cell_area_request_renderer()</code></a>.</p>
@ -3662,7 +3662,7 @@ a result of a call <a class="link" href="GtkCellArea.html#gtk-cell-area-activate
user_function (<a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> *area,
<a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> *renderer,
<a class="link" href="GtkCellEditable.html" title="GtkCellEditable"><span class="type">GtkCellEditable</span></a> *editable,
<span class="type">GdkRectangle</span> *cell_area,
<a href="../html/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *cell_area,
<span class="type">gchar</span> *path,
<span class="type">gpointer</span> user_data)</pre>
<p>Indicates that editing has started on <em class="parameter"><code>renderer</code></em>
@ -3696,7 +3696,7 @@ should be added to the owning cell-layouting widget at <em class="parameter"><co
</tr>
<tr>
<td class="parameter_name"><p>cell_area</p></td>
<td class="parameter_description"><p>the <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> relative <span class="type">GdkRectangle</span> coordinates
<td class="parameter_description"><p>the <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> relative <a href="../html/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> coordinates
where <em class="parameter"><code>editable</code></em>
should be added</p></td>
<td class="parameter_annotations"> </td>

4
docs/reference/gtk/html/GtkCellEditable.html
View File

@ -162,7 +162,7 @@ temporary widgets should be configured for editing, get the new value, etc.</p>
<a name="gtk-cell-editable-start-editing"></a><h3>gtk_cell_editable_start_editing ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_cell_editable_start_editing (<em class="parameter"><code><a class="link" href="GtkCellEditable.html" title="GtkCellEditable"><span class="type">GtkCellEditable</span></a> *cell_editable</code></em>,
<em class="parameter"><code><span class="type">GdkEvent</span> *event</code></em>);</pre>
<em class="parameter"><code><a href="../html/gdk3-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a> *event</code></em>);</pre>
<p>Begins editing on a <em class="parameter"><code>cell_editable</code></em>
.</p>
<p>The <a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> for the cell creates and returns a <a class="link" href="GtkCellEditable.html" title="GtkCellEditable"><span class="type">GtkCellEditable</span></a> from
@ -189,7 +189,7 @@ lifetime is temporary and does not persist across other edits and/or cells.</p>
</tr>
<tr>
<td class="parameter_name"><p>event</p></td>
<td class="parameter_description"><p>The <span class="type">GdkEvent</span> that began the editing process, or
<td class="parameter_description"><p>The <a href="../html/gdk3-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a> that began the editing process, or
<code class="literal">NULL</code> if editing was initiated programmatically. </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>

38
docs/reference/gtk/html/GtkCellRenderer.html
View File

@ -262,13 +262,13 @@
</tr>
<tr>
<td class="property_type">
<span class="type">GdkColor</span> *</td>
<a href="../html/gdk3-Colors.html#GdkColor"><span class="type">GdkColor</span></a> *</td>
<td class="property_name"><a class="link" href="GtkCellRenderer.html#GtkCellRenderer--cell-background-gdk" title="The “cell-background-gdk” property">cell-background-gdk</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type">
<span class="type">GdkRGBA</span> *</td>
<a href="../html/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a> *</td>
<td class="property_name"><a class="link" href="GtkCellRenderer.html#GtkCellRenderer--cell-background-rgba" title="The “cell-background-rgba” property">cell-background-rgba</a></td>
<td class="property_flags">Read / Write</td>
</tr>
@ -486,8 +486,8 @@ The type must be a subtype of <span class="type">GtkRendererCellAccessible</span
gtk_cell_renderer_get_aligned_area (<em class="parameter"><code><a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> *cell</code></em>,
<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>,
<em class="parameter"><code><a class="link" href="GtkCellRenderer.html#GtkCellRendererState" title="enum GtkCellRendererState"><span class="type">GtkCellRendererState</span></a> flags</code></em>,
<em class="parameter"><code>const <span class="type">GdkRectangle</span> *cell_area</code></em>,
<em class="parameter"><code><span class="type">GdkRectangle</span> *aligned_area</code></em>);</pre>
<em class="parameter"><code>const <a href="../html/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *cell_area</code></em>,
<em class="parameter"><code><a href="../html/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *aligned_area</code></em>);</pre>
<p>Gets the aligned area used by <em class="parameter"><code>cell</code></em>
inside <em class="parameter"><code>cell_area</code></em>
. Used for finding
@ -538,7 +538,7 @@ that would acually be used to render. </p></td>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_cell_renderer_get_size (<em class="parameter"><code><a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> *cell</code></em>,
<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>,
<em class="parameter"><code>const <span class="type">GdkRectangle</span> *cell_area</code></em>,
<em class="parameter"><code>const <a href="../html/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *cell_area</code></em>,
<em class="parameter"><code><span class="type">gint</span> *x_offset</code></em>,
<em class="parameter"><code><span class="type">gint</span> *y_offset</code></em>,
<em class="parameter"><code><span class="type">gint</span> *width</code></em>,
@ -615,8 +615,8 @@ in <em class="parameter"><code>x_offset</code></em>
gtk_cell_renderer_render (<em class="parameter"><code><a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> *cell</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>,
<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>,
<em class="parameter"><code>const <span class="type">GdkRectangle</span> *background_area</code></em>,
<em class="parameter"><code>const <span class="type">GdkRectangle</span> *cell_area</code></em>,
<em class="parameter"><code>const <a href="../html/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *background_area</code></em>,
<em class="parameter"><code>const <a href="../html/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *cell_area</code></em>,
<em class="parameter"><code><a class="link" href="GtkCellRenderer.html#GtkCellRendererState" title="enum GtkCellRendererState"><span class="type">GtkCellRendererState</span></a> flags</code></em>);</pre>
<p>Invokes the virtual render function of the <a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a>. The three
passed-in rectangles are areas in <em class="parameter"><code>cr</code></em>
@ -681,11 +681,11 @@ padding on the sides)</p></td>
<a name="gtk-cell-renderer-activate"></a><h3>gtk_cell_renderer_activate ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gtk_cell_renderer_activate (<em class="parameter"><code><a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> *cell</code></em>,
<em class="parameter"><code><span class="type">GdkEvent</span> *event</code></em>,
<em class="parameter"><code><a href="../html/gdk3-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a> *event</code></em>,
<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>,
<em class="parameter"><code>const <span class="type">gchar</span> *path</code></em>,
<em class="parameter"><code>const <span class="type">GdkRectangle</span> *background_area</code></em>,
<em class="parameter"><code>const <span class="type">GdkRectangle</span> *cell_area</code></em>,
<em class="parameter"><code>const <a href="../html/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *background_area</code></em>,
<em class="parameter"><code>const <a href="../html/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *cell_area</code></em>,
<em class="parameter"><code><a class="link" href="GtkCellRenderer.html#GtkCellRendererState" title="enum GtkCellRendererState"><span class="type">GtkCellRendererState</span></a> flags</code></em>);</pre>
<p>Passes an activate event to the cell renderer for possible processing.
Some cell renderers may use events; for example, <a class="link" href="GtkCellRendererToggle.html" title="GtkCellRendererToggle"><span class="type">GtkCellRendererToggle</span></a>
@ -706,7 +706,7 @@ toggles when it gets a mouse click.</p>
</tr>
<tr>
<td class="parameter_name"><p>event</p></td>
<td class="parameter_description"><p>a <span class="type">GdkEvent</span></p></td>
<td class="parameter_description"><p>a <a href="../html/gdk3-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
@ -748,11 +748,11 @@ e.g. for <a class="link" href="GtkTreeView.html" title="GtkTreeView"><span class
<a name="gtk-cell-renderer-start-editing"></a><h3>gtk_cell_renderer_start_editing ()</h3>
<pre class="programlisting"><a class="link" href="GtkCellEditable.html" title="GtkCellEditable"><span class="returnvalue">GtkCellEditable</span></a> *
gtk_cell_renderer_start_editing (<em class="parameter"><code><a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> *cell</code></em>,
<em class="parameter"><code><span class="type">GdkEvent</span> *event</code></em>,
<em class="parameter"><code><a href="../html/gdk3-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a> *event</code></em>,
<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>,
<em class="parameter"><code>const <span class="type">gchar</span> *path</code></em>,
<em class="parameter"><code>const <span class="type">GdkRectangle</span> *background_area</code></em>,
<em class="parameter"><code>const <span class="type">GdkRectangle</span> *cell_area</code></em>,
<em class="parameter"><code>const <a href="../html/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *background_area</code></em>,
<em class="parameter"><code>const <a href="../html/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *cell_area</code></em>,
<em class="parameter"><code><a class="link" href="GtkCellRenderer.html#GtkCellRendererState" title="enum GtkCellRendererState"><span class="type">GtkCellRendererState</span></a> flags</code></em>);</pre>
<p>Starts editing the contents of this <em class="parameter"><code>cell</code></em>
, through a new <a class="link" href="GtkCellEditable.html" title="GtkCellEditable"><span class="type">GtkCellEditable</span></a>
@ -773,7 +773,7 @@ widget created by the <a class="link" href="GtkCellRenderer.html#GtkCellRenderer
</tr>
<tr>
<td class="parameter_name"><p>event</p></td>
<td class="parameter_description"><p>a <span class="type">GdkEvent</span>. </p></td>
<td class="parameter_description"><p>a <a href="../html/gdk3-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a>. </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>
@ -1801,8 +1801,8 @@ inside <em class="parameter"><code>cell_area</code></em>
<hr>
<div class="refsect2">
<a name="GtkCellRenderer--cell-background-gdk"></a><h3>The <code class="literal">“cell-background-gdk”</code> property</h3>
<pre class="programlisting"> “cell-background-gdk” <span class="type">GdkColor</span> *</pre>
<p>Cell background as a <span class="type">GdkColor</span></p>
<pre class="programlisting"> “cell-background-gdk” <a href="../html/gdk3-Colors.html#GdkColor"><span class="type">GdkColor</span></a> *</pre>
<p>Cell background as a <a href="../html/gdk3-Colors.html#GdkColor"><span class="type">GdkColor</span></a></p>
<div class="warning">
<p><code class="literal">GtkCellRenderer:cell-background-gdk</code> has been deprecated since version 3.4 and should not be used in newly-written code.</p>
<p>Use <a class="link" href="GtkCellRenderer.html#GtkCellRenderer--cell-background-rgba" title="The “cell-background-rgba” property"><span class="type">“cell-background-rgba”</span></a> instead.</p>
@ -1812,8 +1812,8 @@ inside <em class="parameter"><code>cell_area</code></em>
<hr>
<div class="refsect2">
<a name="GtkCellRenderer--cell-background-rgba"></a><h3>The <code class="literal">“cell-background-rgba”</code> property</h3>
<pre class="programlisting"> “cell-background-rgba” <span class="type">GdkRGBA</span> *</pre>
<p>Cell background as a <span class="type">GdkRGBA</span></p>
<pre class="programlisting"> “cell-background-rgba” <a href="../html/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a> *</pre>
<p>Cell background as a <a href="../html/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a></p>
<p>Flags: Read / Write</p>
<p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></p>
</div>

6
docs/reference/gtk/html/GtkCellRendererAccel.html
View File

@ -71,7 +71,7 @@
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type"><span class="type">GdkModifierType</span></td>
<td class="property_type"><a href="../html/gdk3-Windows.html#GdkModifierType"><span class="type">GdkModifierType</span></a></td>
<td class="property_name"><a class="link" href="GtkCellRendererAccel.html#GtkCellRendererAccel--accel-mods" title="The “accel-mods” property">accel-mods</a></td>
<td class="property_flags">Read / Write</td>
</tr>
@ -226,7 +226,7 @@ in the same way as they are in menus.</p>
<hr>
<div class="refsect2">
<a name="GtkCellRendererAccel--accel-mods"></a><h3>The <code class="literal">“accel-mods”</code> property</h3>
<pre class="programlisting"> “accel-mods” <span class="type">GdkModifierType</span></pre>
<pre class="programlisting"> “accel-mods” <a href="../html/gdk3-Windows.html#GdkModifierType"><span class="type">GdkModifierType</span></a></pre>
<p>The modifier mask of the accelerator.</p>
<p>Flags: Read / Write</p>
<p class="since">Since: 2.10</p>
@ -290,7 +290,7 @@ user_function (<a class="link" href="GtkCellRendererAccel.html" title="GtkCellRe
user_function (<a class="link" href="GtkCellRendererAccel.html" title="GtkCellRendererAccel"><span class="type">GtkCellRendererAccel</span></a> *accel,
<span class="type">gchar</span> *path_string,
<span class="type">guint</span> accel_key,
<span class="type">GdkModifierType</span> accel_mods,
<a href="../html/gdk3-Windows.html#GdkModifierType"><span class="type">GdkModifierType</span></a> accel_mods,
<span class="type">guint</span> hardware_keycode,
<span class="type">gpointer</span> user_data)</pre>
<p>Gets emitted when the user has selected a new accelerator.</p>

24
docs/reference/gtk/html/GtkCellRendererText.html
View File

@ -94,13 +94,13 @@
</tr>
<tr>
<td class="property_type">
<span class="type">GdkColor</span> *</td>
<a href="../html/gdk3-Colors.html#GdkColor"><span class="type">GdkColor</span></a> *</td>
<td class="property_name"><a class="link" href="GtkCellRendererText.html#GtkCellRendererText--background-gdk" title="The “background-gdk” property">background-gdk</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type">
<span class="type">GdkRGBA</span> *</td>
<a href="../html/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a> *</td>
<td class="property_name"><a class="link" href="GtkCellRendererText.html#GtkCellRendererText--background-rgba" title="The “background-rgba” property">background-rgba</a></td>
<td class="property_flags">Read / Write</td>
</tr>
@ -160,13 +160,13 @@
</tr>
<tr>
<td class="property_type">
<span class="type">GdkColor</span> *</td>
<a href="../html/gdk3-Colors.html#GdkColor"><span class="type">GdkColor</span></a> *</td>
<td class="property_name"><a class="link" href="GtkCellRendererText.html#GtkCellRendererText--foreground-gdk" title="The “foreground-gdk” property">foreground-gdk</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type">
<span class="type">GdkRGBA</span> *</td>
<a href="../html/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a> *</td>
<td class="property_name"><a class="link" href="GtkCellRendererText.html#GtkCellRendererText--foreground-rgba" title="The “foreground-rgba” property">foreground-rgba</a></td>
<td class="property_flags">Read / Write</td>
</tr>
@ -482,8 +482,8 @@ on the other hand, sets the horizontal alignment of the whole text.</p>
<hr>
<div class="refsect2">
<a name="GtkCellRendererText--background-gdk"></a><h3>The <code class="literal">“background-gdk”</code> property</h3>
<pre class="programlisting"> “background-gdk” <span class="type">GdkColor</span> *</pre>
<p>Background color as a <span class="type">GdkColor</span></p>
<pre class="programlisting"> “background-gdk” <a href="../html/gdk3-Colors.html#GdkColor"><span class="type">GdkColor</span></a> *</pre>
<p>Background color as a <a href="../html/gdk3-Colors.html#GdkColor"><span class="type">GdkColor</span></a></p>
<div class="warning">
<p><code class="literal">GtkCellRendererText:background-gdk</code> has been deprecated since version 3.4 and should not be used in newly-written code.</p>
<p>Use <a class="link" href="GtkCellRendererText.html#GtkCellRendererText--background-rgba" title="The “background-rgba” property"><span class="type">“background-rgba”</span></a> instead.</p>
@ -493,8 +493,8 @@ on the other hand, sets the horizontal alignment of the whole text.</p>
<hr>
<div class="refsect2">
<a name="GtkCellRendererText--background-rgba"></a><h3>The <code class="literal">“background-rgba”</code> property</h3>
<pre class="programlisting"> “background-rgba” <span class="type">GdkRGBA</span> *</pre>
<p>Background color as a <span class="type">GdkRGBA</span></p>
<pre class="programlisting"> “background-rgba” <a href="../html/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a> *</pre>
<p>Background color as a <a href="../html/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a></p>
<p>Flags: Read / Write</p>
<p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></p>
</div>
@ -584,8 +584,8 @@ for another way of making the text fit into a given width.</p>
<hr>
<div class="refsect2">
<a name="GtkCellRendererText--foreground-gdk"></a><h3>The <code class="literal">“foreground-gdk”</code> property</h3>
<pre class="programlisting"> “foreground-gdk” <span class="type">GdkColor</span> *</pre>
<p>Foreground color as a <span class="type">GdkColor</span></p>
<pre class="programlisting"> “foreground-gdk” <a href="../html/gdk3-Colors.html#GdkColor"><span class="type">GdkColor</span></a> *</pre>
<p>Foreground color as a <a href="../html/gdk3-Colors.html#GdkColor"><span class="type">GdkColor</span></a></p>
<div class="warning">
<p><code class="literal">GtkCellRendererText:foreground-gdk</code> has been deprecated since version 3.4 and should not be used in newly-written code.</p>
<p>Use <a class="link" href="GtkCellRendererText.html#GtkCellRendererText--foreground-rgba" title="The “foreground-rgba” property"><span class="type">“foreground-rgba”</span></a> instead.</p>
@ -595,8 +595,8 @@ for another way of making the text fit into a given width.</p>
<hr>
<div class="refsect2">
<a name="GtkCellRendererText--foreground-rgba"></a><h3>The <code class="literal">“foreground-rgba”</code> property</h3>
<pre class="programlisting"> “foreground-rgba” <span class="type">GdkRGBA</span> *</pre>
<p>Foreground color as a <span class="type">GdkRGBA</span></p>
<pre class="programlisting"> “foreground-rgba” <a href="../html/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a> *</pre>
<p>Foreground color as a <a href="../html/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a></p>
<p>Flags: Read / Write</p>
<p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></p>
</div>

16
docs/reference/gtk/html/GtkCellView.html
View File

@ -190,13 +190,13 @@
</tr>
<tr>
<td class="property_type">
<span class="type">GdkColor</span> *</td>
<a href="../html/gdk3-Colors.html#GdkColor"><span class="type">GdkColor</span></a> *</td>
<td class="property_name"><a class="link" href="GtkCellView.html#GtkCellView--background-gdk" title="The “background-gdk” property">background-gdk</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type">
<span class="type">GdkRGBA</span> *</td>
<a href="../html/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a> *</td>
<td class="property_name"><a class="link" href="GtkCellView.html#GtkCellView--background-rgba" title="The “background-rgba” property">background-rgba</a></td>
<td class="property_flags">Read / Write</td>
</tr>
@ -623,7 +623,7 @@ the model row pointed to by <em class="parameter"><code>path</code></em>
<a name="gtk-cell-view-set-background-color"></a><h3>gtk_cell_view_set_background_color ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_cell_view_set_background_color (<em class="parameter"><code><a class="link" href="GtkCellView.html" title="GtkCellView"><span class="type">GtkCellView</span></a> *cell_view</code></em>,
<em class="parameter"><code>const <span class="type">GdkColor</span> *color</code></em>);</pre>
<em class="parameter"><code>const <a href="../html/gdk3-Colors.html#GdkColor"><span class="type">GdkColor</span></a> *color</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_cell_view_set_background_color</code> has been deprecated since version 3.4 and should not be used in newly-written code.</p>
<p>Use <a class="link" href="GtkCellView.html#gtk-cell-view-set-background-rgba" title="gtk_cell_view_set_background_rgba ()"><code class="function">gtk_cell_view_set_background_rgba()</code></a> instead.</p>
@ -659,7 +659,7 @@ gtk_cell_view_set_background_color (<em class="parameter"><code><a class="link"
<a name="gtk-cell-view-set-background-rgba"></a><h3>gtk_cell_view_set_background_rgba ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_cell_view_set_background_rgba (<em class="parameter"><code><a class="link" href="GtkCellView.html" title="GtkCellView"><span class="type">GtkCellView</span></a> *cell_view</code></em>,
<em class="parameter"><code>const <span class="type">GdkRGBA</span> *rgba</code></em>);</pre>
<em class="parameter"><code>const <a href="../html/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a> *rgba</code></em>);</pre>
<p>Sets the background color of <em class="parameter"><code>cell_view</code></em>
.</p>
<div class="refsect3">
@ -858,8 +858,8 @@ the entire <a class="link" href="GtkTreeModel.html" title="GtkTreeModel"><span c
<hr>
<div class="refsect2">
<a name="GtkCellView--background-gdk"></a><h3>The <code class="literal">“background-gdk”</code> property</h3>
<pre class="programlisting"> “background-gdk” <span class="type">GdkColor</span> *</pre>
<p>The background color as a <span class="type">GdkColor</span></p>
<pre class="programlisting"> “background-gdk” <a href="../html/gdk3-Colors.html#GdkColor"><span class="type">GdkColor</span></a> *</pre>
<p>The background color as a <a href="../html/gdk3-Colors.html#GdkColor"><span class="type">GdkColor</span></a></p>
<div class="warning">
<p><code class="literal">GtkCellView:background-gdk</code> has been deprecated since version 3.4 and should not be used in newly-written code.</p>
<p>Use <a class="link" href="GtkCellView.html#GtkCellView--background-rgba" title="The “background-rgba” property"><span class="type">“background-rgba”</span></a> instead.</p>
@ -869,8 +869,8 @@ the entire <a class="link" href="GtkTreeModel.html" title="GtkTreeModel"><span c
<hr>
<div class="refsect2">
<a name="GtkCellView--background-rgba"></a><h3>The <code class="literal">“background-rgba”</code> property</h3>
<pre class="programlisting"> “background-rgba” <span class="type">GdkRGBA</span> *</pre>
<p>The background color as a <span class="type">GdkRGBA</span></p>
<pre class="programlisting"> “background-rgba” <a href="../html/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a> *</pre>
<p>The background color as a <a href="../html/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a></p>
<p>Flags: Read / Write</p>
<p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></p>
</div>

32
docs/reference/gtk/html/GtkColorButton.html
View File

@ -165,13 +165,13 @@
</tr>
<tr>
<td class="property_type">
<span class="type">GdkColor</span> *</td>
<a href="../html/gdk3-Colors.html#GdkColor"><span class="type">GdkColor</span></a> *</td>
<td class="property_name"><a class="link" href="GtkColorButton.html#GtkColorButton--color" title="The “color” property">color</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type">
<span class="type">GdkRGBA</span> *</td>
<a href="../html/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a> *</td>
<td class="property_name"><a class="link" href="GtkColorButton.html#GtkColorButton--rgba" title="The “rgba” property">rgba</a></td>
<td class="property_flags">Read / Write</td>
</tr>
@ -277,7 +277,7 @@ color when the user finishes.</p>
<div class="refsect2">
<a name="gtk-color-button-new-with-color"></a><h3>gtk_color_button_new_with_color ()</h3>
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
gtk_color_button_new_with_color (<em class="parameter"><code>const <span class="type">GdkColor</span> *color</code></em>);</pre>
gtk_color_button_new_with_color (<em class="parameter"><code>const <a href="../html/gdk3-Colors.html#GdkColor"><span class="type">GdkColor</span></a> *color</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_color_button_new_with_color</code> has been deprecated since version 3.4 and should not be used in newly-written code.</p>
<p>Use <a class="link" href="GtkColorButton.html#gtk-color-button-new-with-rgba" title="gtk_color_button_new_with_rgba ()"><code class="function">gtk_color_button_new_with_rgba()</code></a> instead.</p>
@ -293,7 +293,7 @@ gtk_color_button_new_with_color (<em class="parameter"><code>const <span class="
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>color</p></td>
<td class="parameter_description"><p>A <span class="type">GdkColor</span> to set the current color with</p></td>
<td class="parameter_description"><p>A <a href="../html/gdk3-Colors.html#GdkColor"><span class="type">GdkColor</span></a> to set the current color with</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
@ -308,7 +308,7 @@ gtk_color_button_new_with_color (<em class="parameter"><code>const <span class="
<div class="refsect2">
<a name="gtk-color-button-new-with-rgba"></a><h3>gtk_color_button_new_with_rgba ()</h3>
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
gtk_color_button_new_with_rgba (<em class="parameter"><code>const <span class="type">GdkRGBA</span> *rgba</code></em>);</pre>
gtk_color_button_new_with_rgba (<em class="parameter"><code>const <a href="../html/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a> *rgba</code></em>);</pre>
<p>Creates a new color button.</p>
<div class="refsect3">
<a name="gtk-color-button-new-with-rgba.parameters"></a><h4>Parameters</h4>
@ -320,7 +320,7 @@ gtk_color_button_new_with_rgba (<em class="parameter"><code>const <span class="t
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>rgba</p></td>
<td class="parameter_description"><p>A <span class="type">GdkRGBA</span> to set the current color with</p></td>
<td class="parameter_description"><p>A <a href="../html/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a> to set the current color with</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
@ -336,7 +336,7 @@ gtk_color_button_new_with_rgba (<em class="parameter"><code>const <span class="t
<a name="gtk-color-button-set-color"></a><h3>gtk_color_button_set_color ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_color_button_set_color (<em class="parameter"><code><a class="link" href="GtkColorButton.html" title="GtkColorButton"><span class="type">GtkColorButton</span></a> *button</code></em>,
<em class="parameter"><code>const <span class="type">GdkColor</span> *color</code></em>);</pre>
<em class="parameter"><code>const <a href="../html/gdk3-Colors.html#GdkColor"><span class="type">GdkColor</span></a> *color</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_color_button_set_color</code> is deprecated and should not be used in newly-written code.</p>
<p>Use <a class="link" href="GtkColorChooser.html#gtk-color-chooser-set-rgba" title="gtk_color_chooser_set_rgba ()"><code class="function">gtk_color_chooser_set_rgba()</code></a> instead.</p>
@ -359,7 +359,7 @@ gtk_color_button_set_color (<em class="parameter"><code><a class="link" href="Gt
</tr>
<tr>
<td class="parameter_name"><p>color</p></td>
<td class="parameter_description"><p>A <span class="type">GdkColor</span> to set the current color with</p></td>
<td class="parameter_description"><p>A <a href="../html/gdk3-Colors.html#GdkColor"><span class="type">GdkColor</span></a> to set the current color with</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
@ -372,7 +372,7 @@ gtk_color_button_set_color (<em class="parameter"><code><a class="link" href="Gt
<a name="gtk-color-button-get-color"></a><h3>gtk_color_button_get_color ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_color_button_get_color (<em class="parameter"><code><a class="link" href="GtkColorButton.html" title="GtkColorButton"><span class="type">GtkColorButton</span></a> *button</code></em>,
<em class="parameter"><code><span class="type">GdkColor</span> *color</code></em>);</pre>
<em class="parameter"><code><a href="../html/gdk3-Colors.html#GdkColor"><span class="type">GdkColor</span></a> *color</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_color_button_get_color</code> has been deprecated since version 3.4 and should not be used in newly-written code.</p>
<p>Use <a class="link" href="GtkColorChooser.html#gtk-color-chooser-get-rgba" title="gtk_color_chooser_get_rgba ()"><code class="function">gtk_color_chooser_get_rgba()</code></a> instead.</p>
@ -395,7 +395,7 @@ gtk_color_button_get_color (<em class="parameter"><code><a class="link" href="Gt
</tr>
<tr>
<td class="parameter_name"><p>color</p></td>
<td class="parameter_description"><p>a <span class="type">GdkColor</span> to fill in with the current color. </p></td>
<td class="parameter_description"><p>a <a href="../html/gdk3-Colors.html#GdkColor"><span class="type">GdkColor</span></a> to fill in with the current color. </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>
@ -475,7 +475,7 @@ gtk_color_button_get_alpha (<em class="parameter"><code><a class="link" href="Gt
<a name="gtk-color-button-set-rgba"></a><h3>gtk_color_button_set_rgba ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_color_button_set_rgba (<em class="parameter"><code><a class="link" href="GtkColorButton.html" title="GtkColorButton"><span class="type">GtkColorButton</span></a> *button</code></em>,
<em class="parameter"><code>const <span class="type">GdkRGBA</span> *rgba</code></em>);</pre>
<em class="parameter"><code>const <a href="../html/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a> *rgba</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_color_button_set_rgba</code> has been deprecated since version 3.4 and should not be used in newly-written code.</p>
<p>Use <a class="link" href="GtkColorChooser.html#gtk-color-chooser-set-rgba" title="gtk_color_chooser_set_rgba ()"><code class="function">gtk_color_chooser_set_rgba()</code></a> instead.</p>
@ -499,7 +499,7 @@ gtk_color_button_set_rgba (<em class="parameter"><code><a class="link" href="Gtk
</tr>
<tr>
<td class="parameter_name"><p>rgba</p></td>
<td class="parameter_description"><p>a <span class="type">GdkRGBA</span> to set the current color with</p></td>
<td class="parameter_description"><p>a <a href="../html/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a> to set the current color with</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
@ -512,7 +512,7 @@ gtk_color_button_set_rgba (<em class="parameter"><code><a class="link" href="Gtk
<a name="gtk-color-button-get-rgba"></a><h3>gtk_color_button_get_rgba ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_color_button_get_rgba (<em class="parameter"><code><a class="link" href="GtkColorButton.html" title="GtkColorButton"><span class="type">GtkColorButton</span></a> *button</code></em>,
<em class="parameter"><code><span class="type">GdkRGBA</span> *rgba</code></em>);</pre>
<em class="parameter"><code><a href="../html/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a> *rgba</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_color_button_get_rgba</code> has been deprecated since version 3.4 and should not be used in newly-written code.</p>
<p>Use <a class="link" href="GtkColorChooser.html#gtk-color-chooser-get-rgba" title="gtk_color_chooser_get_rgba ()"><code class="function">gtk_color_chooser_get_rgba()</code></a> instead.</p>
@ -536,7 +536,7 @@ gtk_color_button_get_rgba (<em class="parameter"><code><a class="link" href="Gtk
</tr>
<tr>
<td class="parameter_name"><p>rgba</p></td>
<td class="parameter_description"><p>a <span class="type">GdkRGBA</span> to fill in with the current color. </p></td>
<td class="parameter_description"><p>a <a href="../html/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a> to fill in with the current color. </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>
@ -690,7 +690,7 @@ gtk_color_button_get_title (<em class="parameter"><code><a class="link" href="Gt
<hr>
<div class="refsect2">
<a name="GtkColorButton--color"></a><h3>The <code class="literal">“color”</code> property</h3>
<pre class="programlisting"> “color” <span class="type">GdkColor</span> *</pre>
<pre class="programlisting"> “color” <a href="../html/gdk3-Colors.html#GdkColor"><span class="type">GdkColor</span></a> *</pre>
<p>The selected color.</p>
<div class="warning">
<p><code class="literal">GtkColorButton:color</code> has been deprecated since version 3.4 and should not be used in newly-written code.</p>
@ -702,7 +702,7 @@ gtk_color_button_get_title (<em class="parameter"><code><a class="link" href="Gt
<hr>
<div class="refsect2">
<a name="GtkColorButton--rgba"></a><h3>The <code class="literal">“rgba”</code> property</h3>
<pre class="programlisting"> “rgba” <span class="type">GdkRGBA</span> *</pre>
<pre class="programlisting"> “rgba” <a href="../html/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a> *</pre>
<p>The RGBA color.</p>
<p>Flags: Read / Write</p>
<p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></p>

18
docs/reference/gtk/html/GtkColorChooser.html
View File

@ -98,7 +98,7 @@
<tbody>
<tr>
<td class="property_type">
<span class="type">GdkRGBA</span> *</td>
<a href="../html/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a> *</td>
<td class="property_name"><a class="link" href="GtkColorChooser.html#GtkColorChooser--rgba" title="The “rgba” property">rgba</a></td>
<td class="property_flags">Read / Write</td>
</tr>
@ -175,7 +175,7 @@ allowed to have alpha (translucency).</p>
<a name="gtk-color-chooser-get-rgba"></a><h3>gtk_color_chooser_get_rgba ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_color_chooser_get_rgba (<em class="parameter"><code><a class="link" href="GtkColorChooser.html" title="GtkColorChooser"><span class="type">GtkColorChooser</span></a> *chooser</code></em>,
<em class="parameter"><code><span class="type">GdkRGBA</span> *color</code></em>);</pre>
<em class="parameter"><code><a href="../html/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a> *color</code></em>);</pre>
<p>Gets the currently-selected color.</p>
<div class="refsect3">
<a name="gtk-color-chooser-get-rgba.parameters"></a><h4>Parameters</h4>
@ -193,7 +193,7 @@ gtk_color_chooser_get_rgba (<em class="parameter"><code><a class="link" href="Gt
</tr>
<tr>
<td class="parameter_name"><p>color</p></td>
<td class="parameter_description"><p>a <span class="type">GdkRGBA</span> to fill in with the current color. </p></td>
<td class="parameter_description"><p>a <a href="../html/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a> to fill in with the current color. </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>
@ -206,7 +206,7 @@ gtk_color_chooser_get_rgba (<em class="parameter"><code><a class="link" href="Gt
<a name="gtk-color-chooser-set-rgba"></a><h3>gtk_color_chooser_set_rgba ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_color_chooser_set_rgba (<em class="parameter"><code><a class="link" href="GtkColorChooser.html" title="GtkColorChooser"><span class="type">GtkColorChooser</span></a> *chooser</code></em>,
<em class="parameter"><code>const <span class="type">GdkRGBA</span> *color</code></em>);</pre>
<em class="parameter"><code>const <a href="../html/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a> *color</code></em>);</pre>
<p>Sets the color.</p>
<div class="refsect3">
<a name="gtk-color-chooser-set-rgba.parameters"></a><h4>Parameters</h4>
@ -299,7 +299,7 @@ gtk_color_chooser_add_palette (<em class="parameter"><code><a class="link" href=
<em class="parameter"><code><a class="link" href="gtk3-Standard-Enumerations.html#GtkOrientation" title="enum GtkOrientation"><span class="type">GtkOrientation</span></a> orientation</code></em>,
<em class="parameter"><code><span class="type">gint</span> colors_per_line</code></em>,
<em class="parameter"><code><span class="type">gint</span> n_colors</code></em>,
<em class="parameter"><code><span class="type">GdkRGBA</span> *colors</code></em>);</pre>
<em class="parameter"><code><a href="../html/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a> *colors</code></em>);</pre>
<p>Adds a palette to the color chooser. If <em class="parameter"><code>orientation</code></em>
is horizontal,
the colors are grouped in rows, with <em class="parameter"><code>colors_per_line</code></em>
@ -370,9 +370,9 @@ be displayed in rows, <a class="link" href="gtk3-Standard-Enumerations.html#GTK-
<a name="GtkColorChooser.property-details"></a><h2>Property Details</h2>
<div class="refsect2">
<a name="GtkColorChooser--rgba"></a><h3>The <code class="literal">“rgba”</code> property</h3>
<pre class="programlisting"> “rgba” <span class="type">GdkRGBA</span> *</pre>
<pre class="programlisting"> “rgba” <a href="../html/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a> *</pre>
<p>The ::rgba property contains the currently selected color,
as a <span class="type">GdkRGBA</span> struct. The property can be set to change
as a <a href="../html/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a> struct. The property can be set to change
the current selection programmatically.</p>
<p>Flags: Read / Write</p>
<p class="since">Since: <a class="link" href="api-index-3-4.html#api-index-3.4">3.4</a></p>
@ -382,7 +382,7 @@ the current selection programmatically.</p>
<a name="GtkColorChooser--use-alpha"></a><h3>The <code class="literal">“use-alpha”</code> property</h3>
<pre class="programlisting"> “use-alpha” <span class="type">gboolean</span></pre>
<p>When ::use-alpha is <code class="literal">TRUE</code>, colors may have alpha (translucency)
information. When it is <code class="literal">FALSE</code>, the <span class="type">GdkRGBA</span> struct obtained
information. When it is <code class="literal">FALSE</code>, the <a href="../html/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a> struct obtained
via the <a class="link" href="GtkColorChooser.html#GtkColorChooser--rgba" title="The “rgba” property"><span class="type">“rgba”</span></a> property will be forced to have
alpha == 1.</p>
<p>Implementations are expected to show alpha by rendering the color
@ -398,7 +398,7 @@ over a non-uniform background (like a checkerboard pattern).</p>
<a name="GtkColorChooser-color-activated"></a><h3>The <code class="literal">“color-activated”</code> signal</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
user_function (<a class="link" href="GtkColorChooser.html" title="GtkColorChooser"><span class="type">GtkColorChooser</span></a> *chooser,
<span class="type">GdkRGBA</span> *color,
<a href="../html/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a> *color,
<span class="type">gpointer</span> user_data)</pre>
<p>Emitted when a color is activated from the color chooser.
This usually happens when the user clicks a color swatch,

54
docs/reference/gtk/html/GtkColorSelection.html
View File

@ -246,13 +246,13 @@
</tr>
<tr>
<td class="property_type">
<span class="type">GdkColor</span> *</td>
<a href="../html/gdk3-Colors.html#GdkColor"><span class="type">GdkColor</span></a> *</td>
<td class="property_name"><a class="link" href="GtkColorSelection.html#GtkColorSelection--current-color" title="The “current-color” property">current-color</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type">
<span class="type">GdkRGBA</span> *</td>
<a href="../html/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a> *</td>
<td class="property_name"><a class="link" href="GtkColorSelection.html#GtkColorSelection--current-rgba" title="The “current-rgba” property">current-rgba</a></td>
<td class="property_flags">Read / Write</td>
</tr>
@ -535,7 +535,7 @@ the original opacity to be <em class="parameter"><code>alpha</code></em>
<a name="gtk-color-selection-get-current-color"></a><h3>gtk_color_selection_get_current_color ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_color_selection_get_current_color (<em class="parameter"><code><a class="link" href="GtkColorSelection.html" title="GtkColorSelection"><span class="type">GtkColorSelection</span></a> *colorsel</code></em>,
<em class="parameter"><code><span class="type">GdkColor</span> *color</code></em>);</pre>
<em class="parameter"><code><a href="../html/gdk3-Colors.html#GdkColor"><span class="type">GdkColor</span></a> *color</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_color_selection_get_current_color</code> has been deprecated since version 3.4 and should not be used in newly-written code.</p>
<p>Use <a class="link" href="GtkColorSelection.html#gtk-color-selection-get-current-rgba" title="gtk_color_selection_get_current_rgba ()"><code class="function">gtk_color_selection_get_current_rgba()</code></a> instead.</p>
@ -558,7 +558,7 @@ gtk_color_selection_get_current_color (<em class="parameter"><code><a class="lin
</tr>
<tr>
<td class="parameter_name"><p>color</p></td>
<td class="parameter_description"><p>a <span class="type">GdkColor</span> to fill in with the current color. </p></td>
<td class="parameter_description"><p>a <a href="../html/gdk3-Colors.html#GdkColor"><span class="type">GdkColor</span></a> to fill in with the current color. </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>
@ -570,7 +570,7 @@ gtk_color_selection_get_current_color (<em class="parameter"><code><a class="lin
<a name="gtk-color-selection-set-current-color"></a><h3>gtk_color_selection_set_current_color ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_color_selection_set_current_color (<em class="parameter"><code><a class="link" href="GtkColorSelection.html" title="GtkColorSelection"><span class="type">GtkColorSelection</span></a> *colorsel</code></em>,
<em class="parameter"><code>const <span class="type">GdkColor</span> *color</code></em>);</pre>
<em class="parameter"><code>const <a href="../html/gdk3-Colors.html#GdkColor"><span class="type">GdkColor</span></a> *color</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_color_selection_set_current_color</code> has been deprecated since version 3.4 and should not be used in newly-written code.</p>
<p>Use <a class="link" href="GtkColorSelection.html#gtk-color-selection-set-current-rgba" title="gtk_color_selection_set_current_rgba ()"><code class="function">gtk_color_selection_set_current_rgba()</code></a> instead.</p>
@ -596,7 +596,7 @@ the original color to be <em class="parameter"><code>color</code></em>
</tr>
<tr>
<td class="parameter_name"><p>color</p></td>
<td class="parameter_description"><p>a <span class="type">GdkColor</span> to set the current color with</p></td>
<td class="parameter_description"><p>a <a href="../html/gdk3-Colors.html#GdkColor"><span class="type">GdkColor</span></a> to set the current color with</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
@ -672,7 +672,7 @@ as it might seem confusing to have that alpha change.</p>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_color_selection_get_previous_color
(<em class="parameter"><code><a class="link" href="GtkColorSelection.html" title="GtkColorSelection"><span class="type">GtkColorSelection</span></a> *colorsel</code></em>,
<em class="parameter"><code><span class="type">GdkColor</span> *color</code></em>);</pre>
<em class="parameter"><code><a href="../html/gdk3-Colors.html#GdkColor"><span class="type">GdkColor</span></a> *color</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_color_selection_get_previous_color</code> has been deprecated since version 3.4 and should not be used in newly-written code.</p>
<p>Use <a class="link" href="GtkColorSelection.html#gtk-color-selection-get-previous-rgba" title="gtk_color_selection_get_previous_rgba ()"><code class="function">gtk_color_selection_get_previous_rgba()</code></a> instead.</p>
@ -695,7 +695,7 @@ gtk_color_selection_get_previous_color
</tr>
<tr>
<td class="parameter_name"><p>color</p></td>
<td class="parameter_description"><p>a <span class="type">GdkColor</span> to fill in with the original color value. </p></td>
<td class="parameter_description"><p>a <a href="../html/gdk3-Colors.html#GdkColor"><span class="type">GdkColor</span></a> to fill in with the original color value. </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>
@ -708,7 +708,7 @@ gtk_color_selection_get_previous_color
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_color_selection_set_previous_color
(<em class="parameter"><code><a class="link" href="GtkColorSelection.html" title="GtkColorSelection"><span class="type">GtkColorSelection</span></a> *colorsel</code></em>,
<em class="parameter"><code>const <span class="type">GdkColor</span> *color</code></em>);</pre>
<em class="parameter"><code>const <a href="../html/gdk3-Colors.html#GdkColor"><span class="type">GdkColor</span></a> *color</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_color_selection_set_previous_color</code> has been deprecated since version 3.4 and should not be used in newly-written code.</p>
<p>Use <a class="link" href="GtkColorSelection.html#gtk-color-selection-set-previous-rgba" title="gtk_color_selection_set_previous_rgba ()"><code class="function">gtk_color_selection_set_previous_rgba()</code></a> instead.</p>
@ -735,7 +735,7 @@ set this color the first time it is called.</p>
</tr>
<tr>
<td class="parameter_name"><p>color</p></td>
<td class="parameter_description"><p>a <span class="type">GdkColor</span> to set the previous color with</p></td>
<td class="parameter_description"><p>a <a href="../html/gdk3-Colors.html#GdkColor"><span class="type">GdkColor</span></a> to set the previous color with</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
@ -747,7 +747,7 @@ set this color the first time it is called.</p>
<a name="gtk-color-selection-get-current-rgba"></a><h3>gtk_color_selection_get_current_rgba ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_color_selection_get_current_rgba (<em class="parameter"><code><a class="link" href="GtkColorSelection.html" title="GtkColorSelection"><span class="type">GtkColorSelection</span></a> *colorsel</code></em>,
<em class="parameter"><code><span class="type">GdkRGBA</span> *rgba</code></em>);</pre>
<em class="parameter"><code><a href="../html/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a> *rgba</code></em>);</pre>
<div class="warning"><p><code class="literal">gtk_color_selection_get_current_rgba</code> is deprecated and should not be used in newly-written code.</p></div>
<p>Sets <em class="parameter"><code>rgba</code></em>
to be the current color in the GtkColorSelection widget.</p>
@ -767,7 +767,7 @@ gtk_color_selection_get_current_rgba (<em class="parameter"><code><a class="link
</tr>
<tr>
<td class="parameter_name"><p>rgba</p></td>
<td class="parameter_description"><p>a <span class="type">GdkRGBA</span> to fill in with the current color. </p></td>
<td class="parameter_description"><p>a <a href="../html/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a> to fill in with the current color. </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>
@ -780,7 +780,7 @@ gtk_color_selection_get_current_rgba (<em class="parameter"><code><a class="link
<a name="gtk-color-selection-set-current-rgba"></a><h3>gtk_color_selection_set_current_rgba ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_color_selection_set_current_rgba (<em class="parameter"><code><a class="link" href="GtkColorSelection.html" title="GtkColorSelection"><span class="type">GtkColorSelection</span></a> *colorsel</code></em>,
<em class="parameter"><code>const <span class="type">GdkRGBA</span> *rgba</code></em>);</pre>
<em class="parameter"><code>const <a href="../html/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a> *rgba</code></em>);</pre>
<div class="warning"><p><code class="literal">gtk_color_selection_set_current_rgba</code> is deprecated and should not be used in newly-written code.</p></div>
<p>Sets the current color to be <em class="parameter"><code>rgba</code></em>
.</p>
@ -803,7 +803,7 @@ the original color to be <em class="parameter"><code>rgba</code></em>
</tr>
<tr>
<td class="parameter_name"><p>rgba</p></td>
<td class="parameter_description"><p>A <span class="type">GdkRGBA</span> to set the current color with</p></td>
<td class="parameter_description"><p>A <a href="../html/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a> to set the current color with</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
@ -816,7 +816,7 @@ the original color to be <em class="parameter"><code>rgba</code></em>
<a name="gtk-color-selection-get-previous-rgba"></a><h3>gtk_color_selection_get_previous_rgba ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_color_selection_get_previous_rgba (<em class="parameter"><code><a class="link" href="GtkColorSelection.html" title="GtkColorSelection"><span class="type">GtkColorSelection</span></a> *colorsel</code></em>,
<em class="parameter"><code><span class="type">GdkRGBA</span> *rgba</code></em>);</pre>
<em class="parameter"><code><a href="../html/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a> *rgba</code></em>);</pre>
<div class="warning"><p><code class="literal">gtk_color_selection_get_previous_rgba</code> is deprecated and should not be used in newly-written code.</p></div>
<p>Fills <em class="parameter"><code>rgba</code></em>
in with the original color value.</p>
@ -836,7 +836,7 @@ gtk_color_selection_get_previous_rgba (<em class="parameter"><code><a class="lin
</tr>
<tr>
<td class="parameter_name"><p>rgba</p></td>
<td class="parameter_description"><p>a <span class="type">GdkRGBA</span> to fill in with the original color value. </p></td>
<td class="parameter_description"><p>a <a href="../html/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a> to fill in with the original color value. </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>
@ -849,7 +849,7 @@ gtk_color_selection_get_previous_rgba (<em class="parameter"><code><a class="lin
<a name="gtk-color-selection-set-previous-rgba"></a><h3>gtk_color_selection_set_previous_rgba ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_color_selection_set_previous_rgba (<em class="parameter"><code><a class="link" href="GtkColorSelection.html" title="GtkColorSelection"><span class="type">GtkColorSelection</span></a> *colorsel</code></em>,
<em class="parameter"><code>const <span class="type">GdkRGBA</span> *rgba</code></em>);</pre>
<em class="parameter"><code>const <a href="../html/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a> *rgba</code></em>);</pre>
<div class="warning"><p><code class="literal">gtk_color_selection_set_previous_rgba</code> is deprecated and should not be used in newly-written code.</p></div>
<p>Sets the “previous” color to be <em class="parameter"><code>rgba</code></em>
.</p>
@ -873,7 +873,7 @@ set this color the first time it is called.</p>
</tr>
<tr>
<td class="parameter_name"><p>rgba</p></td>
<td class="parameter_description"><p>a <span class="type">GdkRGBA</span> to set the previous color with</p></td>
<td class="parameter_description"><p>a <a href="../html/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a> to set the previous color with</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
@ -916,11 +916,11 @@ a color around, and <code class="literal">FALSE</code> if the selection has stop
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gtk_color_selection_palette_from_string
(<em class="parameter"><code>const <span class="type">gchar</span> *str</code></em>,
<em class="parameter"><code><span class="type">GdkColor</span> **colors</code></em>,
<em class="parameter"><code><a href="../html/gdk3-Colors.html#GdkColor"><span class="type">GdkColor</span></a> **colors</code></em>,
<em class="parameter"><code><span class="type">gint</span> *n_colors</code></em>);</pre>
<div class="warning"><p><code class="literal">gtk_color_selection_palette_from_string</code> is deprecated and should not be used in newly-written code.</p></div>
<p>Parses a color palette string; the string is a colon-separated
list of color names readable by <code class="function">gdk_color_parse()</code>.</p>
list of color names readable by <a href="../html/gdk3-Colors.html#gdk-color-parse"><code class="function">gdk_color_parse()</code></a>.</p>
<div class="refsect3">
<a name="gtk-color-selection-palette-from-string.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
@ -938,7 +938,7 @@ list of color names readable by <code class="function">gdk_color_parse()</code>.
<tr>
<td class="parameter_name"><p>colors</p></td>
<td class="parameter_description"><p>return location for
allocated array of <span class="type">GdkColor</span>. </p></td>
allocated array of <a href="../html/gdk3-Colors.html#GdkColor"><span class="type">GdkColor</span></a>. </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="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=n_colors]</span></td>
</tr>
<tr>
@ -958,7 +958,7 @@ allocated array of <span class="type">GdkColor</span>. </p></td>
<div class="refsect2">
<a name="gtk-color-selection-palette-to-string"></a><h3>gtk_color_selection_palette_to_string ()</h3>
<pre class="programlisting"><span class="returnvalue">gchar</span> *
gtk_color_selection_palette_to_string (<em class="parameter"><code>const <span class="type">GdkColor</span> *colors</code></em>,
gtk_color_selection_palette_to_string (<em class="parameter"><code>const <a href="../html/gdk3-Colors.html#GdkColor"><span class="type">GdkColor</span></a> *colors</code></em>,
<em class="parameter"><code><span class="type">gint</span> n_colors</code></em>);</pre>
<div class="warning"><p><code class="literal">gtk_color_selection_palette_to_string</code> is deprecated and should not be used in newly-written code.</p></div>
<p>Encodes a palette as a string, useful for persistent storage.</p>
@ -993,7 +993,7 @@ gtk_color_selection_palette_to_string (<em class="parameter"><code>const <span c
<div class="refsect2">
<a name="GtkColorSelectionChangePaletteFunc"></a><h3>GtkColorSelectionChangePaletteFunc ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
<span class="c_punctuation">(</span>*GtkColorSelectionChangePaletteFunc<span class="c_punctuation">)</span> (<em class="parameter"><code>const <span class="type">GdkColor</span> *colors</code></em>,
<span class="c_punctuation">(</span>*GtkColorSelectionChangePaletteFunc<span class="c_punctuation">)</span> (<em class="parameter"><code>const <a href="../html/gdk3-Colors.html#GdkColor"><span class="type">GdkColor</span></a> *colors</code></em>,
<em class="parameter"><code><span class="type">gint</span> n_colors</code></em>);</pre>
<div class="warning"><p><code class="literal">GtkColorSelectionChangePaletteFunc</code> has been deprecated since version 3.4 and should not be used in newly-written code.</p></div>
<div class="refsect3">
@ -1058,8 +1058,8 @@ GtkColorSelection widgets will be modified.</p>
<a name="GtkColorSelectionChangePaletteWithScreenFunc"></a><h3>GtkColorSelectionChangePaletteWithScreenFunc ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
<span class="c_punctuation">(</span>*GtkColorSelectionChangePaletteWithScreenFunc<span class="c_punctuation">)</span>
(<em class="parameter"><code><span class="type">GdkScreen</span> *screen</code></em>,
<em class="parameter"><code>const <span class="type">GdkColor</span> *colors</code></em>,
(<em class="parameter"><code><a href="../html/GdkScreen.html#GdkScreen-struct"><span class="type">GdkScreen</span></a> *screen</code></em>,
<em class="parameter"><code>const <a href="../html/gdk3-Colors.html#GdkColor"><span class="type">GdkColor</span></a> *colors</code></em>,
<em class="parameter"><code><span class="type">gint</span> n_colors</code></em>);</pre>
<div class="warning"><p><code class="literal">GtkColorSelectionChangePaletteWithScreenFunc</code> has been deprecated since version 3.4 and should not be used in newly-written code.</p></div>
<div class="refsect3">
@ -1132,7 +1132,7 @@ GtkColorSelection widgets will be modified.</p>
<hr>
<div class="refsect2">
<a name="GtkColorSelection--current-color"></a><h3>The <code class="literal">“current-color”</code> property</h3>
<pre class="programlisting"> “current-color” <span class="type">GdkColor</span> *</pre>
<pre class="programlisting"> “current-color” <a href="../html/gdk3-Colors.html#GdkColor"><span class="type">GdkColor</span></a> *</pre>
<p>The current GdkColor color.</p>
<div class="warning">
<p><code class="literal">GtkColorSelection:current-color</code> has been deprecated since version 3.4 and should not be used in newly-written code.</p>
@ -1143,7 +1143,7 @@ GtkColorSelection widgets will be modified.</p>
<hr>
<div class="refsect2">
<a name="GtkColorSelection--current-rgba"></a><h3>The <code class="literal">“current-rgba”</code> property</h3>
<pre class="programlisting"> “current-rgba” <span class="type">GdkRGBA</span> *</pre>
<pre class="programlisting"> “current-rgba” <a href="../html/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a> *</pre>
<p>The current RGBA color.</p>
<p>Flags: Read / Write</p>
<p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></p>

6
docs/reference/gtk/html/GtkComboBox.html
View File

@ -1353,12 +1353,12 @@ cell renderers for the new model.</p>
<a name="gtk-combo-box-popup-for-device"></a><h3>gtk_combo_box_popup_for_device ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_combo_box_popup_for_device (<em class="parameter"><code><a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *combo_box</code></em>,
<em class="parameter"><code><span class="type">GdkDevice</span> *device</code></em>);</pre>
<em class="parameter"><code><a href="../html/GdkDevice.html#GdkDevice-struct"><span class="type">GdkDevice</span></a> *device</code></em>);</pre>
<p>Pops up the menu or dropdown list of <em class="parameter"><code>combo_box</code></em>
, the popup window
will be grabbed so only <em class="parameter"><code>device</code></em>
and its associated pointer/keyboard
are the only <span class="type">GdkDevices</span> able to send events to it.</p>
are the only <a href="../html/GdkDevice.html#GdkDevice-struct"><span class="type">GdkDevices</span></a> able to send events to it.</p>
<div class="refsect3">
<a name="gtk-combo-box-popup-for-device.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
@ -1375,7 +1375,7 @@ are the only <span class="type">GdkDevices</span> able to send events to it.</p>
</tr>
<tr>
<td class="parameter_name"><p>device</p></td>
<td class="parameter_description"><p>a <span class="type">GdkDevice</span></p></td>
<td class="parameter_description"><p>a <a href="../html/GdkDevice.html#GdkDevice-struct"><span class="type">GdkDevice</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>

2
docs/reference/gtk/html/GtkContainer.html
View File

@ -1902,7 +1902,7 @@ gtk_container_propagate_draw (<em class="parameter"><code><a class="link" href="
<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>When a container receives a call to the draw function, it must send
synthetic <a class="link" href="GtkWidget.html#GtkWidget-draw" title="The “draw” signal"><span class="type">“draw”</span></a> calls to all children that don’t have their
own <span class="type">GdkWindows</span>. This function provides a convenient way of doing this.
own <a href="../html/gdk3-Windows.html#GdkWindow-struct"><span class="type">GdkWindows</span></a>. This function provides a convenient way of doing this.
A container, when it receives a call to its <a class="link" href="GtkWidget.html#GtkWidget-draw" title="The “draw” signal"><span class="type">“draw”</span></a> function,
calls <a class="link" href="GtkContainer.html#gtk-container-propagate-draw" title="gtk_container_propagate_draw ()"><code class="function">gtk_container_propagate_draw()</code></a> once for each child, passing in
the <em class="parameter"><code>cr</code></em>

4
docs/reference/gtk/html/GtkDialog.html
View File

@ -1105,7 +1105,7 @@ headerbar is only used by the dialog if the
<div class="refsect2">
<a name="gtk-alternative-dialog-button-order"></a><h3>gtk_alternative_dialog_button_order ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gtk_alternative_dialog_button_order (<em class="parameter"><code><span class="type">GdkScreen</span> *screen</code></em>);</pre>
gtk_alternative_dialog_button_order (<em class="parameter"><code><a href="../html/GdkScreen.html#GdkScreen-struct"><span class="type">GdkScreen</span></a> *screen</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_alternative_dialog_button_order</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
<p>Deprecated</p>
@ -1130,7 +1130,7 @@ notified if the button order setting changes.</p>
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>screen</p></td>
<td class="parameter_description"><p>a <span class="type">GdkScreen</span>, or <code class="literal">NULL</code> to use the default screen. </p></td>
<td class="parameter_description"><p>a <a href="../html/GdkScreen.html#GdkScreen-struct"><span class="type">GdkScreen</span></a>, or <code class="literal">NULL</code> to use the default screen. </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>

4
docs/reference/gtk/html/GtkDrawingArea.html
View File

@ -167,7 +167,7 @@ to call <a class="link" href="GtkStyleContext.html#gtk-render-background" title=
<span class="normal"> </span><span class="function"><a href="GtkStyleContext.html#gtk-style-context-get-color">gtk_style_context_get_color</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">context</span><span class="symbol">,</span>
<span class="normal"> </span><span class="function"><a href="GtkStyleContext.html#gtk-style-context-get-state">gtk_style_context_get_state</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">context</span><span class="symbol">),</span>
<span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">color</span><span class="symbol">);</span>
<span class="normal"> </span><span class="function">gdk_cairo_set_source_rgba</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">cr</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">color</span><span class="symbol">);</span>
<span class="normal"> </span><span class="function"><a href="../html/gdk3-Cairo-Interaction.html#gdk-cairo-set-source-rgba">gdk_cairo_set_source_rgba</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">cr</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">color</span><span class="symbol">);</span>
<span class="normal"> </span><span class="function"><a href="/usr/share/gtk-doc/html/cairo/cairo-cairo-t.html#cairo-fill">cairo_fill</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">cr</span><span class="symbol">);</span>
@ -188,7 +188,7 @@ to call <a class="link" href="GtkStyleContext.html#gtk-render-background" title=
onscreen, or when it’s covered by another window and then uncovered.
You can also force an expose event by adding to the “damage region”
of the drawing area’s window; <a class="link" href="GtkWidget.html#gtk-widget-queue-draw-area" title="gtk_widget_queue_draw_area ()"><code class="function">gtk_widget_queue_draw_area()</code></a> and
<code class="function">gdk_window_invalidate_rect()</code> are equally good ways to do this.
<a href="../html/gdk3-Windows.html#gdk-window-invalidate-rect"><code class="function">gdk_window_invalidate_rect()</code></a> are equally good ways to do this.
You’ll then get a draw signal for the invalid region.</p>
<p>The available routines for drawing are documented on the
GDK Drawing Primitives page

12
docs/reference/gtk/html/GtkEntry.html
View File

@ -1388,7 +1388,7 @@ in <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkE
<a name="gtk-entry-get-text-area"></a><h3>gtk_entry_get_text_area ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_entry_get_text_area (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>,
<em class="parameter"><code><span class="type">GdkRectangle</span> *text_area</code></em>);</pre>
<em class="parameter"><code><a href="../html/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *text_area</code></em>);</pre>
<p>Gets the area where the entry’s text is drawn. This function is
useful when drawing something to the entry in a draw callback.</p>
<p>If the entry is not realized, <em class="parameter"><code>text_area</code></em>
@ -2668,7 +2668,7 @@ where a block bounces back and forth. Each call to
<a name="gtk-entry-im-context-filter-keypress"></a><h3>gtk_entry_im_context_filter_keypress ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gtk_entry_im_context_filter_keypress (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>,
<em class="parameter"><code><span class="type">GdkEventKey</span> *event</code></em>);</pre>
<em class="parameter"><code><a href="../html/gdk3-Event-Structures.html#GdkEventKey"><span class="type">GdkEventKey</span></a> *event</code></em>);</pre>
<p>Allow the <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> input method to internally handle key press
and release events. If this function returns <code class="literal">TRUE</code>, then no further
processing should be done for this key event. See
@ -3527,7 +3527,7 @@ string with <code class="function">g_free()</code> when done. </p>
gtk_entry_set_icon_drag_source (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>,
<em class="parameter"><code><a class="link" href="GtkEntry.html#GtkEntryIconPosition" title="enum GtkEntryIconPosition"><span class="type">GtkEntryIconPosition</span></a> icon_pos</code></em>,
<em class="parameter"><code><a class="link" href="gtk3-Selections.html#GtkTargetList"><span class="type">GtkTargetList</span></a> *target_list</code></em>,
<em class="parameter"><code><span class="type">GdkDragAction</span> actions</code></em>);</pre>
<em class="parameter"><code><a href="../html/gdk3-Drag-and-Drop.html#GdkDragAction"><span class="type">GdkDragAction</span></a> actions</code></em>);</pre>
<p>Sets up the icon at the given position so that GTK+ will start a drag
operation when the user clicks and drags the icon.</p>
<p>To handle the drag operation, you need to connect to the usual
@ -3611,7 +3611,7 @@ DND operation, or -1.</p>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_entry_get_icon_area (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>,
<em class="parameter"><code><a class="link" href="GtkEntry.html#GtkEntryIconPosition" title="enum GtkEntryIconPosition"><span class="type">GtkEntryIconPosition</span></a> icon_pos</code></em>,
<em class="parameter"><code><span class="type">GdkRectangle</span> *icon_area</code></em>);</pre>
<em class="parameter"><code><a href="../html/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *icon_area</code></em>);</pre>
<p>Gets the area where entry’s icon at <em class="parameter"><code>icon_pos</code></em>
is drawn.
This function is useful when drawing something to the
@ -4981,7 +4981,7 @@ units to delete</p></td>
<pre class="programlisting"><span class="returnvalue">void</span>
user_function (<a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry,
<a class="link" href="GtkEntry.html#GtkEntryIconPosition" title="enum GtkEntryIconPosition"><span class="type">GtkEntryIconPosition</span></a> icon_pos,
<span class="type">GdkEvent</span> *event,
<a href="../html/gdk3-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a> *event,
<span class="type">gpointer</span> user_data)</pre>
<p>The ::icon-press signal is emitted when an activatable icon
is clicked.</p>
@ -5026,7 +5026,7 @@ is clicked.</p>
<pre class="programlisting"><span class="returnvalue">void</span>
user_function (<a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry,
<a class="link" href="GtkEntry.html#GtkEntryIconPosition" title="enum GtkEntryIconPosition"><span class="type">GtkEntryIconPosition</span></a> icon_pos,
<span class="type">GdkEvent</span> *event,
<a href="../html/gdk3-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a> *event,
<span class="type">gpointer</span> user_data)</pre>
<p>The ::icon-release signal is emitted on the button release from a
mouse click over an activatable icon.</p>

4
docs/reference/gtk/html/GtkEventBox.html
View File

@ -241,10 +241,10 @@ gtk_event_box_set_visible_window (<em class="parameter"><code><a class="link" hr
<p>Set whether the event box uses a visible or invisible child
window. The default is to use visible windows.</p>
<p>In an invisible window event box, the window that the
event box creates is a <code class="literal">GDK_INPUT_ONLY</code> window, which
event box creates is a <a href="../html/gdk3-Windows.html#GDK-INPUT-ONLY:CAPS"><code class="literal">GDK_INPUT_ONLY</code></a> window, which
means that it is invisible and only serves to receive
events.</p>
<p>A visible window event box creates a visible (<code class="literal">GDK_INPUT_OUTPUT</code>)
<p>A visible window event box creates a visible (<a href="../html/gdk3-Windows.html#GDK-INPUT-OUTPUT:CAPS"><code class="literal">GDK_INPUT_OUTPUT</code></a>)
window that acts as the parent window for all the widgets
contained in the event box.</p>
<p>You should generally make your event box invisible if

8
docs/reference/gtk/html/GtkEventController.html
View File

@ -145,7 +145,7 @@
<div class="refsect1">
<a name="GtkEventController.description"></a><h2>Description</h2>
<p><a class="link" href="GtkEventController.html" title="GtkEventController"><span class="type">GtkEventController</span></a> is a base, low-level implementation for event
controllers. Those react to a series of <span class="type">GdkEvents</span>, and possibly trigger
controllers. Those react to a series of <a href="../html/gdk3-Event-Structures.html#GdkEvent"><span class="type">GdkEvents</span></a>, and possibly trigger
actions as a consequence of those.</p>
</div>
<div class="refsect1">
@ -219,7 +219,7 @@ the events can be managed by calling <a class="link" href="GtkEventController.ht
<a name="gtk-event-controller-handle-event"></a><h3>gtk_event_controller_handle_event ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gtk_event_controller_handle_event (<em class="parameter"><code><a class="link" href="GtkEventController.html" title="GtkEventController"><span class="type">GtkEventController</span></a> *controller</code></em>,
<em class="parameter"><code>const <span class="type">GdkEvent</span> *event</code></em>);</pre>
<em class="parameter"><code>const <a href="../html/gdk3-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a> *event</code></em>);</pre>
<p>Feeds an events into <em class="parameter"><code>controller</code></em>
, so it can be interpreted
and the controller actions triggered.</p>
@ -239,7 +239,7 @@ and the controller actions triggered.</p>
</tr>
<tr>
<td class="parameter_name"><p>event</p></td>
<td class="parameter_description"><p>a <span class="type">GdkEvent</span></p></td>
<td class="parameter_description"><p>a <a href="../html/gdk3-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
@ -384,7 +384,7 @@ will be dropped at this point.</p>
<div class="refsect2">
<a name="GtkEventController--widget"></a><h3>The <code class="literal">“widget”</code> property</h3>
<pre class="programlisting"> “widget” <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *</pre>
<p>The widget receiving the <span class="type">GdkEvents</span> that the controller will handle.</p>
<p>The widget receiving the <a href="../html/gdk3-Event-Structures.html#GdkEvent"><span class="type">GdkEvents</span></a> that the controller will handle.</p>
<p>Flags: Read / Write / Construct Only</p>
<p class="since">Since: <a class="link" href="api-index-3-14.html#api-index-3.14">3.14</a></p>
</div>

109
docs/reference/gtk/html/GtkEventControllerKey.html
View File

@ -29,7 +29,7 @@
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2><span class="refentrytitle"><a name="GtkEventControllerKey.top_of_page"></a>GtkEventControllerKey</span></h2>
<p>GtkEventControllerKey</p>
<p>GtkEventControllerKey — Event controller for key events</p>
</td>
<td class="gallery_image" valign="top" align="right"></td>
</tr></table></div>
@ -119,6 +119,9 @@
</div>
<div class="refsect1">
<a name="GtkEventControllerKey.description"></a><h2>Description</h2>
<p><a class="link" href="GtkEventControllerKey.html" title="GtkEventControllerKey"><span class="type">GtkEventControllerKey</span></a> is an event controller meant for situations
where you need access to key events.</p>
<p>This object was added in 3.24.</p>
</div>
<div class="refsect1">
<a name="GtkEventControllerKey.functions_details"></a><h2>Functions</h2>
@ -164,34 +167,120 @@ user_function (<a class="link" href="GtkEventControllerKey.html" title="GtkEvent
<div class="refsect2">
<a name="GtkEventControllerKey-key-pressed"></a><h3>The <code class="literal">“key-pressed”</code> signal</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
user_function (<a class="link" href="GtkEventControllerKey.html" title="GtkEventControllerKey"><span class="type">GtkEventControllerKey</span></a> *eventcontrollerkey,
<span class="type">guint</span> arg1,
<span class="type">guint</span> arg2,
<span class="type">GdkModifierType</span> arg3,
user_function (<a class="link" href="GtkEventControllerKey.html" title="GtkEventControllerKey"><span class="type">GtkEventControllerKey</span></a> *controller,
<span class="type">guint</span> keyval,
<span class="type">guint</span> keycode,
<a href="../html/gdk3-Windows.html#GdkModifierType"><span class="type">GdkModifierType</span></a> state,
<span class="type">gpointer</span> user_data)</pre>
<p>This signal is emitted whenever a key is pressed.</p>
<div class="refsect3">
<a name="GtkEventControllerKey-key-pressed.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>controller</p></td>
<td class="parameter_description"><p>the object which received the signal.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>keyval</p></td>
<td class="parameter_description"><p>the pressed key.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>keycode</p></td>
<td class="parameter_description"><p>the raw code of the pressed key.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>state</p></td>
<td class="parameter_description"><p>the bitmask, representing the state of modifier keys and pointer buttons. See <a href="../html/gdk3-Windows.html#GdkModifierType"><span class="type">GdkModifierType</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 set when the signal handler was connected.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="GtkEventControllerKey-key-pressed.returns"></a><h4>Returns</h4>
<p> <code class="literal">TRUE</code> if the key press was handled, <code class="literal">FALSE</code> otherwise.</p>
</div>
<p>Flags: Run Last</p>
<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="GtkEventControllerKey-key-released"></a><h3>The <code class="literal">“key-released”</code> signal</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
user_function (<a class="link" href="GtkEventControllerKey.html" title="GtkEventControllerKey"><span class="type">GtkEventControllerKey</span></a> *eventcontrollerkey,
<span class="type">guint</span> arg1,
<span class="type">guint</span> arg2,
<span class="type">GdkModifierType</span> arg3,
user_function (<a class="link" href="GtkEventControllerKey.html" title="GtkEventControllerKey"><span class="type">GtkEventControllerKey</span></a> *controller,
<span class="type">guint</span> keyval,
<span class="type">guint</span> keycode,
<a href="../html/gdk3-Windows.html#GdkModifierType"><span class="type">GdkModifierType</span></a> state,
<span class="type">gpointer</span> user_data)</pre>
<p>This signal is emitted whenever a key is released.</p>
<div class="refsect3">
<a name="GtkEventControllerKey-key-released.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>controller</p></td>
<td class="parameter_description"><p>the object which received the signal.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>keyval</p></td>
<td class="parameter_description"><p>the released key.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>keycode</p></td>
<td class="parameter_description"><p>the raw code of the released key.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>state</p></td>
<td class="parameter_description"><p>the bitmask, representing the state of modifier keys and pointer buttons. See <a href="../html/gdk3-Windows.html#GdkModifierType"><span class="type">GdkModifierType</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 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: <a class="link" href="api-index-3-24.html#api-index-3.24">3.24</a></p>
</div>
<hr>
<div class="refsect2">
<a name="GtkEventControllerKey-modifiers"></a><h3>The <code class="literal">“modifiers”</code> signal</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
user_function (<a class="link" href="GtkEventControllerKey.html" title="GtkEventControllerKey"><span class="type">GtkEventControllerKey</span></a> *eventcontrollerkey,
<span class="type">GdkModifierType</span> arg1,
<a href="../html/gdk3-Windows.html#GdkModifierType"><span class="type">GdkModifierType</span></a> arg1,
<span class="type">gpointer</span> user_data)</pre>
<p>Flags: Run Last</p>
</div>
</div>
<div class="refsect1">
<a name="GtkEventControllerKey.see-also"></a><h2>See Also</h2>
<p><a class="link" href="GtkEventController.html" title="GtkEventController"><span class="type">GtkEventController</span></a></p>
</div>
</div>
<div class="footer">
<hr>Generated by GTK-Doc V1.29</div>

42
docs/reference/gtk/html/GtkGLArea.html
View File

@ -53,7 +53,7 @@
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">GdkGLContext</span> *
<a href="../html/GdkGLContext.html#GdkGLContext-struct"><span class="returnvalue">GdkGLContext</span></a> *
</td>
<td class="function_name">
<a class="link" href="GtkGLArea.html#gtk-gl-area-get-context" title="gtk_gl_area_get_context ()">gtk_gl_area_get_context</a> <span class="c_punctuation">()</span>
@ -214,7 +214,7 @@
</tr>
<tr>
<td class="property_type">
<span class="type">GdkGLContext</span> *</td>
<a href="../html/GdkGLContext.html#GdkGLContext-struct"><span class="type">GdkGLContext</span></a> *</td>
<td class="property_name"><a class="link" href="GtkGLArea.html#GtkGLArea--context" title="The “context” property">context</a></td>
<td class="property_flags">Read</td>
</tr>
@ -252,7 +252,7 @@
<tbody>
<tr>
<td class="signal_type">
<span class="returnvalue">GdkGLContext</span>*</td>
<a href="../html/GdkGLContext.html#GdkGLContext-struct"><span class="returnvalue">GdkGLContext</span></a>*</td>
<td class="signal_name"><a class="link" href="GtkGLArea.html#GtkGLArea-create-context" title="The “create-context” signal">create-context</a></td>
<td class="signal_flags">Run Last</td>
</tr>
@ -310,7 +310,7 @@ GtkGLArea implements
<div class="refsect1">
<a name="GtkGLArea.description"></a><h2>Description</h2>
<p><a class="link" href="GtkGLArea.html" title="GtkGLArea"><span class="type">GtkGLArea</span></a> is a widget that allows drawing with OpenGL.</p>
<p><a class="link" href="GtkGLArea.html" title="GtkGLArea"><span class="type">GtkGLArea</span></a> sets up its own <span class="type">GdkGLContext</span> for the window it creates, and
<p><a class="link" href="GtkGLArea.html" title="GtkGLArea"><span class="type">GtkGLArea</span></a> sets up its own <a href="../html/GdkGLContext.html#GdkGLContext-struct"><span class="type">GdkGLContext</span></a> for the window it creates, and
creates a custom GL framebuffer that the widget will do GL rendering onto.
It also ensures that this framebuffer is the default GL rendering target
when rendering.</p>
@ -318,7 +318,7 @@ when rendering.</p>
or subclass <a class="link" href="GtkGLArea.html" title="GtkGLArea"><span class="type">GtkGLArea</span></a> and override the <em class="parameter"><code>GtkGLAreaClass.render()</code></em>
virtual
function.</p>
<p>The <a class="link" href="GtkGLArea.html" title="GtkGLArea"><span class="type">GtkGLArea</span></a> widget ensures that the <span class="type">GdkGLContext</span> is associated with
<p>The <a class="link" href="GtkGLArea.html" title="GtkGLArea"><span class="type">GtkGLArea</span></a> widget ensures that the <a href="../html/GdkGLContext.html#GdkGLContext-struct"><span class="type">GdkGLContext</span></a> is associated with
the widget's drawing area, and it is kept updated when the size and
position of the drawing area changes.</p>
<div class="refsect3">
@ -400,7 +400,7 @@ for you to draw its content:</p>
<p>If you need to initialize OpenGL state, e.g. buffer objects or
shaders, you should use the <a class="link" href="GtkWidget.html#GtkWidget-realize" title="The “realize” signal"><span class="type">“realize”</span></a> signal; you
can use the <a class="link" href="GtkWidget.html#GtkWidget-unrealize" title="The “unrealize” signal"><span class="type">“unrealize”</span></a> signal to clean up. Since the
<span class="type">GdkGLContext</span> creation and initialization may fail, you will
<a href="../html/GdkGLContext.html#GdkGLContext-struct"><span class="type">GdkGLContext</span></a> creation and initialization may fail, you will
need to check for errors, using <a class="link" href="GtkGLArea.html#gtk-gl-area-get-error" title="gtk_gl_area_get_error ()"><code class="function">gtk_gl_area_get_error()</code></a>. An example
of how to safely initialize the GL state is:</p>
<div class="informalexample">
@ -479,7 +479,7 @@ of how to safely initialize the GL state is:</p>
</div>
<p></p>
<p>If you need to change the options for creating the <span class="type">GdkGLContext</span>
<p>If you need to change the options for creating the <a href="../html/GdkGLContext.html#GdkGLContext-struct"><span class="type">GdkGLContext</span></a>
you should use the <a class="link" href="GtkGLArea.html#GtkGLArea-create-context" title="The “create-context” signal"><span class="type">“create-context”</span></a> signal.</p>
</div>
</div>
@ -499,9 +499,9 @@ gtk_gl_area_new (<em class="parameter"><code><span class="type">void</span></cod
<hr>
<div class="refsect2">
<a name="gtk-gl-area-get-context"></a><h3>gtk_gl_area_get_context ()</h3>
<pre class="programlisting"><span class="returnvalue">GdkGLContext</span> *
<pre class="programlisting"><a href="../html/GdkGLContext.html#GdkGLContext-struct"><span class="returnvalue">GdkGLContext</span></a> *
gtk_gl_area_get_context (<em class="parameter"><code><a class="link" href="GtkGLArea.html" title="GtkGLArea"><span class="type">GtkGLArea</span></a> *area</code></em>);</pre>
<p>Retrieves the <span class="type">GdkGLContext</span> used by <em class="parameter"><code>area</code></em>
<p>Retrieves the <a href="../html/GdkGLContext.html#GdkGLContext-struct"><span class="type">GdkGLContext</span></a> used by <em class="parameter"><code>area</code></em>
.</p>
<div class="refsect3">
<a name="gtk-gl-area-get-context.parameters"></a><h4>Parameters</h4>
@ -520,7 +520,7 @@ gtk_gl_area_get_context (<em class="parameter"><code><a class="link" href="GtkGL
</div>
<div class="refsect3">
<a name="gtk-gl-area-get-context.returns"></a><h4>Returns</h4>
<p>the <span class="type">GdkGLContext</span>. </p>
<p>the <a href="../html/GdkGLContext.html#GdkGLContext-struct"><span class="type">GdkGLContext</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: <a class="link" href="api-index-3-16.html#api-index-3.16">3.16</a></p>
@ -530,7 +530,7 @@ gtk_gl_area_get_context (<em class="parameter"><code><a class="link" href="GtkGL
<a name="gtk-gl-area-make-current"></a><h3>gtk_gl_area_make_current ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_gl_area_make_current (<em class="parameter"><code><a class="link" href="GtkGLArea.html" title="GtkGLArea"><span class="type">GtkGLArea</span></a> *area</code></em>);</pre>
<p>Ensures that the <span class="type">GdkGLContext</span> used by <em class="parameter"><code>area</code></em>
<p>Ensures that the <a href="../html/GdkGLContext.html#GdkGLContext-struct"><span class="type">GdkGLContext</span></a> used by <em class="parameter"><code>area</code></em>
is associated with
the <a class="link" href="GtkGLArea.html" title="GtkGLArea"><span class="type">GtkGLArea</span></a>.</p>
<p>This function is automatically called before emitting the
@ -1015,7 +1015,7 @@ gtk_gl_area_set_use_es (<em class="parameter"><code><a class="link" href="GtkGLA
<em class="parameter"><code><span class="type">gboolean</span> use_es</code></em>);</pre>
<p>Sets whether the <em class="parameter"><code>area</code></em>
should create an OpenGL or an OpenGL ES context.</p>
<p>You should check the capabilities of the <span class="type">GdkGLContext</span> before drawing
<p>You should check the capabilities of the <a href="../html/GdkGLContext.html#GdkGLContext-struct"><span class="type">GdkGLContext</span></a> before drawing
with either API.</p>
<div class="refsect3">
<a name="gtk-gl-area-set-use-es.parameters"></a><h4>Parameters</h4>
@ -1141,9 +1141,9 @@ to redraw.</p>
<hr>
<div class="refsect2">
<a name="GtkGLArea--context"></a><h3>The <code class="literal">“context”</code> property</h3>
<pre class="programlisting"> “context” <span class="type">GdkGLContext</span> *</pre>
<p>The <span class="type">GdkGLContext</span> used by the <a class="link" href="GtkGLArea.html" title="GtkGLArea"><span class="type">GtkGLArea</span></a> widget.</p>
<p>The <a class="link" href="GtkGLArea.html" title="GtkGLArea"><span class="type">GtkGLArea</span></a> widget is responsible for creating the <span class="type">GdkGLContext</span>
<pre class="programlisting"> “context” <a href="../html/GdkGLContext.html#GdkGLContext-struct"><span class="type">GdkGLContext</span></a> *</pre>
<p>The <a href="../html/GdkGLContext.html#GdkGLContext-struct"><span class="type">GdkGLContext</span></a> used by the <a class="link" href="GtkGLArea.html" title="GtkGLArea"><span class="type">GtkGLArea</span></a> widget.</p>
<p>The <a class="link" href="GtkGLArea.html" title="GtkGLArea"><span class="type">GtkGLArea</span></a> widget is responsible for creating the <a href="../html/GdkGLContext.html#GdkGLContext-struct"><span class="type">GdkGLContext</span></a>
instance. If you need to render with other kinds of buffers (stencil,
depth, etc), use render buffers.</p>
<p>Flags: Read</p>
@ -1186,9 +1186,9 @@ target framebuffer.</p>
<div class="refsect2">
<a name="GtkGLArea--use-es"></a><h3>The <code class="literal">“use-es”</code> property</h3>
<pre class="programlisting"> “use-es” <span class="type">gboolean</span></pre>
<p>If set to <code class="literal">TRUE</code> the widget will try to create a <span class="type">GdkGLContext</span> using
<p>If set to <code class="literal">TRUE</code> the widget will try to create a <a href="../html/GdkGLContext.html#GdkGLContext-struct"><span class="type">GdkGLContext</span></a> using
OpenGL ES instead of OpenGL.</p>
<p>See also: <code class="function">gdk_gl_context_set_use_es()</code></p>
<p>See also: <a href="../html/GdkGLContext.html#gdk-gl-context-set-use-es"><code class="function">gdk_gl_context_set_use_es()</code></a></p>
<p>Flags: Read / Write</p>
<p>Default value: FALSE</p>
<p class="since">Since: <a class="link" href="api-index-3-22.html#api-index-3.22">3.22</a></p>
@ -1198,7 +1198,7 @@ OpenGL ES instead of OpenGL.</p>
<a name="GtkGLArea.signal-details"></a><h2>Signal Details</h2>
<div class="refsect2">
<a name="GtkGLArea-create-context"></a><h3>The <code class="literal">“create-context”</code> signal</h3>
<pre class="programlisting"><span class="returnvalue">GdkGLContext</span>*
<pre class="programlisting"><a href="../html/GdkGLContext.html#GdkGLContext-struct"><span class="returnvalue">GdkGLContext</span></a>*
user_function (<a class="link" href="GtkGLArea.html" title="GtkGLArea"><span class="type">GtkGLArea</span></a> *area,
<span class="type">gpointer</span> user_data)</pre>
<p>The ::create-context signal is emitted when the widget is being
@ -1238,7 +1238,7 @@ of how the construction failed.</p>
</div>
<div class="refsect3">
<a name="GtkGLArea-create-context.returns"></a><h4>Returns</h4>
<p>a newly created <span class="type">GdkGLContext</span>;
<p>a newly created <a href="../html/GdkGLContext.html#GdkGLContext-struct"><span class="type">GdkGLContext</span></a>;
the <a class="link" href="GtkGLArea.html" title="GtkGLArea"><span class="type">GtkGLArea</span></a> widget will take ownership of the returned value. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
@ -1250,7 +1250,7 @@ the <a class="link" href="GtkGLArea.html" title="GtkGLArea"><span class="type">G
<a name="GtkGLArea-render"></a><h3>The <code class="literal">“render”</code> signal</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
user_function (<a class="link" href="GtkGLArea.html" title="GtkGLArea"><span class="type">GtkGLArea</span></a> *area,
<span class="type">GdkGLContext</span> *context,
<a href="../html/GdkGLContext.html#GdkGLContext-struct"><span class="type">GdkGLContext</span></a> *context,
<span class="type">gpointer</span> user_data)</pre>
<p>The ::render signal is emitted every time the contents
of the <a class="link" href="GtkGLArea.html" title="GtkGLArea"><span class="type">GtkGLArea</span></a> should be redrawn.</p>
@ -1274,7 +1274,7 @@ and the buffers are painted to the window once the emission terminates.</p>
</tr>
<tr>
<td class="parameter_name"><p>context</p></td>
<td class="parameter_description"><p>the <span class="type">GdkGLContext</span> used by <em class="parameter"><code>area</code></em>
<td class="parameter_description"><p>the <a href="../html/GdkGLContext.html#GdkGLContext-struct"><span class="type">GdkGLContext</span></a> used by <em class="parameter"><code>area</code></em>
</p></td>
<td class="parameter_annotations"> </td>
</tr>

96
docs/reference/gtk/html/GtkGesture.html
View File

@ -44,7 +44,7 @@
<tbody>
<tr>
<td class="function_type">
<span class="returnvalue">GdkDevice</span> *
<a href="../html/GdkDevice.html#GdkDevice-struct"><span class="returnvalue">GdkDevice</span></a> *
</td>
<td class="function_name">
<a class="link" href="GtkGesture.html#gtk-gesture-get-device" title="gtk_gesture_get_device ()">gtk_gesture_get_device</a> <span class="c_punctuation">()</span>
@ -52,7 +52,7 @@
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">GdkWindow</span> *
<a href="../html/gdk3-Windows.html#GdkWindow-struct"><span class="returnvalue">GdkWindow</span></a> *
</td>
<td class="function_name">
<a class="link" href="GtkGesture.html#gtk-gesture-get-window" title="gtk_gesture_get_window ()">gtk_gesture_get_window</a> <span class="c_punctuation">()</span>
@ -124,14 +124,14 @@
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">GdkEventSequence</span> *
<a href="../html/gdk3-Events.html#GdkEventSequence"><span class="returnvalue">GdkEventSequence</span></a> *
</td>
<td class="function_name">
<a class="link" href="GtkGesture.html#gtk-gesture-get-last-updated-sequence" title="gtk_gesture_get_last_updated_sequence ()">gtk_gesture_get_last_updated_sequence</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">const <span class="returnvalue">GdkEvent</span> *
<td class="function_type">const <a href="../html/gdk3-Event-Structures.html#GdkEvent"><span class="returnvalue">GdkEvent</span></a> *
</td>
<td class="function_name">
<a class="link" href="GtkGesture.html#gtk-gesture-get-last-event" title="gtk_gesture_get_last_event ()">gtk_gesture_get_last_event</a> <span class="c_punctuation">()</span>
@ -212,7 +212,7 @@
</tr>
<tr>
<td class="property_type">
<span class="type">GdkWindow</span> *</td>
<a href="../html/gdk3-Windows.html#GdkWindow-struct"><span class="type">GdkWindow</span></a> *</td>
<td class="property_name"><a class="link" href="GtkGesture.html#GtkGesture--window" title="The “window” property">window</a></td>
<td class="property_flags">Read / Write</td>
</tr>
@ -295,7 +295,7 @@
<p><a class="link" href="GtkGesture.html" title="GtkGesture"><span class="type">GtkGesture</span></a> is the base object for gesture recognition, although this
object is quite generalized to serve as a base for multi-touch gestures,
it is suitable to implement single-touch and pointer-based gestures (using
the special <code class="literal">NULL</code> <span class="type">GdkEventSequence</span> value for these).</p>
the special <code class="literal">NULL</code> <a href="../html/gdk3-Events.html#GdkEventSequence"><span class="type">GdkEventSequence</span></a> value for these).</p>
<p>The number of touches that a <a class="link" href="GtkGesture.html" title="GtkGesture"><span class="type">GtkGesture</span></a> need to be recognized is controlled
by the <a class="link" href="GtkGesture.html#GtkGesture--n-points" title="The “n-points” property"><span class="type">“n-points”</span></a> property, if a gesture is keeping track of less
or more than that number of sequences, it won't check wether the gesture
@ -332,7 +332,7 @@ a chance to interact with events that have not been handled yet.</p>
<a href="GtkGesture.html#GtkGesture-struct"><span class="type">GtkGestures</span></a>, both across the parents of the widget receiving the event and
in parallel within an individual widget. It is a responsibility of the
widgets using those gestures to set the state of touch sequences accordingly
in order to enable cooperation of gestures around the <span class="type">GdkEventSequences</span>
in order to enable cooperation of gestures around the <a href="../html/gdk3-Events.html#GdkEventSequence"><span class="type">GdkEventSequences</span></a>
triggering those.</p>
<p>Within a widget, gestures can be grouped through <a class="link" href="GtkGesture.html#gtk-gesture-group" title="gtk_gesture_group ()"><code class="function">gtk_gesture_group()</code></a>,
grouped gestures synchronize the state of sequences, so calling
@ -356,13 +356,13 @@ propagation chain.</p></li>
<li class="listitem"><p>Stopping event propagation after the gesture group handles the event.</p></li>
</ul></div>
<p>Note: if a sequence is set early to <a class="link" href="GtkGesture.html#GTK-EVENT-SEQUENCE-CLAIMED:CAPS"><span class="type">GTK_EVENT_SEQUENCE_CLAIMED</span></a> on
<span class="type">GDK_TOUCH_BEGIN</span>/<span class="type">GDK_BUTTON_PRESS</span> (so those events are captured before
<a href="../html/gdk3-Events.html#GDK-TOUCH-BEGIN:CAPS"><span class="type">GDK_TOUCH_BEGIN</span></a>/<a href="../html/gdk3-Events.html#GDK-BUTTON-PRESS:CAPS"><span class="type">GDK_BUTTON_PRESS</span></a> (so those events are captured before
reaching the event widget, this implies <a class="link" href="GtkEventController.html#GTK-PHASE-CAPTURE:CAPS"><span class="type">GTK_PHASE_CAPTURE</span></a>), one similar
event will emulated if the sequence changes to <a class="link" href="GtkGesture.html#GTK-EVENT-SEQUENCE-DENIED:CAPS"><span class="type">GTK_EVENT_SEQUENCE_DENIED</span></a>.
This way event coherence is preserved before event propagation is unstopped
again.</p>
<p>Sequence states can't be changed freely, see <a class="link" href="GtkGesture.html#gtk-gesture-set-sequence-state" title="gtk_gesture_set_sequence_state ()"><code class="function">gtk_gesture_set_sequence_state()</code></a>
to know about the possible lifetimes of a <span class="type">GdkEventSequence</span>.</p>
to know about the possible lifetimes of a <a href="../html/gdk3-Events.html#GdkEventSequence"><span class="type">GdkEventSequence</span></a>.</p>
</div>
<div class="refsect3">
<a name="id-1.3.24.6.9.9"></a><h4>Touchpad gestures</h4>
@ -370,9 +370,9 @@ to know about the possible lifetimes of a <span class="type">GdkEventSequence</s
touchpad gesture events. The only precautions users of <a class="link" href="GtkGesture.html" title="GtkGesture"><span class="type">GtkGesture</span></a> should do
to enable this support are:</p>
<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; ">
<li class="listitem"><p>Enabling <code class="literal">GDK_TOUCHPAD_GESTURE_MASK</code> on their <span class="type">GdkWindows</span></p></li>
<li class="listitem"><p>Enabling <a href="../html/gdk3-Events.html#GDK-TOUCHPAD-GESTURE-MASK:CAPS"><code class="literal">GDK_TOUCHPAD_GESTURE_MASK</code></a> on their <a href="../html/gdk3-Windows.html#GdkWindow-struct"><span class="type">GdkWindows</span></a></p></li>
<li class="listitem"><p>If the gesture has <a class="link" href="GtkEventController.html#GTK-PHASE-NONE:CAPS"><code class="literal">GTK_PHASE_NONE</code></a>, ensuring events of type
<code class="literal">GDK_TOUCHPAD_SWIPE</code> and <code class="literal">GDK_TOUCHPAD_PINCH</code> are handled by the <a class="link" href="GtkGesture.html" title="GtkGesture"><span class="type">GtkGesture</span></a></p></li>
<a href="../html/gdk3-Events.html#GDK-TOUCHPAD-SWIPE:CAPS"><code class="literal">GDK_TOUCHPAD_SWIPE</code></a> and <a href="../html/gdk3-Events.html#GDK-TOUCHPAD-PINCH:CAPS"><code class="literal">GDK_TOUCHPAD_PINCH</code></a> are handled by the <a class="link" href="GtkGesture.html" title="GtkGesture"><span class="type">GtkGesture</span></a></p></li>
</ul></div>
</div>
</div>
@ -380,9 +380,9 @@ to enable this support are:</p>
<a name="GtkGesture.functions_details"></a><h2>Functions</h2>
<div class="refsect2">
<a name="gtk-gesture-get-device"></a><h3>gtk_gesture_get_device ()</h3>
<pre class="programlisting"><span class="returnvalue">GdkDevice</span> *
<pre class="programlisting"><a href="../html/GdkDevice.html#GdkDevice-struct"><span class="returnvalue">GdkDevice</span></a> *
gtk_gesture_get_device (<em class="parameter"><code><a class="link" href="GtkGesture.html" title="GtkGesture"><span class="type">GtkGesture</span></a> *gesture</code></em>);</pre>
<p>Returns the master <span class="type">GdkDevice</span> that is currently operating
<p>Returns the master <a href="../html/GdkDevice.html#GdkDevice-struct"><span class="type">GdkDevice</span></a> that is currently operating
on <em class="parameter"><code>gesture</code></em>
, or <code class="literal">NULL</code> if the gesture is not being interacted.</p>
<div class="refsect3">
@ -402,7 +402,7 @@ on <em class="parameter"><code>gesture</code></em>
</div>
<div class="refsect3">
<a name="gtk-gesture-get-device.returns"></a><h4>Returns</h4>
<p>a <span class="type">GdkDevice</span>, or <code class="literal">NULL</code>. </p>
<p>a <a href="../html/GdkDevice.html#GdkDevice-struct"><span class="type">GdkDevice</span></a>, or <code class="literal">NULL</code>. </p>
<p><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>][<acronym title="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-14.html#api-index-3.14">3.14</a></p>
@ -410,7 +410,7 @@ on <em class="parameter"><code>gesture</code></em>
<hr>
<div class="refsect2">
<a name="gtk-gesture-get-window"></a><h3>gtk_gesture_get_window ()</h3>
<pre class="programlisting"><span class="returnvalue">GdkWindow</span> *
<pre class="programlisting"><a href="../html/gdk3-Windows.html#GdkWindow-struct"><span class="returnvalue">GdkWindow</span></a> *
gtk_gesture_get_window (<em class="parameter"><code><a class="link" href="GtkGesture.html" title="GtkGesture"><span class="type">GtkGesture</span></a> *gesture</code></em>);</pre>
<p>Returns the user-defined window that receives the events
handled by <em class="parameter"><code>gesture</code></em>
@ -443,7 +443,7 @@ information.</p>
<a name="gtk-gesture-set-window"></a><h3>gtk_gesture_set_window ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_gesture_set_window (<em class="parameter"><code><a class="link" href="GtkGesture.html" title="GtkGesture"><span class="type">GtkGesture</span></a> *gesture</code></em>,
<em class="parameter"><code><span class="type">GdkWindow</span> *window</code></em>);</pre>
<em class="parameter"><code><a href="../html/gdk3-Windows.html#GdkWindow-struct"><span class="type">GdkWindow</span></a> *window</code></em>);</pre>
<p>Sets a specific window to receive events about, so <em class="parameter"><code>gesture</code></em>
will effectively handle only events targeting <em class="parameter"><code>window</code></em>
@ -466,7 +466,7 @@ a child of it. <em class="parameter"><code>window</code></em>
</tr>
<tr>
<td class="parameter_name"><p>window</p></td>
<td class="parameter_description"><p>a <span class="type">GdkWindow</span>, or <code class="literal">NULL</code>. </p></td>
<td class="parameter_description"><p>a <a href="../html/gdk3-Windows.html#GdkWindow-struct"><span class="type">GdkWindow</span></a>, or <code class="literal">NULL</code>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
</tbody>
@ -539,7 +539,7 @@ returned <code class="literal">TRUE</code> for the sequences being currently int
<a name="gtk-gesture-get-sequence-state"></a><h3>gtk_gesture_get_sequence_state ()</h3>
<pre class="programlisting"><a class="link" href="GtkGesture.html#GtkEventSequenceState" title="enum GtkEventSequenceState"><span class="returnvalue">GtkEventSequenceState</span></a>
gtk_gesture_get_sequence_state (<em class="parameter"><code><a class="link" href="GtkGesture.html" title="GtkGesture"><span class="type">GtkGesture</span></a> *gesture</code></em>,
<em class="parameter"><code><span class="type">GdkEventSequence</span> *sequence</code></em>);</pre>
<em class="parameter"><code><a href="../html/gdk3-Events.html#GdkEventSequence"><span class="type">GdkEventSequence</span></a> *sequence</code></em>);</pre>
<p>Returns the <em class="parameter"><code>sequence</code></em>
state, as seen by <em class="parameter"><code>gesture</code></em>
.</p>
@ -559,7 +559,7 @@ gtk_gesture_get_sequence_state (<em class="parameter"><code><a class="link" href
</tr>
<tr>
<td class="parameter_name"><p>sequence</p></td>
<td class="parameter_description"><p>a <span class="type">GdkEventSequence</span></p></td>
<td class="parameter_description"><p>a <a href="../html/gdk3-Events.html#GdkEventSequence"><span class="type">GdkEventSequence</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
@ -577,7 +577,7 @@ gtk_gesture_get_sequence_state (<em class="parameter"><code><a class="link" href
<a name="gtk-gesture-set-sequence-state"></a><h3>gtk_gesture_set_sequence_state ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gtk_gesture_set_sequence_state (<em class="parameter"><code><a class="link" href="GtkGesture.html" title="GtkGesture"><span class="type">GtkGesture</span></a> *gesture</code></em>,
<em class="parameter"><code><span class="type">GdkEventSequence</span> *sequence</code></em>,
<em class="parameter"><code><a href="../html/gdk3-Events.html#GdkEventSequence"><span class="type">GdkEventSequence</span></a> *sequence</code></em>,
<em class="parameter"><code><a class="link" href="GtkGesture.html#GtkEventSequenceState" title="enum GtkEventSequenceState"><span class="type">GtkEventSequenceState</span></a> state</code></em>);</pre>
<p>Sets the state of <em class="parameter"><code>sequence</code></em>
in <em class="parameter"><code>gesture</code></em>
@ -662,7 +662,7 @@ gesture processes the event.</p>
</tr>
<tr>
<td class="parameter_name"><p>sequence</p></td>
<td class="parameter_description"><p>a <span class="type">GdkEventSequence</span></p></td>
<td class="parameter_description"><p>a <a href="../html/gdk3-Events.html#GdkEventSequence"><span class="type">GdkEventSequence</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
@ -726,7 +726,7 @@ was changed successfully</p>
<a name="gtk-gesture-get-sequences"></a><h3>gtk_gesture_get_sequences ()</h3>
<pre class="programlisting"><span class="returnvalue">GList</span> *
gtk_gesture_get_sequences (<em class="parameter"><code><a class="link" href="GtkGesture.html" title="GtkGesture"><span class="type">GtkGesture</span></a> *gesture</code></em>);</pre>
<p>Returns the list of <span class="type">GdkEventSequences</span> currently being interpreted
<p>Returns the list of <a href="../html/gdk3-Events.html#GdkEventSequence"><span class="type">GdkEventSequences</span></a> currently being interpreted
by <em class="parameter"><code>gesture</code></em>
.</p>
<div class="refsect3">
@ -747,7 +747,7 @@ by <em class="parameter"><code>gesture</code></em>
<div class="refsect3">
<a name="gtk-gesture-get-sequences.returns"></a><h4>Returns</h4>
<p>A list
of <span class="type">GdkEventSequences</span>, the list elements are owned by GTK+
of <a href="../html/gdk3-Events.html#GdkEventSequence"><span class="type">GdkEventSequences</span></a>, the list elements are owned by GTK+
and must not be freed or modified, the list itself must be deleted
through <code class="function">g_list_free()</code>. </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> GdkEventSequence]</span></p>
@ -759,7 +759,7 @@ through <code class="function">g_list_free()</code>. </p>
<a name="gtk-gesture-handles-sequence"></a><h3>gtk_gesture_handles_sequence ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gtk_gesture_handles_sequence (<em class="parameter"><code><a class="link" href="GtkGesture.html" title="GtkGesture"><span class="type">GtkGesture</span></a> *gesture</code></em>,
<em class="parameter"><code><span class="type">GdkEventSequence</span> *sequence</code></em>);</pre>
<em class="parameter"><code><a href="../html/gdk3-Events.html#GdkEventSequence"><span class="type">GdkEventSequence</span></a> *sequence</code></em>);</pre>
<p>Returns <code class="literal">TRUE</code> if <em class="parameter"><code>gesture</code></em>
is currently handling events corresponding to
<em class="parameter"><code>sequence</code></em>
@ -780,7 +780,7 @@ gtk_gesture_handles_sequence (<em class="parameter"><code><a class="link" href="
</tr>
<tr>
<td class="parameter_name"><p>sequence</p></td>
<td class="parameter_description"><p>a <span class="type">GdkEventSequence</span> or <code class="literal">NULL</code>. </p></td>
<td class="parameter_description"><p>a <a href="../html/gdk3-Events.html#GdkEventSequence"><span class="type">GdkEventSequence</span></a> or <code class="literal">NULL</code>. </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>
</tbody>
@ -797,9 +797,9 @@ is handling <em class="parameter"><code>sequence</code></em>
<hr>
<div class="refsect2">
<a name="gtk-gesture-get-last-updated-sequence"></a><h3>gtk_gesture_get_last_updated_sequence ()</h3>
<pre class="programlisting"><span class="returnvalue">GdkEventSequence</span> *
<pre class="programlisting"><a href="../html/gdk3-Events.html#GdkEventSequence"><span class="returnvalue">GdkEventSequence</span></a> *
gtk_gesture_get_last_updated_sequence (<em class="parameter"><code><a class="link" href="GtkGesture.html" title="GtkGesture"><span class="type">GtkGesture</span></a> *gesture</code></em>);</pre>
<p>Returns the <span class="type">GdkEventSequence</span> that was last updated on <em class="parameter"><code>gesture</code></em>
<p>Returns the <a href="../html/gdk3-Events.html#GdkEventSequence"><span class="type">GdkEventSequence</span></a> that was last updated on <em class="parameter"><code>gesture</code></em>
.</p>
<div class="refsect3">
<a name="gtk-gesture-get-last-updated-sequence.parameters"></a><h4>Parameters</h4>
@ -826,9 +826,9 @@ gtk_gesture_get_last_updated_sequence (<em class="parameter"><code><a class="lin
<hr>
<div class="refsect2">
<a name="gtk-gesture-get-last-event"></a><h3>gtk_gesture_get_last_event ()</h3>
<pre class="programlisting">const <span class="returnvalue">GdkEvent</span> *
<pre class="programlisting">const <a href="../html/gdk3-Event-Structures.html#GdkEvent"><span class="returnvalue">GdkEvent</span></a> *
gtk_gesture_get_last_event (<em class="parameter"><code><a class="link" href="GtkGesture.html" title="GtkGesture"><span class="type">GtkGesture</span></a> *gesture</code></em>,
<em class="parameter"><code><span class="type">GdkEventSequence</span> *sequence</code></em>);</pre>
<em class="parameter"><code><a href="../html/gdk3-Events.html#GdkEventSequence"><span class="type">GdkEventSequence</span></a> *sequence</code></em>);</pre>
<p>Returns the last event that was processed for <em class="parameter"><code>sequence</code></em>
.</p>
<p>Note that the returned pointer is only valid as long as the <em class="parameter"><code>sequence</code></em>
@ -852,7 +852,7 @@ a copy of the event.</p>
</tr>
<tr>
<td class="parameter_name"><p>sequence</p></td>
<td class="parameter_description"><p>a <span class="type">GdkEventSequence</span>. </p></td>
<td class="parameter_description"><p>a <a href="../html/gdk3-Events.html#GdkEventSequence"><span class="type">GdkEventSequence</span></a>. </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>
</tbody>
@ -870,7 +870,7 @@ a copy of the event.</p>
<a name="gtk-gesture-get-point"></a><h3>gtk_gesture_get_point ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gtk_gesture_get_point (<em class="parameter"><code><a class="link" href="GtkGesture.html" title="GtkGesture"><span class="type">GtkGesture</span></a> *gesture</code></em>,
<em class="parameter"><code><span class="type">GdkEventSequence</span> *sequence</code></em>,
<em class="parameter"><code><a href="../html/gdk3-Events.html#GdkEventSequence"><span class="type">GdkEventSequence</span></a> *sequence</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>If <em class="parameter"><code>sequence</code></em>
@ -897,7 +897,7 @@ widget allocation.</p>
</tr>
<tr>
<td class="parameter_name"><p>sequence</p></td>
<td class="parameter_description"><p>a <span class="type">GdkEventSequence</span>, or <code class="literal">NULL</code> for pointer events. </p></td>
<td class="parameter_description"><p>a <a href="../html/gdk3-Events.html#GdkEventSequence"><span class="type">GdkEventSequence</span></a>, or <code class="literal">NULL</code> for pointer events. </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>
@ -925,7 +925,7 @@ is currently interpreted</p>
<a name="gtk-gesture-get-bounding-box"></a><h3>gtk_gesture_get_bounding_box ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gtk_gesture_get_bounding_box (<em class="parameter"><code><a class="link" href="GtkGesture.html" title="GtkGesture"><span class="type">GtkGesture</span></a> *gesture</code></em>,
<em class="parameter"><code><span class="type">GdkRectangle</span> *rect</code></em>);</pre>
<em class="parameter"><code><a href="../html/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *rect</code></em>);</pre>
<p>If there are touch sequences being currently handled by <em class="parameter"><code>gesture</code></em>
,
this function returns <code class="literal">TRUE</code> and fills in <em class="parameter"><code>rect</code></em>
@ -1023,11 +1023,11 @@ gtk_gesture_group (<em class="parameter"><code><a class="link" href="GtkGesture.
to the same group than <em class="parameter"><code>group_gesture</code></em>
. Gestures
are by default isolated in their own groups.</p>
<p>When gestures are grouped, the state of <span class="type">GdkEventSequences</span>
<p>When gestures are grouped, the state of <a href="../html/gdk3-Events.html#GdkEventSequence"><span class="type">GdkEventSequences</span></a>
is kept in sync for all of those, so calling <a class="link" href="GtkGesture.html#gtk-gesture-set-sequence-state" title="gtk_gesture_set_sequence_state ()"><code class="function">gtk_gesture_set_sequence_state()</code></a>,
on one will transfer the same value to the others.</p>
<p>Groups also perform an "implicit grabbing" of sequences, if a
<span class="type">GdkEventSequence</span> state is set to <a class="link" href="GtkGesture.html#GTK-EVENT-SEQUENCE-CLAIMED:CAPS"><span class="type">GTK_EVENT_SEQUENCE_CLAIMED</span></a> on one group,
<a href="../html/gdk3-Events.html#GdkEventSequence"><span class="type">GdkEventSequence</span></a> state is set to <a class="link" href="GtkGesture.html#GTK-EVENT-SEQUENCE-CLAIMED:CAPS"><span class="type">GTK_EVENT_SEQUENCE_CLAIMED</span></a> on one group,
every other gesture group attached to the same <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> will switch the
state for that sequence to <a class="link" href="GtkGesture.html#GTK-EVENT-SEQUENCE-DENIED:CAPS"><span class="type">GTK_EVENT_SEQUENCE_DENIED</span></a>.</p>
<div class="refsect3">
@ -1154,7 +1154,7 @@ gtk_gesture_is_grouped_with (<em class="parameter"><code><a class="link" href="G
<hr>
<div class="refsect2">
<a name="GtkEventSequenceState"></a><h3>enum GtkEventSequenceState</h3>
<p>Describes the state of a <span class="type">GdkEventSequence</span> in a <a class="link" href="GtkGesture.html" title="GtkGesture"><span class="type">GtkGesture</span></a>.</p>
<p>Describes the state of a <a href="../html/gdk3-Events.html#GdkEventSequence"><span class="type">GdkEventSequence</span></a> in a <a class="link" href="GtkGesture.html" title="GtkGesture"><span class="type">GtkGesture</span></a>.</p>
<div class="refsect3">
<a name="GtkEventSequenceState.members"></a><h4>Members</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
@ -1205,9 +1205,9 @@ gtk_gesture_is_grouped_with (<em class="parameter"><code><a class="link" href="G
<hr>
<div class="refsect2">
<a name="GtkGesture--window"></a><h3>The <code class="literal">“window”</code> property</h3>
<pre class="programlisting"> “window” <span class="type">GdkWindow</span> *</pre>
<pre class="programlisting"> “window” <a href="../html/gdk3-Windows.html#GdkWindow-struct"><span class="type">GdkWindow</span></a> *</pre>
<p>If non-<code class="literal">NULL</code>, the gesture will only listen for events that happen on
this <span class="type">GdkWindow</span>, or a child of it.</p>
this <a href="../html/gdk3-Windows.html#GdkWindow-struct"><span class="type">GdkWindow</span></a>, or a child of it.</p>
<p>Flags: Read / Write</p>
<p class="since">Since: <a class="link" href="api-index-3-14.html#api-index-3.14">3.14</a></p>
</div>
@ -1218,7 +1218,7 @@ this <span class="type">GdkWindow</span>, or a child of it.</p>
<a name="GtkGesture-begin"></a><h3>The <code class="literal">“begin”</code> signal</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
user_function (<a class="link" href="GtkGesture.html" title="GtkGesture"><span class="type">GtkGesture</span></a> *gesture,
<span class="type">GdkEventSequence</span> *sequence,
<a href="../html/gdk3-Events.html#GdkEventSequence"><span class="type">GdkEventSequence</span></a> *sequence,
<span class="type">gpointer</span> user_data)</pre>
<p>This signal is emitted when the gesture is recognized. This means the
number of touch sequences matches <a class="link" href="GtkGesture.html#GtkGesture--n-points" title="The “n-points” property"><span class="type">“n-points”</span></a>, and the <span class="type">“check”</span>
@ -1243,7 +1243,7 @@ to the current set of active touches, so don't rely on this being true.</p>
</tr>
<tr>
<td class="parameter_name"><p>sequence</p></td>
<td class="parameter_description"><p>the <span class="type">GdkEventSequence</span> that made the gesture to be recognized</p></td>
<td class="parameter_description"><p>the <a href="../html/gdk3-Events.html#GdkEventSequence"><span class="type">GdkEventSequence</span></a> that made the gesture to be recognized</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
@ -1262,7 +1262,7 @@ to the current set of active touches, so don't rely on this being true.</p>
<a name="GtkGesture-cancel"></a><h3>The <code class="literal">“cancel”</code> signal</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
user_function (<a class="link" href="GtkGesture.html" title="GtkGesture"><span class="type">GtkGesture</span></a> *gesture,
<span class="type">GdkEventSequence</span> *sequence,
<a href="../html/gdk3-Events.html#GdkEventSequence"><span class="type">GdkEventSequence</span></a> *sequence,
<span class="type">gpointer</span> user_data)</pre>
<p>This signal is emitted whenever a sequence is cancelled. This usually
happens on active touches when <a class="link" href="GtkEventController.html#gtk-event-controller-reset" title="gtk_event_controller_reset ()"><code class="function">gtk_event_controller_reset()</code></a> is called
@ -1289,7 +1289,7 @@ was claimed by parent widgets' controllers (see <a class="link" href="GtkGesture
</tr>
<tr>
<td class="parameter_name"><p>sequence</p></td>
<td class="parameter_description"><p>the <span class="type">GdkEventSequence</span> that was cancelled</p></td>
<td class="parameter_description"><p>the <a href="../html/gdk3-Events.html#GdkEventSequence"><span class="type">GdkEventSequence</span></a> that was cancelled</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
@ -1308,7 +1308,7 @@ was claimed by parent widgets' controllers (see <a class="link" href="GtkGesture
<a name="GtkGesture-end"></a><h3>The <code class="literal">“end”</code> signal</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
user_function (<a class="link" href="GtkGesture.html" title="GtkGesture"><span class="type">GtkGesture</span></a> *gesture,
<span class="type">GdkEventSequence</span> *sequence,
<a href="../html/gdk3-Events.html#GdkEventSequence"><span class="type">GdkEventSequence</span></a> *sequence,
<span class="type">gpointer</span> user_data)</pre>
<p>This signal is emitted when <em class="parameter"><code>gesture</code></em>
either stopped recognizing the event
@ -1337,7 +1337,7 @@ by checking through <a class="link" href="GtkGesture.html#gtk-gesture-handles-se
</tr>
<tr>
<td class="parameter_name"><p>sequence</p></td>
<td class="parameter_description"><p>the <span class="type">GdkEventSequence</span> that made gesture recognition to finish</p></td>
<td class="parameter_description"><p>the <a href="../html/gdk3-Events.html#GdkEventSequence"><span class="type">GdkEventSequence</span></a> that made gesture recognition to finish</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
@ -1356,7 +1356,7 @@ by checking through <a class="link" href="GtkGesture.html#gtk-gesture-handles-se
<a name="GtkGesture-sequence-state-changed"></a><h3>The <code class="literal">“sequence-state-changed”</code> signal</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
user_function (<a class="link" href="GtkGesture.html" title="GtkGesture"><span class="type">GtkGesture</span></a> *gesture,
<span class="type">GdkEventSequence</span> *sequence,
<a href="../html/gdk3-Events.html#GdkEventSequence"><span class="type">GdkEventSequence</span></a> *sequence,
<a class="link" href="GtkGesture.html#GtkEventSequenceState" title="enum GtkEventSequenceState"><span class="type">GtkEventSequenceState</span></a> state,
<span class="type">gpointer</span> user_data)</pre>
<p>This signal is emitted whenever a sequence state changes. See
@ -1378,7 +1378,7 @@ sequence lifetimes.</p>
</tr>
<tr>
<td class="parameter_name"><p>sequence</p></td>
<td class="parameter_description"><p>the <span class="type">GdkEventSequence</span> that was cancelled</p></td>
<td class="parameter_description"><p>the <a href="../html/gdk3-Events.html#GdkEventSequence"><span class="type">GdkEventSequence</span></a> that was cancelled</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
@ -1402,7 +1402,7 @@ sequence lifetimes.</p>
<a name="GtkGesture-update"></a><h3>The <code class="literal">“update”</code> signal</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
user_function (<a class="link" href="GtkGesture.html" title="GtkGesture"><span class="type">GtkGesture</span></a> *gesture,
<span class="type">GdkEventSequence</span> *sequence,
<a href="../html/gdk3-Events.html#GdkEventSequence"><span class="type">GdkEventSequence</span></a> *sequence,
<span class="type">gpointer</span> user_data)</pre>
<p>This signal is emitted whenever an event is handled while the gesture is
recognized. <em class="parameter"><code>sequence</code></em>
@ -1423,7 +1423,7 @@ recognized. <em class="parameter"><code>sequence</code></em>
</tr>
<tr>
<td class="parameter_name"><p>sequence</p></td>
<td class="parameter_description"><p>the <span class="type">GdkEventSequence</span> that was updated</p></td>
<td class="parameter_description"><p>the <a href="../html/gdk3-Events.html#GdkEventSequence"><span class="type">GdkEventSequence</span></a> that was updated</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>

4
docs/reference/gtk/html/GtkGestureMultiPress.html
View File

@ -168,7 +168,7 @@ presses.</p>
<a name="gtk-gesture-multi-press-set-area"></a><h3>gtk_gesture_multi_press_set_area ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_gesture_multi_press_set_area (<em class="parameter"><code><a class="link" href="GtkGestureMultiPress.html" title="GtkGestureMultiPress"><span class="type">GtkGestureMultiPress</span></a> *gesture</code></em>,
<em class="parameter"><code>const <span class="type">GdkRectangle</span> *rect</code></em>);</pre>
<em class="parameter"><code>const <a href="../html/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *rect</code></em>);</pre>
<p>If <em class="parameter"><code>rect</code></em>
is non-<code class="literal">NULL</code>, the press area will be checked to be
confined within the rectangle, otherwise the button count
@ -208,7 +208,7 @@ akin to an input shape.</p>
<a name="gtk-gesture-multi-press-get-area"></a><h3>gtk_gesture_multi_press_get_area ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gtk_gesture_multi_press_get_area (<em class="parameter"><code><a class="link" href="GtkGestureMultiPress.html" title="GtkGestureMultiPress"><span class="type">GtkGestureMultiPress</span></a> *gesture</code></em>,
<em class="parameter"><code><span class="type">GdkRectangle</span> *rect</code></em>);</pre>
<em class="parameter"><code><a href="../html/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *rect</code></em>);</pre>
<p>If an area was set through <a class="link" href="GtkGestureMultiPress.html#gtk-gesture-multi-press-set-area" title="gtk_gesture_multi_press_set_area ()"><code class="function">gtk_gesture_multi_press_set_area()</code></a>,
this function will return <code class="literal">TRUE</code> and fill in <em class="parameter"><code>rect</code></em>
with the

8
docs/reference/gtk/html/GtkGestureSingle.html
View File

@ -99,7 +99,7 @@
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">GdkEventSequence</span> *
<a href="../html/gdk3-Events.html#GdkEventSequence"><span class="returnvalue">GdkEventSequence</span></a> *
</td>
<td class="function_name">
<a class="link" href="GtkGestureSingle.html#gtk-gesture-single-get-current-sequence" title="gtk_gesture_single_get_current_sequence ()">gtk_gesture_single_get_current_sequence</a> <span class="c_punctuation">()</span>
@ -173,7 +173,7 @@ not restricted) for dealing with mouse and single-touch gestures. Under
interaction, these gestures stick to the first interacting sequence, which
is accessible through <a class="link" href="GtkGestureSingle.html#gtk-gesture-single-get-current-sequence" title="gtk_gesture_single_get_current_sequence ()"><code class="function">gtk_gesture_single_get_current_sequence()</code></a> while the
gesture is being interacted with.</p>
<p>By default gestures react to both <code class="literal">GDK_BUTTON_PRIMARY</code> and touch
<p>By default gestures react to both <a href="../html/gdk3-Events.html#GDK-BUTTON-PRIMARY:CAPS"><code class="literal">GDK_BUTTON_PRIMARY</code></a> and touch
events, <a class="link" href="GtkGestureSingle.html#gtk-gesture-single-set-touch-only" title="gtk_gesture_single_set_touch_only ()"><code class="function">gtk_gesture_single_set_touch_only()</code></a> can be used to change the
touch behavior. Callers may also specify a different mouse button number
to interact with through <a class="link" href="GtkGestureSingle.html#gtk-gesture-single-set-button" title="gtk_gesture_single_set_button ()"><code class="function">gtk_gesture_single_set_button()</code></a>, or react to any
@ -281,7 +281,7 @@ gtk_gesture_single_set_touch_only (<em class="parameter"><code><a class="link" h
<p>If <em class="parameter"><code>touch_only</code></em>
is <code class="literal">TRUE</code>, <em class="parameter"><code>gesture</code></em>
will only handle events of type
<span class="type">GDK_TOUCH_BEGIN</span>, <span class="type">GDK_TOUCH_UPDATE</span> or <span class="type">GDK_TOUCH_END</span>. If <code class="literal">FALSE</code>,
<a href="../html/gdk3-Events.html#GDK-TOUCH-BEGIN:CAPS"><span class="type">GDK_TOUCH_BEGIN</span></a>, <a href="../html/gdk3-Events.html#GDK-TOUCH-UPDATE:CAPS"><span class="type">GDK_TOUCH_UPDATE</span></a> or <a href="../html/gdk3-Events.html#GDK-TOUCH-END:CAPS"><span class="type">GDK_TOUCH_END</span></a>. If <code class="literal">FALSE</code>,
mouse events will be handled too.</p>
<div class="refsect3">
<a name="gtk-gesture-single-set-touch-only.parameters"></a><h4>Parameters</h4>
@ -404,7 +404,7 @@ is none.</p>
<hr>
<div class="refsect2">
<a name="gtk-gesture-single-get-current-sequence"></a><h3>gtk_gesture_single_get_current_sequence ()</h3>
<pre class="programlisting"><span class="returnvalue">GdkEventSequence</span> *
<pre class="programlisting"><a href="../html/gdk3-Events.html#GdkEventSequence"><span class="returnvalue">GdkEventSequence</span></a> *
gtk_gesture_single_get_current_sequence
(<em class="parameter"><code><a class="link" href="GtkGestureSingle.html" title="GtkGestureSingle"><span class="type">GtkGestureSingle</span></a> *gesture</code></em>);</pre>
<p>Returns the event sequence currently interacting with <em class="parameter"><code>gesture</code></em>

6
docs/reference/gtk/html/GtkGestureStylus.html
View File

@ -173,7 +173,7 @@ gtk_gesture_stylus_new (<em class="parameter"><code><a class="link" href="GtkWid
<a name="gtk-gesture-stylus-get-axis"></a><h3>gtk_gesture_stylus_get_axis ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gtk_gesture_stylus_get_axis (<em class="parameter"><code><a class="link" href="GtkGestureStylus.html" title="GtkGestureStylus"><span class="type">GtkGestureStylus</span></a> *gesture</code></em>,
<em class="parameter"><code><span class="type">GdkAxisUse</span> axis</code></em>,
<em class="parameter"><code><a href="../html/GdkDevice.html#GdkAxisUse"><span class="type">GdkAxisUse</span></a> axis</code></em>,
<em class="parameter"><code><span class="type">gdouble</span> *value</code></em>);</pre>
<p>Returns the current value for the requested <em class="parameter"><code>axis</code></em>
. This function
@ -218,7 +218,7 @@ signals.</p>
<a name="gtk-gesture-stylus-get-axes"></a><h3>gtk_gesture_stylus_get_axes ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gtk_gesture_stylus_get_axes (<em class="parameter"><code><a class="link" href="GtkGestureStylus.html" title="GtkGestureStylus"><span class="type">GtkGestureStylus</span></a> *gesture</code></em>,
<em class="parameter"><code><span class="type">GdkAxisUse</span> axes[]</code></em>,
<em class="parameter"><code><a href="../html/GdkDevice.html#GdkAxisUse"><span class="type">GdkAxisUse</span></a> axes[]</code></em>,
<em class="parameter"><code><span class="type">gdouble</span> **values</code></em>);</pre>
<p>Returns the current values for the requested <em class="parameter"><code>axes</code></em>
. This function
@ -241,7 +241,7 @@ signals.</p>
</tr>
<tr>
<td class="parameter_name"><p>axes</p></td>
<td class="parameter_description"><p>array of requested axes, terminated with <span class="type">GDK_AXIS_IGNORE</span>. </p></td>
<td class="parameter_description"><p>array of requested axes, terminated with <a href="../html/GdkDevice.html#GDK-AXIS-IGNORE:CAPS"><span class="type">GDK_AXIS_IGNORE</span></a>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym>]</span></td>
</tr>
<tr>

8
docs/reference/gtk/html/GtkIMContext.html
View File

@ -341,9 +341,9 @@ in order for the new input method to become available to GTK+ applications.</p>
<a name="gtk-im-context-set-client-window"></a><h3>gtk_im_context_set_client_window ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_im_context_set_client_window (<em class="parameter"><code><a class="link" href="GtkIMContext.html" title="GtkIMContext"><span class="type">GtkIMContext</span></a> *context</code></em>,
<em class="parameter"><code><span class="type">GdkWindow</span> *window</code></em>);</pre>
<em class="parameter"><code><a href="../html/gdk3-Windows.html#GdkWindow-struct"><span class="type">GdkWindow</span></a> *window</code></em>);</pre>
<p>Set the client window for the input context; this is the
<span class="type">GdkWindow</span> in which the input appears. This window is
<a href="../html/gdk3-Windows.html#GdkWindow-struct"><span class="type">GdkWindow</span></a> in which the input appears. This window is
used in order to correctly position status windows, and may
also be used for purposes internal to the input method.</p>
<div class="refsect3">
@ -424,7 +424,7 @@ within the preedit string. </p></td>
<a name="gtk-im-context-filter-keypress"></a><h3>gtk_im_context_filter_keypress ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gtk_im_context_filter_keypress (<em class="parameter"><code><a class="link" href="GtkIMContext.html" title="GtkIMContext"><span class="type">GtkIMContext</span></a> *context</code></em>,
<em class="parameter"><code><span class="type">GdkEventKey</span> *event</code></em>);</pre>
<em class="parameter"><code><a href="../html/gdk3-Event-Structures.html#GdkEventKey"><span class="type">GdkEventKey</span></a> *event</code></em>);</pre>
<p>Allow an input method to internally handle key press and release
events. If this function returns <code class="literal">TRUE</code>, then no further processing
should be done for this key event.</p>
@ -534,7 +534,7 @@ method to clear the preedit state.</p>
<a name="gtk-im-context-set-cursor-location"></a><h3>gtk_im_context_set_cursor_location ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_im_context_set_cursor_location (<em class="parameter"><code><a class="link" href="GtkIMContext.html" title="GtkIMContext"><span class="type">GtkIMContext</span></a> *context</code></em>,
<em class="parameter"><code>const <span class="type">GdkRectangle</span> *area</code></em>);</pre>
<em class="parameter"><code>const <a href="../html/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *area</code></em>);</pre>
<p>Notify the input method that a change in cursor
position has been made. The location is relative to the client
window.</p>

60
docs/reference/gtk/html/GtkIconTheme.html
View File

@ -536,7 +536,7 @@ or stock items, rather than directly, but looking up icons
directly is also simple. The <a class="link" href="GtkIconTheme.html" title="GtkIconTheme"><span class="type">GtkIconTheme</span></a> object acts
as a database of all the icons in the current theme. You
can create new <a class="link" href="GtkIconTheme.html" title="GtkIconTheme"><span class="type">GtkIconTheme</span></a> objects, but it’s much more
efficient to use the standard icon theme for the <span class="type">GdkScreen</span>
efficient to use the standard icon theme for the <a href="../html/GdkScreen.html#GdkScreen-struct"><span class="type">GdkScreen</span></a>
so that the icon information is shared with other people
looking up icons.</p>
<div class="informalexample">
@ -628,7 +628,7 @@ is open. Do not ref or unref it. </p>
<div class="refsect2">
<a name="gtk-icon-theme-get-for-screen"></a><h3>gtk_icon_theme_get_for_screen ()</h3>
<pre class="programlisting"><a class="link" href="GtkIconTheme.html" title="GtkIconTheme"><span class="returnvalue">GtkIconTheme</span></a> *
gtk_icon_theme_get_for_screen (<em class="parameter"><code><span class="type">GdkScreen</span> *screen</code></em>);</pre>
gtk_icon_theme_get_for_screen (<em class="parameter"><code><a href="../html/GdkScreen.html#GdkScreen-struct"><span class="type">GdkScreen</span></a> *screen</code></em>);</pre>
<p>Gets the icon theme object associated with <em class="parameter"><code>screen</code></em>
; if this
function has not previously been called for the given
@ -648,7 +648,7 @@ a single icon theme object will be shared between users.</p>
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>screen</p></td>
<td class="parameter_description"><p>a <span class="type">GdkScreen</span></p></td>
<td class="parameter_description"><p>a <a href="../html/GdkScreen.html#GdkScreen-struct"><span class="type">GdkScreen</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
@ -668,7 +668,7 @@ is open. Do not ref or unref it. </p>
<a name="gtk-icon-theme-set-screen"></a><h3>gtk_icon_theme_set_screen ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_icon_theme_set_screen (<em class="parameter"><code><a class="link" href="GtkIconTheme.html" title="GtkIconTheme"><span class="type">GtkIconTheme</span></a> *icon_theme</code></em>,
<em class="parameter"><code><span class="type">GdkScreen</span> *screen</code></em>);</pre>
<em class="parameter"><code><a href="../html/GdkScreen.html#GdkScreen-struct"><span class="type">GdkScreen</span></a> *screen</code></em>);</pre>
<p>Sets the screen for an icon theme; the screen is used
to track the user’s currently configured icon theme,
which might be different for different screens.</p>
@ -688,7 +688,7 @@ which might be different for different screens.</p>
</tr>
<tr>
<td class="parameter_name"><p>screen</p></td>
<td class="parameter_description"><p>a <span class="type">GdkScreen</span></p></td>
<td class="parameter_description"><p>a <a href="../html/GdkScreen.html#GdkScreen-struct"><span class="type">GdkScreen</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
@ -981,7 +981,7 @@ combines these two steps if all you need is the pixbuf.)</p>
<p>When rendering on displays with high pixel densities you should not
use a <em class="parameter"><code>size</code></em>
multiplied by the scaling factor returned by functions
like <code class="function">gdk_window_get_scale_factor()</code>. Instead, you should use
like <a href="../html/gdk3-Windows.html#gdk-window-get-scale-factor"><code class="function">gdk_window_get_scale_factor()</code></a>. Instead, you should use
<a class="link" href="GtkIconTheme.html#gtk-icon-theme-lookup-icon-for-scale" title="gtk_icon_theme_lookup_icon_for_scale ()"><code class="function">gtk_icon_theme_lookup_icon_for_scale()</code></a>, as the assets loaded
for a given scaling factor may be different.</p>
<div class="refsect3">
@ -1223,7 +1223,7 @@ into a pixbuf using <a class="link" href="GtkIconTheme.html#gtk-icon-info-load-i
<p>When rendering on displays with high pixel densities you should not
use a <em class="parameter"><code>size</code></em>
multiplied by the scaling factor returned by functions
like <code class="function">gdk_window_get_scale_factor()</code>. Instead, you should use
like <a href="../html/gdk3-Windows.html#gdk-window-get-scale-factor"><code class="function">gdk_window_get_scale_factor()</code></a>. Instead, you should use
<a class="link" href="GtkIconTheme.html#gtk-icon-theme-lookup-by-gicon-for-scale" title="gtk_icon_theme_lookup_by_gicon_for_scale ()"><code class="function">gtk_icon_theme_lookup_by_gicon_for_scale()</code></a>, as the assets loaded
for a given scaling factor may be different.</p>
<div class="refsect3">
@ -1479,7 +1479,7 @@ gtk_icon_theme_load_surface (<em class="parameter"><code><a class="link" href="G
<em class="parameter"><code>const <span class="type">gchar</span> *icon_name</code></em>,
<em class="parameter"><code><span class="type">gint</span> size</code></em>,
<em class="parameter"><code><span class="type">gint</span> scale</code></em>,
<em class="parameter"><code><span class="type">GdkWindow</span> *for_window</code></em>,
<em class="parameter"><code><a href="../html/gdk3-Windows.html#GdkWindow-struct"><span class="type">GdkWindow</span></a> *for_window</code></em>,
<em class="parameter"><code><a class="link" href="GtkIconTheme.html#GtkIconLookupFlags" title="enum GtkIconLookupFlags"><span class="type">GtkIconLookupFlags</span></a> flags</code></em>,
<em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
<p>Looks up an icon in an icon theme for a particular window scale,
@ -1522,7 +1522,7 @@ exactly this size; see <a class="link" href="GtkIconTheme.html#gtk-icon-info-loa
</tr>
<tr>
<td class="parameter_name"><p>for_window</p></td>
<td class="parameter_description"><p><span class="type">GdkWindow</span> to optimize drawing for, or <code class="literal">NULL</code>. </p></td>
<td class="parameter_description"><p><a href="../html/gdk3-Windows.html#GdkWindow-struct"><span class="type">GdkWindow</span></a> to optimize drawing for, 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>
@ -2081,7 +2081,7 @@ to the icon. </p>
<a name="gtk-icon-info-load-surface"></a><h3>gtk_icon_info_load_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> *
gtk_icon_info_load_surface (<em class="parameter"><code><a class="link" href="GtkIconTheme.html#GtkIconInfo" title="GtkIconInfo"><span class="type">GtkIconInfo</span></a> *icon_info</code></em>,
<em class="parameter"><code><span class="type">GdkWindow</span> *for_window</code></em>,
<em class="parameter"><code><a href="../html/gdk3-Windows.html#GdkWindow-struct"><span class="type">GdkWindow</span></a> *for_window</code></em>,
<em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
<p>Renders an icon previously looked up in an icon theme using
<a class="link" href="GtkIconTheme.html#gtk-icon-theme-lookup-icon" title="gtk_icon_theme_lookup_icon ()"><code class="function">gtk_icon_theme_lookup_icon()</code></a>; the size will be based on the size
@ -2110,7 +2110,7 @@ returned by this function will be scaled to the exact size.</p>
</tr>
<tr>
<td class="parameter_name"><p>for_window</p></td>
<td class="parameter_description"><p><span class="type">GdkWindow</span> to optimize drawing for, or <code class="literal">NULL</code>. </p></td>
<td class="parameter_description"><p><a href="../html/gdk3-Windows.html#GdkWindow-struct"><span class="type">GdkWindow</span></a> to optimize drawing for, 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>
@ -2229,10 +2229,10 @@ to the icon. </p>
<a name="gtk-icon-info-load-symbolic"></a><h3>gtk_icon_info_load_symbolic ()</h3>
<pre class="programlisting"><a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf-struct"><span class="returnvalue">GdkPixbuf</span></a> *
gtk_icon_info_load_symbolic (<em class="parameter"><code><a class="link" href="GtkIconTheme.html#GtkIconInfo" title="GtkIconInfo"><span class="type">GtkIconInfo</span></a> *icon_info</code></em>,
<em class="parameter"><code>const <span class="type">GdkRGBA</span> *fg</code></em>,
<em class="parameter"><code>const <span class="type">GdkRGBA</span> *success_color</code></em>,
<em class="parameter"><code>const <span class="type">GdkRGBA</span> *warning_color</code></em>,
<em class="parameter"><code>const <span class="type">GdkRGBA</span> *error_color</code></em>,
<em class="parameter"><code>const <a href="../html/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a> *fg</code></em>,
<em class="parameter"><code>const <a href="../html/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a> *success_color</code></em>,
<em class="parameter"><code>const <a href="../html/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a> *warning_color</code></em>,
<em class="parameter"><code>const <a href="../html/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a> *error_color</code></em>,
<em class="parameter"><code><span class="type">gboolean</span> *was_symbolic</code></em>,
<em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
<p>Loads an icon, modifying it to match the system colours for the foreground,
@ -2263,24 +2263,24 @@ for more information about symbolic icons.</p>
</tr>
<tr>
<td class="parameter_name"><p>fg</p></td>
<td class="parameter_description"><p>a <span class="type">GdkRGBA</span> representing the foreground color of the icon</p></td>
<td class="parameter_description"><p>a <a href="../html/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a> representing the foreground color of the icon</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>success_color</p></td>
<td class="parameter_description"><p>a <span class="type">GdkRGBA</span> representing the warning color
<td class="parameter_description"><p>a <a href="../html/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a> representing the warning color
of the icon or <code class="literal">NULL</code> to use the default color. </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>warning_color</p></td>
<td class="parameter_description"><p>a <span class="type">GdkRGBA</span> representing the warning color
<td class="parameter_description"><p>a <a href="../html/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a> representing the warning color
of the icon or <code class="literal">NULL</code> to use the default color. </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>error_color</p></td>
<td class="parameter_description"><p>a <span class="type">GdkRGBA</span> representing the error color
<td class="parameter_description"><p>a <a href="../html/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a> representing the error color
of the icon or <code class="literal">NULL</code> to use the default color (allow-none). </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>
@ -2313,10 +2313,10 @@ or <code class="literal">NULL</code>. </p></td>
<a name="gtk-icon-info-load-symbolic-async"></a><h3>gtk_icon_info_load_symbolic_async ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_icon_info_load_symbolic_async (<em class="parameter"><code><a class="link" href="GtkIconTheme.html#GtkIconInfo" title="GtkIconInfo"><span class="type">GtkIconInfo</span></a> *icon_info</code></em>,
<em class="parameter"><code>const <span class="type">GdkRGBA</span> *fg</code></em>,
<em class="parameter"><code>const <span class="type">GdkRGBA</span> *success_color</code></em>,
<em class="parameter"><code>const <span class="type">GdkRGBA</span> *warning_color</code></em>,
<em class="parameter"><code>const <span class="type">GdkRGBA</span> *error_color</code></em>,
<em class="parameter"><code>const <a href="../html/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a> *fg</code></em>,
<em class="parameter"><code>const <a href="../html/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a> *success_color</code></em>,
<em class="parameter"><code>const <a href="../html/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a> *warning_color</code></em>,
<em class="parameter"><code>const <a href="../html/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a> *error_color</code></em>,
<em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
<em class="parameter"><code><span class="type">GAsyncReadyCallback</span> callback</code></em>,
<em class="parameter"><code><span class="type">gpointer</span> user_data</code></em>);</pre>
@ -2340,24 +2340,24 @@ version of this call.</p>
</tr>
<tr>
<td class="parameter_name"><p>fg</p></td>
<td class="parameter_description"><p>a <span class="type">GdkRGBA</span> representing the foreground color of the icon</p></td>
<td class="parameter_description"><p>a <a href="../html/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a> representing the foreground color of the icon</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>success_color</p></td>
<td class="parameter_description"><p>a <span class="type">GdkRGBA</span> representing the warning color
<td class="parameter_description"><p>a <a href="../html/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a> representing the warning color
of the icon or <code class="literal">NULL</code> to use the default color. </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>warning_color</p></td>
<td class="parameter_description"><p>a <span class="type">GdkRGBA</span> representing the warning color
<td class="parameter_description"><p>a <a href="../html/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a> representing the warning color
of the icon or <code class="literal">NULL</code> to use the default color. </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>error_color</p></td>
<td class="parameter_description"><p>a <span class="type">GdkRGBA</span> representing the error color
<td class="parameter_description"><p>a <a href="../html/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a> representing the error color
of the icon or <code class="literal">NULL</code> to use the default color (allow-none). </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>
@ -2728,7 +2728,7 @@ and attached points should be returned in their original
<a name="gtk-icon-info-get-embedded-rect"></a><h3>gtk_icon_info_get_embedded_rect ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gtk_icon_info_get_embedded_rect (<em class="parameter"><code><a class="link" href="GtkIconTheme.html#GtkIconInfo" title="GtkIconInfo"><span class="type">GtkIconInfo</span></a> *icon_info</code></em>,
<em class="parameter"><code><span class="type">GdkRectangle</span> *rectangle</code></em>);</pre>
<em class="parameter"><code><a href="../html/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *rectangle</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_icon_info_get_embedded_rect</code> has been deprecated since version 3.14 and should not be used in newly-written code.</p>
<p>Embedded rectangles are deprecated</p>
@ -2750,7 +2750,7 @@ gtk_icon_info_get_embedded_rect (<em class="parameter"><code><a class="link" hre
</tr>
<tr>
<td class="parameter_name"><p>rectangle</p></td>
<td class="parameter_description"><p><span class="type">GdkRectangle</span> in which to store embedded
<td class="parameter_description"><p><a href="../html/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> in which to store embedded
rectangle coordinates; coordinates are only stored
when this function returns <code class="literal">TRUE</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>]</span></td>
@ -2769,7 +2769,7 @@ when this function returns <code class="literal">TRUE</code>. </p></td>
<a name="gtk-icon-info-get-attach-points"></a><h3>gtk_icon_info_get_attach_points ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gtk_icon_info_get_attach_points (<em class="parameter"><code><a class="link" href="GtkIconTheme.html#GtkIconInfo" title="GtkIconInfo"><span class="type">GtkIconInfo</span></a> *icon_info</code></em>,
<em class="parameter"><code><span class="type">GdkPoint</span> **points</code></em>,
<em class="parameter"><code><a href="../html/gdk3-Points-Rectangles-and-Regions.html#GdkPoint"><span class="type">GdkPoint</span></a> **points</code></em>,
<em class="parameter"><code><span class="type">gint</span> *n_points</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_icon_info_get_attach_points</code> has been deprecated since version 3.14 and should not be used in newly-written code.</p>

12
docs/reference/gtk/html/GtkIconView.html
View File

@ -682,7 +682,7 @@
</tr>
<tr>
<td class="property_type">
<span class="type">GdkColor</span> *</td>
<a href="../html/gdk3-Colors.html#GdkColor"><span class="type">GdkColor</span></a> *</td>
<td class="property_name"><a class="link" href="GtkIconView.html#GtkIconView--s-selection-box-color" title="The “selection-box-color” style property">selection-box-color</a></td>
<td class="property_flags">Read</td>
</tr>
@ -2085,7 +2085,7 @@ gtk_icon_view_get_activate_on_single_click
gtk_icon_view_get_cell_rect (<em class="parameter"><code><a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a> *icon_view</code></em>,
<em class="parameter"><code><a class="link" href="GtkTreeModel.html#GtkTreePath"><span class="type">GtkTreePath</span></a> *path</code></em>,
<em class="parameter"><code><a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> *cell</code></em>,
<em class="parameter"><code><span class="type">GdkRectangle</span> *rect</code></em>);</pre>
<em class="parameter"><code><a href="../html/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *rect</code></em>);</pre>
<p>Fills the bounding rectangle in widget coordinates for the cell specified by
<em class="parameter"><code>path</code></em>
and <em class="parameter"><code>cell</code></em>
@ -2803,10 +2803,10 @@ displayed. Column numbers start at 0.</p>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_icon_view_enable_model_drag_source
(<em class="parameter"><code><a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a> *icon_view</code></em>,
<em class="parameter"><code><span class="type">GdkModifierType</span> start_button_mask</code></em>,
<em class="parameter"><code><a href="../html/gdk3-Windows.html#GdkModifierType"><span class="type">GdkModifierType</span></a> start_button_mask</code></em>,
<em class="parameter"><code>const <a class="link" href="gtk3-Selections.html#GtkTargetEntry" title="struct GtkTargetEntry"><span class="type">GtkTargetEntry</span></a> *targets</code></em>,
<em class="parameter"><code><span class="type">gint</span> n_targets</code></em>,
<em class="parameter"><code><span class="type">GdkDragAction</span> actions</code></em>);</pre>
<em class="parameter"><code><a href="../html/gdk3-Drag-and-Drop.html#GdkDragAction"><span class="type">GdkDragAction</span></a> actions</code></em>);</pre>
<p>Turns <em class="parameter"><code>icon_view</code></em>
into a drag source for automatic DND. Calling this
method sets <a class="link" href="GtkIconView.html#GtkIconView--reorderable" title="The “reorderable” property"><span class="type">“reorderable”</span></a> to <code class="literal">FALSE</code>.</p>
@ -2859,7 +2859,7 @@ widget</p></td>
gtk_icon_view_enable_model_drag_dest (<em class="parameter"><code><a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a> *icon_view</code></em>,
<em class="parameter"><code>const <a class="link" href="gtk3-Selections.html#GtkTargetEntry" title="struct GtkTargetEntry"><span class="type">GtkTargetEntry</span></a> *targets</code></em>,
<em class="parameter"><code><span class="type">gint</span> n_targets</code></em>,
<em class="parameter"><code><span class="type">GdkDragAction</span> actions</code></em>);</pre>
<em class="parameter"><code><a href="../html/gdk3-Drag-and-Drop.html#GdkDragAction"><span class="type">GdkDragAction</span></a> actions</code></em>);</pre>
<p>Turns <em class="parameter"><code>icon_view</code></em>
into a drop destination for automatic DND. Calling this
method sets <a class="link" href="GtkIconView.html#GtkIconView--reorderable" title="The “reorderable” property"><span class="type">“reorderable”</span></a> to <code class="literal">FALSE</code>.</p>
@ -3467,7 +3467,7 @@ property are both set to -1, no texts are displayed.</p>
<hr>
<div class="refsect2">
<a name="GtkIconView--s-selection-box-color"></a><h3>The <code class="literal">“selection-box-color”</code> style property</h3>
<pre class="programlisting"> “selection-box-color” <span class="type">GdkColor</span> *</pre>
<pre class="programlisting"> “selection-box-color” <a href="../html/gdk3-Colors.html#GdkColor"><span class="type">GdkColor</span></a> *</pre>
<p>The color of the selection box.</p>
<div class="warning">
<p><code class="literal">GtkIconView:selection-box-color</code> has been deprecated since version 3.20 and should not be used in newly-written code.</p>

5
docs/reference/gtk/html/GtkImage.html
View File

@ -434,7 +434,7 @@ display an animation (<a href="http://library.gnome.org/devel/gdk-pixbuf/unstabl
<p><a class="link" href="GtkImage.html" title="GtkImage"><span class="type">GtkImage</span></a> is a subclass of <a class="link" href="GtkMisc.html" title="GtkMisc"><span class="type">GtkMisc</span></a>, which implies that you can
align it (center, left, right) and add padding to it, using
<a class="link" href="GtkMisc.html" title="GtkMisc"><span class="type">GtkMisc</span></a> methods.</p>
<p><a class="link" href="GtkImage.html" title="GtkImage"><span class="type">GtkImage</span></a> is a “no window” widget (has no <span class="type">GdkWindow</span> of its own),
<p><a class="link" href="GtkImage.html" title="GtkImage"><span class="type">GtkImage</span></a> is a “no window” widget (has no <a href="../html/gdk3-Windows.html#GdkWindow-struct"><span class="type">GdkWindow</span></a> of its own),
so by default does not receive events. If you want to receive events
on the image, such as button clicks, place the image inside a
<a class="link" href="GtkEventBox.html" title="GtkEventBox"><span class="type">GtkEventBox</span></a>, then connect to the event signals on the event box.</p>
@ -531,7 +531,8 @@ can then be loaded into a <a href="http://library.gnome.org/devel/gdk-pixbuf/uns
</div>
<div class="refsect2">
<a name="id-1.3.8.3.9.9"></a><h3>CSS nodes</h3>
<p>GtkImage has a single CSS node with the name image.</p>
<p>GtkImage has a single CSS node with the name image. The style classes
may appear on image CSS nodes: .icon-dropshadow, .lowres-icon.</p>
</div>
</div>
<div class="refsect1">

2
docs/reference/gtk/html/GtkImageMenuItem.html
View File

@ -298,7 +298,7 @@ binding of Ctrl+M:</p>
<span class="function"><a href="GtkLabel.html#gtk-label-set-xalign">gtk_label_set_xalign</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function">GTK_LABEL</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">label</span><span class="symbol">),</span><span class="normal"> </span><span class="number">0.0</span><span class="symbol">);</span>
<span class="function"><a href="GtkWidget.html#gtk-widget-add-accelerator">gtk_widget_add_accelerator</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">menu_item</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"activate"</span><span class="symbol">,</span><span class="normal"> accel_group</span><span class="symbol">,</span>
<span class="normal"> GDK_KEY_m</span><span class="symbol">,</span><span class="normal"> GDK_CONTROL_MASK</span><span class="symbol">,</span><span class="normal"> <a href="gtk3-Keyboard-Accelerators.html#GTK-ACCEL-VISIBLE:CAPS">GTK_ACCEL_VISIBLE</a></span><span class="symbol">);</span>
<span class="normal"> GDK_KEY_m</span><span class="symbol">,</span><span class="normal"> <a href="../html/gdk3-Windows.html#GDK-CONTROL-MASK:CAPS">GDK_CONTROL_MASK</a></span><span class="symbol">,</span><span class="normal"> <a href="gtk3-Keyboard-Accelerators.html#GTK-ACCEL-VISIBLE:CAPS">GTK_ACCEL_VISIBLE</a></span><span class="symbol">);</span>
<span class="function"><a href="GtkAccelLabel.html#gtk-accel-label-set-accel-widget">gtk_accel_label_set_accel_widget</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function">GTK_ACCEL_LABEL</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">label</span><span class="symbol">),</span><span class="normal"> menu_item</span><span class="symbol">);</span>
<span class="function"><a href="GtkBox.html#gtk-box-pack-end">gtk_box_pack_end</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function">GTK_BOX</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">box</span><span class="symbol">),</span><span class="normal"> label</span><span class="symbol">,</span><span class="normal"> TRUE</span><span class="symbol">,</span><span class="normal"> TRUE</span><span class="symbol">,</span><span class="normal"> </span><span class="number">0</span><span class="symbol">);</span>

22
docs/reference/gtk/html/GtkInvisible.html
View File

@ -68,7 +68,7 @@
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">GdkScreen</span> *
<a href="../html/GdkScreen.html#GdkScreen-struct"><span class="returnvalue">GdkScreen</span></a> *
</td>
<td class="function_name">
<a class="link" href="GtkInvisible.html#gtk-invisible-get-screen" title="gtk_invisible_get_screen ()">gtk_invisible_get_screen</a> <span class="c_punctuation">()</span>
@ -87,7 +87,7 @@
</colgroup>
<tbody><tr>
<td class="property_type">
<span class="type">GdkScreen</span> *</td>
<a href="../html/GdkScreen.html#GdkScreen-struct"><span class="type">GdkScreen</span></a> *</td>
<td class="property_name"><a class="link" href="GtkInvisible.html#GtkInvisible--screen" title="The “screen” property">screen</a></td>
<td class="property_flags">Read / Write</td>
</tr></tbody>
@ -148,7 +148,7 @@ gtk_invisible_new (<em class="parameter"><code><span class="type">void</span></c
<div class="refsect2">
<a name="gtk-invisible-new-for-screen"></a><h3>gtk_invisible_new_for_screen ()</h3>
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
gtk_invisible_new_for_screen (<em class="parameter"><code><span class="type">GdkScreen</span> *screen</code></em>);</pre>
gtk_invisible_new_for_screen (<em class="parameter"><code><a href="../html/GdkScreen.html#GdkScreen-struct"><span class="type">GdkScreen</span></a> *screen</code></em>);</pre>
<p>Creates a new <a class="link" href="GtkInvisible.html" title="GtkInvisible"><span class="type">GtkInvisible</span></a> object for a specified screen</p>
<div class="refsect3">
<a name="gtk-invisible-new-for-screen.parameters"></a><h4>Parameters</h4>
@ -160,7 +160,7 @@ gtk_invisible_new_for_screen (<em class="parameter"><code><span class="type">Gdk
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>screen</p></td>
<td class="parameter_description"><p>a <span class="type">GdkScreen</span> which identifies on which
<td class="parameter_description"><p>a <a href="../html/GdkScreen.html#GdkScreen-struct"><span class="type">GdkScreen</span></a> which identifies on which
the new <a class="link" href="GtkInvisible.html" title="GtkInvisible"><span class="type">GtkInvisible</span></a> will be created.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
@ -177,8 +177,8 @@ the new <a class="link" href="GtkInvisible.html" title="GtkInvisible"><span clas
<a name="gtk-invisible-set-screen"></a><h3>gtk_invisible_set_screen ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_invisible_set_screen (<em class="parameter"><code><a class="link" href="GtkInvisible.html" title="GtkInvisible"><span class="type">GtkInvisible</span></a> *invisible</code></em>,
<em class="parameter"><code><span class="type">GdkScreen</span> *screen</code></em>);</pre>
<p>Sets the <span class="type">GdkScreen</span> where the <a class="link" href="GtkInvisible.html" title="GtkInvisible"><span class="type">GtkInvisible</span></a> object will be displayed.</p>
<em class="parameter"><code><a href="../html/GdkScreen.html#GdkScreen-struct"><span class="type">GdkScreen</span></a> *screen</code></em>);</pre>
<p>Sets the <a href="../html/GdkScreen.html#GdkScreen-struct"><span class="type">GdkScreen</span></a> where the <a class="link" href="GtkInvisible.html" title="GtkInvisible"><span class="type">GtkInvisible</span></a> object will be displayed.</p>
<div class="refsect3">
<a name="gtk-invisible-set-screen.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
@ -195,7 +195,7 @@ gtk_invisible_set_screen (<em class="parameter"><code><a class="link" href="GtkI
</tr>
<tr>
<td class="parameter_name"><p>screen</p></td>
<td class="parameter_description"><p>a <span class="type">GdkScreen</span>.</p></td>
<td class="parameter_description"><p>a <a href="../html/GdkScreen.html#GdkScreen-struct"><span class="type">GdkScreen</span></a>.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
@ -206,9 +206,9 @@ gtk_invisible_set_screen (<em class="parameter"><code><a class="link" href="GtkI
<hr>
<div class="refsect2">
<a name="gtk-invisible-get-screen"></a><h3>gtk_invisible_get_screen ()</h3>
<pre class="programlisting"><span class="returnvalue">GdkScreen</span> *
<pre class="programlisting"><a href="../html/GdkScreen.html#GdkScreen-struct"><span class="returnvalue">GdkScreen</span></a> *
gtk_invisible_get_screen (<em class="parameter"><code><a class="link" href="GtkInvisible.html" title="GtkInvisible"><span class="type">GtkInvisible</span></a> *invisible</code></em>);</pre>
<p>Returns the <span class="type">GdkScreen</span> object associated with <em class="parameter"><code>invisible</code></em>
<p>Returns the <a href="../html/GdkScreen.html#GdkScreen-struct"><span class="type">GdkScreen</span></a> object associated with <em class="parameter"><code>invisible</code></em>
</p>
<div class="refsect3">
<a name="gtk-invisible-get-screen.parameters"></a><h4>Parameters</h4>
@ -227,7 +227,7 @@ gtk_invisible_get_screen (<em class="parameter"><code><a class="link" href="GtkI
</div>
<div class="refsect3">
<a name="gtk-invisible-get-screen.returns"></a><h4>Returns</h4>
<p>the associated <span class="type">GdkScreen</span>. </p>
<p>the associated <a href="../html/GdkScreen.html#GdkScreen-struct"><span class="type">GdkScreen</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.2</p>
@ -244,7 +244,7 @@ gtk_invisible_get_screen (<em class="parameter"><code><a class="link" href="GtkI
<a name="GtkInvisible.property-details"></a><h2>Property Details</h2>
<div class="refsect2">
<a name="GtkInvisible--screen"></a><h3>The <code class="literal">“screen”</code> property</h3>
<pre class="programlisting"> “screen” <span class="type">GdkScreen</span> *</pre>
<pre class="programlisting"> “screen” <a href="../html/GdkScreen.html#GdkScreen-struct"><span class="type">GdkScreen</span></a> *</pre>
<p>The screen where this window will be displayed.</p>
<p>Flags: Read / Write</p>
</div>

8
docs/reference/gtk/html/GtkLayout.html
View File

@ -118,7 +118,7 @@
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">GdkWindow</span> *
<a href="../html/gdk3-Windows.html#GdkWindow-struct"><span class="returnvalue">GdkWindow</span></a> *
</td>
<td class="function_name">
<a class="link" href="GtkLayout.html#gtk-layout-get-bin-window" title="gtk_layout_get_bin_window ()">gtk_layout_get_bin_window</a> <span class="c_punctuation">()</span>
@ -213,7 +213,7 @@ different in that it supports scrolling natively due to implementing
<p>If you just want to draw, a <a class="link" href="GtkDrawingArea.html" title="GtkDrawingArea"><span class="type">GtkDrawingArea</span></a> is a better choice since it has
lower overhead. If you just need to position child widgets at specific
points, then <a class="link" href="GtkFixed.html" title="GtkFixed"><span class="type">GtkFixed</span></a> provides that functionality on its own.</p>
<p>When handling expose events on a <a class="link" href="GtkLayout.html" title="GtkLayout"><span class="type">GtkLayout</span></a>, you must draw to the <span class="type">GdkWindow</span>
<p>When handling expose events on a <a class="link" href="GtkLayout.html" title="GtkLayout"><span class="type">GtkLayout</span></a>, you must draw to the <a href="../html/gdk3-Windows.html#GdkWindow-struct"><span class="type">GdkWindow</span></a>
returned by <a class="link" href="GtkLayout.html#gtk-layout-get-bin-window" title="gtk_layout_get_bin_window ()"><code class="function">gtk_layout_get_bin_window()</code></a>, rather than to the one returned by
<a class="link" href="GtkWidget.html#gtk-widget-get-window" title="gtk_widget_get_window ()"><code class="function">gtk_widget_get_window()</code></a> as you would for a <a class="link" href="GtkDrawingArea.html" title="GtkDrawingArea"><span class="type">GtkDrawingArea</span></a>.</p>
</div>
@ -572,7 +572,7 @@ gtk_layout_set_vadjustment (<em class="parameter"><code><a class="link" href="Gt
<hr>
<div class="refsect2">
<a name="gtk-layout-get-bin-window"></a><h3>gtk_layout_get_bin_window ()</h3>
<pre class="programlisting"><span class="returnvalue">GdkWindow</span> *
<pre class="programlisting"><a href="../html/gdk3-Windows.html#GdkWindow-struct"><span class="returnvalue">GdkWindow</span></a> *
gtk_layout_get_bin_window (<em class="parameter"><code><a class="link" href="GtkLayout.html" title="GtkLayout"><span class="type">GtkLayout</span></a> *layout</code></em>);</pre>
<p>Retrieve the bin window of the layout used for drawing operations.</p>
<div class="refsect3">
@ -592,7 +592,7 @@ gtk_layout_get_bin_window (<em class="parameter"><code><a class="link" href="Gtk
</div>
<div class="refsect3">
<a name="gtk-layout-get-bin-window.returns"></a><h4>Returns</h4>
<p>a <span class="type">GdkWindow</span>. </p>
<p>a <a href="../html/gdk3-Windows.html#GdkWindow-struct"><span class="type">GdkWindow</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.14</p>

62
docs/reference/gtk/html/GtkMenu.html
View File

@ -337,7 +337,7 @@
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type"><span class="type">GdkAnchorHints</span></td>
<td class="property_type"><a href="../html/gdk3-Windows.html#GdkAnchorHints"><span class="type">GdkAnchorHints</span></a></td>
<td class="property_name"><a class="link" href="GtkMenu.html#GtkMenu--anchor-hints" title="The “anchor-hints” property">anchor-hints</a></td>
<td class="property_flags">Read / Write / Construct</td>
</tr>
@ -348,7 +348,7 @@
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type"><span class="type">GdkWindowTypeHint</span></td>
<td class="property_type"><a href="../html/gdk3-Windows.html#GdkWindowTypeHint"><span class="type">GdkWindowTypeHint</span></a></td>
<td class="property_name"><a class="link" href="GtkMenu.html#GtkMenu--menu-type-hint" title="The “menu-type-hint” property">menu-type-hint</a></td>
<td class="property_flags">Read / Write / Construct</td>
</tr>
@ -608,10 +608,10 @@ can pop up a menu when the 3rd mouse button is pressed. </p>
<span class="normal"> </span><span class="comment">// g_signal_connect_swapped() was called.</span>
<span class="normal"> menu </span><span class="symbol">=</span><span class="normal"> </span><span class="function">GTK_MENU</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">widget</span><span class="symbol">);</span>
<span class="normal"> </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">event</span><span class="symbol">-&gt;</span><span class="normal">type </span><span class="symbol">==</span><span class="normal"> GDK_BUTTON_PRESS</span><span class="symbol">)</span>
<span class="normal"> </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">event</span><span class="symbol">-&gt;</span><span class="normal">type </span><span class="symbol">==</span><span class="normal"> <a href="../html/gdk3-Events.html#GDK-BUTTON-PRESS:CAPS">GDK_BUTTON_PRESS</a></span><span class="symbol">)</span>
<span class="normal"> </span><span class="cbracket">{</span>
<span class="normal"> event_button </span><span class="symbol">=</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">GdkEventButton </span><span class="symbol">*)</span><span class="normal"> event</span><span class="symbol">;</span>
<span class="normal"> </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">event_button</span><span class="symbol">-&gt;</span><span class="normal">button </span><span class="symbol">==</span><span class="normal"> GDK_BUTTON_SECONDARY</span><span class="symbol">)</span>
<span class="normal"> event_button </span><span class="symbol">=</span><span class="normal"> </span><span class="symbol">(</span><span class="normal"><a href="../html/gdk3-Event-Structures.html#GdkEventButton">GdkEventButton</a> </span><span class="symbol">*)</span><span class="normal"> event</span><span class="symbol">;</span>
<span class="normal"> </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">event_button</span><span class="symbol">-&gt;</span><span class="normal">button </span><span class="symbol">==</span><span class="normal"> <a href="../html/gdk3-Events.html#GDK-BUTTON-SECONDARY:CAPS">GDK_BUTTON_SECONDARY</a></span><span class="symbol">)</span>
<span class="normal"> </span><span class="cbracket">{</span>
<span class="normal"> </span><span class="function"><a href="GtkMenu.html#gtk-menu-popup">gtk_menu_popup</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">menu</span><span class="symbol">,</span><span class="normal"> NULL</span><span class="symbol">,</span><span class="normal"> NULL</span><span class="symbol">,</span><span class="normal"> NULL</span><span class="symbol">,</span><span class="normal"> NULL</span><span class="symbol">,</span><span class="normal"> </span>
<span class="normal"> event_button</span><span class="symbol">-&gt;</span><span class="normal">button</span><span class="symbol">,</span><span class="normal"> event_button</span><span class="symbol">-&gt;</span><span class="normal">time</span><span class="symbol">);</span>
@ -709,8 +709,8 @@ attach widget or on any of its parent widgets.</p>
<a name="gtk-menu-set-screen"></a><h3>gtk_menu_set_screen ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_menu_set_screen (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>,
<em class="parameter"><code><span class="type">GdkScreen</span> *screen</code></em>);</pre>
<p>Sets the <span class="type">GdkScreen</span> on which the menu will be displayed.</p>
<em class="parameter"><code><a href="../html/GdkScreen.html#GdkScreen-struct"><span class="type">GdkScreen</span></a> *screen</code></em>);</pre>
<p>Sets the <a href="../html/GdkScreen.html#GdkScreen-struct"><span class="type">GdkScreen</span></a> on which the menu will be displayed.</p>
<div class="refsect3">
<a name="gtk-menu-set-screen.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
@ -727,7 +727,7 @@ gtk_menu_set_screen (<em class="parameter"><code><a class="link" href="GtkMenu.h
</tr>
<tr>
<td class="parameter_name"><p>screen</p></td>
<td class="parameter_description"><p>a <span class="type">GdkScreen</span>, or <code class="literal">NULL</code> if the screen should be
<td class="parameter_description"><p>a <a href="../html/GdkScreen.html#GdkScreen-struct"><span class="type">GdkScreen</span></a>, or <code class="literal">NULL</code> if the screen should be
determined by the widget the menu is attached to. </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>
@ -847,11 +847,11 @@ rightmost, uppermost and lower column and row numbers of the table.
<a name="gtk-menu-popup-at-rect"></a><h3>gtk_menu_popup_at_rect ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_menu_popup_at_rect (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>,
<em class="parameter"><code><span class="type">GdkWindow</span> *rect_window</code></em>,
<em class="parameter"><code>const <span class="type">GdkRectangle</span> *rect</code></em>,
<em class="parameter"><code><span class="type">GdkGravity</span> rect_anchor</code></em>,
<em class="parameter"><code><span class="type">GdkGravity</span> menu_anchor</code></em>,
<em class="parameter"><code>const <span class="type">GdkEvent</span> *trigger_event</code></em>);</pre>
<em class="parameter"><code><a href="../html/gdk3-Windows.html#GdkWindow-struct"><span class="type">GdkWindow</span></a> *rect_window</code></em>,
<em class="parameter"><code>const <a href="../html/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *rect</code></em>,
<em class="parameter"><code><a href="../html/gdk3-Windows.html#GdkGravity"><span class="type">GdkGravity</span></a> rect_anchor</code></em>,
<em class="parameter"><code><a href="../html/gdk3-Windows.html#GdkGravity"><span class="type">GdkGravity</span></a> menu_anchor</code></em>,
<em class="parameter"><code>const <a href="../html/gdk3-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a> *trigger_event</code></em>);</pre>
<p>Displays <em class="parameter"><code>menu</code></em>
and makes it available for selection.</p>
<p>See <a class="link" href="GtkMenu.html#gtk-menu-popup-at-widget" title="gtk_menu_popup_at_widget ()"><code class="function">gtk_menu_popup_at_widget()</code></a> and <a class="link" href="GtkMenu.html#gtk-menu-popup-at-pointer" title="gtk_menu_popup_at_pointer ()"><code class="function">gtk_menu_popup_at_pointer()</code></a>, which
@ -892,13 +892,13 @@ direction is right-to-left.</p>
</tr>
<tr>
<td class="parameter_name"><p>rect_window</p></td>
<td class="parameter_description"><p>the <span class="type">GdkWindow</span> <em class="parameter"><code>rect</code></em>
<td class="parameter_description"><p>the <a href="../html/gdk3-Windows.html#GdkWindow-struct"><span class="type">GdkWindow</span></a> <em class="parameter"><code>rect</code></em>
is relative to. </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</p></td>
<td class="parameter_description"><p>the <span class="type">GdkRectangle</span> to align <em class="parameter"><code>menu</code></em>
<td class="parameter_description"><p>the <a href="../html/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> to align <em class="parameter"><code>menu</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>
@ -918,7 +918,7 @@ to align with <em class="parameter"><code>rect</code></em>
</tr>
<tr>
<td class="parameter_name"><p>trigger_event</p></td>
<td class="parameter_description"><p>the <span class="type">GdkEvent</span> that initiated this request or
<td class="parameter_description"><p>the <a href="../html/gdk3-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a> that initiated this request or
<code class="literal">NULL</code> if it's the current event. </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>
@ -933,9 +933,9 @@ to align with <em class="parameter"><code>rect</code></em>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_menu_popup_at_widget (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>,
<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>,
<em class="parameter"><code><span class="type">GdkGravity</span> widget_anchor</code></em>,
<em class="parameter"><code><span class="type">GdkGravity</span> menu_anchor</code></em>,
<em class="parameter"><code>const <span class="type">GdkEvent</span> *trigger_event</code></em>);</pre>
<em class="parameter"><code><a href="../html/gdk3-Windows.html#GdkGravity"><span class="type">GdkGravity</span></a> widget_anchor</code></em>,
<em class="parameter"><code><a href="../html/gdk3-Windows.html#GdkGravity"><span class="type">GdkGravity</span></a> menu_anchor</code></em>,
<em class="parameter"><code>const <a href="../html/gdk3-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a> *trigger_event</code></em>);</pre>
<p>Displays <em class="parameter"><code>menu</code></em>
and makes it available for selection.</p>
<p>See <a class="link" href="GtkMenu.html#gtk-menu-popup-at-pointer" title="gtk_menu_popup_at_pointer ()"><code class="function">gtk_menu_popup_at_pointer()</code></a> to pop up a menu at the master pointer.
@ -995,7 +995,7 @@ to align with <em class="parameter"><code>widget</code></em>
</tr>
<tr>
<td class="parameter_name"><p>trigger_event</p></td>
<td class="parameter_description"><p>the <span class="type">GdkEvent</span> that initiated this request or
<td class="parameter_description"><p>the <a href="../html/gdk3-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a> that initiated this request or
<code class="literal">NULL</code> if it's the current event. </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>
@ -1009,7 +1009,7 @@ to align with <em class="parameter"><code>widget</code></em>
<a name="gtk-menu-popup-at-pointer"></a><h3>gtk_menu_popup_at_pointer ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_menu_popup_at_pointer (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>,
<em class="parameter"><code>const <span class="type">GdkEvent</span> *trigger_event</code></em>);</pre>
<em class="parameter"><code>const <a href="../html/gdk3-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a> *trigger_event</code></em>);</pre>
<p>Displays <em class="parameter"><code>menu</code></em>
and makes it available for selection.</p>
<p>See <a class="link" href="GtkMenu.html#gtk-menu-popup-at-widget" title="gtk_menu_popup_at_widget ()"><code class="function">gtk_menu_popup_at_widget()</code></a> to pop up a menu at a widget.
@ -1038,7 +1038,7 @@ out how it was actually positioned.</p>
</tr>
<tr>
<td class="parameter_name"><p>trigger_event</p></td>
<td class="parameter_description"><p>the <span class="type">GdkEvent</span> that initiated this request or
<td class="parameter_description"><p>the <a href="../html/gdk3-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a> that initiated this request or
<code class="literal">NULL</code> if it's the current event. </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>
@ -1052,7 +1052,7 @@ out how it was actually positioned.</p>
<a name="gtk-menu-popup-for-device"></a><h3>gtk_menu_popup_for_device ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_menu_popup_for_device (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>,
<em class="parameter"><code><span class="type">GdkDevice</span> *device</code></em>,
<em class="parameter"><code><a href="../html/GdkDevice.html#GdkDevice-struct"><span class="type">GdkDevice</span></a> *device</code></em>,
<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *parent_menu_shell</code></em>,
<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *parent_menu_item</code></em>,
<em class="parameter"><code><a class="link" href="GtkMenu.html#GtkMenuPositionFunc" title="GtkMenuPositionFunc ()"><span class="type">GtkMenuPositionFunc</span></a> func</code></em>,
@ -1110,7 +1110,7 @@ have this problem.</p>
</tr>
<tr>
<td class="parameter_name"><p>device</p></td>
<td class="parameter_description"><p>a <span class="type">GdkDevice</span>. </p></td>
<td class="parameter_description"><p>a <a href="../html/GdkDevice.html#GdkDevice-struct"><span class="type">GdkDevice</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>
@ -1464,7 +1464,7 @@ and should not be modified or freed.</p>
gtk_menu_set_monitor (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>,
<em class="parameter"><code><span class="type">gint</span> monitor_num</code></em>);</pre>
<p>Informs GTK+ on which monitor a menu should be popped up.
See <code class="function">gdk_monitor_get_geometry()</code>.</p>
See <a href="../html/GdkMonitor.html#gdk-monitor-get-geometry"><code class="function">gdk_monitor_get_geometry()</code></a>.</p>
<p>This function should be called from a <a class="link" href="GtkMenu.html#GtkMenuPositionFunc" title="GtkMenuPositionFunc ()"><span class="type">GtkMenuPositionFunc</span></a>
if the menu should not appear on the same monitor as the pointer.
This information can’t be reliably inferred from the coordinates
@ -1529,7 +1529,7 @@ be popped up or -1, if no monitor has been set</p>
<a name="gtk-menu-place-on-monitor"></a><h3>gtk_menu_place_on_monitor ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_menu_place_on_monitor (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>,
<em class="parameter"><code><span class="type">GdkMonitor</span> *monitor</code></em>);</pre>
<em class="parameter"><code><a href="../html/GdkMonitor.html#GdkMonitor-struct"><span class="type">GdkMonitor</span></a> *monitor</code></em>);</pre>
<p>Places <em class="parameter"><code>menu</code></em>
on the given monitor.</p>
<div class="refsect3">
@ -2087,13 +2087,13 @@ menu item is selected.</p>
<hr>
<div class="refsect2">
<a name="GtkMenu--anchor-hints"></a><h3>The <code class="literal">“anchor-hints”</code> property</h3>
<pre class="programlisting"> “anchor-hints” <span class="type">GdkAnchorHints</span></pre>
<pre class="programlisting"> “anchor-hints” <a href="../html/gdk3-Windows.html#GdkAnchorHints"><span class="type">GdkAnchorHints</span></a></pre>
<p>Positioning hints for aligning the menu relative to a rectangle.</p>
<p>These hints determine how the menu should be positioned in the case that
the menu would fall off-screen if placed in its ideal position.</p>
<p><span class="inlinemediaobject"><img src="popup-flip.png"></span></p>
<p>For example, <code class="literal">GDK_ANCHOR_FLIP_Y</code> will replace <code class="literal">GDK_GRAVITY_NORTH_WEST</code> with
<code class="literal">GDK_GRAVITY_SOUTH_WEST</code> and vice versa if the menu extends beyond the
<p>For example, <a href="../html/gdk3-Windows.html#GDK-ANCHOR-FLIP-Y:CAPS"><code class="literal">GDK_ANCHOR_FLIP_Y</code></a> will replace <a href="../html/gdk3-Windows.html#GDK-GRAVITY-NORTH-WEST:CAPS"><code class="literal">GDK_GRAVITY_NORTH_WEST</code></a> with
<a href="../html/gdk3-Windows.html#GDK-GRAVITY-SOUTH-WEST:CAPS"><code class="literal">GDK_GRAVITY_SOUTH_WEST</code></a> and vice versa if the menu extends beyond the
bottom edge of the monitor.</p>
<p>See <a class="link" href="GtkMenu.html#gtk-menu-popup-at-rect" title="gtk_menu_popup_at_rect ()"><code class="function">gtk_menu_popup_at_rect()</code></a>, <a class="link" href="GtkMenu.html#gtk-menu-popup-at-widget" title="gtk_menu_popup_at_widget ()"><code class="function">gtk_menu_popup_at_widget()</code></a>,
<a class="link" href="GtkMenu.html#gtk-menu-popup-at-pointer" title="gtk_menu_popup_at_pointer ()"><code class="function">gtk_menu_popup_at_pointer()</code></a>, <a class="link" href="GtkMenu.html#GtkMenu--rect-anchor-dx" title="The “rect-anchor-dx” property"><span class="type">“rect-anchor-dx”</span></a>,
@ -2115,8 +2115,8 @@ use <a class="link" href="GtkMenu.html#gtk-menu-attach-to-widget" title="gtk_men
<hr>
<div class="refsect2">
<a name="GtkMenu--menu-type-hint"></a><h3>The <code class="literal">“menu-type-hint”</code> property</h3>
<pre class="programlisting"> “menu-type-hint” <span class="type">GdkWindowTypeHint</span></pre>
<p>The <span class="type">GdkWindowTypeHint</span> to use for the menu's <span class="type">GdkWindow</span>.</p>
<pre class="programlisting"> “menu-type-hint” <a href="../html/gdk3-Windows.html#GdkWindowTypeHint"><span class="type">GdkWindowTypeHint</span></a></pre>
<p>The <a href="../html/gdk3-Windows.html#GdkWindowTypeHint"><span class="type">GdkWindowTypeHint</span></a> to use for the menu's <a href="../html/gdk3-Windows.html#GdkWindow-struct"><span class="type">GdkWindow</span></a>.</p>
<p>See <a class="link" href="GtkMenu.html#gtk-menu-popup-at-rect" title="gtk_menu_popup_at_rect ()"><code class="function">gtk_menu_popup_at_rect()</code></a>, <a class="link" href="GtkMenu.html#gtk-menu-popup-at-widget" title="gtk_menu_popup_at_widget ()"><code class="function">gtk_menu_popup_at_widget()</code></a>,
<a class="link" href="GtkMenu.html#gtk-menu-popup-at-pointer" title="gtk_menu_popup_at_pointer ()"><code class="function">gtk_menu_popup_at_pointer()</code></a>, <a class="link" href="GtkMenu.html#GtkMenu--anchor-hints" title="The “anchor-hints” property"><span class="type">“anchor-hints”</span></a>,
<a class="link" href="GtkMenu.html#GtkMenu--rect-anchor-dx" title="The “rect-anchor-dx” property"><span class="type">“rect-anchor-dx”</span></a>, <a class="link" href="GtkMenu.html#GtkMenu--rect-anchor-dy" title="The “rect-anchor-dy” property"><span class="type">“rect-anchor-dy”</span></a>, and <a class="link" href="GtkMenu.html#GtkMenu-popped-up" title="The “popped-up” signal"><span class="type">“popped-up”</span></a>.</p>

2
docs/reference/gtk/html/GtkMenuShell.html
View File

@ -599,7 +599,7 @@ work if the focus is on some toplevel owned by the onscreen keyboard.</p>
set to <code class="literal">FALSE</code>
should not display mnemonics or accelerators, since it cannot be
guaranteed that they will work.</p>
<p>See also <code class="function">gdk_keyboard_grab()</code></p>
<p>See also <a href="../html/gdk3-General.html#gdk-keyboard-grab"><code class="function">gdk_keyboard_grab()</code></a></p>
<div class="refsect3">
<a name="gtk-menu-shell-set-take-focus.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">

2
docs/reference/gtk/html/GtkOverlay.html
View File

@ -433,7 +433,7 @@ size of any overlay child widgets.</p></td>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
user_function (<a class="link" href="GtkOverlay.html" title="GtkOverlay"><span class="type">GtkOverlay</span></a> *overlay,
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget,
<span class="type">GdkRectangle</span> *allocation,
<a href="../html/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *allocation,
<span class="type">gpointer</span> user_data)</pre>
<p>The ::get-child-position signal is emitted to determine
the position and size of any overlay child widgets. A

16
docs/reference/gtk/html/GtkPadController.html
View File

@ -85,7 +85,7 @@
</tr>
<tr>
<td class="property_type">
<span class="type">GdkDevice</span> *</td>
<a href="../html/GdkDevice.html#GdkDevice-struct"><span class="type">GdkDevice</span></a> *</td>
<td class="property_name"><a class="link" href="GtkPadController.html#GtkPadController--pad" title="The “pad” property">pad</a></td>
<td class="property_flags">Read / Write / Construct Only</td>
</tr>
@ -137,12 +137,12 @@ perform no action, this event controller is provided to map those to
<span class="type">GAction</span> objects, thus letting the application give those a more semantic
meaning.</p>
<p>Buttons and sensors are not constrained to triggering a single action, some
<code class="literal">GDK_SOURCE_TABLET_PAD</code> devices feature multiple "modes", all these input
<a href="../html/GdkDevice.html#GDK-SOURCE-TABLET-PAD:CAPS"><code class="literal">GDK_SOURCE_TABLET_PAD</code></a> devices feature multiple "modes", all these input
elements have one current mode, which may determine the final action
being triggered. Pad devices often divide buttons and sensors into groups,
all elements in a group share the same current mode, but different groups
may have different modes. See <code class="function">gdk_device_pad_get_n_groups()</code> and
<code class="function">gdk_device_pad_get_group_n_modes()</code>.</p>
may have different modes. See <a href="../html/GdkDevicePad.html#gdk-device-pad-get-n-groups"><code class="function">gdk_device_pad_get_n_groups()</code></a> and
<a href="../html/GdkDevicePad.html#gdk-device-pad-get-group-n-modes"><code class="function">gdk_device_pad_get_group_n_modes()</code></a>.</p>
<p>Each of the actions that a given button/strip/ring performs for a given
mode is defined by <a class="link" href="GtkPadController.html#GtkPadActionEntry" title="struct GtkPadActionEntry"><span class="type">GtkPadActionEntry</span></a>, it contains an action name that
will be looked up in the given <span class="type">GActionGroup</span> and activated whenever the
@ -194,7 +194,7 @@ is required that those are made stateful and accepting this <span class="type">G
<pre class="programlisting"><a class="link" href="GtkPadController.html" title="GtkPadController"><span class="returnvalue">GtkPadController</span></a> *
gtk_pad_controller_new (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>,
<em class="parameter"><code><span class="type">GActionGroup</span> *group</code></em>,
<em class="parameter"><code><span class="type">GdkDevice</span> *pad</code></em>);</pre>
<em class="parameter"><code><a href="../html/GdkDevice.html#GdkDevice-struct"><span class="type">GdkDevice</span></a> *pad</code></em>);</pre>
<p>Creates a new <a class="link" href="GtkPadController.html" title="GtkPadController"><span class="type">GtkPadController</span></a> that will associate events from <em class="parameter"><code>pad</code></em>
to
actions. A <code class="literal">NULL</code> pad may be provided so the controller manages all pad devices
@ -227,7 +227,7 @@ events to actions, use <a class="link" href="GtkPadController.html#gtk-pad-contr
</tr>
<tr>
<td class="parameter_name"><p>pad</p></td>
<td class="parameter_description"><p>A <code class="literal">GDK_SOURCE_TABLET_PAD</code> device, or <code class="literal">NULL</code> to handle all pads. </p></td>
<td class="parameter_description"><p>A <a href="../html/GdkDevice.html#GDK-SOURCE-TABLET-PAD:CAPS"><code class="literal">GDK_SOURCE_TABLET_PAD</code></a> device, or <code class="literal">NULL</code> to handle all pads. </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>
</tbody>
@ -455,14 +455,14 @@ be deemed user-visible.</p></td>
<hr>
<div class="refsect2">
<a name="GtkPadController--pad"></a><h3>The <code class="literal">“pad”</code> property</h3>
<pre class="programlisting"> “pad” <span class="type">GdkDevice</span> *</pre>
<pre class="programlisting"> “pad” <a href="../html/GdkDevice.html#GdkDevice-struct"><span class="type">GdkDevice</span></a> *</pre>
<p>Pad device to control.</p>
<p>Flags: Read / Write / Construct Only</p>
</div>
</div>
<div class="refsect1">
<a name="GtkPadController.see-also"></a><h2>See Also</h2>
<p><a class="link" href="GtkEventController.html" title="GtkEventController"><span class="type">GtkEventController</span></a>, <span class="type">GdkDevicePad</span></p>
<p><a class="link" href="GtkEventController.html" title="GtkEventController"><span class="type">GtkEventController</span></a>, <a href="../html/GdkDevicePad.html#GdkDevicePad-struct"><span class="type">GdkDevicePad</span></a></p>
</div>
</div>
<div class="footer">

6
docs/reference/gtk/html/GtkPaned.html
View File

@ -119,7 +119,7 @@
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">GdkWindow</span> *
<a href="../html/gdk3-Windows.html#GdkWindow-struct"><span class="returnvalue">GdkWindow</span></a> *
</td>
<td class="function_name">
<a class="link" href="GtkPaned.html#gtk-paned-get-handle-window" title="gtk_paned_get_handle_window ()">gtk_paned_get_handle_window</a> <span class="c_punctuation">()</span>
@ -688,9 +688,9 @@ gtk_paned_get_position (<em class="parameter"><code><a class="link" href="GtkPan
<hr>
<div class="refsect2">
<a name="gtk-paned-get-handle-window"></a><h3>gtk_paned_get_handle_window ()</h3>
<pre class="programlisting"><span class="returnvalue">GdkWindow</span> *
<pre class="programlisting"><a href="../html/gdk3-Windows.html#GdkWindow-struct"><span class="returnvalue">GdkWindow</span></a> *
gtk_paned_get_handle_window (<em class="parameter"><code><a class="link" href="GtkPaned.html" title="GtkPaned"><span class="type">GtkPaned</span></a> *paned</code></em>);</pre>
<p>Returns the <span class="type">GdkWindow</span> of the handle. This function is
<p>Returns the <a href="../html/gdk3-Windows.html#GdkWindow-struct"><span class="type">GdkWindow</span></a> of the handle. This function is
useful when handling button or motion events because it
enables the callback to distinguish between the window
of the paned, a child and the handle.</p>

10
docs/reference/gtk/html/GtkPlacesSidebar.html
View File

@ -1234,7 +1234,7 @@ see and interact with drives and network servers directly.</p>
gtk_places_sidebar_set_drop_targets_visible
(<em class="parameter"><code><a class="link" href="GtkPlacesSidebar.html" title="GtkPlacesSidebar"><span class="type">GtkPlacesSidebar</span></a> *sidebar</code></em>,
<em class="parameter"><code><span class="type">gboolean</span> visible</code></em>,
<em class="parameter"><code><span class="type">GdkDragContext</span> *context</code></em>);</pre>
<em class="parameter"><code><a href="../html/gdk3-Drag-and-Drop.html#GdkDragContext-struct"><span class="type">GdkDragContext</span></a> *context</code></em>);</pre>
<p>Make the GtkPlacesSidebar show drop targets, so it can show the available
drop targets and a "new bookmark" row. This improves the Drag-and-Drop
experience of the user and allows applications to show all available
@ -1478,7 +1478,7 @@ of the drag-and-drop operation.</p>
<a name="GtkPlacesSidebar-drag-action-requested"></a><h3>The <code class="literal">“drag-action-requested”</code> signal</h3>
<pre class="programlisting"><span class="returnvalue">gint</span>
user_function (<a class="link" href="GtkPlacesSidebar.html" title="GtkPlacesSidebar"><span class="type">GtkPlacesSidebar</span></a> *sidebar,
<span class="type">GdkDragContext</span> *context,
<a href="../html/gdk3-Drag-and-Drop.html#GdkDragContext-struct"><span class="type">GdkDragContext</span></a> *context,
<span class="type">GObject</span> *dest_file,
<span class="type">gpointer</span> source_file_list,
<span class="type">gpointer</span> user_data)</pre>
@ -1508,7 +1508,7 @@ possible actions for the destination <em class="parameter"><code>dest_file</code
</tr>
<tr>
<td class="parameter_name"><p>context</p></td>
<td class="parameter_description"><p><span class="type">GdkDragContext</span> with information about the drag operation. </p></td>
<td class="parameter_description"><p><a href="../html/gdk3-Drag-and-Drop.html#GdkDragContext-struct"><span class="type">GdkDragContext</span></a> with information about the drag operation. </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> Gdk.DragContext]</span></td>
</tr>
<tr>
@ -1531,8 +1531,8 @@ possible actions for the destination <em class="parameter"><code>dest_file</code
</div>
<div class="refsect3">
<a name="GtkPlacesSidebar-drag-action-requested.returns"></a><h4>Returns</h4>
<p> The drag action to use, for example, <span class="type">GDK_ACTION_COPY</span>
or <span class="type">GDK_ACTION_MOVE</span>, or 0 if no action is allowed here (i.e. drops
<p> The drag action to use, for example, <a href="../html/gdk3-Drag-and-Drop.html#GDK-ACTION-COPY:CAPS"><span class="type">GDK_ACTION_COPY</span></a>
or <a href="../html/gdk3-Drag-and-Drop.html#GDK-ACTION-MOVE:CAPS"><span class="type">GDK_ACTION_MOVE</span></a>, or 0 if no action is allowed here (i.e. drops
are not allowed in the specified <em class="parameter"><code>dest_file</code></em>
).</p>
</div>

18
docs/reference/gtk/html/GtkPlug.html
View File

@ -93,7 +93,7 @@
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">GdkWindow</span> *
<a href="../html/gdk3-Windows.html#GdkWindow-struct"><span class="returnvalue">GdkWindow</span></a> *
</td>
<td class="function_name">
<a class="link" href="GtkPlug.html#gtk-plug-get-socket-window" title="gtk_plug_get_socket_window ()">gtk_plug_get_socket_window</a> <span class="c_punctuation">()</span>
@ -118,7 +118,7 @@
</tr>
<tr>
<td class="property_type">
<span class="type">GdkWindow</span> *</td>
<a href="../html/gdk3-Windows.html#GdkWindow-struct"><span class="type">GdkWindow</span></a> *</td>
<td class="property_name"><a class="link" href="GtkPlug.html#GtkPlug--socket-window" title="The “socket-window” property">socket-window</a></td>
<td class="property_flags">Read</td>
</tr>
@ -190,7 +190,7 @@ This protocol has also been implemented in other toolkits, e.g. Qt,
allowing the same level of integration when embedding a Qt widget
in GTK+ or vice versa.</p>
<p>The <a class="link" href="GtkPlug.html" title="GtkPlug"><span class="type">GtkPlug</span></a> and <a class="link" href="GtkSocket.html" title="GtkSocket"><span class="type">GtkSocket</span></a> widgets are only available when GTK+
is compiled for the X11 platform and <code class="literal">GDK_WINDOWING_X11</code> is defined.
is compiled for the X11 platform and <a href="../html/gdk3-General.html#GDK-WINDOWING-X11:CAPS"><code class="literal">GDK_WINDOWING_X11</code></a> is defined.
They can only be used on a <span class="type">GdkX11Display</span>. To use <a class="link" href="GtkPlug.html" title="GtkPlug"><span class="type">GtkPlug</span></a> and
<a class="link" href="GtkSocket.html" title="GtkSocket"><span class="type">GtkSocket</span></a>, you need to include the <code class="literal">gtk/gtkx.h</code> header.</p>
</div>
@ -233,7 +233,7 @@ gtk_plug_construct (<em class="parameter"><code><a class="link" href="GtkPlug.ht
<a name="gtk-plug-construct-for-display"></a><h3>gtk_plug_construct_for_display ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_plug_construct_for_display (<em class="parameter"><code><a class="link" href="GtkPlug.html" title="GtkPlug"><span class="type">GtkPlug</span></a> *plug</code></em>,
<em class="parameter"><code><span class="type">GdkDisplay</span> *display</code></em>,
<em class="parameter"><code><a href="../html/GdkDisplay.html#GdkDisplay-struct"><span class="type">GdkDisplay</span></a> *display</code></em>,
<em class="parameter"><code><span class="type">Window</span> socket_id</code></em>);</pre>
<p>Finish the initialization of <em class="parameter"><code>plug</code></em>
for a given <a class="link" href="GtkSocket.html" title="GtkSocket"><span class="type">GtkSocket</span></a> identified by
@ -257,7 +257,7 @@ This function will generally only be used by classes deriving from <a class="lin
</tr>
<tr>
<td class="parameter_name"><p>display</p></td>
<td class="parameter_description"><p>the <span class="type">GdkDisplay</span> associated with <em class="parameter"><code>socket_id</code></em>
<td class="parameter_description"><p>the <a href="../html/GdkDisplay.html#GdkDisplay-struct"><span class="type">GdkDisplay</span></a> associated with <em class="parameter"><code>socket_id</code></em>
’s
<a class="link" href="GtkSocket.html" title="GtkSocket"><span class="type">GtkSocket</span></a>.</p></td>
<td class="parameter_annotations"> </td>
@ -306,7 +306,7 @@ can later be plugged into a <a class="link" href="GtkSocket.html" title="GtkSock
<div class="refsect2">
<a name="gtk-plug-new-for-display"></a><h3>gtk_plug_new_for_display ()</h3>
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
gtk_plug_new_for_display (<em class="parameter"><code><span class="type">GdkDisplay</span> *display</code></em>,
gtk_plug_new_for_display (<em class="parameter"><code><a href="../html/GdkDisplay.html#GdkDisplay-struct"><span class="type">GdkDisplay</span></a> *display</code></em>,
<em class="parameter"><code><span class="type">Window</span> socket_id</code></em>);</pre>
<p>Create a new plug widget inside the <a class="link" href="GtkSocket.html" title="GtkSocket"><span class="type">GtkSocket</span></a> identified by socket_id.</p>
<div class="refsect3">
@ -320,7 +320,7 @@ gtk_plug_new_for_display (<em class="parameter"><code><span class="type">GdkDisp
<tbody>
<tr>
<td class="parameter_name"><p>display</p></td>
<td class="parameter_description"><p>the <span class="type">GdkDisplay</span> on which <em class="parameter"><code>socket_id</code></em>
<td class="parameter_description"><p>the <a href="../html/GdkDisplay.html#GdkDisplay-struct"><span class="type">GdkDisplay</span></a> on which <em class="parameter"><code>socket_id</code></em>
is displayed</p></td>
<td class="parameter_annotations"> </td>
</tr>
@ -396,7 +396,7 @@ gtk_plug_get_embedded (<em class="parameter"><code><a class="link" href="GtkPlug
<hr>
<div class="refsect2">
<a name="gtk-plug-get-socket-window"></a><h3>gtk_plug_get_socket_window ()</h3>
<pre class="programlisting"><span class="returnvalue">GdkWindow</span> *
<pre class="programlisting"><a href="../html/gdk3-Windows.html#GdkWindow-struct"><span class="returnvalue">GdkWindow</span></a> *
gtk_plug_get_socket_window (<em class="parameter"><code><a class="link" href="GtkPlug.html" title="GtkPlug"><span class="type">GtkPlug</span></a> *plug</code></em>);</pre>
<p>Retrieves the socket the plug is embedded in.</p>
<div class="refsect3">
@ -442,7 +442,7 @@ gtk_plug_get_socket_window (<em class="parameter"><code><a class="link" href="Gt
<hr>
<div class="refsect2">
<a name="GtkPlug--socket-window"></a><h3>The <code class="literal">“socket-window”</code> property</h3>
<pre class="programlisting"> “socket-window” <span class="type">GdkWindow</span> *</pre>
<pre class="programlisting"> “socket-window” <a href="../html/gdk3-Windows.html#GdkWindow-struct"><span class="type">GdkWindow</span></a> *</pre>
<p>The window of the socket the plug is embedded in.</p>
<p>Flags: Read</p>
<p class="since">Since: 2.14</p>

8
docs/reference/gtk/html/GtkPopover.html
View File

@ -219,7 +219,7 @@
</tr>
<tr>
<td class="property_type">
<span class="type">GdkRectangle</span> *</td>
<a href="../html/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *</td>
<td class="property_name"><a class="link" href="GtkPopover.html#GtkPopover--pointing-to" title="The “pointing-to” property">pointing-to</a></td>
<td class="property_flags">Read / Write</td>
</tr>
@ -652,7 +652,7 @@ gtk_popover_get_relative_to (<em class="parameter"><code><a class="link" href="G
<a name="gtk-popover-set-pointing-to"></a><h3>gtk_popover_set_pointing_to ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_popover_set_pointing_to (<em class="parameter"><code><a class="link" href="GtkPopover.html" title="GtkPopover"><span class="type">GtkPopover</span></a> *popover</code></em>,
<em class="parameter"><code>const <span class="type">GdkRectangle</span> *rect</code></em>);</pre>
<em class="parameter"><code>const <a href="../html/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *rect</code></em>);</pre>
<p>Sets the rectangle that <em class="parameter"><code>popover</code></em>
will point to, in the
coordinate space of the widget <em class="parameter"><code>popover</code></em>
@ -687,7 +687,7 @@ see <a class="link" href="GtkPopover.html#gtk-popover-set-relative-to" title="gt
<a name="gtk-popover-get-pointing-to"></a><h3>gtk_popover_get_pointing_to ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gtk_popover_get_pointing_to (<em class="parameter"><code><a class="link" href="GtkPopover.html" title="GtkPopover"><span class="type">GtkPopover</span></a> *popover</code></em>,
<em class="parameter"><code><span class="type">GdkRectangle</span> *rect</code></em>);</pre>
<em class="parameter"><code><a href="../html/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *rect</code></em>);</pre>
<p>If a rectangle to point to has been set, this function will
return <code class="literal">TRUE</code> and fill in <em class="parameter"><code>rect</code></em>
with such rectangle, otherwise
@ -1111,7 +1111,7 @@ receive input while the popover is visible).</p>
<hr>
<div class="refsect2">
<a name="GtkPopover--pointing-to"></a><h3>The <code class="literal">“pointing-to”</code> property</h3>
<pre class="programlisting"> “pointing-to” <span class="type">GdkRectangle</span> *</pre>
<pre class="programlisting"> “pointing-to” <a href="../html/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *</pre>
<p>Marks a specific rectangle to be pointed.</p>
<p>Flags: Read / Write</p>
<p class="since">Since: <a class="link" href="api-index-3-12.html#api-index-3.12">3.12</a></p>

2
docs/reference/gtk/html/GtkRange.html
View File

@ -1198,7 +1198,7 @@ gtk_range_get_min_slider_size (<em class="parameter"><code><a class="link" href=
<a name="gtk-range-get-range-rect"></a><h3>gtk_range_get_range_rect ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_range_get_range_rect (<em class="parameter"><code><a class="link" href="GtkRange.html" title="GtkRange"><span class="type">GtkRange</span></a> *range</code></em>,
<em class="parameter"><code><span class="type">GdkRectangle</span> *range_rect</code></em>);</pre>
<em class="parameter"><code><a href="../html/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *range_rect</code></em>);</pre>
<p>This function returns the area that contains the range’s trough
and its steppers, in widget-&gt;window coordinates.</p>
<p>This function is useful mainly for <a class="link" href="GtkRange.html" title="GtkRange"><span class="type">GtkRange</span></a> subclasses.</p>

8
docs/reference/gtk/html/GtkScrolledWindow.html
View File

@ -907,8 +907,8 @@ is simply a convenience function; it is equivalent to adding the
unscrollable child to a viewport, then adding the viewport to the
scrolled window. If a child has native scrolling, use
<a class="link" href="GtkContainer.html#gtk-container-add" title="gtk_container_add ()"><code class="function">gtk_container_add()</code></a> instead of this function.</p>
<p>The viewport scrolls the child by moving its <span class="type">GdkWindow</span>, and takes
the size of the child to be the size of its toplevel <span class="type">GdkWindow</span>.
<p>The viewport scrolls the child by moving its <a href="../html/gdk3-Windows.html#GdkWindow-struct"><span class="type">GdkWindow</span></a>, and takes
the size of the child to be the size of its toplevel <a href="../html/gdk3-Windows.html#GdkWindow-struct"><span class="type">GdkWindow</span></a>.
This will be very wrong for most widgets that support native scrolling;
for example, if you add a widget such as <a class="link" href="GtkTreeView.html" title="GtkTreeView"><span class="type">GtkTreeView</span></a> with a viewport,
the whole widget will scroll, including the column headings. Thus,
@ -1128,7 +1128,7 @@ gtk_scrolled_window_set_kinetic_scrolling
<em class="parameter"><code><span class="type">gboolean</span> kinetic_scrolling</code></em>);</pre>
<p>Turns kinetic scrolling on or off.
Kinetic scrolling only applies to devices with source
<code class="literal">GDK_SOURCE_TOUCHSCREEN</code>.</p>
<a href="../html/GdkDevice.html#GDK-SOURCE-TOUCHSCREEN:CAPS"><code class="literal">GDK_SOURCE_TOUCHSCREEN</code></a>.</p>
<div class="refsect3">
<a name="gtk-scrolled-window-set-kinetic-scrolling.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
@ -1858,7 +1858,7 @@ bars are placed.</p>
<a name="GtkScrolledWindow--kinetic-scrolling"></a><h3>The <code class="literal">“kinetic-scrolling”</code> property</h3>
<pre class="programlisting"> “kinetic-scrolling” <span class="type">gboolean</span></pre>
<p>Whether kinetic scrolling is enabled or not. Kinetic scrolling
only applies to devices with source <code class="literal">GDK_SOURCE_TOUCHSCREEN</code>.</p>
only applies to devices with source <a href="../html/GdkDevice.html#GDK-SOURCE-TOUCHSCREEN:CAPS"><code class="literal">GDK_SOURCE_TOUCHSCREEN</code></a>.</p>
<p>Flags: Read / Write</p>
<p>Default value: TRUE</p>
<p class="since">Since: <a class="link" href="api-index-3-4.html#api-index-3.4">3.4</a></p>

10
docs/reference/gtk/html/GtkSearchBar.html
View File

@ -360,11 +360,11 @@ toggle button.</p>
<a name="gtk-search-bar-handle-event"></a><h3>gtk_search_bar_handle_event ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gtk_search_bar_handle_event (<em class="parameter"><code><a class="link" href="GtkSearchBar.html" title="GtkSearchBar"><span class="type">GtkSearchBar</span></a> *bar</code></em>,
<em class="parameter"><code><span class="type">GdkEvent</span> *event</code></em>);</pre>
<em class="parameter"><code><a href="../html/gdk3-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a> *event</code></em>);</pre>
<p>This function should be called when the top-level
window which contains the search bar received a key event.</p>
<p>If the key event is handled by the search bar, the bar will
be shown, the entry populated with the entered text and <code class="literal">GDK_EVENT_STOP</code>
be shown, the entry populated with the entered text and <a href="../html/gdk3-Events.html#GDK-EVENT-STOP:CAPS"><code class="literal">GDK_EVENT_STOP</code></a>
will be returned. The caller should ensure that events are
not propagated further.</p>
<p>If no entry has been connected to the search bar, using
@ -443,7 +443,7 @@ immediately with a warning.</p>
</tr>
<tr>
<td class="parameter_name"><p>event</p></td>
<td class="parameter_description"><p>a <span class="type">GdkEvent</span> containing key press events</p></td>
<td class="parameter_description"><p>a <a href="../html/gdk3-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a> containing key press events</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
@ -451,9 +451,9 @@ immediately with a warning.</p>
</div>
<div class="refsect3">
<a name="gtk-search-bar-handle-event.returns"></a><h4>Returns</h4>
<p> <code class="literal">GDK_EVENT_STOP</code> if the key press event resulted
<p> <a href="../html/gdk3-Events.html#GDK-EVENT-STOP:CAPS"><code class="literal">GDK_EVENT_STOP</code></a> if the key press event resulted
in text being entered in the search entry (and revealing
the search bar if necessary), <code class="literal">GDK_EVENT_PROPAGATE</code> otherwise.</p>
the search bar if necessary), <a href="../html/gdk3-Events.html#GDK-EVENT-PROPAGATE:CAPS"><code class="literal">GDK_EVENT_PROPAGATE</code></a> otherwise.</p>
</div>
<p class="since">Since: <a class="link" href="api-index-3-10.html#api-index-3.10">3.10</a></p>
</div>

8
docs/reference/gtk/html/GtkSearchEntry.html
View File

@ -167,7 +167,7 @@ empty, and a clear icon when it isn't.</p>
<a name="gtk-search-entry-handle-event"></a><h3>gtk_search_entry_handle_event ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gtk_search_entry_handle_event (<em class="parameter"><code><a class="link" href="GtkSearchEntry.html" title="GtkSearchEntry"><span class="type">GtkSearchEntry</span></a> *entry</code></em>,
<em class="parameter"><code><span class="type">GdkEvent</span> *event</code></em>);</pre>
<em class="parameter"><code><a href="../html/gdk3-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a> *event</code></em>);</pre>
<p>This function should be called when the top-level window
which contains the search entry received a key event. If
the entry is part of a <a class="link" href="GtkSearchBar.html" title="GtkSearchBar"><span class="type">GtkSearchBar</span></a>, it is preferable
@ -175,7 +175,7 @@ to call <a class="link" href="GtkSearchBar.html#gtk-search-bar-handle-event" tit
reveal the entry in addition to passing the event to this
function.</p>
<p>If the key event is handled by the search entry and starts
or continues a search, <code class="literal">GDK_EVENT_STOP</code> will be returned.
or continues a search, <a href="../html/gdk3-Events.html#GDK-EVENT-STOP:CAPS"><code class="literal">GDK_EVENT_STOP</code></a> will be returned.
The caller should ensure that the entry is shown in this
case, and not propagate the event further.</p>
<div class="refsect3">
@ -202,8 +202,8 @@ case, and not propagate the event further.</p>
</div>
<div class="refsect3">
<a name="gtk-search-entry-handle-event.returns"></a><h4>Returns</h4>
<p> <code class="literal">GDK_EVENT_STOP</code> if the key press event resulted
in a search beginning or continuing, <code class="literal">GDK_EVENT_PROPAGATE</code>
<p> <a href="../html/gdk3-Events.html#GDK-EVENT-STOP:CAPS"><code class="literal">GDK_EVENT_STOP</code></a> if the key press event resulted
in a search beginning or continuing, <a href="../html/gdk3-Events.html#GDK-EVENT-PROPAGATE:CAPS"><code class="literal">GDK_EVENT_PROPAGATE</code></a>
otherwise.</p>
</div>
<p class="since">Since: <a class="link" href="api-index-3-16.html#api-index-3.16">3.16</a></p>

18
docs/reference/gtk/html/GtkSettings.html
View File

@ -720,7 +720,7 @@ no default screen, then returns <code class="literal">NULL</code>. </p>
<div class="refsect2">
<a name="gtk-settings-get-for-screen"></a><h3>gtk_settings_get_for_screen ()</h3>
<pre class="programlisting"><a class="link" href="GtkSettings.html" title="Settings"><span class="returnvalue">GtkSettings</span></a> *
gtk_settings_get_for_screen (<em class="parameter"><code><span class="type">GdkScreen</span> *screen</code></em>);</pre>
gtk_settings_get_for_screen (<em class="parameter"><code><a href="../html/GdkScreen.html#GdkScreen-struct"><span class="type">GdkScreen</span></a> *screen</code></em>);</pre>
<p>Gets the <a class="link" href="GtkSettings.html" title="Settings"><span class="type">GtkSettings</span></a> object for <em class="parameter"><code>screen</code></em>
, creating it if necessary.</p>
<div class="refsect3">
@ -733,7 +733,7 @@ gtk_settings_get_for_screen (<em class="parameter"><code><span class="type">GdkS
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>screen</p></td>
<td class="parameter_description"><p>a <span class="type">GdkScreen</span>.</p></td>
<td class="parameter_description"><p>a <a href="../html/GdkScreen.html#GdkScreen-struct"><span class="type">GdkScreen</span></a>.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
@ -815,7 +815,7 @@ between 0 and 1.</p>
</tr>
<tr>
<td class="parameter_name"><p>property_value</p></td>
<td class="parameter_description"><p>a <span class="type">GValue</span> which must hold <span class="type">GdkColor</span> values.</p></td>
<td class="parameter_description"><p>a <span class="type">GValue</span> which must hold <a href="../html/gdk3-Colors.html#GdkColor"><span class="type">GdkColor</span></a> values.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
@ -825,7 +825,7 @@ between 0 and 1.</p>
<a name="gtk-rc-property-parse-color.returns"></a><h4>Returns</h4>
<p> <code class="literal">TRUE</code> if <em class="parameter"><code>gstring</code></em>
could be parsed and <em class="parameter"><code>property_value</code></em>
has been set to the resulting <span class="type">GdkColor</span>.</p>
has been set to the resulting <a href="../html/gdk3-Colors.html#GdkColor"><span class="type">GdkColor</span></a>.</p>
</div>
</div>
<hr>
@ -1231,7 +1231,7 @@ the token parsed, or a GSTRING holding an unparsed statement</p></td>
<a name="GtkSettings--color-hash"></a><h3>The <code class="literal">“color-hash”</code> property</h3>
<pre class="programlisting"> “color-hash” <span class="type">GHashTable</span> *</pre>
<p>Holds a hash table representation of the <a class="link" href="GtkSettings.html#GtkSettings--gtk-color-scheme" title="The “gtk-color-scheme” property"><span class="type">“gtk-color-scheme”</span></a>
setting, mapping color names to <span class="type">GdkColors</span>.</p>
setting, mapping color names to <a href="../html/gdk3-Colors.html#GdkColor"><span class="type">GdkColors</span></a>.</p>
<p><span class="annotation">[<acronym title="Free data container after the code is done."><span class="acronym">transfer container</span></acronym>]</span></p>
<div class="warning">
<p><code class="literal">GtkSettings:color-hash</code> has been deprecated since version 3.8 and should not be used in newly-written code.</p>
@ -1355,7 +1355,7 @@ presses the mnemonic activator.</p>
Color names must be acceptable as identifiers in the
<a class="link" href="gtk3-Resource-Files.html" title="Resource Files">gtkrc</a> syntax, and
color specifications must be in the format accepted by
<code class="function">gdk_color_parse()</code>.</p>
<a href="../html/gdk3-Colors.html#gdk-color-parse"><code class="function">gdk_color_parse()</code></a>.</p>
<p>Note that due to the way the color tables from different sources are
merged, color specifications will be converted to hexadecimal form
when getting this property.</p>
@ -1602,7 +1602,7 @@ last char. 600 is a good value for enabling it.</p>
<pre class="programlisting"> “gtk-error-bell” <span class="type">gboolean</span></pre>
<p>When <code class="literal">TRUE</code>, keyboard navigation and other input-related errors
will cause a beep. Since the error bell is implemented using
<code class="function">gdk_window_beep()</code>, the windowing system may offer ways to
<a href="../html/gdk3-Windows.html#gdk-window-beep"><code class="function">gdk_window_beep()</code></a>, the windowing system may offer ways to
configure the error bell in many ways, such as flashing the
window or similar visual effects.</p>
<p>Flags: Read / Write</p>
@ -1731,7 +1731,7 @@ to be present on the used input device.</p>
<div class="warning">
<p><code class="literal">GtkSettings:gtk-keynav-cursor-only</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
<p>Generally, the behavior for touchscreen input should be
performed dynamically based on <code class="function">gdk_event_get_source_device()</code>.</p>
performed dynamically based on <a href="../html/gdk3-Events.html#gdk-event-get-source-device"><code class="function">gdk_event_get_source_device()</code></a>.</p>
</div>
<p>Flags: Read / Write</p>
<p>Default value: FALSE</p>
@ -2190,7 +2190,7 @@ functionality.</p>
<div class="warning">
<p><code class="literal">GtkSettings:gtk-touchscreen-mode</code> has been deprecated since version 3.4. and should not be used in newly-written code.</p>
<p>Generally, the behavior for touchscreen input should be
performed dynamically based on <code class="function">gdk_event_get_source_device()</code>.</p>
performed dynamically based on <a href="../html/gdk3-Events.html#gdk-event-get-source-device"><code class="function">gdk_event_get_source_device()</code></a>.</p>
</div>
<p>Flags: Read / Write</p>
<p>Default value: FALSE</p>

6
docs/reference/gtk/html/GtkSocket.html
View File

@ -68,7 +68,7 @@
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">GdkWindow</span> *
<a href="../html/gdk3-Windows.html#GdkWindow-struct"><span class="returnvalue">GdkWindow</span></a> *
</td>
<td class="function_name">
<a class="link" href="GtkSocket.html#gtk-socket-get-plug-window" title="gtk_socket_get_plug_window ()">gtk_socket_get_plug_window</a> <span class="c_punctuation">()</span>
@ -193,7 +193,7 @@ This protocol has also been implemented in other toolkits, e.g. Qt,
allowing the same level of integration when embedding a Qt widget
in GTK or vice versa.</p>
<p>The <a class="link" href="GtkPlug.html" title="GtkPlug"><span class="type">GtkPlug</span></a> and <a class="link" href="GtkSocket.html" title="GtkSocket"><span class="type">GtkSocket</span></a> widgets are only available when GTK+
is compiled for the X11 platform and <code class="literal">GDK_WINDOWING_X11</code> is defined.
is compiled for the X11 platform and <a href="../html/gdk3-General.html#GDK-WINDOWING-X11:CAPS"><code class="literal">GDK_WINDOWING_X11</code></a> is defined.
They can only be used on a <span class="type">GdkX11Display</span>. To use <a class="link" href="GtkPlug.html" title="GtkPlug"><span class="type">GtkPlug</span></a> and
<a class="link" href="GtkSocket.html" title="GtkSocket"><span class="type">GtkSocket</span></a>, you need to include the <code class="literal">gtk/gtkx.h</code> header.</p>
</div>
@ -282,7 +282,7 @@ before you can make this call.</p>
<hr>
<div class="refsect2">
<a name="gtk-socket-get-plug-window"></a><h3>gtk_socket_get_plug_window ()</h3>
<pre class="programlisting"><span class="returnvalue">GdkWindow</span> *
<pre class="programlisting"><a href="../html/gdk3-Windows.html#GdkWindow-struct"><span class="returnvalue">GdkWindow</span></a> *
gtk_socket_get_plug_window (<em class="parameter"><code><a class="link" href="GtkSocket.html" title="GtkSocket"><span class="type">GtkSocket</span></a> *socket_</code></em>);</pre>
<p>Retrieves the window of the plug. Use this to check if the plug has
been created inside of the socket.</p>

36
docs/reference/gtk/html/GtkStatusIcon.html
View File

@ -186,7 +186,7 @@
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">GdkScreen</span> *
<a href="../html/GdkScreen.html#GdkScreen-struct"><span class="returnvalue">GdkScreen</span></a> *
</td>
<td class="function_name">
<a class="link" href="GtkStatusIcon.html#gtk-status-icon-get-screen" title="gtk_status_icon_get_screen ()">gtk_status_icon_get_screen</a> <span class="c_punctuation">()</span>
@ -364,7 +364,7 @@
</tr>
<tr>
<td class="property_type">
<span class="type">GdkScreen</span> *</td>
<a href="../html/GdkScreen.html#GdkScreen-struct"><span class="type">GdkScreen</span></a> *</td>
<td class="property_name"><a class="link" href="GtkStatusIcon.html#GtkStatusIcon--screen" title="The “screen” property">screen</a></td>
<td class="property_flags">Read / Write</td>
</tr>
@ -1135,15 +1135,15 @@ status icon is embedded (see <a class="link" href="GtkStatusIcon.html#gtk-status
<a name="gtk-status-icon-set-screen"></a><h3>gtk_status_icon_set_screen ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_status_icon_set_screen (<em class="parameter"><code><a class="link" href="GtkStatusIcon.html" title="GtkStatusIcon"><span class="type">GtkStatusIcon</span></a> *status_icon</code></em>,
<em class="parameter"><code><span class="type">GdkScreen</span> *screen</code></em>);</pre>
<em class="parameter"><code><a href="../html/GdkScreen.html#GdkScreen-struct"><span class="type">GdkScreen</span></a> *screen</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_status_icon_set_screen</code> has been deprecated since version 3.14 and should not be used in newly-written code.</p>
<p>Use <span class="type">GNotification</span> and <a class="link" href="GtkApplication.html" title="GtkApplication"><span class="type">GtkApplication</span></a> to
provide status notifications; there is no direct replacement
for this function, as GTK typically only has one <span class="type">GdkScreen</span>
for this function, as GTK typically only has one <a href="../html/GdkScreen.html#GdkScreen-struct"><span class="type">GdkScreen</span></a>
and notifications are managed by the platform</p>
</div>
<p>Sets the <span class="type">GdkScreen</span> where <em class="parameter"><code>status_icon</code></em>
<p>Sets the <a href="../html/GdkScreen.html#GdkScreen-struct"><span class="type">GdkScreen</span></a> where <em class="parameter"><code>status_icon</code></em>
is displayed; if
the icon is already mapped, it will be unmapped, and
then remapped on the new screen.</p>
@ -1163,7 +1163,7 @@ then remapped on the new screen.</p>
</tr>
<tr>
<td class="parameter_name"><p>screen</p></td>
<td class="parameter_description"><p>a <span class="type">GdkScreen</span></p></td>
<td class="parameter_description"><p>a <a href="../html/GdkScreen.html#GdkScreen-struct"><span class="type">GdkScreen</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
@ -1174,7 +1174,7 @@ then remapped on the new screen.</p>
<hr>
<div class="refsect2">
<a name="gtk-status-icon-get-screen"></a><h3>gtk_status_icon_get_screen ()</h3>
<pre class="programlisting"><span class="returnvalue">GdkScreen</span> *
<pre class="programlisting"><a href="../html/GdkScreen.html#GdkScreen-struct"><span class="returnvalue">GdkScreen</span></a> *
gtk_status_icon_get_screen (<em class="parameter"><code><a class="link" href="GtkStatusIcon.html" title="GtkStatusIcon"><span class="type">GtkStatusIcon</span></a> *status_icon</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_status_icon_get_screen</code> has been deprecated since version 3.14 and should not be used in newly-written code.</p>
@ -1182,7 +1182,7 @@ gtk_status_icon_get_screen (<em class="parameter"><code><a class="link" href="Gt
provide status notifications; there is no direct replacement
for this function, as notifications are managed by the platform</p>
</div>
<p>Returns the <span class="type">GdkScreen</span> associated with <em class="parameter"><code>status_icon</code></em>
<p>Returns the <a href="../html/GdkScreen.html#GdkScreen-struct"><span class="type">GdkScreen</span></a> associated with <em class="parameter"><code>status_icon</code></em>
.</p>
<div class="refsect3">
<a name="gtk-status-icon-get-screen.parameters"></a><h4>Parameters</h4>
@ -1201,7 +1201,7 @@ gtk_status_icon_get_screen (<em class="parameter"><code><a class="link" href="Gt
</div>
<div class="refsect3">
<a name="gtk-status-icon-get-screen.returns"></a><h4>Returns</h4>
<p>a <span class="type">GdkScreen</span>. </p>
<p>a <a href="../html/GdkScreen.html#GdkScreen-struct"><span class="type">GdkScreen</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.12</p>
@ -1730,8 +1730,8 @@ to position <em class="parameter"><code>menu</code></em>
<a name="gtk-status-icon-get-geometry"></a><h3>gtk_status_icon_get_geometry ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gtk_status_icon_get_geometry (<em class="parameter"><code><a class="link" href="GtkStatusIcon.html" title="GtkStatusIcon"><span class="type">GtkStatusIcon</span></a> *status_icon</code></em>,
<em class="parameter"><code><span class="type">GdkScreen</span> **screen</code></em>,
<em class="parameter"><code><span class="type">GdkRectangle</span> *area</code></em>,
<em class="parameter"><code><a href="../html/GdkScreen.html#GdkScreen-struct"><span class="type">GdkScreen</span></a> **screen</code></em>,
<em class="parameter"><code><a href="../html/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *area</code></em>,
<em class="parameter"><code><a class="link" href="gtk3-Standard-Enumerations.html#GtkOrientation" title="enum GtkOrientation"><span class="type">GtkOrientation</span></a> *orientation</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_status_icon_get_geometry</code> has been deprecated since version 3.14 and should not be used in newly-written code.</p>
@ -1921,7 +1921,7 @@ is embedded.</p>
<hr>
<div class="refsect2">
<a name="GtkStatusIcon--screen"></a><h3>The <code class="literal">“screen”</code> property</h3>
<pre class="programlisting"> “screen” <span class="type">GdkScreen</span> *</pre>
<pre class="programlisting"> “screen” <a href="../html/GdkScreen.html#GdkScreen-struct"><span class="type">GdkScreen</span></a> *</pre>
<p>The screen where this status icon will be displayed.</p>
<p>Flags: Read / Write</p>
</div>
@ -2052,7 +2052,7 @@ be used by applications and should be wrapped by language bindings.</p>
<a name="GtkStatusIcon-button-press-event"></a><h3>The <code class="literal">“button-press-event”</code> signal</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
user_function (<a class="link" href="GtkStatusIcon.html" title="GtkStatusIcon"><span class="type">GtkStatusIcon</span></a> *status_icon,
<span class="type">GdkEvent</span> *event,
<a href="../html/gdk3-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a> *event,
<span class="type">gpointer</span> user_data)</pre>
<p>The ::button-press-event signal will be emitted when a button
(typically from a mouse) is pressed.</p>
@ -2074,7 +2074,7 @@ and ::popup-menu signals in preference.</p>
</tr>
<tr>
<td class="parameter_name"><p>event</p></td>
<td class="parameter_description"><p>the <span class="type">GdkEventButton</span> which triggered
<td class="parameter_description"><p>the <a href="../html/gdk3-Event-Structures.html#GdkEventButton"><span class="type">GdkEventButton</span></a> which triggered
this signal. </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> Gdk.EventButton]</span></td>
</tr>
@ -2099,7 +2099,7 @@ for the event. <code class="literal">FALSE</code> to propagate the event further
<a name="GtkStatusIcon-button-release-event"></a><h3>The <code class="literal">“button-release-event”</code> signal</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
user_function (<a class="link" href="GtkStatusIcon.html" title="GtkStatusIcon"><span class="type">GtkStatusIcon</span></a> *status_icon,
<span class="type">GdkEvent</span> *event,
<a href="../html/gdk3-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a> *event,
<span class="type">gpointer</span> user_data)</pre>
<p>The ::button-release-event signal will be emitted when a button
(typically from a mouse) is released.</p>
@ -2121,7 +2121,7 @@ and ::popup-menu signals in preference.</p>
</tr>
<tr>
<td class="parameter_name"><p>event</p></td>
<td class="parameter_description"><p>the <span class="type">GdkEventButton</span> which triggered
<td class="parameter_description"><p>the <a href="../html/gdk3-Event-Structures.html#GdkEventButton"><span class="type">GdkEventButton</span></a> which triggered
this signal. </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> Gdk.EventButton]</span></td>
</tr>
@ -2286,7 +2286,7 @@ should be shown right now, <code class="literal">FALSE</code> otherwise.</p>
<a name="GtkStatusIcon-scroll-event"></a><h3>The <code class="literal">“scroll-event”</code> signal</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
user_function (<a class="link" href="GtkStatusIcon.html" title="GtkStatusIcon"><span class="type">GtkStatusIcon</span></a> *status_icon,
<span class="type">GdkEvent</span> *event,
<a href="../html/gdk3-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a> *event,
<span class="type">gpointer</span> user_data)</pre>
<p>The ::scroll-event signal is emitted when a button in the 4 to 7
range is pressed. Wheel mice are usually configured to generate
@ -2308,7 +2308,7 @@ button press events for buttons 4 and 5 when the wheel is turned.</p>
</tr>
<tr>
<td class="parameter_name"><p>event</p></td>
<td class="parameter_description"><p>the <span class="type">GdkEventScroll</span> which triggered
<td class="parameter_description"><p>the <a href="../html/gdk3-Event-Structures.html#GdkEventScroll"><span class="type">GdkEventScroll</span></a> which triggered
this signal. </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> Gdk.EventScroll]</span></td>
</tr>

56
docs/reference/gtk/html/GtkStyle.html
View File

@ -501,7 +501,7 @@ gtk_style_copy (<em class="parameter"><code><a class="link" href="GtkStyle.html"
<a name="gtk-style-attach"></a><h3>gtk_style_attach ()</h3>
<pre class="programlisting"><a class="link" href="GtkStyle.html" title="GtkStyle"><span class="returnvalue">GtkStyle</span></a> *
gtk_style_attach (<em class="parameter"><code><a class="link" href="GtkStyle.html" title="GtkStyle"><span class="type">GtkStyle</span></a> *style</code></em>,
<em class="parameter"><code><span class="type">GdkWindow</span> *window</code></em>);</pre>
<em class="parameter"><code><a href="../html/gdk3-Windows.html#GdkWindow-struct"><span class="type">GdkWindow</span></a> *window</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_style_attach</code> has been deprecated since version 3.0 and should not be used in newly-written code.</p>
<p>Use <a class="link" href="GtkWidget.html#gtk-widget-style-attach" title="gtk_widget_style_attach ()"><code class="function">gtk_widget_style_attach()</code></a> instead</p>
@ -531,7 +531,7 @@ in the following way:
</tr>
<tr>
<td class="parameter_name"><p>window</p></td>
<td class="parameter_description"><p>a <span class="type">GdkWindow</span>.</p></td>
<td class="parameter_description"><p>a <a href="../html/gdk3-Windows.html#GdkWindow-struct"><span class="type">GdkWindow</span></a>.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
@ -608,7 +608,7 @@ has a <a class="link" href="GtkStyleContext.html" title="GtkStyleContext"><span
<a name="gtk-style-set-background"></a><h3>gtk_style_set_background ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_style_set_background (<em class="parameter"><code><a class="link" href="GtkStyle.html" title="GtkStyle"><span class="type">GtkStyle</span></a> *style</code></em>,
<em class="parameter"><code><span class="type">GdkWindow</span> *window</code></em>,
<em class="parameter"><code><a href="../html/gdk3-Windows.html#GdkWindow-struct"><span class="type">GdkWindow</span></a> *window</code></em>,
<em class="parameter"><code><a class="link" href="GtkWidget.html#GtkStateType" title="enum GtkStateType"><span class="type">GtkStateType</span></a> state_type</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_style_set_background</code> has been deprecated since version 3.0 and should not be used in newly-written code.</p>
@ -634,7 +634,7 @@ specified by <em class="parameter"><code>style</code></em>
</tr>
<tr>
<td class="parameter_name"><p>window</p></td>
<td class="parameter_description"><p>a <span class="type">GdkWindow</span></p></td>
<td class="parameter_description"><p>a <a href="../html/gdk3-Windows.html#GdkWindow-struct"><span class="type">GdkWindow</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
@ -652,7 +652,7 @@ specified by <em class="parameter"><code>style</code></em>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_style_apply_default_background (<em class="parameter"><code><a class="link" href="GtkStyle.html" title="GtkStyle"><span class="type">GtkStyle</span></a> *style</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>,
<em class="parameter"><code><span class="type">GdkWindow</span> *window</code></em>,
<em class="parameter"><code><a href="../html/gdk3-Windows.html#GdkWindow-struct"><span class="type">GdkWindow</span></a> *window</code></em>,
<em class="parameter"><code><a class="link" href="GtkWidget.html#GtkStateType" title="enum GtkStateType"><span class="type">GtkStateType</span></a> state_type</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>,
@ -669,7 +669,7 @@ gtk_style_apply_default_background (<em class="parameter"><code><a class="link"
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gtk_style_lookup_color (<em class="parameter"><code><a class="link" href="GtkStyle.html" title="GtkStyle"><span class="type">GtkStyle</span></a> *style</code></em>,
<em class="parameter"><code>const <span class="type">gchar</span> *color_name</code></em>,
<em class="parameter"><code><span class="type">GdkColor</span> *color</code></em>);</pre>
<em class="parameter"><code><a href="../html/gdk3-Colors.html#GdkColor"><span class="type">GdkColor</span></a> *color</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_style_lookup_color</code> has been deprecated since version 3.0 and should not be used in newly-written code.</p>
<p>Use <a class="link" href="GtkStyleContext.html#gtk-style-context-lookup-color" title="gtk_style_context_lookup_color ()"><code class="function">gtk_style_context_lookup_color()</code></a> instead</p>
@ -702,7 +702,7 @@ switch occurs.</p>
</tr>
<tr>
<td class="parameter_name"><p>color</p></td>
<td class="parameter_description"><p>the <span class="type">GdkColor</span> to fill in. </p></td>
<td class="parameter_description"><p>the <a href="../html/gdk3-Colors.html#GdkColor"><span class="type">GdkColor</span></a> to fill in. </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>
@ -2617,7 +2617,7 @@ gtk_paint_resize_grip (<em class="parameter"><code><a class="link" href="GtkStyl
<em class="parameter"><code><a class="link" href="GtkWidget.html#GtkStateType" title="enum GtkStateType"><span class="type">GtkStateType</span></a> state_type</code></em>,
<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>,
<em class="parameter"><code>const <span class="type">gchar</span> *detail</code></em>,
<em class="parameter"><code><span class="type">GdkWindowEdge</span> edge</code></em>,
<em class="parameter"><code><a href="../html/gdk3-Windows.html#GdkWindowEdge"><span class="type">GdkWindowEdge</span></a> edge</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>,
@ -2698,7 +2698,7 @@ parameters.</p>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_draw_insertion_cursor (<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</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>,
<em class="parameter"><code>const <span class="type">GdkRectangle</span> *location</code></em>,
<em class="parameter"><code>const <a href="../html/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *location</code></em>,
<em class="parameter"><code><span class="type">gboolean</span> is_primary</code></em>,
<em class="parameter"><code><a class="link" href="GtkWidget.html#GtkTextDirection" title="enum GtkTextDirection"><span class="type">GtkTextDirection</span></a> direction</code></em>,
<em class="parameter"><code><span class="type">gboolean</span> draw_arrow</code></em>);</pre>
@ -2800,53 +2800,53 @@ cursor. Should be <code class="literal">FALSE</code> unless the cursor is split.
</colgroup>
<tbody>
<tr>
<td class="struct_member_name"><p><span class="type">GdkColor</span> <em class="structfield"><code><a name="GtkStyle-struct.fg"></a>fg</code></em>[5];</p></td>
<td class="struct_member_description"><p>Set of foreground <span class="type">GdkColor</span></p></td>
<td class="struct_member_name"><p><a href="../html/gdk3-Colors.html#GdkColor"><span class="type">GdkColor</span></a> <em class="structfield"><code><a name="GtkStyle-struct.fg"></a>fg</code></em>[5];</p></td>
<td class="struct_member_description"><p>Set of foreground <a href="../html/gdk3-Colors.html#GdkColor"><span class="type">GdkColor</span></a></p></td>
<td class="struct_member_annotations"> </td>
</tr>
<tr>
<td class="struct_member_name"><p><span class="type">GdkColor</span> <em class="structfield"><code><a name="GtkStyle-struct.bg"></a>bg</code></em>[5];</p></td>
<td class="struct_member_description"><p>Set of background <span class="type">GdkColor</span></p></td>
<td class="struct_member_name"><p><a href="../html/gdk3-Colors.html#GdkColor"><span class="type">GdkColor</span></a> <em class="structfield"><code><a name="GtkStyle-struct.bg"></a>bg</code></em>[5];</p></td>
<td class="struct_member_description"><p>Set of background <a href="../html/gdk3-Colors.html#GdkColor"><span class="type">GdkColor</span></a></p></td>
<td class="struct_member_annotations"> </td>
</tr>
<tr>
<td class="struct_member_name"><p><span class="type">GdkColor</span> <em class="structfield"><code><a name="GtkStyle-struct.light"></a>light</code></em>[5];</p></td>
<td class="struct_member_description"><p>Set of light <span class="type">GdkColor</span></p></td>
<td class="struct_member_name"><p><a href="../html/gdk3-Colors.html#GdkColor"><span class="type">GdkColor</span></a> <em class="structfield"><code><a name="GtkStyle-struct.light"></a>light</code></em>[5];</p></td>
<td class="struct_member_description"><p>Set of light <a href="../html/gdk3-Colors.html#GdkColor"><span class="type">GdkColor</span></a></p></td>
<td class="struct_member_annotations"> </td>
</tr>
<tr>
<td class="struct_member_name"><p><span class="type">GdkColor</span> <em class="structfield"><code><a name="GtkStyle-struct.dark"></a>dark</code></em>[5];</p></td>
<td class="struct_member_description"><p>Set of dark <span class="type">GdkColor</span></p></td>
<td class="struct_member_name"><p><a href="../html/gdk3-Colors.html#GdkColor"><span class="type">GdkColor</span></a> <em class="structfield"><code><a name="GtkStyle-struct.dark"></a>dark</code></em>[5];</p></td>
<td class="struct_member_description"><p>Set of dark <a href="../html/gdk3-Colors.html#GdkColor"><span class="type">GdkColor</span></a></p></td>
<td class="struct_member_annotations"> </td>
</tr>
<tr>
<td class="struct_member_name"><p><span class="type">GdkColor</span> <em class="structfield"><code><a name="GtkStyle-struct.mid"></a>mid</code></em>[5];</p></td>
<td class="struct_member_description"><p>Set of mid <span class="type">GdkColor</span></p></td>
<td class="struct_member_name"><p><a href="../html/gdk3-Colors.html#GdkColor"><span class="type">GdkColor</span></a> <em class="structfield"><code><a name="GtkStyle-struct.mid"></a>mid</code></em>[5];</p></td>
<td class="struct_member_description"><p>Set of mid <a href="../html/gdk3-Colors.html#GdkColor"><span class="type">GdkColor</span></a></p></td>
<td class="struct_member_annotations"> </td>
</tr>
<tr>
<td class="struct_member_name"><p><span class="type">GdkColor</span> <em class="structfield"><code><a name="GtkStyle-struct.text"></a>text</code></em>[5];</p></td>
<td class="struct_member_description"><p>Set of text <span class="type">GdkColor</span></p></td>
<td class="struct_member_name"><p><a href="../html/gdk3-Colors.html#GdkColor"><span class="type">GdkColor</span></a> <em class="structfield"><code><a name="GtkStyle-struct.text"></a>text</code></em>[5];</p></td>
<td class="struct_member_description"><p>Set of text <a href="../html/gdk3-Colors.html#GdkColor"><span class="type">GdkColor</span></a></p></td>
<td class="struct_member_annotations"> </td>
</tr>
<tr>
<td class="struct_member_name"><p><span class="type">GdkColor</span> <em class="structfield"><code><a name="GtkStyle-struct.base"></a>base</code></em>[5];</p></td>
<td class="struct_member_description"><p>Set of base <span class="type">GdkColor</span></p></td>
<td class="struct_member_name"><p><a href="../html/gdk3-Colors.html#GdkColor"><span class="type">GdkColor</span></a> <em class="structfield"><code><a name="GtkStyle-struct.base"></a>base</code></em>[5];</p></td>
<td class="struct_member_description"><p>Set of base <a href="../html/gdk3-Colors.html#GdkColor"><span class="type">GdkColor</span></a></p></td>
<td class="struct_member_annotations"> </td>
</tr>
<tr>
<td class="struct_member_name"><p><span class="type">GdkColor</span> <em class="structfield"><code><a name="GtkStyle-struct.text-aa"></a>text_aa</code></em>[5];</p></td>
<td class="struct_member_name"><p><a href="../html/gdk3-Colors.html#GdkColor"><span class="type">GdkColor</span></a> <em class="structfield"><code><a name="GtkStyle-struct.text-aa"></a>text_aa</code></em>[5];</p></td>
<td class="struct_member_description"><p>Color halfway between text/base</p></td>
<td class="struct_member_annotations"> </td>
</tr>
<tr>
<td class="struct_member_name"><p><span class="type">GdkColor</span> <em class="structfield"><code><a name="GtkStyle-struct.black"></a>black</code></em>;</p></td>
<td class="struct_member_description"><p><span class="type">GdkColor</span> to use for black</p></td>
<td class="struct_member_name"><p><a href="../html/gdk3-Colors.html#GdkColor"><span class="type">GdkColor</span></a> <em class="structfield"><code><a name="GtkStyle-struct.black"></a>black</code></em>;</p></td>
<td class="struct_member_description"><p><a href="../html/gdk3-Colors.html#GdkColor"><span class="type">GdkColor</span></a> to use for black</p></td>
<td class="struct_member_annotations"> </td>
</tr>
<tr>
<td class="struct_member_name"><p><span class="type">GdkColor</span> <em class="structfield"><code><a name="GtkStyle-struct.white"></a>white</code></em>;</p></td>
<td class="struct_member_description"><p><span class="type">GdkColor</span> to use for white</p></td>
<td class="struct_member_name"><p><a href="../html/gdk3-Colors.html#GdkColor"><span class="type">GdkColor</span></a> <em class="structfield"><code><a name="GtkStyle-struct.white"></a>white</code></em>;</p></td>
<td class="struct_member_description"><p><a href="../html/gdk3-Colors.html#GdkColor"><span class="type">GdkColor</span></a> to use for white</p></td>
<td class="struct_member_annotations"> </td>
</tr>
<tr>

80
docs/reference/gtk/html/GtkStyleContext.html
View File

@ -115,7 +115,7 @@
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">GdkScreen</span> *
<a href="../html/GdkScreen.html#GdkScreen-struct"><span class="returnvalue">GdkScreen</span></a> *
</td>
<td class="function_name">
<a class="link" href="GtkStyleContext.html#gtk-style-context-get-screen" title="gtk_style_context_get_screen ()">gtk_style_context_get_screen</a> <span class="c_punctuation">()</span>
@ -123,7 +123,7 @@
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">GdkFrameClock</span> *
<a href="../html/GdkFrameClock.html#GdkFrameClock-struct"><span class="returnvalue">GdkFrameClock</span></a> *
</td>
<td class="function_name">
<a class="link" href="GtkStyleContext.html#gtk-style-context-get-frame-clock" title="gtk_style_context_get_frame_clock ()">gtk_style_context_get_frame_clock</a> <span class="c_punctuation">()</span>
@ -691,7 +691,7 @@
</tr>
<tr>
<td class="property_type">
<span class="type">GdkFrameClock</span> *</td>
<a href="../html/GdkFrameClock.html#GdkFrameClock-struct"><span class="type">GdkFrameClock</span></a> *</td>
<td class="property_name"><a class="link" href="GtkStyleContext.html#GtkStyleContext--paint-clock" title="The “paint-clock” property">paint-clock</a></td>
<td class="property_flags">Read / Write</td>
</tr>
@ -703,7 +703,7 @@
</tr>
<tr>
<td class="property_type">
<span class="type">GdkScreen</span> *</td>
<a href="../html/GdkScreen.html#GdkScreen-struct"><span class="type">GdkScreen</span></a> *</td>
<td class="property_name"><a class="link" href="GtkStyleContext.html#GtkStyleContext--screen" title="The “screen” property">screen</a></td>
<td class="property_flags">Read / Write</td>
</tr>
@ -1177,7 +1177,7 @@ can be either attached explicitly to the context through
combination of all providers’ information in priority order.</p>
<p>For GTK+ widgets, any <a class="link" href="GtkStyleContext.html" title="GtkStyleContext"><span class="type">GtkStyleContext</span></a> returned by
<a class="link" href="GtkWidget.html#gtk-widget-get-style-context" title="gtk_widget_get_style_context ()"><code class="function">gtk_widget_get_style_context()</code></a> will already have a <a class="link" href="gtk3-GtkWidgetPath.html#GtkWidgetPath" title="GtkWidgetPath"><span class="type">GtkWidgetPath</span></a>, a
<span class="type">GdkScreen</span> and RTL/LTR information set. The style context will also be
<a href="../html/GdkScreen.html#GdkScreen-struct"><span class="type">GdkScreen</span></a> and RTL/LTR information set. The style context will also be
updated automatically if any of these settings change on the widget.</p>
<p>If you are using the theming layer standalone, you will need to set a
widget path and a screen yourself to the created style context through
@ -1290,7 +1290,7 @@ between <a class="link" href="GtkStyleProvider.html#GTK-STYLE-PROVIDER-PRIORITY-
<a name="gtk-style-context-add-provider-for-screen"></a><h3>gtk_style_context_add_provider_for_screen ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_style_context_add_provider_for_screen
(<em class="parameter"><code><span class="type">GdkScreen</span> *screen</code></em>,
(<em class="parameter"><code><a href="../html/GdkScreen.html#GdkScreen-struct"><span class="type">GdkScreen</span></a> *screen</code></em>,
<em class="parameter"><code><a class="link" href="GtkStyleProvider.html" title="GtkStyleProvider"><span class="type">GtkStyleProvider</span></a> *provider</code></em>,
<em class="parameter"><code><span class="type">guint</span> priority</code></em>);</pre>
<p>Adds a global style provider to <em class="parameter"><code>screen</code></em>
@ -1313,7 +1313,7 @@ over another added through this function.</p>
<tbody>
<tr>
<td class="parameter_name"><p>screen</p></td>
<td class="parameter_description"><p>a <span class="type">GdkScreen</span></p></td>
<td class="parameter_description"><p>a <a href="../html/GdkScreen.html#GdkScreen-struct"><span class="type">GdkScreen</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
@ -1550,9 +1550,9 @@ to free any allocated memory.</p>
<hr>
<div class="refsect2">
<a name="gtk-style-context-get-screen"></a><h3>gtk_style_context_get_screen ()</h3>
<pre class="programlisting"><span class="returnvalue">GdkScreen</span> *
<pre class="programlisting"><a href="../html/GdkScreen.html#GdkScreen-struct"><span class="returnvalue">GdkScreen</span></a> *
gtk_style_context_get_screen (<em class="parameter"><code><a class="link" href="GtkStyleContext.html" title="GtkStyleContext"><span class="type">GtkStyleContext</span></a> *context</code></em>);</pre>
<p>Returns the <span class="type">GdkScreen</span> to which <em class="parameter"><code>context</code></em>
<p>Returns the <a href="../html/GdkScreen.html#GdkScreen-struct"><span class="type">GdkScreen</span></a> to which <em class="parameter"><code>context</code></em>
is attached.</p>
<div class="refsect3">
<a name="gtk-style-context-get-screen.parameters"></a><h4>Parameters</h4>
@ -1571,16 +1571,16 @@ gtk_style_context_get_screen (<em class="parameter"><code><a class="link" href="
</div>
<div class="refsect3">
<a name="gtk-style-context-get-screen.returns"></a><h4>Returns</h4>
<p>a <span class="type">GdkScreen</span>. </p>
<p>a <a href="../html/GdkScreen.html#GdkScreen-struct"><span class="type">GdkScreen</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>
</div>
<hr>
<div class="refsect2">
<a name="gtk-style-context-get-frame-clock"></a><h3>gtk_style_context_get_frame_clock ()</h3>
<pre class="programlisting"><span class="returnvalue">GdkFrameClock</span> *
<pre class="programlisting"><a href="../html/GdkFrameClock.html#GdkFrameClock-struct"><span class="returnvalue">GdkFrameClock</span></a> *
gtk_style_context_get_frame_clock (<em class="parameter"><code><a class="link" href="GtkStyleContext.html" title="GtkStyleContext"><span class="type">GtkStyleContext</span></a> *context</code></em>);</pre>
<p>Returns the <span class="type">GdkFrameClock</span> to which <em class="parameter"><code>context</code></em>
<p>Returns the <a href="../html/GdkFrameClock.html#GdkFrameClock-struct"><span class="type">GdkFrameClock</span></a> to which <em class="parameter"><code>context</code></em>
is attached.</p>
<div class="refsect3">
<a name="gtk-style-context-get-frame-clock.parameters"></a><h4>Parameters</h4>
@ -1599,7 +1599,7 @@ gtk_style_context_get_frame_clock (<em class="parameter"><code><a class="link" h
</div>
<div class="refsect3">
<a name="gtk-style-context-get-frame-clock.returns"></a><h4>Returns</h4>
<p>a <span class="type">GdkFrameClock</span>, or <code class="literal">NULL</code>
<p>a <a href="../html/GdkFrameClock.html#GdkFrameClock-struct"><span class="type">GdkFrameClock</span></a>, or <code class="literal">NULL</code>
if <em class="parameter"><code>context</code></em>
does not have an attached frame clock. </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>
@ -1836,7 +1836,7 @@ was defined. </p>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_style_context_get_color (<em class="parameter"><code><a class="link" href="GtkStyleContext.html" title="GtkStyleContext"><span class="type">GtkStyleContext</span></a> *context</code></em>,
<em class="parameter"><code><a class="link" href="gtk3-Standard-Enumerations.html#GtkStateFlags" title="enum GtkStateFlags"><span class="type">GtkStateFlags</span></a> state</code></em>,
<em class="parameter"><code><span class="type">GdkRGBA</span> *color</code></em>);</pre>
<em class="parameter"><code><a href="../html/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a> *color</code></em>);</pre>
<p>Gets the foreground color for a given state.</p>
<p>See <a class="link" href="GtkStyleContext.html#gtk-style-context-get-property" title="gtk_style_context_get_property ()"><code class="function">gtk_style_context_get_property()</code></a> and
<a class="link" href="GtkStyleContext.html#GTK-STYLE-PROPERTY-COLOR:CAPS" title="GTK_STYLE_PROPERTY_COLOR"><span class="type">GTK_STYLE_PROPERTY_COLOR</span></a> for details.</p>
@ -1876,7 +1876,7 @@ gtk_style_context_get_color (<em class="parameter"><code><a class="link" href="G
gtk_style_context_get_background_color
(<em class="parameter"><code><a class="link" href="GtkStyleContext.html" title="GtkStyleContext"><span class="type">GtkStyleContext</span></a> *context</code></em>,
<em class="parameter"><code><a class="link" href="gtk3-Standard-Enumerations.html#GtkStateFlags" title="enum GtkStateFlags"><span class="type">GtkStateFlags</span></a> state</code></em>,
<em class="parameter"><code><span class="type">GdkRGBA</span> *color</code></em>);</pre>
<em class="parameter"><code><a href="../html/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a> *color</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_style_context_get_background_color</code> has been deprecated since version 3.16 and should not be used in newly-written code.</p>
<p>Use <a class="link" href="GtkStyleContext.html#gtk-render-background" title="gtk_render_background ()"><code class="function">gtk_render_background()</code></a> instead.</p>
@ -1924,7 +1924,7 @@ style classes to modify the color to be rendered.</p>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_style_context_get_border_color (<em class="parameter"><code><a class="link" href="GtkStyleContext.html" title="GtkStyleContext"><span class="type">GtkStyleContext</span></a> *context</code></em>,
<em class="parameter"><code><a class="link" href="gtk3-Standard-Enumerations.html#GtkStateFlags" title="enum GtkStateFlags"><span class="type">GtkStateFlags</span></a> state</code></em>,
<em class="parameter"><code><span class="type">GdkRGBA</span> *color</code></em>);</pre>
<em class="parameter"><code><a href="../html/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a> *color</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_style_context_get_border_color</code> has been deprecated since version 3.16 and should not be used in newly-written code.</p>
<p>Use <a class="link" href="GtkStyleContext.html#gtk-render-frame" title="gtk_render_frame ()"><code class="function">gtk_render_frame()</code></a> instead.</p>
@ -2212,7 +2212,7 @@ it’s being unset.</p>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gtk_style_context_lookup_color (<em class="parameter"><code><a class="link" href="GtkStyleContext.html" title="GtkStyleContext"><span class="type">GtkStyleContext</span></a> *context</code></em>,
<em class="parameter"><code>const <span class="type">gchar</span> *color_name</code></em>,
<em class="parameter"><code><span class="type">GdkRGBA</span> *color</code></em>);</pre>
<em class="parameter"><code><a href="../html/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a> *color</code></em>);</pre>
<p>Looks up and resolves a color name in the <em class="parameter"><code>context</code></em>
color map.</p>
<div class="refsect3">
@ -2296,7 +2296,7 @@ the default icon factory, returning an icon set if found, otherwise
<a name="gtk-style-context-notify-state-change"></a><h3>gtk_style_context_notify_state_change ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_style_context_notify_state_change (<em class="parameter"><code><a class="link" href="GtkStyleContext.html" title="GtkStyleContext"><span class="type">GtkStyleContext</span></a> *context</code></em>,
<em class="parameter"><code><span class="type">GdkWindow</span> *window</code></em>,
<em class="parameter"><code><a href="../html/gdk3-Windows.html#GdkWindow-struct"><span class="type">GdkWindow</span></a> *window</code></em>,
<em class="parameter"><code><span class="type">gpointer</span> region_id</code></em>,
<em class="parameter"><code><a class="link" href="GtkWidget.html#GtkStateType" title="enum GtkStateType"><span class="type">GtkStateType</span></a> state</code></em>,
<em class="parameter"><code><span class="type">gboolean</span> state_value</code></em>);</pre>
@ -2391,7 +2391,7 @@ is why the style places the transition under the :hover pseudo-class.</p>
</tr>
<tr>
<td class="parameter_name"><p>window</p></td>
<td class="parameter_description"><p>a <span class="type">GdkWindow</span></p></td>
<td class="parameter_description"><p>a <a href="../html/gdk3-Windows.html#GdkWindow-struct"><span class="type">GdkWindow</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
@ -2543,14 +2543,14 @@ See <a class="link" href="GtkStyleContext.html#gtk-style-context-push-animatable
<a name="gtk-style-context-scroll-animations"></a><h3>gtk_style_context_scroll_animations ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_style_context_scroll_animations (<em class="parameter"><code><a class="link" href="GtkStyleContext.html" title="GtkStyleContext"><span class="type">GtkStyleContext</span></a> *context</code></em>,
<em class="parameter"><code><span class="type">GdkWindow</span> *window</code></em>,
<em class="parameter"><code><a href="../html/gdk3-Windows.html#GdkWindow-struct"><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>
<div class="warning">
<p><code class="literal">gtk_style_context_scroll_animations</code> has been deprecated since version 3.6 and should not be used in newly-written code.</p>
<p>This function does nothing.</p>
</div>
<p>This function is analogous to <code class="function">gdk_window_scroll()</code>, and
<p>This function is analogous to <a href="../html/gdk3-Windows.html#gdk-window-scroll"><code class="function">gdk_window_scroll()</code></a>, and
should be called together with it so the invalidation
areas for any ongoing animation are scrolled together
with it.</p>
@ -2570,7 +2570,7 @@ with it.</p>
</tr>
<tr>
<td class="parameter_name"><p>window</p></td>
<td class="parameter_description"><p>a <span class="type">GdkWindow</span> used previously in
<td class="parameter_description"><p>a <a href="../html/gdk3-Windows.html#GdkWindow-struct"><span class="type">GdkWindow</span></a> used previously in
<a class="link" href="GtkStyleContext.html#gtk-style-context-notify-state-change" title="gtk_style_context_notify_state_change ()"><code class="function">gtk_style_context_notify_state_change()</code></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
@ -2627,7 +2627,7 @@ gtk_style_context_remove_provider (<em class="parameter"><code><a class="link" h
<a name="gtk-style-context-remove-provider-for-screen"></a><h3>gtk_style_context_remove_provider_for_screen ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_style_context_remove_provider_for_screen
(<em class="parameter"><code><span class="type">GdkScreen</span> *screen</code></em>,
(<em class="parameter"><code><a href="../html/GdkScreen.html#GdkScreen-struct"><span class="type">GdkScreen</span></a> *screen</code></em>,
<em class="parameter"><code><a class="link" href="GtkStyleProvider.html" title="GtkStyleProvider"><span class="type">GtkStyleProvider</span></a> *provider</code></em>);</pre>
<p>Removes <em class="parameter"><code>provider</code></em>
from the global style providers list in <em class="parameter"><code>screen</code></em>
@ -2643,7 +2643,7 @@ gtk_style_context_remove_provider_for_screen
<tbody>
<tr>
<td class="parameter_name"><p>screen</p></td>
<td class="parameter_description"><p>a <span class="type">GdkScreen</span></p></td>
<td class="parameter_description"><p>a <a href="../html/GdkScreen.html#GdkScreen-struct"><span class="type">GdkScreen</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
@ -2660,9 +2660,9 @@ gtk_style_context_remove_provider_for_screen
<div class="refsect2">
<a name="gtk-style-context-reset-widgets"></a><h3>gtk_style_context_reset_widgets ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_style_context_reset_widgets (<em class="parameter"><code><span class="type">GdkScreen</span> *screen</code></em>);</pre>
gtk_style_context_reset_widgets (<em class="parameter"><code><a href="../html/GdkScreen.html#GdkScreen-struct"><span class="type">GdkScreen</span></a> *screen</code></em>);</pre>
<p>This function recomputes the styles for all widgets under a particular
<span class="type">GdkScreen</span>. This is useful when some global parameter has changed that
<a href="../html/GdkScreen.html#GdkScreen-struct"><span class="type">GdkScreen</span></a>. This is useful when some global parameter has changed that
affects the appearance of all widgets, because when a widget gets a new
style, it will both redraw and recompute any cached information about
its appearance. As an example, it is used when the color scheme changes
@ -2677,7 +2677,7 @@ in the related <a class="link" href="GtkSettings.html" title="Settings"><span cl
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>screen</p></td>
<td class="parameter_description"><p>a <span class="type">GdkScreen</span></p></td>
<td class="parameter_description"><p>a <a href="../html/GdkScreen.html#GdkScreen-struct"><span class="type">GdkScreen</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
@ -2689,7 +2689,7 @@ in the related <a class="link" href="GtkSettings.html" title="Settings"><span cl
<a name="gtk-style-context-set-background"></a><h3>gtk_style_context_set_background ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_style_context_set_background (<em class="parameter"><code><a class="link" href="GtkStyleContext.html" title="GtkStyleContext"><span class="type">GtkStyleContext</span></a> *context</code></em>,
<em class="parameter"><code><span class="type">GdkWindow</span> *window</code></em>);</pre>
<em class="parameter"><code><a href="../html/gdk3-Windows.html#GdkWindow-struct"><span class="type">GdkWindow</span></a> *window</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_style_context_set_background</code> has been deprecated since version 3.18 and should not be used in newly-written code.</p>
<p>Use <a class="link" href="GtkStyleContext.html#gtk-render-background" title="gtk_render_background ()"><code class="function">gtk_render_background()</code></a> instead.
@ -2717,7 +2717,7 @@ color specified in <em class="parameter"><code>context</code></em>
</tr>
<tr>
<td class="parameter_name"><p>window</p></td>
<td class="parameter_description"><p>a <span class="type">GdkWindow</span></p></td>
<td class="parameter_description"><p>a <a href="../html/gdk3-Windows.html#GdkWindow-struct"><span class="type">GdkWindow</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
@ -3288,7 +3288,7 @@ itself with <code class="function">g_list_free()</code> when you are done with i
<a name="gtk-style-context-set-screen"></a><h3>gtk_style_context_set_screen ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_style_context_set_screen (<em class="parameter"><code><a class="link" href="GtkStyleContext.html" title="GtkStyleContext"><span class="type">GtkStyleContext</span></a> *context</code></em>,
<em class="parameter"><code><span class="type">GdkScreen</span> *screen</code></em>);</pre>
<em class="parameter"><code><a href="../html/GdkScreen.html#GdkScreen-struct"><span class="type">GdkScreen</span></a> *screen</code></em>);</pre>
<p>Attaches <em class="parameter"><code>context</code></em>
to the given screen.</p>
<p>The screen is used to add style information from “global” style
@ -3312,7 +3312,7 @@ call this yourself.</p>
</tr>
<tr>
<td class="parameter_name"><p>screen</p></td>
<td class="parameter_description"><p>a <span class="type">GdkScreen</span></p></td>
<td class="parameter_description"><p>a <a href="../html/GdkScreen.html#GdkScreen-struct"><span class="type">GdkScreen</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
@ -3325,7 +3325,7 @@ call this yourself.</p>
<a name="gtk-style-context-set-frame-clock"></a><h3>gtk_style_context_set_frame_clock ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_style_context_set_frame_clock (<em class="parameter"><code><a class="link" href="GtkStyleContext.html" title="GtkStyleContext"><span class="type">GtkStyleContext</span></a> *context</code></em>,
<em class="parameter"><code><span class="type">GdkFrameClock</span> *frame_clock</code></em>);</pre>
<em class="parameter"><code><a href="../html/GdkFrameClock.html#GdkFrameClock-struct"><span class="type">GdkFrameClock</span></a> *frame_clock</code></em>);</pre>
<p>Attaches <em class="parameter"><code>context</code></em>
to the given frame clock.</p>
<p>The frame clock is used for the timing of animations.</p>
@ -3343,12 +3343,12 @@ call this yourself.</p>
<tbody>
<tr>
<td class="parameter_name"><p>context</p></td>
<td class="parameter_description"><p>a <span class="type">GdkFrameClock</span></p></td>
<td class="parameter_description"><p>a <a href="../html/GdkFrameClock.html#GdkFrameClock-struct"><span class="type">GdkFrameClock</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>frame_clock</p></td>
<td class="parameter_description"><p>a <span class="type">GdkFrameClock</span></p></td>
<td class="parameter_description"><p>a <a href="../html/GdkFrameClock.html#GdkFrameClock-struct"><span class="type">GdkFrameClock</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
@ -3678,7 +3678,7 @@ gtk_render_background_get_clip (<em class="parameter"><code><a class="link" href
<em class="parameter"><code><span class="type">gdouble</span> y</code></em>,
<em class="parameter"><code><span class="type">gdouble</span> width</code></em>,
<em class="parameter"><code><span class="type">gdouble</span> height</code></em>,
<em class="parameter"><code><span class="type">GdkRectangle</span> *out_clip</code></em>);</pre>
<em class="parameter"><code><a href="../html/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *out_clip</code></em>);</pre>
<p>Returns the area that will be affected (i.e. drawn to) when
calling <a class="link" href="GtkStyleContext.html#gtk-render-background" title="gtk_render_background ()"><code class="function">gtk_render_background()</code></a> for the given <em class="parameter"><code>context</code></em>
and
@ -4725,14 +4725,14 @@ gtk_render_insertion_cursor (<em class="parameter"><code><a class="link" href="G
<a name="GTK-STYLE-PROPERTY-BACKGROUND-COLOR:CAPS"></a><h3>GTK_STYLE_PROPERTY_BACKGROUND_COLOR</h3>
<pre class="programlisting">#define GTK_STYLE_PROPERTY_BACKGROUND_COLOR "background-color"
</pre>
<p>A property holding the background color of rendered elements as a <span class="type">GdkRGBA</span>.</p>
<p>A property holding the background color of rendered elements as a <a href="../html/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a>.</p>
</div>
<hr>
<div class="refsect2">
<a name="GTK-STYLE-PROPERTY-COLOR:CAPS"></a><h3>GTK_STYLE_PROPERTY_COLOR</h3>
<pre class="programlisting">#define GTK_STYLE_PROPERTY_COLOR "color"
</pre>
<p>A property holding the foreground color of rendered elements as a <span class="type">GdkRGBA</span>.</p>
<p>A property holding the foreground color of rendered elements as a <a href="../html/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a>.</p>
</div>
<hr>
<div class="refsect2">
@ -4794,7 +4794,7 @@ requesting size</p>
<a name="GTK-STYLE-PROPERTY-BORDER-COLOR:CAPS"></a><h3>GTK_STYLE_PROPERTY_BORDER_COLOR</h3>
<pre class="programlisting">#define GTK_STYLE_PROPERTY_BORDER_COLOR "border-color"
</pre>
<p>A property holding the element’s border color as a <span class="type">GdkRGBA</span>.</p>
<p>A property holding the element’s border color as a <a href="../html/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a>.</p>
</div>
<hr>
<div class="refsect2">
@ -5903,7 +5903,7 @@ that can be of different width on each side.</p>
<hr>
<div class="refsect2">
<a name="GtkStyleContext--paint-clock"></a><h3>The <code class="literal">“paint-clock”</code> property</h3>
<pre class="programlisting"> “paint-clock” <span class="type">GdkFrameClock</span> *</pre>
<pre class="programlisting"> “paint-clock” <a href="../html/GdkFrameClock.html#GdkFrameClock-struct"><span class="type">GdkFrameClock</span></a> *</pre>
<p>The associated GdkFrameClock.</p>
<p>Flags: Read / Write</p>
</div>
@ -5919,7 +5919,7 @@ for details.</p>
<hr>
<div class="refsect2">
<a name="GtkStyleContext--screen"></a><h3>The <code class="literal">“screen”</code> property</h3>
<pre class="programlisting"> “screen” <span class="type">GdkScreen</span> *</pre>
<pre class="programlisting"> “screen” <a href="../html/GdkScreen.html#GdkScreen-struct"><span class="type">GdkScreen</span></a> *</pre>
<p>The associated GdkScreen.</p>
<p>Flags: Read / Write</p>
</div>

58
docs/reference/gtk/html/GtkTextBuffer.html
View File

@ -564,7 +564,7 @@
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">GdkAtom</span> *
<a href="../html/gdk3-Properties-and-Atoms.html#GdkAtom"><span class="returnvalue">GdkAtom</span></a> *
</td>
<td class="function_name">
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-get-deserialize-formats" title="gtk_text_buffer_get_deserialize_formats ()">gtk_text_buffer_get_deserialize_formats</a> <span class="c_punctuation">()</span>
@ -580,7 +580,7 @@
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">GdkAtom</span> *
<a href="../html/gdk3-Properties-and-Atoms.html#GdkAtom"><span class="returnvalue">GdkAtom</span></a> *
</td>
<td class="function_name">
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-get-serialize-formats" title="gtk_text_buffer_get_serialize_formats ()">gtk_text_buffer_get_serialize_formats</a> <span class="c_punctuation">()</span>
@ -588,7 +588,7 @@
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">GdkAtom</span>
<a href="../html/gdk3-Properties-and-Atoms.html#GdkAtom"><span class="returnvalue">GdkAtom</span></a>
</td>
<td class="function_name">
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-register-deserialize-format" title="gtk_text_buffer_register_deserialize_format ()">gtk_text_buffer_register_deserialize_format</a> <span class="c_punctuation">()</span>
@ -596,7 +596,7 @@
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">GdkAtom</span>
<a href="../html/gdk3-Properties-and-Atoms.html#GdkAtom"><span class="returnvalue">GdkAtom</span></a>
</td>
<td class="function_name">
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-register-deserialize-tagset" title="gtk_text_buffer_register_deserialize_tagset ()">gtk_text_buffer_register_deserialize_tagset</a> <span class="c_punctuation">()</span>
@ -604,7 +604,7 @@
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">GdkAtom</span>
<a href="../html/gdk3-Properties-and-Atoms.html#GdkAtom"><span class="returnvalue">GdkAtom</span></a>
</td>
<td class="function_name">
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-register-serialize-format" title="gtk_text_buffer_register_serialize_format ()">gtk_text_buffer_register_serialize_format</a> <span class="c_punctuation">()</span>
@ -612,7 +612,7 @@
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">GdkAtom</span>
<a href="../html/gdk3-Properties-and-Atoms.html#GdkAtom"><span class="returnvalue">GdkAtom</span></a>
</td>
<td class="function_name">
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-register-serialize-tagset" title="gtk_text_buffer_register_serialize_tagset ()">gtk_text_buffer_register_serialize_tagset</a> <span class="c_punctuation">()</span>
@ -3355,7 +3355,7 @@ gtk_text_buffer_add_selection_clipboard
contents of <em class="parameter"><code>buffer</code></em>
are available. In most cases, <em class="parameter"><code>clipboard</code></em>
will be
the <a class="link" href="gtk3-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> of type <code class="literal">GDK_SELECTION_PRIMARY</code> for a view of <em class="parameter"><code>buffer</code></em>
the <a class="link" href="gtk3-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> of type <a href="../html/gdk3-Selections.html#GDK-SELECTION-PRIMARY:CAPS"><code class="literal">GDK_SELECTION_PRIMARY</code></a> for a view of <em class="parameter"><code>buffer</code></em>
.</p>
<div class="refsect3">
<a name="gtk-text-buffer-add-selection-clipboard.parameters"></a><h4>Parameters</h4>
@ -3493,7 +3493,7 @@ serialized with <a class="link" href="GtkTextBuffer.html#gtk-text-buffer-seriali
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gtk_text_buffer_deserialize (<em class="parameter"><code><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *register_buffer</code></em>,
<em class="parameter"><code><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *content_buffer</code></em>,
<em class="parameter"><code><span class="type">GdkAtom</span> format</code></em>,
<em class="parameter"><code><a href="../html/gdk3-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> format</code></em>,
<em class="parameter"><code><a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>,
<em class="parameter"><code>const <span class="type">guint8</span> *data</code></em>,
<em class="parameter"><code><span class="type">gsize</span> length</code></em>,
@ -3567,7 +3567,7 @@ is registered with</p></td>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gtk_text_buffer_deserialize_get_can_create_tags
(<em class="parameter"><code><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *buffer</code></em>,
<em class="parameter"><code><span class="type">GdkAtom</span> format</code></em>);</pre>
<em class="parameter"><code><a href="../html/gdk3-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> format</code></em>);</pre>
<p>This functions returns the value set with
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-deserialize-set-can-create-tags" title="gtk_text_buffer_deserialize_set_can_create_tags ()"><code class="function">gtk_text_buffer_deserialize_set_can_create_tags()</code></a></p>
<div class="refsect3">
@ -3586,7 +3586,7 @@ gtk_text_buffer_deserialize_get_can_create_tags
</tr>
<tr>
<td class="parameter_name"><p>format</p></td>
<td class="parameter_description"><p>a <span class="type">GdkAtom</span> representing a registered rich text format</p></td>
<td class="parameter_description"><p>a <a href="../html/gdk3-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> representing a registered rich text format</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
@ -3604,7 +3604,7 @@ gtk_text_buffer_deserialize_get_can_create_tags
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_text_buffer_deserialize_set_can_create_tags
(<em class="parameter"><code><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *buffer</code></em>,
<em class="parameter"><code><span class="type">GdkAtom</span> format</code></em>,
<em class="parameter"><code><a href="../html/gdk3-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> format</code></em>,
<em class="parameter"><code><span class="type">gboolean</span> can_create_tags</code></em>);</pre>
<p>Use this function to allow a rich text deserialization function to
create new tags in the receiving buffer. Note that using this
@ -3637,7 +3637,7 @@ handle the newly created tags.</p>
</tr>
<tr>
<td class="parameter_name"><p>format</p></td>
<td class="parameter_description"><p>a <span class="type">GdkAtom</span> representing a registered rich text format</p></td>
<td class="parameter_description"><p>a <a href="../html/gdk3-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> representing a registered rich text format</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
@ -3686,7 +3686,7 @@ using <a class="link" href="gtk3-Selections.html#gtk-target-list-add-rich-text-t
<hr>
<div class="refsect2">
<a name="gtk-text-buffer-get-deserialize-formats"></a><h3>gtk_text_buffer_get_deserialize_formats ()</h3>
<pre class="programlisting"><span class="returnvalue">GdkAtom</span> *
<pre class="programlisting"><a href="../html/gdk3-Properties-and-Atoms.html#GdkAtom"><span class="returnvalue">GdkAtom</span></a> *
gtk_text_buffer_get_deserialize_formats
(<em class="parameter"><code><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *buffer</code></em>,
<em class="parameter"><code><span class="type">gint</span> *n_formats</code></em>);</pre>
@ -3719,7 +3719,7 @@ with <em class="parameter"><code>buffer</code></em>
<div class="refsect3">
<a name="gtk-text-buffer-get-deserialize-formats.returns"></a><h4>Returns</h4>
<p>an array of
<span class="type">GdkAtoms</span> representing the registered formats. </p>
<a href="../html/gdk3-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtoms</span></a> representing the registered formats. </p>
<p><span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=n_formats][<acronym title="Free data container after the code is done."><span class="acronym">transfer container</span></acronym>]</span></p>
</div>
<p class="since">Since: 2.10</p>
@ -3760,7 +3760,7 @@ using <a class="link" href="gtk3-Selections.html#gtk-target-list-add-rich-text-t
<hr>
<div class="refsect2">
<a name="gtk-text-buffer-get-serialize-formats"></a><h3>gtk_text_buffer_get_serialize_formats ()</h3>
<pre class="programlisting"><span class="returnvalue">GdkAtom</span> *
<pre class="programlisting"><a href="../html/gdk3-Properties-and-Atoms.html#GdkAtom"><span class="returnvalue">GdkAtom</span></a> *
gtk_text_buffer_get_serialize_formats (<em class="parameter"><code><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *buffer</code></em>,
<em class="parameter"><code><span class="type">gint</span> *n_formats</code></em>);</pre>
<p>This function returns the rich text serialize formats registered
@ -3792,7 +3792,7 @@ with <em class="parameter"><code>buffer</code></em>
<div class="refsect3">
<a name="gtk-text-buffer-get-serialize-formats.returns"></a><h4>Returns</h4>
<p>an array of
<span class="type">GdkAtoms</span> representing the registered formats. </p>
<a href="../html/gdk3-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtoms</span></a> representing the registered formats. </p>
<p><span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=n_formats][<acronym title="Free data container after the code is done."><span class="acronym">transfer container</span></acronym>]</span></p>
</div>
<p class="since">Since: 2.10</p>
@ -3800,7 +3800,7 @@ with <em class="parameter"><code>buffer</code></em>
<hr>
<div class="refsect2">
<a name="gtk-text-buffer-register-deserialize-format"></a><h3>gtk_text_buffer_register_deserialize_format ()</h3>
<pre class="programlisting"><span class="returnvalue">GdkAtom</span>
<pre class="programlisting"><a href="../html/gdk3-Properties-and-Atoms.html#GdkAtom"><span class="returnvalue">GdkAtom</span></a>
gtk_text_buffer_register_deserialize_format
(<em class="parameter"><code><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *buffer</code></em>,
<em class="parameter"><code>const <span class="type">gchar</span> *mime_type</code></em>,
@ -3853,7 +3853,7 @@ is no longer needed</p></td>
</div>
<div class="refsect3">
<a name="gtk-text-buffer-register-deserialize-format.returns"></a><h4>Returns</h4>
<p>the <span class="type">GdkAtom</span> that corresponds to the
<p>the <a href="../html/gdk3-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> that corresponds to the
newly registered format’s mime-type. </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>
@ -3862,7 +3862,7 @@ newly registered format’s mime-type. </p>
<hr>
<div class="refsect2">
<a name="gtk-text-buffer-register-deserialize-tagset"></a><h3>gtk_text_buffer_register_deserialize_tagset ()</h3>
<pre class="programlisting"><span class="returnvalue">GdkAtom</span>
<pre class="programlisting"><a href="../html/gdk3-Properties-and-Atoms.html#GdkAtom"><span class="returnvalue">GdkAtom</span></a>
gtk_text_buffer_register_deserialize_tagset
(<em class="parameter"><code><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *buffer</code></em>,
<em class="parameter"><code>const <span class="type">gchar</span> *tagset_name</code></em>);</pre>
@ -3894,7 +3894,7 @@ format with the passed <em class="parameter"><code>buffer</code></em>
</div>
<div class="refsect3">
<a name="gtk-text-buffer-register-deserialize-tagset.returns"></a><h4>Returns</h4>
<p>the <span class="type">GdkAtom</span> that corresponds to the
<p>the <a href="../html/gdk3-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> that corresponds to the
newly registered format’s mime-type. </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>
@ -3903,7 +3903,7 @@ newly registered format’s mime-type. </p>
<hr>
<div class="refsect2">
<a name="gtk-text-buffer-register-serialize-format"></a><h3>gtk_text_buffer_register_serialize_format ()</h3>
<pre class="programlisting"><span class="returnvalue">GdkAtom</span>
<pre class="programlisting"><a href="../html/gdk3-Properties-and-Atoms.html#GdkAtom"><span class="returnvalue">GdkAtom</span></a>
gtk_text_buffer_register_serialize_format
(<em class="parameter"><code><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *buffer</code></em>,
<em class="parameter"><code>const <span class="type">gchar</span> *mime_type</code></em>,
@ -3956,7 +3956,7 @@ is no longer needed</p></td>
</div>
<div class="refsect3">
<a name="gtk-text-buffer-register-serialize-format.returns"></a><h4>Returns</h4>
<p>the <span class="type">GdkAtom</span> that corresponds to the
<p>the <a href="../html/gdk3-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> that corresponds to the
newly registered format’s mime-type. </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>
@ -3965,7 +3965,7 @@ newly registered format’s mime-type. </p>
<hr>
<div class="refsect2">
<a name="gtk-text-buffer-register-serialize-tagset"></a><h3>gtk_text_buffer_register_serialize_tagset ()</h3>
<pre class="programlisting"><span class="returnvalue">GdkAtom</span>
<pre class="programlisting"><a href="../html/gdk3-Properties-and-Atoms.html#GdkAtom"><span class="returnvalue">GdkAtom</span></a>
gtk_text_buffer_register_serialize_tagset
(<em class="parameter"><code><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *buffer</code></em>,
<em class="parameter"><code>const <span class="type">gchar</span> *tagset_name</code></em>);</pre>
@ -4012,7 +4012,7 @@ receiving buffer to deal with with pasting of arbitrary tags.</p>
</div>
<div class="refsect3">
<a name="gtk-text-buffer-register-serialize-tagset.returns"></a><h4>Returns</h4>
<p>the <span class="type">GdkAtom</span> that corresponds to the
<p>the <a href="../html/gdk3-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> that corresponds to the
newly registered format’s mime-type. </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>
@ -4085,7 +4085,7 @@ the serialized data, or <code class="literal">NULL</code> if an error occurred.
<pre class="programlisting"><span class="returnvalue">guint8</span> *
gtk_text_buffer_serialize (<em class="parameter"><code><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *register_buffer</code></em>,
<em class="parameter"><code><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *content_buffer</code></em>,
<em class="parameter"><code><span class="type">GdkAtom</span> format</code></em>,
<em class="parameter"><code><a href="../html/gdk3-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> format</code></em>,
<em class="parameter"><code>const <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *start</code></em>,
<em class="parameter"><code>const <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *end</code></em>,
<em class="parameter"><code><span class="type">gsize</span> *length</code></em>);</pre>
@ -4156,7 +4156,7 @@ data, encoded as <em class="parameter"><code>format</code></em>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_text_buffer_unregister_deserialize_format
(<em class="parameter"><code><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *buffer</code></em>,
<em class="parameter"><code><span class="type">GdkAtom</span> format</code></em>);</pre>
<em class="parameter"><code><a href="../html/gdk3-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> format</code></em>);</pre>
<p>This function unregisters a rich text format that was previously
registered using <a class="link" href="GtkTextBuffer.html#gtk-text-buffer-register-deserialize-format" title="gtk_text_buffer_register_deserialize_format ()"><code class="function">gtk_text_buffer_register_deserialize_format()</code></a> or
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-register-deserialize-tagset" title="gtk_text_buffer_register_deserialize_tagset ()"><code class="function">gtk_text_buffer_register_deserialize_tagset()</code></a>.</p>
@ -4176,7 +4176,7 @@ registered using <a class="link" href="GtkTextBuffer.html#gtk-text-buffer-regist
</tr>
<tr>
<td class="parameter_name"><p>format</p></td>
<td class="parameter_description"><p>a <span class="type">GdkAtom</span> representing a registered rich text format.</p></td>
<td class="parameter_description"><p>a <a href="../html/gdk3-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> representing a registered rich text format.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
@ -4190,7 +4190,7 @@ registered using <a class="link" href="GtkTextBuffer.html#gtk-text-buffer-regist
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_text_buffer_unregister_serialize_format
(<em class="parameter"><code><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *buffer</code></em>,
<em class="parameter"><code><span class="type">GdkAtom</span> format</code></em>);</pre>
<em class="parameter"><code><a href="../html/gdk3-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> format</code></em>);</pre>
<p>This function unregisters a rich text format that was previously
registered using <a class="link" href="GtkTextBuffer.html#gtk-text-buffer-register-serialize-format" title="gtk_text_buffer_register_serialize_format ()"><code class="function">gtk_text_buffer_register_serialize_format()</code></a> or
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-register-serialize-tagset" title="gtk_text_buffer_register_serialize_tagset ()"><code class="function">gtk_text_buffer_register_serialize_tagset()</code></a></p>
@ -4210,7 +4210,7 @@ registered using <a class="link" href="GtkTextBuffer.html#gtk-text-buffer-regist
</tr>
<tr>
<td class="parameter_name"><p>format</p></td>
<td class="parameter_description"><p>a <span class="type">GdkAtom</span> representing a registered rich text format.</p></td>
<td class="parameter_description"><p>a <a href="../html/gdk3-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> representing a registered rich text format.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>

60
docs/reference/gtk/html/GtkTextTag.html
View File

@ -157,13 +157,13 @@
</tr>
<tr>
<td class="property_type">
<span class="type">GdkColor</span> *</td>
<a href="../html/gdk3-Colors.html#GdkColor"><span class="type">GdkColor</span></a> *</td>
<td class="property_name"><a class="link" href="GtkTextTag.html#GtkTextTag--background-gdk" title="The “background-gdk” property">background-gdk</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type">
<span class="type">GdkRGBA</span> *</td>
<a href="../html/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a> *</td>
<td class="property_name"><a class="link" href="GtkTextTag.html#GtkTextTag--background-rgba" title="The “background-rgba” property">background-rgba</a></td>
<td class="property_flags">Read / Write</td>
</tr>
@ -239,13 +239,13 @@
</tr>
<tr>
<td class="property_type">
<span class="type">GdkColor</span> *</td>
<a href="../html/gdk3-Colors.html#GdkColor"><span class="type">GdkColor</span></a> *</td>
<td class="property_name"><a class="link" href="GtkTextTag.html#GtkTextTag--foreground-gdk" title="The “foreground-gdk” property">foreground-gdk</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type">
<span class="type">GdkRGBA</span> *</td>
<a href="../html/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a> *</td>
<td class="property_name"><a class="link" href="GtkTextTag.html#GtkTextTag--foreground-rgba" title="The “foreground-rgba” property">foreground-rgba</a></td>
<td class="property_flags">Read / Write</td>
</tr>
@ -329,13 +329,13 @@
</tr>
<tr>
<td class="property_type">
<span class="type">GdkColor</span> *</td>
<a href="../html/gdk3-Colors.html#GdkColor"><span class="type">GdkColor</span></a> *</td>
<td class="property_name"><a class="link" href="GtkTextTag.html#GtkTextTag--paragraph-background-gdk" title="The “paragraph-background-gdk” property">paragraph-background-gdk</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type">
<span class="type">GdkRGBA</span> *</td>
<a href="../html/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a> *</td>
<td class="property_name"><a class="link" href="GtkTextTag.html#GtkTextTag--paragraph-background-rgba" title="The “paragraph-background-rgba” property">paragraph-background-rgba</a></td>
<td class="property_flags">Read / Write</td>
</tr>
@ -436,7 +436,7 @@
</tr>
<tr>
<td class="property_type">
<span class="type">GdkRGBA</span> *</td>
<a href="../html/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a> *</td>
<td class="property_name"><a class="link" href="GtkTextTag.html#GtkTextTag--strikethrough-rgba" title="The “strikethrough-rgba” property">strikethrough-rgba</a></td>
<td class="property_flags">Read / Write</td>
</tr>
@ -478,7 +478,7 @@
</tr>
<tr>
<td class="property_type">
<span class="type">GdkRGBA</span> *</td>
<a href="../html/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a> *</td>
<td class="property_name"><a class="link" href="GtkTextTag.html#GtkTextTag--underline-rgba" title="The “underline-rgba” property">underline-rgba</a></td>
<td class="property_flags">Read / Write</td>
</tr>
@ -689,7 +689,7 @@ automatically.</p>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gtk_text_tag_event (<em class="parameter"><code><a class="link" href="GtkTextTag.html" title="GtkTextTag"><span class="type">GtkTextTag</span></a> *tag</code></em>,
<em class="parameter"><code><span class="type">GObject</span> *event_object</code></em>,
<em class="parameter"><code><span class="type">GdkEvent</span> *event</code></em>,
<em class="parameter"><code><a href="../html/gdk3-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a> *event</code></em>,
<em class="parameter"><code>const <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>);</pre>
<p>Emits the “event” signal on the <a class="link" href="GtkTextTag.html" title="GtkTextTag"><span class="type">GtkTextTag</span></a>.</p>
<div class="refsect3">
@ -1108,13 +1108,13 @@ baseline +/- ascent/descent (font height).</p></td>
</colgroup>
<tbody>
<tr>
<td class="struct_member_name"><p><span class="type">GdkColor</span> <em class="structfield"><code><a name="GtkTextAppearance.bg-color"></a>bg_color</code></em>;</p></td>
<td class="struct_member_description"><p>Background <span class="type">GdkColor</span>.</p></td>
<td class="struct_member_name"><p><a href="../html/gdk3-Colors.html#GdkColor"><span class="type">GdkColor</span></a> <em class="structfield"><code><a name="GtkTextAppearance.bg-color"></a>bg_color</code></em>;</p></td>
<td class="struct_member_description"><p>Background <a href="../html/gdk3-Colors.html#GdkColor"><span class="type">GdkColor</span></a>.</p></td>
<td class="struct_member_annotations"> </td>
</tr>
<tr>
<td class="struct_member_name"><p><span class="type">GdkColor</span> <em class="structfield"><code><a name="GtkTextAppearance.fg-color"></a>fg_color</code></em>;</p></td>
<td class="struct_member_description"><p>Foreground <span class="type">GdkColor</span>.</p></td>
<td class="struct_member_name"><p><a href="../html/gdk3-Colors.html#GdkColor"><span class="type">GdkColor</span></a> <em class="structfield"><code><a name="GtkTextAppearance.fg-color"></a>fg_color</code></em>;</p></td>
<td class="struct_member_description"><p>Foreground <a href="../html/gdk3-Colors.html#GdkColor"><span class="type">GdkColor</span></a>.</p></td>
<td class="struct_member_annotations"> </td>
</tr>
<tr>
@ -1155,8 +1155,8 @@ part of a <a class="link" href="GtkTextTag.html#GtkTextAttributes" title="struct
<td class="struct_member_annotations"> </td>
</tr>
<tr>
<td class="struct_member_name"><p><span class="type">GdkRGBA</span> *<em class="structfield"><code><a name="GtkTextAppearance.rgba"></a>rgba</code></em>[2];</p></td>
<td class="struct_member_description"><p><span class="type">GdkRGBA</span></p></td>
<td class="struct_member_name"><p><a href="../html/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a> *<em class="structfield"><code><a name="GtkTextAppearance.rgba"></a>rgba</code></em>[2];</p></td>
<td class="struct_member_description"><p><a href="../html/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a></p></td>
<td class="struct_member_annotations"> </td>
</tr>
</tbody>
@ -1206,8 +1206,8 @@ the margins override one another (the default).</p>
<hr>
<div class="refsect2">
<a name="GtkTextTag--background-gdk"></a><h3>The <code class="literal">“background-gdk”</code> property</h3>
<pre class="programlisting"> “background-gdk” <span class="type">GdkColor</span> *</pre>
<p>Background color as a <span class="type">GdkColor</span>.</p>
<pre class="programlisting"> “background-gdk” <a href="../html/gdk3-Colors.html#GdkColor"><span class="type">GdkColor</span></a> *</pre>
<p>Background color as a <a href="../html/gdk3-Colors.html#GdkColor"><span class="type">GdkColor</span></a>.</p>
<div class="warning">
<p><code class="literal">GtkTextTag:background-gdk</code> has been deprecated since version 3.4 and should not be used in newly-written code.</p>
<p>Use <a class="link" href="GtkTextTag.html#GtkTextTag--background-rgba" title="The “background-rgba” property"><span class="type">“background-rgba”</span></a> instead.</p>
@ -1217,8 +1217,8 @@ the margins override one another (the default).</p>
<hr>
<div class="refsect2">
<a name="GtkTextTag--background-rgba"></a><h3>The <code class="literal">“background-rgba”</code> property</h3>
<pre class="programlisting"> “background-rgba” <span class="type">GdkRGBA</span> *</pre>
<p>Background color as a <span class="type">GdkRGBA</span>.</p>
<pre class="programlisting"> “background-rgba” <a href="../html/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a> *</pre>
<p>Background color as a <a href="../html/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a>.</p>
<p>Flags: Read / Write</p>
<p class="since">Since: <a class="link" href="api-index-3-2.html#api-index-3.2">3.2</a></p>
</div>
@ -1334,8 +1334,8 @@ the internals of <a href="/usr/share/gtk-doc/html/pango/pango-Fonts.html#PangoFo
<hr>
<div class="refsect2">
<a name="GtkTextTag--foreground-gdk"></a><h3>The <code class="literal">“foreground-gdk”</code> property</h3>
<pre class="programlisting"> “foreground-gdk” <span class="type">GdkColor</span> *</pre>
<p>Foreground color as a <span class="type">GdkColor</span>.</p>
<pre class="programlisting"> “foreground-gdk” <a href="../html/gdk3-Colors.html#GdkColor"><span class="type">GdkColor</span></a> *</pre>
<p>Foreground color as a <a href="../html/gdk3-Colors.html#GdkColor"><span class="type">GdkColor</span></a>.</p>
<div class="warning">
<p><code class="literal">GtkTextTag:foreground-gdk</code> has been deprecated since version 3.4 and should not be used in newly-written code.</p>
<p>Use <a class="link" href="GtkTextTag.html#GtkTextTag--foreground-rgba" title="The “foreground-rgba” property"><span class="type">“foreground-rgba”</span></a> instead.</p>
@ -1345,8 +1345,8 @@ the internals of <a href="/usr/share/gtk-doc/html/pango/pango-Fonts.html#PangoFo
<hr>
<div class="refsect2">
<a name="GtkTextTag--foreground-rgba"></a><h3>The <code class="literal">“foreground-rgba”</code> property</h3>
<pre class="programlisting"> “foreground-rgba” <span class="type">GdkRGBA</span> *</pre>
<p>Foreground color as a <span class="type">GdkRGBA</span>.</p>
<pre class="programlisting"> “foreground-rgba” <a href="../html/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a> *</pre>
<p>Foreground color as a <a href="../html/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a>.</p>
<p>Flags: Read / Write</p>
<p class="since">Since: <a class="link" href="api-index-3-2.html#api-index-3.2">3.2</a></p>
</div>
@ -1488,8 +1488,8 @@ locale, see also <a class="link" href="gtk3-General.html#gtk-get-default-languag
<hr>
<div class="refsect2">
<a name="GtkTextTag--paragraph-background-gdk"></a><h3>The <code class="literal">“paragraph-background-gdk”</code> property</h3>
<pre class="programlisting"> “paragraph-background-gdk” <span class="type">GdkColor</span> *</pre>
<p>The paragraph background color as a <span class="type">GdkColor</span>.</p>
<pre class="programlisting"> “paragraph-background-gdk” <a href="../html/gdk3-Colors.html#GdkColor"><span class="type">GdkColor</span></a> *</pre>
<p>The paragraph background color as a <a href="../html/gdk3-Colors.html#GdkColor"><span class="type">GdkColor</span></a>.</p>
<div class="warning">
<p><code class="literal">GtkTextTag:paragraph-background-gdk</code> has been deprecated since version 3.4 and should not be used in newly-written code.</p>
<p>Use <a class="link" href="GtkTextTag.html#GtkTextTag--paragraph-background-rgba" title="The “paragraph-background-rgba” property"><span class="type">“paragraph-background-rgba”</span></a> instead.</p>
@ -1500,8 +1500,8 @@ locale, see also <a class="link" href="gtk3-General.html#gtk-get-default-languag
<hr>
<div class="refsect2">
<a name="GtkTextTag--paragraph-background-rgba"></a><h3>The <code class="literal">“paragraph-background-rgba”</code> property</h3>
<pre class="programlisting"> “paragraph-background-rgba” <span class="type">GdkRGBA</span> *</pre>
<p>The paragraph background color as a <span class="type">GdkRGBA</span>.</p>
<pre class="programlisting"> “paragraph-background-rgba” <a href="../html/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a> *</pre>
<p>The paragraph background color as a <a href="../html/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a>.</p>
<p>Flags: Read / Write</p>
<p class="since">Since: <a class="link" href="api-index-3-2.html#api-index-3.2">3.2</a></p>
</div>
@ -1667,7 +1667,7 @@ locale, see also <a class="link" href="gtk3-General.html#gtk-get-default-languag
<hr>
<div class="refsect2">
<a name="GtkTextTag--strikethrough-rgba"></a><h3>The <code class="literal">“strikethrough-rgba”</code> property</h3>
<pre class="programlisting"> “strikethrough-rgba” <span class="type">GdkRGBA</span> *</pre>
<pre class="programlisting"> “strikethrough-rgba” <a href="../html/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a> *</pre>
<p>This property modifies the color of strikeouts. If not set, strikeouts
will use the forground color.</p>
<p>Flags: Read / Write</p>
@ -1732,7 +1732,7 @@ will use the forground color.</p>
<hr>
<div class="refsect2">
<a name="GtkTextTag--underline-rgba"></a><h3>The <code class="literal">“underline-rgba”</code> property</h3>
<pre class="programlisting"> “underline-rgba” <span class="type">GdkRGBA</span> *</pre>
<pre class="programlisting"> “underline-rgba” <a href="../html/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a> *</pre>
<p>This property modifies the color of underlines. If not set, underlines
will use the forground color.</p>
<p>If <a class="link" href="GtkTextTag.html#GtkTextTag--underline" title="The “underline” property"><span class="type">“underline”</span></a> is set to <a href="/usr/share/gtk-doc/html/pango/pango-Text-Attributes.html#PANGO-UNDERLINE-ERROR:CAPS"><code class="literal">PANGO_UNDERLINE_ERROR</code></a>, an alternate
@ -1815,7 +1815,7 @@ will always override those defaults.</p>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
user_function (<a class="link" href="GtkTextTag.html" title="GtkTextTag"><span class="type">GtkTextTag</span></a> *tag,
<span class="type">GObject</span> *object,
<span class="type">GdkEvent</span> *event,
<a href="../html/gdk3-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a> *event,
<a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter,
<span class="type">gpointer</span> user_data)</pre>
<p>The ::event signal is emitted when an event occurs on a region of the

30
docs/reference/gtk/html/GtkTextView.html
View File

@ -206,7 +206,7 @@
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">GdkWindow</span> *
<a href="../html/gdk3-Windows.html#GdkWindow-struct"><span class="returnvalue">GdkWindow</span></a> *
</td>
<td class="function_name">
<a class="link" href="GtkTextView.html#gtk-text-view-get-window" title="gtk_text_view_get_window ()">gtk_text_view_get_window</a> <span class="c_punctuation">()</span>
@ -785,7 +785,7 @@
</colgroup>
<tbody><tr>
<td class="property_type">
<span class="type">GdkColor</span> *</td>
<a href="../html/gdk3-Colors.html#GdkColor"><span class="type">GdkColor</span></a> *</td>
<td class="property_name"><a class="link" href="GtkTextView.html#GtkTextView--s-error-underline-color" title="The “error-underline-color” style property">error-underline-color</a></td>
<td class="property_flags">Read</td>
</tr></tbody>
@ -1414,7 +1414,7 @@ buffer, it it isn’t there already.</p>
<a name="gtk-text-view-get-visible-rect"></a><h3>gtk_text_view_get_visible_rect ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_text_view_get_visible_rect (<em class="parameter"><code><a class="link" href="GtkTextView.html" title="GtkTextView"><span class="type">GtkTextView</span></a> *text_view</code></em>,
<em class="parameter"><code><span class="type">GdkRectangle</span> *visible_rect</code></em>);</pre>
<em class="parameter"><code><a href="../html/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *visible_rect</code></em>);</pre>
<p>Fills <em class="parameter"><code>visible_rect</code></em>
with the currently-visible
region of the buffer, in buffer coordinates. Convert to window coordinates
@ -1448,7 +1448,7 @@ with <a class="link" href="GtkTextView.html#gtk-text-view-buffer-to-window-coord
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_text_view_get_iter_location (<em class="parameter"><code><a class="link" href="GtkTextView.html" title="GtkTextView"><span class="type">GtkTextView</span></a> *text_view</code></em>,
<em class="parameter"><code>const <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>,
<em class="parameter"><code><span class="type">GdkRectangle</span> *location</code></em>);</pre>
<em class="parameter"><code><a href="../html/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *location</code></em>);</pre>
<p>Gets a rectangle which roughly contains the character at <em class="parameter"><code>iter</code></em>
.
The rectangle position is in buffer coordinates; use
@ -1489,8 +1489,8 @@ coordinates to coordinates for one of the windows in the text view.</p>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_text_view_get_cursor_locations (<em class="parameter"><code><a class="link" href="GtkTextView.html" title="GtkTextView"><span class="type">GtkTextView</span></a> *text_view</code></em>,
<em class="parameter"><code>const <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>,
<em class="parameter"><code><span class="type">GdkRectangle</span> *strong</code></em>,
<em class="parameter"><code><span class="type">GdkRectangle</span> *weak</code></em>);</pre>
<em class="parameter"><code><a href="../html/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *strong</code></em>,
<em class="parameter"><code><a href="../html/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *weak</code></em>);</pre>
<p>Given an <em class="parameter"><code>iter</code></em>
within a text layout, determine the positions of the
strong and weak cursors if the insertion point is at that
@ -1883,10 +1883,10 @@ coordinates, storing the result in (<em class="parameter"><code>buffer_x</code><
<hr>
<div class="refsect2">
<a name="gtk-text-view-get-window"></a><h3>gtk_text_view_get_window ()</h3>
<pre class="programlisting"><span class="returnvalue">GdkWindow</span> *
<pre class="programlisting"><a href="../html/gdk3-Windows.html#GdkWindow-struct"><span class="returnvalue">GdkWindow</span></a> *
gtk_text_view_get_window (<em class="parameter"><code><a class="link" href="GtkTextView.html" title="GtkTextView"><span class="type">GtkTextView</span></a> *text_view</code></em>,
<em class="parameter"><code><a class="link" href="GtkTextView.html#GtkTextWindowType" title="enum GtkTextWindowType"><span class="type">GtkTextWindowType</span></a> win</code></em>);</pre>
<p>Retrieves the <span class="type">GdkWindow</span> corresponding to an area of the text view;
<p>Retrieves the <a href="../html/gdk3-Windows.html#GdkWindow-struct"><span class="type">GdkWindow</span></a> corresponding to an area of the text view;
possible windows include the overall widget window, child windows
on the left, right, top, bottom, and the window that displays the
text buffer. Windows are <code class="literal">NULL</code> and nonexistent if their width or
@ -1916,7 +1916,7 @@ realized.</p>
</div>
<div class="refsect3">
<a name="gtk-text-view-get-window.returns"></a><h4>Returns</h4>
<p>a <span class="type">GdkWindow</span>, or <code class="literal">NULL</code>. </p>
<p>a <a href="../html/gdk3-Windows.html#GdkWindow-struct"><span class="type">GdkWindow</span></a>, or <code class="literal">NULL</code>. </p>
<p><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
</div>
@ -1925,7 +1925,7 @@ realized.</p>
<a name="gtk-text-view-get-window-type"></a><h3>gtk_text_view_get_window_type ()</h3>
<pre class="programlisting"><a class="link" href="GtkTextView.html#GtkTextWindowType" title="enum GtkTextWindowType"><span class="returnvalue">GtkTextWindowType</span></a>
gtk_text_view_get_window_type (<em class="parameter"><code><a class="link" href="GtkTextView.html" title="GtkTextView"><span class="type">GtkTextView</span></a> *text_view</code></em>,
<em class="parameter"><code><span class="type">GdkWindow</span> *window</code></em>);</pre>
<em class="parameter"><code><a href="../html/gdk3-Windows.html#GdkWindow-struct"><span class="type">GdkWindow</span></a> *window</code></em>);</pre>
<p>Usually used to find out which window an event corresponds to.</p>
<p>If you connect to an event signal on <em class="parameter"><code>text_view</code></em>
, this function
@ -3492,7 +3492,7 @@ and should be freed with <a class="link" href="GtkTextTag.html#gtk-text-attribut
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gtk_text_view_im_context_filter_keypress
(<em class="parameter"><code><a class="link" href="GtkTextView.html" title="GtkTextView"><span class="type">GtkTextView</span></a> *text_view</code></em>,
<em class="parameter"><code><span class="type">GdkEventKey</span> *event</code></em>);</pre>
<em class="parameter"><code><a href="../html/gdk3-Event-Structures.html#GdkEventKey"><span class="type">GdkEventKey</span></a> *event</code></em>);</pre>
<p>Allow the <a class="link" href="GtkTextView.html" title="GtkTextView"><span class="type">GtkTextView</span></a> input method to internally handle key press
and release events. If this function returns <code class="literal">TRUE</code>, then no further
processing should be done for this key event. See
@ -3529,7 +3529,7 @@ and the default key event handling of the <a class="link" href="GtkTextView.html
<span class="cbracket">{</span>
<span class="normal"> </span><span class="usertype">guint</span><span class="normal"> keyval</span><span class="symbol">;</span>
<span class="normal"> </span><span class="function">gdk_event_get_keyval</span><span class="normal"> </span><span class="symbol">((</span><span class="normal">GdkEvent</span><span class="symbol">*)</span><span class="normal">event</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">keyval</span><span class="symbol">);</span>
<span class="normal"> </span><span class="function"><a href="../html/gdk3-Events.html#gdk-event-get-keyval">gdk_event_get_keyval</a></span><span class="normal"> </span><span class="symbol">((</span><span class="normal"><a href="../html/gdk3-Event-Structures.html#GdkEvent">GdkEvent</a></span><span class="symbol">*)</span><span class="normal">event</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">keyval</span><span class="symbol">);</span>
<span class="normal"> </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">keyval </span><span class="symbol">==</span><span class="normal"> GDK_KEY_Return </span><span class="symbol">||</span><span class="normal"> keyval </span><span class="symbol">==</span><span class="normal"> GDK_KEY_KP_Enter</span><span class="symbol">)</span>
<span class="normal"> </span><span class="cbracket">{</span>
@ -4337,7 +4337,7 @@ to the padding from the theme.</p>
<a name="GtkTextView.style-property-details"></a><h2>Style Property Details</h2>
<div class="refsect2">
<a name="GtkTextView--s-error-underline-color"></a><h3>The <code class="literal">“error-underline-color”</code> style property</h3>
<pre class="programlisting"> “error-underline-color” <span class="type">GdkColor</span> *</pre>
<pre class="programlisting"> “error-underline-color” <a href="../html/gdk3-Colors.html#GdkColor"><span class="type">GdkColor</span></a> *</pre>
<p>Color with which to draw error-indication underlines.</p>
<p>Flags: Read</p>
</div>
@ -4569,8 +4569,8 @@ extended at <em class="parameter"><code>location</code></em>
</div>
<div class="refsect3">
<a name="GtkTextView-extend-selection.returns"></a><h4>Returns</h4>
<p> <code class="literal">GDK_EVENT_STOP</code> to stop other handlers from being invoked for the
event. <code class="literal">GDK_EVENT_PROPAGATE</code> to propagate the event further.</p>
<p> <a href="../html/gdk3-Events.html#GDK-EVENT-STOP:CAPS"><code class="literal">GDK_EVENT_STOP</code></a> to stop other handlers from being invoked for the
event. <a href="../html/gdk3-Events.html#GDK-EVENT-PROPAGATE:CAPS"><code class="literal">GDK_EVENT_PROPAGATE</code></a> to propagate the event further.</p>
</div>
<p>Flags: Run Last</p>
<p class="since">Since: <a class="link" href="api-index-3-16.html#api-index-3.16">3.16</a></p>

16
docs/reference/gtk/html/GtkThemingEngine.html
View File

@ -82,7 +82,7 @@
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">GdkScreen</span> *
<a href="../html/GdkScreen.html#GdkScreen-struct"><span class="returnvalue">GdkScreen</span></a> *
</td>
<td class="function_name">
<a class="link" href="GtkThemingEngine.html#gtk-theming-engine-get-screen" title="gtk_theming_engine_get_screen ()">gtk_theming_engine_get_screen</a> <span class="c_punctuation">()</span>
@ -471,10 +471,10 @@ done with it. </p></td>
<hr>
<div class="refsect2">
<a name="gtk-theming-engine-get-screen"></a><h3>gtk_theming_engine_get_screen ()</h3>
<pre class="programlisting"><span class="returnvalue">GdkScreen</span> *
<pre class="programlisting"><a href="../html/GdkScreen.html#GdkScreen-struct"><span class="returnvalue">GdkScreen</span></a> *
gtk_theming_engine_get_screen (<em class="parameter"><code><a class="link" href="GtkThemingEngine.html" title="GtkThemingEngine"><span class="type">GtkThemingEngine</span></a> *engine</code></em>);</pre>
<div class="warning"><p><code class="literal">gtk_theming_engine_get_screen</code> has been deprecated since version 3.14 and should not be used in newly-written code.</p></div>
<p>Returns the <span class="type">GdkScreen</span> to which <em class="parameter"><code>engine</code></em>
<p>Returns the <a href="../html/GdkScreen.html#GdkScreen-struct"><span class="type">GdkScreen</span></a> to which <em class="parameter"><code>engine</code></em>
currently rendering to.</p>
<div class="refsect3">
<a name="gtk-theming-engine-get-screen.parameters"></a><h4>Parameters</h4>
@ -493,7 +493,7 @@ gtk_theming_engine_get_screen (<em class="parameter"><code><a class="link" href=
</div>
<div class="refsect3">
<a name="gtk-theming-engine-get-screen.returns"></a><h4>Returns</h4>
<p>a <span class="type">GdkScreen</span>, or <code class="literal">NULL</code>. </p>
<p>a <a href="../html/GdkScreen.html#GdkScreen-struct"><span class="type">GdkScreen</span></a>, or <code class="literal">NULL</code>. </p>
<p><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
</div>
@ -677,7 +677,7 @@ rendered element.</p>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_theming_engine_get_color (<em class="parameter"><code><a class="link" href="GtkThemingEngine.html" title="GtkThemingEngine"><span class="type">GtkThemingEngine</span></a> *engine</code></em>,
<em class="parameter"><code><a class="link" href="gtk3-Standard-Enumerations.html#GtkStateFlags" title="enum GtkStateFlags"><span class="type">GtkStateFlags</span></a> state</code></em>,
<em class="parameter"><code><span class="type">GdkRGBA</span> *color</code></em>);</pre>
<em class="parameter"><code><a href="../html/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a> *color</code></em>);</pre>
<div class="warning"><p><code class="literal">gtk_theming_engine_get_color</code> has been deprecated since version 3.14 and should not be used in newly-written code.</p></div>
<p>Gets the foreground color for a given state.</p>
<div class="refsect3">
@ -716,7 +716,7 @@ gtk_theming_engine_get_color (<em class="parameter"><code><a class="link" href="
gtk_theming_engine_get_background_color
(<em class="parameter"><code><a class="link" href="GtkThemingEngine.html" title="GtkThemingEngine"><span class="type">GtkThemingEngine</span></a> *engine</code></em>,
<em class="parameter"><code><a class="link" href="gtk3-Standard-Enumerations.html#GtkStateFlags" title="enum GtkStateFlags"><span class="type">GtkStateFlags</span></a> state</code></em>,
<em class="parameter"><code><span class="type">GdkRGBA</span> *color</code></em>);</pre>
<em class="parameter"><code><a href="../html/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a> *color</code></em>);</pre>
<div class="warning"><p><code class="literal">gtk_theming_engine_get_background_color</code> has been deprecated since version 3.14 and should not be used in newly-written code.</p></div>
<p>Gets the background color for a given state.</p>
<div class="refsect3">
@ -754,7 +754,7 @@ gtk_theming_engine_get_background_color
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_theming_engine_get_border_color (<em class="parameter"><code><a class="link" href="GtkThemingEngine.html" title="GtkThemingEngine"><span class="type">GtkThemingEngine</span></a> *engine</code></em>,
<em class="parameter"><code><a class="link" href="gtk3-Standard-Enumerations.html#GtkStateFlags" title="enum GtkStateFlags"><span class="type">GtkStateFlags</span></a> state</code></em>,
<em class="parameter"><code><span class="type">GdkRGBA</span> *color</code></em>);</pre>
<em class="parameter"><code><a href="../html/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a> *color</code></em>);</pre>
<div class="warning"><p><code class="literal">gtk_theming_engine_get_border_color</code> has been deprecated since version 3.14 and should not be used in newly-written code.</p></div>
<p>Gets the border color for a given state.</p>
<div class="refsect3">
@ -1032,7 +1032,7 @@ to the flags affecting the region.</p>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gtk_theming_engine_lookup_color (<em class="parameter"><code><a class="link" href="GtkThemingEngine.html" title="GtkThemingEngine"><span class="type">GtkThemingEngine</span></a> *engine</code></em>,
<em class="parameter"><code>const <span class="type">gchar</span> *color_name</code></em>,
<em class="parameter"><code><span class="type">GdkRGBA</span> *color</code></em>);</pre>
<em class="parameter"><code><a href="../html/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a> *color</code></em>);</pre>
<div class="warning"><p><code class="literal">gtk_theming_engine_lookup_color</code> has been deprecated since version 3.14 and should not be used in newly-written code.</p></div>
<p>Looks up and resolves a color name in the current style’s color map.</p>
<div class="refsect3">

6
docs/reference/gtk/html/GtkToolPalette.html
View File

@ -429,7 +429,7 @@ signal handler of the drag target.</p>
<span class="function"><a href="GtkToolPalette.html#gtk-tool-palette-add-drag-dest">gtk_tool_palette_add_drag_dest</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function">GTK_TOOL_PALETTE</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">palette</span><span class="symbol">),</span><span class="normal"> target</span><span class="symbol">,</span>
<span class="normal"> <a href="gtk3-Drag-and-Drop.html#GTK-DEST-DEFAULT-ALL:CAPS">GTK_DEST_DEFAULT_ALL</a></span><span class="symbol">,</span>
<span class="normal"> <a href="GtkToolPalette.html#GTK-TOOL-PALETTE-DRAG-ITEMS:CAPS">GTK_TOOL_PALETTE_DRAG_ITEMS</a></span><span class="symbol">,</span>
<span class="normal"> GDK_ACTION_COPY</span><span class="symbol">);</span></pre></td>
<span class="normal"> <a href="../html/gdk3-Drag-and-Drop.html#GDK-ACTION-COPY:CAPS">GDK_ACTION_COPY</a></span><span class="symbol">);</span></pre></td>
</tr>
</tbody>
</table>
@ -857,7 +857,7 @@ gtk_tool_palette_add_drag_dest (<em class="parameter"><code><a class="link" href
<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>,
<em class="parameter"><code><a class="link" href="gtk3-Drag-and-Drop.html#GtkDestDefaults" title="enum GtkDestDefaults"><span class="type">GtkDestDefaults</span></a> flags</code></em>,
<em class="parameter"><code><a class="link" href="GtkToolPalette.html#GtkToolPaletteDragTargets" title="enum GtkToolPaletteDragTargets"><span class="type">GtkToolPaletteDragTargets</span></a> targets</code></em>,
<em class="parameter"><code><span class="type">GdkDragAction</span> actions</code></em>);</pre>
<em class="parameter"><code><a href="../html/gdk3-Drag-and-Drop.html#GdkDragAction"><span class="type">GdkDragAction</span></a> actions</code></em>);</pre>
<p>Sets <em class="parameter"><code>palette</code></em>
as drag source (see <a class="link" href="GtkToolPalette.html#gtk-tool-palette-set-drag-source" title="gtk_tool_palette_set_drag_source ()"><code class="function">gtk_tool_palette_set_drag_source()</code></a>)
and sets <em class="parameter"><code>widget</code></em>
@ -898,7 +898,7 @@ should support</p></td>
</tr>
<tr>
<td class="parameter_name"><p>actions</p></td>
<td class="parameter_description"><p>the <span class="type">GdkDragActions</span> which the widget should suppport</p></td>
<td class="parameter_description"><p>the <a href="../html/gdk3-Drag-and-Drop.html#GdkDragAction"><span class="type">GdkDragActions</span></a> which the widget should suppport</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>

8
docs/reference/gtk/html/GtkTooltip.html
View File

@ -451,7 +451,7 @@ and <a class="link" href="GtkTooltip.html#gtk-tooltip-set-icon" title="gtk_toolt
<div class="refsect2">
<a name="gtk-tooltip-trigger-tooltip-query"></a><h3>gtk_tooltip_trigger_tooltip_query ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_tooltip_trigger_tooltip_query (<em class="parameter"><code><span class="type">GdkDisplay</span> *display</code></em>);</pre>
gtk_tooltip_trigger_tooltip_query (<em class="parameter"><code><a href="../html/GdkDisplay.html#GdkDisplay-struct"><span class="type">GdkDisplay</span></a> *display</code></em>);</pre>
<p>Triggers a new tooltip query on <em class="parameter"><code>display</code></em>
, in order to update the current
visible tooltip, or to show/hide the current tooltip. This function is
@ -467,7 +467,7 @@ key press.</p>
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>display</p></td>
<td class="parameter_description"><p>a <span class="type">GdkDisplay</span></p></td>
<td class="parameter_description"><p>a <a href="../html/GdkDisplay.html#GdkDisplay-struct"><span class="type">GdkDisplay</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
@ -479,7 +479,7 @@ key press.</p>
<a name="gtk-tooltip-set-tip-area"></a><h3>gtk_tooltip_set_tip_area ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_tooltip_set_tip_area (<em class="parameter"><code><a class="link" href="GtkTooltip.html" title="GtkTooltip"><span class="type">GtkTooltip</span></a> *tooltip</code></em>,
<em class="parameter"><code>const <span class="type">GdkRectangle</span> *rect</code></em>);</pre>
<em class="parameter"><code>const <a href="../html/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *rect</code></em>);</pre>
<p>Sets the area of the widget, where the contents of this tooltip apply,
to be <em class="parameter"><code>rect</code></em>
(in widget coordinates). This is especially useful for
@ -504,7 +504,7 @@ functions for this: <a class="link" href="GtkTreeView.html#gtk-tree-view-set-too
</tr>
<tr>
<td class="parameter_name"><p>rect</p></td>
<td class="parameter_description"><p>a <span class="type">GdkRectangle</span></p></td>
<td class="parameter_description"><p>a <a href="../html/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>

26
docs/reference/gtk/html/GtkTreeView.html
View File

@ -510,7 +510,7 @@
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">GdkWindow</span> *
<a href="../html/gdk3-Windows.html#GdkWindow-struct"><span class="returnvalue">GdkWindow</span></a> *
</td>
<td class="function_name">
<a class="link" href="GtkTreeView.html#gtk-tree-view-get-bin-window" title="gtk_tree_view_get_bin_window ()">gtk_tree_view_get_bin_window</a> <span class="c_punctuation">()</span>
@ -1023,7 +1023,7 @@
</tr>
<tr>
<td class="property_type">
<span class="type">GdkColor</span> *</td>
<a href="../html/gdk3-Colors.html#GdkColor"><span class="type">GdkColor</span></a> *</td>
<td class="property_name"><a class="link" href="GtkTreeView.html#GtkTreeView--s-even-row-color" title="The “even-row-color” style property">even-row-color</a></td>
<td class="property_flags">Read</td>
</tr>
@ -1055,7 +1055,7 @@
</tr>
<tr>
<td class="property_type">
<span class="type">GdkColor</span> *</td>
<a href="../html/gdk3-Colors.html#GdkColor"><span class="type">GdkColor</span></a> *</td>
<td class="property_name"><a class="link" href="GtkTreeView.html#GtkTreeView--s-odd-row-color" title="The “odd-row-color” style property">odd-row-color</a></td>
<td class="property_flags">Read</td>
</tr>
@ -3515,7 +3515,7 @@ cell can be placed, or <code class="literal">NULL</code>. </p></td>
gtk_tree_view_get_cell_area (<em class="parameter"><code><a class="link" href="GtkTreeView.html" title="GtkTreeView"><span class="type">GtkTreeView</span></a> *tree_view</code></em>,
<em class="parameter"><code><a class="link" href="GtkTreeModel.html#GtkTreePath"><span class="type">GtkTreePath</span></a> *path</code></em>,
<em class="parameter"><code><a class="link" href="GtkTreeViewColumn.html" title="GtkTreeViewColumn"><span class="type">GtkTreeViewColumn</span></a> *column</code></em>,
<em class="parameter"><code><span class="type">GdkRectangle</span> *rect</code></em>);</pre>
<em class="parameter"><code><a href="../html/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *rect</code></em>);</pre>
<p>Fills the bounding rectangle in bin_window coordinates for the cell at the
row specified by <em class="parameter"><code>path</code></em>
and the column specified by <em class="parameter"><code>column</code></em>
@ -3575,7 +3575,7 @@ realized.</p>
gtk_tree_view_get_background_area (<em class="parameter"><code><a class="link" href="GtkTreeView.html" title="GtkTreeView"><span class="type">GtkTreeView</span></a> *tree_view</code></em>,
<em class="parameter"><code><a class="link" href="GtkTreeModel.html#GtkTreePath"><span class="type">GtkTreePath</span></a> *path</code></em>,
<em class="parameter"><code><a class="link" href="GtkTreeViewColumn.html" title="GtkTreeViewColumn"><span class="type">GtkTreeViewColumn</span></a> *column</code></em>,
<em class="parameter"><code><span class="type">GdkRectangle</span> *rect</code></em>);</pre>
<em class="parameter"><code><a href="../html/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *rect</code></em>);</pre>
<p>Fills the bounding rectangle in bin_window coordinates for the cell at the
row specified by <em class="parameter"><code>path</code></em>
and the column specified by <em class="parameter"><code>column</code></em>
@ -3633,7 +3633,7 @@ itself, excluding surrounding borders and the tree expander area.</p>
<a name="gtk-tree-view-get-visible-rect"></a><h3>gtk_tree_view_get_visible_rect ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_tree_view_get_visible_rect (<em class="parameter"><code><a class="link" href="GtkTreeView.html" title="GtkTreeView"><span class="type">GtkTreeView</span></a> *tree_view</code></em>,
<em class="parameter"><code><span class="type">GdkRectangle</span> *visible_rect</code></em>);</pre>
<em class="parameter"><code><a href="../html/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *visible_rect</code></em>);</pre>
<p>Fills <em class="parameter"><code>visible_rect</code></em>
with the currently-visible region of the
buffer, in tree coordinates. Convert to bin_window coordinates with
@ -3714,7 +3714,7 @@ and <em class="parameter"><code>end_path</code></em>
<hr>
<div class="refsect2">
<a name="gtk-tree-view-get-bin-window"></a><h3>gtk_tree_view_get_bin_window ()</h3>
<pre class="programlisting"><span class="returnvalue">GdkWindow</span> *
<pre class="programlisting"><a href="../html/gdk3-Windows.html#GdkWindow-struct"><span class="returnvalue">GdkWindow</span></a> *
gtk_tree_view_get_bin_window (<em class="parameter"><code><a class="link" href="GtkTreeView.html" title="GtkTreeView"><span class="type">GtkTreeView</span></a> *tree_view</code></em>);</pre>
<p>Returns the window that <em class="parameter"><code>tree_view</code></em>
renders to.
@ -3738,7 +3738,7 @@ to confirm that the event on <em class="parameter"><code>tree_view</code></em>
</div>
<div class="refsect3">
<a name="gtk-tree-view-get-bin-window.returns"></a><h4>Returns</h4>
<p>A <span class="type">GdkWindow</span>, or <code class="literal">NULL</code> when <em class="parameter"><code>tree_view</code></em>
<p>A <a href="../html/gdk3-Windows.html#GdkWindow-struct"><span class="type">GdkWindow</span></a>, or <code class="literal">NULL</code> when <em class="parameter"><code>tree_view</code></em>
hasn’t been realized yet. </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>
@ -4056,7 +4056,7 @@ tree (the full scrollable area of the tree).</p>
gtk_tree_view_enable_model_drag_dest (<em class="parameter"><code><a class="link" href="GtkTreeView.html" title="GtkTreeView"><span class="type">GtkTreeView</span></a> *tree_view</code></em>,
<em class="parameter"><code>const <a class="link" href="gtk3-Selections.html#GtkTargetEntry" title="struct GtkTargetEntry"><span class="type">GtkTargetEntry</span></a> *targets</code></em>,
<em class="parameter"><code><span class="type">gint</span> n_targets</code></em>,
<em class="parameter"><code><span class="type">GdkDragAction</span> actions</code></em>);</pre>
<em class="parameter"><code><a href="../html/gdk3-Drag-and-Drop.html#GdkDragAction"><span class="type">GdkDragAction</span></a> actions</code></em>);</pre>
<p>Turns <em class="parameter"><code>tree_view</code></em>
into a drop destination for automatic DND. Calling
this method sets <a class="link" href="GtkTreeView.html#GtkTreeView--reorderable" title="The “reorderable” property"><span class="type">“reorderable”</span></a> to <code class="literal">FALSE</code>.</p>
@ -4102,10 +4102,10 @@ widget</p></td>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_tree_view_enable_model_drag_source
(<em class="parameter"><code><a class="link" href="GtkTreeView.html" title="GtkTreeView"><span class="type">GtkTreeView</span></a> *tree_view</code></em>,
<em class="parameter"><code><span class="type">GdkModifierType</span> start_button_mask</code></em>,
<em class="parameter"><code><a href="../html/gdk3-Windows.html#GdkModifierType"><span class="type">GdkModifierType</span></a> start_button_mask</code></em>,
<em class="parameter"><code>const <a class="link" href="gtk3-Selections.html#GtkTargetEntry" title="struct GtkTargetEntry"><span class="type">GtkTargetEntry</span></a> *targets</code></em>,
<em class="parameter"><code><span class="type">gint</span> n_targets</code></em>,
<em class="parameter"><code><span class="type">GdkDragAction</span> actions</code></em>);</pre>
<em class="parameter"><code><a href="../html/gdk3-Drag-and-Drop.html#GdkDragAction"><span class="type">GdkDragAction</span></a> actions</code></em>);</pre>
<p>Turns <em class="parameter"><code>tree_view</code></em>
into a drag source for automatic DND. Calling this
method sets <a class="link" href="GtkTreeView.html#GtkTreeView--reorderable" title="The “reorderable” property"><span class="type">“reorderable”</span></a> to <code class="literal">FALSE</code>.</p>
@ -5876,7 +5876,7 @@ in <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type
<hr>
<div class="refsect2">
<a name="GtkTreeView--s-even-row-color"></a><h3>The <code class="literal">“even-row-color”</code> style property</h3>
<pre class="programlisting"> “even-row-color” <span class="type">GdkColor</span> *</pre>
<pre class="programlisting"> “even-row-color” <a href="../html/gdk3-Colors.html#GdkColor"><span class="type">GdkColor</span></a> *</pre>
<p>Color to use for even rows.</p>
<p>Flags: Read</p>
</div>
@ -5926,7 +5926,7 @@ in <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type
<hr>
<div class="refsect2">
<a name="GtkTreeView--s-odd-row-color"></a><h3>The <code class="literal">“odd-row-color”</code> style property</h3>
<pre class="programlisting"> “odd-row-color” <span class="type">GdkColor</span> *</pre>
<pre class="programlisting"> “odd-row-color” <a href="../html/gdk3-Colors.html#GdkColor"><span class="type">GdkColor</span></a> *</pre>
<p>Color to use for odd rows.</p>
<p>Flags: Read</p>
</div>

2
docs/reference/gtk/html/GtkTreeViewColumn.html
View File

@ -2247,7 +2247,7 @@ renderer. This is used primarily by the <a class="link" href="GtkTreeView.html"
<a name="gtk-tree-view-column-cell-get-size"></a><h3>gtk_tree_view_column_cell_get_size ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_tree_view_column_cell_get_size (<em class="parameter"><code><a class="link" href="GtkTreeViewColumn.html" title="GtkTreeViewColumn"><span class="type">GtkTreeViewColumn</span></a> *tree_column</code></em>,
<em class="parameter"><code>const <span class="type">GdkRectangle</span> *cell_area</code></em>,
<em class="parameter"><code>const <a href="../html/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *cell_area</code></em>,
<em class="parameter"><code><span class="type">gint</span> *x_offset</code></em>,
<em class="parameter"><code><span class="type">gint</span> *y_offset</code></em>,
<em class="parameter"><code><span class="type">gint</span> *width</code></em>,

12
docs/reference/gtk/html/GtkViewport.html
View File

@ -100,7 +100,7 @@
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">GdkWindow</span> *
<a href="../html/gdk3-Windows.html#GdkWindow-struct"><span class="returnvalue">GdkWindow</span></a> *
</td>
<td class="function_name">
<a class="link" href="GtkViewport.html#gtk-viewport-get-bin-window" title="gtk_viewport_get_bin_window ()">gtk_viewport_get_bin_window</a> <span class="c_punctuation">()</span>
@ -108,7 +108,7 @@
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">GdkWindow</span> *
<a href="../html/gdk3-Windows.html#GdkWindow-struct"><span class="returnvalue">GdkWindow</span></a> *
</td>
<td class="function_name">
<a class="link" href="GtkViewport.html#gtk-viewport-get-view-window" title="gtk_viewport_get_view_window ()">gtk_viewport_get_view_window</a> <span class="c_punctuation">()</span>
@ -420,7 +420,7 @@ gtk_viewport_get_shadow_type (<em class="parameter"><code><a class="link" href="
<hr>
<div class="refsect2">
<a name="gtk-viewport-get-bin-window"></a><h3>gtk_viewport_get_bin_window ()</h3>
<pre class="programlisting"><span class="returnvalue">GdkWindow</span> *
<pre class="programlisting"><a href="../html/gdk3-Windows.html#GdkWindow-struct"><span class="returnvalue">GdkWindow</span></a> *
gtk_viewport_get_bin_window (<em class="parameter"><code><a class="link" href="GtkViewport.html" title="GtkViewport"><span class="type">GtkViewport</span></a> *viewport</code></em>);</pre>
<p>Gets the bin window of the <a class="link" href="GtkViewport.html" title="GtkViewport"><span class="type">GtkViewport</span></a>.</p>
<div class="refsect3">
@ -440,7 +440,7 @@ gtk_viewport_get_bin_window (<em class="parameter"><code><a class="link" href="G
</div>
<div class="refsect3">
<a name="gtk-viewport-get-bin-window.returns"></a><h4>Returns</h4>
<p>a <span class="type">GdkWindow</span>. </p>
<p>a <a href="../html/gdk3-Windows.html#GdkWindow-struct"><span class="type">GdkWindow</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.20</p>
@ -448,7 +448,7 @@ gtk_viewport_get_bin_window (<em class="parameter"><code><a class="link" href="G
<hr>
<div class="refsect2">
<a name="gtk-viewport-get-view-window"></a><h3>gtk_viewport_get_view_window ()</h3>
<pre class="programlisting"><span class="returnvalue">GdkWindow</span> *
<pre class="programlisting"><a href="../html/gdk3-Windows.html#GdkWindow-struct"><span class="returnvalue">GdkWindow</span></a> *
gtk_viewport_get_view_window (<em class="parameter"><code><a class="link" href="GtkViewport.html" title="GtkViewport"><span class="type">GtkViewport</span></a> *viewport</code></em>);</pre>
<p>Gets the view window of the <a class="link" href="GtkViewport.html" title="GtkViewport"><span class="type">GtkViewport</span></a>.</p>
<div class="refsect3">
@ -468,7 +468,7 @@ gtk_viewport_get_view_window (<em class="parameter"><code><a class="link" href="
</div>
<div class="refsect3">
<a name="gtk-viewport-get-view-window.returns"></a><h4>Returns</h4>
<p>a <span class="type">GdkWindow</span>. </p>
<p>a <a href="../html/gdk3-Windows.html#GdkWindow-struct"><span class="type">GdkWindow</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.22</p>

546
docs/reference/gtk/html/GtkWidget.html
View File

File diff suppressed because it is too large Load Diff

106
docs/reference/gtk/html/GtkWindow.html
View File

@ -158,7 +158,7 @@
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">GdkGravity</span>
<a href="../html/gdk3-Windows.html#GdkGravity"><span class="returnvalue">GdkGravity</span></a>
</td>
<td class="function_name">
<a class="link" href="GtkWindow.html#gtk-window-get-gravity" title="gtk_window_get_gravity ()">gtk_window_get_gravity</a> <span class="c_punctuation">()</span>
@ -214,7 +214,7 @@
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">GdkScreen</span> *
<a href="../html/GdkScreen.html#GdkScreen-struct"><span class="returnvalue">GdkScreen</span></a> *
</td>
<td class="function_name">
<a class="link" href="GtkWindow.html#gtk-window-get-screen" title="gtk_window_get_screen ()">gtk_window_get_screen</a> <span class="c_punctuation">()</span>
@ -620,7 +620,7 @@
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">GdkModifierType</span>
<a href="../html/gdk3-Windows.html#GdkModifierType"><span class="returnvalue">GdkModifierType</span></a>
</td>
<td class="function_name">
<a class="link" href="GtkWindow.html#gtk-window-get-mnemonic-modifier" title="gtk_window_get_mnemonic_modifier ()">gtk_window_get_mnemonic_modifier</a> <span class="c_punctuation">()</span>
@ -682,7 +682,7 @@
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">GdkWindowTypeHint</span>
<a href="../html/gdk3-Windows.html#GdkWindowTypeHint"><span class="returnvalue">GdkWindowTypeHint</span></a>
</td>
<td class="function_name">
<a class="link" href="GtkWindow.html#gtk-window-get-type-hint" title="gtk_window_get_type_hint ()">gtk_window_get_type_hint</a> <span class="c_punctuation">()</span>
@ -1057,7 +1057,7 @@
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type"><span class="type">GdkGravity</span></td>
<td class="property_type"><a href="../html/gdk3-Windows.html#GdkGravity"><span class="type">GdkGravity</span></a></td>
<td class="property_name"><a class="link" href="GtkWindow.html#GtkWindow--gravity" title="The “gravity” property">gravity</a></td>
<td class="property_flags">Read / Write</td>
</tr>
@ -1126,7 +1126,7 @@
</tr>
<tr>
<td class="property_type">
<span class="type">GdkScreen</span> *</td>
<a href="../html/GdkScreen.html#GdkScreen-struct"><span class="type">GdkScreen</span></a> *</td>
<td class="property_name"><a class="link" href="GtkWindow.html#GtkWindow--screen" title="The “screen” property">screen</a></td>
<td class="property_flags">Read / Write</td>
</tr>
@ -1164,7 +1164,7 @@
<td class="property_flags">Read / Write / Construct Only</td>
</tr>
<tr>
<td class="property_type"><span class="type">GdkWindowTypeHint</span></td>
<td class="property_type"><a href="../html/gdk3-Windows.html#GdkWindowTypeHint"><span class="type">GdkWindowTypeHint</span></a></td>
<td class="property_name"><a class="link" href="GtkWindow.html#GtkWindow--type-hint" title="The “type-hint” property">type-hint</a></td>
<td class="property_flags">Read / Write</td>
</tr>
@ -1831,12 +1831,12 @@ gtk_window_set_geometry_hints.</p>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_window_set_geometry_hints (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>,
<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *geometry_widget</code></em>,
<em class="parameter"><code><span class="type">GdkGeometry</span> *geometry</code></em>,
<em class="parameter"><code><span class="type">GdkWindowHints</span> geom_mask</code></em>);</pre>
<em class="parameter"><code><a href="../html/gdk3-Windows.html#GdkGeometry"><span class="type">GdkGeometry</span></a> *geometry</code></em>,
<em class="parameter"><code><a href="../html/gdk3-Windows.html#GdkWindowHints"><span class="type">GdkWindowHints</span></a> geom_mask</code></em>);</pre>
<p>This function sets up hints about how a window can be resized by
the user. You can set a minimum and maximum size; allowed resize
increments (e.g. for xterm, you can only resize by the size of a
character); aspect ratios; and more. See the <span class="type">GdkGeometry</span> struct.</p>
character); aspect ratios; and more. See the <a href="../html/gdk3-Windows.html#GdkGeometry"><span class="type">GdkGeometry</span></a> struct.</p>
<div class="refsect3">
<a name="gtk-window-set-geometry-hints.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
@ -1877,11 +1877,11 @@ set. </p></td>
<a name="gtk-window-set-gravity"></a><h3>gtk_window_set_gravity ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_window_set_gravity (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>,
<em class="parameter"><code><span class="type">GdkGravity</span> gravity</code></em>);</pre>
<em class="parameter"><code><a href="../html/gdk3-Windows.html#GdkGravity"><span class="type">GdkGravity</span></a> gravity</code></em>);</pre>
<p>Window gravity defines the meaning of coordinates passed to
<a class="link" href="GtkWindow.html#gtk-window-move" title="gtk_window_move ()"><code class="function">gtk_window_move()</code></a>. See <a class="link" href="GtkWindow.html#gtk-window-move" title="gtk_window_move ()"><code class="function">gtk_window_move()</code></a> and <span class="type">GdkGravity</span> for
<a class="link" href="GtkWindow.html#gtk-window-move" title="gtk_window_move ()"><code class="function">gtk_window_move()</code></a>. See <a class="link" href="GtkWindow.html#gtk-window-move" title="gtk_window_move ()"><code class="function">gtk_window_move()</code></a> and <a href="../html/gdk3-Windows.html#GdkGravity"><span class="type">GdkGravity</span></a> for
more details.</p>
<p>The default window gravity is <span class="type">GDK_GRAVITY_NORTH_WEST</span> which will
<p>The default window gravity is <a href="../html/gdk3-Windows.html#GDK-GRAVITY-NORTH-WEST:CAPS"><span class="type">GDK_GRAVITY_NORTH_WEST</span></a> which will
typically “do what you mean.”</p>
<div class="refsect3">
<a name="gtk-window-set-gravity.parameters"></a><h4>Parameters</h4>
@ -1909,7 +1909,7 @@ typically “do what you mean.”</p>
<hr>
<div class="refsect2">
<a name="gtk-window-get-gravity"></a><h3>gtk_window_get_gravity ()</h3>
<pre class="programlisting"><span class="returnvalue">GdkGravity</span>
<pre class="programlisting"><a href="../html/gdk3-Windows.html#GdkGravity"><span class="returnvalue">GdkGravity</span></a>
gtk_window_get_gravity (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>);</pre>
<p>Gets the value set by <a class="link" href="GtkWindow.html#gtk-window-set-gravity" title="gtk_window_set_gravity ()"><code class="function">gtk_window_set_gravity()</code></a>.</p>
<div class="refsect3">
@ -1983,7 +1983,7 @@ functions in GTK+ will sometimes call
<p>On Wayland, this function can also be used to attach a new
<a class="link" href="GtkWindow.html#GTK-WINDOW-POPUP:CAPS"><span class="type">GTK_WINDOW_POPUP</span></a> to a <a class="link" href="GtkWindow.html#GTK-WINDOW-TOPLEVEL:CAPS"><span class="type">GTK_WINDOW_TOPLEVEL</span></a> parent already mapped
on screen so that the <a class="link" href="GtkWindow.html#GTK-WINDOW-POPUP:CAPS"><span class="type">GTK_WINDOW_POPUP</span></a> will be created as a
subsurface-based window <span class="type">GDK_WINDOW_SUBSURFACE</span> which can be
subsurface-based window <a href="../html/gdk3-Windows.html#GDK-WINDOW-SUBSURFACE:CAPS"><span class="type">GDK_WINDOW_SUBSURFACE</span></a> which can be
positioned at will relatively to the <a class="link" href="GtkWindow.html#GTK-WINDOW-TOPLEVEL:CAPS"><span class="type">GTK_WINDOW_TOPLEVEL</span></a> surface.</p>
<p>On Windows, this function puts the child window on top of the parent,
much as the window manager would have done on X.</p>
@ -2141,8 +2141,8 @@ is maximized</p></td>
<a name="gtk-window-set-screen"></a><h3>gtk_window_set_screen ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_window_set_screen (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>,
<em class="parameter"><code><span class="type">GdkScreen</span> *screen</code></em>);</pre>
<p>Sets the <span class="type">GdkScreen</span> where the <em class="parameter"><code>window</code></em>
<em class="parameter"><code><a href="../html/GdkScreen.html#GdkScreen-struct"><span class="type">GdkScreen</span></a> *screen</code></em>);</pre>
<p>Sets the <a href="../html/GdkScreen.html#GdkScreen-struct"><span class="type">GdkScreen</span></a> where the <em class="parameter"><code>window</code></em>
is displayed; if
the window is already mapped, it will be unmapped, and
then remapped on the new screen.</p>
@ -2162,7 +2162,7 @@ then remapped on the new screen.</p>
</tr>
<tr>
<td class="parameter_name"><p>screen</p></td>
<td class="parameter_description"><p>a <span class="type">GdkScreen</span>.</p></td>
<td class="parameter_description"><p>a <a href="../html/GdkScreen.html#GdkScreen-struct"><span class="type">GdkScreen</span></a>.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
@ -2173,9 +2173,9 @@ then remapped on the new screen.</p>
<hr>
<div class="refsect2">
<a name="gtk-window-get-screen"></a><h3>gtk_window_get_screen ()</h3>
<pre class="programlisting"><span class="returnvalue">GdkScreen</span> *
<pre class="programlisting"><a href="../html/GdkScreen.html#GdkScreen-struct"><span class="returnvalue">GdkScreen</span></a> *
gtk_window_get_screen (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>);</pre>
<p>Returns the <span class="type">GdkScreen</span> associated with <em class="parameter"><code>window</code></em>
<p>Returns the <a href="../html/GdkScreen.html#GdkScreen-struct"><span class="type">GdkScreen</span></a> associated with <em class="parameter"><code>window</code></em>
.</p>
<div class="refsect3">
<a name="gtk-window-get-screen.parameters"></a><h4>Parameters</h4>
@ -2194,7 +2194,7 @@ gtk_window_get_screen (<em class="parameter"><code><a class="link" href="GtkWind
</div>
<div class="refsect3">
<a name="gtk-window-get-screen.returns"></a><h4>Returns</h4>
<p>a <span class="type">GdkScreen</span>. </p>
<p>a <a href="../html/GdkScreen.html#GdkScreen-struct"><span class="type">GdkScreen</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.2</p>
@ -2389,7 +2389,7 @@ gtk_window_remove_mnemonic (<em class="parameter"><code><a class="link" href="Gt
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gtk_window_mnemonic_activate (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>,
<em class="parameter"><code><span class="type">guint</span> keyval</code></em>,
<em class="parameter"><code><span class="type">GdkModifierType</span> modifier</code></em>);</pre>
<em class="parameter"><code><a href="../html/gdk3-Windows.html#GdkModifierType"><span class="type">GdkModifierType</span></a> modifier</code></em>);</pre>
<p>Activates the targets associated with the mnemonic.</p>
<div class="refsect3">
<a name="gtk-window-mnemonic-activate.parameters"></a><h4>Parameters</h4>
@ -2428,7 +2428,7 @@ gtk_window_mnemonic_activate (<em class="parameter"><code><a class="link" href="
<a name="gtk-window-activate-key"></a><h3>gtk_window_activate_key ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gtk_window_activate_key (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>,
<em class="parameter"><code><span class="type">GdkEventKey</span> *event</code></em>);</pre>
<em class="parameter"><code><a href="../html/gdk3-Event-Structures.html#GdkEventKey"><span class="type">GdkEventKey</span></a> *event</code></em>);</pre>
<p>Activates mnemonics and accelerators for this <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a>. This is normally
called by the default ::key_press_event handler for toplevel windows,
however in some cases it may be useful to call this directly when
@ -2449,7 +2449,7 @@ overriding the standard key handling for a toplevel window.</p>
</tr>
<tr>
<td class="parameter_name"><p>event</p></td>
<td class="parameter_description"><p>a <span class="type">GdkEventKey</span></p></td>
<td class="parameter_description"><p>a <a href="../html/gdk3-Event-Structures.html#GdkEventKey"><span class="type">GdkEventKey</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
@ -2466,7 +2466,7 @@ overriding the standard key handling for a toplevel window.</p>
<a name="gtk-window-propagate-key-event"></a><h3>gtk_window_propagate_key_event ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gtk_window_propagate_key_event (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>,
<em class="parameter"><code><span class="type">GdkEventKey</span> *event</code></em>);</pre>
<em class="parameter"><code><a href="../html/gdk3-Event-Structures.html#GdkEventKey"><span class="type">GdkEventKey</span></a> *event</code></em>);</pre>
<p>Propagate a key press or release event to the focus widget and
up the focus container chain until a widget handles <em class="parameter"><code>event</code></em>
.
@ -2490,7 +2490,7 @@ overriding the standard key handling for a toplevel window.</p>
</tr>
<tr>
<td class="parameter_name"><p>event</p></td>
<td class="parameter_description"><p>a <span class="type">GdkEventKey</span></p></td>
<td class="parameter_description"><p>a <a href="../html/gdk3-Event-Structures.html#GdkEventKey"><span class="type">GdkEventKey</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
@ -2961,7 +2961,7 @@ on <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">Gt
<a name="gtk-window-fullscreen-on-monitor"></a><h3>gtk_window_fullscreen_on_monitor ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_window_fullscreen_on_monitor (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>,
<em class="parameter"><code><span class="type">GdkScreen</span> *screen</code></em>,
<em class="parameter"><code><a href="../html/GdkScreen.html#GdkScreen-struct"><span class="type">GdkScreen</span></a> *screen</code></em>,
<em class="parameter"><code><span class="type">gint</span> monitor</code></em>);</pre>
<p>Asks to place <em class="parameter"><code>window</code></em>
in the fullscreen state. Note that you shouldn't assume
@ -2984,7 +2984,7 @@ on <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">Gt
</tr>
<tr>
<td class="parameter_name"><p>screen</p></td>
<td class="parameter_description"><p>a <span class="type">GdkScreen</span> to draw to</p></td>
<td class="parameter_description"><p>a <a href="../html/GdkScreen.html#GdkScreen-struct"><span class="type">GdkScreen</span></a> to draw to</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
@ -3132,7 +3132,7 @@ below other windows</p></td>
<a name="gtk-window-begin-resize-drag"></a><h3>gtk_window_begin_resize_drag ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_window_begin_resize_drag (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>,
<em class="parameter"><code><span class="type">GdkWindowEdge</span> edge</code></em>,
<em class="parameter"><code><a href="../html/gdk3-Windows.html#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>,
@ -3322,7 +3322,7 @@ policy involved.</p>
<a name="gtk-window-set-mnemonic-modifier"></a><h3>gtk_window_set_mnemonic_modifier ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_window_set_mnemonic_modifier (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>,
<em class="parameter"><code><span class="type">GdkModifierType</span> modifier</code></em>);</pre>
<em class="parameter"><code><a href="../html/gdk3-Windows.html#GdkModifierType"><span class="type">GdkModifierType</span></a> modifier</code></em>);</pre>
<p>Sets the mnemonic modifier for this window.</p>
<div class="refsect3">
<a name="gtk-window-set-mnemonic-modifier.parameters"></a><h4>Parameters</h4>
@ -3353,7 +3353,7 @@ mnemonics on this window.</p></td>
<a name="gtk-window-set-type-hint"></a><h3>gtk_window_set_type_hint ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_window_set_type_hint (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>,
<em class="parameter"><code><span class="type">GdkWindowTypeHint</span> hint</code></em>);</pre>
<em class="parameter"><code><a href="../html/gdk3-Windows.html#GdkWindowTypeHint"><span class="type">GdkWindowTypeHint</span></a> hint</code></em>);</pre>
<p>By setting the type hint for the window, you allow the window
manager to decorate and handle the window in a way which is
suitable to the function of the window in your application.</p>
@ -3898,7 +3898,7 @@ no themed icon. </p>
<hr>
<div class="refsect2">
<a name="gtk-window-get-mnemonic-modifier"></a><h3>gtk_window_get_mnemonic_modifier ()</h3>
<pre class="programlisting"><span class="returnvalue">GdkModifierType</span>
<pre class="programlisting"><a href="../html/gdk3-Windows.html#GdkModifierType"><span class="returnvalue">GdkModifierType</span></a>
gtk_window_get_mnemonic_modifier (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>);</pre>
<p>Returns the mnemonic modifier for this window. See
<a class="link" href="GtkWindow.html#gtk-window-set-mnemonic-modifier" title="gtk_window_set_mnemonic_modifier ()"><code class="function">gtk_window_set_mnemonic_modifier()</code></a>.</p>
@ -3972,11 +3972,11 @@ have been known to mismanage window gravity, which result in windows
moving even if you use the coordinates of the current position as
returned by this function.</p>
<p>If you haven’t changed the window gravity, its gravity will be
<span class="type">GDK_GRAVITY_NORTH_WEST</span>. This means that <a class="link" href="GtkWindow.html#gtk-window-get-position" title="gtk_window_get_position ()"><code class="function">gtk_window_get_position()</code></a>
<a href="../html/gdk3-Windows.html#GDK-GRAVITY-NORTH-WEST:CAPS"><span class="type">GDK_GRAVITY_NORTH_WEST</span></a>. This means that <a class="link" href="GtkWindow.html#gtk-window-get-position" title="gtk_window_get_position ()"><code class="function">gtk_window_get_position()</code></a>
gets the position of the top-left corner of the window manager
frame for the window. <a class="link" href="GtkWindow.html#gtk-window-move" title="gtk_window_move ()"><code class="function">gtk_window_move()</code></a> sets the position of this
same top-left corner.</p>
<p>If a window has gravity <span class="type">GDK_GRAVITY_STATIC</span> the window manager
<p>If a window has gravity <a href="../html/gdk3-Windows.html#GDK-GRAVITY-STATIC:CAPS"><span class="type">GDK_GRAVITY_STATIC</span></a> the window manager
frame is not relevant, and thus <a class="link" href="GtkWindow.html#gtk-window-get-position" title="gtk_window_get_position ()"><code class="function">gtk_window_get_position()</code></a> will
always produce accurate results. However you can’t use static
gravity to do things like place a window in a corner of the screen,
@ -4268,7 +4268,7 @@ is attached, or <code class="literal">NULL</code> if the window is not attached
<hr>
<div class="refsect2">
<a name="gtk-window-get-type-hint"></a><h3>gtk_window_get_type_hint ()</h3>
<pre class="programlisting"><span class="returnvalue">GdkWindowTypeHint</span>
<pre class="programlisting"><a href="../html/gdk3-Windows.html#GdkWindowTypeHint"><span class="returnvalue">GdkWindowTypeHint</span></a>
gtk_window_get_type_hint (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>);</pre>
<p>Gets the type hint for this window. See <a class="link" href="GtkWindow.html#gtk-window-set-type-hint" title="gtk_window_set_type_hint ()"><code class="function">gtk_window_set_type_hint()</code></a>.</p>
<div class="refsect3">
@ -4535,7 +4535,7 @@ reference point for the window. The gravity determines two things:
first, the location of the reference point in root window
coordinates; and second, which point on the window is positioned at
the reference point.</p>
<p>By default the gravity is <span class="type">GDK_GRAVITY_NORTH_WEST</span>, so the reference
<p>By default the gravity is <a href="../html/gdk3-Windows.html#GDK-GRAVITY-NORTH-WEST:CAPS"><span class="type">GDK_GRAVITY_NORTH_WEST</span></a>, so the reference
point is simply the <em class="parameter"><code>x</code></em>
, <em class="parameter"><code>y</code></em>
supplied to <a class="link" href="GtkWindow.html#gtk-window-move" title="gtk_window_move ()"><code class="function">gtk_window_move()</code></a>. The
@ -4544,17 +4544,17 @@ border) will be placed at <em class="parameter"><code>x</code></em>
, <em class="parameter"><code>y</code></em>
. Therefore, to position a window
at the top left of the screen, you want to use the default gravity
(which is <span class="type">GDK_GRAVITY_NORTH_WEST</span>) and move the window to 0,0.</p>
(which is <a href="../html/gdk3-Windows.html#GDK-GRAVITY-NORTH-WEST:CAPS"><span class="type">GDK_GRAVITY_NORTH_WEST</span></a>) and move the window to 0,0.</p>
<p>To position a window at the bottom right corner of the screen, you
would set <span class="type">GDK_GRAVITY_SOUTH_EAST</span>, which means that the reference
would set <a href="../html/gdk3-Windows.html#GDK-GRAVITY-SOUTH-EAST:CAPS"><span class="type">GDK_GRAVITY_SOUTH_EAST</span></a>, which means that the reference
point is at <em class="parameter"><code>x</code></em>
+ the window width and <em class="parameter"><code>y</code></em>
+ the window height, and
the bottom-right corner of the window border will be placed at that
reference point. So, to place a window in the bottom right corner
you would first set gravity to south east, then write:
<code class="literal">gtk_window_move (window, <code class="function">gdk_screen_width()</code> - window_width,
<code class="function">gdk_screen_height()</code> - window_height)</code> (note that this
<code class="literal">gtk_window_move (window, <a href="../html/gdk3-General.html#gdk-screen-width"><code class="function">gdk_screen_width()</code></a> - window_width,
<a href="../html/gdk3-General.html#gdk-screen-height"><code class="function">gdk_screen_height()</code></a> - window_height)</code> (note that this
example does not take multi-head scenarios into account).</p>
<p>The <a class="ulink" href="http://www.freedesktop.org/Standards/wm-spec" target="_top">Extended Window Manager Hints Specification</a>
has a nice table of gravities in the “implementation notes” section.</p>
@ -4606,7 +4606,7 @@ geometry string, <a class="link" href="GtkWindow.html#gtk-window-parse-geometry"
and calls <a class="link" href="GtkWindow.html#gtk-window-set-default-size" title="gtk_window_set_default_size ()"><code class="function">gtk_window_set_default_size()</code></a> and/or <a class="link" href="GtkWindow.html#gtk-window-move" title="gtk_window_move ()"><code class="function">gtk_window_move()</code></a>
to resize/move the window.</p>
<p>If <a class="link" href="GtkWindow.html#gtk-window-parse-geometry" title="gtk_window_parse_geometry ()"><code class="function">gtk_window_parse_geometry()</code></a> returns <code class="literal">TRUE</code>, it will also
set the <span class="type">GDK_HINT_USER_POS</span> and/or <span class="type">GDK_HINT_USER_SIZE</span> hints
set the <a href="../html/gdk3-Windows.html#GDK-HINT-USER-POS:CAPS"><span class="type">GDK_HINT_USER_POS</span></a> and/or <a href="../html/gdk3-Windows.html#GDK-HINT-USER-SIZE:CAPS"><span class="type">GDK_HINT_USER_SIZE</span></a> hints
indicating to the window manager that the size/position of
the window was user-specified. This causes most window
managers to honor the geometry.</p>
@ -4681,7 +4681,7 @@ on the window.</p>
<span class="normal"> </span><span class="usertype">GtkWidget</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">window</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">vbox</span><span class="symbol">;</span>
<span class="normal"> </span><span class="usertype">GdkGeometry</span><span class="normal"> size_hints </span><span class="symbol">=</span><span class="normal"> </span><span class="cbracket">{</span>
<span class="normal"> </span><span class="number">100</span><span class="symbol">,</span><span class="normal"> </span><span class="number">50</span><span class="symbol">,</span><span class="normal"> </span><span class="number">0</span><span class="symbol">,</span><span class="normal"> </span><span class="number">0</span><span class="symbol">,</span><span class="normal"> </span><span class="number">100</span><span class="symbol">,</span><span class="normal"> </span><span class="number">50</span><span class="symbol">,</span><span class="normal"> </span><span class="number">10</span><span class="symbol">,</span>
<span class="normal"> </span><span class="number">10</span><span class="symbol">,</span><span class="normal"> </span><span class="number">0.0</span><span class="symbol">,</span><span class="normal"> </span><span class="number">0.0</span><span class="symbol">,</span><span class="normal"> GDK_GRAVITY_NORTH_WEST</span>
<span class="normal"> </span><span class="number">10</span><span class="symbol">,</span><span class="normal"> </span><span class="number">0.0</span><span class="symbol">,</span><span class="normal"> </span><span class="number">0.0</span><span class="symbol">,</span><span class="normal"> <a href="../html/gdk3-Windows.html#GDK-GRAVITY-NORTH-WEST:CAPS">GDK_GRAVITY_NORTH_WEST</a></span>
<span class="normal"> </span><span class="cbracket">}</span><span class="symbol">;</span>
<span class="normal"> </span><span class="function"><a href="gtk3-General.html#gtk-init">gtk_init</a></span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">argc</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">argv</span><span class="symbol">);</span>
@ -4696,9 +4696,9 @@ on the window.</p>
<span class="normal"> </span><span class="function"><a href="GtkWindow.html#gtk-window-set-geometry-hints">gtk_window_set_geometry_hints</a></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">window</span><span class="symbol">),</span>
<span class="normal"> NULL</span><span class="symbol">,</span>
<span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">size_hints</span><span class="symbol">,</span>
<span class="normal"> GDK_HINT_MIN_SIZE </span><span class="symbol">|</span>
<span class="normal"> GDK_HINT_BASE_SIZE </span><span class="symbol">|</span>
<span class="normal"> GDK_HINT_RESIZE_INC</span><span class="symbol">);</span>
<span class="normal"> <a href="../html/gdk3-Windows.html#GDK-HINT-MIN-SIZE:CAPS">GDK_HINT_MIN_SIZE</a> </span><span class="symbol">|</span>
<span class="normal"> <a href="../html/gdk3-Windows.html#GDK-HINT-BASE-SIZE:CAPS">GDK_HINT_BASE_SIZE</a> </span><span class="symbol">|</span>
<span class="normal"> <a href="../html/gdk3-Windows.html#GDK-HINT-RESIZE-INC:CAPS">GDK_HINT_RESIZE_INC</a></span><span class="symbol">);</span>
<span class="normal"> </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">argc </span><span class="symbol">&gt;</span><span class="normal"> </span><span class="number">1</span><span class="symbol">)</span>
<span class="normal"> </span><span class="cbracket">{</span>
@ -5181,7 +5181,7 @@ property which is mentioned in the ICCCM.</p>
gtk_window_set_auto_startup_notification
(<em class="parameter"><code><span class="type">gboolean</span> setting</code></em>);</pre>
<p>By default, after showing the first <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a>, GTK+ calls
<code class="function">gdk_notify_startup_complete()</code>. Call this function to disable
<a href="../html/gdk3-General.html#gdk-notify-startup-complete"><code class="function">gdk_notify_startup_complete()</code></a>. Call this function to disable
the automatic startup notification. You might do this if your
first window is a splash screen, and you want to delay notification
until after your real main window has been shown, for example.</p>
@ -5505,13 +5505,13 @@ gtk_window_resize_grip_is_visible (<em class="parameter"><code><a class="link" h
<a name="gtk-window-get-resize-grip-area"></a><h3>gtk_window_get_resize_grip_area ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gtk_window_get_resize_grip_area (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *window</code></em>,
<em class="parameter"><code><span class="type">GdkRectangle</span> *rect</code></em>);</pre>
<em class="parameter"><code><a href="../html/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *rect</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_window_get_resize_grip_area</code> has been deprecated since version 3.14 and should not be used in newly-written code.</p>
<p>Resize grips have been removed.</p>
</div>
<p>If a window has a resize grip, this will retrieve the grip
position, width and height into the specified <span class="type">GdkRectangle</span>.</p>
position, width and height into the specified <a href="../html/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a>.</p>
<div class="refsect3">
<a name="gtk-window-get-resize-grip-area.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
@ -5528,7 +5528,7 @@ position, width and height into the specified <span class="type">GdkRectangle</s
</tr>
<tr>
<td class="parameter_name"><p>rect</p></td>
<td class="parameter_description"><p>a pointer to a <span class="type">GdkRectangle</span> which we should store
<td class="parameter_description"><p>a pointer to a <a href="../html/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> which we should store
the resize grip area. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
</tr>
@ -6007,8 +6007,8 @@ and should not be set by applications.</p>
<hr>
<div class="refsect2">
<a name="GtkWindow--gravity"></a><h3>The <code class="literal">“gravity”</code> property</h3>
<pre class="programlisting"> “gravity” <span class="type">GdkGravity</span></pre>
<p>The window gravity of the window. See <a class="link" href="GtkWindow.html#gtk-window-move" title="gtk_window_move ()"><code class="function">gtk_window_move()</code></a> and <span class="type">GdkGravity</span> for
<pre class="programlisting"> “gravity” <a href="../html/gdk3-Windows.html#GdkGravity"><span class="type">GdkGravity</span></a></pre>
<p>The window gravity of the window. See <a class="link" href="GtkWindow.html#gtk-window-move" title="gtk_window_move ()"><code class="function">gtk_window_move()</code></a> and <a href="../html/gdk3-Windows.html#GdkGravity"><span class="type">GdkGravity</span></a> for
more details about window gravity.</p>
<p>Flags: Read / Write</p>
<p>Default value: GDK_GRAVITY_NORTH_WEST</p>
@ -6132,7 +6132,7 @@ and should not be set by applications.</p>
<hr>
<div class="refsect2">
<a name="GtkWindow--screen"></a><h3>The <code class="literal">“screen”</code> property</h3>
<pre class="programlisting"> “screen” <span class="type">GdkScreen</span> *</pre>
<pre class="programlisting"> “screen” <a href="../html/GdkScreen.html#GdkScreen-struct"><span class="type">GdkScreen</span></a> *</pre>
<p>The screen where this window will be displayed.</p>
<p>Flags: Read / Write</p>
</div>
@ -6191,7 +6191,7 @@ more details about transient windows.</p>
<hr>
<div class="refsect2">
<a name="GtkWindow--type-hint"></a><h3>The <code class="literal">“type-hint”</code> property</h3>
<pre class="programlisting"> “type-hint” <span class="type">GdkWindowTypeHint</span></pre>
<pre class="programlisting"> “type-hint” <a href="../html/gdk3-Windows.html#GdkWindowTypeHint"><span class="type">GdkWindowTypeHint</span></a></pre>
<p>Hint to help the desktop environment understand what kind of window this is and how to treat it.</p>
<p>Flags: Read / Write</p>
<p>Default value: GDK_WINDOW_TYPE_HINT_NORMAL</p>

4
docs/reference/gtk/html/GtkWindowGroup.html
View File

@ -269,7 +269,7 @@ see <a class="link" href="gtk3-General.html#gtk-grab-add" title="gtk_grab_add (
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
gtk_window_group_get_current_device_grab
(<em class="parameter"><code><a class="link" href="GtkWindowGroup.html" title="GtkWindowGroup"><span class="type">GtkWindowGroup</span></a> *window_group</code></em>,
<em class="parameter"><code><span class="type">GdkDevice</span> *device</code></em>);</pre>
<em class="parameter"><code><a href="../html/GdkDevice.html#GdkDevice-struct"><span class="type">GdkDevice</span></a> *device</code></em>);</pre>
<p>Returns the current grab widget for <em class="parameter"><code>device</code></em>
, or <code class="literal">NULL</code> if none.</p>
<div class="refsect3">
@ -288,7 +288,7 @@ gtk_window_group_get_current_device_grab
</tr>
<tr>
<td class="parameter_name"><p>device</p></td>
<td class="parameter_description"><p>a <span class="type">GdkDevice</span></p></td>
<td class="parameter_description"><p>a <a href="../html/GdkDevice.html#GdkDevice-struct"><span class="type">GdkDevice</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>

70
docs/reference/gtk/html/ch26s02.html
View File

@ -418,15 +418,15 @@
<td><a href="/usr/share/gtk-doc/html/cairo/cairo-Regions.html#cairo-region-t"><span class="type">cairo_region_t</span></a></td>
</tr>
<tr>
<td><span class="type">GdkRectangle</span></td>
<td><a href="../html/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a></td>
<td><a href="/usr/share/gtk-doc/html/cairo/cairo-Types.html#cairo-rectangle-int-t"><span class="type">cairo_rectangle_int_t</span></a></td>
</tr>
<tr>
<td><code class="function">gdk_rectangle_intersect()</code></td>
<td><a href="../html/gdk3-Points-Rectangles-and-Regions.html#gdk-rectangle-intersect"><code class="function">gdk_rectangle_intersect()</code></a></td>
<td>this function is still there</td>
</tr>
<tr>
<td><code class="function">gdk_rectangle_union()</code></td>
<td><a href="../html/gdk3-Points-Rectangles-and-Regions.html#gdk-rectangle-union"><code class="function">gdk_rectangle_union()</code></a></td>
<td>this function is still there</td>
</tr>
<tr>
@ -551,7 +551,7 @@
<span class="normal">pixmap </span><span class="symbol">=</span><span class="normal"> </span><span class="function">gdk_pixmap_new</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">NULL</span><span class="symbol">,</span><span class="normal"> </span><span class="number">1</span><span class="symbol">,</span><span class="normal"> </span><span class="number">1</span><span class="symbol">,</span><span class="normal"> </span><span class="number">1</span><span class="symbol">);</span>
<span class="normal">cr </span><span class="symbol">=</span><span class="normal"> </span><span class="function">gdk_cairo_create</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">pixmap</span><span class="symbol">);</span>
<span class="normal">cr </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="../html/gdk3-Cairo-Interaction.html#gdk-cairo-create">gdk_cairo_create</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">pixmap</span><span class="symbol">);</span>
<span class="function"><a href="/usr/share/gtk-doc/html/cairo/cairo-Paths.html#cairo-rectangle">cairo_rectangle</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">cr</span><span class="symbol">,</span><span class="normal"> </span><span class="number">0</span><span class="symbol">,</span><span class="normal"> </span><span class="number">0</span><span class="symbol">,</span><span class="normal"> </span><span class="number">1</span><span class="symbol">,</span><span class="normal"> </span><span class="number">1</span><span class="symbol">);</span>
<span class="function"><a href="/usr/share/gtk-doc/html/cairo/cairo-cairo-t.html#cairo-fill">cairo_fill</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">cr</span><span class="symbol">);</span>
<span class="function"><a href="/usr/share/gtk-doc/html/cairo/cairo-cairo-t.html#cairo-destroy">cairo_destroy</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">cr</span><span class="symbol">);</span>
@ -603,13 +603,13 @@
<span class="function"><a href="/usr/share/gtk-doc/html/cairo/cairo-cairo-t.html#cairo-fill">cairo_fill</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">cr</span><span class="symbol">);</span>
<span class="function"><a href="/usr/share/gtk-doc/html/cairo/cairo-cairo-t.html#cairo-destroy">cairo_destroy</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">cr</span><span class="symbol">);</span>
<span class="normal">pixbuf </span><span class="symbol">=</span><span class="normal"> </span><span class="function">gdk_pixbuf_get_from_surface</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">s</span><span class="symbol">,</span>
<span class="normal">pixbuf </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="../html/gdk3-Pixbufs.html#gdk-pixbuf-get-from-surface">gdk_pixbuf_get_from_surface</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">s</span><span class="symbol">,</span>
<span class="normal"> </span><span class="number">0</span><span class="symbol">,</span><span class="normal"> </span><span class="number">0</span><span class="symbol">,</span>
<span class="normal"> </span><span class="number">3</span><span class="symbol">,</span><span class="normal"> </span><span class="number">3</span><span class="symbol">);</span>
<span class="function"><a href="/usr/share/gtk-doc/html/cairo/cairo-cairo-surface-t.html#cairo-surface-destroy">cairo_surface_destroy</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">s</span><span class="symbol">);</span>
<span class="normal">cursor </span><span class="symbol">=</span><span class="normal"> </span><span class="function">gdk_cursor_new_from_pixbuf</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">display</span><span class="symbol">,</span><span class="normal"> pixbuf</span><span class="symbol">,</span><span class="normal"> </span><span class="number">0</span><span class="symbol">,</span><span class="normal"> </span><span class="number">0</span><span class="symbol">);</span>
<span class="normal">cursor </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="../html/gdk3-Cursors.html#gdk-cursor-new-from-pixbuf">gdk_cursor_new_from_pixbuf</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">display</span><span class="symbol">,</span><span class="normal"> pixbuf</span><span class="symbol">,</span><span class="normal"> </span><span class="number">0</span><span class="symbol">,</span><span class="normal"> </span><span class="number">0</span><span class="symbol">);</span>
<span class="function">g_object_unref</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">pixbuf</span><span class="symbol">);</span></pre></td>
</tr>
@ -628,7 +628,7 @@
<a name="id-1.6.3.4.6"></a>Replace GdkColormap by GdkVisual</h3></div></div></div>
<p>
For drawing with cairo, it is not necessary to allocate colors, and
a <span class="type">GdkVisual</span> provides enough information for cairo to handle colors
a <a href="../html/gdk3-Visuals.html#GdkVisual-struct"><span class="type">GdkVisual</span></a> provides enough information for cairo to handle colors
in 'native' surfaces. Therefore, <span class="type">GdkColormap</span> and related functions
have been removed in GTK+ 3, and visuals are used instead. The
colormap-handling functions of <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> (<code class="function">gtk_widget_set_colormap()</code>,
@ -701,10 +701,10 @@
<span class="normal"> </span><span class="usertype">GtkWidget</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">label</span><span class="symbol">)</span>
<span class="cbracket">{</span>
<span class="normal"> </span><span class="usertype">GdkScreen</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">screen </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GtkWidget.html#gtk-widget-get-screen">gtk_widget_get_screen</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function">GTK_WIDGET</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">window</span><span class="symbol">));</span>
<span class="normal"> </span><span class="usertype">GdkVisual</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">visual </span><span class="symbol">=</span><span class="normal"> </span><span class="function">gdk_screen_get_rgba_visual</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">screen</span><span class="symbol">);</span>
<span class="normal"> </span><span class="usertype">GdkVisual</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">visual </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="../html/GdkScreen.html#gdk-screen-get-rgba-visual">gdk_screen_get_rgba_visual</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">screen</span><span class="symbol">);</span>
<span class="normal"> </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">visual </span><span class="symbol">==</span><span class="normal"> NULL</span><span class="symbol">)</span>
<span class="normal"> visual </span><span class="symbol">=</span><span class="normal"> </span><span class="function">gdk_screen_get_system_visual</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">screen</span><span class="symbol">);</span>
<span class="normal"> visual </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="../html/GdkScreen.html#gdk-screen-get-system-visual">gdk_screen_get_system_visual</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">screen</span><span class="symbol">);</span>
<span class="normal"> </span><span class="function"><a href="GtkWidget.html#gtk-widget-set-visual">gtk_widget_set_visual</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">window</span><span class="symbol">,</span><span class="normal"> visual</span><span class="symbol">);</span>
<span class="cbracket">}</span></pre></td>
@ -722,7 +722,7 @@
<a name="id-1.6.3.4.7"></a>GdkDrawable is gone</h3></div></div></div>
<p>
<span class="type">GdkDrawable</span> has been removed in GTK+ 3, together with <span class="type">GdkPixmap</span>
and <span class="type">GdkImage</span>. The only remaining drawable class is <span class="type">GdkWindow</span>.
and <span class="type">GdkImage</span>. The only remaining drawable class is <a href="../html/gdk3-Windows.html#GdkWindow-struct"><span class="type">GdkWindow</span></a>.
For dealing with image data, you should use a <a href="/usr/share/gtk-doc/html/cairo/cairo-cairo-surface-t.html#cairo-surface-t"><span class="type">cairo_surface_t</span></a> or
a <a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf-struct"><span class="type">GdkPixbuf</span></a>.
</p>
@ -744,26 +744,26 @@
<tbody>
<tr>
<td><code class="function">gdk_drawable_get_visual()</code></td>
<td><code class="function">gdk_window_get_visual()</code></td>
<td><a href="../html/gdk3-Windows.html#gdk-window-get-visual"><code class="function">gdk_window_get_visual()</code></a></td>
</tr>
<tr>
<td><code class="function">gdk_drawable_get_size()</code></td>
<td>
<code class="function">gdk_window_get_width()</code>
<code class="function">gdk_window_get_height()</code>
<a href="../html/gdk3-Windows.html#gdk-window-get-width"><code class="function">gdk_window_get_width()</code></a>
<a href="../html/gdk3-Windows.html#gdk-window-get-height"><code class="function">gdk_window_get_height()</code></a>
</td>
</tr>
<tr>
<td><code class="function">gdk_pixbuf_get_from_drawable()</code></td>
<td><code class="function">gdk_pixbuf_get_from_window()</code></td>
<td><a href="../html/gdk3-Pixbufs.html#gdk-pixbuf-get-from-window"><code class="function">gdk_pixbuf_get_from_window()</code></a></td>
</tr>
<tr>
<td><code class="function">gdk_drawable_get_clip_region()</code></td>
<td><code class="function">gdk_window_get_clip_region()</code></td>
<td><a href="../html/gdk3-Windows.html#gdk-window-get-clip-region"><code class="function">gdk_window_get_clip_region()</code></a></td>
</tr>
<tr>
<td><code class="function">gdk_drawable_get_visible_region()</code></td>
<td><code class="function">gdk_window_get_visible_region()</code></td>
<td><a href="../html/gdk3-Windows.html#gdk-window-get-visible-region"><code class="function">gdk_window_get_visible_region()</code></a></td>
</tr>
</tbody>
</table></div>
@ -781,7 +781,7 @@
<p>
The special-purpose GdkEventClient events and the <code class="function">gdk_add_client_message_filter()</code> and <code class="function">gdk_display_add_client_message_filter()</code> functions have been
removed. Receiving X11 ClientMessage events is still possible, using
the general <code class="function">gdk_window_add_filter()</code> API. A client message filter like
the general <a href="../html/gdk3-Windows.html#gdk-window-add-filter"><code class="function">gdk_window_add_filter()</code></a> API. A client message filter like
</p>
<div class="informalexample">
<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
@ -799,7 +799,7 @@
10
11
12</pre></td>
<td class="listing_code"><pre class="programlisting"><span class="keyword">static</span><span class="normal"> GdkFilterReturn</span>
<td class="listing_code"><pre class="programlisting"><span class="keyword">static</span><span class="normal"> <a href="../html/gdk3-Windows.html#GdkFilterReturn">GdkFilterReturn</a></span>
<span class="function">message_filter</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">GdkXEvent</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">xevent</span><span class="symbol">,</span><span class="normal"> </span><span class="usertype">GdkEvent</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">event</span><span class="symbol">,</span><span class="normal"> </span><span class="usertype">gpointer</span><span class="normal"> data</span><span class="symbol">)</span>
<span class="cbracket">{</span>
<span class="normal"> </span><span class="usertype">XClientMessageEvent</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">evt </span><span class="symbol">=</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">XClientMessageEvent </span><span class="symbol">*)</span><span class="normal">xevent</span><span class="symbol">;</span>
@ -809,7 +809,7 @@
<span class="normal"> </span><span class="symbol">...</span>
<span class="normal">message_type </span><span class="symbol">=</span><span class="normal"> </span><span class="function">gdk_atom_intern</span><span class="normal"> </span><span class="symbol">(</span><span class="string">"MANAGER"</span><span class="symbol">,</span><span class="normal"> FALSE</span><span class="symbol">);</span>
<span class="normal">message_type </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="../html/gdk3-Properties-and-Atoms.html#gdk-atom-intern">gdk_atom_intern</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"MANAGER"</span><span class="symbol">,</span><span class="normal"> FALSE</span><span class="symbol">);</span>
<span class="function">gdk_display_add_client_message_filter</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">display</span><span class="symbol">,</span><span class="normal"> message_type</span><span class="symbol">,</span><span class="normal"> message_filter</span><span class="symbol">,</span><span class="normal"> NULL</span><span class="symbol">);</span></pre></td>
</tr>
</tbody>
@ -844,27 +844,27 @@
19
20
21</pre></td>
<td class="listing_code"><pre class="programlisting"><span class="keyword">static</span><span class="normal"> GdkFilterReturn</span>
<td class="listing_code"><pre class="programlisting"><span class="keyword">static</span><span class="normal"> <a href="../html/gdk3-Windows.html#GdkFilterReturn">GdkFilterReturn</a></span>
<span class="function">event_filter</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">GdkXEvent</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">xevent</span><span class="symbol">,</span><span class="normal"> </span><span class="usertype">GdkEvent</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">event</span><span class="symbol">,</span><span class="normal"> </span><span class="usertype">gpointer</span><span class="normal"> data</span><span class="symbol">)</span>
<span class="cbracket">{</span>
<span class="normal"> </span><span class="usertype">XClientMessageEvent</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">evt</span><span class="symbol">;</span>
<span class="normal"> </span><span class="usertype">GdkAtom</span><span class="normal"> message_type</span><span class="symbol">;</span>
<span class="normal"> </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(((</span><span class="normal">XEvent </span><span class="symbol">*)</span><span class="normal">xevent</span><span class="symbol">)-&gt;</span><span class="normal">type </span><span class="symbol">!=</span><span class="normal"> ClientMessage</span><span class="symbol">)</span>
<span class="normal"> </span><span class="keyword">return</span><span class="normal"> GDK_FILTER_CONTINUE</span><span class="symbol">;</span>
<span class="normal"> </span><span class="keyword">return</span><span class="normal"> <a href="../html/gdk3-Windows.html#GDK-FILTER-CONTINUE:CAPS">GDK_FILTER_CONTINUE</a></span><span class="symbol">;</span>
<span class="normal"> evt </span><span class="symbol">=</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">XClientMessageEvent </span><span class="symbol">*)</span><span class="normal">xevent</span><span class="symbol">;</span>
<span class="normal"> message_type </span><span class="symbol">=</span><span class="normal"> </span><span class="function">XInternAtom</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">evt</span><span class="symbol">-&gt;</span><span class="normal">display</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"MANAGER"</span><span class="symbol">,</span><span class="normal"> FALSE</span><span class="symbol">);</span>
<span class="normal"> </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">evt</span><span class="symbol">-&gt;</span><span class="normal">message_type </span><span class="symbol">!=</span><span class="normal"> message_type</span><span class="symbol">)</span>
<span class="normal"> </span><span class="keyword">return</span><span class="normal"> GDK_FILTER_CONTINUE</span><span class="symbol">;</span>
<span class="normal"> </span><span class="keyword">return</span><span class="normal"> <a href="../html/gdk3-Windows.html#GDK-FILTER-CONTINUE:CAPS">GDK_FILTER_CONTINUE</a></span><span class="symbol">;</span>
<span class="normal"> </span><span class="comment">/* do something with evt ... */</span>
<span class="cbracket">}</span>
<span class="normal"> </span><span class="symbol">...</span>
<span class="function">gdk_window_add_filter</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">NULL</span><span class="symbol">,</span><span class="normal"> message_filter</span><span class="symbol">,</span><span class="normal"> NULL</span><span class="symbol">);</span></pre></td>
<span class="function"><a href="../html/gdk3-Windows.html#gdk-window-add-filter">gdk_window_add_filter</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">NULL</span><span class="symbol">,</span><span class="normal"> message_filter</span><span class="symbol">,</span><span class="normal"> NULL</span><span class="symbol">);</span></pre></td>
</tr>
</tbody>
</table>
@ -873,7 +873,7 @@
<p>
One advantage of using an event filter is that you can actually
remove the filter when you don't need it anymore, using
<code class="function">gdk_window_remove_filter()</code>.
<a href="../html/gdk3-Windows.html#gdk-window-remove-filter"><code class="function">gdk_window_remove_filter()</code></a>.
</p>
<p>
The other difference to be aware of when working with event filters
@ -881,7 +881,7 @@
means that your application does not receive core X11 key or button
events. Instead, all input events are delivered as XIDeviceEvents.
As a short-term workaround for this, you can force your application
to not use XI2, with <code class="function">gdk_disable_multidevice()</code>. In the long term,
to not use XI2, with <a href="../html/GdkDeviceManager.html#gdk-disable-multidevice"><code class="function">gdk_disable_multidevice()</code></a>. In the long term,
you probably want to rewrite your event filter to deal with
XIDeviceEvents.
</p>
@ -891,7 +891,7 @@
<a name="id-1.6.3.4.9"></a>Backend-specific code</h3></div></div></div>
<p>
In GTK+ 2.x, GDK could only be compiled for one backend at a time,
and the <code class="literal">GDK_WINDOWING_X11</code> or <code class="literal">GDK_WINDOWING_WIN32</code> macros could
and the <a href="../html/gdk3-General.html#GDK-WINDOWING-X11:CAPS"><code class="literal">GDK_WINDOWING_X11</code></a> or <a href="../html/gdk3-General.html#GDK-WINDOWING-WIN32:CAPS"><code class="literal">GDK_WINDOWING_WIN32</code></a> macros could
be used to find out which one you are dealing with:
</p>
<div class="informalexample">
@ -905,11 +905,11 @@
5
6
7</pre></td>
<td class="listing_code"><pre class="programlisting"><span class="preproc">#ifdef</span><span class="normal"> GDK_WINDOWING_X11</span>
<span class="normal"> </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">timestamp </span><span class="symbol">!=</span><span class="normal"> GDK_CURRENT_TIME</span><span class="symbol">)</span>
<span class="normal"> </span><span class="function">gdk_x11_window_set_user_time</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">gdk_window</span><span class="symbol">,</span><span class="normal"> timestamp</span><span class="symbol">);</span>
<td class="listing_code"><pre class="programlisting"><span class="preproc">#ifdef</span><span class="normal"> <a href="../html/gdk3-General.html#GDK-WINDOWING-X11:CAPS">GDK_WINDOWING_X11</a></span>
<span class="normal"> </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">timestamp </span><span class="symbol">!=</span><span class="normal"> <a href="../html/gdk3-Events.html#GDK-CURRENT-TIME:CAPS">GDK_CURRENT_TIME</a></span><span class="symbol">)</span>
<span class="normal"> </span><span class="function"><a href="../html/gdk3-X-Window-System-Interaction.html#gdk-x11-window-set-user-time">gdk_x11_window_set_user_time</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">gdk_window</span><span class="symbol">,</span><span class="normal"> timestamp</span><span class="symbol">);</span>
<span class="preproc">#endif</span>
<span class="preproc">#ifdef</span><span class="normal"> GDK_WINDOWING_WIN32</span>
<span class="preproc">#ifdef</span><span class="normal"> <a href="../html/gdk3-General.html#GDK-WINDOWING-WIN32:CAPS">GDK_WINDOWING_WIN32</a></span>
<span class="normal"> </span><span class="comment">/* ... win32 specific code ... */</span>
<span class="preproc">#endif</span></pre></td>
</tr>
@ -920,7 +920,7 @@
<p>
In GTK+ 3, GDK can be built with multiple backends, and currently
used backend has to be determined at runtime, typically using
type-check macros on a <span class="type">GdkDisplay</span> or <span class="type">GdkWindow</span>. You still need
type-check macros on a <a href="../html/GdkDisplay.html#GdkDisplay-struct"><span class="type">GdkDisplay</span></a> or <a href="../html/gdk3-Windows.html#GdkWindow-struct"><span class="type">GdkWindow</span></a>. You still need
to use the GDK_WINDOWING macros to only compile code referring
to supported backends:
</p>
@ -946,15 +946,15 @@
16
17
18</pre></td>
<td class="listing_code"><pre class="programlisting"><span class="preproc">#ifdef</span><span class="normal"> GDK_WINDOWING_X11</span>
<td class="listing_code"><pre class="programlisting"><span class="preproc">#ifdef</span><span class="normal"> <a href="../html/gdk3-General.html#GDK-WINDOWING-X11:CAPS">GDK_WINDOWING_X11</a></span>
<span class="normal"> </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="function">GDK_IS_X11_DISPLAY</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">display</span><span class="symbol">))</span>
<span class="normal"> </span><span class="cbracket">{</span>
<span class="normal"> </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">timestamp </span><span class="symbol">!=</span><span class="normal"> GDK_CURRENT_TIME</span><span class="symbol">)</span>
<span class="normal"> </span><span class="function">gdk_x11_window_set_user_time</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">gdk_window</span><span class="symbol">,</span><span class="normal"> timestamp</span><span class="symbol">);</span>
<span class="normal"> </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">timestamp </span><span class="symbol">!=</span><span class="normal"> <a href="../html/gdk3-Events.html#GDK-CURRENT-TIME:CAPS">GDK_CURRENT_TIME</a></span><span class="symbol">)</span>
<span class="normal"> </span><span class="function"><a href="../html/gdk3-X-Window-System-Interaction.html#gdk-x11-window-set-user-time">gdk_x11_window_set_user_time</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">gdk_window</span><span class="symbol">,</span><span class="normal"> timestamp</span><span class="symbol">);</span>
<span class="normal"> </span><span class="cbracket">}</span>
<span class="normal"> </span><span class="keyword">else</span>
<span class="preproc">#endif</span>
<span class="preproc">#ifdef</span><span class="normal"> GDK_WINDOWING_WIN32</span>
<span class="preproc">#ifdef</span><span class="normal"> <a href="../html/gdk3-General.html#GDK-WINDOWING-WIN32:CAPS">GDK_WINDOWING_WIN32</a></span>
<span class="normal"> </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="function">GDK_IS_WIN32_DISPLAY</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">display</span><span class="symbol">))</span>
<span class="normal"> </span><span class="cbracket">{</span>
<span class="normal"> </span><span class="comment">/* ... win32 specific code ... */</span>

4
docs/reference/gtk/html/ch32s05.html
View File

@ -60,8 +60,8 @@
behavior than before.
</p>
<p>
The Gtk+ scrolling implementation has changed. <code class="function">gdk_window_scroll()</code>
and <code class="function">gdk_window_move_region()</code> no longer copy the region on the
The Gtk+ scrolling implementation has changed. <a href="../html/gdk3-Windows.html#gdk-window-scroll"><code class="function">gdk_window_scroll()</code></a>
and <a href="../html/gdk3-Windows.html#gdk-window-move-region"><code class="function">gdk_window_move_region()</code></a> no longer copy the region on the
window, but rather invalidate the entire scrolled region. This is
slightly slower, but allowed us to implement a offscreen surface
scrolling method which better fits modern hardware. Most scrolling

2
docs/reference/gtk/html/chap-drawing-model.html
View File

@ -92,7 +92,7 @@
<p>
The windowing system generates events for native windows. The GDK
interface to the windowing system translates such native events into
<span class="structname">GdkEvent</span>
<a href="../html/gdk3-Event-Structures.html#GdkEvent"><span class="structname">GdkEvent</span></a>
structures and sends them on to the GTK layer. In turn, the GTK layer
finds the widget that corresponds to a particular
<code class="classname">GdkWindow</code> and emits the corresponding event

74
docs/reference/gtk/html/chap-input-handling.html
View File

@ -44,7 +44,7 @@
The most basic input devices that every computer user has interacted with are
keyboards and mice; beyond these, GTK+ supports touchpads, touchscreens and
more exotic input devices such as graphics tablets. Inside GTK+, every such
input device is represented by a <span class="type">GdkDevice</span> object.
input device is represented by a <a href="../html/GdkDevice.html#GdkDevice-struct"><span class="type">GdkDevice</span></a> object.
</p>
<p>
To simplify dealing with the variability between these input devices, GTK+
@ -67,16 +67,16 @@
the window with the keyboard focus.
</p>
<p>
GDK translates these raw windowing system events into <span class="type">GdkEvents</span>.
GDK translates these raw windowing system events into <a href="../html/gdk3-Event-Structures.html#GdkEvent"><span class="type">GdkEvents</span></a>.
Typical input events are:
</p>
<table border="0" summary="Simple list" class="simplelist">
<tr><td><span class="type">GdkEventButton</span></td></tr>
<tr><td><span class="type">GdkEventMotion</span></td></tr>
<tr><td><span class="type">GdkEventCrossing</span></td></tr>
<tr><td><span class="type">GdkEventKey</span></td></tr>
<tr><td><span class="type">GdkEventFocus</span></td></tr>
<tr><td><span class="type">GdkEventTouch</span></td></tr>
<tr><td><a href="../html/gdk3-Event-Structures.html#GdkEventButton"><span class="type">GdkEventButton</span></a></td></tr>
<tr><td><a href="../html/gdk3-Event-Structures.html#GdkEventMotion"><span class="type">GdkEventMotion</span></a></td></tr>
<tr><td><a href="../html/gdk3-Event-Structures.html#GdkEventCrossing"><span class="type">GdkEventCrossing</span></a></td></tr>
<tr><td><a href="../html/gdk3-Event-Structures.html#GdkEventKey"><span class="type">GdkEventKey</span></a></td></tr>
<tr><td><a href="../html/gdk3-Event-Structures.html#GdkEventFocus"><span class="type">GdkEventFocus</span></a></td></tr>
<tr><td><a href="../html/gdk3-Event-Structures.html#GdkEventTouch"><span class="type">GdkEventTouch</span></a></td></tr>
</table>
<p>
</p>
@ -85,14 +85,14 @@
grabs (system-wide or in-app) are taking input away:
</p>
<table border="0" summary="Simple list" class="simplelist">
<tr><td><span class="type">GdkEventGrabBroken</span></td></tr>
<tr><td><a href="../html/gdk3-Event-Structures.html#GdkEventGrabBroken"><span class="type">GdkEventGrabBroken</span></a></td></tr>
<tr><td><a class="link" href="GtkWidget.html#GtkWidget-grab-notify" title="The “grab-notify” signal"><span class="type">“grab-notify”</span></a></td></tr>
</table>
<p>
</p>
<p>
When GTK+ is initialized, it sets up an event handler function with
<code class="function">gdk_event_handler_set()</code>, which receives all of these input events
<a href="../html/gdk3-Events.html#gdk-event-handler-set"><code class="function">gdk_event_handler_set()</code></a>, which receives all of these input events
(as well as others, for instance window management related events).
</p>
</div>
@ -100,7 +100,7 @@
<div class="refsect2">
<a name="event-propagation"></a><h3>Event propagation</h3>
<p>
For widgets which have a <span class="type">GdkWindow</span> set, events are received from the
For widgets which have a <a href="../html/gdk3-Windows.html#GdkWindow-struct"><span class="type">GdkWindow</span></a> set, events are received from the
windowing system and passed to <a class="link" href="gtk3-General.html#gtk-main-do-event" title="gtk_main_do_event ()"><code class="function">gtk_main_do_event()</code></a>. See its documentation
for details of what it does: compression of enter/leave events,
identification of the widget receiving the event, pushing the event onto a
@ -108,26 +108,26 @@
widget.
</p>
<p>
When a GDK backend produces an input event, it is tied to a <span class="type">GdkDevice</span> and
a <span class="type">GdkWindow</span>, which in turn represents a windowing system surface in the
When a GDK backend produces an input event, it is tied to a <a href="../html/GdkDevice.html#GdkDevice-struct"><span class="type">GdkDevice</span></a> and
a <a href="../html/gdk3-Windows.html#GdkWindow-struct"><span class="type">GdkWindow</span></a>, which in turn represents a windowing system surface in the
backend. If a widget has grabbed the current input device, or all input
devices, the event is propagated to that <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>. Otherwise, it is
propagated to the the <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> which called <a class="link" href="GtkWidget.html#gtk-widget-register-window" title="gtk_widget_register_window ()"><code class="function">gtk_widget_register_window()</code></a>
on the <span class="type">GdkWindow</span> receiving the event.
on the <a href="../html/gdk3-Windows.html#GdkWindow-struct"><span class="type">GdkWindow</span></a> receiving the event.
</p>
<p>
Grabs are implemented for each input device, and globally. A grab for a
specific input device (<a class="link" href="gtk3-General.html#gtk-device-grab-add" title="gtk_device_grab_add ()"><code class="function">gtk_device_grab_add()</code></a>), is sent events in
preference to a global grab (<a class="link" href="gtk3-General.html#gtk-grab-add" title="gtk_grab_add ()"><code class="function">gtk_grab_add()</code></a>). Input grabs only have effect
within the <a class="link" href="GtkWindowGroup.html" title="GtkWindowGroup"><span class="type">GtkWindowGroup</span></a> containing the <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> which registered the
event’s <span class="type">GdkWindow</span>. If this <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> is a child of the grab widget, the
event’s <a href="../html/gdk3-Windows.html#GdkWindow-struct"><span class="type">GdkWindow</span></a>. If this <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> is a child of the grab widget, the
event is propagated to the child — this is the basis for propagating
events within modal dialogs.
</p>
<p>
An event is propagated to a widget using <a class="link" href="gtk3-General.html#gtk-propagate-event" title="gtk_propagate_event ()"><code class="function">gtk_propagate_event()</code></a>.
Propagation differs between event types: key events (<code class="literal">GDK_KEY_PRESS</code>,
<code class="literal">GDK_KEY_RELEASE</code>) are delivered to the top-level <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a>; other events
Propagation differs between event types: key events (<a href="../html/gdk3-Events.html#GDK-KEY-PRESS:CAPS"><code class="literal">GDK_KEY_PRESS</code></a>,
<a href="../html/gdk3-Events.html#GDK-KEY-RELEASE:CAPS"><code class="literal">GDK_KEY_RELEASE</code></a>) are delivered to the top-level <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a>; other events
are propagated down and up the widget hierarchy in three phases (see
<a class="link" href="GtkEventController.html#GtkPropagationPhase" title="enum GtkPropagationPhase"><span class="type">GtkPropagationPhase</span></a>).
</p>
@ -173,7 +173,7 @@
<p>
Any time during the propagation phase, a widget may indicate that a
received event was consumed and propagation should therefore be stopped.
In traditional event handlers, this is hinted by returning <code class="literal">GDK_EVENT_STOP</code>.
In traditional event handlers, this is hinted by returning <a href="../html/gdk3-Events.html#GDK-EVENT-STOP:CAPS"><code class="literal">GDK_EVENT_STOP</code></a>.
If gestures are used, this may happen when the widget tells the gesture
to claim the event touch sequence (or the pointer events) for its own. See the
"gesture states" section below to know more of the latter.
@ -186,21 +186,21 @@
Each widget instance has a basic event mask and another per input device,
which determine the types of input event it receives. Each event mask set
on a widget is added to the corresponding (basic or per-device) event mask
for the widget’s <span class="type">GdkWindow</span>, and all child <span class="type">GdkWindows</span>.
for the widget’s <a href="../html/gdk3-Windows.html#GdkWindow-struct"><span class="type">GdkWindow</span></a>, and all child <a href="../html/gdk3-Windows.html#GdkWindow-struct"><span class="type">GdkWindows</span></a>.
</p>
<p>
If a widget is windowless (<a class="link" href="GtkWidget.html#gtk-widget-get-has-window" title="gtk_widget_get_has_window ()"><code class="function">gtk_widget_get_has_window()</code></a> returns <code class="literal">FALSE</code>) and
an application wants to receive custom events on it, it must be placed
inside a <a class="link" href="GtkEventBox.html" title="GtkEventBox"><span class="type">GtkEventBox</span></a> to receive the events, and an appropriate event mask
must be set on the box. When implementing a widget, use a <code class="literal">GDK_INPUT_ONLY</code>
<span class="type">GdkWindow</span> to receive the events instead.
must be set on the box. When implementing a widget, use a <a href="../html/gdk3-Windows.html#GDK-INPUT-ONLY:CAPS"><code class="literal">GDK_INPUT_ONLY</code></a>
<a href="../html/gdk3-Windows.html#GdkWindow-struct"><span class="type">GdkWindow</span></a> to receive the events instead.
</p>
<p>
Filtering events against event masks happens inside <span class="type">GdkWindow</span>, which
Filtering events against event masks happens inside <a href="../html/gdk3-Windows.html#GdkWindow-struct"><span class="type">GdkWindow</span></a>, which
exposes event masks to the windowing system to reduce the number of events
GDK receives from it. On receiving an event, it is filtered against the
<span class="type">GdkWindow</span>’s mask for the input device, if set. Otherwise, it is filtered
against the <span class="type">GdkWindow</span>’s basic event mask.
<a href="../html/gdk3-Windows.html#GdkWindow-struct"><span class="type">GdkWindow</span></a>’s mask for the input device, if set. Otherwise, it is filtered
against the <a href="../html/gdk3-Windows.html#GdkWindow-struct"><span class="type">GdkWindow</span></a>’s basic event mask.
</p>
<p>
This means that widgets must add to the event mask for each event type
@ -208,7 +208,7 @@
<a class="link" href="GtkWidget.html#gtk-widget-add-events" title="gtk_widget_add_events ()"><code class="function">gtk_widget_add_events()</code></a> to preserve the existing mask. Widgets which are
aware of floating devices should use <a class="link" href="GtkWidget.html#gtk-widget-set-device-events" title="gtk_widget_set_device_events ()"><code class="function">gtk_widget_set_device_events()</code></a> or
<a class="link" href="GtkWidget.html#gtk-widget-add-device-events" title="gtk_widget_add_device_events ()"><code class="function">gtk_widget_add_device_events()</code></a>, and must explicitly enable the device
using <a class="link" href="GtkWidget.html#gtk-widget-set-device-enabled" title="gtk_widget_set_device_enabled ()"><code class="function">gtk_widget_set_device_enabled()</code></a>. See the <span class="type">GdkDeviceManager</span>
using <a class="link" href="GtkWidget.html#gtk-widget-set-device-enabled" title="gtk_widget_set_device_enabled ()"><code class="function">gtk_widget_set_device_enabled()</code></a>. See the <a href="../html/GdkDeviceManager.html#GdkDeviceManager-struct"><span class="type">GdkDeviceManager</span></a>
documentation for more information.
</p>
<p>
@ -221,23 +221,23 @@
<div class="refsect2">
<a name="id-1.2.7.3.6"></a><h3>Touch events</h3>
<p>
Touch events are emitted as events of type <code class="literal">GDK_TOUCH_BEGIN</code>, <code class="literal">GDK_TOUCH_UPDATE</code> or
<code class="literal">GDK_TOUCH_END</code>, those events contain an “event sequence” that univocally identifies
Touch events are emitted as events of type <a href="../html/gdk3-Events.html#GDK-TOUCH-BEGIN:CAPS"><code class="literal">GDK_TOUCH_BEGIN</code></a>, <a href="../html/gdk3-Events.html#GDK-TOUCH-UPDATE:CAPS"><code class="literal">GDK_TOUCH_UPDATE</code></a> or
<a href="../html/gdk3-Events.html#GDK-TOUCH-END:CAPS"><code class="literal">GDK_TOUCH_END</code></a>, those events contain an “event sequence” that univocally identifies
the physical touch until it is lifted from the device.
</p>
<p>
On some windowing platforms, multitouch devices perform pointer emulation, this works
by granting a “pointer emulating” hint to one of the currently interacting touch
sequences, which will be reported on every <span class="type">GdkEventTouch</span> event from that sequence. By
default, if a widget didn't request touch events by setting <code class="literal">GDK_TOUCH_MASK</code> on its
sequences, which will be reported on every <a href="../html/gdk3-Event-Structures.html#GdkEventTouch"><span class="type">GdkEventTouch</span></a> event from that sequence. By
default, if a widget didn't request touch events by setting <a href="../html/gdk3-Events.html#GDK-TOUCH-MASK:CAPS"><code class="literal">GDK_TOUCH_MASK</code></a> on its
event mask and didn't override <a class="link" href="GtkWidget.html#GtkWidget-touch-event" title="The “touch-event” signal"><span class="type">“touch-event”</span></a>, GTK+ will transform these
“pointer emulating” events into semantically similar <span class="type">GdkEventButton</span> and <span class="type">GdkEventMotion</span>
events. Depending on <code class="literal">GDK_TOUCH_MASK</code> being in the event mask or not, non-pointer-emulating
“pointer emulating” events into semantically similar <a href="../html/gdk3-Event-Structures.html#GdkEventButton"><span class="type">GdkEventButton</span></a> and <a href="../html/gdk3-Event-Structures.html#GdkEventMotion"><span class="type">GdkEventMotion</span></a>
events. Depending on <a href="../html/gdk3-Events.html#GDK-TOUCH-MASK:CAPS"><code class="literal">GDK_TOUCH_MASK</code></a> being in the event mask or not, non-pointer-emulating
sequences could still trigger gestures or just get filtered out, regardless of the widget
not handling those directly.
</p>
<p>
If the widget sets <code class="literal">GDK_TOUCH_MASK</code> on its event mask and doesn't chain up on
If the widget sets <a href="../html/gdk3-Events.html#GDK-TOUCH-MASK:CAPS"><code class="literal">GDK_TOUCH_MASK</code></a> on its event mask and doesn't chain up on
<a class="link" href="GtkWidget.html#GtkWidget-touch-event" title="The “touch-event” signal"><span class="type">“touch-event”</span></a>, only touch events will be received, and no pointer emulation
will be performed.
</p>
@ -251,8 +251,8 @@
happen on user interaction, when a <span class="type">GdkEventButtonPress</span> happens, all events from
then on, until after the corresponding <span class="type">GdkEventButtonRelease</span>, will be reported
to the widget that got the first event. Likewise, on touch events, every
<span class="type">GdkEventSequence</span> will deliver only events to the widget that received its
<code class="literal">GDK_TOUCH_BEGIN</code> event.
<a href="../html/gdk3-Events.html#GdkEventSequence"><span class="type">GdkEventSequence</span></a> will deliver only events to the widget that received its
<a href="../html/gdk3-Events.html#GDK-TOUCH-BEGIN:CAPS"><code class="literal">GDK_TOUCH_BEGIN</code></a> event.
</p>
<p>
Explicit grabs happen programatically (both activation and deactivation),
@ -268,7 +268,7 @@
This makes it necessary for widgets to handle the cancellation of any ongoing
interaction. Depending on whether a GTK or GDK grab is causing this, the
widget will respectively receive a <a class="link" href="GtkWidget.html#GtkWidget-grab-notify" title="The “grab-notify” signal"><span class="type">“grab-notify”</span></a> signal, or a
<span class="type">GdkEventGrabBroken</span> event.
<a href="../html/gdk3-Event-Structures.html#GdkEventGrabBroken"><span class="type">GdkEventGrabBroken</span></a> event.
</p>
<p>
On gestures, these signals are handled automatically, causing the gesture
@ -284,7 +284,7 @@
<a name="event-controllers-and-gestures"></a><h3>Event controllers and gestures</h3>
<p>
Event controllers are standalone objects that can perform specific actions
upon received <span class="type">GdkEvents</span>. These are tied to a <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>, and can be told of
upon received <a href="../html/gdk3-Event-Structures.html#GdkEvent"><span class="type">GdkEvents</span></a>. These are tied to a <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>, and can be told of
the event propagation phase at which they will manage the events.
</p>
<p>
@ -338,7 +338,7 @@
Alternatively, or at a later point in time, the widget may choose to deny the touch
sequences, thus letting those go through again in event propagation. When this happens
in the capture phase, and if there are no other claiming gestures in the widget,
a <code class="literal">GDK_TOUCH_BEGIN</code>/<code class="literal">GDK_BUTTON_PRESS</code> event will be emulated and
a <a href="../html/gdk3-Events.html#GDK-TOUCH-BEGIN:CAPS"><code class="literal">GDK_TOUCH_BEGIN</code></a>/<a href="../html/gdk3-Events.html#GDK-BUTTON-PRESS:CAPS"><code class="literal">GDK_BUTTON_PRESS</code></a> event will be emulated and
propagated downwards, in order to preserve consistency.
</p>
<p>

4
docs/reference/gtk/html/gtk-compiling.html
View File

@ -67,12 +67,12 @@ Deprecated GTK+ functions are annotated to make the compiler
emit warnings when they are used (e.g. with gcc, you need to use
the -Wdeprecated-declarations option). If these warnings are
problematic, they can be turned off by defining the preprocessor
symbol <code class="literal">GDK_DISABLE_DEPRECATION_WARNINGS</code> by using the commandline
symbol <a href="../html/gdk3-General.html#GDK-DISABLE-DEPRECATION-WARNINGS:CAPS"><code class="literal">GDK_DISABLE_DEPRECATION_WARNINGS</code></a> by using the commandline
option <code class="literal">-DGDK_DISABLE_DEPRECATION_WARNINGS</code>
</p>
<p>
GTK+ deprecation annotations are versioned; by defining the
macros <code class="literal">GDK_VERSION_MIN_REQUIRED</code> and <code class="literal">GDK_VERSION_MAX_ALLOWED</code>,
macros <a href="../html/gdk3-General.html#GDK-VERSION-MIN-REQUIRED:CAPS"><code class="literal">GDK_VERSION_MIN_REQUIRED</code></a> and <a href="../html/gdk3-General.html#GDK-VERSION-MAX-ALLOWED:CAPS"><code class="literal">GDK_VERSION_MAX_ALLOWED</code></a>,
you can specify the range of GTK+ versions whose API you want
to use. APIs that were deprecated before or introduced after
this range will trigger compiler warnings.

Some files were not shown because too many files have changed in this diff Show More