Class Drawing

Rysunek

Reprezentuje rysunek na arkuszu w arkuszu kalkulacyjnym.

Metody

Metoda	Zwracany typ	Krótki opis
getContainerInfo()	ContainerInfo	Pobiera informacje o tym, gdzie rysunek jest umieszczony na arkuszu.
getHeight()	Integer	Zwraca rzeczywistą wysokość tego rysunku w pikselach.
getOnAction()	String	Zwraca nazwę makra dołączonego do tego rysunku.
getSheet()	Sheet	Zwraca arkusz, na którym pojawia się ten rysunek.
getWidth()	Integer	Zwraca rzeczywistą szerokość tego rysunku w pikselach.
getZIndex()	Number	Zwraca z-index tego rysunku.
remove()	void	Usuwa ten rysunek z arkusza kalkulacyjnego.
setHeight(height)	Drawing	Określa rzeczywistą wysokość tego rysunku w pikselach.
setOnAction(macroName)	Drawing	Przypisuje funkcję makro do tego rysunku.
setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)	Drawing	Określa pozycję, w której rysunek ma się pojawić na arkuszu.
setWidth(width)	Drawing	Ustawia rzeczywistą szerokość tego rysunku w pikselach.
setZIndex(zIndex)	Drawing	Ustawia z-index rysunku.

Szczegółowa dokumentacja

getContainerInfo()

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

Powrót

ContainerInfo – obiekt zawierający pozycję kontenera rysunku.

Autoryzacja

Skrypty, które korzystają 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ść 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, które korzystają 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.
const drawings = SpreadsheetApp.getActiveSheet().getDrawings();
for (let i = 0; i < drawings.length; i++) {
  Logger.log(drawings[i].getOnAction());
}

Powrót

String – nazwa makra powiązana z tym rysunkiem.

Autoryzacja

Skrypty, które korzystają 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()

Zwraca arkusz, na którym pojawia 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, na którym ma się pojawić rysunek.

Autoryzacja

Skrypty, które korzystają 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 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, które korzystają 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 z-index 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 elementów tego rysunku.

Autoryzacja

Skrypty, które korzystają 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. Dalsze operacje na rysunku spowodują 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, które korzystają 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)

Określa rzeczywistą wysokość tego rysunku w pikselach.

Parametry

Nazwa	Typ	Opis
height	Integer	Pożądana wysokość w pikselach.

Powrót

Drawing – ten rysunek, do łańcucha.

Autoryzacja

Skrypty, które korzystają 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ę makro do tego rysunku.

Parametry

Nazwa	Typ	Opis
macroName	String	Nazwa funkcji w makro.

Powrót

Drawing – ten rysunek, do łańcucha.

---

setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)

Określa pozycję, w której rysunek ma się pojawić na arkuszu. Indeksy pozycji wiersza i kolumny kotwicy są indeksowane od 1.

Parametry

Nazwa	Typ	Opis
anchorRowPos	Integer	Górna krawędź rysunku jest przypięta do tego wiersza.
anchorColPos	Integer	Górna krawędź rysunku jest zablokowana w tej kolumnie.
offsetX	Integer	Poziome przesunięcie od narożnika komórki w pikselach.
offsetY	Integer	Pionowe przesunięcie względem narożnika komórki w pikselach.

Powrót

Drawing – ten rysunek, do łańcucha.

Autoryzacja

Skrypty, które korzystają 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 rzeczywistą szerokość tego rysunku w pikselach.

Parametry

Nazwa	Typ	Opis
width	Integer	Pożądana szerokość w pikselach.

Powrót

Drawing – ten rysunek, do łańcucha.

Autoryzacja

Skrypty, które korzystają 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 z-index rysunku.

Parametry

Nazwa	Typ	Opis
zIndex	Number	Kolejność nakładania elementów tego rysunku.

Powrót

Drawing – ten rysunek, do łańcucha.