<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
<!ENTITY appversion "3.1.0">
<!ENTITY manrevision "3.0">
<!ENTITY app "Glade">
]>
<!-- 
  Maintained by the GNOME Documentation Project
  http://developer.gnome.org/projects/gdp
  Template version: 2.0 beta
  Template last modified Apr 11, 2002
-->
<article id="index" lang="en">

  <articleinfo> 
    <title>Manuale del disegnatore di interfacce Glade</title> 
      
    <abstract role="description"><para>Glade è un disegnatore di interfacce utente per applicazioni GTK+.</para>
    </abstract>

    <copyright> 
      <year>2006</year> 
      <holder>Vincent Geddes</holder> 
    </copyright>
    <copyright> 
      <year>2004</year>
      <year>2003</year>
      <holder>Sun Microsystems</holder> 
    </copyright> 
    <copyright> 
      <year>2002</year><year>2000</year> 
      <holder>Michael Vance</holder> 
    </copyright> 

    <publisher> 
      <publishername>Progetto di documentazione di GNOME</publishername> 
    </publisher> 

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

    <authorgroup> 
      <author role="maintainer"> 
	<firstname>Vincent</firstname> 
	<surname>Geddes</surname> 
	<affiliation> 
	  <orgname>Progetto di documentazione di GNOME</orgname>
	  <address><email>vincent.geddes@gmail.com</email></address>
	</affiliation>
      </author> 
      <author> 
        <firstname>Sun</firstname> 
        <surname>Squadra di documentazione di GNOME</surname> 
        <affiliation> 
          <orgname>Sun Microsystems</orgname> 
        </affiliation> 
       </author> 
       <author> 
         <firstname>Michael</firstname> 
         <surname>Vance</surname> 
         <affiliation> 
           <orgname>Progetto di documentazione di GNOME</orgname> 
           </affiliation> 
       </author> 
    </authorgroup>


<!-- According to GNU FDL, revision history is mandatory if you are -->
<!-- modifying/reusing someone else's document.  If not, you can omit it. -->
<!-- Remember to remove the &manrevision; entity from the revision entries other
-->
<!-- than the current revision. -->
<!-- The revision numbering system for GNOME manuals is as follows: -->
<!-- * the revision number consists of two components -->
<!-- * the first component of the revision number reflects the release version of the GNOME desktop. -->
<!-- * the second component of the revision number is a decimal unit that is incremented with each revision of the manual. -->
<!-- For example, if the GNOME desktop release is V2.x, the first version of the manual that -->
<!-- is written in that desktop timeframe is V2.0, the second version of the manual is V2.1, etc. -->
<!-- When the desktop release version changes to V3.x, the revision number of the manual changes -->
<!-- to V3.0, and so on. -->  
    <revhistory>
        <revision> 
		<revnumber>Manuale di Glade 3.0</revnumber> 
		<date>5 dicembre 2006</date>
		<revdescription> 
	  		<para role="author">Vincent Geddes</para>
	  		<para role="publisher">Progetto di documentazione di GNOME</para>
		</revdescription> 
        </revision>
        <revision> 
                <revnumber>Manuale di Glade 2.1;</revnumber> 
                <date>17 giugno 2004</date> 
                <revdescription> 
                        <para role="author">Squadra Sun di documentazione di GNOME</para>
                        <para role="publisher">Progetto di documentazione di GNOME</para>
                </revdescription> 
        </revision>
        <revision> 
                <revnumber>Manuale utente di Glade 2.0</revnumber> 
                <date>25 febbraio 2004</date> 
                <revdescription> 
                        <para role="author">Squadra Sun di documentazione di GNOME</para>
                        <para role="publisher">Progetto di documentazione di GNOME</para>
                </revdescription> 
        </revision>             
        <revision> 
                <revnumber>Manuale utente di Glade 1.2</revnumber> 
                <date>10 feb 2004</date> 
                <revdescription> 
                        <para role="author">Squadra Sun di documentazione di GNOME</para>
                        <para role="publisher">Progetto di documentazione di GNOME</para>
                </revdescription> 
        </revision>  
        <revision> 
                <revnumber>Manuale utente di Glade 1.1</revnumber> 
                <date>30 mar 2002</date> 
                <revdescription> 
                        <para role="author">Michael Vance</para>
                        <para role="publisher">Progetto di documentazione di GNOME</para>
                </revdescription> 
        </revision> 
        <revision> 
                <revnumber>Manuale utente di Glade 1.0</revnumber> 
                <date>11 mag 2000</date> 
                <revdescription> 
                        <para role="author">Michael Vance</para>
                        <para role="publisher">Progetto di documentazione di GNOME</para>
                </revdescription> 
        </revision> 
    </revhistory> 

    <releaseinfo>Questo manuale descrive la versione 3.1.0 di Glade.</releaseinfo> 
    <legalnotice> 
      <title>Commenti</title> 
      <para>To report a bug or make a suggestion regarding the Glade application or
      this manual, follow the directions in the <ulink url="ghelp:gnome-feedback" type="help">GNOME Feedback Page</ulink>.
      </para>
<!-- Translators may also add here feedback address for translations -->
    </legalnotice> 
  </articleinfo> 

    <indexterm><primary>glade</primary></indexterm>
    <indexterm><primary>disegnatore di interfacce utente</primary></indexterm>


<!-- ============= Document Body ============================= -->
<!-- ============= Introduction ============================== -->
<!-- Use the Introduction section to give a brief overview of what
     the application is and what it does. -->
  <sect1 id="introduction"> 
    <title>Introduzione</title> 

    <para>The <application>Glade</application> interface designer enables you to create and edit user interface designs for 
    <application>GTK+</application> applications.</para>

    <para>The GTK+ library provides an extensive collection of user interface building blocks
    such as text boxes, dialog labels, numeric entries, check boxes, and menus. These
    building blocks are called <emphasis>widgets</emphasis>. You can use Glade to place widgets in a GUI. Glade allows you
    to modify the layout and properties of these widgets. You can also use Glade to add connections between
    widgets and application source code.</para>

    <para>The user interfaces designed in Glade are stored in an XML format, enabling easy integration 
    with external tools. You can use the <application>libglade</application> library to dynamically create
    GUIs from the XML description.</para>

  </sect1>

  <sect1 id="getting-started"> 
    <title>Per iniziare</title> 

    <sect2 id="glade-start">
    <title>Avviare <application>Glade</application></title>
    <para>You can start <application>Glade</application> in the following ways:
    </para> 
    <variablelist>
    	<varlistentry>
    		<term><guimenu>Applications</guimenu> menu</term>
    		<listitem>
    		<para>Choose 
    		<menuchoice>
    		<guisubmenu>Programming</guisubmenu>
    		<guimenuitem>Glade Interface Designer</guimenuitem>
    		</menuchoice>. </para>
    		</listitem>
    	</varlistentry>
    	<varlistentry>
    		<term>Linea di comando</term>
    		<listitem>
    		<para>To start <application>Glade</application> from a command line, type the following command, 
    		then press <keycap>Return</keycap>: <command>glade-3</command></para>	 
    		</listitem>
    	</varlistentry>
    </variablelist>
    </sect2>

    <sect2 id="glade-when-start">
    <title>Quando si avvia <application>Glade</application></title>
    <para>When you start <application>Glade</application>, the following window is displayed.</para>

        <figure id="main-window-fig"> 
          <title>Finestra di <application>Glade</application></title> 
            <screenshot> 
              <mediaobject>
                <imageobject><imagedata fileref="figures/main-window.png" format="PNG"/></imageobject>
                <textobject><phrase>Mostra la finestra <application>Glade</application>.</phrase></textobject> 
              </mediaobject> 
            </screenshot> 
        </figure>
        
        <para>The <application>Glade</application> window contains the following elements: </para>

        <variablelist>
          <varlistentry> <term>Barra menù</term>
            <listitem>
            <para>The menus on the menubar contain all of the commands you need to work with files in <application>Glade</application>.</para>
            </listitem>
          </varlistentry>
          <varlistentry> <term>Barra strumenti</term>
            <listitem>
            <para>La barra degli strumenti contiene un sottoinsieme dei comandi che si possono accedere dalla barra dei menù.</para>
            </listitem>
          </varlistentry>
          <varlistentry> <term>Area disegno</term>
            <listitem>
            <para>L'area di disegno è dove un'interfaccia utente può essere modifica visualmente.</para>
            </listitem>
          </varlistentry>
          <varlistentry> <term>Tavolozza</term>
            <listitem>
            <para>La tavolozza contiene i widget che possono essere utilizzati per generare una interfaccia utente.</para>
            </listitem>
          </varlistentry>
          <varlistentry> <term>Ispettore</term>
            <listitem>
            <para>L'ispettore visualizza informazioni circa i widget in un progetto.</para>
            </listitem>
          </varlistentry>
          <varlistentry> <term>Editor proprietà</term>
            <listitem>
            <para>L'editor di proprietà è utilizzato per manipolare le proprietà dei widget, così come per aggiungere connessioni al codice sorgente.</para>
            </listitem>
          </varlistentry>
          <varlistentry> <term>Barra di stato</term>
            <listitem>
            <para>The statusbar displays information about current <application>Glade</application> activity and contextual information about the menu items.</para>
            </listitem>
          </varlistentry>
        </variablelist>

    </sect2>
  </sect1>

  <sect1 id="working-with-projects"> 
         <title>Lavorare con i progetti</title> 
  
 
<!-- To Create a New Project  -->
	 <sect2 id="glade-create-new-project"> 
		<title>Creare un nuovo progetto</title>
		<para>To create a new project, choose <menuchoice><guimenu>File</guimenu><guimenuitem>New</guimenuitem></menuchoice>. The application displays a new blank project in the <application>Glade</application> window.</para>
	 </sect2>

	 <sect2 id="glade-open-project"> 
		<title>Aprire un progetto</title>
		<para>To open an existing project, choose <menuchoice><guimenu>File</guimenu><guimenuitem>Open</guimenuitem></menuchoice>. The application displays the project in the <application>Glade</application> window.</para>
	 </sect2>

<!-- To Save a Project -->
	 <sect2 id="glade-save-project"> 
		<title>Salvare un progetto</title>
		<para>I progetti si possono salvare nei modi seguenti:</para>
		<itemizedlist> 
		  <listitem><para>To save changes to an existing project file, choose <menuchoice><guimenu>File</guimenu><guimenuitem>Save</guimenuitem></menuchoice>. </para>
		  </listitem>
		  <listitem><para>To save a new project file or to save an existing project file under a new filename, choose <menuchoice> <guimenu>File</guimenu> <guimenuitem>Save As</guimenuitem> </menuchoice>. Enter a name for the project file in the <guilabel>Save As</guilabel> dialog, then click <guibutton>Save</guibutton>. </para>
		  </listitem>
		</itemizedlist>
	 </sect2>
  </sect1>


  <sect1 id="working-with-widgets"> 
         <title>Lavorare con i widget</title>
         <sect2 id="select-widgets-palette">
                <title>Selezionare widget della finestra della tavolozza</title>
                <para>
                  You can work with the widgets in the 
                  <guilabel>Tavolozza</guilabel> window in the following
ways:
                </para>
                <variablelist> 
                  <varlistentry> 
                         <term>Modalità selezione</term> 
                         <listitem>
                                <para>
                                  To use selection mode,
 click on the 
                                  <guilabel>Selector</guilabel> arrow. The
pointer changes to an
                                  arrow to indicate that selection mode is
active. In this mode, you use the mouse to select widgets in your project.
You can then use the <guilabel>Properties</guilabel> window to edit the
properties of the widgets.</para>
<para>Si può anche utilizzare il menù contestuale del widget per selezionare un widget. Fare clic con il tasto destro del mouse per aprire il menù contestuale del widget.</para><para>You
can add multiple widgets of a specific type from the
<guilabel>Tavolozza</guilabel> to your project by holding down the
<keycap>Control</keycap> key when you select a widget. You need to click on
the <guilabel>Selector</guilabel> arrow or another widget in the
<guilabel>Tavolozza</guilabel> to return to normal mode.</para>
                         </listitem> 
                  </varlistentry> 
                </variablelist> 
                <variablelist> 
                  <varlistentry> 
                         <term>Modalità posizionamento widget</term> 
                         <listitem> 
                                <para>
                                  To use widget placement mode, select a
widget in the 
                                  <guilabel>Tavolozza</guilabel> window. When
you select most widgets, the
                                  pointer changes to a pointer-plus-cross.
You can then place the widget inside containers,
                                  top-level  widgets, and so on. After you
place a widget, the mode returns to
                                  selection mode.</para>
                         </listitem> 
                  </varlistentry> 
                </variablelist> 
                <variablelist> 
                  <varlistentry> 
                         <term>Modalità di posizionamento livello principale</term> 
                         <listitem> 
                                <para>
                                  To use top level placement mode, select a
defined top-level
                                  widget in the
<application>Tavolozza</application> window. When you select a top-level
                                  widget in the 
                                  <guilabel>Tavolozza</guilabel> window, the
widget appears
                                  immediately on your desktop. You can then
edit the widget. After you select a top-level widget,
                                  the mode returns to selection mode.
                                </para>
                         </listitem> 
                  </varlistentry> 
                </variablelist> 
         </sect2>
<sect2 id="organize-widgets">
<title>Organizzare i widget nel proprio progetto</title>
<para>You use widget containers, or boxes, to layout and organize widgets
in your project window. You can choose the following widget containers from
the <guilabel>Tavolozza</guilabel> window:
</para>
<itemizedlist>
<listitem><para>Casella orizzontale</para>
</listitem><listitem><para>Casella verticale</para></listitem>
<listitem><para>Tabella</para></listitem>
<listitem><para>Posizioni fisse</para></listitem>
<listitem><para>Casella pulsanti orizzontale</para></listitem>
<listitem><para>Casella pulsanti verticale</para></listitem>
<listitem><para>Riquadri orizzontali</para></listitem>
<listitem><para>Riquadri verticali</para></listitem>
<listitem><para>Notebook</para></listitem>
<listitem><para>Cornice</para></listitem>
<listitem><para>Finestra di scorrimento</para></listitem>
<listitem><para>Viewport</para></listitem>
</itemizedlist>
<para>
You can  nest boxes  to create complex layout structures. When you create
horizontal and vertical boxes, <application>Glade</application> asks you
how many rows or columns to create initially, though rows and columns can
easily be added or deleted later. 
</para>
<para>
When you have created all the boxes you require, you can add specific
widgets like labels, buttons, and more complicated widgets into the boxes.
Notice that <application>Glade</application> packs widgets into the layout
which eliminates a lot of tedious work. The use of boxes enables windows to
change size to accommodate different size labels in different languages
when the application is localized.</para></sect2>
         <sect2 id="place-widgets-clipboard"> 
                <title>Posizionare un widget negli appunti</title> 
                <para>
                  To remove a widget from a parent and place the widget on
the clipboard,
                  select the widget then choose 
                  <menuchoice> 
                         <guimenu>Edit</guimenu> 
                         <guisubmenu>Cut</guisubmenu> 
                  </menuchoice>. 
                </para>
         </sect2> 
         <sect2 id="copy-widget-clipboard"> 
                <title>Copiare un widget negli appunti</title> 
                <para>
                  To copy a widget to the clipboard, select the widget then
choose 
                  <menuchoice> 
                         <guimenu>Edit</guimenu> 
                         <guisubmenu>Copy</guisubmenu> 
                  </menuchoice>. The original widget remains attached to
the parent. 
                </para>
         </sect2> 
         <sect2 id="paste-widget-clipboard"> 
                <title>Incollare un widget degli appunti nel proprio progetto</title> 
                <para>
                  To paste a widget that exists on the clipboard into your
project,
                  choose 
                  <menuchoice> 
                         <guimenu>Edit</guimenu> 
                         <guisubmenu>Paste</guisubmenu> 
                  </menuchoice>.</para><para>All widgets must have a unique
name within <application>Glade</application>. If you cut a widget, and then
paste the widget into your project, then the widget and all of the children
of the widget keep their original names. If you copy a widget, or paste the
widget multiple times into your project, then
<application>Glade</application> generates new names for the widget
copies.</para>
         </sect2> 
         <sect2 id="delete-widget"> 
                <title>Eliminare un widget</title> 
                <para>To delete a widget from the parent without
                  moving the widget to the clipboard, 
                                select the widget then 
                                choose 
                                <menuchoice> 
                                  <guimenu>Edit</guimenu> 
                                  <guisubmenu>Delete</guisubmenu> 
                                </menuchoice>. 
                         </para>
                 
         </sect2> 
         
         <sect2 id="edit-widget"> 
                <title>Cambiare una proprietà di un widget</title> 
                <para>L'editor di proprietà è utilizzato per modificare le proprietà di un widget selezionato. Per cambiare una proprietà di un widget, selezionare il widget e poi inserire un valore appropriato in uno dei campi di proprietà della finestra delle proprietà.</para>
                
                
         </sect2> 
  </sect1>
  
<sect1 id="about"> 
    <title>Informazioni su Glade</title> 
    <para> Glade is maintained by the Glade developers and GNOME community volunteers.
      To find more information about Glade, please visit the 
      <ulink url="http://glade.gnome.org" type="http">Glade 
      Web site</ulink>.</para>
    <para>
      To report a bug or make a suggestion regarding this application or
      this manual, you can submit them using 
      <ulink url="http://bugzilla.gnome.org/enter_bug.cgi?product=glade3" type="http">bugzilla</ulink>.
    </para>

    <para>
      Another excellent source of information are the Glade 
      <ulink url="http://lists.ximian.com/mailman/listinfo/glade-users" type="http">user</ulink> and 
      <ulink url="http://lists.ximian.com/mailman/listinfo/glade-devel" type="http">developer</ulink> mailing lists.  In addition to 
      subscribing, you might also want to browse the list archives, available
      via these same links.
    </para>

    <para> This program is distributed under the terms of the GNU
      General Public license as published by the Free Software
      Foundation; either version 2 of the License, or (at your option)
      any later version. A copy of this license can be found at this
      <ulink url="ghelp:gpl" type="help">link</ulink>, or in the file
      COPYING included with the source code of this program. </para>
  </sect1> 

</article>
