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)

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

المعلّمات

الاسمالنوعالوصف
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 — هذا الرسم للسلاسل.