تمت ترجمة هذه الصفحة بواسطة 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)`

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

المَعلمات

الاسم	Type	الوصف
`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 ميغابايت.

المَعلمات

الاسم	Type	الوصف
`blob`	`BlobSource`	الصورة الجديدة على شكل Blob

استرجاع الكرة

OverGridImage - هذه الصورة للتسلسل.

التفويض

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

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

`replace(url)`

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

المَعلمات

الاسم	Type	الوصف
`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)`

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

المَعلمات

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

استرجاع الكرة

OverGridImage - هذه الصورة للتسلسل.

التفويض

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

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

`setAltTextTitle(title)`

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

المَعلمات

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

استرجاع الكرة

OverGridImage - هذه الصورة للتسلسل.

التفويض

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

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

`setAnchorCell(cell)`

لضبط الخلية حيث يتم تثبيت الصورة.

المَعلمات

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

استرجاع الكرة

OverGridImage - هذه الصورة للتسلسل.

التفويض

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

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

`setAnchorCellXOffset(offset)`

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

المَعلمات

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

استرجاع الكرة

OverGridImage - هذه الصورة للتسلسل.

التفويض

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

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

`setAnchorCellYOffset(offset)`

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

المَعلمات

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

استرجاع الكرة

OverGridImage - هذه الصورة للتسلسل.

التفويض

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

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

`setHeight(height)`

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

المَعلمات

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

استرجاع الكرة

OverGridImage - صورة التسلسل.

التفويض

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

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

`setWidth(width)`

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

المَعلمات

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

استرجاع الكرة

OverGridImage - صورة التسلسل.

التفويض

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

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