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)

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

المعلمات

الاسمالنوعالوصف
heightIntegerالارتفاع المطلوب بالبكسل

الإرجاع

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

التفويض

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

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

setOnAction(macroName)

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

المعلمات

الاسمالنوعالوصف
macroNameStringاسم دالة الماكرو

الإرجاع

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

setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)

لضبط موضع ظهور الرسم على الورقة يتمّ ترقيم موضع الصف والعمود في إشارة الربط باستخدام الرقم 1.

المعلمات

الاسمالنوعالوصف
anchorRowPosIntegerيتم تثبيت الجانب العلوي من الرسم في هذا الصف.
anchorColPosIntegerيتم تثبيت الجانب العلوي من الرسم في هذا العمود.
offsetXIntegerالقيمة الأفقية للعنصر من زاوية الخلية بالبكسل
offsetYIntegerالقيمة العمودية للعنصر من زاوية الخلية بالبكسل

الإرجاع

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

التفويض

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

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

setWidth(width)

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

المعلمات

الاسمالنوعالوصف
widthIntegerالعرض المطلوب بالبكسل

الإرجاع

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

التفويض

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

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

setZIndex(zIndex)

تُستخدَم لضبط "فهرس z" لهذا الرسم.

المعلمات

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

الإرجاع

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