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: هذا الرسم للسلسلة