Bekerja dengan Tema Dokumen

Bekerja dengan Tema Dokumen

Panduan ini menunjukkan cara membaca dan menyesuaikan skema warna dan font yang dibagikan dokumen Word dengan aplikasi Office lainnya – tema dokumen – menggunakan Theme, ThemeColors, dan ThemeFonts in Aspose.Words FOSS untuk .NET. Tema sebuah dokumen adalah palet dan pasangan font yang format yang menyadari tema di tempat lain dalam model objek merujuk kepadanya alih-alih mengkodekan secara keras warna atau nama font tertentu.

Objek Tema

Document.Theme mengembalikan instance Theme untuk dokumen. Theme.Colors adalah objek ThemeColors yang menyimpan dua belas warna tema dokumen; Theme.MajorFonts dan Theme.MinorFonts adalah objek ThemeFonts yang masing-masing menyimpan set font judul dan isi.

Warna Tema

ThemeColors menyajikan dua belas yang dapat ditulis Color properti: Dark1, Light1, Dark2, Light2, Accent1 through Accent6, Hyperlink, dan FollowedHyperlink. Objek pemformatan di tempat lain dalam dokumen – Border.ThemeColor, Shading.ForegroundPatternThemeColor / BackgroundPatternThemeColor, Fill.ForeThemeColor / BackThemeColor, Stroke.ForeThemeColor / BackThemeColor, dan Font.ThemeColor – menahan sebuah ThemeColor nilai enum (Dark1, Light1, Dark2, Light2, Accent1-Accent6, Hyperlink, FollowedHyperlink, plus Text1, Text2, Background1, Background2, dan None) yang mengidentifikasi which slot warna tema berlaku; yang sebenarnya Color nilai untuk slot itu berasal dari yang bersangkutan ThemeColors properti pada Document.Theme.Colors.

Font Tema

ThemeFonts mengekspos tiga properti string yang dapat ditulisi: Latin (untuk karakter skrip Latin), EastAsian, dan ComplexScript – nama font yang digunakan untuk setiap skrip ketika objek pemformatan mengacu pada tema. Font.ThemeFont, ThemeFontAscii, ThemeFontFarEast, ThemeFontOther, dan ThemeFontBi masing-masing menyimpan nilai enum ThemeFont (Major, Minor, atau None) yang mengidentifikasi apakah suatu objek Font mengacu pada Theme.MajorFonts atau Theme.MinorFonts untuk rentang skrip tertentu, alih-alih menyimpan nama font eksplisitnya sendiri.

Tips dan Praktik Terbaik

• Ubah warna pada semua batas, bayangan, isi, dan font yang sadar tema dalam satu penyuntingan dengan memperbarui properti ThemeColors yang relevan pada Document.Theme.Colors, alih-alih menelusuri dokumen untuk memperbarui setiap objek pemformatan secara individual.
• Periksa apakah properti ThemeColor atau ThemeFont dari sebuah objek pemformatan bernilai None sebelum menganggapnya mengacu pada tema – None berarti objek tersebut memiliki Color atau nama font eksplisitnya sendiri.
• Theme.MajorFonts biasanya menyediakan font heading dan Theme.MinorFonts font tubuh, sesuai dengan pemilih font tema Word.

Masalah Umum

FAQ

Bagaimana cara membaca warna tema dokumen?

Baca Document.Theme.Colors, sebuah objek ThemeColors dengan properti Color untuk masing-masing dari dua belas slot warna tema – Dark1, Light1, Dark2, Light2, Accent1-Accent6, Hyperlink, dan FollowedHyperlink.

Bagaimana cara mengubah warna aksen dokumen di semua tempat yang digunakannya?

Atur Document.Theme.Colors.Accent1 (atau slot aksen mana pun) ke Color baru; setiap objek pemformatan yang properti ThemeColor-nya merujuk ke slot tersebut akan menerima perubahan.

Apa perbedaan antara ThemeColors dan ThemeColor?

ThemeColors (pada Document.Theme.Colors) adalah objek yang menyimpan dua belas nilai Color sebenarnya untuk dokumen. ThemeColor adalah enum yang digunakan di tempat lain (Border, Shading, Fill, Stroke, Font) untuk merujuk ke salah satu slot tersebut dengan nama alih-alih menyimpan warna secara langsung.

Bagaimana cara mengatur font tema yang digunakan oleh objek Font?

Atur Font.ThemeFont (atau ThemeFontAscii / ThemeFontFarEast / ThemeFontOther / ThemeFontBi khusus skrip) ke ThemeFont.Major atau ThemeFont.Minor; nama font sebenarnya kemudian diambil dari Document.Theme.MajorFonts atau MinorFonts.

API Reference Ringkasan

Lihat Juga

• Aspose.Words for .NET — Enterprise Documentation