텍스트 수정 및 스타일 지정

텍스트 범위를 사용하여 텍스트를 수정하고 스타일을 지정합니다. 이 범위는 TextRange 유형으로 표시됩니다. TextRange는 도형 또는 표 셀 내의 텍스트 세그먼트를 나타냅니다. 도형 또는 표 셀에서 getText를 호출하면 전체 텍스트를 포함하는 텍스트 범위가 반환됩니다.

도형 내에서 텍스트가 맞게 조정되는 방식을 수정하는 메서드를 사용하는 경우 도형에 적용된 자동 맞춤 설정이 비활성화됩니다.

텍스트 범위 사용

텍스트 범위에는 텍스트 범위로 포함되는 텍스트 세그먼트를 구분하는 두 개의 색인(시작 색인 및 끝 색인)이 있습니다. getStartIndex 및 getEndIndex 함수를 사용하여 이러한 색인을 결정합니다.

텍스트 범위의 시작 색인은 포함되고 끝 색인은 제외됩니다. 두 색인 모두 0부터 시작합니다.

텍스트 범위의 콘텐츠를 읽으려면 asString 또는 asRenderedString 함수를 사용합니다.

텍스트 범위 내에서 하위 범위를 검색하려면 getRange 함수를 사용합니다.

다음 스크립트는 첫 번째 슬라이드에 텍스트 상자를 만들고 텍스트 콘텐츠를 'Hello world!'로 설정합니다. 그런 다음 'Hello'에만 걸쳐 있는 하위 범위를 검색합니다.

slides/style/style.gs
try {
  // Get the first slide of active presentation
  const slide = SlidesApp.getActivePresentation().getSlides()[0];
  // Insert shape in the slide with dimensions
  const shape = slide.insertShape(
    SlidesApp.ShapeType.TEXT_BOX,
    100,
    200,
    300,
    60,
  );
  const textRange = shape.getText();
  // Set text in TEXT_BOX
  textRange.setText("Hello world!");
  console.log(
    `Start: ${textRange.getStartIndex()}; End: ${textRange.getEndIndex()}; Content: ${textRange.asString()}`,
  );
  const subRange = textRange.getRange(0, 5);
  console.log(
    `Sub-range Start: ${subRange.getStartIndex()}; Sub-range End: ${subRange.getEndIndex()}; Sub-range Content: ${subRange.asString()}`,
  );
} catch (err) {
  // TODO (developer) - Handle exception
  console.log("Failed with an error %s ", err.message);
}

도형 또는 표 셀에서 반환된 텍스트 범위는 텍스트가 삽입되고 삭제되더라도 항상 전체 텍스트를 포함합니다. 따라서 이 예에서는 다음 로그 문을 생성합니다.

Start: 0; End: 13; Content: Hello world!
Start: 0; End: 5; Content: Hello

텍스트 삽입 및 삭제

텍스트 범위를 사용하여 도형 및 표 셀에 텍스트를 삽입하고 삭제할 수 있습니다.

  • insertText 및 appendText를 사용하면 텍스트를 삽입할 수 있습니다.
  • setText는 텍스트 범위의 텍스트를 제공된 텍스트로 바꿉니다.
  • clear는 텍스트 범위 내에서 텍스트를 삭제합니다.

다음 스크립트는 이러한 함수의 사용을 보여줍니다.

slides/style/style.gs
try {
  // Get the first slide of active presentation
  const slide = SlidesApp.getActivePresentation().getSlides()[0];
  // Insert shape in the slide with dimensions
  const shape = slide.insertShape(
    SlidesApp.ShapeType.TEXT_BOX,
    100,
    200,
    300,
    60,
  );
  const textRange = shape.getText();
  textRange.setText("Hello world!");
  textRange.clear(6, 11);
  // Insert text in TEXT_BOX
  textRange.insertText(6, "galaxy");
  console.log(
    `Start: ${textRange.getStartIndex()}; End: ${textRange.getEndIndex()}; Content: ${textRange.asString()}`,
  );
} catch (err) {
  // TODO (developer) - Handle exception
  console.log("Failed with an error %s ", err.message);
}

이 스크립트는 첫 번째 슬라이드에 텍스트 상자를 만들고 텍스트 콘텐츠를 'Hello world!'로 설정합니다. 그런 다음 문자 6~11('world')을 삭제하고 대신 색인 6에 텍스트 'galaxy'를 삽입합니다. 이 예에서는 다음 로그 문을 생성합니다.

Start: 0; End: 14; Content: Hello galaxy!

검색 및 바꾸기

프레젠테이션 또는 페이지에서 replaceAllText 함수를 사용하여 전체 프레젠테이션 또는 특정 페이지에서 전역 찾기 및 바꾸기를 실행합니다.

TextRange의 find 함수는 범위 내에서 문자열의 인스턴스를 반환합니다. 도형 또는 표 셀 내에서 찾기 및 바꾸기를 실행하는 데 setText와 함께 사용할 수 있습니다.

단락, 목록 항목, 실행

TextRange는 유용한 텍스트 항목 컬렉션을 반환하는 함수를 제공합니다. 이러한 함수에는 다음이 포함됩니다.

  • getParagraphs, 텍스트 범위와 겹치는 모든 단락을 제공하는 단락은 줄바꿈 문자('\n')로 끝나는 텍스트 시퀀스입니다.
  • getListParagraphs, 현재 텍스트 범위의 목록 항목을 반환하는
  • getRuns, 현재 텍스트 범위와 겹치는 텍스트 실행을 제공하는 텍스트 실행은 모든 문자가 동일한 텍스트 스타일을 갖는 텍스트 세그먼트입니다.

텍스트 스타일 지정

텍스트 스타일은 글꼴, 색상, 하이퍼링크를 비롯한 프레젠테이션의 텍스트 문자 렌더링을 결정합니다.

텍스트 범위의 getTextStyle 함수는 텍스트 스타일 지정에 사용되는 TextStyle 객체 를 제공합니다. TextStyle 객체는 상위 TextRange와 동일한 텍스트를 포함합니다.

slides/style/style.gs
try {
  // Get the first slide of active presentation
  const slide = SlidesApp.getActivePresentation().getSlides()[0];
  // Insert shape in the slide with dimensions
  const shape = slide.insertShape(
    SlidesApp.ShapeType.TEXT_BOX,
    100,
    200,
    300,
    60,
  );
  const textRange = shape.getText();
  // Set text in TEXT_BOX
  textRange.setText("Hello ");
  // Append text in TEXT_BOX
  const insertedText = textRange.appendText("world!");
  // Style the text with url,bold
  insertedText
    .getTextStyle()
    .setBold(true)
    .setLinkUrl("www.example.com")
    .setForegroundColor("#ff0000");
  const helloRange = textRange.getRange(0, 5);
  console.log(
    `Text: ${helloRange.asString()}; Bold: ${helloRange.getTextStyle().isBold()}`,
  );
  console.log(
    `Text: ${insertedText.asString()}; Bold: ${insertedText.getTextStyle().isBold()}`,
  );
  console.log(
    `Text: ${textRange.asString()}; Bold: ${textRange.getTextStyle().isBold()}`,
  );
} catch (err) {
  // TODO (developer) - Handle exception
  console.log("Failed with an error %s ", err.message);
}

앞의 예에서는 먼저 첫 번째 슬라이드에 텍스트 상자를 만들고 콘텐츠를 'Hello '로 설정합니다. 그런 다음 텍스트 'world!'를 추가합니다. 새로 추가된 텍스트는 굵게 표시되고 www.example.com에 연결되며 색상이 빨간색으로 설정됩니다.

스타일을 읽을 때 범위에 스타일에 여러 값이 있으면 함수가 null을 반환합니다. 따라서 이 샘플은 다음 로그 문을 생성합니다.

Text: Hello; Bold: false
Text: world!; Bold: true
Text: Hello world!; Bold: null

텍스트에 적용할 수 있는 다른 스타일도 많이 있습니다. 자세한 내용은 TextStyle 참조 문서를 확인하세요.

단락 스타일 지정

단락 스타일은 전체 단락에 적용되며 텍스트 정렬 및 줄 간격과 같은 항목을 포함합니다. getParagraphStyle 함수는 TextRange에서 상위 텍스트 범위와 겹치는 모든 단락의 스타일을 지정하는 ParagraphStyle 객체를 제공합니다.

다음 예에서는 단락이 4개인 텍스트 상자를 첫 번째 슬라이드에 만든 다음 처음 세 단락을 가운데 정렬합니다.

slides/style/style.gs
try {
  // Get the first slide of active presentation
  const slide = SlidesApp.getActivePresentation().getSlides()[0];
  // Insert shape in the slide with dimensions
  const shape = slide.insertShape(
    SlidesApp.ShapeType.TEXT_BOX,
    50,
    50,
    300,
    300,
  );
  const textRange = shape.getText();
  // Set the text in the shape/TEXT_BOX
  textRange.setText("Paragraph 1\nParagraph2\nParagraph 3\nParagraph 4");
  const paragraphs = textRange.getParagraphs();
  // Style the paragraph alignment center.
  for (let i = 0; i <= 3; i++) {
    const paragraphStyle = paragraphs[i].getRange().getParagraphStyle();
    paragraphStyle.setParagraphAlignment(SlidesApp.ParagraphAlignment.CENTER);
  }
} catch (err) {
  // TODO (developer) - Handle exception
  console.log("Failed with an error %s ", err.message);
}

목록 스타일 지정

ParagraphStyle과 마찬가지로 ListStyle을 사용하여 상위 텍스트 범위와 겹치는 모든 단락의 스타일을 지정할 수 있습니다.

slides/style/style.gs
try {
  // Get the first slide of active presentation
  const slide = SlidesApp.getActivePresentation().getSlides()[0];
  // Insert shape in the slide with dimensions
  const shape = slide.insertShape(
    SlidesApp.ShapeType.TEXT_BOX,
    50,
    50,
    300,
    300,
  );
  // Add and style the list
  const textRange = shape.getText();
  textRange
    .appendText("Item 1\n")
    .appendText("\tItem 2\n")
    .appendText("\t\tItem 3\n")
    .appendText("Item 4");
  // Preset patterns of glyphs for lists in text.
  textRange
    .getListStyle()
    .applyListPreset(SlidesApp.ListPreset.DIGIT_ALPHA_ROMAN);
  const paragraphs = textRange.getParagraphs();
  for (let i = 0; i < paragraphs.length; i++) {
    const listStyle = paragraphs[i].getRange().getListStyle();
    console.log(
      `Paragraph ${i + 1}'s nesting level: ${listStyle.getNestingLevel()}`,
    );
  }
} catch (err) {
  // TODO (developer) - Handle exception
  console.log("Failed with an error %s ", err.message);
}

앞의 예에서는 단락이 4개인 텍스트 상자를 첫 번째 슬라이드에 만듭니다. 두 번째 단락은 한 번 들여쓰기되고 세 번째 단락은 두 번 들여쓰기됩니다. 그런 다음 모든 단락에 목록 사전 설정을 적용합니다. 마지막으로 각 단락의 중첩 수준이 로깅됩니다. 단락의 중첩 수준은 단락 텍스트 앞의 탭 수에서 가져옵니다. 따라서 스크립트는 다음 로그 문을 생성합니다.

Paragraph 1's nesting level: 0
Paragraph 2's nesting level: 1
Paragraph 3's nesting level: 2
Paragraph 4's nesting level: 0