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

Class OverGridImage

يمثل صورة فوق الشبكة في جدول بيانات.

الطُرق

الطريقة	نوع الإرجاع	وصف قصير
`assignScript(functionName)`	`OverGridImage`	تعيّن الدالة اسم الدالة المحدّد لهذه الصورة.
`getAltTextDescription()`	`String`	عرض وصف النص البديل لهذه الصورة.
`getAltTextTitle()`	`String`	عرض عنوان النص البديل لهذه الصورة.
`getAnchorCell()`	`Range`	لعرض الخلية التي توجد فيها صورة
`getAnchorCellXOffset()`	`Integer`	لعرض إزاحة البكسل الأفقي من خلية الارتساء.
`getAnchorCellYOffset()`	`Integer`	لعرض إزاحة البكسل الرأسي من خلية الارتساء.
`getHeight()`	`Integer`	عرض الارتفاع الفعلي لهذه الصورة بالبكسل.
`getInherentHeight()`	`Integer`	عرض الارتفاع الكامن لهذه الصورة بالبكسل.
`getInherentWidth()`	`Integer`	عرض الارتفاع الكامن لهذه الصورة بالبكسل.
`getScript()`	`String`	تعرض اسم الدالة المعينة لهذه الصورة.
`getSheet()`	`Sheet`	لعرض الورقة التي تظهر عليها هذه الصورة.
`getUrl()`	`String`	الحصول على عنوان URL لمصدر الصورة يعرض `null` إذا كان عنوان URL غير متاح.
`getWidth()`	`Integer`	عرض العرض الفعلي لهذه الصورة بالبكسل.
`remove()`	`void`	لحذف هذه الصورة من جدول البيانات.
`replace(blob)`	`OverGridImage`	يستبدل هذه الصورة بالصورة المحددة في `BlobSource` المقدَّم.
`replace(url)`	`OverGridImage`	يعمل هذا الإجراء على استبدال هذه الصورة بأخرى من عنوان URL المحدّد.
`resetSize()`	`OverGridImage`	إعادة ضبط هذه الصورة إلى أبعادها الأساسية.
`setAltTextDescription(description)`	`OverGridImage`	لضبط وصف النص البديل لهذه الصورة.
`setAltTextTitle(title)`	`OverGridImage`	لضبط عنوان النص البديل لهذه الصورة.
`setAnchorCell(cell)`	`OverGridImage`	لضبط الخلية التي توجد فيها الصورة
`setAnchorCellXOffset(offset)`	`OverGridImage`	لضبط إزاحة البكسل الأفقي من خلية الارتساء.
`setAnchorCellYOffset(offset)`	`OverGridImage`	لضبط إزاحة البكسل الرأسي من خلية الارتساء.
`setHeight(height)`	`OverGridImage`	لتعيين الارتفاع الفعلي لهذه الصورة بالبكسل.
`setWidth(width)`	`OverGridImage`	لتعيين العرض الفعلي لهذه الصورة بالبكسل.

الوثائق التفصيلية

`assignScript(functionName)`

تعيّن الدالة اسم الدالة المحدّد لهذه الصورة.

المعلمات

الاسم	النوع	الوصف
`functionName`	`String`	اسم الدالة التي يتم تحديدها. يجب أن يكون هذا المحتوى في مستوى أعلى علني. ، وليس واحدة تنتهي بشرطة سفلية مثل `privateFunction_`.

الإرجاع

OverGridImage — هذه الصورة للسلسلة.

التفويض

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

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

`getAltTextDescription()`

عرض وصف النص البديل لهذه الصورة.

الإرجاع

String — وصف النص البديل

التفويض

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

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

`getAltTextTitle()`

عرض عنوان النص البديل لهذه الصورة.

الإرجاع

String — عنوان النص البديل

التفويض

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

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

`getAnchorCell()`

لعرض الخلية التي توجد فيها صورة

الإرجاع

Range — خلية الارتساء

التفويض

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

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

`getAnchorCellXOffset()`

لعرض إزاحة البكسل الأفقي من خلية الارتساء.

الإرجاع

Integer — إزاحة البكسل الأفقية

التفويض

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

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

`getAnchorCellYOffset()`

لعرض إزاحة البكسل الرأسي من خلية الارتساء.

الإرجاع

Integer — إزاحة البكسل العمودية.

التفويض

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

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

`getHeight()`

عرض الارتفاع الفعلي لهذه الصورة بالبكسل.

// Logs the height of all images in a spreadsheet
var images = SpreadsheetApp.getActiveSpreadsheet().getImages();
for (var i = 0; i < images.length; i++) {
  Logger.log(images[i].getHeight());
}

الإرجاع

Integer — ارتفاع الصورة بالبكسل.

التفويض

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

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

`getInherentHeight()`

عرض الارتفاع الكامن لهذه الصورة بالبكسل.

الإرجاع

Integer — الارتفاع الكامن بالبكسل.

التفويض

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

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

`getInherentWidth()`

عرض الارتفاع الكامن لهذه الصورة بالبكسل.

الإرجاع

Integer — العرض الكامن بالبكسل.

التفويض

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

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

`getScript()`

تعرض اسم الدالة المعينة لهذه الصورة.

الإرجاع

String — اسم الدالة.

التفويض

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

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

`getSheet()`

لعرض الورقة التي تظهر عليها هذه الصورة.

// Logs the parent sheet of all images in a spreadsheet
var images = SpreadsheetApp.getActiveSpreadsheet().getImages();
for (var i = 0; i < images.length; i++) {
  Logger.log(images[i].getSheet());
}

الإرجاع

Sheet — الورقة التي تظهر عليها الصورة.

التفويض

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

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

`getUrl()`

الحصول على عنوان URL لمصدر الصورة يعرض null إذا كان عنوان URL غير متاح. إذا كانت الصورة عن طريق عنوان URL باستخدام واجهة برمجة تطبيقات، تؤدي هذه الطريقة إلى عرض عنوان URL الذي تم تقديمه أثناء إدراج الصورة.

الإرجاع

String: عنوان URL للصورة في حال توفّره تعرض القيمة null إذا كانت الصورة غير متوفّرة أو غير متوفّرة عنوان URL مصدر.

التفويض

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

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

`getWidth()`

عرض العرض الفعلي لهذه الصورة بالبكسل.

// Logs the width of all images in a spreadsheet
var images = SpreadsheetApp.getActiveSpreadsheet().getImages();
for (var i = 0; i < images.length; i++) {
  Logger.log(images[i].getWidth());
}

الإرجاع

Integer — عرض الصورة بالبكسل.

التفويض

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

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

`remove()`

لحذف هذه الصورة من جدول البيانات. ينتج عن أي عملية إضافية على الصورة نص برمجي خطأ.

// Deletes all images in a spreadsheet
var images = SpreadsheetApp.getActiveSpreadsheet().getImages();
for (var i = 0; i < images.length; i++) {
  images[i].remove();
}

التفويض

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

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

`replace(blob)`

يستبدل هذه الصورة بالصورة المحددة في BlobSource المقدَّم. الحد الأقصى حجم الكائن الثنائي الكبير المتوافق هو 2 ميغابايت.

المعلمات

الاسم	النوع	الوصف
`blob`	`BlobSource`	الصورة الجديدة على شكل كائن كتلة (Blob)

الإرجاع

OverGridImage — هذه الصورة للسلسلة.

التفويض

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

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

`replace(url)`

يعمل هذا الإجراء على استبدال هذه الصورة بأخرى من عنوان URL المحدّد.

المعلمات

الاسم	النوع	الوصف
`url`	`String`	عنوان URL للصورة الجديدة

الإرجاع

OverGridImage — هذه الصورة للسلسلة.

التفويض

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

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

`resetSize()`

إعادة ضبط هذه الصورة إلى أبعادها الأساسية.

الإرجاع

OverGridImage — هذه الصورة للسلسلة.

التفويض

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

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

`setAltTextDescription(description)`

لضبط وصف النص البديل لهذه الصورة.

المعلمات

الاسم	النوع	الوصف
`description`	`String`	وصف النص البديل الجديد للصورة.

الإرجاع

OverGridImage — هذه الصورة للسلسلة.

التفويض

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

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

`setAltTextTitle(title)`

لضبط عنوان النص البديل لهذه الصورة.

المعلمات

الاسم	النوع	الوصف
`title`	`String`	عنوان النص البديل الجديد للصورة

الإرجاع

OverGridImage — هذه الصورة للسلسلة.

التفويض

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

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

`setAnchorCell(cell)`

لضبط الخلية التي توجد فيها الصورة

المعلمات

الاسم	النوع	الوصف
`cell`	`Range`	خلية الارتساء الجديدة.

الإرجاع

OverGridImage — هذه الصورة للسلسلة.

التفويض

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

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

`setAnchorCellXOffset(offset)`

لضبط إزاحة البكسل الأفقي من خلية الارتساء.

المعلمات

الاسم	النوع	الوصف
`offset`	`Integer`	إزاحة بكسل أفقية جديدة

الإرجاع

OverGridImage — هذه الصورة للسلسلة.

التفويض

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

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

`setAnchorCellYOffset(offset)`

لضبط إزاحة البكسل الرأسي من خلية الارتساء.

المعلمات

الاسم	النوع	الوصف
`offset`	`Integer`	إزاحة البكسل العمودية الجديدة

الإرجاع

OverGridImage — هذه الصورة للسلسلة.

التفويض

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

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

`setHeight(height)`

لتعيين الارتفاع الفعلي لهذه الصورة بالبكسل.

المعلمات

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

الإرجاع

OverGridImage — صورة للسلسلة

التفويض

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

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

`setWidth(width)`

لتعيين العرض الفعلي لهذه الصورة بالبكسل.

المعلمات

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

الإرجاع

OverGridImage — صورة للسلسلة

التفويض

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

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