Class Link

الرابط

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

الطُرق

الطريقةنوع القيمة التي تم إرجاعهاوصف قصير
getLinkType()LinkTypeتعرض LinkType.
getLinkedSlide()Slide|nullتعرض هذه السمة Slide المرتبط بأنواع الروابط غير المستندة إلى عناوين URL، إذا كان متاحًا.
getSlideId()String|nullتعرِض هذه السمة رقم تعريف Slide أو null المرتبطَين إذا لم تكن قيمة LinkType هي LinkType.SLIDE_ID.
getSlideIndex()Integer|nullتعرِض هذه السمة الفهرس المستند إلى الصفر للسمة المرتبطة Slide أو null إذا لم تكن السمة LinkType هي LinkType.SLIDE_INDEX.
getSlidePosition()SlidePosition|nullتعرِض هذه السمة SlidePosition Slide المرتبط أو null إذا لم يكن LinkType LinkType.SLIDE_POSITION.
getUrl()String|nullتعرض هذه الدالة عنوان 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|null

التفويض

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

  • 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|null

التفويض

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

  • 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|null

التفويض

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

  • 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|null

التفويض

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

  • 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|null

التفويض

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

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations