Class Link

الرابط

رابط نص تشعبي.

الطُرق

الطريقةنوع القيمة التي يتم إرجاعهاوصف قصير
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());
}

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

LinkType

التفويض

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

  • 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());
}

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

Slide

التفويض

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

  • 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());
}

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

SlidePosition

التفويض

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

  • 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