Class Drawing

Disegno

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

Metodi

MetodoTipo restituitoBreve descrizione
getContainerInfo()ContainerInfoRecupera le informazioni sulla posizione del disegno nel foglio.
getHeight()IntegerRestituisce l'altezza effettiva di questo disegno in pixel.
getOnAction()StringRestituisce il nome della macro associata a questo disegno.
getSheet()SheetRestituisce il foglio in cui viene visualizzato il disegno.
getWidth()IntegerRestituisce la larghezza effettiva di questo disegno in pixel.
getZIndex()NumberRestituisce lo z-index di questo disegno.
remove()voidElimina il disegno dal foglio di lavoro.
setHeight(height)DrawingImposta l'altezza effettiva del disegno in pixel.
setOnAction(macroName)DrawingAssegna una funzione di 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 del disegno in pixel.
setZIndex(zIndex)DrawingImposta l'indice z di questo disegno.

Documentazione dettagliata

getContainerInfo()

Recupera le 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 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());
}

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 associata 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());
}

Invio

String: il nome della macro associata 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 viene visualizzato il 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());
}

Invio

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 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());
}

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 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());
}

Invio

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 operazione successiva sul disegno comporta un errore dello 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 del disegno in pixel.

Parametri

NomeTipoDescrizione
heightIntegerL'altezza desiderata in pixel.

Invio

Drawing: questo disegno, per l'accoppiamento.

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 di macro a questo disegno.

Parametri

NomeTipoDescrizione
macroNameStringNome della funzione della macro.

Invio

Drawing: questo disegno, per l'accoppiamento.

setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)

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

Parametri

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

Invio

Drawing: questo disegno, per l'accoppiamento.

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

Parametri

NomeTipoDescrizione
widthIntegerLa larghezza desiderata in pixel.

Invio

Drawing: questo disegno, per l'accoppiamento.

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.

Invio

Drawing: questo disegno, per l'accoppiamento.