Class Link

קישור

קישור היפרטקסט.

Methods

שיטהסוג הערך שמוחזרתיאור קצר
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