gtk3/docs/reference/gtk/html/gtk-windows.html
2020-12-11 10:15:31 +00:00

117 lines
4.8 KiB
HTML
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Using GTK+ on Windows: GTK+ 3 Reference Manual</title>
<meta name="generator" content="DocBook XSL Stylesheets Vsnapshot">
<link rel="home" href="index.html" title="GTK+ 3 Reference Manual">
<link rel="up" href="platform-support.html" title="Part VII. GTK+ Platform Support">
<link rel="prev" href="gtk-x11.html" title="Using GTK+ on the X Window System">
<link rel="next" href="gtk-osx.html" title="Using GTK+ on Mac OS X">
<meta name="generator" content="GTK-Doc V1.33.0 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="5"><tr valign="middle">
<td width="100%" align="left" class="shortcuts"></td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
<td><a accesskey="u" href="platform-support.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
<td><a accesskey="p" href="gtk-x11.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
<td><a accesskey="n" href="gtk-osx.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
</tr></table>
<div class="refentry">
<a name="gtk-windows"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2><span class="refentrytitle">Using GTK+ on Windows</span></h2>
<p>Using GTK+ on Windows —
Windows-specific aspects of using GTK+
</p>
</td>
<td class="gallery_image" valign="top" align="right"></td>
</tr></table></div>
<div class="refsect1">
<a name="id-1.8.6.3"></a><h2>Using GTK+ on Windows</h2>
<p>
The Windows port of GTK+ is an implementation of GDK (and therefore GTK+)
on top of the Win32 API. When compiling GTK+ on Windows, this backend is
the default.
</p>
<div class="refsect2">
<a name="win32-cmdline"></a><h3>Windows-specific commandline options</h3>
<p>
The Windows GDK backend can be influenced with some
additional command line arguments.
</p>
<p><b><code class="systemitem">--sync</code>. </b>
Don't batch GDI requests. This might be a marginally useful option for
debugging.
</p>
<p><b><code class="systemitem">--no-wintab</code>,
<code class="systemitem">--ignore-wintab</code>. </b>
Don't use the Wintab API for tablet support.
</p>
<p><b><code class="systemitem">--use-wintab</code>. </b>
Use the Wintab API for tablet support. This is the default.
</p>
<p><b><code class="systemitem">--max-colors <em class="replaceable"><code>number</code></em></code>. </b>
In 256 color mode, restrict the size of the color palette to
the specified number of colors. This option is obsolete.
</p>
</div>
<hr>
<div class="refsect2">
<a name="win32-envar"></a><h3>Windows-specific environment variables</h3>
<p>
The Win32 GDK backend can be influenced with some
additional environment variables.
</p>
<p><b><code class="envar">GDK_IGNORE_WINTAB</code>. </b>
If this variable is set, GTK+ doesn't use
the Wintab API for tablet support.
</p>
<p><b><code class="envar">GDK_USE_WINTAB</code>. </b>
If this variable is set, GTK+ uses the Wintab API for
tablet support. This is the default.
</p>
<p><b><code class="envar">GDK_WIN32_MAX_COLORS</code>. </b>
Specifies the size of the color palette used
in 256 color mode.
</p>
</div>
<hr>
<div class="refsect2">
<a name="win32-cursors"></a><h3>Windows-specific handling of cursors</h3>
<p>
By default the "system" cursor theme is used. This makes GTK prefer cursors
that Windows currently uses, falling back to Adwaita cursors and (as the last
resort) built-in X cursors.
</p>
<p>
When any other cursor theme is used, GTK will prefer cursors from that theme,
falling back to Windows cursors and built-in X cursors.
</p>
<p>
Theme can be changed by setting <code class="literal">gtk-cursor-theme-name</code> GTK+ setting. Users can override GTK+ settings in the <code class="filename">settings.ini</code> file or at runtime in the GTK+ Inspector.
</p>
<p>
Themes are loaded from normal Windows variants of the XDG locations:
<code class="filename">%HOME%/icons/THEME/cursors</code>,
<code class="filename">%APPDATA%/icons/THEME/cursors</code>,
<code class="filename">RUNTIME_PREFIX/share/icons/THEME/cursors</code>.
</p>
<p>
The <code class="literal">gtk-cursor-theme-size</code> setting is ignored, GTK will use the cursor size that Windows tells it to use.
</p>
</div>
<p>
More information about GTK+ on Windows, including detailed build
instructions, binary downloads, etc, can be found
<a class="ulink" href="https://wiki.gnome.org/Projects/GTK+/Win32" target="_top">online</a>.
</p>
</div>
</div>
<div class="footer">
<hr>Generated by GTK-Doc V1.33.0</div>
</body>
</html>