Rappresenta un disegno su un foglio di un foglio di lavoro.
Metodi
Metodo | Tipo restituito | Breve descrizione |
---|---|---|
getContainerInfo() | ContainerInfo | Recupera le informazioni sulla posizione del disegno nel foglio. |
getHeight() | Integer | Restituisce l'altezza effettiva del disegno in pixel. |
getOnAction() | String | Restituisce il nome della macro associata a questo disegno. |
getSheet() | Sheet | Restituisce il foglio in cui appare questo disegno. |
getWidth() | Integer | Restituisce la larghezza effettiva del disegno in pixel. |
getZIndex() | Number | Restituisce lo z-index di questo disegno. |
remove() | void | Elimina questo disegno dal foglio di lavoro. |
setHeight(height) | Drawing | Imposta l'altezza effettiva del disegno in pixel. |
setOnAction(macroName) | Drawing | Assegna una funzione macro a questo disegno. |
setPosition(anchorRowPos, anchorColPos, offsetX, offsetY) | Drawing | Imposta la posizione in cui viene visualizzato il disegno sul foglio. |
setWidth(width) | Drawing | Imposta la larghezza effettiva di questo disegno in pixel. |
setZIndex(zIndex) | Drawing | Imposta lo z-index di questo disegno. |
Documentazione dettagliata
getContainerInfo()
Recupera le informazioni sulla posizione del disegno nel foglio.
Ritorni
ContainerInfo
: oggetto che contiene la posizione del contenitore del disegno.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getHeight()
Restituisce l'altezza effettiva del disegno in pixel.
// Logs the height of all drawings in a sheet var drawings = SpreadsheetApp.getActiveSheet().getDrawings(); for (var i = 0; i < drawings.length; i++) { Logger.log(drawings[i].getHeight()); }
Ritorni
Integer
: l'altezza del disegno in pixel.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getOnAction()
Restituisce il nome della macro associata a questo disegno.
// Logs the macro name of all drawings on the active sheet. var drawings = SpreadsheetApp.getActiveSheet().getDrawings(); for (var i = 0; i < drawings.length; i++) { Logger.log(drawings[i].getOnAction()); }
Ritorni
String
: il nome della macro associato a questo disegno.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getSheet()
Restituisce il foglio in cui appare questo disegno.
// Logs the parent sheet of all drawings on the active sheet. var drawings = SpreadsheetApp.getActiveSheet().getDrawings(); for (var i = 0; i < drawings.length; i++) { Logger.log(drawings[i].getSheet()); }
Ritorni
Sheet
: il foglio su cui viene visualizzato il disegno.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getWidth()
Restituisce la larghezza effettiva del disegno in pixel.
// Logs the width of all drawings in a sheet var drawings = SpreadsheetApp.getActiveSheet().getDrawings(); for (var i = 0; i < drawings.length; i++) { Logger.log(drawings[i].getWidth()); }
Ritorni
Integer
: la larghezza del disegno in pixel.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getZIndex()
Restituisce lo z-index di questo disegno.
// Logs the z-index of all drawings on the active sheet. var drawings = SpreadsheetApp.getActiveSheet().getDrawings(); for (var i = 0; i < drawings.length; i++) { Logger.log(drawings[i].getZIndex()); }
Ritorni
Number
: Z-Index di questo disegno.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
remove()
Elimina questo disegno dal foglio di lavoro. Qualsiasi altra operazione sul disegno genera un errore di script.
// Deletes all drawings from the active sheet. var drawings = SpreadsheetApp.getActiveSheet().getDrawings(); for (var i = 0; i < drawings.length; i++) { drawings[i].remove(); }
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setHeight(height)
Imposta l'altezza effettiva del disegno in pixel.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
height | Integer | L'altezza desiderata in pixel. |
Ritorni
Drawing
- Questo disegno, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setOnAction(macroName)
Assegna una funzione macro a questo disegno.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
macroName | String | Nome della funzione macro. |
Ritorni
Drawing
- Questo disegno, per il concatenamento.
setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)
Imposta la posizione in cui viene visualizzato il disegno sul foglio. Gli indici della riga di ancoraggio e della posizione della colonna sono indicizzati 1.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
anchorRowPos | Integer | Il lato superiore del disegno è ancorato a questa riga. |
anchorColPos | Integer | Il lato superiore del disegno è ancorato in questa colonna. |
offsetX | Integer | Lo scostamento orizzontale dall'angolo della cella in pixel. |
offsetY | Integer | Lo scostamento verticale dall'angolo della cella in pixel. |
Ritorni
Drawing
- Questo disegno, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setWidth(width)
Imposta la larghezza effettiva di questo disegno in pixel.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
width | Integer | La larghezza desiderata in pixel. |
Ritorni
Drawing
- Questo disegno, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setZIndex(zIndex)
Imposta lo z-index di questo disegno.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
zIndex | Number | Z-Index di questo disegno. |
Ritorni
Drawing
- Questo disegno, per il concatenamento.