Metni düzenleme ve stil verme

TextRange türüyle gösterilen metin aralıklarını kullanarak metinleri düzenleyin ve biçimlendirin. TextRange, bir şekil veya tablo hücresi içindeki metin segmentini temsil eder. Bir şekil veya tablo hücresinde getText tuşuna basıldığında, metnin tamamını kapsayan bir metin aralığı döndürülür.

Metnin bir şekle nasıl sığdığını düzenleyen yöntemler kullanırsanız şekle uygulanan tüm otomatik sığdırma ayarları devre dışı bırakılır.

Metin aralıklarını kullanma

Metin aralığı, metin aralığı kapsamındaki metin segmentini sınırlayan iki dizine sahiptir: başlangıç dizini ve bitiş dizini. getStartIndex ve getEndIndex işlevlerini kullanarak bu dizinleri belirleyin.

Bir metin aralığının başlangıç dizini dahil, bitiş dizini ise hariçtir. Her iki dizin de sıfır tabanlıdır.

Bir metin aralığının içeriğini okumak için asString veya asRenderedString işlevlerini kullanın.

Bir metin aralığındaki alt aralığı almak için getRange işlevini kullanın.

Aşağıdaki komut dosyası, ilk slaytta bir metin kutusu oluşturur ve metin içeriğini "Merhaba dünya!" olarak ayarlar. Ardından, yalnızca "Merhaba"yı kapsayan bir alt aralık alır.

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);
}

Bir şekil veya tablo hücresi tarafından döndürülen metin aralığı, metin eklenip silinse bile her zaman metnin tamamını kapsar. Bu nedenle, bu örnek aşağıdaki günlük ifadelerini oluşturur:

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

Metin ekleme ve silme

Metin aralıklarını kullanarak şekillere ve tablo hücrelerine metin ekleyip silebilirsiniz.

  • insertText ve appendText simgeleriyle metin ekleyebilirsiniz.
  • setText, bir metin aralığının metnini sağlanan metinle değiştirir.
  • clear, metin aralığındaki metni siler.

Aşağıdaki komut dosyası, bu işlevlerin kullanımını gösterir:

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);
}

Bu komut dosyası, ilk slaytta bir metin kutusu oluşturur ve metin içeriğini "Merhaba dünya!" olarak ayarlar. Ardından 6. karakterden 11. karaktere kadar olan karakterleri ("world") siler ve 6. indekse "galaxy" metnini ekler. Bu örnek aşağıdaki günlük ifadesini oluşturur:

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

Arama ve değiştirme

Sunumun veya sayfanın tamamında ya da belirli bir sayfada genel bulma ve değiştirme işlemi yapmak için sunumda veya sayfada replaceAllText işlevini kullanın.

TextRange üzerindeki find işlevi, aralıktaki dize örneklerini döndürür. Bir şekil veya tablo hücresinde bulma ve değiştirme işlemleri gerçekleştirmek için setText ile birlikte kullanılabilir.

Paragraflar, liste öğeleri ve çalıştırmalar

TextRange, metin öğelerinin faydalı koleksiyonlarını döndürmek için işlevler sağlar. Bu işlevlerden bazıları şunlardır:

  • getParagraphs,, metin aralığıyla çakışan tüm paragrafları sağlar. Paragraf, yeni satır karakteri "\n" ile sonlanan bir metin dizisidir.
  • getListParagraphs,, geçerli metin aralığındaki liste öğelerini döndürür.
  • getRuns,, geçerli metin aralığıyla çakışan metin çalıştırmalarını sağlar. Metin çalıştırması, tüm karakterlerin aynı metin stiline sahip olduğu bir metin segmentidir.

Metin stili

Metin stili, sununuzdaki metin karakterlerinin yazı tipi, renk ve köprü oluşturma dahil olmak üzere nasıl işleneceğini belirler.

Bir metin aralığının getTextStyle işlevi, metinleri stilize etmek için kullanılan bir TextStyle nesnesi sağlar. TextStyle nesnesi, üst öğesi TextRange ile aynı metni kapsıyor.

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);
}

Önceki örnekte, ilk slaytta bir metin kutusu oluşturulur ve içeriği "Hello " olarak ayarlanır. Ardından "world!" metni eklenir. Yeni eklenen metin www.example.com bağlantısı verilerek kalınlaştırılır ve rengi kırmızı olarak ayarlanır.

Stilleri okurken işlev, aralıkta stil için birden fazla değer varsa null değerini döndürür. Bu nedenle, örnek aşağıdaki günlük ifadelerini oluşturur:

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

Metne uygulanabilecek başka birçok stil vardır. Daha fazla bilgiyi TextStyle referans belgelerinde bulabilirsiniz.

Paragraf stili

Paragraf stilleri, metin hizalama ve satır aralığı gibi özellikler de dahil olmak üzere tüm paragraflara uygulanır. TextRange içindeki getParagraphStyle işlevi, üst metin aralığıyla çakışan tüm paragrafları stilize etmek için bir ParagraphStyle nesnesi sağlar.

Aşağıdaki örnekte, ilk slaytta dört paragraflık bir metin kutusu oluşturulur ve ilk üç paragraf ortalanır.

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);
}

Liste stili

ParagraphStyle'ya benzer şekilde, ListStyle üst metin aralığıyla çakışan tüm paragrafları biçimlendirmek için kullanılabilir.

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);
}

Önceki örnekte, ilk slaytta dört paragraf içeren bir metin kutusu oluşturuluyor: ikinci paragraf bir kez, üçüncü paragraf ise iki kez girintileniyor. Ardından, tüm paragraflara bir liste hazır ayarı uygular. Son olarak, her paragrafın yerleştirme düzeyi kaydedilir. Paragrafın iç içe yerleştirme düzeyi, paragraf metninden önceki sekme sayısından gelir. Bu nedenle, komut dosyası aşağıdaki günlük ifadelerini oluşturur:

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