تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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)`

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

المعلمات

الاسم	النوع	الوصف
`height`	`Integer`	الارتفاع المطلوب بالبكسل.

الإرجاع

Drawing: هذا الرسم للسلسلة

التفويض

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

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

`setOnAction(macroName)`

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

المعلمات

الاسم	النوع	الوصف
`macroName`	`String`	اسم دالة الماكرو.

الإرجاع

Drawing: هذا الرسم للسلسلة

`setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)`

لضبط الموضع الذي يظهر فيه الرسم على الورقة صف الارتساء وموضع العمود تتم فهرسة الفهارس بالرقم 1.

المعلمات

الاسم	النوع	الوصف
`anchorRowPos`	`Integer`	يكون الجانب العلوي من الرسم ثابتًا في هذا الصف.
`anchorColPos`	`Integer`	يمكن تثبيت الجانب العلوي من الرسم في هذا العمود.
`offsetX`	`Integer`	الإزاحة الأفقية من زاوية الخلية بالبكسل
`offsetY`	`Integer`	الإزاحة الرأسية من زاوية الخلية بالبكسل.

الإرجاع

Drawing: هذا الرسم للسلسلة

التفويض

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

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

`setWidth(width)`

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

المعلمات

الاسم	النوع	الوصف
`width`	`Integer`	العرض المطلوب بالبكسل.

الإرجاع

Drawing: هذا الرسم للسلسلة

التفويض

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

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

`setZIndex(zIndex)`

لتعيين الفهرس z لهذا الرسم.

المعلمات

الاسم	النوع	الوصف
`zIndex`	`Number`	الفهرس Z لهذا الرسم.

الإرجاع

Drawing: هذا الرسم للسلسلة