تمثّل هذه السمة رسمًا فوق ورقة في جدول بيانات.
الطُرق
| الطريقة | نوع القيمة التي يتم إرجاعها | وصف قصير |
|---|---|---|
get | Container | تعرض هذه الدالة معلومات حول موضع الرسم في ورقة البيانات. |
get | Integer | تعرض هذه السمة الارتفاع الفعلي لهذا الرسم بالبكسل. |
get | String|null | تعرض هذه السمة اسم وحدة الماكرو المرفقة بهذا الرسم. |
get | Sheet | تعرض ورقة البيانات التي يظهر فيها هذا الرسم. |
get | Integer | تعرض هذه السمة العرض الفعلي لهذا الرسم بالبكسل. |
get | Number | تعرض هذه السمة ترتيب العرض على المحور z لهذا الرسم. |
remove() | void | يحذف هذا الرسم من جدول البيانات. |
set | Drawing | تضبط هذه السمة الارتفاع الفعلي لهذا الرسم بالبكسل. |
set | Drawing | تُستخدَم لتعيين دالة ماكرو لهذا الرسم. |
set | Drawing | تضبط هذه السمة الموضع الذي يظهر فيه الرسم على ورقة الجدول. |
set | Drawing | تضبط هذه السمة العرض الفعلي لهذا الرسم بالبكسل. |
set | Drawing | تضبط هذه السمة ترتيب هذا الرسم في محور z. |
مستندات تفصيلية
get Container Info()
تعرض هذه الدالة معلومات حول موضع الرسم في ورقة البيانات.
الإرجاع
Container: عنصر يحتوي على موضع حاوية الرسم.
التفويض
تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام نطاق واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
get Height()
تعرض هذه السمة الارتفاع الفعلي لهذا الرسم بالبكسل.
// 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
get On Action()
تعرض هذه السمة اسم وحدة الماكرو المرفقة بهذا الرسم.
// 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
get Sheet()
تعرض ورقة البيانات التي يظهر فيها هذا الرسم.
// 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
get Width()
تعرض هذه السمة العرض الفعلي لهذا الرسم بالبكسل.
// 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
get ZIndex()
تعرض هذه السمة ترتيب العرض على المحور 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
set Height(height)
تضبط هذه السمة الارتفاع الفعلي لهذا الرسم بالبكسل.
المعلمات
| الاسم | النوع | الوصف |
|---|---|---|
height | Integer | تمثّل هذه السمة الارتفاع المطلوب بالبكسل. |
الإرجاع
Drawing: هذا الرسم، لإنشاء سلسلة
التفويض
تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام نطاق واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
set On Action(macroName)
تُستخدَم لتعيين دالة ماكرو لهذا الرسم.
المعلمات
| الاسم | النوع | الوصف |
|---|---|---|
macro | String | اسم دالة الماكرو. |
الإرجاع
Drawing: هذا الرسم، لإنشاء سلسلة
set Position(anchorRowPos, anchorColPos, offsetX, offsetY)
تضبط هذه السمة الموضع الذي يظهر فيه الرسم على ورقة الجدول. فهارس موضع الصف والعمود الأساسيَّين مفهرسة بدءًا من 1.
المعلمات
| الاسم | النوع | الوصف |
|---|---|---|
anchor | Integer | يتم تثبيت الجانب العلوي من الرسم في هذا الصف. |
anchor | Integer | يتم تثبيت الجانب العلوي من الرسم في هذا العمود. |
offsetX | Integer | الإزاحة الأفقية من زاوية الخلية بالبكسل |
offsetY | Integer | تمثّل هذه السمة الإزاحة العمودية من زاوية الخلية بالبكسل. |
الإرجاع
Drawing: هذا الرسم، لإنشاء سلسلة
التفويض
تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام نطاق واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
set Width(width)
تضبط هذه السمة العرض الفعلي لهذا الرسم بالبكسل.
المعلمات
| الاسم | النوع | الوصف |
|---|---|---|
width | Integer | تمثّل هذه السمة العرض المطلوب بالبكسل. |
الإرجاع
Drawing: هذا الرسم، لإنشاء سلسلة
التفويض
تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام نطاق واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
set ZIndex(zIndex)
تضبط هذه السمة ترتيب هذا الرسم في محور z.
المعلمات
| الاسم | النوع | الوصف |
|---|---|---|
zIndex | Number | فهرس Z لهذا الرسم |
الإرجاع
Drawing: هذا الرسم، لإنشاء سلسلة