.. _ppt_graph:

*****************
PowerPoint: graph
*****************

**graph** è un grafico di PowerPoint.

graph.new
=========

Crea una nuova tabella delle dimensioni (numero punti, numero serie) specificate. 
L'istruzione restituisce anche un riferimento al grafico (*lo seleziona*). 

.. code-block:: ruby
   :linenos:
   
    graph.new(punti, serie, tipo)
    
    graph.new(7, 2, :barclu)        # crea un grafico a barre con due serie di sete punti
  
=========  =====================
Tipo       Descrizione                   
=========  =====================
colclu     xlColumnClustered
colsta     xlColumnStacked
colsta100  xlColumnStacked100
barclu     xlBarClustered
barsta     xlBarStacked
barsta100  xlBarStacked100
pie        xlPie
line       xlLine    
=========  =====================

graph.select
============

Seleziona un grafico.

.. code-block:: ruby
   :linenos:
   
    graph.select              # seleziona il primo grafico della diapositiva
    graph.select(3)           # seleziona il terzo grafico
    graph.select("Testo")     # seleziona il grafico che contiene il testo specificato 
                              # nel corner del foglio dati (riga 1, colonna 1)
    graph.select("Testo",3,5) # seleziona il grafico che contiene il testo specificato 
                              # nel corner del foglio dati che è situato a riga 3. colonna 5


graph.delete
============

Cancella il grafico.

.. code-block:: ruby
   :linenos:
   
    graph.select(3).delete    # cacella 

graph do .. end
===============

Per modificare i dati di un grafico bisogna selezionarlo (o crearlo) e passare un blocco di istruzioni.

.. code-block:: ruby
   :linenos:

    graph.select do 
      ...
      ...
    end

inser_row(nrow)
---------------

Inserisce una nuova riga alla posizione indicata.

insert_col(ncol)
----------------

Inserisce una nuova colonna alla posizione indicata.
    
title
-----

Definisce il titolo del grafico.

xlabel
------

Definisce il titolo dell'asse **x**.

ylabel
------

Definisce il titolo dell'asse **y**.

snames
------

Definisce i nomi delle serie.

has_table
---------

``true`` inserisce la tabella dei dati.
    
has_legend
----------

``true`` inserisce la legenda.

labels
------

Imposta le etichette dei dati.

series
------

Imposta i valori della serie indicata.

.. code-block:: ruby
   :linenos:

    series 2, 10, 20, 30, 40, 50  # imposta i valori della serie 2

cell(r,c) <<
------------

Modifica il valore di un punto (cella di dati).

.. code-block:: ruby
   :linenos:

    cell(2,3) << 75.2