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.

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

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)

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

المعلمات

الاسمالنوعالوصف
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: هذا الرسم، لإنشاء سلسلة