Class Drawing

الرسم

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

الطُرق

الطريقة	نوع القيمة التي تم إرجاعها	وصف قصير
getContainerInfo()	ContainerInfo	تعرض هذه الدالة معلومات حول موضع الرسم في ورقة الجدول.
getHeight()	Integer	تعرض هذه السمة الارتفاع الفعلي لهذا الرسم بالبكسل.
getOnAction()	String|null	تعرض هذه السمة اسم وحدة الماكرو المرفقة بهذا الرسم.
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-index لهذا الرسم.

مستندات تفصيلية

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
const drawings = SpreadsheetApp.getActiveSheet().getDrawings();
for (let 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.
const drawings = SpreadsheetApp.getActiveSheet().getDrawings();
for (let i = 0; i < drawings.length; i++) {
  Logger.log(drawings[i].getOnAction());
}

الإرجاع

String|null: اسم وحدة الماكرو المرفقة بهذا التصميم

التفويض

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

• 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.
const drawings = SpreadsheetApp.getActiveSheet().getDrawings();
for (let 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
const drawings = SpreadsheetApp.getActiveSheet().getDrawings();
for (let 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.
const drawings = SpreadsheetApp.getActiveSheet().getDrawings();
for (let 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.
const drawings = SpreadsheetApp.getActiveSheet().getDrawings();
for (let i = 0; i < drawings.length; i++) {
  drawings[i].remove();
}

التفويض

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

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

---

setHeight(height)

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

المَعلمات

الاسم	النوع	الوصف
height	Integer	تمثّل هذه السمة الارتفاع المطلوب بالبكسل.

الإرجاع

‫Drawing: هذا الرسم، لإنشاء سلسلة

التفويض

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

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

---

setOnAction(macroName)

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

المَعلمات

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

الإرجاع

‫Drawing: هذا الرسم، لإنشاء سلسلة

---

setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)

تضبط هذه السمة الموضع الذي يظهر فيه الرسم على ورقة الجدول. فهارس موضع الصف والعمود الأساسيَّين مفهرسة بدءًا من 1.

المَعلمات

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

الإرجاع

‫Drawing: هذا الرسم، لإنشاء سلسلة

التفويض

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

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

---

setWidth(width)

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

المَعلمات

الاسم	النوع	الوصف
width	Integer	تمثّل هذه السمة العرض المطلوب بالبكسل.

الإرجاع

‫Drawing: هذا الرسم، لإنشاء سلسلة

التفويض

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

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

---

setZIndex(zIndex)

يضبط هذا الإجراء قيمة z-index لهذا الرسم.

المَعلمات

الاسم	النوع	الوصف
zIndex	Number	فهرس Z لهذا الرسم

الإرجاع

‫Drawing: هذا الرسم، لإنشاء سلسلة