Macros/Calc/ba019/it

Riepilogo
Questa pagina fornisce una procedura macro di LibreOffice Basic che crea un nuovo intervallo denominato che fa riferimento a $Foglio1.$B$3:$D$6. È un esempio tratto dal Capitolo 13 ("Calc come un Database") della Guida 7.0 Calc.

Descrizione
In una macro, si accede, si crea e si elimina un intervallo denominato utilizzando il servizio NamedRanges di un documento Calc. A questo servizio sono associati numerosi metodi, i seguenti sono particolarmente utili per la creazione di intervalli denominati:


 * getByName(Nome)
 * Restituisce l'intervallo o l'espressione con il nome specificato.


 * getElementNames
 * Restituisce un array di tutti gli intervalli denominati nel documento corrente.


 * hasByName(Nome)
 * Restituisce un booleano: VERO se un intervallo con questo nome è nel documento corrente e FALSO in caso contrario.


 * addNewByName(Nome, contenuto, posizione, tipo)
 * Aggiunge un nuovo intervallo denominato al documento corrente. Questo metodo ha quattro argomenti:
 * Nome – Una stringa che contiene il nome del nuovo intervallo.
 * Contenuto – Una stringa che contiene l'indirizzo dell'intervallo o l'espressione della formula da nominare.
 * Posizione – L'indirizzo di base per i relativi riferimenti di cella.
 * Tipo – Una combinazione di flag che specificano il tipo di intervallo denominato definito. Questi flag sono elencati nella tabella seguente. Il valore predefinito di questo parametro è zero per qualsiasi intervallo denominato comune.

Ad esempio, il codice seguente utilizza i metodi precedenti per verificare se esiste un intervallo denominato MyNRange. Se non esiste, la macro crea un intervallo con il nome e lo imposta per accedere all'intervallo di celle B3:D6.

Codice
Questo [[Media:Create_named_range_with_macro.ods|foglio di calcolo Calc]] contiene il codice soprastante Basic di LibreOffice