Menghapus tab stop khusus dari tingkat daftar memberi Anda kontrol yang sangat detail atas tata letak daftar dalam dokumen Word. Fitur Removing List Level Tab Stops menambahkan metode sederhana ListLevel.RemoveTabStop() yang menghapus semua tab stop yang sebelumnya telah disetel. Artikel ini memandu Anda melalui pemasangan SDK, membuat daftar, menghapus tab stop‑nya, dan menyimpan dokumen yang diperbarui.

Mengapa Menghapus Tab Stop Tingkat Daftar dalam Dokumen Word

Daftar kata biasanya mengandalkan tab stop default yang menyelaraskan nomor atau bullet daftar dengan teks. Ketika dokumen dihasilkan secara programatik, Anda mungkin menambahkan tab stop khusus untuk mencapai penyelarasan visual tertentu. Kemudian, kebutuhan bisnis dapat berubah, atau Anda mungkin perlu menggunakan kembali templat yang sama untuk tata letak yang berbeda. Mengedit dokumen secara manual untuk menghapus tab stop memakan waktu dan rawan kesalahan. Dengan ListLevel.RemoveTabStop(), Anda dapat secara programatik mengembalikan level daftar ke perilaku defaultnya, memastikan konsistensi di seluruh dokumen yang dihasilkan tanpa intervensi manual.

Memperkenalkan API ListLevel

Aspose.Words for .NET menyediakan model objek yang kaya untuk memanipulasi dokumen Word. Kelas ListLevel mewakili satu tingkat dalam sebuah daftar (misalnya, tingkat pertama dari daftar bernomor). Mulai dari versi 26.7, kelas tersebut mencakup metode RemoveTabStop(), yang menghapus semua tab stop khusus yang ditetapkan pada tingkat tersebut.

Untuk memulai, instal paket Aspose.Words dari NuGet:

Install-Package Aspose.Words

Anda dapat mempelajari lebih lanjut tentang produk di Aspose.Words for .NET halaman produk. Dokumentasi terperinci tersedia di Aspose.Words .NET dokumen, dan referensi API lengkap dapat dijelajahi di sini.

Hapus Tab Stop Kustom dari Tingkat Daftar Tunggal

Tutorial Langkah‑demi‑langkah

  1. Buat Document dan DocumentBuilder baru. Objek Document menyimpan file Word di memori, sementara DocumentBuilder mempermudah pembuatan konten.
  2. Terapkan format daftar bernomor default. Ini memberi kita daftar dengan level dan tab stop yang telah ditentukan.
  3. Tuliskan beberapa item daftar. Item-item tersebut mewarisi format daftar.
  4. Ambil ListLevel saat ini dari builder. Ini adalah level yang baru saja kita buat.
  5. Panggil RemoveTabStop() pada ListLevel. Ini menghapus tab stop khusus.
  6. Simpan dokumen untuk memverifikasi perubahan.

Contoh berikut menunjukkan cara menghapus tab stop khusus dari tingkat daftar menggunakan C# dan Aspose.Words.

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET.git.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// Create a list with default formatting
builder.ListFormat.ApplyNumberDefault();
builder.Writeln("Numbered list item 1");
builder.Writeln("Numbered list item 2");

// Get the list level and remove its tab stop
ListLevel listLevel = builder.ListFormat.ListLevel;
listLevel.RemoveTabStop();

doc.Save("Paragraph.RemoveTabStopFromListLevel.docx");

Cara Kerjanya

  • builder.ListFormat.ApplyNumberDefault() mengalihkan builder ke konteks daftar bernomor menggunakan gaya daftar default yang didefinisikan oleh Word. Ini secara implisit membuat objek List baru dan ListLevel yang sesuai untuk level pertama.
  • builder.Writeln(...) menulis dua item daftar. Karena builder berada dalam mode daftar, setiap pemanggilan secara otomatis menambahkan nomor daftar yang sesuai dan menyelaraskan teks berdasarkan tab stop level tersebut.
  • builder.ListFormat.ListLevel mengembalikan instance ListLevel yang mengontrol pemformatan untuk level daftar saat ini (level 0 dalam kasus ini).
  • listLevel.RemoveTabStop() menghapus tab stop khusus yang telah diatur ketika level daftar dibuat. Setelah pemanggilan ini, daftar akan menggunakan tab stop default Word, biasanya terletak pada indentasi kiri level tersebut.
  • doc.Save(...) menulis dokumen dalam memori ke file bernama Paragraph.RemoveTabStopFromListLevel.docx. Buka file tersebut di Microsoft Word atau penampil kompatibel lainnya untuk melihat bahwa angka dan teks kini diselaraskan menggunakan tab stop default.

Note: Contoh kode ini disalin dari catatan rilis resmi Aspose.Words dan belum dijalankan di lingkungan sandbox. Verifikasi di pengaturan pengembangan Anda sendiri sebelum menggunakannya di produksi.

Hapus Tab Stop dari Semua Tingkat Daftar dalam Dokumen

Dalam banyak skenario dunia nyata, sebuah dokumen berisi beberapa daftar, masing‑masing dengan beberapa tingkat. Menghapus tab stop hanya pada satu tingkat mungkin tidak cukup. Potongan kode berikut menunjukkan cara mengiterasi setiap daftar dalam dokumen dan menghapus tab stop pada setiap tingkat.

// Load an existing document that contains multiple lists
Document doc = new Document("Input.docx");

// Iterate through every list in the document
foreach (List list in doc.Lists)
{
    // Each list can have multiple levels (0‑8). Iterate them.
    foreach (ListLevel level in list.ListLevels)
    {
        // Remove any custom tab stop for this level
        level.RemoveTabStop();
    }
}

// Save the updated document
doc.Save("Output_NoTabStops.docx");

Penjelasan kode

  • new Document("Input.docx") memuat file Word yang ada yang mungkin berisi beberapa daftar.
  • doc.Lists mengembalikan koleksi objek List yang mewakili setiap daftar yang berbeda dalam dokumen.
  • list.ListLevels menyediakan akses ke sembilan level yang mungkin (0‑8) untuk daftar tersebut. Bahkan jika sebuah level tidak digunakan, koleksi tetap berisi instance ListLevel dengan format default.
  • Di dalam loop dalam, level.RemoveTabStop() dipanggil pada setiap level, menjamin tidak ada tab stop khusus yang tersisa di mana pun dalam dokumen.
  • Akhirnya, doc.Save("Output_NoTabStops.docx") menulis dokumen yang telah dibersihkan.

Pendekatan ini sangat berguna ketika Anda perlu menerapkan tata letak daftar yang seragam di seluruh sekumpulan laporan yang dihasilkan atau ketika Anda menormalkan dokumen yang diterima dari sumber eksternal.

Menambahkan dan Kemudian Menghapus Tab Stop Secara Programatik

Kadang‑kadang Anda mungkin perlu menambahkan tab stop khusus untuk tata letak sementara, melakukan beberapa operasi, dan kemudian kembali ke default. SDK memungkinkan Anda menambahkan tab stop dengan ListLevel.TabStops.Add(double position). Setelah menyelesaikan pemformatan sementara, Anda dapat memanggil RemoveTabStop() untuk membersihkan.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

builder.ListFormat.ApplyNumberDefault();
builder.Writeln("Temporarily aligned item 1");

// Add a custom tab stop at 72 points (1 inch)
ListLevel level = builder.ListFormat.ListLevel;
level.TabStops.Add(72);

builder.Writeln("Item with custom tab stop");

// Later, remove the custom tab stop
level.RemoveTabStop();

builder.Writeln("Item after removing tab stop");

doc.Save("TempTabStopDemo.docx");

Penjelasan kode

  • Setelah membuat dokumen dan menerapkan daftar bernomor, kami menulis item pertama.
  • level.TabStops.Add(72) menyisipkan tab stop khusus pada 72 poin (tepat satu inci). Item daftar berikutnya menyelaraskan teksnya pada posisi tersebut.
  • Setelah pemformatan sementara tidak lagi diperlukan, level.RemoveTabStop() menghapus tab stop khusus, menyebabkan item berikutnya kembali ke perataan default.
  • Writeln akhir menunjukkan efek penghapusan tersebut.

Pola ini berguna ketika Anda membutuhkan penyesuaian satu kali—misalnya, untuk menyelaraskan judul dalam daftar untuk tata letak halaman tertentu—sementara menjaga sisa dokumen tetap bersih.

Dapatkan Lisensi Gratis

Aspose menawarkan lisensi gratis sementara yang menghapus watermark evaluasi dan memberikan akses API penuh untuk pengembangan dan pengujian. Anda dapat meminta satu dari halaman lisensi sementara Aspose.

Sumber Daya Tambahan Gratis

Kesimpulan

Dalam tutorial ini kami membahas cara menggunakan metode baru ListLevel.RemoveTabStop() yang diperkenalkan dalam Aspose.Words 26.7. Dengan menghapus tab stop khusus, Anda mendapatkan kembali kontrol atas perataan daftar, menyederhanakan templat dokumen, dan memastikan format yang konsisten di seluruh file Word yang dihasilkan. Contoh‑contohnya menunjukkan penghapusan untuk satu tingkat daftar, penghapusan massal di seluruh dokumen, dan pola untuk penyesuaian tab‑stop sementara. Mengintegrasikan teknik‑teknik ini ke dalam aplikasi .NET Anda akan membuat otomatisasi Word menjadi lebih kuat dan lebih mudah dipelihara.

FAQs

  1. Apa yang sebenarnya dihapus oleh ListLevel.RemoveTabStop()?
    Metode ini menghapus semua tab stop khusus yang telah didefinisikan untuk level daftar, mengembalikan level tersebut untuk menggunakan tab stop default yang ditentukan oleh gaya dokumen.

  2. Apakah saya perlu memanggil Save() setelah menghapus tab stop?
    Ya. Perubahan dilakukan di memori, jadi Anda harus memanggil Document.Save() untuk menyimpan format daftar yang diperbarui ke file.

  3. Apakah saya dapat menghapus tab stop dari semua tingkat daftar dalam satu dokumen?
    Tentu saja. Anda dapat mengiterasi setiap List dalam dokumen dan kemudian setiap ListLevel, memanggil RemoveTabStop() bila diperlukan.

  4. Apakah RemoveTabStop() didukung untuk daftar berpoin maupun daftar bernomor?
    Ya. Metode ini bekerja pada setiap ListLevel terlepas dari apakah itu mewakili bullet, number, atau format multilevel.

  5. Apakah menghapus tab stop khusus akan memengaruhi indentasi item daftar yang sudah ada?
    Hanya posisi tab stop yang berubah. Indentasi keseluruhan yang ditentukan oleh indentasi kiri tingkat daftar tetap tidak berubah, sehingga item daftar tetap mempertahankan hierarki visualnya.

  6. Apakah saya memerlukan lisensi berbayar untuk menggunakan ListLevel.RemoveTabStop()?
    API tersedia dalam lisensi sementara gratis, tetapi untuk penggunaan produksi Anda harus memperoleh lisensi penuh dari Aspose.

Baca Selengkapnya