.NET içinde Stillerle Nasıl Çalışılır
Bu kılavuz, paragraf, karakter, tablo ve liste stillerini aramayı, uygulamayı ve oluşturmaya nasıl yapılacağını gösterir Aspose.Words FOSS için .NET, şunu kullanarak Style, StyleCollection, ve TableStyle sınıfları. Bir belgenin stil koleksiyonunu okuma, stilleri diller arasında güvenilir bir şekilde bulma, stilleri paragraflara ve run’lara uygulama, stilleri oluşturma ve kopyalama ve tablo stillerinde bölgeye özgü koşullu biçimlendirme yapılandırmayı kapsar.
Adım Adım Kılavuz
Adım 1: Paketi Yükleyin
Aspose.Words FOSS for .NET henüz bir NuGet paketi yayınlamıyor — bunun yerine kütüphaneyi kaynaktan derleyin. https://github.com/aspose-words-foss/Aspose.Words-FOSS-for-.NET.git‘ı klonlayın, ardından Aspose.Words.sln‘ı .NET SDK ile Release yapılandırmasında derleyin ve projenizden ortaya çıkan Aspose.Words derlemesine referans verin. Kütüphane .NET Standard 2.0 hedefli olduğundan, .NET Framework 4.6.2+ ve .NET 6/8/10 üzerinde çalışır.
Adım 2: Gerekli Sınıfları İçe Aktarın
Bir using Aspose.Words; yönergesi ekleyin — Style, StyleCollection, TableStyle, StyleType, StyleIdentifier, ConditionalStyle, ConditionalStyleCollection ve ConditionalStyleType hepsi Aspose.Words ad alanında Document ile birlikte bulunur.
Adım 3: Bir Belgenin Stil Koleksiyonunu Okuyun
Document.Styles bir StyleCollection döndürür – belgeye eklenmiş her yerleşik ve kullanıcı tanımlı Style. StyleCollection.Count, kaç stil tuttuğunu rapor eder ve DefaultFont / DefaultParagraphFormat, yeni içeriğin açık bir stil uygulanmadan önce devraldığı belge genelindeki varsayılan biçimlendirmeyi açıklar.
Adım 4: Bir Stili Güvenilir Şekilde Bulun
Bir stili, görüntüleme adını kullanarak StyleCollection indeksleyicisi, styles[name] ile alın. Yerleşik stiller için, aynı indeksleyiciyi bir StyleIdentifier enum değeriyle tercih edin – styles[sti] – adlar yerelleştirilir, ancak StyleIdentifier değerleri yerelleştirilmez, bu yüzden tanımlayıcıyla arama, belgenin dilinden bağımsız aynı şekilde çalışır. İndeksleyici beklediğinizi bulamazsa, Word’ün aynı stil için tanıdığı alternatif adlar için Style.Aliases‘i kontrol edin ve bir stili programlı olarak kaldırmadan veya yeniden adlandırmadan önce Style.BuiltIn‘ı kontrol edin; çünkü yerleşik stiller genellikle belgenin başka yerlerinde adlarıyla referans alınır.
Adım 5: Bir Stili Paragraflara veya Çalışmalara Uygulayın
Stil taşıyan biçimlendirme nesneleri hem bir Style özelliği (Style nesnesi kendisi) hem de bir StyleName özelliği (adıyla bir stili çözen veya oluşturan bir kısayol) ortaya çıkar. Paragraf stili uygulamak için ParagraphFormat.Style veya ParagraphFormat.StyleName‘ü ayarlayın ve bir çalışmanın biçimlendirmesine karakter stili uygulamak için Font.Style veya Font.StyleName‘yı kullanın. StyleName‘ye koleksiyonda henüz bulunmayan bir ad atamak o stili oluşturur — önce StyleCollection indeksleyicisiyle stilin varlığını doğrulayın veya istenen davranış bu değilse Style nesnesini doğrudan atayın.
Adım 6: Stil Hiyerarşileri Oluşturun
BaseStyleName‘ı okuyarak bir stilin, belirli bir stilin ayarlanmamış biçimlendirmeyi nereden devraldığını bulun, LinkedStyleName‘i eşleştirilmiş paragraf/karakter stili için (Word’ün yerleşik stiller için, örneğin bir başlık ve ona bağlı karakter stili tanımladığı gibi) ve NextParagraphStyleName‘yi bu stili kullanan bir paragraftan sonra yazılan yeni paragrafa Word’ün atadığı stil için kullanın. İlgili stillerin bir kümesini tanımlarken BaseStyleName‘ü ayarlayın — örneğin, aynı temel stilden tüm yazı tipi seçimlerini devralması gereken bir başlık stili ailesi gibi — her stil için aynı biçimlendirmeyi tekrarlamak yerine.
Adım 7: Bir Stil Oluştur veya Kopyala
StyleCollection.Add(type, name)‘ı bir StyleType (Paragraph, Character, Table veya List) ve bir ad ile çağırarak yeni, boş bir stil oluşturun, ardından gerektiği gibi Font ve ParagraphFormat özelliklerini ayarlayın. Mevcut bir stili çoğaltmak için — farklı bir Document‘ın StyleCollection‘undan biri dahil — her biçimlendirme özelliğini manuel olarak okuyup yeniden uygulamak yerine StyleCollection.AddCopy(style)‘ı çağırın. Bir stili koleksiyonundan silmek için Style.Remove()‘ı çağırın.
Adım 8: Tablo Stillerini ve Koşullu Biçimlendirmeyi Yapılandır
TableStyle, Style‘i tablo düzeni özellikleri – Alignment, CellSpacing, LeftIndent, Shading, VerticalAlignment ve dört dolgu özelliği (LeftPadding, RightPadding, TopPadding, BottomPadding) – ile genişletir; ayrıca bantlama deseninin kaç satır veya sütun üzerinde tekrarlanacağını kontrol eden RowStripe ve ColumnStripe ekler. Bölge bazlı biçimlendirme için TableStyle.ConditionalStyles‘i yapılandırın – her bölge için bir ConditionalStyle tutan bir ConditionalStyleCollection: FirstRow, LastRow, FirstColumn, LastColumn, OddRowBanding, EvenRowBanding, OddColumnBanding, EvenColumnBanding ve dört köşe hücresi (TopLeftCell, TopRightCell, BottomLeftCell, BottomRightCell). Her ConditionalStyle, kendi Font, ParagraphFormat, Shading, Borders ve hücre dolgusuna sahiptir; Type, hangi ConditionalStyleType bölgesini temsil ettiğini rapor eder; bireysel tablo satırları yerine bu bölgelerde biçimlendirme ayarlayarak tablo düzenlemelerinde ayakta kalacak bantlı, başlık-satırı veya köşe hücresi biçimlendirmesi elde edersiniz.
Adım 9: Biçimlendirmeyi Sıfırla veya Kaldır
ConditionalStyle.ClearFormatting()‘ı bir koşullu bölgeyi sıfırlamak için, veya ConditionalStyleCollection.ClearFormatting()‘ı bir TableStyle üzerindeki tüm bölgeleri bir anda sıfırlamak için çağırın. StyleCollection.ClearQuickStyleGallery(), stilleri kendileri silinmeden Word UI’nin hızlı-stil galerisinden tüm stilleri kaldırır – belge içeriğine dokunmadan galeriyi küçültmek için kullanışlıdır.
Yaygın Sorunlar ve Çözümler
StyleCollection indeksleyicisi bir ad araması için null döndürür Stil adı bu belgede mevcut değil ya da yerleşik bir stil henüz kullanılmadığı için Word onu oluşturmadı. Kontrol et Style.Aliases alternatif adlar için, ya da kullan the StyleCollection indeksleyici ile bir StyleIdentifier yerleşik stiller için yerine.
Ayar StyleName beklenmedik şekilde yeni bir stil oluşturur StyleName adlandırılmış stili, koleksiyonda zaten yoksa oluşturur. Kullanın StyleCollection stilin var olduğunu doğrulamak için önce indeksleyiciyi kullanın, ya da atayın Style nesneyi doğrudan Style özellik yerine StyleName.
Tablo bantlaması, bir TableStyle uyguladıktan sonra görünmüyor Koşullu biçimlendirme bölgeleri – OddRowBanding, EvenRowBanding, ve benzerleri – hiçbir zaman yapılandırılmadı TableStyle.ConditionalStyles. İlgili ConditionalStyle girdilerinde ConditionalStyleCollection.
Bir stil değişikliği, stili zaten kullanan içeriği etkilemez Stilin üzerine uygulanan Doğrudan (manuel) biçimlendirme, stilin kendi ayarlarından üstün olur. Etkilenen satırlarda veya paragraflarda doğrudan biçimlendirmeyi temizleyin veya ayarlayın Style.AutomaticallyUpdate stilin kendisini bu manuel biçimlendirmeden yeniden tanımlaması için.
Yerleşik bir stil araması, başka bir dilde hazırlanmış bir belgede başarısız olur Bu StyleCollection indeks eşleştiricisi, bir adla çağrıldığında yerelleştirilen görüntü adını eşler. Aynı indeks eşleştiricisini karşılık gelen StyleIdentifier enum değeri yerine, çünkü bu tanımlayıcı yerel bağımsızdır.
Sıkça Sorulan Sorular
Bir belgede tüm stillerin koleksiyonunu nasıl alabilirim?
Document.Styles‘ı okuyun, bu belge içindeki tüm yerleşik ve kullanıcı tanımlı Style‘yi içeren bir StyleCollection döndürür.
Style ile StyleIdentifier arasındaki fark nedir?
Style, biçimlendirmesiyle gerçek stil nesnesidir; StyleIdentifier, belge dilinden bağımsız olarak belirli bir yerleşik stili bulmak için kullanılan, StyleCollection dizinleyicisi aracılığıyla erişilen bir yerel bağımsız enum değeridir.
Tablo stilleri paragraf veya karakter stillerinden nasıl farklıdır?
TableStyle, Style‘in bir alt sınıfıdır ve tablo düzeni özelliklerini (Alignment, CellSpacing, padding) ve bölgeye özgü biçimlendirme için bir ConditionalStyles koleksiyonunu ekler; bu, şeritli satırlar, başlık satırları ve köşe hücreleri gibi paragraf veya karakter stillerine uygulanmayan biçimlendirme kavramlarıdır.
Mevcut bir stili değiştirmek yerine tamamen yeni bir stil oluşturabilir miyim?
Evet — boş bir stil oluşturmak için StyleCollection.Add(type, name)‘ı istediğiniz StyleType ve yeni bir adla çağırın, ardından biçimlendirme özelliklerini (Font, ParagraphFormat ve paragraf veya karakter stilleri için diğerlerini) ayarlayın.
Bir stili, başka bir belgede olanı da dahil olmak üzere nasıl kopyalarım?
Hedef koleksiyona bir kopyasını eklemek için StyleCollection.AddCopy(style)‘ı çağırın, bir Style nesnesi gönderin — bu nesne farklı bir Document‘nin StyleCollection‘undan gelebilir —.
