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
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: اسم وحدة الماكرو المرفقة بهذا الرسم.

التفويض

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

• 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" لهذا الرسم.

المعلمات

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

الإرجاع

Drawing - هذا الرسم، لإنشاء سلسلة.