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