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 del disegno in pixel.
getOnAction()StringRestituisce il nome della macro allegata a questo disegno.
getSheet()SheetRestituisce il foglio in cui compare il disegno.
getWidth()IntegerRestituisce la larghezza effettiva del disegno in pixel.
getZIndex()NumberRestituisce lo z-index del disegno.
remove()voidElimina questo disegno dal foglio di lavoro.
setHeight(height)DrawingConsente di impostare l'altezza effettiva del 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)DrawingConsente di impostare la larghezza effettiva di questo disegno in pixel.
setZIndex(zIndex)DrawingImposta 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

NomeTipoDescrizione
heightIntegerL'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

NomeTipoDescrizione
macroNameStringNome 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

NomeTipoDescrizione
anchorRowPosIntegerIl lato superiore del disegno è ancorato a questa riga.
anchorColPosIntegerIl lato superiore del disegno è ancorato a questa colonna.
offsetXIntegerL'offset orizzontale dall'angolo della cella, in pixel.
offsetYIntegerL'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

NomeTipoDescrizione
widthIntegerLa 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

NomeTipoDescrizione
zIndexNumberZ-Index di questo disegno.

Invio

Drawing: questo disegno, per il concatenamento.