رابط نص تشعبي.
الطُرق
الطريقة | نوع القيمة التي يتم إرجاعها | وصف قصير |
---|---|---|
getLinkType() | LinkType | تعرض LinkType . |
getLinkedSlide() | Slide | عرض Slide المرتبطة لأنواع الروابط التي لا ليست عناوين URL، إن وُجدت. |
getSlideId() | String | عرض رقم تعريف السمة Slide أو null المرتبطة إذا لم تكن قيمة LinkType للسمة LinkType.SLIDE_ID |
getSlideIndex() | Integer | يتم عرض الفهرس المستند إلى الصفر لـ Slide أو null المرتبطة إذا لم تكن LinkType LinkType.SLIDE_INDEX . |
getSlidePosition() | SlidePosition | عرض SlidePosition للسمة Slide المرتبطة أو null المرتبطة إذا لم تكن قيمة LinkType LinkType.SLIDE_POSITION . |
getUrl() | String | عرض عنوان URL لصفحة الويب الخارجية أو إلى null إذا لم يكن LinkType للسمة LinkType.URL . |
الوثائق التفصيلية
getLinkType()
تعرض LinkType
.
var link = shape.getLink(); if (link != null) { Logger.log('Shape has a link of type: ' + link.getLinkType()); }
استرجاع الكرة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getLinkedSlide()
عرض Slide
المرتبطة لأنواع الروابط التي لا ليست عناوين URL، إن وُجدت. تعرض القيمة null
إذا لم تكن الشريحة متوفّرة في العرض التقديمي أو إذا كانت قيمة LinkType
هي LinkType.URL
.
var link = shape.getLink(); if (link != null && link.getLinkType() != SlidesApp.LinkType.URL) { Logger.log('Shape has link to slide: ' + link.getLinkedSlide()); }
استرجاع الكرة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getSlideId()
عرض رقم تعريف السمة Slide
أو null
المرتبطة إذا لم تكن قيمة LinkType
للسمة LinkType.SLIDE_ID
يُرجى العلم أنّ الشريحة التي تحتوي على المعرّف المعروض قد لا تكون متوفّرة.
var link = shape.getLink(); if (link != null && link.getLinkType() == SlidesApp.LinkType.SLIDE_ID) { Logger.log('Shape has link to slide with ID: ' + link.getSlideId()); }
استرجاع الكرة
String
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getSlideIndex()
يتم عرض الفهرس المستند إلى الصفر لـ Slide
أو null
المرتبطة إذا لم تكن LinkType
LinkType.SLIDE_INDEX
.
لاحظ أن الشريحة في الفهرس المعروض قد لا تكون موجودة.
var link = shape.getLink(); if (link != null && link.getLinkType() == SlidesApp.LinkType.SLIDE_INDEX) { Logger.log('Shape has link to slide with index: ' + link.getSlideIndex()); }
استرجاع الكرة
Integer
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getSlidePosition()
عرض SlidePosition
للسمة Slide
المرتبطة أو null
المرتبطة إذا لم تكن قيمة LinkType
LinkType.SLIDE_POSITION
.
تجدر الإشارة إلى أنّ الشريحة التي تتضمّن الموضع النسبي المعروض قد لا يكون متوفّرًا.
var link = shape.getLink(); if (link != null && link.getLinkType() == SlidesApp.LinkType.SLIDE_POSITION) { Logger.log('Shape has link to slide with relative position: ' + link.getSlidePosition()); }
استرجاع الكرة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getUrl()
عرض عنوان URL لصفحة الويب الخارجية أو إلى null
إذا لم يكن LinkType
للسمة LinkType.URL
.
var link = shape.getLink(); if (link != null && link.getLinkType() == SlidesApp.LinkType.URL) { Logger.log('Shape has link to URL: ' + link.getUrl()); }
استرجاع الكرة
String
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations