Class Drawing

Disegno

Rappresenta un disegno su un foglio di un foglio di lavoro.

Metodi

MetodoTipo restituitoBreve descrizione
getContainerInfo()ContainerInfoRecupera informazioni sulla posizione del disegno nel foglio.
getHeight()IntegerRestituisce l'altezza effettiva di questo disegno in pixel.
getOnAction()String|nullRestituisce il nome della macro allegata a questo disegno.
getSheet()SheetRestituisce il foglio su cui viene visualizzato questo disegno.
getWidth()IntegerRestituisce la larghezza effettiva di questo disegno in pixel.
getZIndex()NumberRestituisce l'indice z di questo disegno.
remove()voidElimina il disegno dal foglio di lavoro.
setHeight(height)DrawingImposta l'altezza effettiva di questo disegno in pixel.
setOnAction(macroName)DrawingAssegna una funzione macro a questo disegno.
setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)DrawingImposta la posizione in cui viene visualizzato il disegno nel foglio.
setWidth(width)DrawingImposta la larghezza effettiva di questo disegno in pixel.
setZIndex(zIndex)DrawingImposta l'indice z di questo disegno.

Documentazione dettagliata

getContainerInfo()

Recupera informazioni sulla posizione del disegno nel foglio.

Indietro

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 di questo disegno in pixel. 

// Logs the height of all drawings in a sheet
const drawings = SpreadsheetApp.getActiveSheet().getDrawings();
for (let i = 0; i < drawings.length; i++) {
  Logger.log(drawings[i].getHeight());
}

Indietro

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.
const drawings = SpreadsheetApp.getActiveSheet().getDrawings();
for (let i = 0; i < drawings.length; i++) {
  Logger.log(drawings[i].getOnAction());
}

Indietro

String|null: il nome della macro allegata 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 su cui viene visualizzato questo disegno. 

// Logs the parent sheet of all drawings on the active sheet.
const drawings = SpreadsheetApp.getActiveSheet().getDrawings();
for (let i = 0; i < drawings.length; i++) {
  Logger.log(drawings[i].getSheet());
}

Indietro

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 di questo disegno in pixel. 

// Logs the width of all drawings in a sheet
const drawings = SpreadsheetApp.getActiveSheet().getDrawings();
for (let i = 0; i < drawings.length; i++) {
  Logger.log(drawings[i].getWidth());
}

Indietro

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 l'indice z di questo disegno. 

// Logs the z-index of all drawings on the active sheet.
const drawings = SpreadsheetApp.getActiveSheet().getDrawings();
for (let i = 0; i < drawings.length; i++) {
  Logger.log(drawings[i].getZIndex());
}

Indietro

Number: l'indice Z 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 il disegno dal foglio di lavoro. Qualsiasi ulteriore operazione sul disegno genera un errore di script. 

// Deletes all drawings from the active sheet.
const drawings = SpreadsheetApp.getActiveSheet().getDrawings();
for (let 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 di questo disegno in pixel.

Parametri

NomeTipoDescrizione
heightIntegerL'altezza desiderata in pixel.

Indietro

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

NomeTipoDescrizione
macroNameStringNome della funzione macro.

Indietro

Drawing: questo disegno, per il concatenamento.

setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)

Imposta la posizione in cui viene visualizzato il disegno nel foglio. Gli indici della posizione della riga e della colonna di ancoraggio sono basati su 1.

Parametri

NomeTipoDescrizione
anchorRowPosIntegerIl lato superiore del disegno è ancorato a questa riga.
anchorColPosIntegerIl lato superiore del disegno è ancorato a questa sella.
offsetXIntegerLo scostamento orizzontale dall'angolo della cella in pixel.
offsetYIntegerLo scostamento verticale dall'angolo della cella in pixel.

Indietro

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

NomeTipoDescrizione
widthIntegerLa larghezza desiderata in pixel.

Indietro

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 l'indice z di questo disegno.

Parametri

NomeTipoDescrizione
zIndexNumberZ-index di questo disegno.

Indietro

Drawing: questo disegno, per il concatenamento.