يمثل رسمًا فوق ورقة في جدول بيانات.
الطُرق
الطريقة | نوع القيمة التي يتم إرجاعها | وصف قصير |
---|---|---|
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)
لضبط الارتفاع الفعلي لهذا الرسم بالبكسل.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
height | Integer | الارتفاع المطلوب بالبكسل. |
استرجاع الكرة
Drawing
— هذا الرسم للتسلسل.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setOnAction(macroName)
تعيّن دالة ماكرو لهذا الرسم.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
macroName | String | اسم دالة الماكرو. |
استرجاع الكرة
Drawing
— هذا الرسم للتسلسل.
setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)
لتعيين موضع ظهور الرسم على الورقة. فهارس موضع الارتساء والعمود مفهرسة باستخدام رقم 1.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
anchorRowPos | Integer | تم تثبيت الجانب العلوي من الرسم في هذا الصف. |
anchorColPos | Integer | تم تثبيت الجانب العلوي من الرسم في هذا العمود. |
offsetX | Integer | الإزاحة الأفقية من زاوية الخلية بالبكسل. |
offsetY | Integer | الإزاحة العمودية من زاوية الخلية بالبكسل. |
استرجاع الكرة
Drawing
— هذا الرسم للتسلسل.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setWidth(width)
لضبط العرض الفعلي لهذا الرسم بالبكسل.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
width | Integer | العرض المطلوب بالبكسل. |
استرجاع الكرة
Drawing
— هذا الرسم للتسلسل.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setZIndex(zIndex)
لتعيين فهرس z لهذا الرسم.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
zIndex | Number | فهرس Z لهذا الرسم. |
استرجاع الكرة
Drawing
— هذا الرسم للتسلسل.