gtk3/docs/reference/gtk/html/gtk-builder-tool.html
2021-04-15 09:52:10 +01:00

116 lines
4.7 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>gtk-builder-tool: 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="pt06.html" title="Part VI. GTK+ Tools">
<link rel="prev" href="gtk-encode-symbolic-svg.html" title="gtk-encode-symbolic-svg">
<link rel="next" href="gtk-launch.html" title="gtk-launch">
<meta name="generator" content="GTK-Doc V1.33.1 (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="pt06.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
<td><a accesskey="p" href="gtk-encode-symbolic-svg.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
<td><a accesskey="n" href="gtk-launch.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
</tr></table>
<div class="refentry">
<a name="gtk-builder-tool"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2><span class="refentrytitle">gtk-builder-tool</span></h2>
<p>gtk-builder-tool — GtkBuilder file utility</p>
</td>
<td class="gallery_image" valign="top" align="right"></td>
</tr></table></div>
<div class="refsynopsisdiv">
<h2>Synopsis</h2>
<div class="cmdsynopsis"><p><code class="command">gtk-builder-tool</code> [<em class="replaceable"><code>COMMAND</code></em>] [<em class="replaceable"><code>OPTION</code></em>...] <em class="replaceable"><code>FILE</code></em> </p></div>
</div>
<div class="refsect1">
<a name="id-1.7.9.5"></a><h2>Description</h2>
<p>
<span class="command"><strong>gtk-builder-tool</strong></span> can perform various operations
on GtkBuilder .ui files.
</p>
<p>
You should always test the modified .ui files produced by gtk-builder-tool
before using them in production.
</p>
</div>
<div class="refsect1">
<a name="id-1.7.9.6"></a><h2>Commands</h2>
<p>The following commands are understood:</p>
<div class="variablelist"><table border="0" class="variablelist">
<colgroup>
<col align="left" valign="top">
<col>
</colgroup>
<tbody>
<tr>
<td><p><span class="term"><code class="option">validate</code></span></p></td>
<td><p>Validates the .ui file and report errors to stderr.</p></td>
</tr>
<tr>
<td><p><span class="term"><code class="option">simplify</code></span></p></td>
<td><p>Simplifies the .ui file by removing properties that
are set to their default values and write the resulting XML to stdout,
or back to the input file.</p></td>
</tr>
<tr>
<td><p><span class="term"><code class="option">enumerate</code></span></p></td>
<td><p>Lists all the named objects that are created in the .ui file.</p></td>
</tr>
<tr>
<td><p><span class="term"><code class="option">preview</code></span></p></td>
<td><p>Preview the .ui file. This command accepts options
to specify the ID of an object and a .css file to use.</p></td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect1">
<a name="id-1.7.9.7"></a><h2>Simplify Options</h2>
<p>The <code class="option">simplify</code> command accepts the following options:</p>
<div class="variablelist"><table border="0" class="variablelist">
<colgroup>
<col align="left" valign="top">
<col>
</colgroup>
<tbody><tr>
<td><p><span class="term"><code class="option">--replace</code></span></p></td>
<td><p>Write the content back to the .ui file instead of stdout.</p></td>
</tr></tbody>
</table></div>
</div>
<div class="refsect1">
<a name="id-1.7.9.8"></a><h2>Preview Options</h2>
<p>The <code class="option">preview</code> command accepts the following options:</p>
<div class="variablelist"><table border="0" class="variablelist">
<colgroup>
<col align="left" valign="top">
<col>
</colgroup>
<tbody>
<tr>
<td><p><span class="term"><code class="option">--id= ID </code></span></p></td>
<td><p>The ID of the object to preview. If not specified,
gtk-builder-tool will choose a suitable object on its own.</p></td>
</tr>
<tr>
<td><p><span class="term"><code class="option">--css= FILE </code></span></p></td>
<td><p>Load style information from the given .css file.</p></td>
</tr>
</tbody>
</table></div>
</div>
</div>
<div class="footer">
<hr>Generated by GTK-Doc V1.33.1</div>
</body>
</html>