evo/Gtk4-tutorial: GTK 4 tutorial for beginners

docs/index.html
199 строк11 KB
Toshio Sekiya
Update section 1-16. Some bugs are fixed.
21 дек 2022, 16:31
21 дек 2022, 16:31fe3fba6
  <!DOCTYPE html>
  <html lang="en">
  <head>
    <meta charset="utf-8" />
    <meta name="generator" content="pandoc" />
    <meta name="viewport" content="width=device-width, initial-scale=1" />
    <link href="https://cdn.jsdelivr.net/npm/bootstrap@5.0.2/dist/css/bootstrap.min.css" rel="stylesheet" integrity="sha384-EVSTQN3/azprG1Anm3QDgpJLIm9Nao0Yz1ztcQTwFspd3yD65VohhpuuCOmLASjC" crossorigin="anonymous">
    <title>GTK 4 tutorial</title>
    <style>
      code{white-space: pre-wrap;}
      span.smallcaps{font-variant: small-caps;}
      span.underline{text-decoration: underline;}
      div.column{display: inline-block; vertical-align: top; width: 50%;}
      div.hanging-indent{margin-left: 1.5em; text-indent: -1.5em;}
      ul.task-list{list-style: none;}
      pre{overflow: visible;}
      pre > code.sourceCode { white-space: pre; position: relative; }
      pre > code.sourceCode > span { display: inline-block; line-height: 1.25; }
      pre > code.sourceCode > span:empty { height: 1.2em; }
      code.sourceCode > span { color: inherit; text-decoration: inherit; }
      div.sourceCode { margin: 1em 0; }
      pre.sourceCode { margin: 0; }
      @media screen {
      div.sourceCode { overflow: auto; }
      }
      @media print {
      pre > code.sourceCode { white-space: pre-wrap; }
      pre > code.sourceCode > span { text-indent: -5em; padding-left: 5em; }
      }
      pre.numberSource code
        { counter-reset: source-line 0; }
      pre.numberSource code > span
        { position: relative; left: -4em; counter-increment: source-line; }
      pre.numberSource code > span > a:first-child::after
        { content: counter(source-line);
          position: relative; left: -1em; text-align: right; vertical-align: baseline;
          border: none; display: inline-block;
          -webkit-touch-callout: none; -webkit-user-select: none;
          -khtml-user-select: none; -moz-user-select: none;
          -ms-user-select: none; user-select: none;
          padding: 0 4px; width: 4em;
          color: #aaaaaa;
        }
      pre.numberSource { margin-left: 3em; border-left: 1px solid #aaaaaa;  padding-left: 4px; }
      div.sourceCode
        {   }
      @media screen {
      pre > code.sourceCode > span > a:first-child::before { text-decoration: underline; }
      }
      code span.al { color: #ff0000; font-weight: bold; } /* Alert */
      code span.an { color: #60a0b0; font-weight: bold; font-style: italic; } /* Annotation */
      code span.at { color: #7d9029; } /* Attribute */
      code span.bn { color: #40a070; } /* BaseN */
      code span.bu { } /* BuiltIn */
      code span.cf { color: #007020; font-weight: bold; } /* ControlFlow */
      code span.ch { color: #4070a0; } /* Char */
      code span.cn { color: #880000; } /* Constant */
      code span.co { color: #60a0b0; font-style: italic; } /* Comment */
      code span.cv { color: #60a0b0; font-weight: bold; font-style: italic; } /* CommentVar */
      code span.do { color: #ba2121; font-style: italic; } /* Documentation */
      code span.dt { color: #902000; } /* DataType */
      code span.dv { color: #40a070; } /* DecVal */
      code span.er { color: #ff0000; font-weight: bold; } /* Error */
      code span.ex { } /* Extension */
      code span.fl { color: #40a070; } /* Float */
      code span.fu { color: #06287e; } /* Function */
      code span.im { } /* Import */
      code span.in { color: #60a0b0; font-weight: bold; font-style: italic; } /* Information */
      code span.kw { color: #007020; font-weight: bold; } /* Keyword */
      code span.op { color: #666666; } /* Operator */
      code span.ot { color: #007020; } /* Other */
      code span.pp { color: #bc7a00; } /* Preprocessor */
      code span.sc { color: #4070a0; } /* SpecialChar */
      code span.ss { color: #bb6688; } /* SpecialString */
      code span.st { color: #4070a0; } /* String */
      code span.va { color: #19177c; } /* Variable */
      code span.vs { color: #4070a0; } /* VerbatimString */
      code span.wa { color: #60a0b0; font-weight: bold; font-style: italic; } /* Warning */
      div.sourceCode { margin: 10px; padding: 16px 10px 8px 10px; border: 2px solid silver; background-color: ghostwhite; overflow-x:scroll}
      pre:not(.sourceCode) { margin: 10px; padding: 16px 10px 8px 10px; border: 2px solid silver; background-color: ghostwhite; overflow-x:scroll}
      table {margin-left: auto; margin-right: auto; border-collapse: collapse; border: 1px solid;}
      th {padding: 2px 6px; border: 1px solid; background-color: ghostwhite;}
      td {padding: 2px 6px; border: 1px solid;}
      img {display: block; margin-left: auto; margin-right: auto;}
      figcaption {text-align: center;}
    </style>
  </head>
  <body style="padding-top: 70px;">
    <div class="container">
    <nav class="navbar fixed-top navbar-expand-lg navbar-dark bg-primary">
      <div class="container-fluid">
        <span class="navbar-brand">Gtk4 tutorial</span>
        <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbarSupportedContent" aria-controls="navbarSupportedContent" aria-expanded="false" aria-label="Toggle navigation">
          <span class="navbar-toggler-icon"></span>
        </button>
        <div class="collapse navbar-collapse" id="navbarSupportedContent">
          <ul class="navbar-nav me-auto mb-2 mb-lg-0">
            
            
            
          </ul>
        </div>
      </div>
    </nav>
<h1 id="gtk-4-tutorial-for-beginners">GTK 4 Tutorial for beginners</h1>
<h4 id="contents-of-this-repository">Contents of this Repository</h4>
<p>This tutorial illustrates how to write C programs with the GTK 4
library. It focuses on beginners so the contents are limited to the
basics. The table of contents is at the end of this abstract.</p>
<ul>
<li>Section 3 to 21 describes the basics, with the example of a simple
editor <code>tfe</code> (Text File Editor).</li>
<li>Section 22 to 25 describes GtkDrawingArea.</li>
<li>Section 26 to 29 describes the list model and the list view
(GtkListView, GtkGridView and GtkColumnView). It also describes
GtkExpression.</li>
</ul>
<p>The latest version of the tutorial is located at <a
href="https://github.com/ToshioCP/GTK4-tutorial">GTK4-tutorial GitHub
repository</a>. You can read it directly without download.</p>
<p>There’s a GitHub Page of this tutorial at <a
href="https://toshiocp.github.io/GTK4-tutorial/"><code>https://toshiocp.github.io/GTK4-tutorial/</code></a>.
It is easier to read than the repository.</p>
<h4 id="gtk-4-documentation">GTK 4 Documentation</h4>
<p>Please refer to <a href="https://docs.gtk.org/gtk4/index.html">GTK 4
API Reference</a> and <a href="https://developer.gnome.org/">GNOME
Developer Documentation Website</a> for further information.</p>
<p>These websites were opened in August of 2021. The old documents are
located at <a href="https://developer-old.gnome.org/gtk4/stable/">GTK
Reference Manual</a> and <a
href="https://developer-old.gnome.org/">GNOME Developer Center</a>.</p>
<p>If you want to know about GObject and the type system, please refer
to <a href="https://github.com/ToshioCP/Gobject-tutorial">GObject
tutorial</a>. GObject is the base of GTK 4, so it is important for
developers to understand GObject for writing GTK 4 programs.</p>
<h4 id="contribution">Contribution</h4>
<p>This tutorial is still under development and unstable. Even though
the codes of the examples have been tested on GTK 4 (version 4.8.1),
bugs may still exist. If you find any bugs, errors or mistakes in the
tutorial and C examples, please let me know. You can post it to <a
href="https://github.com/ToshioCP/GTK4-tutorial/issues">GitHub
issues</a>. You can also post updated files to <a
href="https://github.com/ToshioCP/GTK4-tutorial/pulls">pull request</a>.
One thing you need to be careful is to correct the source files, which
are under the ‘src’ directory. Don’t modify the files under
<code>gfm</code> or <code>html</code> directories. After modifying some
source files (under <code>src</code> directory), run <code>rake</code>
to create GFM (GitHub Flavoured Markdown) files or run
<code>rake html</code> to create HTML files.</p>
<p>If you have a question, feel free to post it to <code>issue</code>.
All questions are helpful and will make this tutorial get better.</p>
<h4 id="how-to-get-gtk-4-tutorial-with-html-or-pdf-format">How to get
Gtk 4 tutorial with HTML or PDF format</h4>
<p>If you want to get HTML or PDF format tutorial, make them with
<code>rake</code> command, which is a ruby version of make. Type
<code>rake html</code> for HTML. Type <code>rake pdf</code> for PDF.
There is a document (“<a href="Readme_for_developers.html">How to build
GTK 4 Tutorial</a>”) for further information.</p>
<h2 id="table-of-contents">Table of contents</h2>
<ol type="1">
<li><a href="sec1.html">Prerequisite and License</a></li>
<li><a href="sec2.html">Installing GTK 4 into Linux
distributions</a></li>
<li><a href="sec3.html">GtkApplication and GtkApplicationWindow</a></li>
<li><a href="sec4.html">Widgets (1)</a></li>
<li><a href="sec5.html">Widgets (2)</a></li>
<li><a href="sec6.html">Strings and memory management</a></li>
<li><a href="sec7.html">Widgets (3)</a></li>
<li><a href="sec8.html">Defining a final class</a></li>
<li><a href="sec9.html">GtkBuilder and UI file</a></li>
<li><a href="sec10.html">Build system</a></li>
<li><a href="sec11.html">Instance Initialization and
destruction</a></li>
<li><a href="sec12.html">Signals</a></li>
<li><a href="sec13.html">Functions in TfeTextView</a></li>
<li><a href="sec14.html">Functions in GtkNotebook</a></li>
<li><a href="sec15.html">tfeapplication.c</a></li>
<li><a href="sec16.html">How to build tfe (text file editor)</a></li>
<li><a href="sec17.html">Menu and action</a></li>
<li><a href="sec18.html">Stateful action</a></li>
<li><a href="sec19.html">Ui file for menu and action entries</a></li>
<li><a href="sec20.html">GtkMenuButton, accelerators, font, pango and
gsettings</a></li>
<li><a href="sec21.html">Template XML and composite widget</a></li>
<li><a href="sec22.html">GtkDrawingArea and Cairo</a></li>
<li><a href="sec23.html">Periodic Events</a></li>
<li><a href="sec24.html">Combine GtkDrawingArea and TfeTextView</a></li>
<li><a href="sec25.html">Tiny turtle graphics interpreter</a></li>
<li><a href="sec26.html">GtkListView</a></li>
<li><a href="sec27.html">GtkGridView and activate signal</a></li>
<li><a href="sec28.html">GtkExpression</a></li>
<li><a href="sec29.html">GtkColumnView</a></li>
</ol>
<p>This website uses <a
href="https://getbootstrap.jp/">Bootstrap</a>.</p>
    </div>
    <script src="https://cdn.jsdelivr.net/npm/bootstrap@5.0.2/dist/js/bootstrap.bundle.min.js" integrity="sha384-MrcW6ZMFYlzcLA8Nl+NtUVF0sA7MsXsP1UyJoMp4YLEuNSfAP+JcXn/tWtIaxVXM" crossorigin="anonymous"></script>
  </body>
  </html>