<page xmlns="http://projectmallard.org/1.0/" xmlns:its="http://www.w3.org/2005/11/its" xmlns:ui="http://projectmallard.org/experimental/ui/" type="guide" id="c" xml:lang="pt-BR">

  <info>

    <title type="link">C</title>

    <link type="guide" xref="index#tutorials"/>

    <revision version="3.4" date="2012-04-28" status="stub"/>

    <credit type="editor">

      <name>Tiffany Antopolski</name>

      <email its:translate="no">tiffany.antopolski@gmail.com</email>

    </credit>

    <credit type="editor">

      <name>Bastian Ilso</name>

      <email its:translate="no">bastianilso@gnome.org</email>

    </credit>

    <include xmlns="http://www.w3.org/2001/XInclude" href="legal.xml"/>

    <desc>Tutorials and code samples in C.</desc>

    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">

      <mal:name>Rafael Ferreira</mal:name>

      <mal:email>rafael.f.f1@gmail.com</mal:email>

      <mal:years>2013</mal:years>

    </mal:credit>

  </info>

  <title>Platform Demos in C</title>

  <section id="prerequisites">

    <title>Prerequisites</title>

    
To compile these platform demos you will need a C compiler, for example

    <link href="https://gcc.gnu.org/">gcc</link>.

    You will also need GTK+ 3 including headers and pkg-config files.

    Linux distributions usually abstract GTK+ 3 headers and pkg-config files

    into separate packages called gtk3-devel, gtk3-dev

    or similar.

  </section>

  <section id="for-beginners" ui:expanded="false">

    <title>Guidelines for new developers</title>

    
Beyond the prerequisites mentioned above, several tools has been

    developed to assist you further in developing your GNOME application.

    GNOME also recommends a specific coding style and conventions which this

    section will elaborate further upon.

    <section id="recommended-tools">

      <title>Recommended tools</title>

      <list>

        <item>

          
<link href="https://wiki.gnome.org/Apps/Devhelp">DevHelp</link>:

            An API documentation browser for GNOME.

        </item>

        <item>

          
A GNOME IDE (Integrated Development Environment).

          An IDE can assist you in writing and debugging C code,

          for example <link href="https://wiki.gnome.org/Apps/Builder">Builder</link>

          or <link href="https://wiki.gnome.org/Apps/Anjuta">Anjuta</link>.

        </item>

        <item>

          
<link href="http://glade.gnome.org/">Glade</link>:

          A user interface designer for GTK+ Applications.

        </item>

        <item>

          
An IRC Client, for example

          <link href="https://wiki.gnome.org/Apps/Polari">Polari</link> or

          <link href="https://wiki.gnome.org/Apps/Empathy">Empathy</link>.

          If you run into problems while following the beginner tutorials,

          join #gnome on irc.gnome.org.

        </item>

      </list>

    </section>

    <section id="coding-style">

      <title>Coding Style</title>

      
Most applications in the GNOME project is written in the

      <link href="http://en.wikipedia.org/wiki/Indent_style#GNU_style">GNU style</link>

      of indentation. The tutorials and code examples presented are following

      this convention and you are recommended to do so too.

    </section>

    <section id="executing-code">

      <title>Executing Code</title>

      
To run the code samples:

      <steps>

        <item>

          
Copy and paste the code into filename.c

        </item>

        <item>

          
In the terminal type:

          <screen>gcc filename.c `pkg-config --cflags --libs gtk+-3.0` -o filename</screen>

          <screen>./filename</screen>

        </item>

      </steps>

      <note>

        
For more information about compiling GTK+ programs see

        <link href="http://developer.gnome.org/gtk3/3.4/gtk-compiling.html">Compiling GTK+ Applications on UNIX</link>.

      </note>

    </section>

  </section>

  <section id="examples">

    <title>Tutorials</title>

  </section>

<section id="samples">

<title>Widget Code Examples</title>

 <section id="windows" style="2column"><title>Windows</title>

  </section>

  <section id="display-widgets" style="2column"><title>Display widgets</title>

  </section>

  <section id="buttons" style="2column"><title>Buttons and toggles</title>

  </section>

  <section id="entry" style="2column"><title>Numeric and text data entry</title>

  </section>

  <section id="multiline" style="2column"><title>Multiline text editor</title>

  </section>

  <section id="menu-combo-toolbar" style="2column"><title>Menu, combo box and toolbar widgets</title>

  </section>

  <section id="treeview" style="2column"><title>TreeView widget</title>

  </section>

  <section id="selectors"><title>Selectors</title>

    <section id="file-selectors" style="2column"><title>File selectors</title>

    </section>

    <section id="font-selectors" style="2column"><title>Font selectors</title>

    </section>

    <section id="color-selectors" style="2column"><title>Color Selectors</title>

    </section>

  </section>

  <section id="layout" style="2column"><title>Layout containers</title>

  </section>

  <section id="ornaments" style="2column"><title>Ornaments</title>

  </section>

  <section id="scrolling" style="2column"><title>Scrolling</title>

  </section>

  <section id="misc" style="2column"><title>Miscellaneous</title>

  </section>

</section>

</page>