Class Drawing

Rysunek

Reprezentuje rysunek na arkuszu w arkuszu kalkulacyjnym.

Metody

MetodaZwracany typKrótki opis
getContainerInfo()ContainerInfoPobiera informacje o tym, gdzie rysunek jest umieszczony w arkuszu.
getHeight()IntegerZwraca rzeczywistą wysokość tego rysunku w pikselach.
getOnAction()String|nullZwraca nazwę makra dołączonego do tego rysunku.
getSheet()SheetZwraca arkusz, w którym znajduje się ten rysunek.
getWidth()IntegerZwraca rzeczywistą szerokość tego rysunku w pikselach.
getZIndex()NumberZwraca indeks z tego rysunku.
remove()voidUsuwa rysunek z arkusza kalkulacyjnego.
setHeight(height)DrawingUstawia rzeczywistą wysokość tego rysunku w pikselach.
setOnAction(macroName)DrawingPrzypisuje do tego rysunku funkcję makra.
setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)DrawingOkreśla położenie rysunku na arkuszu.
setWidth(width)DrawingUstawia rzeczywistą szerokość rysunku w pikselach.
setZIndex(zIndex)DrawingUstawia kolejność nakładania tego rysunku.

Szczegółowa dokumentacja

getContainerInfo()

Pobiera informacje o tym, gdzie rysunek jest umieszczony w arkuszu.

Powrót

ContainerInfo – obiekt zawierający pozycję kontenera rysunku.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getHeight()

Zwraca rzeczywistą wysokość tego rysunku w pikselach. 

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

Powrót

Integer – wysokość rysunku w pikselach.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getOnAction()

Zwraca nazwę makra dołączonego do tego rysunku. 

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

Powrót

String|null – nazwa makra dołączonego do tego rysunku.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getSheet()

Zwraca arkusz, w którym znajduje się ten rysunek. 

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

Powrót

Sheet – arkusz, w którym znajduje się rysunek.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getWidth()

Zwraca rzeczywistą szerokość tego rysunku w pikselach. 

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

Powrót

Integer – szerokość rysunku w pikselach.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getZIndex()

Zwraca indeks z tego rysunku. 

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

Powrót

Number – kolejność nakładania tego rysunku.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

remove()

Usuwa rysunek z arkusza kalkulacyjnego. Każda kolejna operacja na rysunku powoduje błąd skryptu. 

// Deletes all drawings from the active sheet.
const drawings = SpreadsheetApp.getActiveSheet().getDrawings();
for (let i = 0; i < drawings.length; i++) {
  drawings[i].remove();
}

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setHeight(height)

Ustawia rzeczywistą wysokość tego rysunku w pikselach.

Parametry

NazwaTypOpis
heightIntegerOczekiwana wysokość w pikselach.

Powrót

Drawing – ten rysunek do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setOnAction(macroName)

Przypisuje do tego rysunku funkcję makra.

Parametry

NazwaTypOpis
macroNameStringNazwa funkcji makra.

Powrót

Drawing – ten rysunek do łączenia.

setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)

Określa położenie rysunku na arkuszu. Indeksy wiersza i kolumny kotwicy są indeksowane od 1.

Parametry

NazwaTypOpis
anchorRowPosIntegerGórna krawędź rysunku jest zakotwiczona w tym wierszu.
anchorColPosIntegerGórna krawędź rysunku jest zakotwiczona w tej kolumnie.
offsetXIntegerPoziome przesunięcie od rogu komórki w pikselach.
offsetYIntegerPionowe przesunięcie od rogu komórki w pikselach.

Powrót

Drawing – ten rysunek do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setWidth(width)

Ustawia rzeczywistą szerokość rysunku w pikselach.

Parametry

NazwaTypOpis
widthIntegerŻądana szerokość w pikselach.

Powrót

Drawing – ten rysunek do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setZIndex(zIndex)

Ustawia kolejność nakładania tego rysunku.

Parametry

NazwaTypOpis
zIndexNumberKolejność nakładania tego rysunku.

Powrót

Drawing – ten rysunek do łączenia.