Class Drawing

الرسم

يمثل رسمًا فوق ورقة في جدول بيانات.

الطُرق

الطريقة	نوع القيمة التي يتم إرجاعها	وصف قصير
getContainerInfo()	ContainerInfo	الحصول على معلومات حول مكان الرسم في ورقة البيانات
getHeight()	Integer	تعرض الارتفاع الفعلي لهذا الرسم بالبكسل.
getOnAction()	String	تعرض اسم الماكرو المرفق بهذا الرسم.
getSheet()	Sheet	لعرض الورقة التي يظهر عليها هذا الرسم.
getWidth()	Integer	تعرض العرض الفعلي لهذا الرسم بالبكسل.
getZIndex()	Number	يتم عرض فهرس z لهذا الرسم.
remove()	void	لحذف هذا الرسم من جدول البيانات.
setHeight(height)	Drawing	لضبط الارتفاع الفعلي لهذا الرسم بالبكسل.
setOnAction(macroName)	Drawing	تعيّن دالة ماكرو لهذا الرسم.
setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)	Drawing	لتعيين موضع ظهور الرسم على الورقة.
setWidth(width)	Drawing	لضبط العرض الفعلي لهذا الرسم بالبكسل.
setZIndex(zIndex)	Drawing	لتعيين فهرس z لهذا الرسم.

الوثائق التفصيلية

getContainerInfo()

الحصول على معلومات حول مكان الرسم في ورقة البيانات

استرجاع الكرة

ContainerInfo - كائن يحتوي على موضع حاوية الرسم

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:

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

---

getHeight()

تعرض الارتفاع الفعلي لهذا الرسم بالبكسل.

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

استرجاع الكرة

Integer - ارتفاع الرسم بالبكسل.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:

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

---

getOnAction()

تعرض اسم الماكرو المرفق بهذا الرسم.

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

استرجاع الكرة

String — اسم الماكرو المرفق بهذا الرسم.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:

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

---

getSheet()

لعرض الورقة التي يظهر عليها هذا الرسم.

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

استرجاع الكرة

Sheet - الورقة التي يظهر عليها الرسم.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:

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

---

getWidth()

تعرض العرض الفعلي لهذا الرسم بالبكسل.

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

استرجاع الكرة

Integer — عرض الرسم بالبكسل.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:

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

---

getZIndex()

يتم عرض فهرس z لهذا الرسم.

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

استرجاع الكرة

Number — فهرس Z لهذا الرسم.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:

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

---

remove()

لحذف هذا الرسم من جدول البيانات. ينتج عن أي عملية أخرى على الرسم خطأ في النص البرمجي.

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

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:

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

---

setHeight(height)

لضبط الارتفاع الفعلي لهذا الرسم بالبكسل.

المَعلمات

الاسم	Type	الوصف
height	Integer	الارتفاع المطلوب بالبكسل.

استرجاع الكرة

Drawing — هذا الرسم للتسلسل.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:

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

---

setOnAction(macroName)

تعيّن دالة ماكرو لهذا الرسم.

المَعلمات

الاسم	Type	الوصف
macroName	String	اسم دالة الماكرو.

استرجاع الكرة

Drawing — هذا الرسم للتسلسل.

---

setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)

لتعيين موضع ظهور الرسم على الورقة. فهارس موضع الارتساء والعمود مفهرسة باستخدام رقم 1.

المَعلمات

الاسم	Type	الوصف
anchorRowPos	Integer	تم تثبيت الجانب العلوي من الرسم في هذا الصف.
anchorColPos	Integer	تم تثبيت الجانب العلوي من الرسم في هذا العمود.
offsetX	Integer	الإزاحة الأفقية من زاوية الخلية بالبكسل.
offsetY	Integer	الإزاحة العمودية من زاوية الخلية بالبكسل.

استرجاع الكرة

Drawing — هذا الرسم للتسلسل.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:

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

---

setWidth(width)

لضبط العرض الفعلي لهذا الرسم بالبكسل.

المَعلمات

الاسم	Type	الوصف
width	Integer	العرض المطلوب بالبكسل.

استرجاع الكرة

Drawing — هذا الرسم للتسلسل.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:

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

---

setZIndex(zIndex)

لتعيين فهرس z لهذا الرسم.

المَعلمات

الاسم	Type	الوصف
zIndex	Number	فهرس Z لهذا الرسم.

استرجاع الكرة

Drawing — هذا الرسم للتسلسل.