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 

const shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
const 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. 

const shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
const 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.

يُرجى العِلم أنّ الشريحة التي تحمل رقم التعريف الذي تم إرجاعه قد لا تكون متوفّرة. 

const shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
const 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.

يُرجى العِلم أنّ الشريحة في الفهرس الذي تم إرجاعه قد لا تكون متوفّرة. 

const shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
const 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.

يُرجى العِلم أنّ الشريحة التي تتضمّن الموضع النسبي الذي تم إرجاعه قد لا تكون متوفّرة. 

const shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
const 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. 

const shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
const 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