Rappresenta un disegno su un foglio di un foglio di lavoro.
Metodi
Metodo | Tipo restituito | Breve descrizione |
---|---|---|
getContainerInfo() | ContainerInfo | Recupera informazioni sulla posizione del disegno nel foglio. |
getHeight() | Integer | Restituisce l'altezza effettiva del disegno in pixel. |
getOnAction() | String | Restituisce il nome della macro allegata a questo disegno. |
getSheet() | Sheet | Restituisce il foglio in cui compare il disegno. |
getWidth() | Integer | Restituisce la larghezza effettiva del disegno in pixel. |
getZIndex() | Number | Restituisce lo z-index del disegno. |
remove() | void | Elimina questo disegno dal foglio di lavoro. |
setHeight(height) | Drawing | Consente di impostare 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 nel foglio. |
setWidth(width) | Drawing | Consente di impostare la larghezza effettiva di questo disegno in pixel. |
setZIndex(zIndex) | Drawing | Imposta lo z-index di questo disegno. |
Documentazione dettagliata
getContainerInfo()
Recupera informazioni sulla posizione del disegno nel foglio.
Invio
ContainerInfo
: un oggetto contenente 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()); }
Invio
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 allegata 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()); }
Invio
String
: il nome della macro associato al 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 compare il 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()); }
Invio
Sheet
: il foglio in 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()); }
Invio
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 del 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()); }
Invio
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 ulteriore operazione sul disegno determina 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)
Consente di impostare l'altezza effettiva del disegno in pixel.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
height | Integer | L'altezza desiderata in pixel. |
Invio
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. |
Invio
Drawing
: questo disegno, per il concatenamento.
setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)
Imposta la posizione in cui viene visualizzato il disegno nel foglio. Posizione della riga e della colonna ancorate sono 1-indicizzati.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
anchorRowPos | Integer | Il lato superiore del disegno è ancorato a questa riga. |
anchorColPos | Integer | Il lato superiore del disegno è ancorato a questa colonna. |
offsetX | Integer | L'offset orizzontale dall'angolo della cella, in pixel. |
offsetY | Integer | L'offset verticale dall'angolo della cella in pixel. |
Invio
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)
Consente di impostare la larghezza effettiva di questo disegno in pixel.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
width | Integer | La larghezza desiderata in pixel. |
Invio
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. |
Invio
Drawing
: questo disegno, per il concatenamento.