Class Drawing

Rysunek

Reprezentuje rysunek na arkuszu w arkuszu kalkulacyjnym.

Metody

MetodaZwracany typKrótki opis
getContainerInfo()ContainerInfoPobiera informacje o pozycji rysunków w arkuszu.
getHeight()IntegerZwraca rzeczywistą wysokość rysunków w pikselach.
getOnAction()StringZwraca nazwę makra dołączonego do tego rysunku.
getSheet()SheetWyświetla arkusz, na którym pojawia się ten rysunek.
getWidth()IntegerZwraca faktyczną szerokość tego rysunku w pikselach.
getZIndex()NumberZwraca kolejność nakładania elementów tego rysunku.
remove()voidUsuwa ten rysunek z arkusza kalkulacyjnego.
setHeight(height)DrawingUstawia faktyczną wysokość tego rysunku w pikselach.
setOnAction(macroName)DrawingPrzypisuje funkcję makra do tego rysunku.
setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)DrawingPozwala określić pozycję, w której rysunek pojawi się w arkuszu.
setWidth(width)DrawingUstawia faktyczną szerokość tego rysunku w pikselach.
setZIndex(zIndex)DrawingUstawia kolejność nakładania elementów tego rysunku.

Szczegółowa dokumentacja

getContainerInfo()

Pobiera informacje o pozycji rysunków w arkuszu.

Powroty

ContainerInfo – obiekt zawierający pozycję kontenera rysunków.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

getHeight()

Zwraca rzeczywistą wysokość rysunków w pikselach.

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

Powroty

Integer – wysokość rysunków w pikselach.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym 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.
var drawings = SpreadsheetApp.getActiveSheet().getDrawings();
for (var i = 0; i < drawings.length; i++) {
  Logger.log(drawings[i].getOnAction());
}

Powroty

String – nazwa makra dołączona do tego rysunku.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

getSheet()

Wyświetla arkusz, na którym pojawia się ten rysunek.

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

Powroty

Sheet – arkusz, na którym pojawia się rysunek.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

getWidth()

Zwraca faktyczną szerokość tego rysunku w pikselach.

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

Powroty

Integer – szerokość rysunków w pikselach.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

getZIndex()

Zwraca kolejność nakładania elementów tego rysunku.

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

Powroty

Number – indeks Z-Indeks dla tego rysunku.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

remove()

Usuwa ten rysunek z arkusza kalkulacyjnego. Każda kolejna operacja na rysowaniu spowoduje wystąpienie błędu skryptu.

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

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

setHeight(height)

Ustawia faktyczną wysokość tego rysunku w pikselach.

Parametry

NazwaTypOpis
heightIntegerWymagana wysokość w pikselach.

Powroty

Drawing – rysunek do tworzenia łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

setOnAction(macroName)

Przypisuje funkcję makra do tego rysunku.

Parametry

NazwaTypOpis
macroNameStringNazwa funkcji makra.

Powroty

Drawing – rysunek do tworzenia łańcuchów.


setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)

Pozwala określić pozycję, w której rysunek pojawi się w arkuszu. Indeksy wiersza zakotwiczenia i kolumny są indeksowane 1.

Parametry

NazwaTypOpis
anchorRowPosIntegerGórna strona rysunku jest zakotwiczona w tym wierszu.
anchorColPosIntegerGórna strona rysunków jest zakotwiczona w tej kolumnie
offsetXIntegerOdsunięcie w poziomie od rogu komórki w pikselach.
offsetYIntegerOdsunięcie w pionie od rogu komórki w pikselach.

Powroty

Drawing – rysunek do tworzenia łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

setWidth(width)

Ustawia faktyczną szerokość tego rysunku w pikselach.

Parametry

NazwaTypOpis
widthIntegerŻądana szerokość w pikselach.

Powroty

Drawing – rysunek do tworzenia łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

setZIndex(zIndex)

Ustawia kolejność nakładania elementów tego rysunku.

Parametry

NazwaTypOpis
zIndexNumberKolejność nakładania elementów tego rysunku.

Powroty

Drawing – rysunek do tworzenia łańcuchów.